Symantec logo



fscdsadm - perform online Cross-Platform Data Sharing operations on VxFS file systems




fscdsadm -o { add | remove } -t target_specifiers mount_point

fscdsadm -o { list | none } mount_point

fscdsadm -l { enforce | ignore } mount_point

fscdsadm -s mount_point

fscdsadm -v [ -t target_specifiers ] mount_point


The fscdsadm command performs online administration functions for the Veritas File System Cross-Platform Data Sharing (CDS) feature. Maintaining the list of targets between which the file system is regularly migrated, enforcing or ignoring established CDS limits, validating the file system to detect violations of these limits, and displaying the current CDS state of the file system are some of the tasks that can be performed on VxFS file system through the fscdsadm command.

mount_point specifies the directory on which the file system to be migrated is mounted.

target_specifiers specifies the target to which the file system is proposed to be migrated.


In the 4.0 and 4.1 releases of VxFS, the fscdstask script was provided to perform the various VxFS CDS administration tasks. Starting in the VxFS 5.0 release, the fscdsadm command should be used to perform all online CDS tasks on VxFS file systems. The fscdstask script is deprecated and is provided only for backward compatibility with previous releases. The support for the fscdstask script may be discontinued in future VxFS releases.

The VxFS CDS commands, fscdsadm and fscdsconv, use the information available in the CDS limits file, /opt/VRTS/bin/cdslimitstab. The limits file is installed as part of the VRTSvxfs package. Do not edit /opt/VRTS/bin/cdslimitstab manually.

Cluster File System Issues

No cluster issues; command operates the same on cluster file systems.



Specifies the limit enforcement CDS commands. The valid options are:


Causes the established CDs limits to be enforced on mount_point. When the CDS limits are enforced, the file system prevents the creation of any new file system metadata that exceeds the established limits. The CDS limits that can be enforced are file size, UID, and GID. After enforcing the CDS limits, a file created that exceeds the established CDS limits will have permissions 0000 in the destination directory. You can either delete this partial file, or set the appropriate permissions on the file. Enforcing the CDS limits has no effect on files violating the limits that already exist in the file system at the time when the limits are being enforced. Use the validation capability of fscdsadm to detect and rectify these violations.


Causes the enforced CDS limits to be ignored on mount_point. Once the CDS limits have been ignored, the file system will no longer control activities that might cause the CDS limits to be violated.


Specifies the CDS commands for target list manipulation. The valid options are:


Adds the specified target to the list of targets between which the file system mounted at mount_point will be migrated on an ongoing basis. The target list is maintained by the file system. The CDS limits, when enforced, are determined by the constituents of the target list of mount_point. If the CDS limits are already enforced when a new target is added, the limits corresponding to the newly added target will be reflected in the enforced limits.


Removes the specified target from the target list of mount_point. If the CDS limits are already enforced when a target is removed, the limits corresponding to the newly removed target will be reflected in the enforced limits. If the target list becomes empty by removing the specified target and if the CDS limits are already enforced, the CDS limits will be ignored since the target is now empty.


Removes all targets from the target list of mount_point. If the CDS limits are already enforced, the CDS limits will be ignored since the target list is now empty.


Lists information regarding the targets that are in the target list of mount_point. The following information is displayed for each target in the target list:

Displays the following information regarding the CDS state of mount_point:


The following command adds an HP-UX/11.23 system running VxFS 4.1 to the target list of a file system that is currently on Linux:

# fscdsadm -o add -t os_name=HP-UX,os_rel=11.23,vxfs_vers=4.1 /mnt1

The arch and bits are not specified as part of the target in the above example. This causes the command to assume the defaults in accordance with the definition provided for the target in the limits file.

The following command enforces the CDS limits:

# fscdsadm -l enforce /mnt1

The following command validates the file ssytem to detect if any limits are violated for an HP-UX/IA target:

# fscdsadm -v -t os_name=HP-UX,arch=ia /mnt1



Veritas Storage Foundation Cross-Platform Data Sharing Administrator's Guide