'j' - The Join Command
The join command is specific to the authentication DBM. It is used to join a person in the PUID database to an
authentication realm. Its companion command,
unjoin, removes a person from a
realm (but not from the PUID database).
This is a restricted command --
Only realm administrators may
join users to a realm.
Symbol
The puidnetd.h symbol for the join command is PUIDNETD_CMD_JOIN.
Keys
The standard keys for the join command are either PUID or alias.
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 join is 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.
Required Fields
The join command requires a minimal realm record with a valid realm name.
Additional Fields
Other realm record fields (e.g., password, X.509 certificate, and ACL entries) may be included when a user is joined. For instance, the realm administrator might want to set an initial password, install an X.509 certificate, or create one or more ACL entries.
Examples
Join PUID 00123-45678 to the Purdue realm:
j p12345678 @Rpurdue @
Join PUID 00123-45678 to the Purdue realm with initial password "secret0" (base-64 encoded as "c2VjcmV0MA=="):
j p12345678 @Rpurdue Pc2VjcmV0MA== @