diff options
| author | Ian Eure <ian@retrospec.tv> | 2025-09-14 11:07:25 -0700 |
|---|---|---|
| committer | Ian Eure <ian@retrospec.tv> | 2025-09-14 11:13:17 -0700 |
| commit | 96c30d2bf650ca62beec280d541a0b52f2b6fc7d (patch) | |
| tree | 278103d1d1ab769007063afb5ad9266746435694 /doc | |
| parent | 70b380bdf49831e294b253089d375b5440e5095f (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.texi | 108 |
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 | ||
| 32946 | viewing and searching log files. | ||
| 32947 | |||
| 32948 | The following example will configure the service with default values. | ||
| 32949 | By default, Tailon can be accessed on port 8080 (@code{http://localhost:8080}). | ||
| 32950 | |||
| 32951 | @lisp | ||
| 32952 | (service tailon-service-type) | ||
| 32953 | @end lisp | ||
| 32954 | |||
| 32955 | The following example customises more of the Tailon configuration, | ||
| 32956 | adding @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 | ||
| 32968 | Data type representing the configuration of Tailon. | ||
| 32969 | This type has the following parameters: | ||
| 32970 | |||
| 32971 | @table @asis | ||
| 32972 | @item @code{config-file} (default: @code{(tailon-configuration-file)}) | ||
| 32973 | The 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 | |||
| 32977 | For example, to instead use a local file, the @code{local-file} function | ||
| 32978 | can 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}) | ||
| 32987 | The tailon package to use. | ||
| 32988 | |||
| 32989 | @end table | ||
| 32990 | @end deftp | ||
| 32991 | |||
| 32992 | @deftp {Data Type} tailon-configuration-file | ||
| 32993 | Data type representing the configuration options for Tailon. | ||
| 32994 | This type has the following parameters: | ||
| 32995 | |||
| 32996 | @table @asis | ||
| 32997 | @item @code{files} (default: @code{(list "/var/log")}) | ||
| 32998 | List of files to display. The list can include strings for a single file | ||
| 32999 | or directory, or a list, where the first item is the name of a | ||
| 33000 | subsection, and the remaining items are the files or directories in that | ||
| 33001 | subsection. | ||
| 33002 | |||
| 33003 | @item @code{bind} (default: @code{"localhost:8080"}) | ||
| 33004 | Address and port to which Tailon should bind on. | ||
| 33005 | |||
| 33006 | @item @code{relative-root} (default: @code{#f}) | ||
| 33007 | URL path to use for Tailon, set to @code{#f} to not use a path. | ||
| 33008 | |||
| 33009 | @item @code{allow-transfers?} (default: @code{#t}) | ||
| 33010 | Allow downloading the log files in the web interface. | ||
| 33011 | |||
| 33012 | @item @code{follow-names?} (default: @code{#t}) | ||
| 33013 | Allow tailing of not-yet existent files. | ||
| 33014 | |||
| 33015 | @item @code{tail-lines} (default: @code{200}) | ||
| 33016 | Number of lines to read initially from each file. | ||
| 33017 | |||
| 33018 | @item @code{allowed-commands} (default: @code{(list "tail" "grep" "awk")}) | ||
| 33019 | Commands to allow running. By default, @code{sed} is disabled. | ||
| 33020 | |||
| 33021 | @item @code{debug?} (default: @code{#f}) | ||
| 33022 | Set @code{debug?} to @code{#t} to show debug messages. | ||
| 33023 | |||
| 33024 | @item @code{wrap-lines} (default: @code{#t}) | ||
| 33025 | Initial line wrapping state in the web interface. Set to @code{#t} to | ||
| 33026 | initially wrap lines (the default), or to @code{#f} to initially not | ||
| 33027 | wrap lines. | ||
| 33028 | |||
| 33029 | @item @code{http-auth} (default: @code{#f}) | ||
| 33030 | HTTP authentication type to use. Set to @code{#f} to disable | ||
| 33031 | authentication (the default). Supported values are @code{"digest"} or | ||
| 33032 | @code{"basic"}. | ||
| 33033 | |||
| 33034 | @item @code{users} (default: @code{#f}) | ||
| 33035 | If HTTP authentication is enabled (see @code{http-auth}), access will be | ||
| 33036 | restricted to the credentials provided here. To configure users, use a | ||
| 33037 | list of pairs, where the first element of the pair is the username, and | ||
| 33038 | the 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 |
| 33053 | Darkstat is a packet sniffer that captures network traffic, calculates | 32945 | Darkstat is a packet sniffer that captures network traffic, calculates |
