Man page or keyword search:   man All Sections 1 - General Commands 2 - System Calls 3 - Subroutines, Functions 4 - Special Files 5 - File Formats 6 - Games and Screensavers 7 - Macros and Conventions 8 - Maintenence Commands 9 - Kernel Interface New Commands Server 4.4BSD AIX Alpinelinux Archlinux Aros BSDOS BSDi Bifrost CentOS Cygwin Darwin Debian DigitalUNIX DragonFly ElementaryOS Fedora FreeBSD Gentoo GhostBSD HP-UX Haiku Hurd IRIX Inferno JazzOS Kali Knoppix LinuxMint MacOSX Mageia Mandriva Manjaro Minix MirBSD NeXTSTEP NetBSD OPENSTEP OSF1 OpenBSD OpenDarwin OpenIndiana OpenMandriva OpenServer OpenSuSE OpenVMS Oracle PC-BSD Peanut Pidora Plan9 QNX Raspbian RedHat Scientific Slackware SmartOS Solaris SuSE SunOS Syllable Tru64 UNIXv7 Ubuntu Ultrix UnixWare Xenix YellowDog aLinux   12896 pages apropos Keyword Search (all sections) Output format html ascii pdf view pdf save postscript

auth_for_terminal_es(3)				       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)

SYNOPSIS
       #include <prot.h>

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

LIBRARY
       Security Library - libsecurity.so

PARAMETERS
       Specifies a pointer to the protected profile  structure	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 corre‐
       sponding	 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
       In order to quickstart a program, the program must be  linked  as  fol‐
       lows:

       -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 process‐
       ing for enhanced security.

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	autho‐
       rized for logins on the indicated terminal

SEE ALSO
       getespwent(3), getestcent(3), getesdvent(3)

       Security

						       auth_for_terminal_es(3)

                             _         _         _ 
                            | |       | |       | |     
                            | |       | |       | |     
                         __ | | __ __ | | __ __ | | __  
                         \ \| |/ / \ \| |/ / \ \| |/ /  
                          \ \ / /   \ \ / /   \ \ / /   
                           \   /     \   /     \   /    
                            \_/       \_/       \_/ 

Vote for polarhome