|EA_OPEN(3EXACCT)||Extended Accounting File Access Library Functions||EA_OPEN(3EXACCT)|
cc [ flag... ] file... -lexacct [ library... ] #include <exacct.h> int ea_open(ea_file_t *ef, char *name, char *creator, int aflags, int oflags, mode_t mode);
int ea_close(ea_file_t *ef);
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. If EO_NO_VALID_HDR is set in aflags along with EO_HEAD, the initial header record will be returned as the first item read from the file. When creating a file, the creator argument should be set (system generated files use the value "SunOS"); when reading a file, this argument should be set to NULL if no validation is required; otherwise it should be set to the expected value in the file.
The ea_close() function closes an open exacct file.
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.
The ea_open() and ea_close() functions may fail if:
The ea_open() function may fail if:
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.
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);
See attributes(7) for descriptions of the following attributes:
|ATTRIBUTE TYPE||ATTRIBUTE VALUE|
|November 29, 2001||OmniOS|