hpux man page for getprdfent

getprdfent(3)						     Library Functions Manual						     getprdfent(3)

NAME
       getprdfent(), getprdfnam(), setprdfent(), endprdfent(), putprdfnam() - manipulate system default database entry for a trusted system

SYNOPSIS
DESCRIPTION
       and each returns a pointer to an object with the following structure containing the broken-out fields of a line in the system default data-
       base.  Each line in the database contains a pr_default structure, declared in the header file:

	      struct  system_default_fields  {
		   time_t  fd_inactivity_timeout ;
		   char    fd_boot_authenticate ;

	      } ;

	      struct  system_default_flags {
		   unsigned short
			   fg_inactivity_timeout:1,
			   fg_boot_authenticate:1,

	      } ;
	      struct  pr_default  {
		   char 			   dd_name[20] ;
		   char 			   dg_name ;
		   struct pr_field		   prd ;
		   struct pr_flag		   prg ;
		   struct t_field		   tcd ;
		   struct t_flag		   tcg ;
		   struct dev_field		   devd ;
		   struct dev_flag		   devg ;
		   struct system_default_fields    sfld ;
		   struct system_default_flags	   sflg ;
	      } ;

       Currently there is only one entry in the system default database referenced by name

       The System Default database contains default values for all parameters in the Protected Password, Terminal Control, and	Device	Assignment
       databases,  as  well as configurable system-wide parameters.  The fields from the other databases are described in the corresponding manual
       entries.  fd_inactivity_timeout is the number of seconds until a session is terminated on trusted systems.

       fd_boot_authenticate is a Boolean flag that indicates whether an authorized user must authenticate before the system begins operation.

       returns a pointer to the first pr_default structure in the database when first called.  Thereafter,  it	returns  a  pointer  to  the  next
       pr_default structure in the database so that successive calls can be used to search the database (only one entry is supported).

       searches  from the beginning of the file until a default entry 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.  Currently,  all  pro-
       grams access the default database by calling (the entry name is

       A  call	to has the effect of rewinding the default control file to allow repeated searches.  can be called to close the database when pro-
       cessing is complete.

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

   Notes
       The  value  returned  by  and  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 supply the modified buffer to

       Programs using these routines must be compiled with

APPLICATION USAGE
       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.

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

WARNINGS
       Do not delete the system default entry.

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

FILES
       System Defaults database

SEE ALSO
       authcap(4), default(4), getprpwent(3), getprtcent(3), getdvagent(3).

								  TO BE OBSOLETED						     getprdfent(3)