NAME    [Toc]    [Back]

       time_lock_es  -  Check time-of-day locking (Enhanced Security)

SYNOPSIS    [Toc]    [Back]

       #include <sys/types.h> #include <sys/security.h>  #include
       <prot.h>

       int time_lock_es(
               struct es_passwd *prpwd );

LIBRARY    [Toc]    [Back]

       Security Library (libsecurity.so)

PARAMETERS    [Toc]    [Back]

       Specifies a protected password entry structure.

DESCRIPTION    [Toc]    [Back]

       The  time_lock_es()  function  performs  time-of-day  lock
       checking for the current date and time against  the  timeof-day
  specification  in  the  fd_tod string of the prpwd
       parameter. The function returns 1 if the time lock  is  on
       and 0 if there is no lock.

       The  fd_tod  specification  is like that found in the UUCP
       Systems file. The specification is a comma-separated  list
       of  entries.  If  the current time matches an entry in the
       specification, the time lock is not on.  The  entries  are
       scanned  until a match is found. If no match can be found,
       the time lock is on. Each entry appears as follows:

       <day><start_time-end_time>

       The day is one of the following: Matches any  day  of  the
       week.  Matches Monday through Friday.  Sunday Monday Tuesday
 Wednesday Thursday Friday Saturday

       The times are military time, for example, 9:15 am is 0915,
       6:00  pm is 1800, and 12:42 am is 0042. When start_time is
       less than end_time, the  range  of  times  contains  valid
       times  in  which  to  log  in that day. When the times are
       equal or there is only one  time  (including  no  time  at
       all),  the  entire  day is valid. When start_time is later
       than end_time, times outside the  range  are  valid.   For
       instance,  if  start_time  is 04:15 and end_time is 02:00,
       then any time that falls outside the  range  of  02:00  to
       04:15 is a valid time.

NOTES    [Toc]    [Back]

       Programs using this function must be compiled with -lsecurity.


       In order to quickstart a  program,  the  program  must  be
       linked as follows: -lsecurity -ldb -laud -lm

       See  the  shared  library  discussion  in the Programmer's
       Guide for more information about using  the  quickstarting
       feature.



                                                  time_lock_es(3)