


rrdtool                                              RRDUPDATE(1)



NNNNAAAAMMMMEEEE
     rrdtool update - Store a new set of values into the rrd

SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
     rrrrrrrrddddttttoooooooollll uuuuppppddddaaaatttteeee _f_i_l_e_n_a_m_e [--------tttteeeemmmmppppllllaaaatttteeee|----tttt _d_s_-_n_a_m_e[::::_d_s_-_n_a_m_e]...]
     NNNN|_t_i_m_e_s_t_a_m_p::::_v_a_l_u_e[::::_v_a_l_u_e...]
     [_t_i_m_e_s_t_a_m_p::::_v_a_l_u_e[::::_v_a_l_u_e...] ...]

DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
     The uuuuppppddddaaaatttteeee function feeds new data values into an RRRRRRRRDDDD. The
     data gets time aligned according to the properties of the
     RRRRRRRRDDDD to which the data is written.

     _f_i_l_e_n_a_m_e
             The name of the RRRRRRRRDDDD you want to update.

     --------tttteeeemmmmppppllllaaaatttteeee|----tttt _d_s_-_n_a_m_e[::::_d_s_-_n_a_m_e]...
             by default, the update function expects the data
             input in the order, the data sources are defined in
             the RRD. This is not very error resistant, as you
             might be sending the wrong data into a RRD.

             The template switch allows you to specify which data
             sources you are going to update and in which order.
             If the data sources specified in the template are
             not available in the rrd file, the update process
             will abort with an error message.

     NNNN|_t_i_m_e_s_t_a_m_p::::_v_a_l_u_e[::::_v_a_l_u_e...]
             The data used for updating the RRD was acquired at a
             certain time. This time can either be defined in
             seconds since 1970-01-01. Or by using the letter 'N'
             the update time is set to be the current time.
             Negative time values are subtracted from the current
             time.  Getting the timing right to the second is
             especially important when you are working with data-
             sources of type CCCCOOOOUUUUNNNNTTTTEEEERRRR, DDDDEEEERRRRIIIIVVVVEEEE or AAAABBBBSSSSOOOOLLLLUUUUTTTTEEEE.

             The remaining elements of the argument are DS
             updates. The order of this list is the same as the
             order the data sources were defined in the rra.  If
             there is no data for a certain data-source, the
             letter UUUU (eg. N:0.1:U:1) can be defined.

             The format of the value acquired from the data
             source is dependent of the data source type chosen.
             Normally it will be numeric, but the data
             acquisition modules my impose their very own parsing
             of this parameter as long as the colon (::::) remains
             the data source value separator.





2001-02-20             Last change: 1.0.33                      1






rrdtool                                              RRDUPDATE(1)



EEEEXXXXAAAAMMMMPPPPLLLLEEEE
     `rrdtool update demo1.rrd N:3.44:3.15:U:23'

     Update the database file demo1.rrd with 3 known and one
     _*_U_N_K_N_O_W_N_* value. Use the current time as the update time.

     `rrdtool update demo2.rrd 887457267:U 887457521:22
     88745790:2.7'

     Update the database file demo2.rrd which expects data from a
     single data-source, three times. First with an _*_U_N_K_N_O_W_N_*
     value then with two normal readings. The update interval
     seems to be around 300 seconds.

AAAAUUUUTTTTHHHHOOOORRRR
     Tobias Oetiker <oetiker@ee.ethz.ch>







































2001-02-20             Last change: 1.0.33                      2



