auth_for_terminal_es(3) 				     Library Functions Manual					   auth_for_terminal_es(3)

NAME

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

LIBRARY

       Security Library - libsecurity.so

SYNOPSIS

       #include <prot.h>

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

PARAMETERS

       prpwd  Specifies a pointer to the protected profile structure

       prtc   Pointer to a terminal control structure

DESCRIPTION

       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.

RETURN VALUES

       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

NOTES

       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.

RELATED INFORMATION

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

       Security delim off

															   auth_for_terminal_es(3)