NAME    [Toc]    [Back]

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

SYNOPSIS    [Toc]    [Back]

       #include <siad.h>

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

LIBRARY    [Toc]    [Back]

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

PARAMETERS    [Toc]    [Back]

       The specified new working directory. The parameter must be
       an  ASCII  string.  If  it is a NULL, SIAFAIL is returned.
       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    [Toc]    [Back]

       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    [Toc]    [Back]

       The sia_chdir() routine returns SIASUCCESS or SIAFAIL.

ERRORS    [Toc]    [Back]

       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    [Toc]    [Back]

       /etc/passwd

       /etc/sia/matrix.conf

SEE ALSO    [Toc]    [Back]

       chdir(2)

       Security



                                                     sia_chdir(3)