X-Git-Url: https://git.tokkee.org/?a=blobdiff_plain;f=doc%2Frrdcached.txt;fp=doc%2Frrdcached.txt;h=a550a5613af4ce7025839b4f7df1e03f41e2b9cd;hb=91b2f1022a195d008d818f283690ef63a00fd79c;hp=fdacd186880328a23acaf738bed73492233e0f1e;hpb=fa3f1e567e9c848683aefaa1a1f5e68340c7a5f2;p=pkg-rrdtool.git diff --git a/doc/rrdcached.txt b/doc/rrdcached.txt index fdacd18..a550a56 100644 --- a/doc/rrdcached.txt +++ b/doc/rrdcached.txt @@ -19,7 +19,7 @@ DDEESSCCRRIIPPTTIIOONN The daemon was written with big setups in mind. Those setups usually run into IO related problems sooner or later for reasons that are - beyond the scope of this document. Check the wiki at the RRDTool + beyond the scope of this document. Check the wiki at the RRDtool homepage for details. Also check "SECURITY CONSIDERATIONS" below before using this daemon! A detailed description of how the daemon operates can be found in the "HOW IT WORKS" section below. @@ -73,9 +73,9 @@ OOPPTTIIOONNSS A complete list of available commands can be found in the section "Valid Commands" below. There are two minor special exceptions: - · The "HELP" and "QUIT" commands are always allowed. + · The "HELP" and "QUIT" commands are always allowed. - · If the "BATCH" command is accepted, the .. command will + · If the "BATCH" command is accepted, the .. command will automatically be accepted, too. Please also read "SECURITY CONSIDERATIONS" below. @@ -173,16 +173,25 @@ AAFFFFEECCTTEEDD RRRRDDTTOOOOLL CCOOMMMMAANNDDSS command line argument ----ddaaeemmoonn or the environment variable RRRRDDCCAACCHHEEDD__AADDDDRREESSSS: - dduummpp - ffeettcchh - fflluusshh - ggrraapphh - ggrraapphhvv - iinnffoo - llaasstt - llaassttuuppddaattee - uuppddaattee - xxppoorrtt + · dump + + · fetch + + · flush + + · graph + + · graphv + + · info + + · last + + · lastupdate + + · update + + · xport The uuppddaattee command can send values to the daemon instead of writing them to the disk itself. All other commands can send a FFLLUUSSHH command @@ -209,7 +218,7 @@ HHOOWW IITT WWOORRKKSS When appending a value to a tree node, it is checked whether it's time to write the values to disk. Values are written to disk if "now() - First >= timeout", where "timeout" is the timeout specified - using the --ww option, see OPTIONS. If the values are "old enough" they + using the --ww option, see "OPTIONS". If the values are "old enough" they will be enqueued in the "update queue", i. e. they will be appended to the linked list shown below. Because the tree nodes and the elements of the linked list are the same data structures in memory, any update @@ -264,19 +273,19 @@ HHOOWW IITT WWOORRKKSS The above diagram demonstrates: - · Files/values are stored in a (balanced) tree. + · Files/values are stored in a (balanced) tree. - · Tree nodes and entries in the update queue are the same data + · Tree nodes and entries in the update queue are the same data structure. - · The local time ("First") and the time specified in updates ("Time") + · The local time ("First") and the time specified in updates ("Time") may differ. - · Timed out values are inserted at the "tail". + · Timed out values are inserted at the "tail". - · Explicitly flushed values are inserted at the "head". + · Explicitly flushed values are inserted at the "head". - · ASCII art rocks. + · ASCII art rocks. SSEECCUURRIITTYY CCOONNSSIIDDEERRAATTIIOONNSS AAuutthheennttiiccaattiioonn @@ -322,11 +331,11 @@ SSEECCUURRIITTYY CCOONNSSIIDDEERRAATTIIOONNSS the future, your files will be messed up good! CCoonncclluussiioonn - · Security is the job of the administrator. + · Security is the job of the administrator. - · We recommend to allow write access via UNIX domain sockets only. + · We recommend to allow write access via UNIX domain sockets only. - · You have been warned. + · You have been warned. PPRROOTTOOCCOOLL The daemon communicates with clients using a line based ASCII protocol @@ -525,12 +534,13 @@ SSEEEE AALLSSOO rrdtool, rrdgraph AAUUTTHHOORR - rrrrddccaacchheedd and this manual page have been written by Florian Forster - . + Florian Forster + + Both rrrrddccaacchheedd and this manual page have been written by Florian. CCOONNTTRRIIBBUUTTOORRSS kevin brintnall -1.3.999 2009-09-24 RRDCACHED(1) +1.4.2 2009-11-15 RRDCACHED(1)