sia_chdir(3)

Index for
Section 3
Alphabetical
listing for S
Bottom of
page
sia_chdir(3)
NAME
  sia_chdir - Interface to the chdir system call - SIA (Security Integration
  Architecture)

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

SYNOPSIS
  #include <siad.h>

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

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


RELATED INFORMATION
  chdir(2)

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