NAME

dfsgw delete - Removes an entry from the authentication table on the Gateway Server machine

SYNOPSIS

dfsgw delete -id networkID:userID [-af address_family] [-help]

OPTIONS

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