CFGCADSZ(3x,L) AIX Technical Reference CFGCADSZ(3x,L) ------------------------------------------------------------------------------- cfgcadsz PURPOSE Adds or replaces a stanza in an attribute file. LIBRARY Run-time Services Library (librts.a) SYNTAX #include <cfg04.h> int cfgcadsz (atfile, stanza, stname, after) CFG__SFT *atfile; char *stanza; char *stname; char *after; DESCRIPTION The cfgcadsz subroutine adds a new stanza or replaces an existing stanza in an attribute file. (For details about attribute files, see "attributes.") The atfile parameter points to an open attribute file structure. The stanza parameter points to the buffer that contains the stanza to be written. The stname parameter points to the name of the stanza to be added to the file. The after parameter points to the name of the stanza after which the new stanza is to be inserted. If this parameter is NULL, then the stanza is added to the end of the file. All information that is repeated in the default stanza of the attribute file is removed from the new stanza before it is written to the file. 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 cfgcadsz subroutine fails, the following value is returned: CFG_ECLS An error occurred while closing a file. CFG_EOPN An error occurred while opening a file. Processed November 7, 1990 CFGCADSZ(3x,L) 1
CFGCADSZ(3x,L) AIX Technical Reference CFGCADSZ(3x,L) CFG_SPCE Memory allocation failed because of insufficient space. CFG_UNIO An unrecoverable I/O error occurred during processing. RELATED INFORMATION In this book: "cfgadev," "cfgcclsf," "cfgcdlsz," "cfgcopsf," "cfgcrdsz," and "attributes." Processed November 7, 1990 CFGCADSZ(3x,L) 2