CFGCRDSZ(3x,L)              AIX Technical Reference              CFGCRDSZ(3x,L)



-------------------------------------------------------------------------------
cfgcrdsz



PURPOSE

Reads an attribute file stanza.

LIBRARY

Run-time Services Library (librts.a)

SYNTAX

#include <cfg04.h>

int cfgcrdsz (atfile, stanza, nbytes, stname)
CFG__SFT *atfile;
char *stanza;
int nbytes;
char *stname;

DESCRIPTION

The cfgcrdsz subroutine reads one stanza from an attribute file.  A specific
stanza may be requested, or the next stanza in the file can be read.  When a
stanza is read, any information contained in a default stanza preceding it in
the file is added to the information returned in the buffer.  (For details
about attribute files, see "attributes.")

The atfile parameter points to an open attribute file structure.

The stanza parameter points to the buffer into which the stanza will be read.

The nbytes parameter is the size in bytes of the buffer pointed to by the
stanza parameter.

The stname parameter points to a string containing the name of the stanza to be
read.  If this parameter is a NULL pointer, then the next stanza in the file is
read.

The calling program must have an effective user ID of superuser to access
system customization files such as /etc/master, /etc/system, and
/etc/predefined.

RETURN VALUE

Upon successful completion, the value CFG_SUCC is returned.  If the cfgcrdsz
subroutine fails, then one of the following values is returned:





Processed November 7, 1990      CFGCRDSZ(3x,L)                                1






CFGCRDSZ(3x,L)              AIX Technical Reference              CFGCRDSZ(3x,L)



CFG_EOF    The next stanza was requested, but the end of the file has been
           reached.

CFG_SZNF   The requested stanza was not found in the file.

CFG_SZBF   The requested stanza is longer than nbytes bytes.

CFG_UNIO   Unrecoverable I/O error occurred during processing.

RELATED INFORMATION

In this book:  "cfgcadsz,"  "cfgcclsf,"  "cfgcdlsz," "cfgcopsf," and
"attributes."










































Processed November 7, 1990      CFGCRDSZ(3x,L)                                2