'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.)
Symbol
The puidnetd.h symbol for the lookup command is PUIDNETD_CMD_MINE.
Keys
The only key for the mine command is the PUID.
Reply
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.
Returned Values
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.
I p34
Here's the reply, broken into two lines for readability:
a\tp34\tamickey\h112223333\tNMICKEY MOUSE\c18
>983452209.503\tu26\tU983454182.90\ti0\r\n
Where:
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: