X-Git-Url: https://git.tokkee.org/?a=blobdiff_plain;f=doc%2Frrddump.txt;h=143e655b22fbb4504f8fd4d5bbae8fa8e93426d4;hb=ab20d85a33204f3395d2ffed3284646979d27e9e;hp=d32ddb93c526b27ac3545804b6c0dff359bba829;hpb=b4e87090e25c68f2ee17d5a63bfa213091121976;p=pkg-rrdtool.git diff --git a/doc/rrddump.txt b/doc/rrddump.txt index d32ddb9..143e655 100644 --- a/doc/rrddump.txt +++ b/doc/rrddump.txt @@ -6,11 +6,8 @@ NNAAMMEE rrddump - dump the contents of an RRD to XML format SSYYNNOOPPSSIISS - rrrrddttooooll dduummpp [----nnoo--hheeaaddeerr|--nn] _f_i_l_e_n_a_m_e_._r_r_d > _f_i_l_e_n_a_m_e_._x_m_l - - or - - rrrrddttooooll dduummpp [----nnoo--hheeaaddeerr|--nn] _f_i_l_e_n_a_m_e_._r_r_d _f_i_l_e_n_a_m_e_._x_m_l + rrrrddttooooll dduummpp _f_i_l_e_n_a_m_e_._r_r_d [_f_i_l_e_n_a_m_e_._x_m_l] [----hheeaaddeerr|--hh {none,xsd,dtd}] + [----nnoo--hheeaaddeerr] [----ddaaeemmoonn _a_d_d_r_e_s_s] > _f_i_l_e_n_a_m_e_._x_m_l DDEESSCCRRIIPPTTIIOONN The dduummpp function writes the contents of an RRRRDD in human readable (?) @@ -26,11 +23,24 @@ DDEESSCCRRIIPPTTIIOONN The (optional) filename that you want to write the XML output to. If not specified, the XML will be printed to stdout. - [----nnoo--hheeaaddeerr|--nn] - 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. + ----hheeaaddeerr|--hh {none,xsd,dtd} + 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. + + ----nnoo--hheeaaddeerr + 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. + + ----ddaaeemmoonn _a_d_d_r_e_s_s + Address of the rrdcached daemon. If specified, a "flush" + command is sent to the server before reading the RRD files. + This allows rrrrddttooooll 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 --ll option in the rrdcached manual. + + rrdtool dump --daemon unix:/var/run/rrdcached.sock /var/lib/rrd/foo.rrd EEXXAAMMPPLLEESS To transfer an RRD between architectures, follow these steps: @@ -43,9 +53,18 @@ EEXXAAMMPPLLEESS 3. Run rrrrddttooooll rreessttoorree to create a new RRD from the XML dump. See rrrrddrreessttoorree for details. +EENNVVIIRROONNMMEENNTT VVAARRIIAABBLLEESS + The following environment variables may be used to change the behavior + of "rrdtool dump": + + RRRRDDCCAACCHHEEDD__AADDDDRREESSSS + 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. + AAUUTTHHOORR Tobias Oetiker -1.3.1 2008-05-16 RRDDUMP(1) +1.3.999 2009-06-09 RRDDUMP(1)