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 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 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,mstate
        Untracked task resources: host
              Process accounting: inactive
         Process accounting file: none
       Tracked process resources: none
     Untracked process resources: extended,host,mstate
                 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,flag
       basic    pid,uid,gid,cpu,time,command,tty,flag
       task:
       extended taskid,projid,cpu,time,host,mstate,anctaskid
       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

     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  modify-
           ing   the accounting configuration.

     2     Invalid command line options were specified.

FILES

     /etc/acctadm.conf

ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

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