vserver cifs symlink create
Suggest changes
PDFs
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.
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.
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.
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