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

FreeBSD Manual Pages

  
 
  

home | help
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	 writ-
       ten  in an accounting file for each process that	terminates. The	termi-
       nation of a process can be caused by either an exit(2) call or  a  sig-
       nal(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 oc-
       cur 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	direc-
			       tory.

       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 sys-
			       tem.

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

SunOS 5.10			  20 Jan 2003			       acct(2)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUES | ERRORS | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=acct&sektion=2&manpath=SunOS+5.10>

home | help