Connect to the Purdue Home Page

Purdue University

Identity and Access Management

'm' - The Modify Command

The modify command may be used with all DBMs. It identifies a request to modify the 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_MODIFY.

Keys

The only key for the mine command is the PUID.

Reply

The standard key for the modify command is the PUID. When the PUID isn't known, the alias to the PUID may be used.

These are the common modify 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 and the modification can be made, the reply message will contain a positive acknowledgement (ACK); if not, a negative acknowledgement (NAK).

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.

Modification Values

Modification values, supplied in fields of the command message, vary with the DBM identity.

In general (but not always) modification information is contained in field records. (See fields.) The most common field record for presenting modification information is the modification field record, PUIDNETD_DATA_MDFY, field identifier 'Y'.

The character following PUIDNETD_DATA_MDFY identifies what is to be modified, using its field identifier.

The modification (new) data appears in a PUIDNETD_DATA_NEW field inside the modification record.

Here's an example of a command to modify the alias of PUID 18:

m p18 Ya nfoobar3 Y

Where:

m -- is the modify command, PUIDNETD_CMD_MODIFY.
p18 -- identifies the PUID.
Ya -- starts the modification field record and declares an alias modification.
nfoobar3 -- gives a new alias value of "foobar3".
Y -- ends the modification field record.

Other Modification Fields

Other fields that can accompany the command message identify information to be modified that is specific to the DBM. Follow these to the DBM of interest:

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.