beautypg.com

Dfsgw list – IBM NFS/DFS Secure Gateway User Manual

Page 49

background image

dfsgw list

Purpose

Lists all entries in the authentication table on the Gateway Server machine

Synopsis

dfsgw list [-help]

Options

-help

Displays help information for this command.

Description

The dfsgw list command lists all entries from the local authentication table,
which indicate which users on NFS clients have DCE credentials. 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 hostname used for the client.

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
nonzero exit value.

Privileges Required

No privileges are required.

Output

The dfsgw list command displays the following output for each entry in the
authentication table:

Mapping: hostname : principal => PAG

Expires at date/time

@host=remotehost @sys=sysname

where

Chapter 5. Configuration File and Command Reference

39