|HP-UX Reference > G
HP-UX 11i Version 3: February 2007
gsscred — add, remove and list gsscred table entries
/usr/sbin/gsscred [-n user [-o oid] [-u uid]] [-c comment] -m mech -a
/usr/sbin/gsscred [-n user [-o oid]] [-u uid] [-m mech] -r
/usr/sbin/gsscred [-n user [-o oid]] [-u uid] [-m mech] -l
The gsscred utility is used to create and maintain a mapping between a security principal name and a local UNIX uid. The format of the user name is assumed to be GSS_C_NT_USER_NAME. You can use the -o option to specify the object identifier of the name type. The OID must be specified in dot-separated notation, for example: 22.214.171.124464.3.1.
The gsscred table is used on server machines to lookup the uid of incoming clients connected using RPCSEC_GSS.
When adding users, if no user name is specified, an entry is created in the table for each user from the passwd table. If no comment is specified, the gsscred utility inserts a comment that specifies the user name as an ASCII string and the GSS-API security mechanism that applies to it. The security mechanism will be in string representation as defined in the /etc/gss/mech file.
The parameters are interpreted the same way by the gsscred utility to delete users as they are to create users. At least one of the following options must be specified: -n, -u, or -m. If no security mechanism is specified, then all entries will be deleted for the user identified by either the uid or user name. If only the security mechanism is specified, then all user entries for that security mechanism will be deleted.
Again, the parameters are interpreted the same way by the gsscred utility to search for users as they are to create users. If no options are specified, then the entire table is returned. If the user name or uid is specified, then all entries for that user are returned. If a security mechanism is specified, then all user entries for that security mechanism are returned.
Example 1: Creating a gsscred Table
The following shows how to create a gsscred table for the Kerberos Security Mechanism(V5). gsscred obtains user names and uid's from the passwd table to populate the table.
gsscred -m krb5_mech -a
Example 2: Adding an Entry
The following shows how to add an entry for admin/host1 with a specified uid of 0 for the Kerberos Security Mechanism(V5).
gsscred -m krb5_mech -n admin/host1 -u 0 -a
Example 3: Listing All User Mappings
The following lists all user mappings for the Kerberos Security Mechanism(V5).
gsscred -m krb5_mech -l