ea_close(3EXACCT) (man pages section 3: Extended Library Functions)

man pages section 3: Extended Library Functions

ea_close(3EXACCT)

NAME

ea_open, ea_close- open or close exacct files

SYNOPSIS

cc [flag...] file ... -lexacct [library...] 
#include <exacct.h>

efp

name

creator

aflags

oflags

mode

efp

DESCRIPTION

The ea_open() function provides structured access to exacct files. The aflags argument contains the appropriate exacct flags necessary to describe the file. The oflags and mode arguments contain the appropriate flags and mode to open the file; see <fcntl.h>. If ea_open() is invoked with EO_HEAD specified in aflags, the resulting file is opened with the object cursor located at the first object of the file. If ea_open() is invoked with EO_TAIL specified in aflags, the resulting file is opened with the object cursor positioned beyond the last object in the file.

The ea_close() function closes an open exacct file.

RETURN VALUES

Upon successful completion, ea_open() and ea_close() return 0. Otherwise they return -1 and call ea_error(3EXACCT) to return the extended accounting error value describing the error.

ERRORS

The ea_open() and ea_close() functions may fail if:

EXR_SYSCALL_FAIL: A system call invoked by the function failed. The errno variable contains the error value set by the underlying call.

The ea_open() function may fail if:

EXR_CORRUPT_FILE: The file referred to by name is not a valid exacct file.
EXR_NO_CREATOR: In the case of file creation, the creator argument was NULL. In the case of opening an existing file, a creator argument was specified and does not match the creator item of the exacct file.
EXR_UNKN_VERSION: The file referred to by name uses an exacct file version that cannot be processed by this library.

USAGE

The exacct file format can be used to represent data other than that in the extended accounting format. By using a unique creator type in the file header, application writers can develop their own format suited to the needs of their application.

EXAMPLES

Example 1 Open and Close the `exacct` File

The following example opens the extended accounting data file for processes. The exacct file is then closed.

#include <exacct.h>

ea_file_t ef;
if (ea_open(&ef, "/var/adm/exacct/proc", NULL, EO_HEAD, 
    O_RDONLY, 0) == -1)
        exit(1);
(void) ea_close(ef);

ATTRIBUTES

See attributes(5) for descriptions of the following attributes:

ATTRIBUTE TYPE	ATTRIBUTE VALUE
MT-Level	MT-Safe