fs_blacklist - Manages blacklists of filenames and directory names
fs blacklist -type <blacklist to modify> [-newlist <new blacklist>]+ [-clear] [-help]
The fs blacklist 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 blacklist. Adding file names to the blacklist is useful to avoid unwanted network traffic when the file name is known not to exist.
Specifies which blacklist, 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 blacklist 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 blacklist 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 blacklist for the type named in the -type argument in the following format:
Current <type> blacklist is '<entry1>' '<entry2>' '<entryN>
When the -newlist argument is included, the output is the following:
fs: new <type> blacklist set.
The following example shows the output produced when the nodns list is queried:
% fs blacklist dns Current dns blacklist is '.DS_Store'
The following command defines an afsmountdir list containing 2 entries:
% fs blacklist -type afsmountdir -newlist .Spotlight-V100 metadata_never_index_unless_rootfs fs: new afsmountdir blacklist set.
The first command clears the volroot list. The second command queries the new blacklist.
% fs blacklist -type volroot -clear fs: new volroot blacklist set. % fs blacklist volroot No volroot blacklist was found
The current implementation of the volroot and volrootprefix blacklists only apply when fakestat is enabled.
The current implementation of the afsmountdir blacklist 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
The OpenAFS Quick Start Guide at http://docs.openafs.org/QuickStartUnix/.
The OpenAFS Administration Guide http://docs.openafs.org/AdminGuide/.
Copyright AuriStor, Inc. 2014-2020. 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.