Removes an entry from the authentication table on the Gateway Server machine
Synopsis
dfsgw delete -id networkID:userID [-af address_family] [-help]
Options
-id networkID:userID
Identifies an NFS client and the user whose authentication to DCE from that client is to be canceled. 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 removes the user's entry for the specified NFS client from the local authentication
table (AT).
-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 delete command cancels a user's authenticated access to DFS. The command removes the entry for the specified user and NFS client from the
authentication table on the Gateway Server machine. Once the command removes the entry from the authentication table, the user for whom the entry existed no longer has authenticated access to DFS
from the NFS client for which the entry existed.
Because each Gateway Server machine maintains its own authentication table, you must issue the command on the Gateway Server machine from which an entry is to be removed from the authentication table. The command has no effect on entries the user may have in the authentication table for other NFS clients, and it has no effect on entries in the authentication tables on other Gateway Server machines.
You can also end an authenticated session by issuing the dfs_logout command on the NFS client from which authenticated access is no longer needed. To obtain DCE credentials and create an entry in the authentication table, use the dfsgw add command or the dfs_login command.
Privilege Required
The issuer must be logged into the Gateway Server machine either as the user whose entry is to be removed from the authentication table or as local
root.
Examples
The following command deletes the entry from the authentication table that grants authenticated access to the user named ludwig from the NFS client that has
network address 15.27.32.40. The command is issued by the user ludwig, who has UID 7439. Once the command is issued, ludwig no longer has authenticated access to
DFS from the NFS client.
$ dfsgw del -id 15.27.32.40:7439
Exit Values
The dfsgw delete command returns an exit value of 0 (zero) if it removes the entry for the specified user from the authentication table.
Otherwise, it returns a non-zero exit value.
Related Information
Commands: dfsgw add(8dfs)