fs_ignorelist - Manages ignorelists of filenames and directory names
fs ignorelist -type <ignorelist to modify> [-newlist <new ignorelist>]+ [-clear] [-help]
The fs ignorelist command sets or displays the local Cache Manager's list of filenames to ignore in the /afs/ directory and volume root directories. The Cache Manager will avoid contacting DNS or file servers for file names that exist on the ignorelist. Adding file names to the ignorelist is useful to avoid unwanted network traffic when the file name is known not to exist.
Specifies which ignorelist, by type, will be read or modified.
Do not perform DNS lookups for AFSDB or SRV records of a cell with this name.
Do not perform filename lookups in the root of a volume for names in this list. This is used to preclude crossing mountpoints when for instance a graphical environment may be looking for context about entries across an entire directory.
Do not perform filename lookups in the root of a volume for names beginning with strings in this list. This is used to preclude crossing mountpoints when for instance a graphical environment may be looking for context about entries across an entire directory.
Do not perform filename lookups in the root of the AFS mount; Instead act as if an empty file by the name specified exists.
Sets the ignorelist of the type specified in the -type argument. This option may be used multiple times in the same invocation, which sets the list to include multiple entries.
If both this argument and clear is omitted, the output displays the current setting instead.
Clear the ignorelist of the type specified in the -type argument.
This cannot be specified with the -newlist argument.
Prints the online help for this command. All other valid options are ignored.
When the -newlist argument is omitted, the output reports the machine's ignorelist for the type named in the -type argument in the following format:
Current <type> ignorelist is '<entry1>' '<entry2>' '<entryN>
When the -newlist argument is included, the output is the following:
fs: new <type> ignorelist set.
The following example shows the output produced when the nodns list is queried:
% fs ignorelist dns Current dns ignorelist is '.DS_Store'
The following command defines an afsmountdir list containing 2 entries:
% fs ignorelist -type afsmountdir -newlist .Spotlight-V100 metadata_never_index_unless_rootfs fs: new afsmountdir ignorelist set.
The first command clears the volroot list. The second command queries the new ignorelist.
% fs ignorelist -type volroot -clear fs: new volroot ignorelist set. % fs ignorelist volroot No volroot ignorelist was found
The current implementation of the volroot and volrootprefix ignorelists only apply when fakestat is enabled.
The current implementation of the afsmountdir ignorelist only applies in dynroot mode.
To display the current setting, no privilege is required. To include the -newlist argument on an AFS client machine, the issuer must be logged in as the local superuser root.
The OpenAFS Quick Start Guide at http://docs.openafs.org/QuickStartUnix/.
The OpenAFS Administration Guide http://docs.openafs.org/AdminGuide/.
Copyright AuriStor, Inc. 2014-2021. https://www.auristor.com/ All Rights Reserved.
"AFS" is a registered mark of International Business Machines Corporation, used under license. (USPTO Registration 1598389)
"OpenAFS" is a registered mark of International Business Machines Corporation. (USPTO Registration 4577045)
The "AuriStor" name, log 'S' brand mark, and icon are registered marks of AuriStor, Inc. (USPTO Registrations 4849419, 4849421, and 4928460) (EUIPO Registration 015539653).
"Your File System" is a registered mark of AuriStor, Inc. (USPTO Registrations 4801402 and 4849418).
"YFS" and "AuriStor File System" are trademarks of AuriStor, Inc.