|
|
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)