summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorIan Eure <ian@retrospec.tv>2025-09-14 11:07:25 -0700
committerIan Eure <ian@retrospec.tv>2025-09-14 11:13:17 -0700
commit96c30d2bf650ca62beec280d541a0b52f2b6fc7d (patch)
tree278103d1d1ab769007063afb5ad9266746435694 /doc
parent70b380bdf49831e294b253089d375b5440e5095f (diff)
gnu: Remove Tailon services and documentation.
The tailon package was removed in 63023deaf96bd0d90aba262b194bf1445ec5a0b6, but the associated service and documentation weren’t, leading to `guix pull` breaking. Fixes guix/guix#2689. * doc/guix.texi: Remove Tailon documentation. * gnu/services/web.scm (tailon-service-type): Delete variable. (tailon-configuration-file): Delete variable. (tailon-configuration-file?): Delete variable. (tailon-configuration-file-files): Delete variable. (tailon-configuration-file-bind): Delete variable. (tailon-configuration-file-relative-root): Delete variable. (tailon-configuration-file-allow-transfers?): Delete variable. (tailon-configuration-file-follow-names?): Delete variable. (tailon-configuration-file-tail-lines): Delete variable. (tailon-configuration-file-allowed-commands): Delete variable. (tailon-configuration-file-debug?): Delete variable. (tailon-configuration-file-http-auth): Delete variable. (tailon-configuration-file-users): Delete variable (tailon-configuration): Delete variable. (tailon-configuration?): Delete variable. (tailon-configuration-config-file): Delete variable. (tailon-configuration-package): Delete variable. * gnu/tests/web.scm (%test-tailon): Delete variable. Change-Id: I3b507df8233b0440baa6a2bce4604b5813cb3bb0
Diffstat (limited to 'doc')
-rw-r--r--doc/guix.texi108
1 files changed, 0 insertions, 108 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index 13665b568d7..0924aebf4ad 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -32940,114 +32940,6 @@ Defaults to @samp{#t}.
32940@node Monitoring Services 32940@node Monitoring Services
32941@subsection Monitoring Services 32941@subsection Monitoring Services
32942 32942
32943@subsubheading Tailon Service
32944
32945@uref{https://tailon.readthedocs.io/, Tailon} is a web application for
32946viewing and searching log files.
32947
32948The following example will configure the service with default values.
32949By default, Tailon can be accessed on port 8080 (@code{http://localhost:8080}).
32950
32951@lisp
32952(service tailon-service-type)
32953@end lisp
32954
32955The following example customises more of the Tailon configuration,
32956adding @command{sed} to the list of allowed commands.
32957
32958@lisp
32959(service tailon-service-type
32960 (tailon-configuration
32961 (config-file
32962 (tailon-configuration-file
32963 (allowed-commands '("tail" "grep" "awk" "sed"))))))
32964@end lisp
32965
32966
32967@deftp {Data Type} tailon-configuration
32968Data type representing the configuration of Tailon.
32969This type has the following parameters:
32970
32971@table @asis
32972@item @code{config-file} (default: @code{(tailon-configuration-file)})
32973The configuration file to use for Tailon. This can be set to a
32974@dfn{tailon-configuration-file} record value, or any gexp
32975(@pxref{G-Expressions}).
32976
32977For example, to instead use a local file, the @code{local-file} function
32978can be used:
32979
32980@lisp
32981(service tailon-service-type
32982 (tailon-configuration
32983 (config-file (local-file "./my-tailon.conf"))))
32984@end lisp
32985
32986@item @code{package} (default: @code{tailon})
32987The tailon package to use.
32988
32989@end table
32990@end deftp
32991
32992@deftp {Data Type} tailon-configuration-file
32993Data type representing the configuration options for Tailon.
32994This type has the following parameters:
32995
32996@table @asis
32997@item @code{files} (default: @code{(list "/var/log")})
32998List of files to display. The list can include strings for a single file
32999or directory, or a list, where the first item is the name of a
33000subsection, and the remaining items are the files or directories in that
33001subsection.
33002
33003@item @code{bind} (default: @code{"localhost:8080"})
33004Address and port to which Tailon should bind on.
33005
33006@item @code{relative-root} (default: @code{#f})
33007URL path to use for Tailon, set to @code{#f} to not use a path.
33008
33009@item @code{allow-transfers?} (default: @code{#t})
33010Allow downloading the log files in the web interface.
33011
33012@item @code{follow-names?} (default: @code{#t})
33013Allow tailing of not-yet existent files.
33014
33015@item @code{tail-lines} (default: @code{200})
33016Number of lines to read initially from each file.
33017
33018@item @code{allowed-commands} (default: @code{(list "tail" "grep" "awk")})
33019Commands to allow running. By default, @code{sed} is disabled.
33020
33021@item @code{debug?} (default: @code{#f})
33022Set @code{debug?} to @code{#t} to show debug messages.
33023
33024@item @code{wrap-lines} (default: @code{#t})
33025Initial line wrapping state in the web interface. Set to @code{#t} to
33026initially wrap lines (the default), or to @code{#f} to initially not
33027wrap lines.
33028
33029@item @code{http-auth} (default: @code{#f})
33030HTTP authentication type to use. Set to @code{#f} to disable
33031authentication (the default). Supported values are @code{"digest"} or
33032@code{"basic"}.
33033
33034@item @code{users} (default: @code{#f})
33035If HTTP authentication is enabled (see @code{http-auth}), access will be
33036restricted to the credentials provided here. To configure users, use a
33037list of pairs, where the first element of the pair is the username, and
33038the 2nd element of the pair is the password.
33039
33040@lisp
33041(tailon-configuration-file
33042 (http-auth "basic")
33043 (users '(("user1" . "password1")
33044 ("user2" . "password2"))))
33045@end lisp
33046
33047@end table
33048@end deftp
33049
33050
33051@subsubheading Darkstat Service 32943@subsubheading Darkstat Service
33052@cindex darkstat 32944@cindex darkstat
33053Darkstat is a packet sniffer that captures network traffic, calculates 32945Darkstat is a packet sniffer that captures network traffic, calculates