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 facility. Without arguments, acctadm displays the current status of the
       extended accounting facility.

OPTIONS

       The following options are supported:

       -d resource_list        Disable reporting of resource usage for resource. Specify resource_list as a comma-separated 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 option can be used to tempo-
			       rarily stop writing accounting records to the accounting file without closing it. To close  the	file  use  the	-x
			       option. See -x.

       -e resource_list        Enable  reporting  of  resource usage for resource. Specify resource_list as a comma-separated 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 OPERANDS.

       -f filename	       Send the accounting output for the given operand 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 account-
			       ing 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 components 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 compo-
       nents 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)