Connect to the Purdue Home Page

Purdue University

Identity and Access Management

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.


The puidnetd.h symbol for the lookup command is PUIDNETD_CMD_MINE.


The only key for the mine command is the PUID


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)
  • 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.

Feedback | Contact Purdue
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 or (765) 494-4000.