fstag(1M)fstag(1M)NAMEfstag - create, delete, or list file tags
AVAILABILITY
VRTSvxfs
SYNOPSISfstag create tag [file_path]
fstag delete tag [file_path]
fstag deleteall [file_path]
fstag list [-n] [file_path]
DESCRIPTION
The fstag command creates, deletes, or lists the file tags of a file.
A file tag is an arbitrary ASCII string that is used to classify files
based on any arbitrary criteria. You can have multiple tags per file.
NOTES
The fstag command is supported only on VxFS file systems and will fail
if run on files on a non-VxFS file system.
Symlinks will not be followed, and tagging symlinks will fail.
NFS mount crossings will not be followed, and tagging files on NFS
mounts will fail.
Cluster File System Issues
No cluster issues; command operates the same on cluster file systems.
KEYWORDS
create Creates a tag on the specified file. Duplicate tags are
ignored.
delete Deletes a tag from the specified file. Non-existent tags are
ignored.
deleteall Deletes all tags from the specified file.
list Displays a two column table containing the pathnames and
their corresponding file tags.
OPTIONS-n Suppresses column headings.
ARGUMENTS
tag Specifies the file tag. The tag is an ASCII string of up to
63 characters and cannot contain the / (forward slash) char‐
acter.
file_path Specifies the file pathname on which to run the fstag com‐
mand. You can specify file_path as a single pathname, or as
a list of pathnames with one pathname per line being piped to
the fstab command. If file_path is not specified, fstag
expects to read the pathname from piped output.
EXAMPLES
The following command creates the file tag tag1 on the file
/dst/mds1/file1.db:
# fstag create tag1 /dst/mds1/file1.db
The following command creates the file tag tag1 on the file pathnames
specified on separate lines in the /tmp/fpath plain text file:
# cat /tmp/fpath
/tmp/file1.db
/tmp/file2.db
/tmp/file3.db
# cat /tmp/fpath | fstag create tag1
The following command deletes the file tag tag1 from the file
/dst/mds1/file1.db:
# fstag delete tag1 /dst/mds1/file1.db
The following command deletes the file tag tag1 from the file pathnames
specified on separate lines in the /tmp/fpath plain text file:
# cat /tmp/fpath
/dst/mds1/file1.db
/dst/mds1/file2.db
/dst/mds1/file3.db
# cat /tmp/fpath | fstag delete tag1
The following command deletes all file tags from the file
/dst/mds1/file1.db:
# fstag deleteall /dst/mds1/file1.db
The following command deletes all file tags from the file pathnames
specified on separate lines in the /tmp/fpath plain text file:
# cat /tmp/fpath
/dst/mds1/file1.db
/dst/mds1/file2.db
/dst/mds1/file3.db
# cat /tmp/fpath | fstag deleteall
The following command lists the file tags of the file
/dst/mds1/file1.db:
# fstag list /dst/mds1/file1.db
FILEPATH TAGNAME
======== =======
/dst/mds1/file1.db tag1
/dst/mds1/file1.db tag2
/dst/mds1/file1.db tag3
/dst/mds1/file1.db tag4
The following command lists the file tags of the file pathnames speci‐
fied on separate lines in the /tmp/fpath plain text file:
# cat /tmp/fpath
/dst/mds1/file1.db
/dst/mds1/file2.db
# cat /tmp/fpath | fstag list
FILEPATH TAGNAME
======== =======
/dst/mds1/file1.db tag1
/dst/mds1/file1.db tag2
/dst/mds1/file1.db tag3
/dst/mds1/file1.db tag4
/dst/mds1/file2.db tag2
/dst/mds1/file2.db tag4
The following command lists the file tags of the file
/dst/mds1/file1.db without the output column headings:
# fstag list -n /dst/mds1/file1.db
/dst/mds1/file1.db tag1
/dst/mds1/file1.db tag2
/dst/mds1/file1.db tag3
/dst/mds1/file1.db tag4
SEE ALSOfsppadm(1M), fsppmk(1M)VxFS 5.0 7 Jan 2008 fstag(1M)