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



-------------------------------------------------------------------------------
cfgcdlsz



PURPOSE

Deletes a stanza from an attribute file.

LIBRARY

Run-time Services Library (librts.a)

SYNTAX

#include <cfg04.h>

int cfgcdlsz (atfile, stname)
CFG__SFT *atfile;
char *stname;

DESCRIPTION

The cfgcdlsz subroutine deletes a stanza from an attribute file.  (For details
about attribute files, see "attributes.")

The atfile parameter points to an open attribute file structure.  The stname
parameter points to the name of the stanza to be deleted from 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 cfgcdlsz
subroutine fails, one of the following values is returned:

CFG_ECLS   An error occurred while closing a file.

CFG_EOPN   An error occurred while opening a file.

CFG_SPCE   Memory allocation failed because of insufficient space.

CFG_SZBF   The file contains a stanza that is larger than the maximum allowable
           stanza size.

CFG_SZNF   The requested stanza to be deleted was not found in the file.

CFG_UNIO   An unrecoverable I/O error occurred during processing.





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

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



RELATED INFORMATION

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



















































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