X-Git-Url: https://git.tokkee.org/?a=blobdiff_plain;f=doc%2Frrddump.txt;h=cad185cd3a25fc89fed602f44c6be33050fce57e;hb=d9822df7ed5e8122cf3a62e4e99678e94007f504;hp=717982676ad83b5459561bec40d272b01795cf89;hpb=91345775ebb70f3899781018f95d78076f1e6f23;p=pkg-rrdtool.git diff --git a/doc/rrddump.txt b/doc/rrddump.txt index 7179826..cad185c 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.5 2008-05-16 RRDDUMP(1) +1.4.8 2013-05-23 RRDDUMP(1)