fscdstask(1M)fscdstask(1M)NAMEfscdstask - perform various CDS operations
AVAILABILITY
VRTSvxfs
SYNOPSIS
/opt/VRTS/bin/fscdstask limit command mount_point
/opt/VRTS/bin/fscdstask os command [operating_system] mount_point
/opt/VRTS/bin/fscdstask status mount_point
/opt/VRTS/bin/fscdstask validate OS_list mount_point
/opt/VRTS/bin/fscdstask help keyword
DESCRIPTION
The fscdstask script performs various cross-platform data sharing (CDS)
tasks, such as enforcing or ignoring established CDS limits, adding or
removing from the list of operating systems that will be accessing the
file system, and displaying the current CDS settings of a file system.
See the Veritas Storage Foundation Cross-Platform Data Sharing Adminis‐
trator's Guide for more information and examples of usage.
NOTES
The fscdstask command has been deprecated. For all online CDS opera‐
tions, use the fscdsadm command. The fscdstask command is provided for
compatibility with previous VxFS releases and may be discontinued in
future releases.
The specified file system must be mounted before using this script.
Cluster File System Issues
No cluster issues; command operates the same on cluster file systems.
KEYWORDS
limit Causes the established CDS limits to be enforced or ignored
on the specified mount_point. If enforced, the file system
will make an effort to prevent the creation of file system
metadata that exceeds the established limits. If it cannot
determine if file system limits have been exceeded (only pos‐
sible after a full file system check repair operation), it
will allow the mount operation to proceed immediately while
it asynchronously scans the file system to determine whether
limits are actually exceeded. Possible values for command
are:
enforce Enforces established CDS limits. After CDS limits
are enforced for a file system, a file created that
exceeds the established CDS limits will have per‐
missions of 0000 in the destination directory. You
can either delete this partial file or set the
appropriate permissions of the file.
ignore Ignores established CDS limits.
The CDS limits that can be enforced are file size, user ID,
and group ID.
os Manipulates the list of operating systems between which the
specified mount_point will be moved on an ongoing basis. The
file system maintains this list. Adding or removing an oper‐
ating system from the list causes the file system limits to
be adjusted such that only entities that are accessible from
all the operating systems are allowed to be created once the
CDS limits are enforced. Possible values for command are:
add Adds the specified operating_system to the list of
operating systems between which the file system
will be moved on an ongoing basis.
remove Removes the specified operating_system from the
list of operating systems between which the file
system will be moved on an ongoing basis.
none Removes all operating systems from the list of
operating systems between which the file system
will be moved on an ongoing basis.
list Lists the operating systems between which the file
system will be moved on an ongoing basis.
Possible values for operating_system are: AIX, HP-UX, Linux,
or SunOS. The Linux value refers to 32-bit releases of
Linux. The 64-bit Linux limits are the same as or greater
than those for the Solaris operating system. As such, there
is no need to enforce the Linux (32-bit) limits if migrating
from AIX, HP-UX, or the Solaris operating system to 64-bit
Linux.
After invoking the add or remove commands one or more times,
if the list of operating systems between which this file sys‐
tem will be moved is not empty, invoke the limit enforce com‐
mand for the changes to take effect.
After invoking the remove command one or more times, if the
list of operating systems between which this file system
might be moved is empty, invoke the limit ignore command for
the changes to take effect.
Note that changes made through the os keyword take effect
only after invoking the appropriate limit keyword command.
status Displays the current CDS settings of the file system speci‐
fied by mount_point, specifically if the CDS limits have been
enforced on this file system. If the CDS limits have been
enforced, this command can be used to determine if the limits
are being honored. Additionally, status displays CDS policy-
related information, which is useful for debugging purposes.
If one or more operating systems have been added through the
fscdstask os add command for this file system, status pro‐
vides the following additional information:
· A list of operating systems between which the file
system is expected to be moved on a regular basis.
This is the same information as that displayed by the
fscdstask os list command.
· The current maximum values and the limiting values
for the stablished CDS limits. If the CDS limits have
not been enforced, the current values will be dis‐
played as untracked.
validate Determines whether the specified mount_point has entities
with metadata that exceed the limits for operating systems
specified in the OS_list. OS_list is a space-separated list
of operating systems. Possible values for OS_list are: AIX,
HP-UX, Linux, and SunOS. The Linux value refers to 32-bit
releases of Linux. The 64-bit Linux limits are the same as
or greater than those for the Solaris operating system. As
such, when migrating from AIX, HP-UX, or the Solaris operat‐
ing system to 64-bit Linux, no validation is required.
EXAMPLES
To add and remove an OS from the list of OSes:
# fscdstask os add Linux /mnt
# fscdstask os add SunOS /mnt
# fscdstask os list /mnt
Linux SunOS
# fscdstask os remove SunOS /mnt
# fscdstask os list /mnt
Linux
To validate a file system against an OS:
# fscdstask validate Linux /mnt
To display the current CDS status of a file system:
# fscdstask status /mnt
Status:
current untracked
mounted plain
policy none
policy not downgraded
OS list: Linux
.
.
.
CUR_GID=untracked
CUR_SIZE=untracked
CUR_UID=untracked
LIM_GID=4g
LIM_SIZE=16t-64k
LIM_UID=4g
SEE ALSOfscdsadm(1M), fscdsconv(1M), vxcdsconvert(1M), vxdg(1M)
Veritas Storage Foundation Cross-Platform Data Sharing Administrator's
Guide
VxFS 5.0 7 Jan 2008 fscdstask(1M)