The dfsgw query command determines whether a specific user is authenticated to DCE via the Gateway Server machine. The command can be issued either by the user whose authentication is to be determined or by a user who is logged in as the local root user on the machine configured as a Gateway Server.
The command looks for an entry for the user in the authentication table on the Gateway Server machine on which it is issued. If your environment includes multiple Gateway Server machines, you must issue the command on the Gateway Server machine whose authentication table is to be examined. The command displays information about a user's entry regardless of whether the user authenticated via the dfs_login command or the dfsgw add command.
The dfsgw query command has the following syntax:
dfsgw query -id networkID:userID [-af address_family]
The command includes the following options:
-id networkID:userID
Specifies the network address or hostname of an NFS client and the UID of the user whose DCE authentication for that client is to be determined.
-af address_family
Specifies the style of network address to be used to identify hosts. By default, the command uses the only address family currently supported,
inet (Internet).
For example, the following dfsgw query command determines whether the user ludwig is authenticated from the NFS client that has network address 15.27.32.40. The command is issued by the local root user on the Gateway Server machine.
# dfsgw query -id 15.27.32.40:7439
Mapping found, PAG is 41ffffe4
The command reports that a mapping for the user for the specified NFS client exists in the local authentication table. The user's PAG is 41ffffe4. See the reference page for the dfsgw query command for more information about the command.