acctadm(1M)

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

NAME

acctadm– configure extended accounting facility

SYNOPSIS

/usr/sbin/acctadm [-rux] [-d resource_list] [-e resource_list] [-f filename] [task | process]

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.

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

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

-u

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

-x

Deactivate accounting of the given operand type.

This option requires an operand. See OPERANDS.

OPERANDS

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

The following operands are supported:

process

Run acctadm on the process accounting components of the extended account facility.

task

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

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

EXAMPLES

---

Example 1 Displaying current status




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

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

---

---

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 extended pid,uid,gid,cpu,time,command,tty,projid,taskid,flag basic pid,uid,gid,cpu,time,command,tty,flag

---

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)

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.8  Last Revised 24 Jan 1999

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