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

FreeBSD Manual Pages

  
 
  

home | help
acct(2)			      System Calls Manual		       acct(2)

NAME
       acct() -	enable or disable process accounting

SYNOPSIS
DESCRIPTION
       The  system  call  enables  or disables the system's process accounting
       routine.	 If the	routine	is enabled, an accounting record is written on
       an  accounting  file for	each process that terminates.  Termination can
       be caused by one	of two things: an call or a signal  (see  exit(2)  and
       signal(5)).  The	effective user ID of the calling process must be supe-
       ruser to	use this call.

       path points to a	path name naming the accounting	file.  The  accounting
       file format is described	in acct(4).

       The  accounting routine is enabled if path is nonzero and no errors oc-
       cur during the system call.  It is disabled if path is zero and no  er-
       rors occur during the system call.

       When  the  amount  of  free space on the	file system containing the ac-
       counting	file falls below a configurable	threshold, the system prints a
       message	on  the	console	and disables process accounting.  Another mes-
       sage is printed and the process accounting is re-enabled	when the space
       reaches a second	configurable threshold.

       If  the	size  of  the  process	accounting file	reaches	a configurable
       limit, records for processes  terminating  after	 that  point  will  be
       silently	 lost.	 However,  in  that case the command would still sense
       that process accounting is still	enabled.  This loss of records can  be
       prevented with the command.  and	are described in acctsh(1M)).

RETURN VALUE
       returns the following values:

	      Successful completion.
	      Failure.
		     is	set to indicate	the error.

ERRORS
       If fails, is set	to one of the following	values.

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

	      [EBUSY]	     An	 attempt  is  being  made to enable accounting
			     when it is	already	enabled.

	      [EFAULT]	     path points to an illegal address.	 The  reliable
			     detection	of this	error is implementation	depen-
			     dent.

	      [ELOOP]	     Too  many	symbolic  links	 were  encountered  in
			     translating the path name.

	      [ENAMETOOLONG] The  accounting  file path	name exceeds bytes, or
			     the length	of a component of the  path  name  ex-
			     ceeds bytes while is in effect.

	      [ENOENT]	     One  or  more  components	of the accounting file
			     path name do not exist.

	      [ENOTDIR]	     A component of the	path prefix is	not  a	direc-
			     tory.

	      [EPERM]	     The  effective  user ID of	the calling process is
			     not superuser.

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

	      [ETXTBSY]	     path  points  to  a  text file which is currently
			     open.

SEE ALSO
       acct(1M), acctsh(1M), exit(2), acct(4), signal(5).

STANDARDS CONFORMANCE
								       acct(2)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | ERRORS | SEE ALSO | STANDARDS CONFORMANCE

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

home | help