'l' - The Look Up Command
The lookup command may be used with all DBMs. It is a request to look up information the DBM knows about the person whose
key is supplied in a field of the command message.
The fields that can accompany the
command and reply messages and their contents vary with the DBM identity.
Follow these links for specific information.
Symbol
The puidnetd.h symbol for the lookup command is PUIDNETD_CMD_LOOKUP.
Keys
The standard key for the lookup command is the PUID. When the PUID isn't known, the alias to the PUID may be used. The
reflector DBM also allows keys that include common name, Human Resources IDentification number (HRID), Student IDentification
number (SID), or a regular expression applied to the common name. See the description of the
reflector lookup command for more information
on those alternative keys.
These are the common lookup keys. The field
identifier symbols come from puidnetd.h
a -- alias (PUIDNETD_DATA_AKA); do an exact match on the alias field value.
p -- PUID (PUIDNETD_DATA_PUID); do an exact match on the PUID field value.
Reply
If the specified key is found, the reply message will contain a positive acknowledgement
(ACK);
if not, a negative acknowledgement (
NAK).
An ACK is always accompanied by
these fields. Depending on the DBM, more information may accompany the reply in other fields. The field symbols come from
puidnetd.h.
a -- an alias (PUIDNETD_DATA_AKA); it accompanies an ACK reply.
N -- a common name (PUIDNETD_DATA_CNM); it accompanies an ACK reply.
p -- PUID (PUIDNETD_DATA_PUID); a unique PUID; it accompanies an ACK reply.
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.