The Authorizer Mine Command
I -- The Authorizer Mine Command The mine command requests a report of all information the
authorizer 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 mine 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 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 authorizer DBM returns the following field indentifiers and their values in response to a properly authorized mine command. (Symbols come from puidnetd.h.)
- a -- the PUID's alias (PUIDNETD_DATA_AKA)
- c -- the creator's PUID (PUIDNETD_DATA_CRID)
-
E -- authorization characteristics (PUIDNETD_DATA_AUTHZ_CH) (See
Characteristics Field Value.)
- i -- the PUID's attributes bit value as a hexadecimal integer (PUIDNETD_DATA_ATTR)
- N -- the PUID's common name (PUIDNETD_DATA_CNM)
- p -- the PUID (PUIDNETD_DATA_PUID)
- u -- the PUID of the last updated (modifier) (PUIDNETD_DATA_UPUID)
-
U -- the last update (modification) time (PUIDNETD_DATA_UTM) (See
DBM Times.)
- > -- the creation time (PUIDNETD_DATA_CRTM) (See DBM Times.)
Here's an example for PUID 26
I p26
Reply, shown on multiple lines for the sake of readability:
a\tp26\taaka\tNname\t
Ew3,1536(0,984832032.320),1022570(0,984832032.320)\t
c18\t>983452206.130\tu34\tU983454188.2499\ti0\r\n
Where:
a -- is the positive acknowledgement (ACK)
p26 -- 26 is the PUID.
aaka -- aka is the alias.
E<...> -- <...> are the PUID's characteristics (See Characteristics Field Value.)
s445556666 -- 44555656666 is the Student ID (SID).
Nname -- name is the common name.
c18 -- 18 is the creator's PUID.
>983452206.130 -- 983452206.130 is the creation time. (See DBM Times.)
u34 -- 34 is the last updater's (modifier's) PUID.
U983454188.2499 -- 983454188.2499 is the last update (modification) time. (See DBM Times.)
i0 -- is a bit mask in hexadecimal of the the PUID's attributes.
The PUIDNETD_DATA_AUTHZ_CH Field
Characteristics in the PUIDNETD_DATA_AUTHZ_CH field are stored in a special format, documented in puidnetd.h. The format is described in Characteristics Field Value.