NAME    [Toc]    [Back]

       sia_timed_action  -  Time  limit  routine  - SIA (Security
       Integration Architecture)

SYNOPSIS    [Toc]    [Back]

       #include <siad.h>

       int sia_timed_action(
               int *(action)(),
               void  *params,
               time_t timeout );

LIBRARY    [Toc]    [Back]

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

PARAMETERS    [Toc]    [Back]

       This parameter is a function pointer to the  action  being
       timed.   The parameters to the function specified with the
       action() parameter.  The maximum time in  seconds  allowed
       for the action.

DESCRIPTION    [Toc]    [Back]

       The  sia_timed_action()  routine  provides a way to call a
       function with a  time  limit  and  signal  protection.  If
       SIGHUP,  SIGINT, SIGQUIT, SIGTERM, or SIGALRM is received,
       sia_timed_action() fails.

RETURN VALUES    [Toc]    [Back]

       The  sia_timed_action()  routine  returns  SIAFAIL  if   a
       SIGHUP,  SIGINT,  SIGQUIT,  SIGTERM,  or SIGALRM signal is
       received or if a timeout  occurs.  Otherwise,  the  return
       value from the action() call is returned.

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]

       sigaction(2), sigprocmask(2), siglongjmp(3), sigsetjmp(3)

       Security



                                              sia_timed_action(3)