---
name: "rrdlist"
section: "1"
platform: "linux"
package: "rrdtool"
version: "1.11.0-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/rrdlist"
---

# rrdlist(1)

List directories and rrd databases.

## NAME

rrdlist - List directories and rrd databases.

## SYNOPSIS

**rrdtool** **list** \[**--daemon**\|**-d** *address*\] \[**--noflush**\|**-F**\] \[**--recursive**\|**-r**\] *path*

## DESCRIPTION

The **list** function provides an 'ls-like' interface for traversing and listing the rrd database tree.

When using the **--daemon** option, the **list** function connects to rrdcached, the RRD caching daemon, and issues a "list" command for the given path.

- *path*

  The path (starting with '/') with '/' being the rrdcached base\_dir.

- **--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 **-l** option in the rrdcached manual.

  ```
   rrdtool list --daemon 127.0.0.1:42218 /cluster/nodes/node1
  ```

- **--noflush**\|**-F**

  When using a daemon, `"rrdtool list"` will usually flush its cache to the disk before performing operations. This option disables cache flushing.

- **--recursive**\|**-r**

  Make the list of rrd databases recursive.

## ENVIRONMENT VARIABLES

The following environment variables may be used to change the behavior of `"rrdtool list"`:

- **RRDCACHED\_ADDRESS**

  If this environment variable is set it will have the same effect as specifying the `"--daemon"` option on the command line. If both are present, the command line argument takes precedence.

## AUTHOR

Sebastien Dugue \<sebastien.dugue@atos.net\>