X-Git-Url: https://git.tokkee.org/?a=blobdiff_plain;f=doc%2Frrddump.html;fp=doc%2Frrddump.html;h=10818075b466d5f47445f846abfce5d83989d4ab;hb=ffa00ac697dccce18dca8880ca7a14066521ac5c;hp=ba6e9619078a498a4528160300f00f7ebf74dcea;hpb=51c3d3fb997c22e1ee828470413f1e84989e1f6c;p=pkg-rrdtool.git diff --git a/doc/rrddump.html b/doc/rrddump.html index ba6e961..1081807 100644 --- a/doc/rrddump.html +++ b/doc/rrddump.html @@ -1,18 +1,14 @@ - rrddump - - - -

+ - - -

@@ -38,9 +31,11 @@

SYNOPSIS

-

rrdtool dump [--no-header|-n] filename.rrd > filename.xml

-

or

-

rrdtool dump [--no-header|-n] filename.rrd filename.xml

+

rrdtool dump filename.rrd [filename.xml] +[--header|-h {none,xsd,dtd}] +[--no-header] +[--daemon address] +> filename.xml

@@ -52,44 +47,81 @@ files from one computer architecture to another as well to manipulate the contents of an RRD file in a somewhat more convenient manner.

-
filename.rrd
- +
filename.rrd
+
-

The name of the RRD you want to dump.

+The name of the RRD you want to dump.
-
filename.xml
- +

+
filename.xml
+
-

The (optional) filename that you want to write the XML output to. -If not specified, the XML will be printed to stdout.

+The (optional) filename that you want to write the XML output to. +If not specified, the XML will be printed to stdout.
-
[--no-header|-n]
- +

+
--header|-h {none,xsd,dtd}
+
-

In rrdtool 1.3, the dump function started producing correct xml-headers. -Unfortunately the rrdtool restore function from the 1.2 series can not -handle these headers. With this option you can supress the creatinon of -the xml headers.

+By default rrdtool will add a dtd header to the xml file. Here +you can customize this to and xsd header or no header at all.
-
+

+
--no-header
+
+
+A shortcut for --header=none. +
+
+

If you want to restore the dump with rrdtool 1.2 you should use the +--no-header option since 1.2 can not deal with xml headers.

+
+

+
--daemon address
+
+
+Address of the the rrdcached manpage daemon. If specified, a flush command is sent +to the server before reading the RRD files. This allows rrdtool to return +fresh data even if the daemon is configured to cache values for a long time. +For a list of accepted formats, see the -l option in the the rrdcached manpage manual. +
+
+
+ rrdtool dump --daemon unix:/var/run/rrdcached.sock /var/lib/rrd/foo.rrd
+
+

EXAMPLES

To transfer an RRD between architectures, follow these steps:

    -
  1. -

    On the same system where the RRD was created, use rrdtool dump -to export the data to XML format.

    -
    2. -
  2. -

    Transfer the XML dump to the target system.

    -
    3. -
  3. -

    Run rrdtool restore to create a new RRD from the XML dump. See -rrdrestore for details.

    -
    4. -
+
  • +On the same system where the RRD was created, use rrdtool dump +to export the data to XML format. +

    +
  • +Transfer the XML dump to the target system. +

    +
  • +Run rrdtool restore to create a new RRD from the XML dump. See +rrdrestore for details. +

    +

    +

    +
    +

    ENVIRONMENT VARIABLES

    +

    The following environment variables may be used to change the behavior of +rrdtooldump:

    +
    +
    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. +
    +