|
Hopefully, this page is exactly what you are looking for, but if not, you can always find further assistance on Unix/Linux Forum!
System Calls getacct(2)
NAME
getacct, putacct, wracct - get, put, or write extended
accounting data
SYNOPSIS
#include <sys/exacct.h>
size_t getacct(idtype_t idtype, id_t id, void *buf, size_t
bufsize);
int putacct(idtype_t idtype, id_t id, void *buf, size_t buf-
size, int flags);
int wracct(idtype_t idtype, id_t id, int flags);
DESCRIPTION
These functions provide access to the extended accounting
facility.
The getacct() function returns extended accounting buffers
from the kernel for currently executing tasks and processes.
The resulting data buffer is a packed exacct object that can
be unpacked using ea_unpack_object() (see
ea_pack_object(3EXACCT)) and subsequently manipulated using
the functions of the extended accounting library,
libexacct(3LIB).
The putacct() function provides privileged processes the
ability to tag accounting records with additional data
specific to that process. For instance, a queueing facility
might want to record to which queue a given task or process
was submitted prior to running. The flags argument deter-
mines whether the contents of buf should be treated as raw
data (EP_RAW) or as an embedded exacct structure
(EP_EXACCT_OBJECT). In the case of EP_EXACCT_OBJECT, buf
must be a packed exacct object as returned by
ea_pack_object(3EXACCT). The use of an inappropriate flag or
the inclusion of corrupt exacct data will likely corrupt the
enclosing exacct file.
The wracct() function requests the kernel to write, given
its internal state of resource usage, the appropriate data
for the specified task or process. The flags field deter-
mines whether a partial (EW_PARTIAL) or interval record
(EW_INTERVAL) is written.
These functions require root privilege, as they allow
inquiry or reporting relevant to system tasks and processes
other than the invoking process. The putacct() and wracct()
functions also cause the kernel to write records to the
system's extended accounting files.
SunOS 5.10 Last change: 20 Jan 2003 1
System Calls getacct(2)
RETURN VALUES
The getacct() function returns the number of bytes required
to represent the extended accounting record for the
requested system task or process. If bufsize exceeds the
returned size, buf will contain a valid accounting record
buffer. If bufsize is less than the return value, buf will
contain the first bufsize bytes of the record. If bufsize is
0, getacct() returns only the number of bytes required to
represent the extended accounting record. In the event of
failure, -1 is returned and errno is set to indicate the
error.
The putacct() and wracct() functions return 0 if the record
was successfully written. Otherwise, -1 is returned and
errno is set to indicate the error.
ERRORS
The getacct(), putacct(), and wracct() functions will fail
if:
EINVAL The idtype argument was not P_TASKID or
P_PID.
ENOSPC The file system containing the extended
accounting file is full. The wracct() or
putacct() function will fail if the record
size would exceed the amount of space
remaining on the file system.
ENOTACTIVE The extended accounting facility for the
requested idtype_t is not active. Either
putacct() attempted to write a task record
when the task accounting file was unset, or
getacct() attempted to retrieve accounting
data for a process when extended process
accounting was inactive.
EPERM The {PRIV_SYS_ACCT} privilege is not
asserted in the effective set of the calling
process.
ERSCH The id argument does not refer to a
presently active system task ID or process
ID.
SunOS 5.10 Last change: 20 Jan 2003 2
System Calls getacct(2)
The putacct() and wracct() functions will fail if:
EINVAL The flags argument is neither EW_PARTIAL nor
EW_INTERVAL.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE |ALUE
|_____________________________|_____________________________|
| MT-Level | Async-Signal-Safe |
|_____________________________|_____________________________|
SEE ALSO
ea_pack_object(3EXACCT), libexacct(3LIB), attributes(5)
SunOS 5.10 Last change: 20 Jan 2003 3
Man(1) output converted with
man2html and wrapped by fishsponge
This page was generated on Wed Sep 12 11:26:58 GMT 2007
|
Your favourite pages:
No pages logged yet.
Trying to save cookie... Top 10 most popular pages:
sqlite3 man page (5334 hits)
(openSUSE 10.2)
svn man page (5209 hits)
(FreeBSD 6.2)
adv_cap_autoneg man page (4870 hits)
(Solaris 10 11_06)
CPAN man page (4607 hits)
(Suse Linux 10.1)
ssh man page (4342 hits)
(Suse Linux 10.1)
ssh-socks5-proxy-connect man page (2885 hits)
(Solaris 10 11_06)
netcat man page (2717 hits)
(Suse Linux 10.1)
pprosetup man page (2492 hits)
(Solaris 10 11_06)
startproc man page (2471 hits)
(Suse Linux 10.1)
signal man page (2408 hits)
(Suse Linux 10.1)
|
Man Pages 
