me
/
guix
Archived
1
0
Fork 0
Code

doc: Further clarify documentation of 'host' and 'hosts-service-type'. 

* doc/guix.texi (Base Services): Use docstring of 'host' to document
it and remove @deftp.  Introduce example.  Fix typos in file name.
Ludovic Courtès 2023-02-23 16:15:49 +01:00
parent 35e64a8793
commit 810788b550
No known key found for this signature in database
GPG Key ID: 090B11993D9AEBB5
1 changed files with 14 additions and 22 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

36
doc/guix.texi
View File

@ -18025,6 +18025,8 @@ Type of the service that populates the entries for (@file{/etc/hosts}).
This service type can be @emph{extended} by passing it a list of This service type can be @emph{extended} by passing it a list of
@code{host} records. @code{host} records.
The example below shows how to add two entries to @file{/etc/hosts}:
@c TRANSLATORS: The domain names below SHOULD NOT be translated. @c TRANSLATORS: The domain names below SHOULD NOT be translated.
@c They're domains reserved for use in documentation. (RFC6761 Section 6.5) @c They're domains reserved for use in documentation. (RFC6761 Section 6.5)
@c The addresses used are explained in RFC3849 and RFC5737. @c The addresses used are explained in RFC3849 and RFC5737.
@ -18038,8 +18040,8 @@ This service type can be @emph{extended} by passing it a list of
@end lisp @end lisp
@quotation Note @quotation Note
@cindex @file{/etc/host} default entries @cindex @file{/etc/hosts} default entries
By default @file{/etc/host} comes with the following entries: By default @file{/etc/hosts} comes with the following entries:
@example @example
127.0.0.1 localhost @var{host-name} 127.0.0.1 localhost @var{host-name}
::1 localhost @var{host-name} ::1 localhost @var{host-name}
@ -18064,28 +18066,18 @@ alias of @code{localhost}.
(host "::1" "localhost")))))) (host "::1" "localhost"))))))
@end lisp @end lisp
@end quotation @end quotation
@deftp {Data Type} host
Available @code{host} fields are:
@table @asis
@item @code{address} (type: string)
IP address.
@item @code{canonical-name} (type: string)
Hostname.
@item @code{aliases} (default: @code{'()}) (type: list-of-string)
Additional aliases that map to the same @code{canonical-name}.
@end table
@end deftp
@defun host address canonical-name [aliases]
Procedure for creating @code{host} records.
@end defun
@end defvar @end defvar
@defun host @var{address} @var{canonical-name} [@var{aliases}]
Return a new record for the host at @var{address} with the given
@var{canonical-name} and possibly @var{aliases}.
@var{address} must be a string denoting a valid IPv4 or IPv6 address, and
@var{canonical-name} and the strings listed in @var{aliases} must be valid
host names.
@end defun
@deffn {Scheme Procedure} login-service @var{config} @deffn {Scheme Procedure} login-service @var{config}
Return a service to run login according to @var{config}, a Return a service to run login according to @var{config}, a
@code{<login-configuration>} object, which specifies the message of the day, @code{<login-configuration>} object, which specifies the message of the day,