seclib_twindows(3C)                                     seclib_twindows(3C)

NAME
     seclibtwindows - the user may only log in on authorized terminals and
     at authorized times

SYNOPSIS
     cc ... -lseclib

     #include <seclib.h>

     enum seclibreturnval
     seclibtwindows(enum secwinoptions, struct logincontext *);

     char **
     dupprivlist(char **list);

     void
     freeprivlist(char **list);

DESCRIPTION
     The Time Windows Group is responsible for ensuring that the user only
     logs in on authorized terminals and at authorized times.

     seclibtwindows will:

     -  SECWCKAUTH (CSP feature)

        Use getauth() and ptime() functions to determine if the current
        time, tty is valid for the user.

     -  SECWADDPRIV (CSP feature)

        The supplemental groups specified for the user in the /etc/auth
        file will be added to the list of group in the context strucutre.

     -  SECWKILLTIME (CSP feature)

        The time to kill the session (from the /etc/twindows file) will be
        placed in the context structure.

     dupprivlist and freeprivlist will:

     -  Copy and free an array of character strings. Both the strings will
        be copied (freed) and the array itself will be copied (freed).

ARGUMENTS
     secentryoptions
             A bitmask that directs the function to enable particular
             features. The complete list of values in the bitmask may be
             found in the seclib.h header.

     logincontext
             A value as returned by secliblogincontext(). The structure



Page 1                       Reliant UNIX 5.44                Printed 11/98

seclib_twindows(3C)                                     seclib_twindows(3C)

             referenced by this pointer contains all of the session infor-
             mation required to authenticate a user via the security
             library.

     list    An array of character strings.

RETURN VALUE
     The seclibtwindows returns the seclibreturnval enumeration. The
     function will return:

     SECROK
          The function completed processing without encountering a system
          error.

          NOTE: the function will return SECROK even if it sets
          context->reason to a failure value.

     SECRCALLFAILED
          The function call failed. This is usually because a system call
          failed (such as a malloc() failing when a brk() call returned
          with an error).

     SECRBADOPTION
          The function was called with an invalid argument.

     The dupprivlist() function will return a pointer to a newly allo-
     cated copy of its argument. It will return NULL on failure.

SEE ALSO
     seclib(3C), secliblogincontext(3C), seclibmisc(3C),
     seclibpassentry(3C), seclibpassqual(3C), seclibpasswd(3C),
     seclibruserok(3C), seclibsecterm(3C).






















Page 2                       Reliant UNIX 5.44                Printed 11/98