NAME    [Toc]    [Back]

       auth_for_terminal_es  -  determine whether a given user is
       authorized for login on a given terminal  (Enhanced  Security)

SYNOPSIS    [Toc]    [Back]

       #include <prot.h>

       int auth_for_terminal_es(
               struct es_passwd *prpwd,
               struct es_term *prtc );

LIBRARY    [Toc]    [Back]

       Security Library - libsecurity.so

PARAMETERS    [Toc]    [Back]

       Specifies  a  pointer  to  the protected profile structure
       Pointer to a terminal control structure

DESCRIPTION    [Toc]    [Back]

       The auth_for_terminal_es() function determines whether the
       username associated with the prpwd parameter is authorized
       for logins on the terminal associated with the prtc parameter.
   The   determination   is  based  on  the  username
       (prpwd->uflg->fg_name and prpwd->ufld->fd_name), the  terminal
  name  (prtc->uflg->fg_devname,  prtc->ufld->fd_devname),
 and the associated device assignment database entry
       (fields uflg->fg_users and ufld->fd_users).

       If  either  parameter is NULL or if either the username or
       terminal name is NULL, the function  returns  1.   If  the
       device  assignment entry corresponding to the given terminal
 is not found, a 1 is returned.  If the device  assignment
  entry  has  no  list  of authorized users, or if the
       username associated with the prpwd parameter is present in
       the  list,  then auth_for_terminal_es() routine returns 1.
       If there is a list of authorized users, but the associated
       username  is not found in that list, this function returns
       0.

NOTES    [Toc]    [Back]

       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.

       The  auth_for_terminal_es()  function is called as part of
       login processing for enhanced security.

RETURN VALUES    [Toc]    [Back]

       A return of 1 indicates that the user  is  authorized  for
       logins  on  the indicated terminal A return of 0 indicates
       that the user is not authorized for logins  on  the  indicated
 terminal

SEE ALSO    [Toc]    [Back]

       getespwent(3), getestcent(3), getesdvent(3)

       Security



                                          auth_for_terminal_es(3)