fedfs-delete-junction (8) - Linux Man Pages
fedfs-delete-junction: send a FEDFS_DELETE_JUNCTION ADMIN protocol request
NAMEfedfs-delete-junction - send a FEDFS_DELETE_JUNCTION ADMIN protocol request
SYNOPSISfedfs-delete-junction [-?d] [-n nettype] [-h hostname] [-s security] path
INTRODUCTIONRFC 5716 introduces the Federated File System (FedFS, for short). FedFS is an extensible standardized mechanism by which system administrators construct a coherent namespace across multiple file servers using file system referrals. For further details, see fedfs(7).
FedFS-enabled file servers allow remote administrative access via an authenticated RPC protocol known as the FedFS ADMIN protocol. Using this protocol, FedFS administrators manage FedFS junctions and NSDB connection parameter information on remote FedFS-enabled file servers.
DESCRIPTIONThe fedfs-delete-junction(8) command is part of a collection of low-level single-use programs that is intended for testing the FedFS ADMIN protocol or for use in scripts. It sends a single FEDFS_DELETE_JUNCTION request to a remote FedFS ADMIN protocol service.
The FEDFS_DELETE_JUNCTION request deletes a FedFS junction in a local file system on a remote file server. The fedfs-delete-junction(8) command takes a single positional parameter which is the pathname on the remote server of the junction to be deleted. This pathname is relative to the root of the local file system on the remote server.
The FEDFS_DELETE_JUNCTION request does not remove the FSN record associated with the deleted junction. Other junctions may continue to refer to the FSN in the deleted junction.
When no junction refers to this FSN, use the nsdb-delete-fsn(8) command to delete the FSN and children FSL records. Resolving a junction that contains an FSN UUID without a matching FSN record on the NSDB results in an error on the file server.
- -d, --debug
- Enables debugging messages during operation.
- -?, --help
- Displays fedfs-delete-junction(8) version information and a usage message on stderr.
- -h, --hostname=hostname
- Specifies the hostname of a remote FedFS ADMIN service. If this option is not specified, the default value is localhost.
- -n, --nettype=nettype
- Specifies the transport to use when contacting the remote FedFS ADMIN service. Typically the nettype is one of tcp or udp. If this option is not specified, the default value is netpath. See rpc(3t) for details.
- -s, --security=flavor
- Specifies the security flavor to use when contacting the remote FedFS ADMIN service. Valid flavors are sys, unix, krb5, krb5i, and krb5p. If this option is not specified, the unix flavor is used. See the SECURITY section of this man page for details.
EXAMPLESSuppose you are the FedFS administrator of the example.net FedFS domain. To delete the existing FedFS junction /export/junction1 on the file server fs.example.net, use:
$ fedfs-delete-junction -h fs.example.net /export/junction1
SECURITYBy default, or if the sys and unix flavors are specified with the --security=flavor option, the fedfs-create-junction(8) command uses AUTH_SYS security for the Remote Procedure Call. AUTH_SYS has known weaknesses and should be avoided on untrusted networks.
The RPC client uses the Kerberos v5 GSS mechanism if a Kerberos security flavor is specified. When specifying a Kerberos security flavor, the user must first obtain a valid Kerberos ticket using kinit(1) before running fedfs-create-junction(8).
COLOPHONThis page is part of the fedfs-utils package. A description of the project and information about reporting bugs can be found at http://wiki.linux-nfs.org/wiki/index.php/FedFsUtilsProject.
AUTHORChuck Lever <chuck.lever [at] oracle.com>