Managing Character Mapping for subvolume group

Learn how to manage character mapping in CephFS.

The CephFS subvolume and subvolumegroup interfaces provide a porcelain API to manage character mapping ceph.dir.charmap settings. These settings support name normalization and case sensitivity options.

Configuring Character Mapping

Configure character mapping for a subvolumegroup.

To configure the character mapping for subvolumegroup:

ceph fs subvolumegroup charmap set vol_name group_name setting value

For example,

ceph fs subvolumegroup charmap set vol csi normalization nfd

Outputs:

{"casesensitive":true,"normalization":"nfd","encoding":"utf8"}

Reading Character Mapping

Read character mapping for a subvolumegroup.

To read the character mapping for subvolumegroup:

ceph fs subvolumegroup charmap get vol_name group_name setting

To read the full character mapping for subvolumegroup:

ceph fs subvolumegroup charmap get vol_name group_name

For example,

ceph fs subvolumegroup charmap get vol csi

Outputs:

{"casesensitive":false,"normalization":"nfd","encoding":"utf8"}

Removing Character Mapping

Remove character mapping for a subvolumegroup.

Note: A charmap can only be removed when a subvolumegroup is empty.

To remove the character mapping for subvolumegroup:

ceph fs subvolumegroup charmap rm <vol_name> <group_name>

For example,

ceph fs subvolumegroup charmap rm vol csi

Outputs:

{}