X-Git-Url: https://git.tokkee.org/?a=blobdiff_plain;f=doc%2Frrdcached.txt;h=f2091de9c0309936b43c3af8437be656f4b806a7;hb=fd248121a4d1324289fcb6d0429613c6708cd559;hp=a550a5613af4ce7025839b4f7df1e03f41e2b9cd;hpb=91b2f1022a195d008d818f283690ef63a00fd79c;p=pkg-rrdtool.git diff --git a/doc/rrdcached.txt b/doc/rrdcached.txt index a550a56..f2091de 100644 --- a/doc/rrdcached.txt +++ b/doc/rrdcached.txt @@ -6,9 +6,9 @@ NNAAMMEE rrdcached - Data caching daemon for rrdtool SSYYNNOOPPSSIISS - rrrrddccaacchheedd [--PP _p_e_r_m_i_s_s_i_o_n_s] [--ll _a_d_d_r_e_s_s] [--ww _t_i_m_e_o_u_t] [--zz _d_e_l_a_y] - [--ff _t_i_m_e_o_u_t] [--pp _p_i_d___f_i_l_e] [--tt _w_r_i_t_e___t_h_r_e_a_d_s] [--jj _j_o_u_r_n_a_l___d_i_r] [-F] - [-g] [--bb _b_a_s_e___d_i_r [--BB]] + rrrrddccaacchheedd [--PP _p_e_r_m_i_s_s_i_o_n_s] [--ll _a_d_d_r_e_s_s] [--ss _g_r_o_u_p] [--ww _t_i_m_e_o_u_t] + [--zz _d_e_l_a_y] [--ff _t_i_m_e_o_u_t] [--pp _p_i_d___f_i_l_e] [--tt _w_r_i_t_e___t_h_r_e_a_d_s] + [--jj _j_o_u_r_n_a_l___d_i_r] [-F] [-g] [--bb _b_a_s_e___d_i_r [--BB]] DDEESSCCRRIIPPTTIIOONN rrrrddccaacchheedd is a daemon that receives updates to existing RRD files, @@ -30,7 +30,7 @@ OOPPTTIIOONNSS on that socket. If _a_d_d_r_e_s_s begins with "unix:", everything following that prefix is interpreted as the path to a UNIX domain socket. Otherwise the address or node name are resolved using - getaddrinfo. + "getaddrinfo()". For network sockets, a port may be specified by using the form "[[_a_d_d_r_e_s_s]]::_p_o_r_t_". If the address is an IPv4 address or a fully @@ -52,6 +52,40 @@ OOPPTTIIOONNSS If the --ll option is not specified the default address, "unix:/tmp/rrdcached.sock", will be used. + --ss _g_r_o_u_p___n_a_m_e|_g_i_d + Set the group permissions of a UNIX domain socket. The option + accepts either a numeric group id or group name. That group will + then have both read and write permissions (the socket will have + file permissions 0750) for the socket and, therefore, is able to + send commands to the daemon. This may be useful in cases where you + cannot easily run all RRD processes with the same user privileges + (e.g. graph generating CGI scripts that typically run in the + permission context of the web server). + + This option affects the _f_o_l_l_o_w_i_n_g UNIX socket addresses (the + following --ll options), i.e., you may specify different settings for + different sockets. + + The default is not to change ownership or permissions of the socket + and, thus, use the system default. + + --mm _m_o_d_e + Set the file permissions of a UNIX domain socket. The option + accepts an octal number representing the bit pattern for the mode + (see _c_h_m_o_d(1) for details). + + Please note that not all systems honor this setting. On Linux, + read/write permissions are required to connect to a UNIX socket. + However, many BSD-derived systems ignore permissions for UNIX + sockets. See _u_n_i_x(7) for details. + + This option affects the _f_o_l_l_o_w_i_n_g UNIX socket addresses (the + following --ll options), i.e., you may specify different settings for + different sockets. + + The default is not to change ownership or permissions of the socket + and, thus, use the system default. + --PP _c_o_m_m_a_n_d[,_c_o_m_m_a_n_d[,...]] Specifies the commands accepted via a network socket. This allows administrators of _R_R_D_C_a_c_h_e_D to control the actions accepted from @@ -63,7 +97,7 @@ OOPPTTIIOONNSS rrdcached -P FLUSH,PENDING $MORE_ARGUMENTS - The --PP option effects the _f_o_l_l_o_w_i_n_g socket addresses (the following + The --PP option affects the _f_o_l_l_o_w_i_n_g socket addresses (the following --ll options). In the following example, only the IPv4 network socket (address 10.0.0.1) will be restricted to the "FLUSH" and "PENDING" commands: @@ -543,4 +577,4 @@ CCOONNTTRRIIBBUUTTOORRSS -1.4.2 2009-11-15 RRDCACHED(1) +1.4.3 2010-03-22 RRDCACHED(1)