NAME

fs_blacklist - Manages blacklists of filenames and directory names

SYNOPSIS

fs blacklist -type <blacklist to modify> [-newlist <new blacklist>]+ [-clear] [-help]

DESCRIPTION

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.

OPTIONS

-type <type>

Specifies which blacklist, by type, will be read or modified.

dns

Do not perform DNS lookups for AFSDB or SRV records of a cell with this name.

volroot

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.

volrootprefix

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.

afsmountdir

Do not perform filename lookups in the root of the AFS mount; Instead act as if an empty file by the name specified exists.

-newlist <new blacklist>

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

Clear the blacklist of the type specified in the -type argument.

This cannot be specified with the -newlist argument.

-help

Prints the online help for this command. All other valid options are ignored.

OUTPUT

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.

EXAMPLES

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

ERRATA

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.

PRIVILEGE REQUIRED

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.

SEE ALSO

The OpenAFS Quick Start Guide at http://docs.openafs.org/QuickStartUnix/.

The OpenAFS Administration Guide http://docs.openafs.org/AdminGuide/.

COPYRIGHT

Copyright AuriStor, Inc. 2014-2017. https://www.auristor.com/ All Rights Reserved.

ACKNOWLEDGEMENTS

"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.