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.
Description
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:
-
Vserver associated with the volume
-
Name of the Volume
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 modify
command is not supported for FlexGroup volumes.
Parameters
-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.
The permissible Unicode character set for source mapping is: 0x01-0x19, 0x5C, 0x3A, 0x2A, 0x3F, 0x22, 0x3C, 0x3E, 0x7C, 0xB1.
Examples
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