[unix-history] / usr / src / man / man2 / acct.2

.\" Copyright (c) 1980 Regents of the University of California.
.\" All rights reserved.  The Berkeley software License Agreement
.\" specifies the terms and conditions for redistribution.
.\"
.\"	@(#)acct.2	6.4 (Berkeley) 5/22/86
.\"
.TH ACCT 2 "May 22, 1986"
.UC 4
.SH NAME
acct \- turn accounting on or off
.SH SYNOPSIS
.nf
.ft B
acct(file)
char *file;
.ft R
.fi
.SH DESCRIPTION
The system is prepared to write a record
in an accounting
.I file
for each process as it terminates.
This
call, with a null-terminated string naming an existing file
as argument, turns on accounting;
records for each terminating process are appended to
.IR file .
An argument of 0 causes accounting to be turned off.
.PP
The accounting file format is given in
.IR acct (5).
.PP
This call is permitted only to the super-user.
.SH NOTES
Accounting is automatically disabled when the file system the
accounting file resides on runs out of space; it is enabled when
space once again becomes available.
.SH "RETURN VALUE
On error \-1 is returned.
The file must exist and the call may be exercised only by the super-user.
It is erroneous to try to turn on accounting when it is already on.
.SH ERRORS
.I Acct
will fail if one of the following is true:
.TP 15
[EPERM]
The caller is not the super-user.
.TP 15
[ENOTDIR]
A component of the path prefix is not a directory.
.TP 15
[EINVAL]
The pathname contains a character with the high-order bit set.
.TP 15
[ENAMETOOLONG]
A component of a pathname exceeded 255 characters,
or an entire path name exceeded 1023 characters.
.TP 15
[ENOENT]
The named file does not exist.
.TP 15
[EACCES]
Search permission is denied for a component of the path prefix,
or the path name is not a regular file.
.TP 15
[ELOOP]
Too many symbolic links were encountered in translating the pathname.
.TP 15
[EROFS]
The named file resides on a read-only file system.
.TP 15
[EFAULT]
.I File
points outside the process's allocated address space.
.TP 15
[EIO]
An I/O error occurred while reading from or writing to the file system.
.SH "SEE ALSO"
acct(5), sa(8)
.SH BUGS
No accounting is produced for programs running
when a crash occurs.
In particular non-terminating programs are never
accounted for.
Commit	Line	Data
16bf0669 KM	1	.\" Copyright (c) 1980 Regents of the University of California.
	2	.\" All rights reserved. The Berkeley software License Agreement
	3	.\" specifies the terms and conditions for redistribution.
	4	.\"
95f51977	5	.\" @(#)acct.2 6.4 (Berkeley) 5/22/86
16bf0669	6	.\"
95f51977	7	.TH ACCT 2 "May 22, 1986"
16bf0669 KM	8	.UC 4
	9	.SH NAME
	10	acct \- turn accounting on or off
	11	.SH SYNOPSIS
	12	.nf
79f85414 KM	13	.ft B
	14	acct(file)
	15	char *file;
	16	.ft R
16bf0669 KM	17	.fi
	18	.SH DESCRIPTION
	19	The system is prepared to write a record
	20	in an accounting
	21	.I file
	22	for each process as it terminates.
	23	This
	24	call, with a null-terminated string naming an existing file
	25	as argument, turns on accounting;
	26	records for each terminating process are appended to
	27	.IR file .
	28	An argument of 0 causes accounting to be turned off.
	29	.PP
	30	The accounting file format is given in
	31	.IR acct (5).
79f85414 KM	32	.PP
	33	This call is permitted only to the super-user.
	34	.SH NOTES
	35	Accounting is automatically disabled when the file system the
	36	accounting file resides on runs out of space; it is enabled when
	37	space once again becomes available.
	38	.SH "RETURN VALUE
16bf0669 KM	39	On error \-1 is returned.
	40	The file must exist and the call may be exercised only by the super-user.
	41	It is erroneous to try to turn on accounting when it is already on.
79f85414 KM	42	.SH ERRORS
	43	.I Acct
	44	will fail if one of the following is true:
	45	.TP 15
	46	[EPERM]
	47	The caller is not the super-user.
	48	.TP 15
79f85414 KM	49	[ENOTDIR]
	50	A component of the path prefix is not a directory.
	51	.TP 15
b5984ffe KM	52	[EINVAL]
	53	The pathname contains a character with the high-order bit set.
	54	.TP 15
	55	[ENAMETOOLONG]
	56	A component of a pathname exceeded 255 characters,
	57	or an entire path name exceeded 1023 characters.
	58	.TP 15
79f85414 KM	59	[ENOENT]
	60	The named file does not exist.
	61	.TP 15
b5984ffe KM	62	[EACCES]
	63	Search permission is denied for a component of the path prefix,
	64	or the path name is not a regular file.
	65	.TP 15
	66	[ELOOP]
	67	Too many symbolic links were encountered in translating the pathname.
79f85414 KM	68	.TP 15
	69	[EROFS]
	70	The named file resides on a read-only file system.
	71	.TP 15
	72	[EFAULT]
	73	.I File
	74	points outside the process's allocated address space.
fd690c8b KM	75	.TP 15
	76	[EIO]
	77	An I/O error occurred while reading from or writing to the file system.
79f85414 KM	78	.SH "SEE ALSO"
79f85414 KM	79	acct(5), sa(8)
16bf0669 KM	80	.SH BUGS
	81	No accounting is produced for programs running
	82	when a crash occurs.
e9d005d5	83	In particular non-terminating programs are never
16bf0669	84	accounted for.