Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
ACCT(2)			    BSD	System Calls Manual		       ACCT(2)

NAME
     acct -- enable or disable process accounting

LIBRARY
     Standard C	Library	(libc, -lc)

SYNOPSIS
     #include <unistd.h>

     int
     acct(const	char *file);

DESCRIPTION
     The acct()	call enables or	disables the collection	of system accounting
     records.  If the argument file is a nil pointer, accounting is disabled.
     If	file is	an existing pathname (null-terminated),	record collection is
     enabled and for every process initiated which terminates under normal
     conditions	an accounting record is	appended to file.  Abnormal conditions
     of	termination are	reboots	or other fatal system problems.	 Records for
     processes which never terminate can not be	produced by acct().

     For more information on the record	structure used by acct(), see
     /usr/include/sys/acct.h and acct(5).

     This call is permitted only to the	super-user.

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.

RETURN VALUES
     On	error -1 is returned.  The file	must exist and the call	may be exer-
     cised only	by the super-user.

ERRORS
     Acct() will fail if one of	the following is true:

     [EPERM]		The caller is not the super-user.

     [ENOTDIR]		A component of the path	prefix is not a	directory.

     [ENAMETOOLONG]	A component of a pathname exceeded 255 characters, or
			an entire path name exceeded 1023 characters.

     [ENOENT]		The named file does not	exist.

     [EACCES]		Search permission is denied for	a component of the
			path prefix, or	the path name is not a regular file.

     [ELOOP]		Too many symbolic links	were encountered in translat-
			ing the	pathname.

     [EROFS]		The named file resides on a read-only file system.

     [EFAULT]		File points outside the	process's allocated address
			space.

     [EIO]		An I/O error occurred while reading from or writing to
			the file system.

SEE ALSO
     acct(5), sa(8)

HISTORY
     An	acct() function	call appeared in Version 7 AT&T	UNIX.

BSD				 June 4, 1993				   BSD

NAME | LIBRARY | SYNOPSIS | DESCRIPTION | NOTES | RETURN VALUES | ERRORS | SEE ALSO | HISTORY

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=acct&sektion=2&manpath=FreeBSD+4.7-RELEASE>

home | help