Code

Merge branch 'upstream' into experimental
[pkg-rrdtool.git] / doc / rrdresize.txt
1 RRDRESIZE(1)                        rrdtool                       RRDRESIZE(1)
5 N\bNA\bAM\bME\bE
6        rrdresize - alters the size of an RRA and creates a new .rrd file
8 S\bSY\bYN\bNO\bOP\bPS\bSI\bIS\bS
9        r\brr\brd\bdt\bto\boo\bol\bl r\bre\bes\bsi\biz\bze\be _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be _\br_\br_\ba_\b-_\bn_\bu_\bm  G\bGR\bRO\bOW\bW_\b|S\bSH\bHR\bRI\bIN\bNK\bK _\br_\bo_\bw_\bs
11 D\bDE\bES\bSC\bCR\bRI\bIP\bPT\bTI\bIO\bON\bN
12        The r\bre\bes\bsi\biz\bze\be function is used to modify the number of rows in an R\bRR\bRA\bA.
14        _\bf_\bi_\bl_\be_\bn_\ba_\bm_\be
15                the name of the R\bRR\bRD\bD you want to alter.
17        _\br_\br_\ba_\b-_\bn_\bu_\bm the R\bRR\bRA\bA you want to alter. You can find the number using r\brr\brd\bd-\b-
18                t\bto\boo\bol\bl i\bin\bnf\bfo\bo.
20        G\bGR\bRO\bOW\bW    used if you want to add extra rows to an RRA. The extra rows
21                will be inserted as the rows that are oldest.
23        S\bSH\bHR\bRI\bIN\bNK\bK  used if you want to remove rows from an RRA. The rows that will
24                be removed are the oldest rows.
26        _\br_\bo_\bw_\bs    the number of rows you want to add or remove.
28 N\bNO\bOT\bTE\bES\bS
29        The new .rrd file, with the modified RRAs, is written to the file
30        r\bre\bes\bsi\biz\bze\be.\b.r\brr\brd\bd in the current directory.  T\bTh\bhe\be o\bor\bri\big\bgi\bin\bna\bal\bl .\b.r\brr\brd\bd f\bfi\bil\ble\be i\bis\bs n\bno\bot\bt
31        m\bmo\bod\bdi\bif\bfi\bie\bed\bd.
33        It is possible to abuse this tool and get strange results by first
34        removing some rows and then reinserting the same amount (effectively
35        clearing them to be Unknown). You may thus end up with unknown data in
36        one RRA while at the same timestamp this data is available in another
37        RRA.
39 A\bAU\bUT\bTH\bHO\bOR\bR
40        Alex van den Bogaerdt <alex@ergens.op.het.net>
44 1.3.5                             2008-03-15                      RRDRESIZE(1)