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