time_lock_es(3) 					     Library Functions Manual						   time_lock_es(3)

NAME

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

LIBRARY

       Security Library (libsecurity.so)

SYNOPSIS

       #include <sys/types.h> #include <sys/security.h> #include <prot.h>
       int time_lock_es (      struct es_passwd *prpwd );

PARAMETERS

       Specifies a protected password entry structure.

DESCRIPTION

       The  time_lock_es()  function performs time-of-day lock checking for the current date and time against the time-of-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 cur-
       rent 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

       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.	delim off

																   time_lock_es(3)