'I' - The Mine Command
The mine command may be used with all DBMs. It requests a report of all information the DBM knows about the person whose key
is supplied in a field of the command message.
This is a restricted command -- it may be used only by specific pre-authorized PUIDs. (See DBM ACLs.)
The puidnetd.h symbol for the lookup command is PUIDNETD_CMD_MINE.
The only key for the mine command is the PUID.
If the specified key is found and the PUID making the request is permitted, the reply message will contain a positive
acknowledgement (ACK); if not,
a negative acknowledgement (NAK).
An ACK will be accompanied by fields containing the information the DBM knows about the PUID.
A NAK may be accompanied by these fields. The field symbols come from puidnetd.h.
e -- an error code (PUIDNETD_DATA_ERRC); it accompanies a NAK reply.
M -- a message (PUIDNETD_DATA_MSG); it accompanies a NAK reply.
The information a DBM returns in response to an authorized mine command depends on the DBM.
Some information is common to all DBMs. Here's a reflector DBM mine request for PUID 34 with the common information that is returned.
Here's the reply, broken into two lines for readability:
a -- is a positive acknowledgement.
p34 -- is the PUID.
amickey -- is the alias, "mickey".
h112223333 -- is the Human Respources ID (HRID), 112223333.
NMICKEY MOUSE -- is the common name.
c18 -- 18 is the creator's PUID.
>983452209.503 -- is the time the DBM record was created. (See DBM Times.)
u26 -- 26 is the last updater's (modifier's) PUID.
U983454182.90 -- 983454182.90 is the last update (modification) time. (See DBM Times).
i0 -- the current attribute bit value is 0 (zero).
Additional fields are specific to the DBMs and may be found in these places: