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

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

timelimitThe 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