Lists all entries in the authentication table on the Gateway Server machine
Synopsis
dfsgw list [-help]
Options
-help
Displays the online help for this command.
Description
The dfsgw list command lists all users who have DCE credentials for authenticated access to DFS from NFS clients. To provide this information, the command
lists all entries from the local authentication table (AT). 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 from which entries are to be displayed.
Use the dfsgw query command to see the entry in the authentication table for a specific user. Note that the dfsgw list command provides some additional information not displayed by the dfsgw query command. For example, it displays the hostname of the NFS client for which the DCE credentials are granted, the principal name of the user to whom the credentials are granted, the date and time at which the credentials expire, and the system name and remote host name used for the client.
Privilege Required
No privileges are required.
Output
The dfsgw list command displays the following line of output for each entry in the authentication table:
Mapping: hostname : principal => PAG
Expires at date/time
@host=remotehost @sys=sysname
where
hostname
Names the NFS client for which the entry grants authenticated access to DFS
principal
Displays the principal name of the user to whom the entry grants authenticated access
PAG
Identifies the Process Activation Group (PAG) that exists for the hostname/principal pair
date/time
Specifies the date and time at which the DCE credentials identified by the PAG expire
remotehost
Identifies the remote host name used for the hostname/principal pair
sysname
Identifies the system name used for the hostname/principal pair
The dfsgw list command displays the following line of output if the authentication table contains no entries:
No mappings exist
Examples
The following command displays the current entries from the authentication table on the local Gateway Server machine. The first entry grants secure access to DFS to
the user ludwig from the NFS client named nfs1.abc.com. The PAG associated with the user is 41ffffe4; the user's DCE credentials expire at 6:33 a.m. on 23 July 1994.
dfsgw list
Mapping: nfs1.abc.com : ludwig => 41ffffe4
Expires at Sat Jul 23 06:33:18 1994
(@host=host1.xyz.com @sys-hp700ux_1001)
Mapping: nfs2.abc.com : frost => 41ffffa3
Expires at Sat Jul 23 08:36:23 1994
(@host=host2.xyz.com @sys-hp700ux_1001)
Mapping: nfs2.abc.com : wvh
=> 41ffffbe
Expires at Sun Jul 24 00:51:21 1994
(@host=host3.xyz.com @sys-hp700ux_1001)
.
.
.
Exit Values
The dfsgw list command returns an exit value of 0 (zero) if it succeeds in listing the entries from the authentication table. Otherwise, it
returns a non-zero exit value.
Related Information
Commands: dfsgw add(8dfs)