diff options
Diffstat (limited to 'doc/guix.texi')
-rw-r--r-- | doc/guix.texi | 58 |
1 files changed, 57 insertions, 1 deletions
diff --git a/doc/guix.texi b/doc/guix.texi index d61a5b7514..6cf20aa09f 100644 --- a/doc/guix.texi +++ b/doc/guix.texi @@ -943,10 +943,13 @@ A number of optional fields may be specified: @item @code{port} (default: @code{22}) Port number of SSH server on the machine. -@item @code{private-key} (default: @file{~/.ssh/id_rsa}) +@item @code{private-key} (default: @file{~root/.ssh/id_rsa}) The SSH private key file to use when connecting to the machine, in OpenSSH format. +Note that the default value is the private key @emph{of the root +account}. Make sure it exists if you use the default. + @item @code{compression} (default: @code{"zlib@@openssh.com,zlib"}) @itemx @code{compression-level} (default: @code{3}) The SSH-level compression methods and compression level requested. @@ -1445,6 +1448,14 @@ xset +fp ~/.guix-profile/share/fonts/truetype After that, you can run @code{xlsfonts} (from @code{xlsfonts} package) to make sure your TrueType fonts are listed there. +@cindex @code{fc-cache} +@cindex font cache +After installing fonts you may have to refresh the font cache to use +them in applications. The same applies when applications installed via +Guix do not seem to find fonts. To force rebuilding of the font cache +run @code{fc-cache -f}. The @code{fc-cache} command is provided by the +@code{fontconfig} package. + @subsection X.509 Certificates @cindex @code{nss-certs} @@ -15276,6 +15287,35 @@ Package object of thermald. @node Miscellaneous Services @subsubsection Miscellaneous Services +@cindex sysctl +@subsubheading System Control Service + +The @code{(gnu services sysctl)} provides a service to configure kernel +parameters at boot. + +@defvr {Scheme Variable} sysctl-service-type +The service type for @command{sysctl}, which modifies kernel parameters +under @file{/proc/sys/}. To enable IPv4 forwarding, it can be +instantiated as: + +@example +(service sysctl-service-type + (sysctl-configuration + (settings '(("net.ipv4.ip_forward" . "1"))))) +@end example +@end defvr + +@deftp {Data Type} sysctl-configuration +The data type representing the configuration of @command{sysctl}. + +@table @asis +@item @code{sysctl} (default: @code{(file-append procps "/sbin/sysctl"}) +The @command{sysctl} executable to use. + +@item @code{settings} (default: @code{'()}) +An association list specifies kernel parameters and their values. +@end table +@end deftp @cindex lirc @subsubheading Lirc Service @@ -16190,6 +16230,9 @@ in @var{file} that stands alone. By default, @command{guix system} estimates the size of the image needed to store the system, but you can use the @option{--image-size} option to specify a value. +You can specify the root file system type by using the +@option{--file-system-type} option. It defaults to @code{ext4}. + When using @code{vm-image}, the returned image is in qcow2 format, which the QEMU emulator can efficiently use. @xref{Running GuixSD in a VM}, for more information on how to run the image in a virtual machine. @@ -16245,6 +16288,19 @@ This works as per @command{guix build} (@pxref{Invoking guix build}). Return the derivation file name of the given operating system without building anything. +@item --file-system-type=@var{type} +@itemx -t @var{type} +For the @code{disk-image} action, create a file system of the given +@var{type} on the image. + +When this option is omitted, @command{guix system} uses @code{ext4}. + +@cindex ISO-9660 format +@cindex CD image format +@cindex DVD image format +@code{--file-system-type=iso9660} produces an ISO-9660 image, suitable +for burning on CDs and DVDs. + @item --image-size=@var{size} For the @code{vm-image} and @code{disk-image} actions, create an image of the given @var{size}. @var{size} may be a number of bytes, or it may |