acct(2) [osf1 man page]

acct(2) 							System Calls Manual							   acct(2)

NAME

       acct - Enables and disables process accounting

SYNOPSIS

       int acct (      char *path );

PARAMETERS

       Specifies a pointer to the pathname of the file, or specifies a null pointer.

DESCRIPTION

       The acct() function enables and disables UNIX process accounting.  When enabled, process accounting produces an accounting record on behalf
       of each terminating process.  The path parameter specifies the pathname of the file to which an accounting record  is  written.	 When  the
       path parameter is 0 (zero) or a null value, the acct() function disables the accounting routine.

       If the path parameter refers to a symbolic link, the acct() function writes records to the file pointed to by the symbolic link.

       If  Network  File  System is installed on your system, the accounting file can reside on another node.  To ensure accurate accounting, each
       node must have its own accounting file, which can be located on any node in the network.

       The calling process must have superuser privilege to enable or disable process accounting.

RETURN VALUES

       Upon successful completion, the acct() function returns a value of 0 (zero).  Otherwise, a value of -1 is returned  and	errno  is  set	to
       indicate the error.

ERRORS

       If  the acct() function fails, errno may be set to one of the following values: The calling process does not have appropriate system privi-
       lege.  The file named by the path parameter does not exist.

       The file named by the path parameter is not an ordinary file.  Write permission is denied for the named accounting file.   The  named  file
       resides on a read-only file system.

RELATED INFORMATION

       Functions: exit(2), sigaction(2), sigvec(2), expacct(3), raise(3) delim off

																	   acct(2)

acct(2) 							   System Calls 							   acct(2)

NAME

       acct - enable or disable process accounting

SYNOPSIS

       #include <unistd.h>

       int acct(const char *path);

DESCRIPTION

       The  acct()  function  enables  or  disables the system process accounting routine. If the routine is enabled, an accounting record will be
       written in an accounting file for each process that terminates. The termination of a process can be caused by either an exit(2) call  or  a
       signal(3C)). The effective user ID of the process calling acct() must have the appropriate privileges.

       The path argument points to the pathname of the accounting file, whose file format is described on the acct.h(3HEAD) manual page.

       The accounting routine is enabled if path is non-zero and no errors occur during the function. It is disabled if path is  (char *)NULL  and
       no errors occur during the function.

RETURN VALUES

       Upon successful completion, 0 is returned. Otherwise, -1 is returned and errno is set to indicate the error.

ERRORS

       The acct() function will fail if:

       EACCES		       The file named by path is not an ordinary file.

       EBUSY		       An attempt is being made to enable accounting using the same file that is currently being used.

       EFAULT		       The path argument points to an illegal address.

       ELOOP		       Too many symbolic links were encountered in translating path.

       ENAMETOOLONG	       The length of the  path argument exceeds {PATH_MAX}, or the length of a	path  argument	exceeds  {NAME_MAX}  while
			       _POSIX_NO_TRUNC is in effect.

       ENOENT		       One or more components of the accounting file pathname do not exist.

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

       EPERM		       The {PRIV_SYS_ACCT} privilege is not asserted in the effective set of the calling process.

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

SEE ALSO

       exit(2), acct.h(3HEAD), signal(3C), privileges(5)

SunOS 5.10							    20 Jan 2003 							   acct(2)