Maintenance Commands                                  acctadm(1M)

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

SunOS 5.8           Last change: 24 Jan 1999                    1

Maintenance Commands                                  acctadm(1M)

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

SunOS 5.8           Last change: 24 Jan 1999                    2

Maintenance Commands                                  acctadm(1M)

     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)

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 change: 24 Jan 1999                    3