vserver cifs symlink modify

Modify a symlink path mapping

Availability: This command is available to cluster and Vserver administrators at the admin privilege level.

Description

The vserver cifs symlink modify command modifies the CIFS share name, CIFS path, CIFS server name, or locality of a symbolic link mapping. It can also be used to modify the value of -home-directory field.

Parameters

-vserver <vserver name> - Vserver
This parameter specifies the Vserver on which the symbolic link mapping is located.
-unix-path <text> - UNIX Path
This parameter specifies the UNIX (NFS) path of the mapping that you want to modify.
Note: It must begin and end with a forward slash (/).
[-share-name <Share>] - CIFS Share
This parameter specifies a new CIFS share name for the mapping.
[-cifs-path <TextNoCase>] - CIFS Path
This parameter specifies a new CIFS path for the mapping. Note that this value is specified by using a UNIX-style path.
Note: It must begin and end with a forward slash (/).
[-cifs-server <TextNoCase>] - Remote NetBIOS Server Name
This parameter specifies a new CIFS server DNS name, IP address, or NetBIOS name for the mapping.
[-locality {local|widelink}] - Local or Wide Symlink
This parameter specifies a new locality for the mapping. A local symbolic link maps to the local CIFS share. A free symbolic link can map anywhere on the local server. A wide symbolic link maps to any CIFS share on the network. The default setting is local. The free link option is obsolete.
[-home-directory {true|false}] - Home Directory
This parameter specifies whether the new target share is a home directory.
Note: This field must be set to true when the target share is a Home Directory for correct processing.

Examples

The following example modifies the symbolic link mapping to a UNIX path /example/ on a Vserver named vs1. The mapping is modified to use the CIFS path /mycompany/example/.

cluster1::> vserver cifs symlink modify -vserver vs1 -unix-path /example/ -cifs-path "/mycompany/example/"

The following example modifies the symbolic link mapping to a UNIX path /example/ on a Vserver named vs1. The mapping is modified to use the CIFS share name EXAMPLE_SHARE, the CIFS path /mycompany/example/, on the CIFS server cifs.example.com, and to be a wide link.

cluster1::> vserver cifs symlink modify -vserver vs1 -unix-path /example/ -share-name EXAMPLE_SHARE -cifs-path "/mycompany/example/" -cifs-server cifs.example.com
-locality widelink