NAME

dfsgw list - Lists all entries in the authentication table on the Gateway Server machine

SYNOPSIS

dfsgw list [-help]

OPTIONS

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, and the date and time at which the credentials expire. 

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

where Names the NFS client for which the entry grants authenticated access to DFS Displays the principal name of the user to whom the entry grants authenticated access Identifies the Process Activation Group (PAG) that exists for the hostname/principal pair Specifies the date and time at which the DCE credentials identified by the PAG expire

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 Mapping: nfs2.abc.com : frost => 41ffffa3 Expires at Sat Jul 23 08:36:23 1994 Mapping: nfs2.abc.com : wvh => 41ffffbe Expires at Sun Jul 24 00:51:21 1994
 . . .

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), dfsgw_delete(8dfs), dfsgw_query(8dfs), dfs_login(8dfs), dfs_logout(8dfs)