Purpose
Displays the tag names for tagged directories or file names in Oracle ACFS file systems.
Syntax and Description
acfsutil tag info -h acfsutil tag info [-r] [-c -t tagname] path [path ...] acfsutil tag info [-c -t tagname]
acfsutil tag info -h displays help text and exits.
Table 16-26 contains the options available with the acfsutil tag info command.
Table 16-26 Options for the acfsutil tag info command
| Option | Description |
|---|---|
|
|
Specifies the tag name string to display. Enclose the string in quotes if the string contains a space. |
|
|
Specifies the path name to one or more files or directories. |
|
|
Specifies recursive action on a specified path. |
|
|
Specifies case-insensitive partial matching on the tag name. |
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 that the user has read access privileges.
Running acfsutil tag info on a file or directory that is protected by a security realm fails. If a user runs acfsutil tag info with the -r option on a directory protected by a security realm and the user does not have browse permissions on the directory, then no output is displayed. To resolve this issue, the user must be added to the security realm and granted READDIR permissions. For information about adding objects to an Oracle ACFS security realm, refer to "acfsutil sec realm add".
Examples
The following example show the use of the acfsutil tag info command.