getprdfent.3 (2010 09)

g
getprdfent(3) getprdfent(3)
(TO BE OBSOLETED)
NAME
getprdfent(), getprdfnam(), setprdfent(), endprdfent(), putprdfnam() - manipulate system default data-
base entry for a trusted system
SYNOPSIS
#include <sys/types.h>
#include <hpsecurity.h>
#include <prot.h>
struct pr_default *getprdfent(void);
struct pr_default *getprdfnam(const char *name);
void setprdfent(void);
void endprdfent(void);
int putprdfnam(const char *name, struct pr_default *pr);
DESCRIPTION
getprdfent and getprdfnam each returns a pointer to an object with the following structure contain-
ing the broken-out fields of a line in the system default database. Each line in the database contains a
pr_default structure, declared in the <prot.h> 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
default.
The System Default database contains default values for all parameters in the Protected Password, Ter-
minal 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.
getprdfent 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).
getprdfnam 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 encoun-
tered on reading, these functions return a NULL pointer. Currently, all programs access the default data-
base by calling getprdfnam (the entry name is default).
HP-UX 11i Version 3: September 2010 − 1 − Hewlett-Packard Company 1