LPC Library Functions: domain_stats

NAME

domain_stats() - returns statistics gathered on domains

SYNOPSIS

mapping domain_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, errors, heart_beats, 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.
• 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.
• 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, ... ])

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

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

Note that this efun is only available if the driver flag PACKAGE_MUDLIB_STATS is defined.

SEE ALSO

domain_file(), author_file(), set_author()