aboutsummaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
author宋文武 <iyzsong@member.fsf.org>2018-01-06 16:40:32 +0800
committer宋文武 <iyzsong@member.fsf.org>2018-01-08 20:43:35 +0800
commit693b52df68a5fac6683c9a77dcb08ee3364aa225 (patch)
treedd24c5bf0d0c5de6d8503ea7a0548f45bbfda28a /doc
parentc8cee2ef96b93079d3c629f52a6779d68348227e (diff)
downloadguix-693b52df68a5fac6683c9a77dcb08ee3364aa225.tar
guix-693b52df68a5fac6683c9a77dcb08ee3364aa225.tar.gz
gnu: services: Add darkstat service.
* gnu/services/monitoring.scm: New file. * gnu/local.mk (GNU_SYSTEM_MODULES): Add it. * doc/guix.texi (Monitoring Services): Document it.
Diffstat (limited to 'doc')
-rw-r--r--doc/guix.texi42
1 files changed, 42 insertions, 0 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index bde0b5d8d0..e9ee5127a8 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -14727,6 +14727,48 @@ the 2nd element of the pair is the password.
@end deftp
+@subsubheading Darkstat Service
+@cindex darkstat
+Darkstat is a packet sniffer that captures network traffic, calculates
+statistics about usage, and serves reports over HTTP.
+
+@defvar {Scheme Variable} darkstat-service-type
+This is the service type for the
+@uref{https://unix4lyfe.org/darkstat/, darkstat}
+service, its value must be a @code{darkstat-configuration} record as in
+this example:
+
+@example
+(service darkstat-service-type
+ (darkstat-configuration
+ (interface "eno1")))
+@end example
+@end defvar
+
+@deftp {Data Type} darkstat-configuration
+Data type representing the configuration of @command{darkstat}.
+
+@table @asis
+@item @code{package} (default: @code{darkstat})
+The darkstat package to use.
+
+@item @code{interface}
+Capture traffic on the specified network interface.
+
+@item @code{port} (default: @code{"667"})
+Bind the web interface to the specified port.
+
+@item @code{bind-address} (default: @code{"127.0.0.1"})
+Bind the web interface to the specified address.
+
+@item @code{base} (default: @code{"/"})
+Specify the path of the base URL. This can be useful if
+@command{darkstat} is accessed via a reverse proxy.
+
+@end table
+@end deftp
+
+
@node Kerberos Services
@subsubsection Kerberos Services
@cindex Kerberos