acctadm

 

---

 
 
 
 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
 
 
 

---