Content-type: text/html Man page of time_lock

time_lock

Section: C Library Functions (3)
Index Return to Main Contents
 

NAME

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

LIBRARY

Security Library (libsecurity.a)  

SYNOPSIS

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

int time_lock (        struct pr_passwd *prpwd );

 

PARAMETERS

Specifies a protected password entry structure.  

DESCRIPTION

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:

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


 

Index

NAME
LIBRARY
SYNOPSIS
PARAMETERS
DESCRIPTION
NOTES

This document was created by man2html, using the manual pages.
Time: 02:42:41 GMT, October 02, 2010