.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\"
.\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2).
.\" Fear.  Run.  Save yourself.  No user-serviceable parts.
.    \" fudge factors for nroff and troff
.if n \{\
.    ds #H 0
.    ds #V .8m
.    ds #F .3m
.    ds #[ \f1
.    ds #] \fP
.\}
.if t \{\
.    ds #H ((1u-(\\\\n(.fu%2u))*.13m)
.    ds #V .6m
.    ds #F 0
.    ds #[ \&
.    ds #] \&
.\}
.    \" simple accents for nroff and troff
.if n \{\
.    ds ' \&
.    ds ` \&
.    ds ^ \&
.    ds , \&
.    ds ~ ~
.    ds /
.\}
.if t \{\
.    ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u"
.    ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u'
.    ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u'
.    ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u'
.    ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u'
.    ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u'
.\}
.    \" troff and (daisy-wheel) nroff accents
.ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V'
.ds 8 \h'\*(#H'\(*b\h'-\*(#H'
.ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#]
.ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H'
.ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u'
.ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#]
.ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#]
.ds ae a\h'-(\w'a'u*4/10)'e
.ds Ae A\h'-(\w'A'u*4/10)'E
.    \" corrections for vroff
.if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u'
.if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u'
.    \" for low resolution devices (crt and lpr)
.if \n(.H>23 .if \n(.V>19 \
\{\
.    ds : e
.    ds 8 ss
.    ds o a
.    ds d- d\h'-1'\(ga
.    ds D- D\h'-1'\(hy
.    ds th \o'bp'
.    ds Th \o'LP'
.    ds ae ae
.    ds Ae AE
.\}
.rm #[ #] #H #V #F C
.\" ========================================================================
.\"
.IX Title "FS_SETCACHESIZE 1"
.TH FS_SETCACHESIZE 1 "2021-01-14" "OpenAFS" "AFS Command Reference"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.SH "NAME"
fs_setcachesize \- Sets the size of the disk cache
.SH "SYNOPSIS"
.IX Header "SYNOPSIS"
\&\fBfs setcachesize\fR [\fB\-blocks\fR <\fIsize (0 =\fR reset)>>] [\fB\-reset\fR] [\fB\-help\fR]
.PP
\&\fBfs setca\fR [\fB\-b\fR <\fIsize (0 =\fR reset)>>] [\fB\-r\fR] [\fB\-h\fR]
.PP
\&\fBfs cachesize\fR [\fB\-b\fR <\fIsize (0 =\fR reset)>>] [\fB\-r\fR] [\fB\-h\fR]
.PP
\&\fBfs ca\fR [\fB\-b\fR <\fIsize (0 =\fR reset)>>] [\fB\-r\fR] [\fB\-h\fR]
.SH "DESCRIPTION"
.IX Header "DESCRIPTION"
The \fBfs setcachesize\fR command changes the number of kilobyte blocks of
local disk space available to the Cache Manager for its data cache, on
machines that use a disk cache. The command is not operative on machines
that use a memory cache.
.PP
To return the cache size to the default value specified in the third field
of the local \fI/etc/openafs/cacheinfo\fR file, provide a value of \f(CW0\fR to
the \fB\-blocks\fR argument.
.PP
To return the cache size to the value set when the machine was last
rebooted, use the \fB\-reset\fR flag instead of the \fB\-blocks\fR argument. This
is normally the amount specified in the \fIcacheinfo\fR file, unless the
\&\fB\-blocks\fR argument was included on the \fBafsd\fR command to override the
\&\fBcacheinfo\fR value.
.PP
To display the current cache size and amount of cache in use, for both
disk and memory caches, use the \fBfs getcacheparms\fR command.
.SH "CAUTIONS"
.IX Header "CAUTIONS"
This command is not operative on machines using a memory cache, and
results in an error message. To change memory cache size, edit the
\&\fBcacheinfo\fR file and reboot, or reboot and provide the \fB\-blocks\fR
argument to the \fBafsd\fR command.
.PP
On machines using a disk cache, do not set the cache size to exceed 85% to
90% of the actual disk space available for the cache directory. The cache
implementation itself requires a small amount of space on the partition.
.SH "OPTIONS"
.IX Header "OPTIONS"
.IP "\fB\-blocks\fR <\fIsize\fR>" 4
.IX Item "-blocks <size>"
Specifies the amount of disk space available for the Cache Manager to
devote to the cache.  The size should be a positive integer followed by an
optional suffix: \f(CW\*(C`K\*(C'\fR for kibibytes (1024 bytes, the default), \f(CW\*(C`M\*(C'\fR for
mebibytes (1024 kibibytes), \f(CW\*(C`G\*(C'\fR for gibibytes (1024 mebibytes), and \f(CW\*(C`T\*(C'\fR
for tebibytes (1024 gibibytes).  Provide a value of \f(CW0\fR to set cache size
to the default specified in the \fIcacheinfo\fR file.
.IP "\fB\-reset\fR" 4
.IX Item "-reset"
Returns the cache size to the value set when the machine was last
booted. This agrees with the value in the \fIcacheinfo\fR file unless the
\&\fB\-blocks\fR argument was used on the \fBafsd\fR command.
.IP "\fB\-help\fR" 4
.IX Item "-help"
Prints the online help for this command. All other valid options are
ignored.
.SH "EXAMPLES"
.IX Header "EXAMPLES"
The following command sets the disk cache size to 25000 kilobyte blocks.
.PP
.Vb 1
\&   % fs setcachesize \-blocks 25000
.Ve
.PP
Both of the following commands reset the disk cache size to the value in
the \fIcacheinfo\fR file, assuming that the \fB\-blocks\fR argument to the
\&\fBafsd\fR command was not used.
.PP
.Vb 2
\&   % fs setcachesize \-blocks 0
\&   % fs setcachesize \-reset
.Ve
.SH "PRIVILEGE REQUIRED"
.IX Header "PRIVILEGE REQUIRED"
The issuer must be logged in as the local superuser root.
.SH "SEE ALSO"
.IX Header "SEE ALSO"
\&\fBcacheinfo\fR\|(5),
\&\fBafsd\fR\|(8),
\&\fBfs_getcacheparms\fR\|(1)
.SH "COPYRIGHT"
.IX Header "COPYRIGHT"
\&\s-1IBM\s0 Corporation 2000. <http://www.ibm.com/> All Rights Reserved.
.PP
This documentation is covered by the \s-1IBM\s0 Public License Version 1.0.  It was
converted from \s-1HTML\s0 to \s-1POD\s0 by software written by Chas Williams and Russ
Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.