The Authenticator Mine Command
The mine command requests a report of all information the authentication DBM knows about the person whose key is supplied in a field of the command message. The returned information includes authentication realm memberships.
Symbol
The puidnetd.h symbol for the lookup command is PUIDNETD_CMD_MINE.
Keys
The only key for the mine command is the PUID
Reply
If the PUID making the request is permitted and the specified key is found, the reply message will contain a positive
acknowledgement (ACK); if not,
a negative acknowledgement (NAK).
An ACK will be accompanied by fields containing the information the authentication DBM knows about the PUID.
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.
Returned Values
The authentication DBM returns the following field identifiers and their values in response to a properly authorized mine command. (Symbols come from puidnetd.h.) The following information is always returned regardless of whether a person is joined to an authentication realm:
- a -- the PUID's alias (PUIDNETD_DATA_AKA)
- c -- the creator's PUID (PUIDNETD_DATA_CRID)
- i -- the PUID's attributes bit value as a hexadecimal integer (PUIDNETD_DATA_ATTR)
- N -- the PUID's common name (PUIDNETD_DATA_CNM)
- p -- the PUID (PUIDNETD_DATA_PUID)
- u -- the PUID of the last updater (modifier) (PUIDNETD_DATA_UPUID)
- U -- the last update (modification) time (PUIDNETD_DATA_UTM) (See DBM Times.)
- > -- the creation time (PUIDNETD_DATA_CRTM) (See DBM Times.)
If the person is joined to one or more authentication realms, authentication realm records containing additional, realm-specific fields are returned:
- @ -- authentication realm record start/end (PUIDNETD_DATA_AUTHC_REC)
- R -- realm name (PUIDNETD_DATA_AUTHC_RNAME)
- H -- password hash (PUIDNETD_DATA_AUTHC_PHASH)
- i -- realm-specific attributes (PUIDNETD_DATA_AUTHC_ATTR)
- ` -- consecutive bad authentications (PUIDNETD_DATA_AUTHC_BA)
- { -- cumulative good authentications (PUIDNETD_DATA_AUTHC_CGA)
- } -- cumulative bad authentications (PUIDNETD_DATA_AUTHC_CBA)
- ~ -- time of last good authentication (PUIDNETD_DATA_AUTHC_LGA)
- * -- time account was frozen (PUIDNETD_DATA_AUTHC_FRZ)
- c -- realm record creator's PUID (PUIDNETD_DATA_CRID)
- > -- the creation time (PUIDNETD_DATA_CRTM) (See DBM Times.)
- u -- realm record last modifier's PUID (PUIDNETD_DATA_UPUID)
- U -- the last update (modification) time (PUIDNETD_DATA_UTM) (See DBM Times.)
- ! -- ACL entry start/end (PUIDNETD_DATA_AUTHC_ACLR). See here for a full explanation of the ACL entry record field.
There may be multiple ACL entry field records returned in a realm record.