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



-------------------------------------------------------------------------------
cfgcopsf



PURPOSE

Opens an attribute file.

LIBRARY

Run-time Services Library (librts.a)

SYNTAX

#include <cfg04.h>

CFG__SFT *cfgcopsf (path)
char *path;

SYNTAX

The cfgcopsf subroutine opens an attribute file for update.  (For details about
attribute files, see "attributes.")

The path parameter points to the full path name of the file to be opened.

The cfgcopsf subroutine calls the fopen subroutine to open the file for update.
If the call to fopen is successful, cfgcopsf allocates a CFG__SFT structure.
This structure contains the file descriptor returned by fopen, a pointer to a
default stanza buffer for reads, a pointer to an array of indexes in a default
stanza buffer, and the full path name of the file that was opened.

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 cfgcopsf subroutine returns a pointer to an
open attribute file structure.  If the cfgcopsf subroutine fails, it returns a
NULL pointer.

RELATED INFORMATION

In this book:  "cfgcadsz,"  "cfgcclsf," "cfgcdlsz,"  "cfgcrdsz,"  "fopen,
freopen, fdopen," and "attributes."








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