You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138
  1. .TH RSPAMD 8 "" "Rspamd User Manual"
  2. .SH NAME
  3. .PP
  4. rspamd - main daemon for rapid spam filtering system
  5. .SH SYNOPSIS
  6. .PP
  7. rspamd [\f[I]options\f[]]...
  8. .PP
  9. rspamd --help
  10. .SH DESCRIPTION
  11. .PP
  12. Rspamd filtering system is designed to be fast, modular and easily
  13. scalable system.
  14. Rspamd core is written in \f[C]C\f[] language using event driven
  15. processing model.
  16. Plugins for rspamd can be written in \f[C]Lua\f[] programming language.
  17. Rspamd is designed to process connections completely asynchronous and do
  18. not block anywhere in code.
  19. .SH OPTIONS
  20. .TP
  21. .B -t, --config-test
  22. Perform config test and exit
  23. .RS
  24. .RE
  25. .TP
  26. .B -f, --no-fork
  27. Do not daemonize main process
  28. .RS
  29. .RE
  30. .TP
  31. .B -c \f[I]path\f[], --config=\f[I]path\f[]
  32. Specify config file(s)
  33. .RS
  34. .RE
  35. .TP
  36. .B -u \f[I]username\f[], --user=\f[I]username\f[]
  37. User to run rspamd as
  38. .RS
  39. .RE
  40. .TP
  41. .B -g \f[I]groupname\f[], --group=\f[I]groupname\f[]
  42. Group to run rspamd as
  43. .RS
  44. .RE
  45. .TP
  46. .B -p \f[I]path\f[], --pid=\f[I]path\f[]
  47. Path to pidfile
  48. .RS
  49. .RE
  50. .TP
  51. .B -C, --dump-cache
  52. Dump symbols cache stats and exit
  53. .RS
  54. .RE
  55. .TP
  56. .B -d, --debug
  57. Force debug output
  58. .RS
  59. .RE
  60. .TP
  61. .B -i, --insecure
  62. Ignore running workers as privileged users (insecure)
  63. .RS
  64. .RE
  65. .TP
  66. .B --test-lua=\f[I]path\f[]
  67. Specify lua file(s) to test
  68. .RS
  69. .RE
  70. .TP
  71. .B --sign-config=\f[I]path\f[]
  72. Specify config file(s) to sign
  73. .RS
  74. .RE
  75. .TP
  76. .B --private-key=\f[I]path\f[]
  77. Specify private key to sign
  78. .RS
  79. .RE
  80. .TP
  81. .B --convert-config=\f[I]path\f[]
  82. Convert configuration to UCL
  83. .RS
  84. .RE
  85. .SH EXAMPLES
  86. .PP
  87. Run rspamd daemon with default configuration:
  88. .IP
  89. .nf
  90. \f[C]
  91. rspamd
  92. \f[]
  93. .fi
  94. .PP
  95. Run rspamd in foreground with custom configuration:
  96. .IP
  97. .nf
  98. \f[C]
  99. rspamd\ -f\ -c\ ~/rspamd.conf
  100. \f[]
  101. .fi
  102. .PP
  103. Run rspamd specifying user and group:
  104. .IP
  105. .nf
  106. \f[C]
  107. rspamd\ -u\ rspamd\ -g\ rspamd\ -c\ /etc/rspamd/rspamd.conf
  108. \f[]
  109. .fi
  110. .PP
  111. Test lua scripts using rspamd API:
  112. .IP
  113. .nf
  114. \f[C]
  115. rspamd\ --test-lua=~/test1.lua\ --test-lua=~/test2.lua
  116. \f[]
  117. .fi
  118. .PP
  119. Sign config files for \f[C].includes\f[] macro:
  120. .IP
  121. .nf
  122. \f[C]
  123. rspamd\ --private-key=sign.key\ --sign-config=rspamd.conf
  124. \f[]
  125. .fi
  126. .PP
  127. Convert old \f[C]XML\f[] config to the \f[C]UCL\f[] format (since
  128. 0.6.0):
  129. .IP
  130. .nf
  131. \f[C]
  132. rspamd\ -c\ /etc/rspamd.xml\ --convert-config=/etc/rspamd/rspamd.conf
  133. \f[]
  134. .fi
  135. .SH SEE ALSO
  136. .PP
  137. Rspamd documentation and source codes may be downloaded from
  138. <https://rspamd.com/>.