Sun Microsystems, Inc.
spacerspacer
spacer   www.sun.com docs.sun.com | | |  
spacer
black dot
   
A   B   C   D   E   F   G   H   I   J   K   L   M   N   O   P   Q   R   S   T   U   V   W   X   Y   Z
    
 
System Administration Commandsacctadm(1M)


NAME

 acctadm - configure extended accounting facility

SYNOPSIS

 /usr/sbin/acctadm [-DErux] [-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.

-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 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 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 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
  process:
  extended pid,uid,gid,cpu,time,command,tty,projid,taskid,ancpid,
           wait-status,flag
  basic    pid,uid,gid,cpu,time,command,tty,flag
  task:
  extended taskid,projid,cpu,time,host,mstate,anctaskid
  basic    taskid,projid,cpu,time
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
  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 TYPEATTRIBUTE VALUE
AvailabilitySUNWcsu

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.9Go To TopLast Changed 2 Aug 2001

 
      
      
Copyright 2002 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms.