Index Index for
Section 3
Index Alphabetical
listing for S
Bottom of page Bottom of
page		 

sia_chdir(3)


NAME

  sia_chdir - Interface to the chdir system call - SIA (Security Integration
  Architecture)


SYNOPSIS

  #include <siad.h>

  int sia_chdir(
	  const char * directory,
	  time_t timelimit );


LIBRARY

  Standard C library (libc.so and libc.a)


PARAMETERS

  directory
      The specified new working directory. The parameter must be an ASCII
      string. If it is a NULL, SIAFAIL is returned.

  timelimit
      The number of seconds to allow for the chdir() call. If a 0 is
      specified, there is no timeout. If the value is less than 0,
      SIA_DEF_TIMEOUT is used.


DESCRIPTION

  The sia_chdir() routine implements a "NFS-safe" way to change the current
  working directory. This routine calls the chdir() system call which is
  protected by alarm() and signal-handling for SIGALRM, SIGHUP, SIGINT,
  SIGQUIT, and SIGTERM. Receipt of any of these signals causes the chdir()
  operation to fail. If the chdir() call completes within the time limit
  given, the call succeeds.


RETURN VALUES

  The sia_chdir() routine returns SIASUCCESS or SIAFAIL.


ERRORS

  The errno value is not (normally) set explicitly by sia_* routines. The
  errno values are those returned from the dynamic loader interface, from
  dependent (siad_*) routines, or from malloc. Possible errors include
  resource constraints (no memory) and various authentication failures.


FILES

  /etc/passwd

  /etc/sia/matrix.conf


SEE ALSO

  chdir(2)

  Security

Index Index for
Section 3
Index Alphabetical
listing for S
Top of page Top of
page