NAME

fs_ignorelist - Manages ignorelists of filenames and directory names

SYNOPSIS

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

DESCRIPTION

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.

OPTIONS

-type <type>

Specifies which ignorelist, 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 ignorelist>

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

Clear the ignorelist 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 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.

EXAMPLES

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

ERRATA

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.

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