Oracle ACFS Command-Line Tools for Tagging (2024)

acfsutil tag info -hacfsutil tag info [-r] [-c -t tagname] path [path ...]acfsutil tag info [-c -t tagname]

acfsutil tag info -h displays help text and exits.

Table 6-36 contains the options available with the acfsutil tag info command.

Table 6-36 Options for the acfsutil tag info command

The acfsutil tag info command can recursively apply the operation to all child files and subdirectories if the -r option is included with specified directory path names.

If no path names are specified, the acfsutil tag info command searches all Oracle ACFS mount points for tagged files.

Only the paths of tagged files in an Oracle ACFS file system are displayed. If the -t tagname option is included, only paths of files with a tag name exactly matching the specified tagname are displayed. If the -c option is included, then tagname can be a case-insensitive substring of a tag name for a successful match. For example, the acfsutil tag info -c -t AG command would display path names of files with tag names such as tag1, ag, or AG.

Any user may use this command to display tag info on a directory to which the user has read access.

Example 6-26 Using the acfsutil tag info command

$ /sbin/acfsutil tag info -r /acfsmounts/acfs1/myrepfiles/

acfsutil tag set -hacfsutil tag set [-v] [-r] tagname path [path ...]

acfsutil tag set -h displays help text and exits.

Table 6-37 contains the options available with the acfsutil tag set command.

Table 6-37 Options for the acfsutil tag set command

The command can recursively apply the operation to all child files and subdirectories for the specified directory path names.

When adding a tag name to a file or directory, the existing tags on that file or directory remain unchanged. New files that are created after a directory is assigned a tag implicitly inherit tags from their parent directories. Existing files in the directory do not inherit the new tag; these files must be explicitly assigned the tag. Renaming a file or moving a file to a subdirectory within the same file system does not cause the file to inherit tag names from the new parent directory. Moving a file between file systems uses a copy operation and the newly created file does inherit the tag names of the parent directory.

There is no fixed maximum number of tag names for an Oracle ACFS file system or for each file and directory. However, the number of tag names is limited by the tag names that fit in up to 64 KB of special metadata storage for each file and directory. This metadata also contains information to manage the extended attributes. Longer tag names reduce the total of tag names that can be set on a file or directory. For example, if all tag names were 4 bytes long, then it is possible to hold approximately 1730 tag names, assuming no other extended attribute information is present.

Any user who has the privilege to modify the target file or directory may run this command.

Example 6-27 Using the acfsutil tag set command

$ /sbin/acfsutil tag set repl_grp1 -r /acfsmounts/acfs1/myrepfiles/*.dat

acfsutil tag unset -hacfsutil tag unset [-v] [-r] {all | tagname} path [path ...]

acfsutil tag unset -h displays help text and exits.

Table 6-38 contains the options available with the acfsutil tag unset command.

Table 6-38 Options for the acfsutil tag unset command

The command can recursively apply the operation to all child files and subdirectories for the specified directory path names.

When removing a tag name from a file or directory, other existing tags on that file or directory remain unchanged.

Any user who has privilege to modify the target file or directory may run this command.

Example 6-28 Using the acfsutil tag unset command

$ /sbin/acfsutil tag unset repl_grp1 -r /acfsmounts/acfs1/myrepfiles/*.log