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

FreeBSD Manual Pages

  
 
  

home | help
acctadm(1M)		System Administration Commands		   acctadm(1M)

NAME
       acctadm - configure extended accounting facility

SYNOPSIS
       /usr/sbin/acctadm  [-DErux]  [-d	 resource_list]	[-e resource_list] [-f
       filename] [task | process | flow]

DESCRIPTION
       acctadm configures various attributes of	the extended accounting	facil-
       ity.  Without arguments,	acctadm	displays the current status of the ex-
       tended accounting facility.

OPTIONS
       The following options are supported:

       -d resource_list	       Disable reporting of  resource  usage  for  re-
			       source.	Specify	resource_list as a comma-sepa-
			       rated list of resources or resource groups.

			       This option requires an operand.	See OPERANDS.

       -D		       Disable accounting of the  given	 operand  type
			       without	closing	 the accounting	file. This op-
			       tion can	be used	to  temporarily	 stop  writing
			       accounting records to the accounting file with-
			       out closing it. To close	the file  use  the  -x
			       option. See -x.

       -e resource_list	       Enable  reporting  of  resource	usage  for re-
			       source. Specify resource_list as	a  comma-sepa-
			       rated list of resources or resource groups.

			       This option requires an operand.	See OPERANDS.

       -E		       Enable  accounting  of  the  given operand type
			       without sending	the  accounting	 output	 to  a
			       file.  This option requires an operand. See OP-
			       ERANDS.

       -f filename	       Send the	accounting output for the given	 oper-
			       and  type  to filename. If filename exists, its
			       contents	are lost.

			       This option requires an operand.	See OPERANDS.

       -r		       Display available resource groups.

			       When this option	is used	with  an  operand,  it
			       displays	 resource groups available for a given
			       accounting type.	When no	operand	is  specified,
			       this  option  displays  resource	groups for all
			       available accounting types. See OPERANDS.

       -u		       Configure accounting based on the  contents  of
			       /etc/acctadm.conf.

       -x		       Deactivate  accounting  of  the	given  operand
			       type. This option also  closes  the  accounting
			       file  for  the  given  accounting type if it is
			       currently open.

			       This option requires an operand.	See OPERANDS.

OPERANDS
       The -d, -D, -e, -E, -f, and -x options require an operand.

       The following operands are supported:

       process		       Run acctadm on the  process  accounting	compo-
			       nents of	the extended accounting	facility.

       task		       Run  acctadm  on	the task accounting components
			       of the extended accounting facility.

       flow		       Run acctadm on the IPQoS	accounting  components
			       of the extended accounting facility.

       The  optional final parameter to	acctadm	represents whether the command
       should act on the process, system task or IPQoS	accounting  components
       of the extended accounting facility.

EXAMPLES
       Example 1: Displaying the Current Status

       The  following  command	displays  the current status. In this example,
       system task accounting is  active  and  tracking	 only  CPU  resources.
       Process and flow	accounting are not active.

       $ acctadm
		   Task	accounting: active
	      Task accounting file: /var/adm/exacct/task
	    Tracked task resources: extended
	  Untracked task resources: host
		Process	accounting: inactive
	   Process accounting file: none
	 Tracked process resources: none
       Untracked process resources: extended,host
		   Flow	accounting: inactive
	      Flow accounting file: none
	    Tracked flow resources: none
	  Untracked flow resources: extended

       Example 2: Activating Basic Process Accounting

       The following command activates basic process accounting:

       $ acctadm -e basic -f /var/adm/exacct/proc process

       Example 3: Displaying Available Resource	Groups

       The following command displays available	resource groups:

       $ acctadm -r
	 process:
	 extended pid,uid,gid,cpu,time,command,tty,projid, \
	 taskid,ancpid,wait-status,zone,flag,memory,mstate
	 basic	  pid,uid,gid,cpu,time,command,tty,flag
	 task:
	 extended taskid,projid,cpu,time,host,mstate,anctaskid,zone
	 basic	  taskid,projid,cpu,time
	 flow:
	 extended saddr,daddr,sport,dport,proto,dsfield,nbytes,npkts, \
	 action,ctime,lseen,projid,uid
	 basic	  saddr,daddr,sport,dport,proto,nbytes,npkts,action

       In the output above, the	lines beginning	with extended are shown	with a
       backslash character. In actual acctadm output,  these  lines  are  dis-
       played as unbroken, long	lines.

       Example 4: Displaying Resource Groups for Task Accounting

       The following command displays resource groups for task accounting:

       $ acctadm -r task
	 extended taskid,projid,cpu,time,host,mstate,anctaskid,zone
	 basic	  taskid,projid,cpu,time

EXIT STATUS
       The following exit values are returned:

       0	Successful completion.

		The  modifications to the current configuration	were valid and
		made successfully.

       1	An error occurred.

		 A fatal error occured either in obtaining or modifying	   the
		accounting configuration.

       2	Invalid	command	line options were specified.

FILES
       /etc/acctadm.conf

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE	TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWcsu			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       acct(2),	attributes(5), ipqos(7IPP)

NOTES
       Both extended accounting	and regular accounting can be active.

       Available  resources  can vary from system to system, and from platform
       to platform.

SunOS 5.10			  30 Sep 2004			   acctadm(1M)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | EXAMPLES | EXIT STATUS | FILES | ATTRIBUTES | SEE ALSO | NOTES

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

home | help