Unix‎ > ‎Solaris‎ > ‎Solaris man pages‎ > ‎1m‎ > ‎

acctsh


NAME
     acctsh, chargefee, ckpacct, dodisk, lastlogin, monacct, nul-
     ladm,  prctmp, prdaily, prtacct, shutacct, startup, turnacct
     - shell procedures for accounting

SYNOPSIS
     /usr/lib/acct/chargefee login-name number

     /usr/lib/acct/ckpacct [blocks]

     /usr/lib/acct/dodisk [-o] [filename...]

     /usr/lib/acct/lastlogin

     /usr/lib/acct/monacct number

     /usr/lib/acct/nulladm filename...

     /usr/lib/acct/prctmp filename

     /usr/lib/acct/prdaily [-c] [-l] [mmdd]

     /usr/lib/acct/prtacct filename [ '' heading '']

     /usr/lib/acct/shutacct [ '' reason '']

     /usr/lib/acct/startup

     /usr/lib/acct/turnacct on | off | switch

DESCRIPTION
  chargefee Command
     chargefee can be invoked to charge  a  number  of  units  to
     login-name.  A  record  is  written  to  /var/adm/fee, to be
     merged with other accounting records by runacct(1M).

  ckpacct Command
     ckpacct should be initiated using cron(1M)  to  periodically
     check  the  size  of  /var/adm/pacct.  If  the  size exceeds
     blocks, 500 by default, turnacct will be invoked with  argu-
     ment switch. To avoid a conflict with turnacct switch execu-
     tion in runacct, do not run ckpacct and  runacct  simultane-
     ously.  If  the  number of free disk blocks in the /var file
     system falls below  500, ckpacct will automatically turn off
     the  collection  of  process  accounting records via the off
     argument  to  turnacct.  When  at  least   500  blocks   are
     restored,   the  accounting  will  be activated again on the
     next invocation of ckpacct. This feature is sensitive to the
     frequency  at  which  ckpacct  is  executed,  usually by the
     cron(1M) command.


  dodisk Command
     dodisk should be invoked by cron(1M)  to  perform  the  disk
     accounting functions.

  lastlogin Command
     lastlogin   is   invoked   by    runacct(1M)    to    update
     /var/adm/acct/sum/loginlog,  which  shows  the  last date on
     which each person logged in.

  monacct Command
     monacct should be invoked once each month or each accounting
     period.  number  indicates  which  month or period it is. If
     number is not  given,  it  defaults  to  the  current  month
     (01-12).  This  default  is useful if monacct is to executed
     using cron(1M) on the  first  day  of  each  month.  monacct
     creates  summary  files in /var/adm/acct/fiscal and restarts
     the summary files in /var/adm/acct/sum.

  nulladm Command
     nulladm creates filename with  mode  664  and  ensures  that
     owner  and group are adm. It is called by various accounting
     shell procedures.

  prctmp Command
     prctmp can be used to print the session  record  file  (nor-
     mally   /var/adm/acct/nite/ctmp  created  by  acctcon1  (see
     acctcon(1M)).

  prdaily Command
     prdaily is invoked by runacct(1M) to format a report of  the
     previous  day's  accounting  data.  The  report  resides  in
     /var/adm/acct/sum/rprt/mmdd where mmdd is the month and  day
     of  the  report. The current daily accounting reports may be
     printed by typing prdaily. Previous days' accounting reports
     can  be  printed by using the mmdd option and specifying the
     exact report date desired.

  prtacct Command
     prtacct can be used to format and print any total accounting
     (tacct)file.

  shutacct Command
     shutacct is invoked during a system shutdown to turn process
     accounting    off   and   append   a    reason   record   to
     /var/adm/wtmpx.

  startup Command
     startup can be invoked when  the  system  is  brought  to  a
     multi-user state to turn process accounting on.

  turnacct Command

     turnacct is an interface to accton (see  acct(1M))  to  turn
     process  accounting on or off. The switch argument moves the
     current  /var/adm/pacct   to   the   next   free   name   in
     /var/adm/pacct.incr  (where incr is a number starting with 0
     and incrementing by one  for each  additional  pacct  file),
     then  turns  accounting  back  on  again.  This procedure is
     called by ckpacct and thus can  be  taken  care  of  by  the
     cron(1M)  command  and  used  to keep  pacct to a reasonable
     size.   shutacct uses turnacct to stop  process  accounting.
     startup uses turnacct to start process accounting.

OPTIONS
     The following options are supported:

     -c       This option prints a report of exceptional resource
              usage  by command, and may be used on current day's
              accounting data only.



     -l       This option prints a report of exceptional usage by
              login  id  for  the  specified date. Previous daily
              reports are cleaned up and  therefore  inaccessible
              after each invocation of monacct.



     -o       This option uses acctdusg (see acct(1M))  to  do  a
              slower  version  of disk accounting by login direc-
              tory. filenames specifies the one or more  filesys-
              tem  names  where disk accounting will be done.  If
              filenames are used, disk accounting will be done on
              these  filesystems  only. If the -o option is used,
              filenames  should  be  mount  points   of   mounted
              filesystems. If the -o option is omitted, filenames
              should be  the  special  file  names  of  mountable
              filesystems.



FILES
     /etc/logadm.conf

         Configuration file for the logadm(1M) command



     /usr/lib/acct

         Holds all accounting commands listed in  section  1M  of
         this manual

     /usr/lib/acct/ptecms.awk

         Contains the limits for  exceptional  usage  by  command
         name



     /usr/lib/acct/ptelus.awk

         Contains the limits for exceptional usage by login ID



     /var/adm/acct/fiscal

         Fiscal reports directory



     /var/adm/acct/nite

         Working directory



     /var/adm/acct/sum

         Summary directory that contains information for monacct



     /var/adm/acct/sum/loginlog

         File updated by last login



     /var/adm/fee

         Accumulator for fees



     /var/adm/pacct

         Current file for per-process accounting



     /var/adm/pacctincr

         Used if pacct gets large and during execution  of  daily
         accounting procedure



     /var/adm/wtmpx

         History of user access and administration information



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

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWaccu                    |
    |_____________________________|_____________________________|


SEE ALSO
     acctcom(1),     acct(1M),     acctcms(1M),      acctcon(1M),
     acctmerg(1M),  acctprc(1M), cron(1M), fwtmp(1M), logadm(1M),
     runacct(1M), acct(2), acct.h(3HEAD), utmpx(4), attributes(5)

NOTES
     See runacct(1M) for the main daily accounting shell  script,
     which  performs  the  accumulation of connect, process, fee,
     and disk accounting on a daily basis. It also  creates  sum-
     maries of command usage.










Man pages from Solaris 10 Update 8. See docs.sun.com and www.oracle.com for further documentation and Solaris information.
Comments