NAME

fs_bypassthreshold - get/set Cache Bypass file size threshold [LINUX only]

SYNOPSIS

fs bypassthreshold [-size <file size>] [-help]

DESCRIPTION

The fs bypassthreshold command either changes the Auristor client Cache Bypass file size threshold, or reports the current threshold. Normally, when an application tries to read data via the Auristor client, the client will fetch the required data from the fileserver, store the results in the local cache, and then serve the application request from the local cache. When the Cache Bypass feature is enabled, certain files will be read directly from the network, and the data will not be saved to the local cache. In some scenarios, this can provide a significant performance improvement, especially if the data is only read once.

Currently, the only way to specify which files should bypass the cache and which files should not, is by file size. In the future, different mechanisms may exist for specifying which files should bypass the local cache and which should not.

If -size is not specified, fs bypassthreshold just reports the current threshold and exits.

CAUTIONS

The fs bypassthreshold command is only available on LINUX platforms. There is no equivalent functionality on other platforms.

OPTIONS

-size <file size>

Specifies how large a file must be in order to enable Cache Bypass mode. If a file is larger than the specified file size (in bytes), reading from that file will bypass the local cache and be read directly from the network. A file size of -1 indicates that Cache Bypass should be disabled completely, so no files will enable Cache Bypass mode, no matter how large they are.

By default Cache Bypass is disabled for files of all sizes.

-help

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

OUTPUT

The output format is identical whether or not -size was specified. If -size is specified, the bypass threshold is changed, and the output contains the new, changed, threshold. Otherwise the output contains the current threshold.

EXAMPLES

The following example turns on Cache Bypass with a threshold of 4KiB:

   % fs bypassthreshold 4096
   Cache bypass threshold 4096

The following example disables Cache Bypass:

   % fs bypassthreshold -1
   Cache bypass threshold -1 (disabled)

The following example examines the current Cache Bypass threshold:

   % fs bypassthreshold
   Cache bypass threshold 4096

PRIVILEGE REQUIRED

To set the bypass threshold, the issuer must be logged in as the local superuser root. Otherwise, no privilege is required.

COPYRIGHT

Portions Copyright 2012 Sine Nomine Associates

This documentation is covered by the BSD License as written in the doc/LICENSE file. The original version of this man page was written by Andrew Deason for OpenAFS.

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.