time_lock - Check time-of-day locking (Enhanced Security)
Security Library (libsecurity.a)
#include <sys/types.h> #include <sys/security.h> #include <prot.h>
int time_lock (
struct pr_passwd *prpwd );
Specifies a protected password entry structure.
The time_lock() 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:
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.
Programs using this function must be compiled with -lsecurity. delim off