time_lock_es(3)time_lock_es(3)NAMEtime_lock_es - Check time-of-day locking (Enhanced Security)
SYNOPSIS
#include <sys/types.h> #include <sys/security.h> #include <prot.h>
int time_lock_es(
struct es_passwd *prpwd );
LIBRARY
Security Library (libsecurity.so)
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 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
Programs using this function must be compiled with -lsecurity.
In order to quickstart a program, the program must be linked as fol‐
lows: -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)