Skip to main content
A newer release of this product is available.

vserver cifs symlink modify

Contributors
Suggest changes
PDFs

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