diff options
| author | Andreas Enge <andreas@enge.fr> | 2025-11-18 17:23:45 +0100 |
|---|---|---|
| committer | Andreas Enge <andreas@enge.fr> | 2025-11-21 14:35:35 +0100 |
| commit | e1a3b41a4ba0d438559af5a8bbecd6383b226396 (patch) | |
| tree | 5159a53525aeb37ade3c73fe51e764715b05ca7f /doc | |
| parent | ad30252858f066e0b2ec46650e9a8edbc5486699 (diff) | |
gnu: Remove lsh-service-type.
* gnu/services/ssh.scm (<lsh-configuration>, %yarrow-seed,
lsh-initialization, lsh-activation, lsh-shepherd-service,
lsh-pam-services, lsh-service-type): Delete variables.
* doc/guix.texi: Remove lsh-service-type documentation.
Change-Id: I18377a111c10ec6f6d362fadabc64cb66a2b122d
Diffstat (limited to 'doc')
| -rw-r--r-- | doc/guix.texi | 83 |
1 files changed, 1 insertions, 82 deletions
diff --git a/doc/guix.texi b/doc/guix.texi index 7bba256b838..4823197470a 100644 --- a/doc/guix.texi +++ b/doc/guix.texi | |||
| @@ -1284,16 +1284,6 @@ If the machine is running the OpenSSH daemon, @command{sshd}, the host | |||
| 1284 | key can be found in a file such as | 1284 | key can be found in a file such as |
| 1285 | @file{/etc/ssh/ssh_host_ed25519_key.pub}. | 1285 | @file{/etc/ssh/ssh_host_ed25519_key.pub}. |
| 1286 | 1286 | ||
| 1287 | If the machine is running the SSH daemon of GNU@tie{}lsh, | ||
| 1288 | @command{lshd}, the host key is in @file{/etc/lsh/host-key.pub} or a | ||
| 1289 | similar file. It can be converted to the OpenSSH format using | ||
| 1290 | @command{lsh-export-key} (@pxref{Converting keys,,, lsh, LSH Manual}): | ||
| 1291 | |||
| 1292 | @example | ||
| 1293 | $ lsh-export-key --openssh < /etc/lsh/host-key.pub | ||
| 1294 | ssh-rsa AAAAB3NzaC1yc2EAAAAEOp8FoQAAAQEAs1eB46LV@dots{} | ||
| 1295 | @end example | ||
| 1296 | |||
| 1297 | @end table | 1287 | @end table |
| 1298 | 1288 | ||
| 1299 | A number of optional fields may be specified: | 1289 | A number of optional fields may be specified: |
| @@ -23974,75 +23964,6 @@ Here is a more complex example configuration for illustrative purposes: | |||
| 23974 | Furthermore, @code{(gnu services ssh)} provides the following services. | 23964 | Furthermore, @code{(gnu services ssh)} provides the following services. |
| 23975 | @cindex SSH | 23965 | @cindex SSH |
| 23976 | @cindex SSH server | 23966 | @cindex SSH server |
| 23977 | |||
| 23978 | @defvar lsh-service-type | ||
| 23979 | Type of the service that runs the GNU@tie{}lsh secure shell (SSH) | ||
| 23980 | daemon, @command{lshd}. The value for this service is a | ||
| 23981 | @code{<lsh-configuration>} object. | ||
| 23982 | @end defvar | ||
| 23983 | |||
| 23984 | @deftp {Data Type} lsh-configuration | ||
| 23985 | Data type representing the configuration of @command{lshd}. | ||
| 23986 | |||
| 23987 | @table @asis | ||
| 23988 | @item @code{lsh} (default: @code{lsh}) (type: file-like) | ||
| 23989 | The package object of the GNU@tie{}lsh secure shell (SSH) daemon. | ||
| 23990 | |||
| 23991 | @item @code{daemonic?} (default: @code{#t}) (type: boolean) | ||
| 23992 | Whether to detach from the controlling terminal. | ||
| 23993 | |||
| 23994 | @item @code{host-key} (default: @code{"/etc/lsh/host-key"}) (type: string) | ||
| 23995 | File containing the @dfn{host key}. This file must be readable by | ||
| 23996 | root only. | ||
| 23997 | |||
| 23998 | @item @code{interfaces} (default: @code{'()}) (type: list) | ||
| 23999 | List of host names or addresses that @command{lshd} will listen on. | ||
| 24000 | If empty, @command{lshd} listens for connections on all the network | ||
| 24001 | interfaces. | ||
| 24002 | |||
| 24003 | @item @code{port-number} (default: @code{22}) (type: integer) | ||
| 24004 | Port to listen on. | ||
| 24005 | |||
| 24006 | @item @code{allow-empty-passwords?} (default: @code{#f}) (type: boolean) | ||
| 24007 | Whether to accept log-ins with empty passwords. | ||
| 24008 | |||
| 24009 | @item @code{root-login?} (default: @code{#f}) (type: boolean) | ||
| 24010 | Whether to accept log-ins as root. | ||
| 24011 | |||
| 24012 | @item @code{syslog-output?} (default: @code{#t}) (type: boolean) | ||
| 24013 | Whether to log @command{lshd} standard output to syslogd. | ||
| 24014 | This will make the service depend on the existence of a syslogd service. | ||
| 24015 | |||
| 24016 | @item @code{pid-file?} (default: @code{#f}) (type: boolean) | ||
| 24017 | When @code{#t}, @command{lshd} writes its PID to the file specified in | ||
| 24018 | @var{pid-file}. | ||
| 24019 | |||
| 24020 | @item @code{pid-file} (default: @code{"/var/run/lshd.pid"}) (type: string) | ||
| 24021 | File that @command{lshd} will write its PID to. | ||
| 24022 | |||
| 24023 | @item @code{x11-forwarding?} (default: @code{#t}) (type: boolean) | ||
| 24024 | Whether to enable X11 forwarding. | ||
| 24025 | |||
| 24026 | @item @code{tcp/ip-forwarding?} (default: @code{#t}) (type: boolean) | ||
| 24027 | Whether to enable TCP/IP forwarding. | ||
| 24028 | |||
| 24029 | @item @code{password-authentication?} (default: @code{#t}) (type: boolean) | ||
| 24030 | Whether to accept log-ins using password authentication. | ||
| 24031 | |||
| 24032 | @item @code{public-key-authentication?} (default: @code{#t}) (type: boolean) | ||
| 24033 | Whether to accept log-ins using public key authentication. | ||
| 24034 | |||
| 24035 | @item @code{initialize?} (default: @code{#t}) (type: boolean) | ||
| 24036 | When @code{#f}, it is up to the user to initialize the randomness | ||
| 24037 | generator (@pxref{lsh-make-seed,,, lsh, LSH Manual}), and to create | ||
| 24038 | a key pair with the private key stored in file @var{host-key} | ||
| 24039 | (@pxref{lshd basics,,, lsh, LSH Manual}). | ||
| 24040 | |||
| 24041 | @end table | ||
| 24042 | @end deftp | ||
| 24043 | |||
| 24044 | @cindex SSH | ||
| 24045 | @cindex SSH server | ||
| 24046 | @defvar openssh-service-type | 23967 | @defvar openssh-service-type |
| 24047 | This is the type for the @uref{http://www.openssh.org, OpenSSH} secure | 23968 | This is the type for the @uref{http://www.openssh.org, OpenSSH} secure |
| 24048 | shell daemon, @command{sshd}. Its value must be an | 23969 | shell daemon, @command{sshd}. Its value must be an |
| @@ -48723,9 +48644,7 @@ particular operating system definition. | |||
| 48723 | @cindex service types | 48644 | @cindex service types |
| 48724 | Technically, developers can define @dfn{service types} to express these | 48645 | Technically, developers can define @dfn{service types} to express these |
| 48725 | relations. There can be any number of services of a given type on the | 48646 | relations. There can be any number of services of a given type on the |
| 48726 | system---for instance, a system running two instances of the GNU secure | 48647 | system, for instance when running two instances with different parameters. |
| 48727 | shell server (lsh) has two instances of @code{lsh-service-type}, with | ||
| 48728 | different parameters. | ||
| 48729 | 48648 | ||
| 48730 | The following section describes the programming interface for service | 48649 | The following section describes the programming interface for service |
| 48731 | types and services. | 48650 | types and services. |
