Authorizer DBM Get Information Command
'i' -- Authorizer DBM Get Information Command The authorizer DBM returns information about its internal state in response to an 'i' command.
Symbol
The puidnetd.h symbol for the list characteristics command is PUIDNETD_CMD_GETINFO.
Default Information
The 'i' command with no options returns default information.
i
Reply message:
MPID: p; b in malloc arena; (n,m) PUID range
Where:
- PID: -- is the prefix for the default information.
- p -- is the UNIX Process ID of the DBM process
-
b in malloc arena -- is the amount of dynamically allocated memory in use in bytes
(This information is restricted to PUID_ROOT callers.)
- (n,m) PUID range -- is the range of PUIDs known to the DBM
Information Requests Selections from a set of request characters may be supplied in the value of a message field accompanying the 'i' command. These request characters are supported by the authorizer DBM:
-
A -- get all DBM information (PUIDNETD_GIFO_ALL). (Some information is restricted to PUID_ROOT callers.)
-
a -- get DBM information about aliases (PUIDNETD_GIFO_AKA). (This information is restricted to PUID_ROOT callers.)
- b -- get a PUID's DBM-specific DBM ACL bits (PUIDNETD_GIFO_GETACL). (This is a restricted option.)
-
p -- get DBM information about PUIDs (PUIDNETD_GIFO_PUID). (This information is restricted to PUID_ROOT callers.)
-
q -- get a DBM's queue statistics (PUIDNETD_GIFO_Q). (This information is restricted to PUID_ROOT callers.)
Restricted Options
Restricted options may be used only by client applications that have identified a PUID to a net damon via client-side
SSL, and the PUID has permission to use the option.
The DBM ACL section gives more information
on how PUIDs are given permission to use restricted DBM facilities.
Restriction of some options or selected information of some options to callers whose PUID is PUID_ROOT is done for reasons
of performance.
Parsing and Identifying Information Messages
DBM information is returned in messages that have unique prefixes. Client applications can scan the returned messages for
ones of interest by using the prefixes. The prefixes are named in the following option examples.
Get All Information (PUIDNETD_GIFO_ALL) An "all information" request ('A')
provides all authorization DBM information, including the default information.
(Some information is restricted to PUID_ROOT callers.)
i MA