RRDLIST(1) rrdtool RRDLIST(1)

# [NAME](#NAME)

rrdlist - List directories and rrd databases.

# [SYNOPSIS](#SYNOPSIS)

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

# [DESCRIPTION](#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*](#path)

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

[**--daemon**|**-d** *address*](#daemon)

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**](#noflush)

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

[**--recursive**|**-r**](#recursive)

Make the list of rrd databases recursive.

# [ENVIRONMENT VARIABLES](#ENVIRONMENT_VARIABLES)

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

[**RRDCACHED\_ADDRESS**](#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](#AUTHOR)

Sebastien Dugue <sebastien.dugue@atos.net>

2026-09-01 1.11.0

---

Document: rrdlist(1) from rrdtool 1.11.0-r1 (Chainguard OS)
Source: https://github.com/oetiker/rrdtool-1.x