getprtcent man page on HP-UX

Man page or keyword search:  
man Server   10987 pages
apropos Keyword Search (all sections)
Output format
HP-UX logo
[printable version]

getprtcent(3)							 getprtcent(3)

       getprtcent, getprtcnam, setprtcent, endprtcent, putprtcnam - manipulate
       terminal control database entry for a trusted system

       and each returns a pointer to an object with  the  following  structure
       containing  the	broken-out  fields of an entry in the terminal control
       database.  Each entry in the database  contains	a  pr_term  structure,
       declared in the header file:

	      struct   t_field	{
		 char	 fd_devname[14];      /* Terminal (or host) name */
		 uid_t	 fd_uid;	      /* uid of last successful login */
		 time_t	 fd_slogin;	      /* time stamp of successful login */
		 uid_t	 fd_uuid;	      /* uid of last unsuccessful login */
		 time_t	 fd_ulogin;	      /* time stamp of unsuccessful login */
		 int	 fd_nlogins;	      /* consecutive failed attempts */
		 int	 fd_max_tries;	      /* maximum unsuc login tries allowed */
		 time_t	 fd_logdelay;	      /* delay between login tries */
		 char	 fd_lock;	      /* terminal locked? */
		 int	 fd_login_timeout;    /* login timeout in seconds */
	      struct  t_flag  {
		 unsigned short
		    fg_devname:1,	      /* Is fd_devname set? */
		    fg_uid:1,		      /* Is fd_uid set? */
		    fg_slogin:1,	      /* Is fd_stime set? */
		    fg_uuid:1,		      /* Is fd_uuid set? */
		    fg_ulogin:1,	      /* Is fd_ftime set? */
		    fg_nlogins:1,	      /* Is fd_nlogins set? */
		    fg_max_tries:1,	      /* Is fd_max_tries set? */
		    fg_logdelay:1,	      /* Is fd_logdelay set? */
		    fg_lock:1,		      /* Is fd_lock set? */
		    fg_login_timeout:1	      /* is fd_login_timeout valid? */
	      struct  pr_term  {
		 struct t_field ufld;
		 struct t_flag uflg;
		 struct t_field sfld;
		 struct t_flag sflg;

       The  system  stores the user ID and time of the last successful login (
       fd_uid and fd_slogin) and unsuccessful login ( fd_uuid  and  fd_ulogin)
       in  the	appropriate Terminal Control database entry. The system incre‐
       ments fd_nlogins with each unsuccessful login, and resets the field  to
       0 on a successful login.	 The fd_max_tries field is a limit on the num‐
       ber of unsuccessful logins until the account is locked. An  administra‐
       tive  lock  can also be applied, indicated by a non-zero fd_lock field.
       fd_logdelay stores the amount of time  (in  seconds)  that  the	system
       waits  between unsuccessful login attempts, and fd_login_timeout stores
       the number of seconds from the beginning of an  authentication  attempt
       until the login attempt is terminated.

       Note  that  ufld	 and uflg refer to user-specific entries, and sfld and
       sflg refer to the system default values (see authcap(4)).

       The value returned by or refers to a structure that is  overwritten  by
       calls  to these routines.  To retrieve an entry, modify it, and replace
       it in the database, copy the entry using structure assignment and  sup‐
       ply the modified buffer to

       returns	a pointer to the first terminal pr_term structure in the data‐
       base when first called.	Thereafter, it returns a pointer to  the  next
       pr_term	structure  in the database, so successive calls can be used to
       search the database.  searches from the beginning of the database until
       a  terminal  name  matching name is found, and returns a pointer to the
       particular structure in which it was found.  If an  end-of-file	or  an
       error is encountered on reading, these functions return a NULL pointer.

       A  call to has the effect of rewinding the Terminal Control database to
       allow repeated searches.	 can be called to close the  Terminal  Control
       database when processing is complete.

       puts a new or replaced terminal control entry pr with key name into the
       database.  If the fg_devname field is 0, the requested entry is deleted
       from  the Terminal Control database.  locks the database for all update
       operations, and performs an after the update or failed attempt.

       In a multithreaded application, these routines are safe	to  be	called
       only from one dedicated thread.	These routines are not POSIX.1c async-
       cancel safe nor async-signal safe.

       and return NULL pointers on or error.  returns 0 if it  cannot  add  or
       update the entry.

       The  fd_devname	field, on systems supporting connections, may refer to
       the ASCII representation of a host name.	 This  can  be	determined  by
       using (see getdvagent(3)) to interrogate the Device Assignment database
       as to the type of the device, passing in the fd_devname	field  of  the
       Terminal	 Control  structure  as	 an  argument.	This allows lockout by
       machine, instead of the device (typically pseudo tty) on which the ses‐
       sion originated.

       Programs using these routines must be compiled with

       The  sfld  and  sflg structures are filled from corresponding fields in
       the system default database.  Thus, a program can  easily  extract  the
       user-specific  or  system-wide  parameters for each database field (see
       getprpwent and getdvagent).

       HP-UX 11i Version 3 is the last	release	 to  support  trusted  systems

       Terminal Control database
       System Defaults database

       getprdfent(3), authcap(4), ttys(4).

				TO BE OBSOLETED			 getprtcent(3)

List of man pages available for HP-UX

Copyright (c) for man pages and the logo by the respective OS vendor.

For those who want to learn more, the polarhome community provides shell access and support.

[legal] [privacy] [GNU] [policy] [cookies] [netiquette] [sponsors] [FAQ]
Polarhome, production since 1999.
Member of Polarhome portal.
Based on Fawad Halim's script.
Vote for polarhome
Free Shell Accounts :: the biggest list on the net