Index Index for
Section 3
Index Alphabetical
listing for T
Bottom of page Bottom of
page		 

time_lock_es(3)


NAME

  time_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

  prpwd
      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:

  Any	  Matches any day of the week.

  Wk	  Matches Monday through Friday.

  Su	  Sunday

  Mo	  Monday

  Tu	  Tuesday

  We	  Wednesday

  Th	  Thursday

  Fr	  Friday

  Sa	  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.

Index Index for
Section 3
Index Alphabetical
listing for T
Top of page Top of
page