Connect to the Purdue Home Page

Purdue University

Identity and Access Management

'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.

Feedback | Contact Purdue | Style Standards
Maintained by: IAMO Team

Purdue University, West Lafayette, IN 47907, (765) 494-4600
© 2010 - 2013 Purdue University | An equal access/equal opportunity university | Copyright Complaints
If you have trouble accessing this page because of a disability, please contact the CSC at itap@purdue.edu or (765) 494-4000.