Queries the authentication table on the Gateway Server machine
Synopsis
dfsgw query -id networkID:userID [-af address_family] [-help]
Options
-id networkID:userID
Identifies an NFS client and the user whose authentication from the client is to be determined. You can specify the network address or the
hostname of the NFS client; you must specify the UNIX user identification number (UID) of the user. The command searches the local authentication table (AT) to determine whether the user has an
entry for the specified NFS client.
-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).
-help
Displays the online help for this command. All other valid options specified with this option are ignored.
Description
The dfsgw query command determines whether the specified user has DCE credentials for authenticated access to DFS from the specified NFS client. To provide
this information, the command checks the local authentication table to determine whether the user has an entry for the NFS client. Because each Gateway Server machine maintains its own
authentication table, you must issue the command on the Gateway Server machine that houses the authentication table to be queried. The command determines only whether the user has an entry for the
specified client; the command does not report whether the user has entries for any other clients.
Use the dfsgw list command to see all entries in the authentication table. The dfsgw list command provides some additional information not displayed by the dfsgw query command. The dfsgw query command is useful for inclusion in scripts that determine only whether a user has authenticated access to DFS from an NFS client.
Privilege Required
The issuer must be logged into the Gateway Server machine either as the user whose entry in the authentication table is to be examined or as local
root.
Output
The dfsgw query command displays the following line of output if the specified user has an entry for the specified NFS client in the authentication table:
Mapping found, PAG is PAG
where PAG identifies the Process Activation Group (PAG) that exists for the user. If the user does not have an entry for the NFS client in the authentication table, the dfsgw query command displays the following line of output instead:
No mapping found
Examples
The following command determines whether the authentication table on the local Gateway Server machine includes an entry that provides authenticated access to the user
named ludwig from the NFS client that has network address 15.27.32.40. The user ludwig has UID 7439. The command reports that ludwig has an entry in the
table; the PAG associated with the user is 41ffffe4.
$ dfsgw query -id 15.27.32.40:7439
Mapping found, PAG is 41ffffe4
Exit Values
The dfsgw add command returns an exit value of 0 (zero) if it finds an entry for the specified user in the authentication table. Otherwise, it
returns a non-zero exit value.
Related Information
Commands: dfsgw add(8dfs)