getfilehdr Subroutine
Purpose
Retrieves the header details of the advanced accounting data file.
Library
The libaacct.a library.
Syntax
#define <sys/aacct.h>
getfilehdr(filename, hdrinfo)
char *filename;
struct aacct_file_header *hdrinfo;Description
The getfilehdr subroutine retrieves the advanced accounting data file header information in a structure of type aacct_file_header and returns it to the caller through the structure pointer passed to it. The data file header contains the system details such as the name of the host, the partition number, and the system model.
Parameters
| Item | Description |
|---|---|
| filename | Name of the advanced accounting data file. |
| hdrinfo | Pointer to the aacct_file_header structure in which the header information is returned. |
Security
No restrictions. Any user can call this function.
Return Values
| Item | Description |
|---|---|
| 0 | The call to the subroutine was successful. |
| -1 | The call to the subroutine failed. |
Error Codes
| Item | Description |
|---|---|
| EINVAL | The passed pointer is NULL. |
| ENOENT | Specified data file does not exist. |
| EPERM | Permission denied. Unable to read the data file. |