vserver cifs character-mapping modify

Modify 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 modify command modifies the CIFS character mapping for the specified volume on a particular Vserver.

You can modify a particular volume's character mapping by specifying the following two parameters in the modify command:

Note: Choose target characters in the "Private Use Area" of Unicode in the following range: U+E0000...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 modify 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 modifying 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 modifying 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.
Note: The permissible Unicode character set for source mapping is: 0x01-0x19, 0x5C, 0x3A, 0x2A, 0x3F, 0x22, 0x3C, 0x3E, 0x7C, 0xB1.


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

cluster1::> vserver cifs character-mapping modify -volume vol1 -mapping 3c:e17d, 3e:f17e, 2a:f746
cluster1::> vserver cifs character-mapping show

Vserver         Volume Name  Character Mapping
--------------  -----------  ------------------------------------------
vs1             vol1         3c:e17d, 3e:f17e, 2a:f746