summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorAndreas Enge <andreas@enge.fr>2025-11-18 17:23:45 +0100
committerAndreas Enge <andreas@enge.fr>2025-11-21 14:35:35 +0100
commite1a3b41a4ba0d438559af5a8bbecd6383b226396 (patch)
tree5159a53525aeb37ade3c73fe51e764715b05ca7f /doc
parentad30252858f066e0b2ec46650e9a8edbc5486699 (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.texi83
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
1284key can be found in a file such as 1284key 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
1287If 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
1289similar 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
1294ssh-rsa AAAAB3NzaC1yc2EAAAAEOp8FoQAAAQEAs1eB46LV@dots{}
1295@end example
1296
1297@end table 1287@end table
1298 1288
1299A number of optional fields may be specified: 1289A number of optional fields may be specified:
@@ -23974,75 +23964,6 @@ Here is a more complex example configuration for illustrative purposes:
23974Furthermore, @code{(gnu services ssh)} provides the following services. 23964Furthermore, @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
23979Type of the service that runs the GNU@tie{}lsh secure shell (SSH)
23980daemon, @command{lshd}. The value for this service is a
23981@code{<lsh-configuration>} object.
23982@end defvar
23983
23984@deftp {Data Type} lsh-configuration
23985Data type representing the configuration of @command{lshd}.
23986
23987@table @asis
23988@item @code{lsh} (default: @code{lsh}) (type: file-like)
23989The package object of the GNU@tie{}lsh secure shell (SSH) daemon.
23990
23991@item @code{daemonic?} (default: @code{#t}) (type: boolean)
23992Whether to detach from the controlling terminal.
23993
23994@item @code{host-key} (default: @code{"/etc/lsh/host-key"}) (type: string)
23995File containing the @dfn{host key}. This file must be readable by
23996root only.
23997
23998@item @code{interfaces} (default: @code{'()}) (type: list)
23999List of host names or addresses that @command{lshd} will listen on.
24000If empty, @command{lshd} listens for connections on all the network
24001interfaces.
24002
24003@item @code{port-number} (default: @code{22}) (type: integer)
24004Port to listen on.
24005
24006@item @code{allow-empty-passwords?} (default: @code{#f}) (type: boolean)
24007Whether to accept log-ins with empty passwords.
24008
24009@item @code{root-login?} (default: @code{#f}) (type: boolean)
24010Whether to accept log-ins as root.
24011
24012@item @code{syslog-output?} (default: @code{#t}) (type: boolean)
24013Whether to log @command{lshd} standard output to syslogd.
24014This will make the service depend on the existence of a syslogd service.
24015
24016@item @code{pid-file?} (default: @code{#f}) (type: boolean)
24017When @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)
24021File that @command{lshd} will write its PID to.
24022
24023@item @code{x11-forwarding?} (default: @code{#t}) (type: boolean)
24024Whether to enable X11 forwarding.
24025
24026@item @code{tcp/ip-forwarding?} (default: @code{#t}) (type: boolean)
24027Whether to enable TCP/IP forwarding.
24028
24029@item @code{password-authentication?} (default: @code{#t}) (type: boolean)
24030Whether to accept log-ins using password authentication.
24031
24032@item @code{public-key-authentication?} (default: @code{#t}) (type: boolean)
24033Whether to accept log-ins using public key authentication.
24034
24035@item @code{initialize?} (default: @code{#t}) (type: boolean)
24036When @code{#f}, it is up to the user to initialize the randomness
24037generator (@pxref{lsh-make-seed,,, lsh, LSH Manual}), and to create
24038a 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
24047This is the type for the @uref{http://www.openssh.org, OpenSSH} secure 23968This is the type for the @uref{http://www.openssh.org, OpenSSH} secure
24048shell daemon, @command{sshd}. Its value must be an 23969shell daemon, @command{sshd}. Its value must be an
@@ -48723,9 +48644,7 @@ particular operating system definition.
48723@cindex service types 48644@cindex service types
48724Technically, developers can define @dfn{service types} to express these 48645Technically, developers can define @dfn{service types} to express these
48725relations. There can be any number of services of a given type on the 48646relations. There can be any number of services of a given type on the
48726system---for instance, a system running two instances of the GNU secure 48647system, for instance when running two instances with different parameters.
48727shell server (lsh) has two instances of @code{lsh-service-type}, with
48728different parameters.
48729 48648
48730The following section describes the programming interface for service 48649The following section describes the programming interface for service
48731types and services. 48650types and services.