dwww Home | Manual pages | Find package

NNACCT(1m)                                                          NNACCT(1m)

       nnacct - news accounting and access authorization (nn)

       nnacct -r [ -f file ] [ -a ] [ user ]...
       nnacct [ -ppolicy ] [ -qquota ] user...
       nnacct -ZERO

       The  nnacct  command  provides an optional accounting and access autho-
       rization for news reading via the nn news reader.

       The first form (-r) is used to print accounting reports.  If a file  is
       specified data from a saved accounting file; otherwise the data is read
       from the current accounting file.

       If -a is specified, the report will contain  accounting  data  for  all
       users.   Otherwise,  if  one  or more users are specified, the data for
       these users will be printed.  If neiter is specified, only the account-
       ing data for the current user is printed.
         Only  the  super-user  can  generate reports for other users than the

       The second form (-p and/or -q)  assigns  the  specified  access  policy
       and/or  quota  to  the specified users.  If a given user is not already
       known in the accounting file, a new entry with the specified policy and
       quota is created (default values are used if both are not specified).

       The  third  form  (-ZERO)  will  clear  the usage counts for all users.
       Individual usage counts cannot be  cleared.   The  original  accounting
       file is saved with a .old suffix.

       The following policies are currently implemented:

       0      No access.  The user is not allowed to read news at all.

       1      Privileged  user.   The  user  can read news at all times and no
              accounting information is saved.  This is obviously  the  policy
              for system administrators :-)

       2      Full time access.  The user can access news at all times.

       3      Off-hours  access.   The user can only access news at off hours,
              i.e. in the morning, in the evening, on week-ends, and on  holi-
              days (not complete - check the source :-)

       The quota specifies a number of hours which the user is allowed to read
       news.  When this quota is used up, access will be blocked.  A quota  of
       zero gives unlimited access.

       New  users  will get the default policy and quota defined in account.c.
       If this allows new users to read news at only specific times, this form
       can be used to permit individual users to read news at all times, or it
       can be used to prevent them from reading news at all.  If  the  default
       policy does not allow new users to read news, this form must be used to
       authorize them to read news.

       If authorization is enabled, the nn news reader  will  call  nnacct  on
       start-up  to check whether the policy and quota defined for the current
       user allows him to read news at this time (or at all).

       If accounting is enabled, the nn news reader will call nnacct  on  exit
       to register the time spent on news reading.  If account logging is also
       defined (see account.c), an line is also added to  the  accounting  log

       When  accounting  is defined, the user can use the :cost command to get
       the current accounting data, and if the variable report-cost is set, nn
       will print accounting information on exit.

       The  use  of nnacct is enabled via the ACCOUNTING and AUTHORIZE symbols
       in nn's configuration file.  Further  configuration  of  cost  calcula-
       tions,  logging,  default policy, default quotas, etc. is done directly
       in the source file account.c.  New access policies can also be  defined
       in this file.  This allows you to change the policies or prices without
       having to recompile the whole package since only nnacct is modified.

       Normally, only root is allowed to change user policy or quota, list all
       user's  accounting  data  etc.  This privilege can be shared with other
       users by listing their login name in the  file  $CLIENT/admins.   There
       should be exactly one login name per line, and no blanks are allowed.

       $db/acct      accounting data (accumulated per user)
       $db/acctlog   accounting log (grows indefinitely)
       $lib/admins   login names of privileged nnacct users.

       nn(1), nnusage(1)

       There  should  be  some tools to mess around with the accounting files,
       e.g. to make summaries, clear usage counters, etc.

       Kim F. Storm, Texas Instruments A/S, Denmark
       E-mail: storm@texas.dk

4th Berkeley Distribution         Release 6.6                       NNACCT(1m)

Generated by dwww version 1.11.3 on Tue Dec 1 17:25:01 CET 2015.