author_stats(3)       LPC Library Functions       author_stats(3)

NAME
     domain_stats() - returns statistics gathered on domains
     author_stats() - returns statistics gathered on authors

SYNOPSIS
     mapping domain_stats( string domain | void );
     mapping author_stats( string domain | void );

DESCRIPTION
     Both domain_stats() and  author_stats()  return  information
     stored  in  a  mapping.   If  no argument is specified, then
     information is returned on all domains (or on  all  authors)
     with  one map entry per domain or author.  If an argument is
     specified, then a map is returned that corresponds  to  that
     domain   or   author   with   keys:   moves,  cost,  errors,
     heart_beats, worth, array_size, and objects.  Each of  these
     map  to integer values.  Moves is the number of objects that
     have moved into objects in the given domain.   Cost  is  the
     number  of  evaluations  (eval_cost)  accumulated by objects
     with the given domain (or author).  Errors is the number  of
     errors   incurred   by   objects   with  the  given  domain.
     Heart_beats is the number of heartbeat calls made on objects
     having  the  given domain.  Worth is the value maintained by
     the add_worth(3) efunction (this is  usually  used  to  keep
     track  of  how  much  money a given wizard has given out vs.
     taken in).  Array_size is the size (in bytes) of the  arrays
     allocated  by  the domain.  Objects is the number of objects
     created by the given domain.  When called with no arguments,
     the returned mapping has a form like this:

          ([ domain0 : info0, domain1 : info1, ... ])

     while info0 has the form:

          ([ "moves" : moves, "cost" : cost, "errors" : errors,
             "heart_beats" : heart_beats, "worth" : worth,
             "array_size" : array_size, "objects" : objects ])

     When called with an argument, the returned mapping will have
     the form of info0.

SEE ALSO
     domain_file(4), author_file(4), set_author(3)

MudOS                Last change: 5 Sep 1994                    1