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