Mercurial > notdcc
diff dccsight.0 @ 0:c7f6b056b673
First import of vendor version
author | Peter Gervai <grin@grin.hu> |
---|---|
date | Tue, 10 Mar 2009 13:49:58 +0100 |
parents | |
children |
line wrap: on
line diff
--- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/dccsight.0 Tue Mar 10 13:49:58 2009 +0100 @@ -0,0 +1,99 @@ +dccsight(8) Distributed Checksum Clearinghouse dccsight(8) + +NNAAMMEE + ddccccssiigghhtt -- Distributed Checksum Clearinghouse raw checksum interface + +SSYYNNOOPPSSIISS + ddccccssiigghhtt [--VVddQQCC] [--hh _h_o_m_e_d_i_r] [--mm _m_a_p] [--ww _w_h_i_t_e_c_l_n_t] [--tt _t_a_r_g_e_t_s] + [--ii _i_n_f_i_l_e] [--LL _l_t_y_p_e_,_f_a_c_i_l_i_t_y_._l_e_v_e_l] + +DDEESSCCRRIIPPTTIIOONN + DDccccssiigghhtt reads one or more lines containing DCC checksums, reports them + to a DCC server, and writes a X-DCC header line. It can be used to + report checksums obtained from dccproc(8) using --CC. + + OOPPTTIIOONNSS + The following options are available: + + --VV displays the version of the DCC raw checksum interface. + + --dd enables debugging output from the DCC client software. Additional + --dd options increase the number of messages. + + --QQ only queries the DCC server about the checksums instead of reporting + and then querying. This is useful when ddccccssiigghhtt is used to filter + mail that has already been reported to a DCC server by another DCC + client such as dccm(8). This can also be useful when applying a + private white or black list to mail that has already been reported + to a DCC server. No single mail message should be reported to a DCC + server more than once per recipient, such as would happen if + ddccccssiigghhtt is not given --QQ when processing a stream of mail that has + already been seen by a DCC client. Additional reports of a message + increase its apparent "bulkness." + + --CC outputs the checksums for the message as well as the X-DCC header. + + --hh _h_o_m_e_d_i_r + overrides the default DCC home directory, _/_v_a_r_/_d_c_c. + + --mm _m_a_p + specifies a name or path of the memory mapped parameter file instead + of the default _m_a_p in the DCC home directory. It should be created + with the cdcc(8) command. + + --ww _w_h_i_t_e_c_l_n_t + specifies an optional file containing SMTP client IP addresses and + SMTP headers of mail that do not need X-DCC headers and whose check- + sums should not be reported to the DCC server. It can also contain + checksums of spam. If the pathname is not absolute, it is relative + to the DCC home directory. Thus, individual users with private + whitelists usually specify them with absolute paths. It is useful + to _i_n_c_l_u_d_e a common or system-wide whitelist in private lists. + + The format of the ddccccssiigghhtt whiteclnt file is the same as the + _w_h_i_t_e_l_i_s_t file required by dbclean(8) and dccsight(8). Because this + list is used frequently, a companion file is used. It has the same + pathname but with an added suffix of _._d_c_c_w. After being created + empty, it will contain an automatic memory mapped hash table of the + main file. + + --tt _t_a_r_g_e_t_s + specifies the number of addressees of the message if other than 1. + The string _m_a_n_y instead of a number asserts that there were too many + addressees and that the message is unsolicited bulk email. + + --ii _i_n_f_i_l_e + specifies an input file instead of standard input. If not absolute, + the pathname is interpreted relative to the directory in which + ddccccssiigghhtt was started. + + --LL _l_t_y_p_e_,_f_a_c_i_l_i_t_y_._l_e_v_e_l + specifies how messages should be logged. _L_t_y_p_e must be _e_r_r_o_r, _i_n_f_o, + or _o_f_f to indicate which of the two types of messages are being con- + trolled or to turn off all syslog(3) messages from ddccccssiigghhtt. _L_e_v_e_l + must be a syslog(3) level among _E_M_E_R_G, _A_L_E_R_T, _C_R_I_T, _E_R_R, _W_A_R_N_I_N_G, + _N_O_T_I_C_E, _I_N_F_O, and _D_E_B_U_G. _F_a_c_i_l_i_t_y must be among _A_U_T_H, _A_U_T_H_P_R_I_V, + _C_R_O_N, _D_A_E_M_O_N, _F_T_P, _K_E_R_N, _L_P_R, _M_A_I_L, _N_E_W_S, _U_S_E_R, _U_U_C_P, and _L_O_C_A_L_0 + through _L_O_C_A_L_7. The default is equivalent to + --LL _i_n_f_o_,_M_A_I_L_._N_O_T_I_C_E --LL _e_r_r_o_r_,_M_A_I_L_._E_R_R + + ddccccssiigghhtt exits 0 on success, and >0 if an error occurs. + +FFIILLEESS + /var/dcc DCC home directory in which other files are found. + map memory mapped file in the DCC home directory of information + concerning DCC servers. + whiteclnt contains the client whitelist in the format described in + dcc(8). + whiteclnt.dccw + memory mapped hash table of the _w_h_i_t_e_c_l_n_t file. + +SSEEEE AALLSSOO + cdcc(8), dcc(8), dbclean(8), dccd(8), dblist(8), dccproc(8), dccm(8), + dccifd(8), mail(1), procmail(1). + +HHIISSTTOORRYY + Implementation of ddccccssiigghhtt was started at Rhyolite Software in 2000. + This document describes version 1.3.103. + + February 26, 2009