Content-type: text/html Man page of auth_for_terminal_es

auth_for_terminal_es

Section: C Library Functions (3)
Index Return to Main Contents
 

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)

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.  

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

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


 

Index

NAME
LIBRARY
SYNOPSIS
PARAMETERS
DESCRIPTION
RETURN VALUES
NOTES
RELATED INFORMATION

This document was created by man2html, using the manual pages.
Time: 02:42:41 GMT, October 02, 2010