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 attri-
     bute  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, then 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 insuffi-
                cient 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.

Related Information

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