services: ssh: Deprecate 'dropbear-service' procedure.

* doc/guix.texi (Networking Services): Replace 'dropbear-service' with
'dropbear-service-type'.
* gnu/services/ssh.scm (dropbear-service): Deprecate procedure.

Signed-off-by: Ludovic Courtès <ludo@gnu.org>
This commit is contained in:
Bruno Victal 2023-02-25 18:57:59 +00:00 committed by Ludovic Courtès
parent 0e21015fd2
commit 3b2e88011a
No known key found for this signature in database
GPG Key ID: 090B11993D9AEBB5
2 changed files with 12 additions and 11 deletions

View File

@ -20983,19 +20983,18 @@ Match Address 192.168.0.1
@end table
@end deftp
@deffn {Scheme Procedure} dropbear-service [@var{config}]
Run the @uref{https://matt.ucc.asn.au/dropbear/dropbear.html,Dropbear SSH
daemon} with the given @var{config}, a @code{<dropbear-configuration>}
object.
@defvar dropbear-service-type
Type of the service that runs the
@url{https://matt.ucc.asn.au/dropbear/dropbear.html, Dropbear SSH daemon},
whose value is a @code{<dropbear-configuration>} object.
For example, to specify a Dropbear service listening on port 1234, add
this call to the operating system's @code{services} field:
For example, to specify a Dropbear service listening on port 1234:
@lisp
(dropbear-service (dropbear-configuration
(port-number 1234)))
(service dropbear-service-type (dropbear-configuration
(port-number 1234)))
@end lisp
@end deffn
@end defvar
@deftp {Data Type} dropbear-configuration
This data type represents the configuration of a Dropbear SSH daemon.

View File

@ -52,7 +52,7 @@
dropbear-configuration
dropbear-configuration?
dropbear-service-type
dropbear-service
dropbear-service ; deprecated
autossh-configuration
autossh-configuration?
@ -717,7 +717,9 @@ of user-name/file-like tuples."
dropbear-activation)))
(default-value (dropbear-configuration))))
(define* (dropbear-service #:optional (config (dropbear-configuration)))
(define-deprecated (dropbear-service #:optional
(config (dropbear-configuration)))
dropbear-service-type
"Run the @uref{https://matt.ucc.asn.au/dropbear/dropbear.html,Dropbear SSH
daemon} with the given @var{config}, a @code{<dropbear-configuration>}
object."