Skip to main content

vserver cifs symlink create

Create a symlink path mapping

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

Description​

The vserver cifs symlink create command creates a symbolic link mapping for CIFS. A mapping consists of a Vserver name, a UNIX (NFS) path, a CIFS share name, and a CIFS path. You can also specify a CIFS server name and whether the CIFS symbolic link is a local link, a free link (obsolete), or wide link. 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. If the target share is a Home Directory, then the -home-directory field must be set to true for correct processing.

Parameters​

-vserver <vserver name> - Vserver
This parameter specifies the Vserver on which you want to create the mapping.
-unix-path <text> - UNIX Path
This parameter specifies the UNIX (NFS) path for the mapping.
Note
It must begin and end with a forward slash (/).
[-share-name <Share>] - CIFS Share
This parameter specifies the CIFS share for the mapping.
-cifs-path <TextNoCase> - CIFS Path
This parameter specifies the 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 whether the CIFS symbolic link is a local link, a free link (obsolete), or wide link. 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 target share is a home directory. The default value is false.
Note
This field must be set to true when the target share is a Home Directory for correct processing.

Examples​

The following example creates a symbolic link mapping on a Vserver named vs1. It has the UNIX path /sales/, the CIFS share name SALES_SHARE, and the CIFS path /mycompany/sales/.

cluster1::> vserver cifs symlink create -vserver vs1
-unix-path /sales/ -share-name SALES_SHARE -cifs-path "/mycompany/sales/"

The following example creates a symbolic link mapping on a Vserver named vs1. It has the UNIX path /example/, the CIFS share name EXAMPLE_SHARE, the CIFS path /mycompany/example/, the CIFS server IP address, and is a wide link.

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