X-Git-Url: https://git.tokkee.org/?a=blobdiff_plain;f=doc%2Frrdtutorial.1;h=db57748d29e9993fddafab501cdcb6a73f7d5c90;hb=d9822df7ed5e8122cf3a62e4e99678e94007f504;hp=d0bad20183467f0f413d8fa6e36f44be1270ccfd;hpb=fd248121a4d1324289fcb6d0429613c6708cd559;p=pkg-rrdtool.git diff --git a/doc/rrdtutorial.1 b/doc/rrdtutorial.1 index d0bad20..db57748 100644 --- a/doc/rrdtutorial.1 +++ b/doc/rrdtutorial.1 @@ -1,4 +1,4 @@ -.\" Automatically generated by Pod::Man 2.1801 (Pod::Simple 3.05) +.\" Automatically generated by Pod::Man 2.25 (Pod::Simple 3.16) .\" .\" Standard preamble: .\" ======================================================================== @@ -124,7 +124,7 @@ .\" ======================================================================== .\" .IX Title "RRDTUTORIAL 1" -.TH RRDTUTORIAL 1 "2009-10-15" "1.4.3" "rrdtool" +.TH RRDTUTORIAL 1 "2013-05-23" "1.4.8" "rrdtool" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l @@ -181,7 +181,7 @@ element. As we are on a circle there is neither a beginning nor an end, you can go on and on and on. After a while, all the available places will be used and the process automatically reuses old locations. This way, the dataset will not grow in size and therefore requires no maintenance. -RRDtool works with with Round Robin Databases (RRDs). It stores and retrieves +RRDtool works with Round Robin Databases (RRDs). It stores and retrieves data from them. .SS "What data can be put into an \s-1RRD\s0?" .IX Subsection "What data can be put into an RRD?" @@ -447,14 +447,19 @@ It should return the following output: \& 920808600: 6.6666666667e\-03 \& 920808900: 3.3333333333e\-03 \& 920809200: nan +\& 920809500: nan .Ve .PP -If it doesn't, something may be wrong. Perhaps your \s-1OS\s0 will print -\&\*(L"NaN\*(R" in a different form. \*(L"NaN\*(R" stands for \*(L"Not A Number\*(R". If your \s-1OS\s0 -writes \*(L"U\*(R" or \*(L"\s-1UNKN\s0\*(R" or something similar that's okay. If something -else is wrong, it will probably be due to an error you made (assuming -that my tutorial is correct of course :\-). In that case: delete the -database and try again. +Note that you might get more rows than you expect. The reason for this is +that you ask for a time range that ends on 920809200. The number that is +written behind 920809200: in the list above covers the time range from +920808900 to 920809200, \s-1EXCLUDING\s0 920809200. Hence to be on the sure side, +you receive the entry from 920809200 to 920809500 as well since it \s-1INCLUDES\s0 +920809200. You may also see \*(L"NaN\*(R" instead of \*(L"nan\*(R" this is \s-1OS\s0 dependent. +\&\*(L"NaN\*(R" stands for \*(L"Not A Number\*(R". If your \s-1OS\s0 writes \*(L"U\*(R" or \*(L"\s-1UNKN\s0\*(R" or +something similar that's okay. If something else is wrong, it will probably +be due to an error you made (assuming that my tutorial is correct of course +:\-). In that case: delete the database and try again. .PP The meaning of the above output will become clear below. .SS "Time to create some graphics"