ONTAP 9.14.1 commands

vserver cifs character-mapping create

Create character mapping on a volume

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


The vserver cifs character-mapping create command creates the CIFS character mapping for the specified volume on a particular Vserver.

Choose target characters in the "Private Use Area" of Unicode in the following range: U+E000…​U+F8FF.
The target Unicode characters must not appear in existing file names; otherwise, unwanted character mappings would occur, resulting in clients being unable to access mapped files. For example, if ":" is mapped to "-" but "-" appears in files normally, a Windows client using the mapped share to access a file named "a-b" would have its request mapped to the NFS name "a:b", which is not the desired file.

The vserver cifs character-mapping create command is not supported for FlexGroups.


-vserver <vserver name> - Vserver

This parameter specifies the Vserver on which a volume is located for which you are creating the character mapping. If only one data Vserver exists, you do not need to specify this parameter.

-volume <volume name> - Volume Name

This parameter specifies the name of the volume for which you are creating the character mapping.

-mapping <text>,…​ - Character Mapping

This parameter specifies the mapping of the invalid CIFS filename characters to valid CIFS filename characters. The mapping consists of a list of source-target character pairs separated by ":". The characters are Unicode characters entered using hexadecimal digits. For example: 3C:E03C.

The permissible Unicode character set for source mapping is: 0x01-0x19, 0x5C, 0x3A, 0x2A, 0x3F, 0x22, 0x3C, 0x3E, 0x7C, 0xB1.


The following example creates a character mapping for a volume vol1 on Vserver vs1.

cluster1::> vserver cifs character-mapping create -volume vol1 -mapping 3c:e17c, 3e:f17d, 2a:f745
cluster1::> vserver cifs character-mapping show

Vserver         Volume Name  Character Mapping
--------------  -----------  ------------------------------------------
vs1             vol1         3c:e17c, 3e:f17d, 2a:f745
Top of Page