acctadm(1M) System Administration Commands acctadm(1M)NAMEacctadm - configure extended accounting facility
SYNOPSIS
/usr/sbin/acctadm [-DErux] [-d resource_list] [-e resource_list] [-f
filename] [task | process | flow]
DESCRIPTIONacctadm configures various attributes of the extended accounting facil‐
ity. 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-sep‐
arated 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 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
resource. Specify resource_list as a comma-sep‐
arated 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 ALSOacct(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)
