.\" -*- mode: troff; coding: utf-8 -*-
.\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43)
.\"
.\" 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
..
.\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>.
.ie n \{\
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    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
.\" ========================================================================
.\"
.IX Title "RRDFLUSHCACHED 1"
.TH RRDFLUSHCACHED 1 2024-03-17 1.7.2 rrdtool
.\" 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
rrdflushcached \- Flush the values for a specific RRD file from memory.
.SH SYNOPSIS
.IX Header "SYNOPSIS"
\&\fBrrdtool\fR \fBflushcached\fR
[\fB\-\-daemon\fR|\fB\-d\fR\ \fIaddress\fR]
\&\fIfilename\fR [\fIfilename\fR ...]
.SH DESCRIPTION
.IX Header "DESCRIPTION"
The \fBflushcached\fR function connects to rrdcached, the RRD caching daemon,
and issues a "flush" command for the given files. The daemon will put the
files to the head of the update queue so they are written "soon". The
status will be returned only after the files' pending updates have been
written to disk.
.IP \fIfilename\fR 8
.IX Item "filename"
The name(s) of the \fBRRD\fR file(s) that are to be written to disk.
.IP "\fB\-\-daemon\fR|\fB\-d\fR \fIaddress\fR" 8
.IX Item "--daemon|-d address"
Address of the rrdcached daemon. If not specified, the
RRDCACHED_ADDRESS environment variable must be set (see below).  For a
list of accepted formats, see the \fB\-l\fR option in the rrdcached
manual.
.Sp
.Vb 1
\& rrdtool flushcached \-\-daemon unix:/var/run/rrdcached.sock /var/lib/rrd/foo.rrd
.Ve
.SH "ENVIRONMENT VARIABLES"
.IX Header "ENVIRONMENT VARIABLES"
The following environment variables may be used to change the behavior of
\&\f(CW\*(C`rrdtool\ flushcached\*(C'\fR:
.IP \fBRRDCACHED_ADDRESS\fR 4
.IX Item "RRDCACHED_ADDRESS"
If this environment variable is set it will have the same effect as specifying
the \f(CW\*(C`\-\-daemon\*(C'\fR option on the command line. If both are present, the command
line argument takes precedence.
.SH AUTHOR
.IX Header "AUTHOR"
Florian Forster <octo\ at\ verplant.org>