ONTAP 9.12.1 commands

50←PDF
  • ONTAP 9.12.1 commands(CA08871-263en.pdf)
  • 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+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.

    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
    Top of Page