[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
04/08: doc: Add generated es.texi files.
|
From: |
guix-commits |
|
Subject: |
04/08: doc: Add generated es.texi files. |
|
Date: |
Tue, 23 Apr 2019 18:36:19 -0400 (EDT) |
civodul pushed a commit to branch master
in repository guix.
commit 3b919e0199495334ea475e02442c33e1e7c8466d
Author: Ludovic Courtès <address@hidden>
Date: Wed Apr 24 00:05:34 2019 +0200
doc: Add generated es.texi files.
* doc/guix.es.texi, doc/contributing.es.texi: New files.
---
doc/contributing.es.texi | 1016 ++
doc/guix.es.texi | 26015 +++++++++++++++++++++++++++++++++++++++++++++
2 files changed, 27031 insertions(+)
diff --git a/doc/contributing.es.texi b/doc/contributing.es.texi
new file mode 100644
index 0000000..0529917
--- /dev/null
+++ b/doc/contributing.es.texi
@@ -0,0 +1,1016 @@
address@hidden Contribuir
address@hidden Contribuir
+
+Este proyecto es un esfuerzo colaborativo, y ¡necesitamos su ayuda para que
+crezca! Por favor, contacte con nosotras en @email{guix-devel@@gnu.org} y en
address@hidden en la red IRC Freenode. Estamos abiertas a ideas, informes de
+errores, parches y cualquier cosa que pueda ser de ayuda para el
+proyecto. Especialmente se agradece ayuda en empaquetamiento
+(@pxref{Guías de empaquetamiento}).
+
address@hidden código de conducta, de contribuidoras
address@hidden acuerdo de contribución
+Queremos proporcionar un entorno cálido, amistoso y libre de acoso, para que
+cualquiera pueda contribuir al máximo de sus capacidades. Para este fin
+nuestro proyecto usa un ``Acuerdo de Contribución'', que fue adaptado de
address@hidden://contributor-coventant.org}. Se puede encontrar una versión
local
+en el fichero @file{CODE-OF-CONDUCT} del árbol de fuentes.
+
+Las contribuidoras no están obligadas a usar su nombre legal en los parches
+ni en la comunicación on-line; pueden usar cualquier nombre o seudónimo de
+su elección.
+
address@hidden
+* Construcción desde Git:: Lo último y mejor.
+* Ejecución de Guix antes de estar instalado:: Trucos de hacker.
+* La configuración perfecta:: Las herramientas adecuadas.
+* Guías de empaquetamiento:: Crecimiento de la distribución.
+* Estilo de codificación:: Higiene de la contribuidora.
+* Envío de parches:: Comparta su trabajo.
address@hidden menu
+
address@hidden Construcción desde Git
address@hidden Construcción desde Git
+
+Si quiere picar en el mismo Guix se recomienda usar la última versión del
+repositorio Git:
+
address@hidden
+git clone https://git.savannah.gnu.org/git/guix.git
address@hidden example
+
+Cuando se compila Guix de una copia de trabajo local (checkout), se
+requieren los siguientes paquetes, además de los mencionados en las
+instrucciones de instalación (@pxref{Requisitos}).
+
address@hidden
address@hidden @url{http://gnu.org/software/autoconf/, GNU Autoconf};
address@hidden @url{http://gnu.org/software/automake/, GNU Automake};
address@hidden @url{http://gnu.org/software/gettext/, GNU Gettext};
address@hidden @url{http://gnu.org/software/texinfo/, GNU Texinfo};
address@hidden @url{http://www.graphviz.org/, Graphviz};
address@hidden @url{http://www.gnu.org/software/help2man/, GNU Help2man
(opcional)}.
address@hidden itemize
+
+El modo más fácil de preparar un entorno de desarrollo para Guix es, por
+supuesto, ¡usando Guix! Las siguientes órdenes inician un nuevo intérprete
+donde todas las dependencias y las variables de entorno apropiadas están
+listas para picar código en Guix:
+
address@hidden
+guix environment guix
address@hidden example
+
address@hidden de guix environment}, para más información sobre esa orden. Se
+pueden añadir dependencias adicionales con la opción @option{--ad-hoc}:
+
address@hidden
+guix environment guix --ad-hoc help2man git strace
address@hidden example
+
+Ejecute @command{./bootstrap} para generar la infraestructura del sistema de
+construcción usando Autoconf y Automake. Si obtiene un error como este:
+
address@hidden
+configure.ac:46: error: possibly undefined macro: PKG_CHECK_MODULES
address@hidden example
+
address@hidden
+probablemente significa que Autoconf no pudo encontrar el fichero pkg.m4,
+que proporciona pkg-config. Asegurese de que @file{pkg.m4} está
+disponible. Lo mismo aplica para el conjunto de macros @file{guile.m4} que
+proporciona Guile. Por ejemplo, si ha instalado Automake en
address@hidden/usr/local}, no va a buscar ficheros @file{.m4} en
address@hidden/usr/share}. En ese caso tiene que ejecutar la siguiente orden:
+
address@hidden
+export ACLOCAL_PATH=/usr/share/aclocal
address@hidden example
+
address@hidden Search Path,,, automake, The GNU Automake Manual} para más
+información.
+
+Entonces, ejecute @command{./configure} como siempre. Asegurese de pasar
address@hidden@var{directorio}}, donde @var{directorio} es el valor
+de @code{localstatedir} usado por su instalación actual (@pxref{El almacén},
+para información sobre esto).
+
+Finalmente, tiene que ejecutar @code{make check} para iniciar las pruebas
+(@pxref{Ejecución de la batería de pruebas}). Si algo falla, eche un vistazo a
las
+instrucciones de instalación (@pxref{Instalación}) o envíe un mensaje---en
+Inglés---a la @email{guix-devel@@gnu.org, lista de correo}.
+
+
address@hidden Ejecución de Guix antes de estar instalado
address@hidden Ejecución de Guix antes de estar instalado
+
+Para mantener un entorno de trabajo estable, encontrará útil probar los
+cambios hechos en su copia de trabajo local sin instalarlos realmente. De
+esa manera, puede distinguir entre su sombrero de ``usuaria final'' y el
+traje de ``harapos''.
+
+Para dicho fin, todas las herramientas de línea de órdenes pueden ser usadas
+incluso si no ha ejecutado @code{make install}. Para hacerlo, primero
+necesita tener un entorno con todas las dependencias disponibles
+(@pxref{Construcción desde Git}), y entonces añada al inicio de cada orden
address@hidden/pre-inst-env} (el guión @file{pre-inst-env} se encuentra en la
+raíz del árbol de compilación de Guix, como address@hidden opción
address@hidden a @command{sudo} asegura que @code{GUILE_LOAD_PATH} contiene la
+información correcta para que @command{guix-daemon} y las herramientas que
+usa puedan encontrar los módulos Guile que necesitan.}:
+
address@hidden
+$ sudo -E ./pre-inst-env guix-daemon --build-users-group=guixbuild
+$ ./pre-inst-env guix build hello
address@hidden example
+
address@hidden
+De manera similar, para una sesión de Guile que use los módulos Guix:
+
address@hidden
+$ ./pre-inst-env guile -c '(use-modules (guix utils)) (pk (%current-system))'
+
+;;; ("x86_64-linux")
address@hidden example
+
address@hidden
address@hidden REPL
address@hidden entorno interactivo
address@hidden y para un entorno interactivo (REPL) (@pxref{Using Guile
+Interactively,,, guile, Guile Reference Manual}):
+
address@hidden
+$ ./pre-inst-env guile
+scheme@@(guile-user)> ,use(guix)
+scheme@@(guile-user)> ,use(gnu)
+scheme@@(guile-user)> (define serpientes
+ (fold-packages
+ (lambda (paquete lst)
+ (if (string-prefix? "python"
+ (package-name paquete))
+ (cons paquete lst)
+ lst))
+ '()))
+scheme@@(guile-user)> (length serpientes)
+$1 = 361
address@hidden example
+
+El guión @command{pre-inst-env} fija todas las variables de entorno
+necesarias para permitir esto, incluyendo @env{PATH} y
address@hidden
+
+Fíjese que la orden @command{./pre-inst-env guix pull} @emph{no} actualiza
+el árbol de fuentes local; simplemente actualiza el enlace
address@hidden/.config/guix/latest} (@pxref{Invocación de guix pull}). Ejecute
address@hidden pull} si quiere actualizar su árbol de fuentes local.
+
+
address@hidden La configuración perfecta
address@hidden La configuración perfecta
+
+La configuración perfecta para hackear en Guix es básicamente la
+configuración perfecta para hacerlo en Guile (@pxref{Using Guile in Emacs,,,
+guile, Guile Reference Manual}). Primero, necesita más que un editor,
+necesita @url{http://www.gnu.org/software/emacs, Emacs}, empoderado por el
+maravilloso @url{http://nongnu.org/geiser, Geiser}. Para configurarlo,
+ejecute:
+
address@hidden
+guix package -i emacs guile emacs-geiser
address@hidden example
+
+Geiser permite desarrollo incremental e interactivo dentro de Emacs:
+compilación y evaluación de código dentro de los buffers, acceso a
+documentación en línea (docstrings), completado dependiente del contexto,
address@hidden para saltar a la definición de un objeto, una consola interactiva
+(REPL) para probar su código, y más (@pxref{Introducción,,, geiser, Geiser
+User Manual}). Para desarrollar Guix adecuadamente, asegúrese de aumentar la
+ruta de carga de Guile (load-path) para que encuentre los ficheros fuente de
+su copia de trabajo:
+
address@hidden
+;; @r{Suponiendo que la copia de trabajo de Guix está en ~/src/guix.}
+(with-eval-after-load 'geiser-guile
+ (add-to-list 'geiser-guile-load-path "~/src/guix"))
address@hidden lisp
+
+Para realmente editar el código, Emacs tiene un modo limpio para
+Scheme. Pero además de eso, no debe perderse
address@hidden://www.emacswiki.org/emacs/ParEdit, Paredit}. Provee de
facilidades
+para operar directamente en el árbol sintáctico como elevar una expresión S
+o recubrirla, embeber o expulsar la siguiente expresión S, etc.
+
address@hidden fragmentos de código
address@hidden plantillas
address@hidden reducir la verborrea
+También proporcionamos plantillas para los mensajes de revisión de git
+comunes y definiciones de paquetes en el directorio
address@hidden/snippets}. Estas plantillas pueden ser usadas con
address@hidden://joaotavora.github.io/yasnippet, YASnippet} para expandir
+mnemotécnicos a fragmentos interactivos de texto. Puedes querer añadir el
+directorio de fragmentos a la variable @var{yas-snippet-dirs} en Emacs.
+
address@hidden
+;; @r{Suponiendo que la copia de trabajo de Guix está en ~/src/guix.}
+(with-eval-after-load 'yasnippet
+ (add-to-list 'yas-snippet-dirs "~/src/guix/etc/snippets"))
address@hidden lisp
+
+Los fragmentos de mensajes de la revisión dependen de
address@hidden://magit.vc/, Magit} para mostrar los ficheros preparados. En la
+edición del mensaje de la revisión teclee @code{add} seguido de @kbd{TAB}
+(el tabulador) para insertar la plantilla del mensaje de la revisión de
+adición de un paquete; teclee @code{update} seguido de @kbd{TAB} para
+insertar una plantilla de actualización de un paquete; teclee @code{https}
+seguido de @kbd{TAB} para insertar una plantilla para cambiar la URI de la
+página de un paquete a HTTPS.
+
+El fragmento principal para @code{scheme-mode} es activado al teclear
address@hidden seguido de @kbd{TAB}. Este fragmento también inserta el
+lanzador @code{origin...} que puede ser expandido de nuevo. El fragmento
address@hidden puede a su vez insertar otros identificadores de lanzado
+terminando en @code{...}, que pueden ser expandidos de nuevo.
+
+
address@hidden Guías de empaquetamiento
address@hidden Guías de empaquetamiento
+
address@hidden paquetes, creación
+La distribución GNU es reciente y puede no disponer de alguno de sus
+paquetes favoritos. Esta sección describe cómo puede ayudar a hacer crecer
+la distribución.
+
+Los paquetes de software libre habitualmente se distribuyen en forma de
address@hidden de código fuente}---típicamente ficheros @file{tar.gz} que
+contienen todos los ficheros fuente. Añadir un paquete a la distribución
+significa esencialmente dos cosas: añadir una @dfn{receta} que describe cómo
+construir el paquete, la que incluye una lista de otros paquetes necesarios
+para la construcción, y añadir @dfn{metadatos del paquete} junto a dicha
+receta, como la descripción y la información de licencias.
+
+En Guix toda esta información está contenida en @dfn{definiciones de
+paquete}. Las definiciones de paquete proporcionan una vista de alto nivel
+del paquete. Son escritas usando la sintaxis del lenguaje de programación
+Scheme; de hecho, definimos una variable por cada paquete enlazada a su
+definición y exportamos esa variable desde un módulo (@pxref{Módulos de
paquetes}). No obstante, un conocimiento profundo de Scheme @emph{no} es un
+pre-requisito para la creación de paquetes. Para más información obre las
+definiciones de paquetes, @pxref{Definición de paquetes}.
+
+Una vez que una definición de paquete está en su lugar, almacenada en un
+fichero del árbol de fuentes de Guix, puede probarse usando la orden
address@hidden build} (@pxref{Invocación de guix build}). Por ejemplo, asumiendo
+que el nuevo paquete se llama @code{gnuevo}, puede ejecutar esta orden desde
+el árbol de construcción de Guix (@pxref{Ejecución de Guix antes de estar
instalado}):
+
address@hidden
+./pre-inst-env guix build gnuevo --keep-failed
address@hidden example
+
+El uso de @code{--keep-failed} facilita la depuración de errores de
+construcción ya que proporciona acceso al árbol de la construcción
+fallida. Otra opción útil de línea de órdenes para la depuración es
address@hidden, para acceder al log de construcción.
+
+Si el paquete resulta desconocido para la orden @command{guix}, puede ser
+que el fichero fuente contenga un error de sintaxis, o no tenga una cláusula
address@hidden para exportar la variable del paquete. Para encontrar
+el problema puede cargar el módulo desde Guile para obtener más información
+sobre el error real:
+
address@hidden
+./pre-inst-env guile -c '(use-modules (gnu packages gnuevo))'
address@hidden example
+
+Una vez que se construya correctamente su paquete, por favor, envíenos un
+parche (@pxref{Envío de parches}). En cualquier caso, si necesita ayuda
+también estaremos felices de ayudarle. Una vez el parche se haya incorporado
+al repositorio de Guix, el nuevo paquete se construye automáticamente en las
+plataformas disponibles por @url{http://hydra.gnu.org/jobset/gnu/master,
+nuestro sistema de integración continua}.
+
address@hidden servidor de sustituciones
+Las usuarias pueden obtener la nueva definición de paquete ejecutando
+simplemente @command{guix pull} (@pxref{Invocación de guix pull}). Cuando
address@hidden@value{SUBSTITUTE-SERVER}} ha terminado de construir el paquete,
la
+instalación del paquete descarga automáticamente los binarios desde allí
+(@pxref{Sustituciones}). El único lugar donde la intervención humana es
+necesaria es en la revisión y aplicación del parche.
+
+
address@hidden
+* Libertad del software:: Qué puede entrar en la distribución.
+* Nombrado de paquetes:: ¿Qué hay en un nombre?
+* Versiones numéricas:: Cuando el nombre no es suficiente.
+* Sinopsis y descripciones:: Ayudar a las usuarias a encontrar el paquete
+ adecuado.
+* Módulos Python:: Un toque de comedia británica.
+* Módulos Perl:: Pequeñas perlas.
+* Paquetes Java:: La parada del café.
+* Tipografías:: Amor por las letras.
address@hidden menu
+
address@hidden Libertad del software
address@hidden Libertad del software
+
address@hidden
===========================================================================
address@hidden
address@hidden This file was generated with po4a. Translate the source file.
address@hidden
address@hidden
===========================================================================
address@hidden Adapted from http://www.gnu.org/philosophy/philosophy.html.
address@hidden software libre
+El sistema operativo GNU se ha desarrollado para que las usuarias puedan
+ejercitar su libertad de computación. GNU es @dfn{software libre}, lo que
+significa ue las usuarias tienen las
address@hidden://www.gnu.org/philosophy/free-sw.html,cuatro libertades
+esenciales}: para ejecutar el programa, para estudiar y modificar el
+programa en la forma de código fuente, para redistribuir copias exactas y
+para distribuir versiones modificadas. Los paquetes encontrados en la
+distribución GNU proporcionan únicamente software que permite estas cuatro
+libertades.
+
+Además, la distribución GNU sigue las
address@hidden://www.gnu.org/distros/free-system-distribution-guidelines.html,directrices
+de distribución de software libre}. Entre otras cosas, estas directrices
+rechazan firmware no-libre, recomendaciones de software no-libre y el
+tratamiento de formas de tratar con marcas registradas y patentes.
+
+Algunos paquetes originales, que serían de otra manera software libre,
+contienen un subconjunto pequeño y opcional que viola estas directrices, por
+ejemplo debido a que ese subconjunto sea en sí código no-libre. Cuando esto
+sucede, las partes indeseadas son eliminadas con parches o fragmentos de
+código en la forma @code{origin} del paquete (@pxref{Definición de paquetes}).
De
+este modo, @code{guix build --source} devuelve las fuentes ``liberadas'' en
+vez de la versión original de las fuentes.
+
+
address@hidden Nombrado de paquetes
address@hidden Nombrado de paquetes
+
address@hidden nombre de paquete
+Un paquete tiene realmente dos nombres asociados con él: Primero, el nombre
+de la @emph{variable Scheme} asociada, que aparece después de
address@hidden A través de este nombre, el paquete está disponible en
+código Scheme, por ejemplo como entrada de otro paquete. Segundo, la cadena
+en el campo @code{name} de la definición de paquete. Este nombre se usa por
+las órdenes de gestión de paquetes como @command{guix package} y
address@hidden build}.
+
+Ambos normalmente son iguales y corresponden a la conversión a minúsculas
+del nombre de proyecto elegido por sus creadoras, con los guiones bajos
+sustituidos por guiones. Por ejemplo, GNUnet está disponible como
address@hidden, y SDL_net como @code{sdl-net}.
+
+No añadimos prefijos @code{lib} para paquetes de bibliotecas, a menos que
+sean parte del nombre oficial del proyecto. Pero vea @ref{Módulos Python} y
address@hidden Perl} para reglas especiales que conciernen a los módulos de
+los lenguajes Python y Perl.
+
+Los nombres de paquetes de tipografías se manejan de forma diferente,
address@hidden
+
+
address@hidden Versiones numéricas
address@hidden Versiones numéricas
+
address@hidden versión de paquete
+Normalmente empaquetamos únicamente la última versión de un proyecto dado de
+software libre. Pero a veces, por ejemplo para versiones de bibliotecas
+incompatibles, se necesitan dos (o más) versiones del mismo paquete. Estas
+necesitan nombres diferentes para las variables Scheme. Usamos el nombre
+como se define en @ref{Nombrado de paquetes} para la versión más reciente; las
+versiones previas usan el mismo nombre, añadiendo un @code{-} y el prefijo
+menor del número de versión que permite distinguir las dos versiones.
+
+El nombre dentro de la definición de paquete es el mismo para todas las
+versiones de un paquete y no contiene ningún número de versión.
+
+Por ejemplo, las versiones 2.24.20 y 3.9.12 de GTK+ pueden empaquetarse como
+sigue:
+
address@hidden
+(define-public gtk+
+ (package
+ (name "gtk+")
+ (version "3.9.12")
+ ...))
+(define-public gtk+-2
+ (package
+ (name "gtk+")
+ (version "2.24.20")
+ ...))
address@hidden example
+Si también deseásemos GTK+3.8.2, se empaquetaría como
address@hidden
+(define-public gtk+-3.8
+ (package
+ (name "gtk+")
+ (version "3.8.2")
+ ...))
address@hidden example
+
address@hidden See
<https://lists.gnu.org/archive/html/guix-devel/2016-01/msg00425.html>,
address@hidden for a discussion of what follows.
address@hidden número de versión, para revisiones de VCS
+De manera ocasional, empaquetamos instantáneas del sistema de control de
+versiones (VCS) de las desarrolladoras originales en vez de publicaciones
+formales. Esto debería permanecer como algo excepcional, ya que son las
+desarrolladoras originales quienes deben clarificar cual es la entrega
+estable. No obstante, a veces es necesario. Por tanto, ¿qué deberíamos poner
+en el campo @code{version}?
+
+Claramente, tenemos que hacer visible el identificador de la revisión en el
+VCS en la cadena de versión, pero tamién debemos asegurarnos que la cadena
+de versión incrementa monotónicamente de manera que @command{guix package
+--upgrade} pueda determinar qué versión es más moderna. Ya que los
+identificadores de revisión, notablemente en Git, no incrementan
+monotónicamente, añadimos un número de revisión que se incrementa cada vez
+que actualizamos a una nueva instantánea. La versión que resulta debería ser
+así:
+
address@hidden
+2.0.11-3.cabba9e
+ ^ ^ ^
+ | | `-- ID de revisión original
+ | |
+ | `--- revisión del paquete Guix
+ |
+última versión de publicación
address@hidden example
+
+Es una buena idea recortar los identificadores de revisión en el campo
address@hidden a, digamos, 7 dígitos. Esto evita una molestia estética
+(asumiendo que la estética tiene importancia aquí) así como problemas
+relacionados con los límites del sistema operativo como la longitud máxima
+de una cadena de ejecución #! (127 bytes en el núcleo Linux). Es mejor usar
+el identificador de revisión completo en @code{origin}, no obstante, para
+evitar ambigüedades. Una definición típica de paquete sería así:
+
address@hidden
+(define mi-paquete
+ (let ((commit "c3f29bc928d5900971f65965feaae59e1272a3f7")
+ (revision "1")) ;Revisión Guix del paquete
+ (package
+ (version (git-version "0.9" revision commit))
+ (source (origin
+ (method git-fetch)
+ (uri (git-reference
+ (url "git://example.org/mi-paquete.git")
+ (commit commit)))
+ (sha256 (base32 "address@hidden"))
+ (file-name (git-file-name name version))))
+ ;; @dots{}
+ )))
address@hidden example
+
address@hidden Sinopsis y descripciones
address@hidden Sinopsis y descripciones
+
address@hidden descripción de paquete
address@hidden sinopsis de paquete
+Como hemos visto previamente, cada paquete en address@hidden incluye una
+sinopsis y una descripción (@pxref{Definición de paquetes}). Las sinopsis y
+descripciones son importantes: son en lo que @command{guix package --search}
+busca, y una pieza crucial de información para ayudar a las usuarias a
+determinar si un paquete dado cubre sus necesidades. Consecuentemente, las
+empaquetadoras deben prestar atención a qué se incluye en ellas.
+
+Las sinopsis deben empezar con mayúscula y no deben terminar con punto. No
+deben empezar con un artículo que habitualmente no aporta nada; por ejemplo,
+se prefiere ``Herramienta para chiribizar'' sobre ``Una herramienta que
+chiribiza ficheros''. La sinopsis debe decir qué es el paquete---por
+ejemplo, ``Utilidades básicas GNU (ficheros, texto, shell)''---o para qué se
+usa---por ejemplo, la sinopsis de address@hidden es ``Imprime líneas que
+aceptadas por un patrón''.
+
+Tenga en cuenta que las sinopsis deben tener un claro significado para una
+audiencia muy amplia. Por ejemplo, ``Manipula la alineación en el formato
+SAM'' puede tener sentido para una investigadora de bioinformática con
+experiencia, pero puede ser de poca ayuda o incluso llevar a confusión a una
+audiencia no-especializada. Es una buena idea proporcionar una sinopsis que
+da una idea del dominio de aplicación del paquete. En ese ejemplo, esto
+podría ser algo como ``Manipula la alineación de secuencias de
+nucleótidos'', lo que esperablemente proporciona a la usuaria una mejor idea
+sobre si esto es lo que está buscando.
+
+Las descripciones deben tener entre cinco y diez líneas. Use frases
+completas, y evite usar acrónimos sin introducirlos previamente. Por favor
+evite frases comerciales como ``líder mundial'', ``de potencia industrial''
+y ``siguiente generación'', y evite superlativos como ``el más
+avanzado''---no son útiles para las usuarias que buscan un paquete e incluso
+pueden sonar sospechosas. En vez de eso, intente ceñirse a los hechos,
+mencionando casos de uso y características.
+
address@hidden marcado Texinfo, en descripciones de paquetes
+Las descripciones pueden incluir marcado Texinfo, lo que es útil para
+introducir ornamentos como @code{@@code} o @code{@@dfn}, listas de puntos o
+enlaces (@pxref{Overview,,, texinfo, GNU Texinfo}). Por consiguiente, debe
+ser cuidadosa cuando use algunos caracteres, por ejemplo @samp{@@} y llaves,
+que son los caracteres especiales básicos en Texinfo (@pxref{Special
+Characters,,, texinfo, GNU Texinfo}). Las interfaces de usuaria como
address@hidden package --show} se encargan de su correcta visualización.
+
+Las sinopsis y descripciones son traducidas por voluntarias
address@hidden://translationproject.org/domain/guix-packages.html, en
+Translation Project} para que todas las usuarias posibles puedan leerlas en
+su lengua nativa. Las interfaces de usuaria las buscan y las muestran en el
+idioma especificado por la localización actual.
+
+Para permitir a @command{xgettext} extraerlas como cadenas traducibles, las
+sinopsis y descripciones @emph{deben ser cadenas literales}. Esto significa
+que no puede usar @code{string-append} o @code{format} para construir estas
+cadenas:
+
address@hidden
+(package
+ ;; @dots{}
+ (synopsis "Esto es traducible")
+ (description (string-append "Esto " "*no*" " es traducible.")))
address@hidden lisp
+
+La traducción requiere mucho trabajo, por lo que, como empaquetadora, le
+rogamos que ponga incluso más atención a sus sinopsis y descripciones ya que
+cada cambio puede suponer trabajo adicional para las traductoras. Para
+ayudarlas, es posible hacer recomendaciones o instrucciones insertando
+comentarios especiales como este (@pxref{xgettext Invocation,,, gettext, GNU
+Gettext}):
+
address@hidden
+;; TRANSLATORS: "X11 resize-and-rotate" should not be translated.
+(description "ARandR is designed to provide a simple visual front end
+for the X11 resize-and-rotate (RandR) extension. @dots{}")
address@hidden example
+
+
address@hidden Módulos Python
address@hidden Módulos Python
+
address@hidden python
+Actualmente empaquetamos Python 2 y Python 3, bajo los nombres de variable
+Scheme @code{python-2} y @code{python} como se explica en @ref{Versiones
numéricas}. Para evitar confusiones y conflictos de nombres con otros
+lenguajes de programación, parece deseable que el nombre de paquete para un
+módulo Python contenga la palabra @code{python}.
+
+Algunos módulos son compatibles únicamente con una versión de Python, otros
+con ambas. Si el paquete Foo compila sólo con Python 3, lo llamamos
address@hidden; si compila sólo con Python 2, lo llamamos
address@hidden Si es compatible con ambas versiones, creamos dos
+paquetes con los nombres correspondientes.
+
+Si un proyecto ya contiene la palabra @code{python}, la eliminamos; por
+ejemplo, el módulo python-dateutil se empaqueta con los nombres
address@hidden y @code{python2-dateutil}. Si el nombre del proyecto
+empieza con @code{py} (por ejemplo @code{pytz}), este se mantiene y el
+prefijo es el especificado anteriormente..
+
address@hidden Especificación de dependencias
address@hidden entradas, para paquetes Python
+
+La información de dependencias para paquetes Python está disponible
+habitualmente en el árbol de fuentes, con varios grados de precisión: en el
+fichero @file{setup.py}, en @file{requirements.txt} o en @file{tox.ini}.
+
+Su misión, cuando escriba una receta para un paquete Python, es asociar
+estas dependencias con el tipo apropiado de ``entrada'' (@pxref{Referencia de
``package'', inputs}). Aunque el importador de @code{pypi} normalmente hace un
+buen trabajo (@pxref{Invocación de guix import}), puede querer comprobar la
+siguiente lista para determinar qué dependencia va dónde.
+
address@hidden
+
address@hidden
+Actualmente empaquetamos con @code{setuptools} y @code{pip} instalados como
+Python 3.4 tiene por defecto. Por tanto no necesita especificar ninguno de
+ellos como entrada. @command{guix lint} le avisará si lo hace.
+
address@hidden
+Las dependencias Python requeridas en tiempo de ejecución van en
address@hidden Típicamente están definidas con la palabra clave
address@hidden en @file{setup.py}, o en el fichero
address@hidden
+
address@hidden
+Los paquetes Python requeridos únicamente durante la construcción---por
+ejemplo, aquellos listados con la palabra clave @code{setup_requires} en
address@hidden únicamente para pruebas---por ejemplo, aquellos en
address@hidden en @code{native-inputs}. La razón es que (1) no
+necesitan ser propagados ya que no se requieren en tiempo de ejecución, y
+(2) en un entorno de compilación cruzada lo que necesitamos es la entrada
+``nativa''.
+
+Ejemplos son las bibliotecas de pruebas @code{pytest}, @code{mock} y
address@hidden Por supuesto, si alguno de estos paquetes también se necesita
+en tiempo de ejecución, necesita ir en @code{propagated-inputs}.
+
address@hidden
+Todo lo que no caiga en las categorías anteriores va a @code{inputs}, por
+ejemplo programas o bibliotecas C requeridas para construir los paquetes
+Python que contienen extensiones C.
+
address@hidden
+Si un paquete Python tiene dependencias opcionales (@code{extras_require}),
+queda en su mano decidir si las añade o no, en base a la relación
+utilidad/sobrecarga (@pxref{Envío de parches, @command{guix size}}).
+
address@hidden itemize
+
+
address@hidden Módulos Perl
address@hidden Módulos Perl
+
address@hidden perl
+Los programas ejecutables Perl se nombran como cualquier otro paquete,
+mediante el uso del nombre oficial en minúsculas. Para paquetes Perl que
+contienen una única clase, usamos el nombre en minúsculas de la clase,
+substituyendo todas las ocurrencias de @code{::} por guiones y agregando el
+prefijo @code{perl-}. Por tanto la clase @code{XML::Parser} se convierte en
address@hidden Los módulos que contienen varias clases mantienen su
+nombre oficial en minúsculas y también se agrega @code{perl-} al
+inicio. Dichos módulos tienden a tener la palabra @code{perl} en alguna
+parte de su nombre, la cual se elimina en favor del prefijo. Por ejemplo,
address@hidden se convierte en @code{perl-libwww}.
+
+
address@hidden Paquetes Java
address@hidden Paquetes Java
+
address@hidden java
+Los programas Java ejecutables se nombran como cualquier otro paquete,
+mediante el uso del nombre oficial en minúsculas.
+
+Para evitar confusión y colisiones de nombres con otros lenguajes de
+programación, es deseable que el nombre del paquete para un paquete Java
+contenga el prefijo @code{java-}. Si el proyecto ya tiene la palabra
address@hidden, eliminamos esta; por ejemplo, el paquete @code{ngsjaga} se
+empaqueta bajo el nombre @code{java-ngs}.
+
+Para los paquetes Java que contienen una clase única o una jerarquía
+pequeña, usamos el nombre de clase en minúsculas, substituyendo todas las
+ocurrencias de @code{.} por guiones y agregando el prefijo @code{java-}. Por
+tanto la clase @code{apache.commons.cli} se convierte en el paquete
address@hidden
+
+
address@hidden Tipografías
address@hidden Tipografías
+
address@hidden tipografías
+Para tipografías que no se instalan generalmente por una usuaria para
+propósitos tipográficos, o que se distribuyen como parte de un paquete de
+software más grande, seguimos las reglas generales de empaquetamiento de
+software; por ejemplo, esto aplica a las tipografías distribuidas como parte
+del sistema X.Org o las tipografías que son parte de TeX Live.
+
+Para facilitar a las usuarias la búsqueda de tipografías, los nombres para
+otros paquetes que contienen únicamente tipografías se construyen como
+sigue, independientemente del nombre de paquete oficial.
+
+El nombre de un paquete que contiene únicamente una familia tipográfica
+comienza con @code{font-}; seguido por el nombre de la tipografía y un guión
+si la tipografía es conocida, y el nombre de la familia tipográfica, donde
+los espacios se sustituyen por guiones (y como es habitual, todas las letras
+mayúsculas se transforman a minúsculas). Por ejemplo, la familia de
+tipografías Gentium de SIL se empaqueta bajo el nombre de
address@hidden
+
+Para un paquete que contenga varias familias tipográficas, el nombre de la
+colección se usa en vez del nombre de la familia tipográfica. Por ejemplo,
+las tipografías Liberation consisten en tres familias: Liberation Sans,
+Liberation Serif y Liberation Mono. Estas se podrían empaquetar por separado
+bajo los nombres @code{font-liberation-sans}, etcétera; pero como se
+distribuyen de forma conjunta bajo un nombre común, preferimos empaquetarlas
+conjuntamente como @code{font-liberation}.
+
+En el caso de que varios formatos de la misma familia o colección
+tipográfica se empaqueten de forma separada, una forma corta del formato,
+precedida por un guión, se añade al nombre del paquete. Usamos @code{-ttf}
+para tipografías TrueType, @code{-otf} para tipografías OpenType y
address@hidden para tipografías Tipo 1 PostScript.
+
+
address@hidden Estilo de codificación
address@hidden Estilo de codificación
+
+En general nuestro código sigue los Estándares de codificación GNU
+(@pxref{Top,,, standards, GNU Coding Standards}). No obstante, no dicen
+mucho de Scheme, así que aquí están algunas reglas adicionales.
+
address@hidden
+* Paradigma de programación:: Cómo componer sus elementos.
+* Módulos:: ¿Dónde almacenar su código?
+* Tipos de datos y reconocimiento de patrones:: Implementación de
+ estructuras de datos.
+* Formato del código:: Convenciones de escritura.
address@hidden menu
+
address@hidden Paradigma de programación
address@hidden Paradigma de programación
+
+El código scheme en Guix está escrito en un estilo puramente funcional. Una
+excepción es el código que incluye entrada/salida, y procedimientos que
+implementan conceptos de bajo nivel, como el procedimiento @code{memoize}.
+
address@hidden Módulos
address@hidden Módulos
+
+Los módulos Guile que están destinados a ser usados en el lado del
+constructor deben encontrarse en el espacio de nombres @code{(guix build
address@hidden)}. No deben hacer referencia a otros módulos Guix o GNU. No
+obstante, no hay problema en usar un módulo del lado del constructor en un
+módulo ``del lado del cliente''.
+
+Los módulos que tratan con el sistema GNU más amplio deben estar en el
+espacio de nombres @code{(gnu @dots{})} en vez de en @code{(guix @dots{})}.
+
address@hidden Tipos de datos y reconocimiento de patrones
address@hidden Tipos de datos y reconocimiento de patrones
+
+La tendencia en el Lisp clásico es usar listas para representar todo, y
+recorrerlas ``a mano'' usando @code{car}, @code{cdr}, @code{cadr} y
+compañía. Hay varios problemas con este estilo, notablemente el hecho de que
+es difícil de leer, propenso a errores y una carga para informes adecuados
+de errores de tipado.
+
+El código de Guix debe definir tipos de datos apropiados (por ejemplo,
+mediante el uso @code{define-record-type*}) en vez de abusar de las
+listas. Además debe usarse el reconocimiento de patrones, vía el módulo de
+Guile @code{(ice-9 match)}, especialmente cuando se analizan listas.
+
address@hidden Formato del código
address@hidden Formato del código
+
address@hidden dar formato al código
address@hidden estilo de codificación
+Cuando escribimos código Scheme, seguimos la sabiduría común entre las
+programadoras Scheme. En general, seguimos las
address@hidden://mumble.net/~campbell/scheme/style.txt, Reglas de estilo Lisp de
+Riastradh}. Este documento resulta que también describe las convenciones más
+usadas en el código Guile. Está lleno de ideas y bien escrito, así que
+recomendamos encarecidamente su lectura.
+
+Algunas formas especiales introducidas en Guix, como el macro
address@hidden tienen reglas de indentación especiales. Estas están
+definidas en el fichero @file{.dir-locals.el}, el cual Emacs usa
+automáticamente. Fíjese que además Emacs-Guix proporciona el modo
address@hidden que indenta y resalta adecuadamente el código de Guix
+(@pxref{Desarrollo,,, emacs-guix, The Emacs-Guix Reference Manual}).
+
address@hidden indentación, de código
address@hidden formato, de código
+Si no usa Emacs, por favor asegúrese de que su editor conoce esas
+reglas. Para indentar automáticamente una definición de paquete también
+puede ejecutar:
+
address@hidden
+./etc/indent-code.el gnu/packages/@var{fichero}.scm @var{paquete}
address@hidden example
+
address@hidden
+Esto indenta automáticamente la definición de @var{paquete} en
address@hidden/packages/@var{fichero}.scm} ejecutando Emacs en modo de
+procesamiento de lotes. Para indentar un fichero completo, omita el segundo
+parámetro:
+
address@hidden
+./etc/indent-code.el gnu/services/@var{fichero}.scm
address@hidden example
+
address@hidden Vim, edición de código Scheme
+Si está editando código con Vim, le recomendamos ejecutar @code{:set
+autoindent} para que el código se indente automáticamente mientras
+escribe. Adicionalmente,
address@hidden://www.vim.org/scripts/script.php?script_id=3998,
address@hidden puede ayudar a manejar todos estos paréntesis.
+
+Requerimos que todos los procedimientos del nivel superior tengan una cadena
+de documentación. Este requisito puede relajarse para procedimientos simples
+privados en el espacio de nombres @code{(guix build @dots{})} no obstante.
+
+Los procedimientos no deben tener más de cuatro parámetros posicionales. Use
+parámetros con palabras clave para procedimientos que toman más de cuatro
+parámetros.
+
+
address@hidden Envío de parches
address@hidden Envío de parches
+
+El desarrollo se lleva a cabo usando el sistema de control de versiones
+distribuido Git. Por lo tanto, no es estrictamente necesario el acceso al
+repositorio. Son bienvenidas las contribuciones en forma de parches como los
+producidos por @code{git format-patch} enviadas a la lista de correo
address@hidden@@gnu.org}.
+
+Esta lista de correo está respaldada por una instancia de Debbugs accesible
+en @uref{https://bugs.gnu.org/guix-patches}, la cual nos permite mantener el
+seguimiento de los envíos. A cada mensaje enviado a esa lista de correo se
+le asigna un número de seguimiento; la gente puede realizar aportaciones
+sobre el tema mediante el envío de correos electrónicos a
address@hidden@var{NNN}@@debbugs.gnu.org}, donde @var{NNN} es el número de
+seguimiento (@pxref{Envío de una serie de parches}).
+
+Le rogamos que escriba los mensajes de revisiones en formato ChangeLog
+(@pxref{Change Logs,,, standards, GNU Coding Standards}); puede comprobar la
+historia de revisiones en busca de ejemplos.
+
+Antes de enviar un parche que añade o modifica una definición de un paquete,
+por favor recorra esta lista de comprobaciones:
+
address@hidden
address@hidden
+Si las autoras del paquete software proporcionan una firma criptográfica
+para el archivo de la versión, haga un esfuerzo para verificar la
+autenticidad del archivo. Para un fichero de firma GPG separado esto puede
+hacerse con la orden @code{gpg --verify}.
+
address@hidden
+Dedique algún tiempo a proporcionar una sinopsis y descripción adecuadas
+para el paquete. @xref{Sinopsis y descripciones}, para algunas directrices.
+
address@hidden
+Ejecute @code{guix lint @var{paquete}}, donde @var{paquete} es el nombre del
+paquete nuevo o modificado, y corrija cualquier error del que informe
+(@pxref{Invocación de guix lint}).
+
address@hidden
+Asegurese de que el paquete compile en su plataforma, usando @code{guix
+build @var{package}}.
+
address@hidden
+También le recomendamos que pruebe a construir el paquete en otras
+plataformas disponibles. Como puede no disponer de acceso a dichas
+plataformas hardware físicamente, le recomendamos el uso de
address@hidden para emularlas. Para activarlo, añada el
+siguiente servicio a la lista de servicios en su configuración
address@hidden:
+
address@hidden
+(service qemu-binfmt-service-type
+ (qemu-binfmt-configuration
+ (platforms (lookup-qemu-platforms "arm" "aarch64" "mips64el"))
+ (guix-support? #t)))
address@hidden example
+
+Una vez hecho esto, reconfigure su sistema.
+
+Enotonces podrá construir paquetes para diferentes plataformas mediante la
+opción @code{--system}. Por ejemplo, para la construcción del paquete
+"hello" para las arquitecturas armhf, aarch64 o mips64 ejecutaría las
+siguientes órdenes, respectivamente:
address@hidden
+guix build --system=armhf-linux --rounds=2 hello
+guix build --system=aarch64-linux --rounds=2 hello
+guix build --system=mips64el-linux --rounds=2 hello
address@hidden example
+
address@hidden
address@hidden empaquetamientos
+Asegurese de que el paquete no usa copias empaquetadas de software ya
+disponible como paquetes separados.
+
+A veces, paquetes incluyen copias embebidas del código fuente de sus
+dependencias para conveniencia de las usuarias. No obstante, como
+distribución, queremos asegurar que dichos paquetes efectivamente usan la
+copia que ya tenemos en la distribución si hay ya una. Esto mejora el uso de
+recursos (la dependencia es construida y almacenada una sola vez), y permite
+a la distribución hacer cambios transversales como aplicar actualizaciones
+de seguridad para un software dado en un único lugar y que afecte a todo el
+sistema---algo que esas copias embebidas impiden.
+
address@hidden
+Eche un vistazo al perfil mostrado por @command{guix size} (@pxref{Invocación
de guix size}). Esto le permitirá darse cuenta de referencias a otros paquetes
+retenidas involuntariamente. También puede ayudar a determinar si se debe
+dividir el paquete (@pxref{Paquetes con múltiples salidas}), y qué
+dependencias opcionales deben usarse. En particular, evite añadir
address@hidden como una dependencia: debido a su tamaño extremo, use
address@hidden o @code{texlive-union}.
+
address@hidden
+Para cambios importantes, compruebe que los paquetes dependientes (si
+aplica) no se ven afectados por el cambio; @code{guix refresh
+--list-dependent @var{package}} le ayudará a hacerlo (@pxref{Invocación de
guix refresh}).
+
address@hidden See
<https://lists.gnu.org/archive/html/guix-devel/2016-10/msg00933.html>.
address@hidden estrategia de ramas
address@hidden estrategia de planificación de reconstrucciones
+En base al número de paquetes dependientes y, por tanto, del tamaño de la
+reconstrucción inducida, los revisiones van a ramas separadas, según estas
+líneas:
+
address@hidden @asis
address@hidden 300 paquetes dependientes o menos
+rama @code{master} (cambios no disruptivos).
+
address@hidden entre 300 y 1.200 paquetes dependientes
+rama @code{staging} (cambios no disruptivos). Esta rama está pensada para
+ser incorporada en @code{master} cada 3 semanas más o menos. Ramas temáticas
+(por ejemplo, una actualización de la pila de GNOME) pueden ir en una rama
+específica (digamos, @code{gnome-updates}).
+
address@hidden más de 1.200 paquetes dependientes
+rama @code{core-updates} (puede incluir cambios mayores y potencialmente
+disruptivos). Esta rama está pensada para ser incluida en @code{master} cada
+2,5 más o menos.
address@hidden table
+
+Todas estas ramas son @uref{https://hydra.gnu.org/project/gnu, seguidas por
+nuestra granja de construcción} e incluidas en @code{master} una vez todo se
+ha construido satisfactoriamente. Esto nos permite corregir errores antes de
+que afecten a usuarias, y reducir la ventana durante la cual los binarios
+preconstruidos no están disponibles.
+
address@hidden TODO: It would be good with badges on the website that tracks
these
address@hidden branches. Or maybe even a status page.
+Generalmente, ramas distintas a @code{master} se consideran
address@hidden si ha habido una evaluación reciente, o hay una rama
address@hidden correspondiente. Por favor, pregunte en la lista de correo o en
+IRC si no está segura de dónde colocar un parche.
+
address@hidden
address@hidden determinismo, del proceso de construcción
address@hidden construcciones reproducibles, comprobar
+Compruebe si el proceso de construcción de un paquete es determinista. Esto
+significa típicamente comprobar si una construcción independiente del
+paquete ofrece exactamente el mismo resultado que usted obtuvo, bit a bit.
+
+Una forma simple de hacerlo es construyendo el mismo paquete varias veces
+seguidas en su máquina (@pxref{Invocación de guix build}):
+
address@hidden
+guix build --rounds=2 mi-paquete
address@hidden example
+
+Esto es suficiente una clase común de problemas de no-determinismo, como las
+marcas de tiempo o salida generada aleatoriamente en el resultado de la
+construcción.
+
+Otra opción es el uso de @command{guix challenge} (@pxref{Invocación de guix
challenge}). Puede ejecutarse una vez la revisión del paquete haya sido
+publicada y construida por @address@hidden para comprobar
+si obtuvo el mismo resultado que usted. Mejor aún: encuentre otra máquina
+que pueda construirla y ejecute @command{guix publish}. Ya que la máquina
+remota es probablemente diferente a la suya, puede encontrar problemas de
+no-determinismo relacionados con el hardware---por ejemplo, el uso de un
+conjunto de instrucciones extendido diferente---o con el núcleo del sistema
+operativo---por ejemplo, dependencias en @code{uname} o ficheros
address@hidden/proc}.
+
address@hidden
+Cuando escriba documentación, por favor use construcciones neutrales de
+género para referirse a la address@hidden: En esta traducción se ha
+optado por usar el femenino para referirse a @emph{personas}, ya que es el
+género gramatical de dicha palabra. Aunque las construcciones impersonales
+pueden adoptarse en la mayoría de casos, también pueden llegar a ser muy
+artificiales en otros usos del castellano; en ocasiones son directamente
+imposibles. Algunas construcciones que proponen la neutralidad de género
+dificultan la lecura automática (-x), o bien dificultan la corrección
+automática (-e), o bien aumentan significativamente la redundancia y reducen
+del mismo modo la velocidad en la lectura (-as/os, -as y -os). No obstante,
+la adopción del genero neutro heredado del latín, el que en castellano se ha
+unido con el masculino, como construcción neutral de género se considera
+inaceptable, ya que sería equivalente al ``it'' en inglés, nada más lejos de
+la intención de las autoras originales del texto.}, como
address@hidden://en.wikipedia.org/wiki/Singular_they, singular ``they''@comma{}
+``their''@comma{} ``them''} y demás.
+
address@hidden
+Compruebe que su parche contiene únicamente un conjunto relacionado de
+cambios. Agrupando cambios sin relación dificulta y ralentiza la revisión.
+
+Ejemplos de cambios sin relación incluyen la adición de varios paquetes, o
+una actualización de un paquete junto a correcciones a ese paquete.
+
address@hidden
+Por favor, siga nuestras reglas de formato de código, posiblemente
+ejecutando el guión @command{etc/indent-code.el} para que lo haga
+automáticamente por usted (@pxref{Formato del código}).
+
address@hidden
+Cuando sea posible, use espejos en la URL de las fuentes (@pxref{Invocación de
guix download}). Use URL fiables, no generadas. Por ejemplo, los archivos de
+GitHub no son necesariamente idénticos de una generación a la siguiente, así
+que en este caso es normalmente mejor clonar el repositorio. No use el campo
address@hidden en la URL: no es muy útil y si el nombre cambia, la URL
+probablemente estará mal.
+
address@hidden enumerate
+
+Cuando publique un parche a la lista de correo, use @samp{[PATCH] @dots{}}
+como el asunto. Puede usar su cliente de correo o la orden @command{git
+send-email} (@pxref{Envío de una serie de parches}). Preferimos recibir los
parches
+en texto plano, ya sea en línea o como adjuntos MIME. Se le recomienda que
+preste atención por si su cliente de correo cambia algo como los saltos de
+línea o la indentación, lo que podría potencialmente romper los parches.
+
+Cuando un error es resuelto, por favor cierre el hilo enviando un correo a
address@hidden@var{NNN}-done@@debbugs.gnu.org}.
+
address@hidden Envío de una serie de parches
address@hidden de una serie de parches}
address@hidden series de parches
address@hidden @code{git send-email}
address@hidden @code{git-send-email}
+
address@hidden Debbugs bug: https://debbugs.gnu.org/db/15/15361.html
+Cuando envíe una serie de parches (por ejemplo, usando @code{git
+send-email}), por favor mande primero un mensaje a
address@hidden@@gnu.org}, y después mande los parches siguientes a
address@hidden@var{NNN}@@debbugs.gnu.org} para asegurarse de que se mantienen
+juntos. Véase @uref{https://debbugs.gnu.org/Advanced.html, la documentación
+de Debbugs} para más información.
diff --git a/doc/guix.es.texi b/doc/guix.es.texi
new file mode 100644
index 0000000..ece6073
--- /dev/null
+++ b/doc/guix.es.texi
@@ -0,0 +1,26015 @@
+\input texinfo
address@hidden
===========================================================================
address@hidden
address@hidden This file was generated with po4a. Translate the source file.
address@hidden
address@hidden
===========================================================================
address@hidden -*-texinfo-*-
+
address@hidden %**start of header
address@hidden guix.es.info
address@hidden UTF-8
address@hidden es
address@hidden on
address@hidden Manual de referencia de GNU Guix
address@hidden %**end of header
+
address@hidden version-es.texi
+
address@hidden Identifier of the OpenPGP key used to sign tarballs and such.
address@hidden OPENPGP-SIGNING-KEY-ID 3CE464558A84FDC69DB40CFB090B11993D9AEBB5
address@hidden KEY-SERVER pool.sks-keyservers.net
+
address@hidden The official substitute server used by default.
address@hidden SUBSTITUTE-SERVER ci.guix.es.info
+
address@hidden
+Copyright @copyright{} 2012, 2013, 2014, 2015, 2016, 2017, 2018, 2019
+Ludovic address@hidden Copyright @copyright{} 2013, 2014, 2016 Andreas
address@hidden
+Copyright @copyright{} 2013 Nikita address@hidden Copyright @copyright{} 2014,
+2015, 2016 Alex address@hidden Copyright @copyright{} 2015, 2016 Mathieu
address@hidden
+Copyright @copyright{} 2014 Pierre-Antoine address@hidden Copyright
@copyright{}
+2015 Taylan Ulrich Bayırlı/address@hidden Copyright @copyright{} 2015, 2016,
2017
+Leo address@hidden Copyright @copyright{} 2015, 2016, 2017, 2018, 2019 Ricardo
address@hidden Copyright @copyright{} 2016 Ben address@hidden Copyright
@copyright{}
+2016, 2017, 2018 Chris address@hidden Copyright @copyright{} 2016, 2017, 2018,
+2019 Efraim address@hidden Copyright @copyright{} 2016 John address@hidden
+Copyright @copyright{} 2016, 2017 address@hidden Copyright @copyright{} 2016,
2017,
+2018, 2019 Jan address@hidden Copyright @copyright{} 2016 Julien address@hidden
+Copyright @copyright{} 2016 Alex ter address@hidden Copyright @copyright{}
2016,
+2017, 2018, 2019 Christopher address@hidden Copyright @copyright{} 2017, 2018
+Clément address@hidden Copyright @copyright{} 2017, 2018 Mathieu address@hidden
+Copyright @copyright{} 2017 Federico address@hidden Copyright @copyright{}
2017,
+2018 Carlo address@hidden Copyright @copyright{} 2017 Thomas address@hidden
+Copyright @copyright{} 2017 address@hidden Copyright @copyright{} 2017
+Christopher Allan address@hidden Copyright @copyright{} 2017, 2018 Marius
address@hidden
+Copyright @copyright{} 2017 Hartmut address@hidden Copyright @copyright{} 2017
+Maxim address@hidden Copyright @copyright{} 2017, 2018 Tobias address@hidden
+Copyright @copyright{} 2017 George address@hidden Copyright @copyright{} 2017
+Andy address@hidden Copyright @copyright{} 2017, 2018, 2019 Arun
address@hidden Copyright
address@hidden 2017 address@hidden Copyright @copyright{} 2018 Rutger
address@hidden
+Copyright @copyright{} 2018 Oleg address@hidden Copyright @copyright{} 2018
Mike
address@hidden Copyright @copyright{} 2018 Pierre-Antoine address@hidden
Copyright
address@hidden 2018 Gábor address@hidden Copyright @copyright{} 2018 Florian
address@hidden Copyright @copyright{} 2018 Laura address@hidden Copyright
@copyright{}
+2018 Alex address@hidden Copyright @copyright{} 2019 Miguel Ángel Arruga Vivas
+(traducción)@*
+
+Se garantiza el permiso de copia, distribución y/o modificación de este
+documento bajo los términos de la licencia de documentación libre de GNU
+(GNU Free Documentation License), versión 1.3 o cualquier versión posterior
+publicada por la Free Software Foundation; sin secciones invariantes, sin
+textos de cubierta delantera ni trasera. Una copia de la licencia está
+incluida en la sección titulada ``GNU Free Documentation License''.
address@hidden copying
+
address@hidden Administración del sistema
address@hidden
+* Guix: (guix.es). Gestión del software instalado y la
+ configuración del sistema.
+* guix package: (guix.es)Llamar a guix package. Instalación, borrado y
+ actualización de paquetes.
+* guix gc: (guix.es)Llamar a guix gc. Reclamar espacio de disco sin usar.
+* guix pull: (guix.es)Llamar a guix pull. Actualización de la lista
+ disponible de paquetes.
+* guix system: (guix.es)Llamar a guix system. Gestión de la configuración
+ del sistema operativo.
address@hidden direntry
+
address@hidden Desarrollo de software
address@hidden
+* guix environment: (guix.es)Llamar a guix environment. Construcción de
+ entornos de
+ desarrollo con
+ Guix.
+* guix build: (guix.es)Llamar a guix build. Construcción de paquetes.
+* guix pack: (guix.es)Llamar a guix pack. Creación de empaquetados
+ binarios.
address@hidden direntry
+
address@hidden
address@hidden Manual de referencia de GNU Guix
address@hidden Uso del gestor de paquetes funcional GNU Guix.
address@hidden Las desarrolladoras de GNU Guix
+
address@hidden
address@hidden 0pt plus 1filll
+Edición @value{EDITION} @* @value{UPDATED} @*
+
address@hidden
address@hidden titlepage
+
address@hidden
+
address@hidden
*********************************************************************
address@hidden Top
address@hidden GNU Guix
+
+Este documento describe GNU Guix versión @value{VERSION}, una herramienta
+funcional de gestión de paquetes escrita para el sistema GNU.
+
address@hidden TRANSLATORS: You can replace the following paragraph with
information on
address@hidden how to join your own translation team and how to report issues
with the
address@hidden translation.
+Este manual también está disponible en Inglés (@pxref{Top,,, guix, GNU Guix
+Reference Manual}), en Francés (@pxref{Top,,, guix.fr, Manuel de référence
+de GNU Guix}) y Alemán (@pxref{Top,,, guix.de, Referenzhandbuch zu GNU
+Guix}). Si quiere traducirlo a su lengua nativa, considere unirse a
address@hidden://translationproject.org/domain/guix-manual.html, Translation
+Project}.
+
address@hidden
+* Introducción:: ¿Qué es esto de Guix?
+* Instalación:: Instalar Guix.
+* Instalación del sistema:: Instalar el sistema operativo completo.
+* Gestión de paquetes:: Instalación de paquetes, actualización, etc.
+* Desarrollo:: Desarrollo de software asistido por Guix
+* Interfaz programática:: Uso de Guix en Scheme.
+* Utilidades:: Órdenes de gestión de paquetes.
+* Configuración del sistema:: Configurar el sistema operativo.
+* Documentación:: Navegar por los manuales de usuaria del
+ software.
+* Instalación de ficheros de depuración:: Alimentación del depurador.
+* Actualizaciones de seguridad:: Desplegar correcciones de seguridad
+ rápidamente.
+* Lanzamiento inicial:: GNU/Linux construido de cero.
+* Transportar:: Adaptación para otra plataforma o núcleo.
+* Contribuir:: ¡Se necesita su ayuda!
+
+* Reconocimientos:: ¡Gracias!
+* Licencia de documentación libre GNU:: La licencia de este manual.
+* Índice de conceptos:: Conceptos.
+* Índice programático:: Tipos de datos, funciones y variables.
+
address@hidden
+ --- La lista detallada de nodos ---
+
+
+
+Introducción
+
+
+
+* La forma de gestión de software de Guix:: Qué es especial.
+* Distribución GNU:: Los paquetes y herramientas.
+
+Instalación
+
+
+
+* Instalación binaria:: ¡Poner Guix en funcionamiento en nada de
+ tiempo!
+* Requisitos:: Software necesario para construir y ejecutar
+ Guix.
+* Ejecución de la batería de pruebas:: Probar Guix.
+* Preparación del daemon:: Preparar el entorno del daemon de
+ construcción.
+* Invocación de guix-daemon:: Ejecutar el daemon de construcción.
+* Configuración de la aplicación:: Configuración específica de la
+ aplicación.
+
+Preparación del daemon
+
+
+
+* Configuración del entorno de construcción:: Preparar el entorno aislado
+ de construcción.
+* Configuración de delegación del daemon:: Delegar construcciones a
+ máquinas remotas.
+* Soporte de SELinux:: Uso de una política SELinux para el daemon.
+
+Instalación del sistema
+
+
+
+* Limitaciones:: Qué puede esperar.
+* Consideraciones sobre el hardware:: Hardware soportado.
+* Instalación desde memoria USB y DVD:: Preparar el medio de instalación.
+* Preparación para la instalación:: Red, particionado, etc.
+* Instalación gráfica guiada:: Instalación gráfica fácil.
+* Instalación manual:: Instalación manual para artistas del teclado.
+* Tras la instalación del sistema:: Cuando la instalación ha finalizado
+ satisfactoriamente.
+* Instalación de Guix en una máquina virtual:: El patio de recreo del
+ sistema Guix.
+* Construcción de la imagen de instalación:: Cómo esto llega a ser.
+
+Instalación manual
+
+
+
+* Distribución de teclado y red y particionado:: Configuración inicial.
+* Procedimiento de instalación:: Instalación.
+
+Gestión de paquetes
+
+
+
+* Características:: Cómo Guix dará brillo a su vida.
+* Invocación de guix package:: Instalación de paquetes, borrado, etc.
+* Sustituciones:: Descargar binarios pre-construidos.
+* Paquetes con múltiples salidas:: Un único paquete de fuentes,
+ múltiples salidas.
+* Invocación de guix gc:: Ejecutar el recolector de basura.
+* Invocación de guix pull:: Obtener la última versión de Guix y la
+ distribución.
+* Canales:: Personalizar el recolector de basura.
+* Inferiores:: Interactuar con otra revisión de Guix.
+* Invocación de guix describe:: Muestra información acerca de su
+ revisión de Guix.
+* Invocación de guix archive:: Exportar e importar ficheros del almacén.
+
+Sustituciones
+
+
+
+* Servidor oficial de sustituciones.:: Una fuente particular de
+ sustituciones.
+* Autorización de servidores de sustituciones:: Cómo habilitar o
+ deshabilitar
+ sustituciones.
+* Verificación de sustituciones:: Cómo verifica las sustituciones Guix.
+* Configuración de la pasarela.:: Cómo obtener sustituciones a través de
+ una pasarela.
+* Fallos en las sustituciones:: Qué pasa cuando una sustitución falla.
+* Sobre la confianza en binarios:: ¿Cómo puede usted confiar en esa masa
+ informe de datos binarios?
+
+Desarrollo
+
+
+
+* Invocación de guix environment:: Configurar entornos de desarrollo.
+* Invocación de guix pack:: Creación de empaquetados de software.
+
+Interfaz programática
+
+
+
+* Módulos de paquetes:: Paquetes bajo el punto de vista del
+ programador.
+* Definición de paquetes:: Definir nuevos paquetes.
+* Sistemas de construcción:: Especificar como se construyen los paquetes.
+* El almacén:: Manipular el almacén de paquetes.
+* Derivaciones:: Interfaz de bajo nivel de las derivaciones de
+ los paquetes.
+* La mónada del almacén:: Interfaz puramente funcional del almacén.
+* Expresiones-G:: Manipular expresiones de construcción.
+* Invocación de guix repl:: Enredar con Guix interactivamente.
+
+Definición de paquetes
+
+
+
+* Referencia de ``package'':: El tipo de datos de los paquetes.
+* Referencia de ``origin'':: El tipo de datos de orígenes.
+
+Utilidades
+
+
+
+* Invocación de guix build:: Construir paquetes desde la línea de
+ órdenes.
+* Invocación de guix edit:: Editar las definiciones de paquetes.
+* Invocación de guix download:: Descargar un fichero e imprimir su hash.
+* Invocación de guix hash:: Calcular el hash criptográfico de un fichero.
+* Invocación de guix import:: Importar definiciones de paquetes.
+* Invocación de guix refresh:: Actualizar definiciones de paquetes.
+* Invocación de guix lint:: Encontrar errores en definiciones de paquetes.
+* Invocación de guix size:: Perfilar el uso del disco.
+* Invocación de guix graph:: Visualizar el grafo de paquetes.
+* Invocación de guix publish:: Compartir sustituciones.
+* Invocación de guix challenge:: Poner a prueba servidores de
+ sustituciones.
+* Invocación de guix copy:: Copiar a y desde un almacén remoto.
+* Invocación de guix container:: Aislamiento de procesos.
+* Invocación de guix weather:: Comprobar la disponibilidad de
+ sustituciones.
+* Invocación de guix processes:: Enumerar los procesos cliente.
+
+Invocación de @command{guix build}
+
+
+
+* Opciones comunes de construcción:: Opciones de construcción para la
+ mayoría de órdenes.
+* Opciones de transformación de paquetes:: Crear variantes de paquetes.
+* Opciones de construcción adicionales:: Opciones específicas de 'guix
+ build'.
+* Depuración de fallos de construcción:: Experiencia de empaquetamiento
+ en la vida real.
+
+Configuración del sistema
+
+
+
+* Uso de la configuración del sistema:: Personalizar su sistema GNU.
+* Referencia de ``operating-system'':: Detalle de las declaraciones de
+ sistema operativo.
+* Sistemas de ficheros:: Configurar el montaje de sistemas de ficheros.
+* Dispositivos traducidos:: Procesamiento extra de dispositivos de bloques.
+* Cuentas de usuaria:: Especificar las cuentas de usuaria.
+* Distribución de teclado:: Cómo interpreta el sistema las pulsaciones
+ del teclado.
+* Localizaciones:: Configuración de idioma y convenciones
+ culturales.
+* Servicios:: Especificar los servicios del sistema.
+* Programas con setuid:: Programas que se ejecutan con privilegios de
+ root.
+* Certificados X.509:: Verificar servidores HTTPS.
+* Selector de servicios de nombres:: Configurar el selector de servicios de
+ nombres de libc.
+* Disco en RAM inicial:: Arranque de Linux-Libre.
+* Configuración del gestor de arranque:: Configurar el gestor de arranque.
+* Invocación de guix system:: Instanciar una configuración del sistema.
+* Ejecutar Guix en una máquina virtual:: Cómo ejecutar el sistema Guix en
+ una máquina virtual.
+* Definición de servicios:: Añadir nuevas definiciones de servicios.
+
+Servicios
+
+
+
+* Servicios base:: Servicios esenciales del sistema.
+* Ejecución de tareas programadas:: El servicio mcron.
+* Rotación de logs:: El servicio rottlog.
+* Servicios de red:: Configuración de red, daemon SSH, etc.
+* Sistema X Window:: Interfaz gráfica.
+* Servicios de impresión:: Soporte de impresoras locales y remotas.
+* Servicios de escritorio:: D-Bus y servicios de escritorio.
+* Servicios de sonido:: Servicios de ALSA y Pulseaudio.
+* Servicios de bases de datos:: Bases de datos SQL, almacenes de
+ clave-valor, etc.
+* Servicios de correo:: IMAP, POP3, SMTP y todo eso.
+* Servicios de mensajería:: Servicios de mensajería.
+* Servicios de telefonía:: Servicios de telefonía.
+* Servicios de monitorización:: Servicios de monitorización.
+* Servicios Kerberos:: Servicios Kerberos.
+* Servicios Web:: Servidores Web.
+* Servicios de certificados:: Certificados TLS via Let's Encrypt.
+* Servicios DNS:: Demonios DNS.
+* Servicios VPN:: Demonios VPN.
+* Sistema de ficheros en red:: Servicios relacionados con NFS.
+* Integración continua:: El servicio Cuirass.
+* Servicios de gestión de energía:: Extender la vida de la batería.
+* Servicios de audio:: El MPD.
+* Servicios de virtualización:: Servicios de virtualización.
+* Servicios de control de versiones:: Proporcionar acceso remoto a
+ repositorios Git.
+* Servicios de juegos:: Servidores de juegos.
+* Servicios misceláneos:: Otros servicios.
+
+Definición de servicios
+
+
+
+* Composición de servicios:: El modelo para la composición de servicios.
+* Tipos de servicios y servicios:: Tipos y servicios
+* Referencia de servicios:: Referencia de la API.
+* Servicios de Shepherd:: Un tipo de servicio particular.
+
address@hidden detailmenu
address@hidden menu
+
address@hidden
*********************************************************************
address@hidden Introducción
address@hidden Introducción
+
address@hidden propósito
+GNU address@hidden'' se pronuncia tal y como se escribe en castellano,
+``gi:ks'' en el alfabeto fonético internacional (IPA).} es una herramienta
+de gestión de paquetes y una distribucion del sistema GNU. Guix facilita a
+usuarias sin privilegios la instalación, actualización o borrado de paquetes
+de software, la vuelta a un conjunto de paquetes previo atómicamente, la
+construcción de paquetes desde las fuentes, y ayuda de forma general en la
+creación y mantenimiento de entornos software.
+
address@hidden Sistema Guix
address@hidden GuixSD, ahora sistema Guix
address@hidden Distribución de Sistema Guix, ahora sistema Guix
+Puede instalar address@hidden sobre un sistema GNU/Linux existente, donde
+complementará las herramientas disponibles sin interferencias
+(@pxref{Instalación}), o puede usarse como un sistema operativo en sí
+mismo, el @address@hidden@footnote{Solíamos referirnos al sistema
+Guix como ``Distribución de sistema Guix'' o ``GuixSD''. Ahora consideramos
+que tiene más sentido agrupar todo bajo la etiqueta ``Guix'' ya que, después
+de todo, el sistema Guix está inmediatamente disponible a través de la orden
address@hidden system}, ¡incluso cuando usa una distribución distinta por
+debajo!}. @xref{Distribución GNU}.
+
address@hidden
+* La forma de gestión de software de Guix:: Qué es especial.
+* Distribución GNU:: Los paquetes y herramientas.
address@hidden menu
+
address@hidden La forma de gestión de software de Guix
address@hidden La forma de gestión de software de Guix
+
address@hidden interfaces de usuaria
+Guix proporciona una interfaz de gestión de paquetes de línea de ordenes
+(@pxref{Gestión de paquetes}), un conjunto de utilidades de línea de órdenes
+(@pxref{Utilidades}), así como interfaces programáticas Scheme
+(@pxref{Interfaz programática}).
address@hidden daemon de construcción
+Su @dfn{daemon de construcción} es responsable de la construcción de
+paquetes en delegación de las usuarias (@pxref{Preparación del daemon}) y de
+la descarga de binarios preconstruidos de fuentes autorizadas
+(@pxref{Sustituciones})
+
address@hidden extensibilidad de la distribución
address@hidden personalización, de paquetes
+Guix incluye definiciones de paquetes para muchos paquetes GNU y no-GNU,
+todos los cuales @uref{https://www.gnu.org/philosophy/free-sw.html, respetan
+la libertad de computación de la usuaria}. Es @emph{extensible}: las
+usuarias pueden escribir sus propias definiciones de paquetes
+(@pxref{Definición de paquetes}) y hacerlas disponibles como módulos
+independientes de paquetes (@pxref{Módulos de paquetes}). También es
address@hidden: las usuarias pueden @emph{derivar} definiciones de
+paquetes especializadas de las existentes, inclusive desde la línea de
+órdenes (@pxref{Opciones de transformación de paquetes}).
+
address@hidden gestión de paquetes funcional
address@hidden aislamiento
+En su implementación, Guix utiliza la disciplina de @dfn{gestión de paquetes
+funcional} en la que Nix fue pionero (@pxref{Reconocimientos}). En Guix, el
+proceso de construcción e instalación es visto como una @emph{función}, en
+el sentido matemático. Dicha función toma entradas, como los guiones de
+construcción, un compilador, unas bibliotecas y devuelve el paquete
+instalado. Como función pura, su resultado únicamente depende de sus
+entradas---por ejemplo, no puede hacer referencia a software o guiones que
+no fuesen pasados explícitamente como entrada. Una función de construcción
+siempre produce el mismo resultado cuando se le proporciona un conjunto de
+entradas dado. No puede modificar el entorno del sistema que la ejecuta de
+ninguna forma; por ejemplo, no puede crear, modificar o borrar archivos
+fuera de sus directorios de construcción e instalación. Esto se consigue
+ejecutando los procesos de construcción en entornos aislados (o
address@hidden), donde únicamente sus entradas explícitas son visibles.
+
address@hidden almacén
+El resultado de las funciones de construcción de paquetes es @dfn{almacenado
+en la caché} en el sistema de ficheros, en un directorio especial llamado
address@hidden almacén} (@pxref{El almacén}). Cada paquete se instala en un
+directorio propio en el almacén---por defecto, bajo @file{/gnu/store}. El
+nombre del directorio contiene el hash de todas las entradas usadas para
+construir el paquete; por tanto, cambiar una entrada resulta en un nombre de
+directorio distinto.
+
+Esta aproximación es el cimiento de las avanzadas características de Guix:
+capacidad para la actualización transaccional y vuelta-atrás de paquetes,
+instalación en el ámbito de la usuaria y recolección de basura de paquetes
+(@pxref{Características}).
+
+
address@hidden Distribución GNU
address@hidden Distribución GNU
+
address@hidden Sistema Guix
+Guix viene con una distribución del sistema GNU consistente en su totalidad
+de software address@hidden término ``libre'' aquí se refiere a la
address@hidden://www.gnu.org/philosophy/free-sw.html,libertad proporcionada a
las
+usuarias de dicho software}.}. La distribución puede instalarse
+independientemente (@pxref{Instalación del sistema}), pero también es posible
+instalar Guix como un gestor de paquetes sobre un sistema GNU/Linux
+existente (@pxref{Instalación}). Para distinguir entre las dos opciones,
+nos referimos a la distribución independiente como el address@hidden
+
+La distribución proporciona paquetes principales de GNU como GNU libc, GCC y
+Binutils, así como muchas aplicaciones GNU y no-GNU. La lista completa de
+paquetes disponibles puede navegarse
address@hidden://www.gnu.org/software/guix/packages,en línea} o ejecutando
address@hidden package} (@pxref{Invocación de guix package}):
+
address@hidden
+guix package --list-available
address@hidden example
+
+Nuestro objetivo es proporcionar una distribución práctica con 100% software
+libre basada en Linux y otras variantes de GNU, con un enfoque en la
+promoción y la alta integración de componentes GNU, y un énfasis en
+programas y herramientas que ayuden a las usuarias a ejercitar esa libertad.
+
+Actualmente hay paquetes disponibles para las siguientes plataformas:
+
address@hidden @code
+
address@hidden x86_64-linux
+arquitectura @code{x86_64} de Intel/AMD, núcleo Linux-Libre;
+
address@hidden i686-linux
+arquitectura de 32-bits Intel (IA32), núcleo Linux-Libre;
+
address@hidden armhf-linux
+arquitectura ARMv7-A con coma flotante hardware, Thumb-2 y NEON, usando la
+interfaz binaria de aplicaciones (ABI) EABI con coma flotante hardware, y el
+núcleo Linux-Libre.
+
address@hidden aarch64-linux
+procesadores de 64-bits ARMv8 little-endian, núcleo Linux-Libre. Está
+actualmente en una fase experimental, con soporte
+limitado. @xref{Contribuir}, para cómo ayudar.
+
address@hidden mips64el-linux
+procesadores MIPS 64-bits little-endian, específicamente las series
+Loongson, n32 ABI, y núcleo Linux-Libre.
+
address@hidden table
+
+Con el address@hidden, @emph{declara} todos los aspectos de la
+configuración del sistema y Guix se hace cargo de instanciar la
+configuración de manera transaccional, reproducible y sin estado global
+(@pxref{Configuración del sistema}). El sistema Guix usa el núcleo Linux-libre,
+el sistema de inicialización Shepherd (@pxref{Introducción,,, shepherd, The
+GNU Shepherd Manual}), las conocidas utilidades y herramientas de
+compilación GNU, así como el entorno gráfico o servicios del sistema de su
+elección.
+
+El sistema Guix está disponible en todas las plataformas previas excepto
address@hidden
+
address@hidden
+Para información sobre el transporte a otras arquitecturas o núcleos,
address@hidden
+
+La construcción de esta distribución es un esfuerzo cooperativo, ¡y esta
+invitada a unirse! @xref{Contribuir}, para información sobre cómo puede
+ayudar.
+
+
address@hidden
*********************************************************************
address@hidden Instalación
address@hidden Instalación
+
address@hidden instalar Guix
+
address@hidden Nota
+Recomendamos el uso de este @uref{https://git.savannah.gnu.org/cgit/guix.";
+"git/plain/etc/guix-install.sh, guión de shell de instalación} para instalar
+Guix sobre un sistema GNU/Linux en ejecución, de aquí en adelante referido
+como una @dfn{distribución address@hidden sección está dedicada a
+la instalación del gestor de paquetes, que puede realizarse sobre un sistema
+GNU/Linux ya en ejecución. Si, en vez de eso, desdea instalar el sistema
+operativo GNU completo, @pxref{Instalación del sistema}.} El guión automatiza
la
+descarga, instalación y configuración inicial de Guix. Debe ejecutarse como
+la usuaria de administración root.
address@hidden quotation
+
address@hidden distribución distinta
address@hidden directorios relacionados con una distribución distinta
+Cuando está instalado sobre una distribución distinta, address@hidden
+complementa las herramientas disponibles sin interferencias. Sus datos
+radican exclusivamente en dos directorios, normalmente @file{/gnu/store} y
address@hidden/var/guix}; otros ficheros en su sistema, como @file{/etc},
permanecen
+intactos.
+
+Una vez instalado, Guix puede ser actualizado ejecutando @command{guix pull}
+(@pxref{Invocación de guix pull}.
+
+Si prefiere realizar los pasos de instalación manualmente o desea
+personalizarlos, puede encontrar útiles las siguientes
+instrucciones. Describen los requisitos de software de Guix, así como su
+instalación manual y la preparación para su uso.
+
address@hidden
+* Instalación binaria:: ¡Poner Guix en funcionamiento en nada de
+ tiempo!
+* Requisitos:: Software necesario para construir y ejecutar
+ Guix.
+* Ejecución de la batería de pruebas:: Probar Guix.
+* Preparación del daemon:: Preparar el entorno del daemon de
+ construcción.
+* Invocación de guix-daemon:: Ejecutar el daemon de construcción.
+* Configuración de la aplicación:: Configuración específica de la
+ aplicación.
address@hidden menu
+
address@hidden Instalación binaria
address@hidden Instalación binaria
+
address@hidden instalar Guix desde binarios
address@hidden guión del instalador
+Esta sección describe cómo instalar Guix en un sistema arbitrario desde un
+archivador autocontenido que proporciona los binarios para Guix y todas sus
+dependencias. Esto es normalmente más rápido que una instalación desde las
+fuentes, la cual es descrita en las siguientes secciones. El único requisito
+es tener address@hidden y Xz.
+
+La instalación consiste más o menos en los siguientes pasos:
+
address@hidden
address@hidden
address@hidden descargar el binario de Guix
+Descargue el archivador con los binarios de
address@hidden://alpha.gnu.org/gnu/guix/address@hidden@var{sistema}.tar.xz},
+donde @var{sistema} es @code{x86_64-linux} para una máquina @code{x86_64}
+que ejecute el núcleo Linux, etcétera.
+
address@hidden The following is somewhat duplicated in ``System Installation''.
+Asegurese de descargar el fichero @file{.sig} asociado y de verificar la
+autenticidad del archivador con él, más o menos así:
+
address@hidden
+$ wget https://alpha.gnu.org/gnu/guix/address@hidden@var{sistema}.tar.xz.sig
+$ gpg --verify address@hidden@var{sistema}.tar.xz.sig
address@hidden example
+
+Si la orden falla porque no dispone de la clave pública necesaria, entonces
+ejecute esta otra orden para importarla:
+
address@hidden
+$ gpg --keyserver @value{KEY-SERVER} \
+ --recv-keys @value{OPENPGP-SIGNING-KEY-ID}
address@hidden example
+
address@hidden
address@hidden end authentication part
+y vuelva a ejecutar la orden @code{gpg --verify}.
+
address@hidden
+Ahora necesita convertirse en la usuaria @code{root}. Dependiendo de su
+distribución, puede que tenga que ejecutar @code{su -} o @code{sudo
+-i}. Como @code{root}, ejecute:
+
address@hidden
+# cd /tmp
+# tar --warning=no-timestamp -xf \
+ address@hidden@var{sistema}.tar.xz
+# mv var/guix /var/ && mv gnu /
address@hidden example
+
+Esto crea @file{/gnu/store} (@pxref{El almacén}) y @file{/var/guix}. El
+último contiene un perfil listo para usar para @code{root} (vea el siguiente
+paso).
+
address@hidden extraiga el archivador en un sistema Guix ya funcionando ya que
+sobreescribiría sus propios ficheros esenciales.
+
+La opción @code{--warning=no-timestamp} asegura que address@hidden no emite
+avisos sobre ``marcas de tiempo imposibles'' (dichos avisos eran emitidos
+por address@hidden 1.26 y anteriores; las versiones recientes están
+bien). Parten del hecho de que todos los ficheros en el archivador tienen su
+tiempo de modificación fijado a cero (que significa el 1 de enero de
+1970). Esto es hecho voluntariamente para asegurarse de que el contenido del
+archivador es independiente de su fecha de creación, haciendolo por tanto
+reproducible.
+
address@hidden
+Ponga disponible el perfil en @file{~root/.config/guix/current}, que es
+donde @command{guix pull} instalará las actualizaciones (@pxref{Invocación de
guix pull}):
+
address@hidden
+# mkdir -p ~root/.config/guix
+# ln -sf /var/guix/profiles/per-user/root/current-guix \
+ ~root/.config/guix/current
address@hidden example
+
+Cargue @file{etc/profile} para aumentar @code{PATH} y otras variables de
+entorno relevantes:
+
address@hidden
+# GUIX_PROFILE="`echo ~root`/.config/guix/current" ; \
+ source $GUIX_PROFILE/etc/profile
address@hidden example
+
address@hidden
+Cree el grupo y las cuentas de usuaria para las usuarias de construcción
+como se explica a continuación (@pxref{Configuración del entorno de
construcción}).
+
address@hidden
+Ejecute el daemon, y configurelo para iniciarse automáticamente al arranque.
+
+Si su distribución anfitriona usa el sistema de inicio systemd, puede
+conseguirlo con estas órdenes:
+
address@hidden Versions of systemd that supported symlinked service files are
not
address@hidden yet widely deployed, so we should suggest that users copy the
service
address@hidden files into place.
address@hidden
address@hidden See this thread for more information:
address@hidden
http://lists.gnu.org/archive/html/guix-devel/2017-01/msg01199.html
+
address@hidden
+# cp ~root/.config/guix/current/lib/systemd/system/guix-daemon.service \
+ /etc/systemd/system/
+# systemctl start guix-daemon && systemctl enable guix-daemon
address@hidden example
+
+Si su distribución anfitriona usa el sistema de inicio Upstart:
+
address@hidden
+# initctl reload-configuration
+# cp ~root/.config/guix/current/lib/upstart/system/guix-daemon.conf \
+ /etc/init/
+# start guix-daemon
address@hidden example
+
+En otro caso, todavía puede iniciar el daemon manualmente con:
+
address@hidden
+# ~root/.config/guix/current/bin/guix-daemon \
+ --build-users-group=guixbuild
address@hidden example
+
address@hidden
+Haga accesible la orden @command{guix} a otras usuarias de la máquina, por
+ejemplo con:
+
address@hidden
+# mkdir -p /usr/local/bin
+# cd /usr/local/bin
+# ln -s /var/guix/profiles/per-user/root/current-guix/bin/guix
address@hidden example
+
+Es también una buena idea poner disponible la versión Info de este manual
+ahí:
+
address@hidden
+# mkdir -p /usr/local/share/info
+# cd /usr/local/share/info
+# for i in /var/guix/profiles/per-user/root/current-guix/share/info/* ;
+ do ln -s $i ; done
address@hidden example
+
+De este modo, asumiendo que @file{/usr/local/share/info} está en la ruta de
+búsqueda, ejecutar @command{info guix.es} abrirá este manual (@pxref{Other
+Info Directories,,, texinfo, GNU Texinfo}, para más detalles sobre cómo
+cambiar la ruta de búsqueda de Info).
+
address@hidden
address@hidden sustituciones, autorización de las mismas
+Para usar sustituciones de @address@hidden o uno de sus
+espejos (@pxref{Sustituciones}), debe autorizarlas:
+
address@hidden
+# guix archive --authorize < \
+ ~root/.config/guix/current/share/guix/@value{SUBSTITUTE-SERVER}.pub
address@hidden example
+
address@hidden
+Cada usuaria puede necesitar dar algunos pasos adicionales para prepar su
+entorno de Guix para el uso, @pxref{Configuración de la aplicación}.
address@hidden enumerate
+
+Voilà, ¡la instalación está completa!
+
+Puede confirmar que Guix está funcionando instalando un paquete de ejemplo
+en su perfil de root:
+
address@hidden
+# guix package -i hello
address@hidden example
+
+El paquete @code{guix} debe permanecer disponible en el perfil de
address@hidden, o podría verse sujeto a la recolección de basura---en cuyo caso
+se encontraría seriamente lastrada por la falta de la orden
address@hidden En otras palabras, no borre @code{guix} ejecutando
address@hidden package -r guix}.
+
+El archivador de la instalación binaria puede ser (re)producido y verificado
+simplemente ejecutando la siguiente orden en el árbol de fuentes de Guix:
+
address@hidden
+make address@hidden
address@hidden example
+
address@hidden
+...@: que a su vez ejecuta:
+
address@hidden
+guix pack -s @var{sistema} --localstatedir \
+ --profile-name=current-guix guix
address@hidden example
+
address@hidden de guix pack}, para más información sobre esta útil herramienta.
+
address@hidden Requisitos
address@hidden Requisitos
+
+Esta sección enumera los requisitos para construir Guix desde las
+fuentes. El procedimiento de construcción de Guix es el mismo que el de otro
+software GNU, y no está cubierto aquí. Por favor, eche un vistazo a los
+ficheros @file{README} y @file{INSTALL} en el árbol de fuentes de Guix para
+obtener detalles adicionales.
+
address@hidden página web oficial
+GNU Guix está disponible para descarga desde su página web en
address@hidden://www.gnu.org/software/guix/}.
+
+GNU Guix depende de los siguientes paquetes:
+
address@hidden
address@hidden @url{http://gnu.org/software/guile/, GNU Guile}, versión 2.2.x;
address@hidden @url{https://notabug.org/cwebber/guile-gcrypt, Guile-Gcrypt},
versión
+0.1.0 o posterior;
address@hidden
address@hidden://gnutls.org/, GnuTLS}, específicamente su API Guile
+(@pxref{Guile Preparations, how to install the GnuTLS bindings for Guile,,
+gnutls-guile, GnuTLS-Guile});
address@hidden
address@hidden://notabug.org/guile-sqlite3/guile-sqlite3, Guile-SQLite3},
+versión 0.1.0 o posterior;
address@hidden
address@hidden FIXME: Specify a version number once a release has been made.
address@hidden://gitlab.com/guile-git/guile-git, Guile-Git}, de agosto de 2017
+o posterior;
address@hidden @uref{https://savannah.nongnu.org/projects/guile-json/,
Guile-JSON};
address@hidden @url{http://zlib.net, zlib};
address@hidden @url{http://www.gnu.org/software/make/, GNU Make}.
address@hidden itemize
+
+Las siguientes dependencias son opcionales:
+
address@hidden
address@hidden
address@hidden Note: We need at least 0.10.2 for 'channel-send-eof'.
+Las características de delegación de construcciones (@pxref{Configuración de
delegación del daemon}) y de @command{guix copy} (@pxref{Invocación de guix
copy}) dependen de
address@hidden://github.com/artyom-poptsov/guile-ssh, Guile-SSH}, versión
+0.10.2 o posterior.
+
address@hidden
+Cuando @url{http://www.bzip.org, libbz2} está disponible, @command{guix
+daemon} puede usarla para comprimir los log de construcción.
address@hidden itemize
+
+A menos que se pasase @code{--disable-daemon} a @command{configure}, los
+siguientes paquetes también son necesarios:
+
address@hidden
address@hidden @url{http://gnupg.org/, GNU libgcrypt};
address@hidden @url{http://sqlite.org, SQLite 3};
address@hidden @url{http://gcc.gnu.org, g++ de GCC} con soporte para el
+estándar C++11
address@hidden itemize
+
address@hidden directorio de estado
+Cuando se configura Guix en un sistema que ya tiene una instalación de Guix,
+asegurese de especificar el mismo directorio de estado que el de la
+instalación existente usando la opción @code{--localstatedir} al guión
address@hidden (@pxref{Directory Variables, @code{localstatedir},,
+standards, GNU Coding Standards}). El guión @command{configure} le proteje
+ante una mala configuración no deseada de @var{localstatedir} de modo que no
+pueda corromper inadvertidamente su almacén (@pxref{El almacén}).
+
address@hidden Nix, compatibilidad
+Cuando está disponible una instalación en funcionamiento del
address@hidden://nixos.org/nix/, gestor de paquetes Nix}, puede a su vez
+configurar Guix con @code{--disable-daemon}. En ese caso, Nix reemplaza las
+tres dependencias anteriores.
+
+Guix es compatible con Nix, así que es posible compartir el mismo almacén
+entre ambos. Para hacerlo debe pasar a @command{configure} no solo el mismo
+valor de @code{--with-store-dir}, sino también el mismo valor de
address@hidden El último es esencial debido a que especifica la
+base de datos donde se encuentran almacenados los metadatos del almacén,
+entre otras cosas. Los valores predeterminados para Nix son
address@hidden/nix/store} y @code{--localstatedir=/nix/var}. Fíjese
+que no se requiere @code{--disable-daemon} si su objetivo es compartir el
+almacén con Nix.
+
address@hidden Ejecución de la batería de pruebas
address@hidden Ejecución de la batería de pruebas
+
address@hidden batería de pruebas
+Después de una ejecución exitosa de @command{configure} y @code{make}, es
+una buena idea ejecutar la batería de pruebas. Puede ayudar a encontrar
+problemas con la configuración o el entorno, o errores en el mismo Guix---e
+informar de fallos en las pruebas es realmente una buena forma de ayudar a
+mejorar el software. Para ejecutar la batería de pruebas, teclee:
+
address@hidden
+make check
address@hidden example
+
+Los casos de prueba pueden ejecutarse en paralelo: puede usar la opción
address@hidden de address@hidden para acelerar las cosas. La primera ejecución
+puede tomar algunos minutos en una máquina reciente; las siguientes
+ejecuciones serán más rápidas puesto que el almacén creado para las pruebas
+ya tendrá varias cosas en la caché.
+
+Tambien es posible ejecutar un subconjunto de las pruebas definiendo la
+variable de makefile @code{TESTS} como en el ejemplo:
+
address@hidden
+make check TESTS="tests/store.scm tests/cpio.scm"
address@hidden example
+
+Por defecto, los resultados de las pruebas se muestran a nivel de
+fichero. Para ver los detalles de cada caso de prueba individual, es posible
+definir la variable de makefile @code{SCM_LOG_DRIVER_FLAGS} como en el
+ejemplo:
+
address@hidden
+make check TESTS="tests/base64.scm" SCM_LOG_DRIVER_FLAGS="--brief=no"
address@hidden example
+
+En caso de fallo, le rogamos que envíe un correo a @email{bug-guix@@gnu.org}
+y adjunte el fichero @file{test-suite.log}. Por favor, especifique la
+versión de Guix usada así como los números de versión de las dependencias
+(@pxref{Requisitos}) en su mensaje.
+
+Guix también viene como una batería de pruebas del sistema completo que
+prueban instancias completas del sistema Guix. Se puede ejecutar únicamente
+en sistemas donde Guix ya está instalado, usando:
+
address@hidden
+make check-system
address@hidden example
+
address@hidden
+o, de nuevo, definiendo @code{TESTS} para seleccionar un subconjunto de las
+pruebas a ejecutar:
+
address@hidden
+make check-system TESTS="basic mcron"
address@hidden example
+
+Estas pruebas de sistema están definidas en los módulos @code{(gnu tests
address@hidden)}. Funcionan ejecutando el sistema operativo con una
instrumentación
+ligera en una máquina virtual (VM). Pueden ser computacionalmente intensivas
+o bastante baratas, dependiendo de si hay sustituciones disponibles para sus
+dependencias (@pxref{Sustituciones}). Algunas requieren mucho espacio de
+almacenamiento para alojar las imágenes de la máquina virtual.
+
+De nuevo, en caso de fallos en las pruebas, le rogamos que envíe a
address@hidden@@gnu.org} todos los detalles.
+
address@hidden Preparación del daemon
address@hidden Preparación del daemon
+
address@hidden daemon
+Operaciones como la construcción de un paquete o la ejecución del recolector
+de basura son realizadas por un proceso especializado, el @dfn{daemon de
+construcción}, en delegación de sus clientes. Únicamente el daemon puede
+acceder al almacén y su base de datos asociada. Por tanto, cualquier
+operación que manipula el almacén se realiza a través del daemon. Por
+ejemplo, las herramientas de línea de órdenes como @command{guix package} y
address@hidden build} se comunican con el daemon (@i{via} llamadas a
+procedimientos remotos) para indicarle qué hacer.
+
+Las siguientes secciones explican cómo preparar el entorno del daemon de
+construcción. Véase tambien @ref{Sustituciones}, para información sobre cómo
+permitir al daemon descargar binarios pre-construidos.
+
address@hidden
+* Configuración del entorno de construcción:: Preparar el entorno aislado
+ de construcción.
+* Configuración de delegación del daemon:: Delegar construcciones a
+ máquinas remotas.
+* Soporte de SELinux:: Uso de una política SELinux para el daemon.
address@hidden menu
+
address@hidden Configuración del entorno de construcción
address@hidden Configuración del entorno de construcción
+
address@hidden entorno de construcción
+En una configuración multiusuaria estándar, Guix y su daemon---el programa
address@hidden instalados por la administradora del sistema;
address@hidden/gnu/store} pertenece a @code{root} y @command{guix-daemon} se
ejecuta
+como @code{root}. Usuarias sin privilegios pueden usar las herramientas de
+Guix para construir paquetes o acceder al almacén de otro modo, y el daemon
+lo hará en delegación suya, asegurando que el almacén permanece en un estado
+consistente, y permitiendo compartir entre usuarias los paquetes
+construidos.
+
address@hidden usuarias de construcción
+Mientras que @command{guix-daemon} se ejecuta como @code{root}, puede que no
+desee que los procesos de construcción de paquetes se ejecuten como
address@hidden también, por razones de seguridad obvias. Para evitarlo, una
+reserva especial de @dfn{usuarias de construcción} debe ser creada para ser
+usada por los procesos de construcción iniciados por el daemon. Estas
+usuarias de construcción no necesitan tener un shell ni un directorio home:
+simplemente serán usadas cuando el daemon se deshaga de los privilegios de
address@hidden en los procesos de construcción. Tener varias de dichas usuarias
+permite al daemon lanzar distintos procesos de construcción bajo UID
+separados, lo que garantiza que no interferirán entre ellos---una
+característica esencial ya que las construcciones se caracterizan como
+funciones puras (@pxref{Introducción}).
+
+En un sistema GNU/Linux, una reserva de usuarias de construcción puede ser
+creada así (usando la sintaxis de Bash y las órdenes de @code{shadow}):
+
address@hidden See
http://lists.gnu.org/archive/html/bug-guix/2013-01/msg00239.html
address@hidden for why `-G' is needed.
address@hidden
+# groupadd --system guixbuild
+# for i in `seq -w 1 10`;
+ do
+ useradd -g guixbuild -G guixbuild \
+ -d /var/empty -s `which nologin` \
+ -c "Usuaria de construcción Guix $i" --system \
+ guixbuilder$i;
+ done
address@hidden example
+
address@hidden
+El número de usuarias de construcción determina cuantos trabajos de
+construcción se pueden ejecutar en paralelo, especificado por la opción
address@hidden (@pxref{Invocación de guix-daemon,
address@hidden). Para usar @command{guix system vm} y las órdenes
+relacionadas, puede necesitar añadir las usuarias de construcción al grupo
address@hidden para que puedan acceder a @file{/dev/kvm}, usando @code{-G
+guixbuild,kvm} en vez de @code{-G guixbuild} (@pxref{Invocación de guix
system}).
+
+El programa @code{guix-daemon} puede ser ejecutado entonces como @code{root}
+con la siguiente address@hidden su máquina usa el sistema de inicio
+systemd, copiando el fichero
address@hidden@var{prefix}/lib/systemd/system/guix-daemon.service} en
address@hidden/etc/systemd/system} asegurará que @command{guix-daemon} se
arranca
+automáticamente. De igual modo, si su máquina usa el sistema de inicio
+Upstart, copie el fichero
address@hidden@var{prefix}/lib/upstart/system/guix-daemon.conf} en
address@hidden/etc/init}.}:
+
address@hidden
+# guix-daemon --build-users-group=guixbuild
address@hidden example
+
address@hidden chroot
address@hidden
+De este modo, el daemon inicia los procesos de construcción en un
+``chroot'', bajo una de las usuarias @code{guixbuilder}. En GNU/Linux, por
+defecto, el entorno ``chroot'' contiene únicamente:
+
address@hidden Keep this list in sync with libstore/build.cc!
-----------------------
address@hidden
address@hidden
+un directorio @code{/dev} mínimo, creado en su mayor parte
+independientemente del @code{/dev} del sistema address@hidden su
+mayor parte'', porque mientras el conjunto de ficheros que aparecen en
address@hidden/dev} es fijo, la mayor parte de estos ficheros solo pueden ser
+creados si el sistema anfitrión los tiene.}
+
address@hidden
+el directorio @code{/proc}; únicamente muestra los procesos del contenedor
+ya que se usa un espacio de nombres de PID separado.
+
address@hidden
address@hidden/etc/passwd} con una entrada para la usuaria actual y una entrada
para
+la usuaria @file{nobody};
+
address@hidden
address@hidden/etc/groups} con una entrada para el grupo de la usuaria;
+
address@hidden
address@hidden/etc/hosts} con una entrada que asocia @code{localhost} a
address@hidden;
+
address@hidden
+un directorio @file{/tmp} con permisos de escritura.
address@hidden itemize
+
+Puede influir en el directorio que el daemon utiliza para almacenar los
+árboles de construcción @i{via} la variable de entorno @code{TMPDIR}. No
+obstante, el árbol de construcción en el ``chroot'' siempre se llama
address@hidden/tmp/address@hidden, donde @var{nombre} es el nombre
+de la derivación---por ejemplo, @code{coreutils-8.24}. De este modo, el
+valor de @code{TMPDIR} no se escapa a los entornos de construcción, lo que
+evita discrepancias en caso de que los procesos de construcción capturen el
+nombre de su árbol de construcción.
+
address@hidden http_proxy
+El daemon también respeta la variable de entorno @code{http_proxy} para las
+descargas HTTP que realiza, sea para derivaciones de salida fija
+(@pxref{Derivaciones}) o para sustituciones (@pxref{Sustituciones}).
+
+Si está instalando Guix como una usuaria sin privilegios, es posible todavía
+ejecutar @command{guix-daemon} siempre que pase @code{--disable-chroot}. No
+obstante, los procesos de construcción no estarán aislados entre sí ni del
+resto del sistema. Por tanto, los procesos de construcción pueden interferir
+entre ellos y pueden acceder a programas, bibliotecas y otros ficheros
+disponibles en el sistema---haciendo mucho más difícil verlos como funciones
address@hidden
+
+
address@hidden Configuración de delegación del daemon
address@hidden Uso de la facilidad de descarga de trabajo
+
address@hidden delegando trabajo
address@hidden hook de construcción
+Cuando así se desee, el daemon de construcción puede @dfn{delegar}
+construcciones de derivación a otras máquinas ejecutando Guix, usando el
address@hidden de construcción} @address@hidden característica está
+únicamente disponible cuando
address@hidden://github.com/artyom-potsov/guile-ssh, Guile-SSH} está
+presente.}. Cuando dicha característica es activada, una lista de máquinas
+de construcción especificadas por la usuaria es leída de
address@hidden/etc/guix/machines.scm}; cada vez que se solicita una
construcción,
+por ejemplo via @code{guix build}, el daemon intenta delegarla a una de las
+máquinas que satisfaga las condiciones de la derivación, en particular su
+tipo de sistema---por ejemplo, @file{x86_64-linux}. Los prerrequisitos
+restantes para la construcción son copiados por SSH a la máquina objetivo,
+la cual procede con la construcción; con un resultado satisfactorio la(s)
+salida(s) de la construcción son copiadas de vuelta a la máquina inicial.
+
+El fichero @file{/etc/guix/machines.scm} normalmente tiene un contenido de
+este estilo:
+
address@hidden
+(list (build-machine
+ (name "ochentayseis.example.org")
+ (system "x86_64-linux")
+ (host-key "ssh-ed25519 address@hidden")
+ (user "rober")
+ (speed 2.)) ;¡increíblemente rápida!
+
+ (build-machine
+ (name "mimips.example.org")
+ (system "mips64el-linux")
+ (host-key "ssh-rsa address@hidden")
+ (user "alicia")
+ (private-key
+ (string-append (getenv "HOME")
+ "/.ssh/identidad-para-guix"))))
address@hidden example
+
address@hidden
+En el ejemplo anterior se especifica una lista de dos máquinas de
+construcción, una para la arquitectura @code{x86_64} y otra para la
+arquitectura @code{mips64el}.
+
+De hecho, este fichero es---¡sin sorpresa ninguna!---un fichero Scheme que
+se evalúa cuando el hook @code{offload} se inicia. El valor que devuelve
+debe ser una lista de objetos @code{build-machine}. Mientras que este
+ejemplo muestra una lista fija de máquinas de construcción, una puede
+imaginarse, digamos, el uso de DNS-SD para devolver una lista de máquinas de
+construcción potenciales descubierta en la red local (@pxref{Introducción,
+Guile-Avahi,, guile-avahi, Using Avahi in Guile Scheme Programs}). El tipo
+de datos @code{build-machine} se detalla a continuación.
+
address@hidden {Tipo de datos} build-machine
+Este tipo de datos representa las máquinas de construcción a las cuales el
+daemon puede delegar construcciones. Los campos importantes son:
+
address@hidden @code
+
address@hidden name
+El nombre de red de la máquina remota.
+
address@hidden system
+El sistema de la máquina remota---por ejemplo, @code{"x86_64-linux"}.
+
address@hidden user
+La cuenta de usuaria a usar cuando se conecte a la máquina remota por
+SSH. Tenga en cuenta que el par de claves SSH @emph{no} debe estar protegido
+por contraseña, para permitir ingresos al sistema no interactivos.
+
address@hidden host-key
+Este campo debe contener la @dfn{clave pública de la máquina} de SSH en
+formato OpenSSH. Es usado para autentificar la máquina cuando nos conectamos
+a ella. Es una cadena larga más o menos así:
+
address@hidden
+ssh-ed25519 address@hidden recordatorio@@example.org
address@hidden example
+
+Si la máquina está ejecutando el daemon OpenSSH, @command{sshd}, la clave
+pública de la máquina puede encontrarse en un fichero como
address@hidden/etc/ssh/ssh_host_ed25519_key.pub}.
+
+Si la máquina está ejecutando el daemon SSH address@hidden, @command{lshd}, la
+clave de la máquina está en @file{/etc/lsh/host-key.pub} o un fichero
+similar. Puede convertirse a formato OpenSSH usando @command{lsh-export-key}
+(@pxref{Converting keys,,, lsh, LSH Manual}):
+
address@hidden
+$ lsh-export-key --openssh < /etc/lsh/host-key.pub
+ssh-rsa address@hidden
address@hidden example
+
address@hidden table
+
+Ciertos número de campos opcionales pueden ser especificados:
+
address@hidden @asis
+
address@hidden @code{port} (predeterminado: @code{22})
+Número de puerto del servidor SSH en la máquina.
+
address@hidden @code{private-key} (predeterminada: @file{~root/.ssh/id_rsa})
+El fichero de clave privada SSH usado para conectarse a la máquina, en
+formato OpenSSH. Esta clave no debe estar protegida con una contraseña.
+
+Tenga en cuenta que el valor predeterminado es la clave privada @emph{de la
+cuenta de root}. Asegurese de que existe si usa el valor predeterminado.
+
address@hidden @code{compression} (predeterminado:
@code{"zlib@@openssh.com,zlib"})
address@hidden @code{compression-level} (predeterminado: @code{3})
+Los métodos de compresión y nivel de compresión a nivel SSH solicitados.
+
+Tenga en cuenta que la delegación de carga depende de la compresión SSH para
+reducir el ancho de banda usado cuando se transfieren ficheros hacia y desde
+máquinas de construcción.
+
address@hidden @code{daemon-socket} (predeterminado:
@code{"/var/guix/daemon-socket/socket"})
+Nombre de fichero del socket de dominio Unix en el que @command{guix-daemon}
+escucha en esa máquina.
+
address@hidden @code{parallel-builds} (predeterminadas: @code{1})
+El número de construcciones que pueden ejecutarse en paralelo en la máquina.
+
address@hidden @code{speed} (predeterminado: @code{1.0})
+Un ``factor de velocidad relativa''. El planificador de delegaciones tenderá
+a preferir máquinas con un factor de velocidad mayor.
+
address@hidden @code{features} (predeterminadas: @code{'()})
+Una lista de cadenas denotando las características específicas permitidas
+por la máquina. Un ejemplo es @code{"kvm"} para máquinas que tienen los
+módulos KVM de Linux y las correspondientes características hardware. Las
+derivaciones pueden solicitar las características por nombre, y entonces se
+planificarán en las máquinas adecuadas.
+
address@hidden table
address@hidden deftp
+
+El ejecutable @code{guix} debe estar en la ruta de búsqueda de las máquinas
+de construcción. Puede comprobar si es el caso ejecutando:
+
address@hidden
+ssh build-machine guix repl --version
address@hidden example
+
+Hay una última cosa por hacer una vez @file{machines.scm} está en su
+lugar. Como se ha explicado anteriormente, cuando se delega, los ficheros se
+transfieren en ambas direcciones entre los almacenes de las máquinas. Para
+que esto funcione, primero debe generar un par de claves en cada máquina
+para permitir al daemon exportar los archivos firmados de ficheros en el
+almacén (@pxref{Invocación de guix archive}):
+
address@hidden
+# guix archive --generate-key
address@hidden example
+
address@hidden
+Cada máquina de construcción debe autorizar a la clave de la máquina maestra
+para que acepte elementos del almacén que reciba de la maestra:
+
address@hidden
+# guix archive --authorize < clave-publica-maestra.txt
address@hidden example
+
address@hidden
+Del mismo podo, la máquina maestra debe autorizar la clave de cada máquina
+de construcción.
+
+Todo este lío con claves está ahí para expresar las mutuas relaciones de
+confianza entre pares de la máquina maestra y las máquinas de
+construcción. Concretamente, cuando la maestra recibe ficheros de una
+máquina de construcción (y @i{vice versa}), su daemon de construcción puede
+asegurarse de que son genuinos, no han sido modificados, y que están
+firmados por una clave autorizada.
+
address@hidden prueba de delegación
+Para comprobar si su configuración es operacional, ejecute esta orden en el
+nodo maestro:
+
address@hidden
+# guix offload test
address@hidden example
+
+Esto intentará conectar con cada una de las máquinas de construcción
+especificadas en @file{/etc/guix/machines.scm}, comprobará que GUile y los
+módulos Guix están disponibles en cada máquina, intentará exportar a la
+máquina e importar de ella, e informará de cualquier error en el proceso.
+
+Si quiere probar un fichero de máquinas diferente, simplemente especifiquelo
+en la línea de órdenes:
+
address@hidden
+# guix offload test otras-maquinas.scm
address@hidden example
+
+Por último, puede probar un subconjunto de máquinas cuyos nombres coincidan
+con una expresión regular así:
+
address@hidden
+# guix offload test maquinas.scm '\.gnu\.org$'
address@hidden example
+
address@hidden estado de delegación
+Para mostrar la carga actual de todas las máquinas de construcción, ejecute
+esta orden en el nodo principal:
+
address@hidden
+# guix offload status
address@hidden example
+
+
address@hidden Soporte de SELinux
address@hidden Soporte de SELinux
+
address@hidden SELinux, política del daemon
address@hidden control de acceso mandatorio, SELinux
address@hidden seguridad, guix-daemon
+Guix incluye un fichero de política SELinux en @file{etc/guix-daemon.cil}
+que puede ser instalado en un sistema donde SELinux está activado, para
+etiquetar los ficheros Guix y especificar el comportamiento esperado del
+daemon. Ya que el sistema Guix no proporciona una política base de SELinux,
+la política del daemon no puede usarse en el sistema Guix.
+
address@hidden Instalación de la política de SELinux
address@hidden SELinux, instalación de la política
+Para instalar la política ejecute esta orden como root:
+
address@hidden
+semodule -i etc/guix-daemon.cil
address@hidden example
+
+Una vez hecho, vuelva a etiquetar el sistema de ficheros con
address@hidden o con un mecanismo distinto que proporcione su sistema.
+
+Una vez la política está instalada, el sistema de ficheros ha sido
+re-etiquetado, y el daemon ha sido reiniciado, debería ejecutarse en el
+contexto @code{guix_daemon_t}. Puede confirmarlo con la siguiente orden:
+
address@hidden
+ps -Zax | grep guix-daemon
address@hidden example
+
+Monitorice los ficheros de log de SELinux mientras ejecuta una orden como
address@hidden build hello} para convencerse que SELinux permite todas las
+operaciones necesarias.
+
address@hidden Limitaciones
address@hidden SELinux, limitaciones
+
+Esta política no es perfecta. Aquí está una lista de limitaciones o
+comportamientos extraños que deben ser considerados al desplegar la política
+SELinux provista para el daemon Guix.
+
address@hidden
address@hidden
address@hidden no se usa realmente. Ninguna de las operaciones
+del socket implica contextos que tengan algo que ver con
address@hidden No hace daño tener esta etiqueta sin usar, pero
+sería preferible definir reglas del socket únicamente para esta etiqueta.
+
address@hidden
address@hidden gc} no puede acceder enlaces arbitrarios a los perfiles. Por
+diseño, la etiqueta del fichero del destino de un enlace simbólico es
+independiente de la etiqueta de fichero del fichero en sí. Aunque todos los
+perfiles bajo $localstatedir se etiquetan, los enlaces para estos perfiles
+heredan la etiqueta del directorio en el que están. Para enlaces en el
+directorio de la usuaria esto será @code{user_home_t}. Pero para los enlaces
+del directorio de root, o @file{/tmp}, o del directorio del servidor HTTP,
+etc., esto no funcionará. @code{guix gc} se verá incapacitado para leer y
+seguir dichos enlaces.
+
address@hidden
+La característica del daemon de esperar conexiones TCP puede que no funcione
+más. Esto puede requerir reglas extra, ya que SELinux trata los sockets de
+red de forma diferente a los ficheros.
+
address@hidden
+Actualmente todos los ficheros con un nombre coincidente con la expresión
+regular @code{/gnu/store.+-(gux-.+|profile)/bin/guix-daemon} tienen asignada
+la etiqueta @code{guix_daemon_exec_t}; esto significa que @emph{cualquier}
+fichero con ese nombre en cualquier perfil tendrá permitida la ejecución en
+el dominio @code{guix_daemon_t}. Esto no es ideal. Una atacante podría
+construir un paquete que proporcione este ejecutable y convencer a la
+usuaria para instalarlo y ejecutarlo, lo que lo eleva al dominio
address@hidden Llegadas a este punto, SELinux no puede prevenir que
+acceda a los ficheros permitidos para los procesos en dicho dominio.
+
+Podríamos generar una política mucho más restrictiva en tiempo de
+instalación, de modo que solo el nombre @emph{exacto} del fichero del
+ejecutable de @code{guix-daemon} actualmente instalado sea marcado como
address@hidden, en vez de usar una expresión regular amplia. La
+desventaja es que root tendría que instalar o actualizar la política en
+tiempo de instalación cada vez que se actualizase el paquete de Guix que
+proporcione el ejecutable de @code{guix-daemon} realmente en ejecución.
address@hidden enumerate
+
address@hidden Invocación de guix-daemon
address@hidden Invocación de @command{guix-daemon}
+
+El programa @command{guix-daemon} implementa toda la funcionalidad para
+acceder al almacén. Esto incluye iniciar procesos de construcción, ejecutar
+el recolector de basura, comprobar la disponibilidad de un resultado de
+construcción, etc. Normalmente se ejecuta como @code{root} así:
+
address@hidden
+# guix-daemon --build-users-group=guixbuild
address@hidden example
+
address@hidden
+Para detalles obre como configurarlo, @pxref{Preparación del daemon}.
+
address@hidden chroot
address@hidden contenedor, entorno de construcción
address@hidden entorno de construcción
address@hidden construcciones reproducibles
+Por defecto, @command{guix-daemon} inicia los procesos de construcción bajo
+distintos UIDs, tomados del grupo de construcción especificado con
address@hidden Además, cada proceso de construcción se ejecuta
+en un entorno ``chroot'' que únicamente contiene el subconjunto del almacén
+del que depende el proceso de construcción, como especifica su derivación
+(@pxref{Interfaz programática, derivación}), más un conjunto específico de
+directorios del sistema. Por defecto, estos directorios contienen
address@hidden/dev} y @file{/dev/pts}. Es más, sobre GNU/Linux, el entorno de
+construcción es un @dfn{contenedor}: además de tener su propio árbol del
+sistema de ficheros, tiene un espacio de nombres de montado separado, su
+propio espacio de nombres de PID, de red, etc. Esto ayuda a obtener
+construcciones reproducibles (@pxref{Características}).
+
+Cuando el daemon realiza una construcción en delegación de la usuaria, crea
+un directorio de construcción bajo @file{/tmp} o bajo el directorio
+especificado por su variable de entorno @code{TMPDIR}. Este directorio se
+comparte con el contenedor durante toda la construcción, aunque dentro del
+contenedor el árbol de construcción siempre se llama
address@hidden/tmp/address@hidden
+
+El directorio de construcción se borra automáticamente una vez completado el
+proceso, a menos que la construcción fallase y se especificase en el cliente
address@hidden (@pxref{Invocación de guix build,
address@hidden).
+
+El daemon espera conexiones y lanza un subproceso por sesión iniciada por
+cada cliente (una de las sub-órdenes de @command{guix}). La orden
address@hidden processes} le permite tener una visión general de la actividad
+de su sistema mostrando clientes y sesiones activas. @xref{Invocación de guix
processes}, para más información.
+
+Se aceptan las siguientes opciones de línea de ordenes:
+
address@hidden @code
address@hidden address@hidden
+Toma las usuarias de @var{grupo} para ejecutar los procesos de construcción
+(@pxref{Preparación del daemon, build users}).
+
address@hidden --no-substitutes
address@hidden sustituciones
+No usa sustituciones para la construcción de productos. Esto es, siempre
+realiza las construcciones localmente en vez de permitir la descarga de
+binarios pre-construidos (@pxref{Sustituciones}).
+
+Cuando el daemon se ejecuta con @code{--no-substitutes}, los clientes aún
+pueden activar explícitamente las sustituciones @i{via} la llamada de
+procedimiento remoto @code{set-build-options} (@pxref{El almacén}).
+
address@hidden address@hidden
address@hidden
+Considera @var{urls} la lista separada por espacios predeterminada de URLs
+de sustituciones de fuentes. Cuando se omite esta opción, se usa
address@hidden://@value{SUBSTITUTE-SERVER}}.
+
+Esto significa que las sustituciones puede ser descargadas de @var{urls},
+mientras estén firmadas por una firma de confianza (@pxref{Sustituciones}).
+
address@hidden hook de construcción
address@hidden --no-build-hook
+No usa el @dfn{hook de construcción}.
+
+El hook de construcción es un programa auxiliar que el daemon puede lanzar y
+al cual envía las peticiones de construcción. Este mecanismo se utiliza para
+delegar construcciones a otras máquinas (@pxref{Configuración de delegación
del daemon}).
+
address@hidden --cache-failures
+Almacena en la caché los fallos de construcción. Por defecto, únicamente las
+construcciones satisfactorias son almacenadas en la caché.
+
+Cuando se usa esta opción, @command{guix gc --list-failures} puede usarse
+para consultar el conjunto de elementos del almacén marcados como fallidos;
address@hidden gc --clear-failures} borra los elementos del almacén del
+conjunto de fallos existentes en la caché. @xref{Invocación de guix gc}.
+
address@hidden address@hidden
address@hidden -c @var{n}
+Usa @var{n} núcleos de la CPU para construir cada derivación; @code{0}
+significa tantos como haya disponibles.
+
+El valor predeterminado es @code{0}, pero puede ser sobreescrito por los
+clientes, como la opción @code{--cores} de @command{guix build}
+(@pxref{Invocación de guix build}).
+
+El efecto es definir la variable de entorno @code{NIX_BUILD_CORES} en el
+proceso de construcción, el cual puede usarla para explotar el paralelismo
+interno---por ejemplo, ejecutando @code{make -j$NIX_BUILD_CORES}.
+
address@hidden address@hidden
address@hidden -M @var{n}
+Permite como máximo @var{n} trabajos de construcción en paralelo. El valor
+predeterminado es @code{1}. Fijarlo a @code{0} significa que ninguna
+construcción se realizará localmente; en vez de eso, el daemon delegará las
+construcciones (@pxref{Configuración de delegación del daemon}), o simplemente
fallará.
+
address@hidden address@hidden
+Cuando la construcción o sustitución permanece en silencio más de
address@hidden, la finaliza e informa de un fallo de construcción.
+
+El valor predeterminado es @code{0}, que deshabilita el plazo.
+
+El valor especificado aquí puede ser sobreescrito por clientes
+(@pxref{Opciones comunes de construcción, @code{--max-silent-time}}).
+
address@hidden address@hidden
+Del mismo modo, cuando el proceso de construcción o sustitución dura más de
address@hidden, lo termina e informa un fallo de construcción.
+
+El valor predeterminado es @code{0}, que deshabilita el plazo.
+
+El valor especificado aquí puede ser sobreescrito por los clientes
+(@pxref{Opciones comunes de construcción, @code{--timeout}}).
+
address@hidden address@hidden
+Construye cada derivación @var{n} veces seguidas, y lanza un error si los
+resultados de las construcciones consecutivas no son idénticos
+bit-a-bit. Fíjese que esta configuración puede ser sobreescrita por clientes
+como @command{guix build} (@pxref{Invocación de guix build}).
+
+Cuando se usa conjuntamente con @option{--keep-failed}, la salida que
+difiere se mantiene en el almacén, bajo
address@hidden/gnu/store/@dots{}-check}. Esto hace fácil buscar diferencias
entre
+los dos resultados.
+
address@hidden --debug
+Produce salida de depuración.
+
+Esto es útil para depurar problemas en el arranque del daemon, pero entonces
+puede ser cambiado el comportamiento por los clientes, por ejemplo la opción
address@hidden de @command{guix build} (@pxref{Invocación de guix build}).
+
address@hidden address@hidden
+Añade @var{dir} al chroot de construcción.
+
+Hacer esto puede cambiar el resultado del proceso de construcción---por
+ejemplo si usa dependencias opcionales, que se encuentren en @var{dir},
+cuando están disponibles, y no de otra forma. Por esa razón, no se
+recomienda hacerlo. En vez de eso, asegurese que cada derivación declara
+todas las entradas que necesita.
+
address@hidden --disable-chroot
+Deshabilita las construcciones en un chroot.
+
+No se recomienda el uso de esta opción ya que, de nuevo, podría permitir a
+los procesos de construcción ganar acceso a dependencias no declaradas. Es
+necesario, no obstante, cuando @command{guix-daemon} se ejecuta bajo una
+cuenta de usuaria sin privilegios.
+
address@hidden address@hidden
+Comprime los logs de construcción de acuerdo a @var{tipo}, que puede ser
address@hidden, @code{bzip2} o @code{none}.
+
+A menos que se use @code{--lose-logs}, todos los log de construcción se
+mantienen en @var{localstatedir}. Para ahorrar espacio, el daemon
+automáticamente los comprime con bzip2 por defecto.
+
address@hidden --disable-deduplication
address@hidden deduplicación
+Deshabilita la ``deduplicación'' automática en el almacén.
+
+Por defecto, los ficheros se añaden al almacén ``deduplicados''
+automáticamente: si un nuevo fichero añadido es idéntico a otro que ya se
+encuentra en el almacén, el daemon introduce el nuevo fichero como un enlace
+duro al otro fichero. Esto puede reducir notablemente el uso del disco, a
+expensas de una carga de entrada/salida ligeramente incrementada al
+finalizar un proceso de construcción. Esta opción deshabilita esta
+optimización.
+
address@hidden --gc-keep-outputs[=yes|no]
+Determina si el recolector de basura (GC) debe mantener salidas de las
+derivaciones vias.
+
address@hidden GC, raíces del recolector de basura
address@hidden raíces del recolector de basura
+Cuando se usa ``yes'', el recolector de basura mantendrá las salidas de
+cualquier derivación viva disponible en el almacén---los ficheros
address@hidden El valor predeterminado es ``no'', lo que significa que las
+salidas de las derivaciones se mantienen únicamente si son alcanzables desde
+alguna raíz del recolector de basura. @xref{Invocación de guix gc}, para más
+información sobre las raices del recolector de basura.
+
address@hidden --gc-keep-derivations[=yes|no]
+Determina si el recolector de basura (GC) debe mantener derivaciones
+correspondientes a salidas vivas.
+
+Cuando se usa ``yes'', como es el caso predeterminado, el recolector de
+basura mantiene derivaciones---es decir, ficheros @code{.drv}---mientras al
+menos una de sus salidas está viva. Esto permite a las usuarias seguir la
+pista de los orígenes de los elementos en el almacén. El uso de ``no'' aquí
+ahorra un poco de espacio en disco.
+
+De este modo, usar @code{--gc-keep-derivations} con valor ``yes'' provoca
+que la vitalidad fluya de salidas a derivaciones, y usar
address@hidden con valor ``yes'' provoca que la vitalidad fluya de
+derivaciones a salidas. Cuando ambas tienen valor ``yes'', el efecto es
+mantener todos los prerrequisitos de construcción (las fuentes, el
+compilador, las bibliotecas y otras herramientas de tiempo de construcción)
+de los objetos vivos del almacén, independientemente de que esos
+prerrequisitos sean alcanzables desde una raíz del recolector de
+basura. Esto es conveniente para desarrolladoras ya que ahorra
+reconstrucciones o descargas.
+
address@hidden --impersonate-linux-2.6
+En sistemas basados en Linux, suplanta a Linux 2.6. Esto significa que la
+llamada del sistema @code{uname} del kernel indicará 2.6 como el número de
+publicación.
+
+Esto puede ser útil para construir programas que (habitualmente de forma
+incorrecta) dependen en el número de versión del núcleo.
+
address@hidden --lose-logs
+No guarda logs de construcción. Por defecto se almacenan bajo
address@hidden@var{localstatedir}/guix/log}.
+
address@hidden address@hidden
+Asume @var{sistema} como el tipo actual de sistema. Por defecto es el par de
+arquitectura/núcleo encontrado durante la configuración, como
address@hidden
+
address@hidden address@hidden
+Escucha conexiones en @var{destino}. @var{destino} se interpreta como el
+nombre del fichero del socket de dominio Unix si comienza on @code{/} (barra
+a la derecha). En otro caso, @var{destino} se interpreta como un nombre de
+máquina o un nombre de máquina y puerto a escuchar. Aquí van unos pocos
+ejemplos:
+
address@hidden @code
address@hidden --listen=/gnu/var/daemon
+Escucha por conexiones en el socket de dominio Unix @file{/gnu/var/daemon},
+creandolo si es necesario.
+
address@hidden --listen=localhost
address@hidden daemon, acceso remoto
address@hidden acceso remoto al daemon
address@hidden daemon, configuración en cluster
address@hidden daemon, configuración en cluster
+Escucha conexiones TCP en la interfaz de red correspondiente a
address@hidden, en el puerto 44146.
+
address@hidden --listen=128.0.0.42:1234
+Escucha conexiones TCP en la interfaz de red correspondiente a
address@hidden, en el puerto 1234.
address@hidden table
+
+Esta opción puede repetirse múltiples veces, en cuyo caso
address@hidden acepta conexiones en todos los destinos
+especificados. Las usuarias pueden indicar a los clientes a qué destino
+conectarse fijando la variable de entorno @code{GUIX_DAEMON_SOCKET}
+(@pxref{El almacén, @code{GUIX_DAEMON_SOCKET}}).
+
address@hidden Nota
+El protocolo del daemon @code{no está autentificado ni cifrado}. El uso de
address@hidden@var{dirección}} es aceptable en redes locales, como
+clusters, donde únicamente los nodos de confianza pueden conectarse al
+daemon de construcción. En otros casos donde el acceso remoto al daemon es
+necesario, recomendamos usar sockets de dominio Unix junto a SSH.
address@hidden quotation
+
+Cuando se omite @code{--listen}, @command{guix-daemon} escucha conexiones en
+el socket de dominio Unix que se encuentra en
address@hidden@var{localstatedir}/guix/daemon-socket/socket}.
address@hidden table
+
+
address@hidden Configuración de la aplicación
address@hidden Configuración de la aplicación
+
address@hidden distribución distinta
+Cuando se usa Guix sobre una distribución GNU/Linux distinta al sistema
+Guix---una @dfn{distribución distinta}---unos pocos pasos adicionales son
+necesarios para tener todo preparado. Aquí están algunos de ellos.
+
address@hidden Localizaciones
+
address@hidden
address@hidden localizaciones, cuando no se está en el sistema Guix
address@hidden LOCPATH
address@hidden GUIX_LOCPATH
+Los paquetes instalados @i{via} Guix no usarán los datos de localización del
+sistema anfitrión. En vez de eso, debe primero instalar uno de los paquetes
+de localización disponibles con Guix y después definir la variable de
+entorno @code{GUIX_LOCPATH}:
+
address@hidden
+$ guix package -i glibc-locales
+$ export GUIX_LOCPATH=$HOME/.guix-profile/lib/locale
address@hidden example
+
+Fíjese que el paquete @code{glibc-locales} contiene datos para todas las
+localizaciones que ofrece address@hidden y pesa alrededor de
address@hidden Alternativamente, @code{glibc-utf8-locales} es más pequeño
+pero limitado a localizaciones UTF-8.
+
+La variable @code{GUIX_LOCPATH} juega un rol similar a @code{LOCPATH}
+(@pxref{Locale Names, @code{LOCPATH},, libc, The GNU C Library Reference
+Manual}). No obstante, hay dos diferencias importantes:
+
address@hidden
address@hidden
address@hidden es respetada únicamente por la libc dentro de Guix, y no
+por la libc que proporcionan las distribuciones distintas. Por tanto, usar
address@hidden le permite asegurarse de que los programas de la
+distribución distinta no cargarán datos de localización incompatibles.
+
address@hidden
+libc añade un sufijo a cada entrada de @code{GUIX_LOCPATH} con @code{/X.Y},
+donde @code{X.Y} es la versión de libc---por ejemplo, @code{2.22}. Esto
+significa que, en caso que su perfil Guix contenga una mezcla de programas
+enlazados contra diferentes versiones de libc, cada versión de libc
+únicamente intentará cargar datos de localización en el formato correcto.
address@hidden enumerate
+
+Esto es importante porque el formato de datos de localización usado por
+diferentes versiones de libc puede ser incompatible.
+
address@hidden Selector de servicios de nombres
+
address@hidden selector de servicios de nombres, glibc
address@hidden NSS (selector de servicios de nombres), glibc
address@hidden ncsd (daemon de caché del servicio de nombres)
address@hidden daemon de caché del servicio de nombres (ncsd)
+Cuando se usa Guix en una distribución distinta, @emph{recomendamos
+encarecidamente} que el sistema ejecute el @dfn{daemon de caché del servicio
+de nombres} de la biblioteca de C de GNU, @command{ncsd}, que debe escuchar
+en el socket @file{/var/run/nscd/socket}. En caso de no hacerlo, las
+aplicaciones instaladas con Guix pueden fallar al buscar nombres de máquinas
+o cuentas de usuaria, o incluso pueden terminar abruptamente. Los siguientes
+párrafos explican por qué.
+
address@hidden @file{nsswitch.conf}
+La biblioteca de C de GNU implementa un @dfn{selector de servicios de
+nombres} (NSS), que es un mecanismo extensible para ``búsquedas de nombres''
+en general: resolución de nombres de máquinas, cuentas de usuaria y más
+(@pxref{Selector de servicios de nombres,,, libc, The GNU C Library Reference
Manual}).
+
address@hidden Servicio de información de red (NIS)
address@hidden NIS (servicio de información de red)
+Al ser extensible, NSS permite el uso de @dfn{módulos}, los cuales
+proporcionan nuevas implementaciones de búsqueda de nombres: por ejemplo, el
+módulo @code{nss-mdns} permite la resolución de nombres de máquina
address@hidden, el módulo @code{nis} permite la búsqueda de cuentas de
+usuaria usando el servicio de información de red (NIS), etc. Estos
+``servicios de búsqueda'' extra se configuran para todo el sistema en
address@hidden/etc/nsswitch.conf}, y todos los programas en ejecución respetan
esta
+configuración (@pxref{NSS Configuration File,,, libc, The GNU C Reference
+Manual}).
+
+Cuando se realiza una búsqueda de nombres---por ejemplo, llamando a la
+función @code{getaddrinfo} en C---las aplicaciones primero intentarán
+conectar con nscd; en caso satisfactorio, nscd realiza la búsqueda de
+nombres en delegación suya. Si nscd no está ejecutándose, entonces realizan
+la búsqueda por ellas mismas, cargando los servicios de búsqueda de nombres
+en su propio espacio de direcciones y ejecutándola. Estos servicios de
+búsqueda de nombres---los ficheros @file{libnss_*.so}---son abiertos con
address@hidden, pero pueden venir de la biblioteca de C del sistema, en vez
+de la biblioteca de C contra la que la aplicación está enlazada (la
+biblioteca de C que viene en Guix).
+
+Y aquí es donde está el problema: si su aplicación está enlazada contra la
+biblioteca de C de Guix (digamos, glibc 2.24) e intenta cargar módulos de
+otra biblioteca de C (digamos, @code{libnss_mdns.so} para glibc 2.22),
+probablemente terminará abruptamente o sus búsquedas de nombres fallarán
+inesperadamente.
+
+Ejecutar @command{nscd} en el sistema, entre otras ventajas, elimina este
+problema de incompatibilidad binaria porque esos ficheros @code{libnss_*.so}
+se cargan en el proceso @command{nscd}, no en la aplicación misma.
+
address@hidden Tipografías X11
+
address@hidden tipografías
+La mayoría de aplicaciones gráficas usan Fontconfig para encontrar y cargar
+tipografías y realizar la renderización del lado del cliente X11. El paquete
address@hidden en Guix busca tipografías en @file{$HOME/.guix-profile}
+por defecto. Por tanto, para permitir a aplicaciones gráficas instaladas con
+Guix mostrar tipografías, tiene que instalar las tipografías también con
+Guix. Paquetes esenciales de tipografías incluyen @code{gs-fonts},
address@hidden y @code{font-gnu-freefont-ttf}.
+
+Para mostrar texto escrito en lenguas chinas, Japonés o Coreano en
+aplicaciones gráficas, considere instalar @code{font-adobe-source-han-sans}
+o @code{font-wqy-zenhei}. La anterior tiene múltiples salidas, una por
+familia de lengua (@pxref{Paquetes con múltiples salidas}). Por ejemplo, la
+siguiente orden instala tipografías para lenguas chinas:
+
address@hidden
+guix package -i font-adobe-source-han-sans:cn
address@hidden example
+
address@hidden @code{xterm}
+Programas más antiguos como @command{xterm} no usan Fontconfig sino que
+dependen en el lado del servidor para realizar el renderizado de
+tipografías. Dichos programas requieren especificar un nombre completo de
+tipografía usando XLFD (Descripción lógica de tipografías X), como esta:
+
address@hidden
+-*-dejavu sans-medium-r-normal-*-*-100-*-*-*-*-*-1
address@hidden example
+
+Para ser capaz de usar estos nombres completos para las tipografías TrueType
+instaladas en su perfil Guix, necesita extender la ruta de fuentes del
+servidor X:
+
address@hidden Note: 'xset' does not accept symlinks so the trick below
arranges to
address@hidden get at the real directory. See <https://bugs.gnu.org/30655>.
address@hidden
+xset +fp $(dirname $(readlink -f
~/.guix-profile/share/fonts/truetype/fonts.dir))
address@hidden example
+
address@hidden @code{xlsfonts}
+Después de eso, puede ejecutar @code{xlsfonts} (del paquete @code{xlsfonts})
+para asegurarse que sus tipografías TrueType se enumeran aquí.
+
address@hidden @code{fc-cache}
address@hidden caché de tipografías
+Después de instalar tipografías puede tener que refrescar la caché de
+tipografías para usarlas en las aplicaciones. Lo mismo aplica cuando las
+aplicaciones instaladas vía Guix no parecen encontrar tipografías. Para
+forzar la reconstrucción de la caché de tipografías ejecute @code{fc-cache
+-f}. La orden @code{fc-cache} es proporcionada por el paquete
address@hidden
+
address@hidden Certificados X.509
+
address@hidden @code{nss-certs}
+El paquete @code{nss-certs} proporciona certificados X.509, que permiten a
+los programas verificar los servidores accedidos por HTTPS.
+
+Cuando se usa Guix en una distribución distinta, puede instalar este paquete
+y definir las variables de entorno relevantes de modo que los paquetes sepan
+dónde buscar los certificados. @xref{Certificados X.509}, para información
+detallada.
+
address@hidden Paquetes Emacs
+
address@hidden @code{emacs}
+Cuando instala paquetes Emacs con Guix, los ficheros elisp pueden estar
+tanto en @file{$HOME/.guix-profile/share/emacs/site-lisp/} o en
+subdirectorios de
address@hidden/.guix-profile/share/emacs/site-lisp/guix.d/}. El último
+directorio existe porque potencialmente pueden existir miles de paquetes
+Emacs, y almacenar todos sus ficheros en un directorio único puede no ser
+confiable (por conflictos de nombres). Por lo que pensamos que usar un
+directorio separado por cada paquete es una buena idea. Es muy similar a
+cómo el sistema de paquetes de Emacs organiza la estructura de ficheros
+(@pxref{Package Files,,, emacs, The GNU Emacs Manual}).
+
+Por defecto, Emacs (el instalado con Guix) ``sabe'' donde se alojan estos
+paquetes, para que usted no tenga que realizar ninguna configuración. Si,
+por alguna razón, desea evitar la carga automática de paquetes Emacs
+instalados con Guix, puede hacerlo ejecutando Emacs con la opción
address@hidden (@pxref{Init File,,, emacs, The GNU Emacs Manual}).
+
address@hidden La cadena de herramientas de GCC
+
address@hidden GCC
address@hidden ld-wrapper
+
+Guix ofrece paquetes de compiladores individuales como @code{gcc}, pero si
+necesita una cadena de herramientas completa para compilar y enlazar código
+fuente lo que realmente desea es el paquete @code{gcc-toolchain}. Este
+paquete proporciona una cadena de herramientas GCC para desarrollo C/C++,
+incluyendo el mismo GCC, la biblioteca de C GNU (cabeceras y binarios, más
+símbolos de desarrollo en la salida @code{debug}), Binutils y un
+recubrimiento del enlazador.
+
+El propósito del recubrimiento es inspeccionar las opciones @code{-L} y
address@hidden proporcionadas al enlazador, y los correspondientes parámetros
address@hidden, y llamar al enlazador real con este nuevo conjunto de
+parámetros. Puede instruir al recubrimiento para rechazar el enlace contra
+bibliotecas que no se encuentren en el almacén fijando el valor de la
+variable de entorno @code{GUIX_LD_WRAPPER_ALLOW_IMPURITIES} a @code{no}.
+
address@hidden TODO What else?
+
address@hidden
*********************************************************************
address@hidden Instalación del sistema
address@hidden Instalación del sistema
+
address@hidden instalación del sistema Guix
address@hidden sistema Guix, instalación
+Esta sección explica cómo instalar el sistema Guix en una máquina. Guix,
+como gestor de paquetes, puede instalarse sobre un sistema GNU/Linux en
+ejecución, @pxref{Instalación}.
+
address@hidden
address@hidden Nota
address@hidden This paragraph is for people reading this from tty2 of the
address@hidden installation image.
+Está leyendo esta documentación con un lector Info. Para obtener detalles
+sobre su uso, presione la tecla @key{RET} (``retorno de carro'' o ``intro'')
+en el siguiente enlace: @pxref{Top, Info reader,, info-stnd, Stand-alone GNU
+Info}. Presione después @kbd{l} para volver aquí.
+
+De manera alternativa, ejecute @command{info info} en otro terminal para
+mantener el manual disponible.
address@hidden quotation
address@hidden ifinfo
+
address@hidden
+* Limitaciones:: Qué puede esperar.
+* Consideraciones sobre el hardware:: Hardware soportado.
+* Instalación desde memoria USB y DVD:: Preparar el medio de instalación.
+* Preparación para la instalación:: Red, particionado, etc.
+* Instalación gráfica guiada:: Instalación gráfica fácil.
+* Instalación manual:: Instalación manual para artistas del teclado.
+* Tras la instalación del sistema:: Cuando la instalación ha finalizado
+ satisfactoriamente.
+* Instalación de Guix en una máquina virtual:: El patio de recreo del
+ sistema Guix.
+* Construcción de la imagen de instalación:: Cómo esto llega a ser.
address@hidden menu
+
address@hidden Limitaciones
address@hidden Limitaciones
+
+We consider Guix System to be ready for a wide range of ``desktop'' and
+server use cases. The reliability guarantees it provides---transactional
+upgrades and rollbacks, reproducibility---make it a solid foundation.
+
+Nevertheless, before you proceed with the installation, be aware of the
+following noteworthy limitations applicable to version @value{VERSION}:
+
address@hidden
address@hidden
+No está implementada la funcionalidad del gestor de volúmenes lógicos (LVM).
+
address@hidden
+Se proporcionan más y más servicios del sistema (@pxref{Servicios}), pero
+pueden faltar algunos.
+
address@hidden
+GNOME, Xfce, LXDE, and Enlightenment are available (@pxref{Servicios de
escritorio}), as well as a number of X11 window managers. However, KDE is
+currently missing.
address@hidden itemize
+
+More than a disclaimer, this is an invitation to report issues (and success
+stories!), and to join us in improving it. @xref{Contribuir}, for more
+info.
+
+
address@hidden Consideraciones sobre el hardware
address@hidden Consideraciones sobre el hardware
+
address@hidden soporte de hardware en el sistema Guix
address@hidden se enfoca en respetar la libertad de computación de las
+usuarias. Se construye sobre el núcleo Linux-libre, lo que significa que
+únicamente funciona hardware para el que existen controladores y firmware
+libres. Hoy en día, un amplio rango del hardware común funciona con
+GNU/Linux-libre---desde teclados a tarjetas gráficas a escáneres y
+controladoras Ethernet. Desafortunadamente, todavía hay áreas donde los
+fabricantes de hardware deniegan a las usuarias el control de su propia
+computación, y dicho hardware no funciona en el sistema Guix.
+
address@hidden WiFi, soporte hardware
+One of the main areas where free drivers or firmware are lacking is WiFi
+devices. WiFi devices known to work include those using Atheros chips
+(AR9271 and AR7010), which corresponds to the @code{ath9k} Linux-libre
+driver, and those using Broadcom/AirForce chips (BCM43xx with Wireless-Core
+Revision 5), which corresponds to the @code{b43-open} Linux-libre driver.
+Free firmware exists for both and is available out-of-the-box on Guix
+System, as part of @code{%base-firmware} (@pxref{Referencia de
``operating-system'',
address@hidden).
+
address@hidden RYF, Respeta Su Libertad
+La @uref{https://www.fsf.org/, Fundación del Software Libre} patrocina
address@hidden://www.fsf.org/ryf, @dfn{Respeta Su Libertad}} (RYF), un programa
+de certificación para productos hardware que respetan su libertad y su
+privacidad y se aseguran de que usted tenga el control sobre su
+dispositivo. Le recomendamos que compruebe la lista de dispositivos
+certificados RYF.
+
+Otro recurso útil es el sitio web @uref{https://wwww.h-node.org/,
+H-Node}. Contiene un catálogo de dispositivos hardware con información
+acerca su funcionalidad con GNU/Linux.
+
+
address@hidden Instalación desde memoria USB y DVD
address@hidden Instalación desde memoria USB y DVD
+
+Se puede descargar una imagen de instalación ISO-9660 que puede ser escrita
+en una memoria USB o grabada en un DVD desde
address@hidden://alpha.gnu.org/gnu/guix/address@hidden@var{sistema}.iso.xz},
+donde @var{sistema} es uno de los siguientes valores:
+
address@hidden @code
address@hidden x86_64-linux
+para un sistema GNU/Linux en CPUs compatibles con la arquitectura de 64-bits
+de Intel/AMD.
+
address@hidden i686-linux
+para un sistema GNU/Linux en CPUs compatibles con la arquitectura de 32-bits
+de Intel.
address@hidden table
+
address@hidden start duplication of authentication part from ``Binary
Installation''
+Asegurese de descargar el fichero @file{.sig} asociado y de verificar la
+autenticidad de la imagen contra él, más o menos así:
+
address@hidden
+$ wget https://alpha.gnu.org/gnu/guix/address@hidden@var{sistema}.iso.xz.sig
+$ gpg --verify address@hidden@var{sistema}.iso.xz.sig
address@hidden example
+
+Si la orden falla porque no dispone de la clave pública necesaria, entonces
+ejecute esta otra orden para importarla:
+
address@hidden
+$ gpg --keyserver @value{KEY-SERVER} \
+ --recv-keys @value{OPENPGP-SIGNING-KEY-ID}
address@hidden example
+
address@hidden
address@hidden end duplication
+y vuelva a ejecutar la orden @code{gpg --verify}.
+
+Esta imagen contiene las herramientas necesarias para una instalación. Está
+pensada ara ser copiada @emph{tal cual} a una memoria USB o DVD con espacio
+suficiente.
+
address@hidden Copiado en una memoria USB
+
+Para copiar la imagen en una memoria USB, siga estos pasos:
+
address@hidden
address@hidden
+Descomprima la imagen usando la orden @command{xz}:
+
address@hidden
+xz -d address@hidden@var{sistema}.iso.xz
address@hidden example
+
address@hidden
+Conecte una memoria USB de address@hidden o más a su máquina, y determine su
+nombre de dispositivo. Asumiendo que la memoria USB es @file{/dev/sdX} copie
+la imagen con:
+
address@hidden
+dd address@hidden@var{sistema}.iso of=/dev/sdX
+sync
address@hidden example
+
+El acceso a @file{/dev/sdX} normalmente necesita privilegios de root.
address@hidden enumerate
+
address@hidden Grabación en un DVD
+
+Para copiar la imagen a un DVD, siga estos pasos:
+
address@hidden
address@hidden
+Descomprima la imagen usando la orden @command{xz}:
+
address@hidden
+xz -d address@hidden@var{sistema}.iso.xz
address@hidden example
+
address@hidden
+Introduzca un DVD escribible en su máquina, y determine el nombre del
+dispositivo. Asumiendo que la unidad DVD es @file{/dev/srX}, copie la imagen
+con:
+
address@hidden
+growisofs -dvd-compat -Z /dev/address@hidden@var{sistema}.iso
address@hidden example
+
+El acceso a @file{/dev/srX} normalmente necesita privilegios de root.
address@hidden enumerate
+
address@hidden Arranque
+
+Una vez hecho esto, debe ser capaz de reiniciar el sistema y arrancar desde
+la memoria USB o el DVD. Lo primero habitualmente requiere que introducirse
+en la BIOS o en el menú de arranque UEFI, donde se puede seleccionar el
+arranque desde la memoria USB.
+
address@hidden de Guix en una máquina virtual}, si, en vez de esto, desea
instalar el
+sistema Guix en una máquina virtual (VM).
+
+
address@hidden Preparación para la instalación
address@hidden Preparación para la instalación
+
+Una vez que haya arrancado, puede usar el instalador gráfico guiado, el cual
+facilita la introducción al sistema (@pxref{Instalación gráfica guiada}).
Alternativamente, si ya es está familiarizada con GNU/Linux
+y desea más control que el que proporciona el instalador gráfico, puede
+seleccionar el proceso de instalación ``manual'' (@pxref{Instalación manual}).
+
+El instalador gráfico está disponible en TTY1. Puede obtener consolas de
+root en los TTY 3 a 6 pulsando @kbd{ctrl-alt-f3}, @kbd{ctrl-alt-f4},
+etc. TTY2 muestra esta documentación y se puede cambiar a dicha consola con
address@hidden La documentación es explorable usando las órdenes del
+lector Info (@pxref{Top,,, info-stnd, Stand-alone GNU Info}). El sistema de
+instalación ejecuta el daemon GPM para ratones, el cual le permite
+seleccionar texto con el botón izquierdo y pegarlo con el botón central.
+
address@hidden Nota
+La instalación requiere acceso a Internet de modo que cualquier dependencia
+de su configuración de sistema no encontrada pueda ser descargada. Véase la
+sección ``Red'' más adelante.
address@hidden quotation
+
address@hidden Instalación gráfica guiada
address@hidden Instalación gráfica guiada
+
+El instalador gráfico es una interfaz de usuaria basada en texto. Le guiará,
+con cajas de diálogo, a través de los pasos necesarios para instalar el
+sistema address@hidden
+
+Las primeras cajas de diálogo le permiten configurar el sistema mientras lo
+usa durante la instalación: puede seleccionar el idioma, la distribución del
+teclado y configurar la red, la cual se usará durante la instalación. La
+siguiente imagen muestra el diálogo de configuración de red.
+
address@hidden/installer-network,5in,, configuración de red en la instalación
+gráfica}
+
+Los siguientes pasos le permitirán particionar su disco duro, como se
+muestra en la siguiente imagen, elegir si se usarán o no sistemas de
+ficheros cifrados, introducir el nombre de la máquina, la contraseña de root
+y crear cuentas adicionales, entre otras cosas.
+
address@hidden/installer-partitions,5in,, particionado en la instalación
+gráfica}
+
+Tenga en cuenta que, en cualquier momento, el instalador le permite salir de
+la instalación actual y retomarla en un paso previo, como se muestra en la
+siguiente imagen.
+
address@hidden/installer-resume,5in,, retomado del proceso de instalación}
+
+Una vez haya finalizado, el instalador produce una configuración de sistema
+operativo y la muestra (@pxref{Uso de la configuración del sistema}). En este
+punto puede pulsar ``OK'' y la instalación procederá. En caso de
+finalización satisfactoria, puede reiniciar con el nuevo sistema y
+disfrutarlo. address@hidden la instalación del sistema} para ver cómo proceder
a
+continuación!
+
+
address@hidden Instalación manual
address@hidden Instalación manual
+
+Esta sección describe como podría instalar ``manualmente'' el sistema
address@hidden en su máquina. Esta opción requiere familiaridad con
+GNU/Linux, con el shell y con las herramientas de administración comunes. Si
+puensa que no es para usted, considere el uso del instalador gráfico guiado
+(@pxref{Instalación gráfica guiada}).
+
+El sistema de instalación proporciona consolas de root en los terminales
+virtuales (TTY) 3 a 6; pulse @kbd{ctrl-alt-f3}, @kbd{ctrl-alt-f4} y
+sucesivas teclas para abrirlas. Incluye muchas herramientas comunes
+necesarias para la instalación del sistema. Pero es también un sistema Guix
+completo, lo que significa que puede instalar paquetes adicionales, en caso
+de necesitarlos, mediante el uso de @command{guix package} (@pxref{Invocación
de guix package}).
+
address@hidden
+* Distribución de teclado y red y particionado:: Configuración inicial.
+* Procedimiento de instalación:: Instalación.
address@hidden menu
+
address@hidden Distribución de teclado y red y particionado
address@hidden Distribución de teclado, red y particionado
+
+Antes de instalar el sistema, puede desear ajustar la distribución del
+teclado, configurar la red y particionar el disco duro deseado. Esta sección
+le guiará durante este proceso.
+
address@hidden Distribución de teclado
+
address@hidden distribución de teclado
+La imagen de instalación usa la distribución de teclado QWERTY de los
+EEUU. Si desea cambiarla, puede usar la orden @command{loadkeys}. Por
+ejemplo, la siguiente orden selecciona la distribución de teclado para el
+castellano:
+
address@hidden
+loadkeys es
address@hidden example
+
+Véanse los ficheros bajo @file{/run/current-system/profile/share/keymaps}
+para la obtención de una lista de distribuciones de teclado
+disponibles. Ejecute @command{man loadkeys} para más información.
+
address@hidden Red
+
+Ejecute la siguiente orden para ver los nombres asignados a sus interfaces
+de red:
+
address@hidden
+ifconfig -a
address@hidden example
+
address@hidden
address@hidden o, usando la orden específica de GNU/Linux @command{ip}:
+
address@hidden
+ip a
address@hidden example
+
address@hidden
http://cgit.freedesktop.org/systemd/systemd/tree/src/udev/udev-builtin-net_id.c#n20
+El nombre de las interfaces de cable comienza con @samp{e}; por ejemplo, la
+interfaz que corresponde a la primera controladora Ethernet en la placa se
+llama @samp{eno1}. El nombre de las interfaces inalámbricas comienza con
address@hidden, como @samp{w1p2s0}.
+
address@hidden @asis
address@hidden Conexión por cable
+Para configurar una red por cable ejecute la siguiente orden, substituyendo
address@hidden con el nombre de la interfaz de cable que desea usar.
+
address@hidden
+ifconfig @var{interfaz} up
address@hidden example
+
address@hidden Conexión sin cable
address@hidden sin cables
address@hidden WiFi
+Para configurar una red inalámbrica, puede crear un fichero de configuración
+para la herramienta de configuración @command{wpa_supplicant} (su ruta no es
+importante) usando uno de los editores de texto disponibles como
address@hidden:
+
address@hidden
+nano wpa_supplicant.conf
address@hidden example
+
+Como un ejemplo, la siguiente plantilla puede colocarse en este fichero y
+funcionará para muchas redes inalámbricas, siempre que se proporcione el
+SSID y la contraseña reales de la red a la que se va a conectar:
+
address@hidden
address@hidden
+ ssid="@var{mi-ssid}"
+ key_mgmt=WPA-PSK
+ psk="la contraseña de la red"
address@hidden
address@hidden example
+
+Inicie el servicio inalámbrico y ejecutelo en segundo plano con la siguiente
+orden (sustituya @var{interfaz} por el nombre de la interfaz de red que
+desea usar):
+
address@hidden
+wpa_supplicant -c wpa_supplicant.conf -i @var{interfaz} -B
address@hidden example
+
+Ejecute @command{man wpa_supplicant} para más información.
address@hidden table
+
address@hidden DHCP
+En este punto, necesita obtener una dirección IP. En una red donde las
+direcciones IP se asignan automáticamente mediante DHCP, puede ejecutar:
+
address@hidden
+dhclient -v @var{interfaz}
address@hidden example
+
+Intente hacer ping a un servidor para comprobar si la red está funcionando
+correctamente:
+
address@hidden
+ping -c 3 gnu.org
address@hidden example
+
+Configurar el acceso por red es casi siempre un requisito debido a que la
+imagen no contiene todo el software y las herramientas que puedan ser
+necesarias.
+
address@hidden instalación por SSH
+Si lo desea, puede continuar la instalación de forma remota iniciando un
+servidor SSH:
+
address@hidden
+herd start ssh-daemon
address@hidden example
+
+Asegurese de fijar una contraseña con @command{passwd}, o configurar la
+verificación de clave pública de OpenSSH para la introducción en el sistema.
+
address@hidden Particionado de discos
+
+A menos que se haya realizado previamente, el siguiente paso es el
+particionado, y después dar formato a la/s partición/es deseadas.
+
+La imagen de instalación contiene varias herramientas de particionado,
+incluyendo Parted (@pxref{Overview,,, parted, GNU Parted User Manual}),
address@hidden y @command{cfdisk}. Ejecutelo y configure el mapa de
+particiones deseado en su disco:
+
address@hidden
+cfdisk
address@hidden example
+
+Si su disco usa el formato de tabla de particiones GUID (GPT) y tiene
+pensado instalar GRUB basado en BIOS (la opción predeterminada), asegurese
+de tener una partición de arranque BIOS disponible (@pxref{BIOS
+installation,,, grub, GNU GRUB manual}).
+
address@hidden EFI, instalación
address@hidden UEFI, instalación
address@hidden ESP, partición del sistema EFI
+Si en vez de eso desea GRUB basado en EFI, se requiere una @dfn{Partición
+del Sistema EFI} (ESP) con formato FAT32. Esta partición puede montarse en
address@hidden/boot/efi} y debe tener la opción @code{esp} activa. Por ejemplo,
en
address@hidden:
+
address@hidden
+parted /dev/sda set 1 esp on
address@hidden example
+
address@hidden Nota
address@hidden grub-bootloader
address@hidden grub-efi-bootloader
+¿No esta segura si usar GRUB basado en EFI o en BIOS? Si el directorio
address@hidden/sys/firmware/efi} existe en la imagen de instalación,
probablemente
+debería realizar una instalación EFI, usando @code{grub-efi-bootloader}. En
+otro caso, debe usar GRUB basado en BIOS, conocido como
address@hidden @xref{Configuración del gestor de arranque}, para más
+información sobre cargadores de arranque.
address@hidden quotation
+
+Una vez haya terminado con el particionado de la unidad de disco deseada,
+tiene que crear un sistema de ficheros en la o las particiónes
address@hidden el sistema Guix únicamente permite sistemas
+de ficheros ext4 y btrfs. En particular, el código que lee UUIDs del sistema
+de ficheros y etiquetas únicamente funciona para dichos sistemas de
+ficheros.}. Para la ESP, si tiene una y asumiendo que es @file{/dev/sda1},
+ejecute:
+
address@hidden
+mkfs.fat -F32 /dev/sda1
address@hidden example
+
+Preferentemente, asigne una etiqueta a los sistemas de ficheros de modo que
+pueda referirse a ellos de forma fácil y precisa en las declaraciones
address@hidden (@pxref{Sistemas de ficheros}). Esto se consigue habitualmente
+con la opción @code{-L} de @command{mkfs.ext4} y las ordenes
+relacionadas. Por tanto, asumiendo que la partición de la raíz es
address@hidden/dev/sda2}, se puede crear un sistema de ficheros con la etiqueta
address@hidden de esta manera:
+
address@hidden
+mkfs.ext4 -L mi-raiz /dev/sda2
address@hidden example
+
address@hidden disco cifrado
+Si en vez de eso planea cifrar la partición raíz, puede usar las
+herramientas Crypsetup/LUKS para hacerlo (véase @inlinefmtifelse{html,
address@hidden://linux.die.net/man/8/cryptsetup, @code{man cryptsetup}},
address@hidden cryptsetup}} para más información). Asumiendo que quiere
almacenar
+la partición raíz en @file{/dev/sda2}, la secuencia de ordenes sería más o
+menos así:
+
address@hidden
+cryptsetup luksFormat /dev/sda2
+cryptsetup open --type luks /dev/sda1 mi-particion
+mkfs.ext4 -L mi-raiz /dev/mapper/mi-particion
address@hidden example
+
+Una vez hecho esto, monte el sistema de ficheros deseado bajo @file{/mnt}
+con una orden como (de nuevo, asumiendo que @code{mi-raiz} es la etiqueta
+del sistema de ficheros raíz):
+
address@hidden
+mount LABEL=mi-raiz /mnt
address@hidden example
+
+Monte también cualquier otro sistema de ficheros que desee usar en el
+sistema resultante relativamente a esta ruta. Si ha optado por
address@hidden/boot/efi} como el punto de montaje de EFI, por ejemplo, ahora
debe
+ser montada en @file{/mnt/boot/efi} para que @code{guix system init} pueda
+encontrarla más adelante.
+
+Finalmente, si planea usar una o más particiones de intercambio
+(@pxref{Memory Concepts, swap space,, libc, The GNU C Library Reference
+Manual}), asegurese de inicializarla con @command{mkswap}. Asumiendo que
+tuviese una partición de intercambio en @file{/dev/sda3}, ejecutaría:
+
address@hidden
+mkswap /dev/sda3
+swapon /dev/sda3
address@hidden example
+
+De manera alternativa, puede usar un fichero de intercambio. Por ejemplo,
+asumiendo que en el nuevo sistema desea usar el fichero
address@hidden/fichero-de-intercambio} como tal, address@hidden ejemplo
+funcionará para muchos tipos de sistemas de ficheros (por ejemplo, ext4). No
+obstante, para los sistemas de ficheros con mecanismos de
+copia-durante-escritura (por ejemplo, btrfs) los pasos pueden diferir. Para
+obtener más detalles, véanse las páginas de manual para @command{mkswap} y
address@hidden:
+
address@hidden
+# Esto son 10GiB de espacio de intercambio. Ajuste "count" para
+# cambiar el tamaño.
+dd if=/dev/zero of=/mnt/swapfile bs=1MiB count=10240
+# Por seguridad, se mantiene el fichero únicamente legible y
+# escribible por root.
+chmod 600 /mnt/swapfile
+mkswap /mnt/swapfile
+swapon /mnt/swapfile
address@hidden example
+
+Fijese que si ha cifrado la partición raíz y creado un fichero de
+intercambio en su sistema de ficheros como se ha descrito anteriormente, el
+cifrado también protege al fichero de intercambio, como a cualquier fichero
+en dicho sistema de ficheros.
+
address@hidden Procedimiento de instalación
address@hidden Procedimiento de instalación
+
+Con las particiones deseadas listas y la raíz deseada montada en
address@hidden/mnt}, estamos preparadas para empezar. Primero, ejecute:
+
address@hidden
+herd start cow-store /mnt
address@hidden example
+
+Esto activa la copia-durante-escritura en @file{/gnu/store}, de modo que los
+paquetes que se añadan durante la fase de instalación se escriban en el
+disco montado en @file{/mnt} en vez de permanecer en memoria. Esto es
+necesario debido a que la primera fase de la orden @command{guix system
+init} (vea más adelante) implica descargas o construcciones en
address@hidden/gnu/store}, el cual, inicialmente, está un sistema de ficheros en
+memoria.
+
+Después debe editar un fichero y proporcionar la declaración de sistema
+operativo a instalar. Para dicho fin, el sistema de instalación viene con
+tres editores de texto. Recomendamos GNU nano (@pxref{Top,,, nano, GNU nano
+Manual}), que permite el resaltado de sintaxis y correspondencia de
+paréntesis; los otros editores son GNU Zile (un clon de Emacs) y nvi (un
+clon del editor @command{vi} original de BSD). Le recomendamos
+encarecidamente almacenar ese fichero en el sistema de ficheros raíz,
+digamos, como @file{/mnt/etc/config.scm}. En caso de no hacerlo, habrá
+perdido su configuración del sistema una vez arranque en el sistema recién
+instalado.
+
address@hidden de la configuración del sistema}, para hacerse una idea del
fichero de
+configuración. Las configuraciones de ejemplo mencionadas en esa sección
+están disponibles bajo @file{/etc/configuration} en la imagen de
+instalación. Por tanto, para empezar con una configuración del sistema que
+proporcione un servidor gráfico (un sistema de ``escritorio''), puede
+ejecutar algo parecido a estas órdenes:
+
address@hidden
+# mkdir /mnt/etc
+# cp /etc/configuration/desktop.scm /mnt/etc/config.scm
+# nano /mnt/etc/config.scm
address@hidden example
+
+Debe prestar atención a lo que su fichero de configuración contiene, y en
+particular:
+
address@hidden
address@hidden
+Asegurese que la forma @code{bootloader-configuration} especifica la
+localización deseada de la instalación de GRUB. Debe mencionar
address@hidden si está usando GRUB con el arranque antiguo, o
address@hidden para sistemas más nuevos UEFI. Para los sistemas
+antiguos, el campo @code{target} denomina un dispositivo, como
address@hidden/dev/sda}; para los sistemas UEFI denomina la ruta de una
partición
+EFI montada, como @code{/boot/efi}; asegurese de que la ruta está
+actualmente montada y haya una entrada @code{file-system} especificada en su
+configuración.
+
address@hidden
+Asegurese que las etiquetas de su sistema de ficheros corresponden con el
+valor de sus campos @code{device} respectivos en su configuración
address@hidden, asumiendo que su configuración @code{file-system} usa el
+procedimiento @code{file-system-label} en su campo @code{device}.
+
address@hidden
+Si hay particiones cifradas o en RAID, asegurese de añadir un campo
address@hidden para describirlas (@pxref{Dispositivos traducidos}).
address@hidden itemize
+
+Una vez haya terminado de preparar el fichero de configuración, el nuevo
+sistema debe ser inicializado (recuerde que el sistema de ficheros raíz
+deseado está montado bajo @file{/mnt}):
+
address@hidden
+guix system init /mnt/etc/config.scm /mnt
address@hidden example
+
address@hidden
+Esto copia todos los ficheros necesarios e instala GRUB en @file{/dev/sdX},
+a menos que proporcione la opción @option{--no-bootloader}. Para más
+información, @pxref{Invocación de guix system}. Esta orden puede desencadenar
+descargas o construcciones de paquetes no encontrados, lo cual puede tomar
+algún tiempo.
+
+Una vez que la orden se complete---¡y, deseablemente, de forma
+satisfactoria!---puede ejecutar @command{reboot} y arrancar con el nuevo
+sistema. La contraseña de @code{root} en el nuevo sistema está vacía
+inicialmente; otras contraseñas de usuarias tienen que ser inicializadas
+ejecutando la orden @command{passwd} como @code{root}, a menos que en su
+configuración se especifique de otra manera (@pxref{user-account-password,
+contraseñas de cuentas de usuaria}). address@hidden la instalación del
sistema} para
+proceder a continuación!
+
+
address@hidden Tras la instalación del sistema
address@hidden Tras la instalación del sistema
+
+¡Éxito! ¡Ha arrancado en el sistema Guix! De ahora en adelante, puede
+actualizar el sistema cuando quiera mediante la ejecución de, digamos:
+
address@hidden
+guix pull
+sudo guix system reconfigure /etc/config.scm
address@hidden example
+
address@hidden
+Esto construye una nueva generación del sistema con los últimos paquetes y
+servicios (@pxref{Invocación de guix system}). Recomendamos realizarlo de
manera
+regular de modo que su sistema incluya las últimas actualizaciones de
+seguridad (@pxref{Actualizaciones de seguridad}).
+
address@hidden See
<https://lists.gnu.org/archive/html/guix-devel/2019-01/msg00268.html>.
address@hidden Nota
address@hidden sudo y @command{guix pull}
+Tenga en cuenta que @command{sudo guix} ejecuta el ejecutable @command{guix}
+de su usuaria y @emph{no} el de root, ya que @command{sudo} no altera
address@hidden Para ejecutar explícitamente el ejecutable @command{guix} de
+root, escriba @command{sudo -i guix @dots{}}.
address@hidden quotation
+
+¡Unase a nosotras en @code{#guix} en la red IRC Freenode o en
address@hidden@@gnu.org} para compartir su experiencia!
+
+
address@hidden Instalación de Guix en una máquina virtual
address@hidden Instalación de Guix en una máquina virtual
+
address@hidden máquina virtual, instalación del sistema Guix
address@hidden servidor virtual privado (VPS)
address@hidden VPS (servidor virtual privado)
+Si desea instalar el sistema Guix en una máquina virtual (VM) o en un
+servidor privado virtual (VPS) en vez de en su preciada máquina, esta
+sección es para usted.
+
+Si quiere arrancar una VM @uref{http://qemu.org/,QEMU} para instalar el
+sistema Guix en una imagen de disco, siga estos pasos:
+
address@hidden
address@hidden
+Primero, obtenga y descomprima la imagen de instalación del sistema Guix
+como se ha descrito previamente (@pxref{Instalación desde memoria USB y DVD}).
+
address@hidden
+Cree una imagen de disco que contendrá el sistema instalado. Para crear una
+imagen de disco con formato qcow2, use la orden @command{qemu-img}:
+
address@hidden
+qemu-img create -f qcow2 guixsd.img 50G
address@hidden example
+
+El fichero que obtenga será mucho menor de 50GB (típicamente menos de 1MB),
+pero crecerá cuando el dispositivo de almacenamiento virtualizado se vaya
+llenando.
+
address@hidden
+Arranque la imagen de instalación USB en una máquina virtual:
+
address@hidden
+qemu-system-x86_64 -m 1024 -smp 1 \
+ -net user -net nic,model=virtio -boot menu=on \
+ -drive address@hidden@var{sistema}.iso \
+ -drive file=guixsd.img
address@hidden example
+
+El orden de las unidades importa.
+
+En la consola de la VM, pulse rápidamente la tecla @kbd{F12} para entrar al
+menú de arranque. Pulse la tecla @kbd{2} y la tecla @kbd{RET} para confirmar
+su selección.
+
address@hidden
+Ahora es root en la VM, prosiga con el procedimiento de
+instalación. @xref{Preparación para la instalación}, y siga las instrucciones.
address@hidden enumerate
+
+Una vez complete la instalación, puede arrancar el sistema que está en la
+imagen @file{guixsd.img}. @xref{Ejecutar Guix en una máquina virtual}, para
información
+sobre cómo hacerlo.
+
address@hidden Construcción de la imagen de instalación
address@hidden Construcción de la imagen de instalación
+
address@hidden imagen de instalación
+La imagen de instalación descrita anteriormente se construyó usando la orden
address@hidden system}, específicamente:
+
address@hidden
+guix system disk-image --file-system-type=iso9660 \
+ gnu/system/install.scm
address@hidden example
+
+Eche un vistazo a @file{gnu/system/install.scm} en el árbol de fuentes, y
+vea también @ref{Invocación de guix system} para más información acerca de la
+imagen de instalación.
+
address@hidden Construcción de la imagen de instalación para placas ARM
+
+Muchas placas ARM necesitan una variante específica del cargador de arranque
address@hidden://www.denx.de/wiki/U-Boot/, U-Boot}.
+
+Si construye una imagen de disco y el cargador de arranque no está
+disponible de otro modo (en otra unidad de arranque, etc.), es recomendable
+construir una imagen que incluya el cargador, específicamente:
+
address@hidden
+guix system disk-image --system=armhf-linux -e '((@@ (gnu system install)
os-with-u-boot) (@@ (gnu system install) installation-os)
"A20-OLinuXino-Lime2")'
address@hidden example
+
address@hidden es el nombre de la placa. Si especifica una placa
+no válida, una lista de placas posibles será mostrada.
+
address@hidden
*********************************************************************
address@hidden Gestión de paquetes
address@hidden Gestión de paquetes
+
address@hidden paquetes
+El propósito de GNU Guix es permitir a las usuarias instalar, actualizar y
+borrar fácilmente paquetes de software, sin tener que conocer acerca de sus
+procedimientos de construcción o dependencias. Guix también va más allá de
+este conjunto obvio de características.
+
+Este capítulo describe las principales características de Guix, así como las
+herramientas de gestión de paquetes que ofrece. Junto a la interfaz de línea
+de órdenes descrita a continuación (@pxref{Invocación de guix package,
@code{guix
+package}}, también puede usar la interfaz Emacs-Guix (@pxref{Top,,,
+emacs-guix, The Emacs Guix Reference Manual}), tras la instalación del
+paquete @code{emacs-guix} (ejecute la orden @kbd{M-x guix-help} para
+iniciarse en su uso):
+
address@hidden
+guix package -i emacs-guix
address@hidden example
+
address@hidden
+* Características:: Cómo Guix dará brillo a su vida.
+* Invocación de guix package:: Instalación de paquetes, borrado, etc.
+* Sustituciones:: Descargar binarios pre-construidos.
+* Paquetes con múltiples salidas:: Un único paquete de fuentes,
+ múltiples salidas.
+* Invocación de guix gc:: Ejecutar el recolector de basura.
+* Invocación de guix pull:: Obtener la última versión de Guix y la
+ distribución.
+* Canales:: Personalizar el recolector de basura.
+* Inferiores:: Interactuar con otra revisión de Guix.
+* Invocación de guix describe:: Muestra información acerca de su
+ revisión de Guix.
+* Invocación de guix archive:: Exportar e importar ficheros del almacén.
address@hidden menu
+
address@hidden Características
address@hidden Características
+
+Cuando se usa Guix, cada paquete se encuentra en el @dfn{almacén de
+paquetes}, en su propio directorio---algo que se asemeja a
address@hidden/gnu/store/xxx-paquete-1.2}, donde @code{xxx} es una cadena en
base32.
+
+En vez de referirse a estos directorios, las usuarias tienen su propio
address@hidden, el cual apunta a los paquetes que realmente desean usar. Estos
+perfiles se almacenan en el directorio de cada usuaria, en
address@hidden/.guix-profile}.
+
+Por ejemplo, @code{alicia} instala GCC 4.7.2. Como resultado,
address@hidden/home/alicia/.guix-profile/bin/gcc} apunta a
address@hidden/gnu/store/@dots{}-gcc-4.7.2/bin/gcc}. Ahora, en la misma máquina,
address@hidden ha instalado ya GCC 4.8.0. El perfil de @code{rober}
+simplemente sigue apuntando a
address@hidden/gnu/store/@dots{}-gcc-4.8.0/bin/gcc}---es decir, ambas versiones
de
+GCC pueden coexistir en el mismo sistema sin ninguna interferencia.
+
+La orden @command{guix package} es la herramienta central para gestión de
+paquetes (@pxref{Invocación de guix package}). Opera en los perfiles de
usuaria,
+y puede ser usada @emph{con privilegios de usuaria normal}.
+
address@hidden transacciones
+La orden proporciona las operaciones obvias de instalación, borrado y
+actualización. Cada invocación es en realidad una @emph{transacción}: o bien
+la operación especificada se realiza satisfactoriamente, o bien nada
+sucede. Por tanto, si el proceso @command{guix package} es finalizado
+durante una transacción, o un fallo eléctrico ocurre durante la transacción,
+el perfil de usuaria permanece en su estado previo, y permanece usable.
+
+Además, cualquier transacción de paquetes puede ser @emph{vuelta atrás}. Si,
+por ejemplo, una actualización instala una nueva versión de un paquete que
+resulta tener un error importante, las usuarias pueden volver a la instancia
+previa de su perfil, de la cual se tiene constancia que funcionaba bien. De
+igual modo, la configuración global del sistema en Guix está sujeta a
+actualizaciones transaccionales y vuelta atrás (@pxref{Uso de la configuración
del sistema}).
+
+Todos los paquetes en el almacén de paquetes pueden ser @emph{eliminados por
+el recolector de basura}. Guix puede determinar qué paquetes están siendo
+todavía referenciados por los perfiles de usuarias, y eliminar aquellos que,
+de forma demostrable, no están referenciados (@pxref{Invocación de guix gc}).
Las
+usuarias pueden también borrar explícitamente generaciones antiguas de su
+perfil para que los paquetes referenciados en ellas puedan ser recolectadas.
+
address@hidden reproducibilidad
address@hidden construcciones reproducibles
+Guix toma una aproximación @dfn{puramente funcional} en la gestión de
+paquetes, como se describe en la introducción (@pxref{Introducción}). Cada
+nombre de directorio de paquete en @file{/gnu/store} contiene un hash de
+todas las entradas que fueron usadas para construir el paquete---compilador,
+bibliotecas, guiones de construcción, etc. Esta correspondencia directa
+permite a las usuarias asegurarse que una instalación dada de un paquete
+corresponde al estado actual de su distribución. Esto también ayuda a
+maximizar la @dfn{reproducibilidad de la construcción}: gracias al uso de
+entornos aislados de construcción, una construcción dada probablemente
+generará ficheros idénticos bit-a-bit cuando se realice en máquinas
+diferentes (@pxref{Invocación de guix-daemon, container}).
+
address@hidden sustituciones
+Estos cimientos permiten a Guix ofrecer @dfn{despliegues transparentes de
+binarios/fuentes}. Cuando un binario pre-construido para un elemento de
address@hidden/gnu/store} está disponible para descarga de una fuente
externa---una
address@hidden, Guix simplemente lo descarga y desempaqueta; en otro caso
+construye el paquete de las fuentes, localmente
+(@pxref{Sustituciones}). Debido a que los resultados de construcción son
+normalmente reproducibles bit-a-bit, las usuarias no tienen que confiar en
+los servidores que proporcionan sustituciones: pueden forzar una
+construcción local y @emph{retar} a las proveedoras (@pxref{Invocación de guix
challenge}).
+
+El control sobre el entorno de construcción es una característica que
+también es útil para desarrolladoras. La orden @command{guix environment}
+permite a desarrolladoras de un paquete configurar rápidamente el entorno de
+desarrollo correcto para su paquete, sin tener que instalar manualmente las
+dependencias del paquete en su perfil (@pxref{Invocación de guix environment}).
+
address@hidden replicación, de entornos de software
address@hidden seguimiento de procedencia, de artefactos de software
+Todo Guix y sus definiciones de paquetes están bajo control de versiones, y
address@hidden pull} le permite ``viajar en el tiempo'' por la historia del
+mismo Guix (@pxref{Invocación de guix pull}). Esto hace posible replicar una
+instancia de Guix en una máquina diferente o en un punto posterior del
+tiempo, lo que a su vez le permite @emph{replicar entornos de software
+completos}, mientras que mantiene un preciso @dfn{seguimiento de la
+procedencia} del software.
+
address@hidden Invocación de guix package
address@hidden Invocación de @command{guix package}
+
address@hidden instalar paquetes
address@hidden borrar paquetes
address@hidden instalación de paquetes
address@hidden borrado de paquetes
+La orden @command{guix package} es la herramienta que permite a las usuarias
+instalar, actualizar y borrar paquetes, así como volver a configuraciones
+previas. Opera únicamente en el perfil propio de la usuaria, y funciona con
+privilegios de usuaria normal (@pxref{Características}). Su sintaxis es:
+
address@hidden
+guix package @var{opciones}
address@hidden example
address@hidden transacciones
+Primariamente, @var{opciones} especifica las operaciones a ser realizadas
+durante la transacción. Al completarse, un nuevo perfil es creado, pero las
address@hidden previas del perfil permanecen disponibles, en caso de que
+la usuaria quisiera volver atrás.
+
+Por ejemplo, para borrar @code{lua} e instalar @code{guile} y
address@hidden en una única transacción:
+
address@hidden
+guix package -r lua -i guile guile-cairo
address@hidden example
+
address@hidden package} también proporciona una @dfn{aproximación
+declarativa}, donde la usuaria especifica el conjunto exacto de paquetes a
+poner disponibles y la pasa a través de la opción @option{--manifest}
+(@pxref{profile-manifest, @option{--manifest}}).
+
address@hidden perfil
+Para cada usuaria, un enlace simbólico al perfil predeterminado de la
+usuaria es creado en @file{$HOME/.guix-profile}. Este enlace simbólico
+siempre apunta a la generación actual del perfil predeterminado de la
+usuaria. Por lo tanto, las usuarias pueden añadir
address@hidden/.guix-profile/bin} a su variable de entorno @code{PATH}, y
+demás.
address@hidden rutas de búsqueda
+Si no está usando la Distribución de Sistema Guix, considere añadir las
+siguientes líneas a su @file{~/.bash_profile} (@pxref{Bash Startup Files,,,
+bash, The GNU Bash Reference Manual}) de modo que los shell lanzados a
+partir de entonces obtengan todas las definiciones de variables de entorno
+correctas:
+
address@hidden
+GUIX_PROFILE="$HOME/.guix-profile" ; \
+source "$HOME/.guix-profile/etc/profile"
address@hidden example
+
+En una configuración multiusuaria, los perfiles de usuaria se almacenan en
+un lugar registrado como una @dfn{raíz del sistema de ficheros}, a la que
+apunta @file{$HOME/.guix-profile} (@pxref{Invocación de guix gc}). Ese
directorio
+normalmente es
address@hidden@var{localstatedir}/guix/profiles/per-user/@var{usuaria}}, donde
address@hidden es el valor pasado a @code{configure} como
address@hidden y @var{usuaria} es el nombre de usuaria. El
+directorio @file{per-user} se crea cuando se lanza @command{guix-daemon}, y
+el subdirectorio @var{usuaria} es creado por @command{guix package}.
+
+Las @var{opciones} pueden ser las siguientes:
+
address@hidden @code
+
address@hidden address@hidden @dots{}
address@hidden -i @var{paquete} @dots{}
+Instala los @var{paquete}s especificados.
+
+Cada @var{paquete} puede especificar un nombre simple de paquete, como por
+ejemplo @code{guile}, o un nombre de paquete seguido por una arroba y el
+número de versión, como por ejemplo @code{guile@@1.8.8} o simplemente
address@hidden@@1.8} (en el último caso la última versión con @code{1.8} como
+prefijo es seleccionada).
+
+Si no se especifica un número de versión, la última versión disponible será
+seleccionada. Además, @var{paquete} puede contener dos puntos, seguido por
+el nombre de una de las salidas del paquete, como en @code{gcc:doc} o
address@hidden@@2.22:lib} (@pxref{Paquetes con múltiples salidas}). Los
+paquetes con el nombre correspondiente (y opcionalmente la versión) se
+buscan entre los módulos de la distribución GNU (@pxref{Módulos de paquetes}).
+
address@hidden entradas propagadas
+A veces los paquetes tienen @dfn{entradas propagadas}: estas son las
+dependencias que se instalan automáticamente junto al paquete requerido
+(@pxref{package-propagated-inputs, @code{propagated-inputs} in
address@hidden objects}, para información sobre las entradas propagadas en
+las definiciones de paquete).
+
address@hidden
+Un ejemplo es la biblioteca GNU MPC: sus ficheros de cabecera C hacen
+referencia a los de la biblioteca GNU MPFR, que a su vez hacen referencia a
+los de la biblioteca GMP. Por tanto, cuando se instala MPC, las bibliotecas
+MPFR y GMP también se instalan en el perfil; borrar MPC también borra MPFR y
+GMP---a menos que también se hayan instalado explícitamente por la usuaria.
+
+Por otra parte, los paquetes a veces dependen de la definición de variables
+de entorno para sus rutas de búsqueda (véase a continuación la explicación
+de @code{--seach-paths}). Cualquier definición de variable de entorno que
+falte o sea posiblemente incorrecta se informa aquí.
+
address@hidden address@hidden
address@hidden -e @var{exp}
+Instala el paquete al que @var{exp} evalúa.
+
address@hidden debe ser una expresión Scheme que evalue a un objeto
address@hidden<package>}. Esta opción es notablemente útil para desambiguar
entre
+variantes con el mismo nombre que un paquete, con expresiones como @code{(@@
+(gnu packages base) guile-final)}.
+
+Fíjese que esta opción instala la primera salida del paquete especificado,
+lo cual puede ser insuficiente cuando se necesita una salida específica de
+un paquete con múltiples salidas.
+
address@hidden address@hidden
address@hidden -f @var{fichero}
+Instala el paquete que resulta de evaluar el código en @var{fichero}.
+
+Como un ejemplo, @var{fichero} puede contener una definición como esta
+(@pxref{Definición de paquetes}):
+
address@hidden
address@hidden package-hello.scm
address@hidden example
+
+Las desarrolladoras pueden encontrarlo útil para incluir un fichero
address@hidden in la raíz del árbol de fuentes de su proyecto que puede ser
+usado para probar imágenes de desarrollo y crear entornos de desarrollo
+reproducibles (@pxref{Invocación de guix environment}).
+
address@hidden address@hidden @dots{}
address@hidden -r @var{paquete} @dots{}
+Borra los @var{paquete}s especificados.
+
+Como en @code{--install}, cada @var{paquete} puede especificar un número de
+versión y/o un nombre de salida además del nombre del paquete. Por ejemplo,
address@hidden glibc:debug} eliminaría la salida @code{debug} de @code{glibc}.
+
address@hidden address@hidden @dots{}]
address@hidden -u address@hidden @dots{}]
address@hidden actualizar paquetes
+Actualiza todos los paquetes instalados. Si se especifica una o más
+expresiones regular @var{regexp}, actualiza únicamente los paquetes
+instalados cuyo nombre es aceptado por @var{regexp}. Véase también la opción
address@hidden más adelante.
+
+Tenga en cuenta que esto actualiza los paquetes a la última versión
+encontrada en la distribución instalada actualmente. Para actualizar su
+distribución, debe ejecutar regularmente @command{guix pull}
+(@pxref{Invocación de guix pull}).
+
address@hidden address@hidden @dots{}]
+Cuando se usa junto a la opción @code{--upgrade}, @emph{no} actualiza ningún
+paquete cuyo nombre sea aceptado por @var{regexp}. Por ejemplo, para
+actualizar todos los paquetes en el perfil actual excepto aquellos que
+contengan la cadena ``emacs'':
+
address@hidden
+$ guix package --upgrade . --do-not-upgrade emacs
address@hidden example
+
address@hidden @address@hidden
address@hidden -m @var{fichero}
address@hidden declaración del perfil
address@hidden manifiesto del perfil
+Crea una nueva generación del perfil desde el objeto de manifiesto devuelto
+por el código Scheme en @var{fichero}.
+
+Esto le permite @emph{declarar} los contenidos del perfil en vez de
+construirlo a través de una secuencia de @code{--install} y órdenes
+similares. La ventaja es que @var{fichero} puede ponerse bajo control de
+versiones, copiarse a máquinas diferentes para reproducir el mismo perfil, y
+demás.
+
address@hidden FIXME: Add reference to (guix profile) documentation when
available.
address@hidden debe devolver un objeto @dfn{manifest}, que es básicamente una
+lista de paquetes:
+
address@hidden packages->manifest
address@hidden
+(use-package-modules guile emacs)
+
+(packages->manifest
+ (list emacs
+ guile-2.0
+ ;; Usa una salida específica del paquete.
+ (list guile-2.0 "debug")))
address@hidden example
+
address@hidden specifications->manifest
+En este ejemplo tenemos que conocer qué módulos definen las variables
address@hidden y @code{guile-2.0} para proporcionar la línea
address@hidden correcta, lo cual puede ser complicado. En cambio
+podemos proporcionar especificaciones regulares de paquetes y dejar a
address@hidden>manifest} buscar los objetos de paquete
+correspondientes así:
+
address@hidden
+(specifications->manifest
+ '("emacs" "guile@@2.2" "guile@@2.2:debug"))
address@hidden example
+
address@hidden --roll-back
address@hidden vuelta atrás
address@hidden deshacer transacciones
address@hidden transacciones, deshaciendo
+Vuelve a la @dfn{generación} previa del perfil---es decir, deshace la última
+transacción.
+
+Cuando se combina con opciones como @code{--install}, la vuelta atrás ocurre
+antes que cualquier acción.
+
+Cuando se vuelve atrás en la primera generación que realmente contiene
+paquetes instalados, se hace que el perfil apunte a la @dfn{generación
+cero}, la cual no contiene ningún fichero a excepción de sus propios
+metadatos.
+
+Después de haber vuelto atrás, instalar, borrar o actualizar paquetes
+sobreescribe las generaciones futuras previas. Por tanto, la historia de las
+generaciones en un perfil es siempre linear.
+
address@hidden address@hidden
address@hidden -S @var{patrón}
address@hidden generaciones
+Cambia a una generación particular definida por el @var{patrón}.
+
address@hidden puede ser tanto un número de generación como un número
+prefijado con ``+'' o ``-''. Esto último significa: mueve atrás/hacia
+delante el número especificado de generaciones. Por ejemplo, si quiere
+volver a la última generación antes de @code{--roll-back}, use
address@hidden
+
+La diferencia entre @code{--roll-back} y @code{--switch-generation=-1} es
+que @code{--switch-generation} no creará una generación cero, así que si la
+generación especificada no existe, la generación actual no se verá cambiada.
+
address@hidden address@hidden
address@hidden rutas de búsqueda
+Informa de variables de entorno, en sintaxis Bash, que pueden necesitarse
+para usar el conjunto de paquetes instalado. Estas variables de entorno se
+usan para especificar las @dfn{rutas de búsqueda} para ficheros usadas por
+algunos de los paquetes.
+
+Por ejemplo, GCC necesita que las variables de entorno @code{CPATH} y
address@hidden estén definidas para poder buscar cabeceras y
+bibliotecas en el perfil de la usuaria (@pxref{Environment Variables,,, gcc,
+Using the GNU Compiler Collection (GCC)}). Si GCC y, digamos, la biblioteca
+de C están instaladas en el perfil, entonces @code{--search-paths} sugerirá
+fijar dichas variables a @address@hidden/include} y
address@hidden@var{perfil}/lib} respectivamente.
+
+El caso de uso típico es para definir estas variables de entorno en el
+shell:
+
address@hidden
+$ eval `guix package --search-paths`
address@hidden example
+
address@hidden puede ser @code{exact}, @code{prefix} o @code{suffix}, lo que
+significa que las definiciones de variables de entorno devueltas serán
+respectivamente las configuraciones exactas, prefijos o sufijos del valor
+actual de dichas variables. Cuando se omite, el valor predeterminado de
address@hidden es @code{exact}.
+
+Esta opción puede usarse para calcular las rutas de búsqueda
address@hidden de varios perfiles. Considere este ejemplo:
+
address@hidden
+$ guix package -p foo -i guile
+$ guix package -p bar -i guile-json
+$ guix package -p foo -p bar --search-paths
address@hidden example
+
+La última orden informa sobre la variable @code{GUILE_LOAD_PATH}, aunque,
+tomada individualmente, ni @file{foo} ni @file{bar} hubieran llevado a esa
+recomendación.
+
+
address@hidden address@hidden
address@hidden -p @var{perfil}
+Usa @var{perfil} en vez del perfil predeterminado de la usuaria.
+
address@hidden colisiones, en un perfil
address@hidden paquetes con colisiones en perfiles
address@hidden colisiones del perfil
address@hidden --allow-collisions
+Permite colisiones de paquetes en el nuevo perfil. ¡Úselo bajo su propio
+riesgo!
+
+Por defecto, @command{guix package} informa como un error las
address@hidden en el perfil. Las colisiones ocurren cuando dos o más
+versiones diferentes o variantes de un paquete dado se han seleccionado para
+el perfil.
+
address@hidden --bootstrap
+Use el Guile usado para el lanzamiento para construir el perfil. Esta opción
+es util únicamente a las desarrolladoras de la distribución.
+
address@hidden table
+
+Además de estas acciones, @command{guix package} acepta las siguientes
+opciones para consultar el estado actual de un perfil, o la disponibilidad
+de paquetes:
+
address@hidden @option
+
address@hidden address@hidden
address@hidden -s @var{regexp}
address@hidden buscar paquetes
+Enumera los paquetes disponibles cuyo nombre, sinopsis o descripción
+corresponde con @var{regexp} (sin tener en cuenta la capitalización),
+ordenados por relevancia. Imprime todos los metadatos de los paquetes
+coincidentes en formato @code{recutils} (@pxref{Top, GNU recutils
+databases,, recutils, GNU recutils manual}).
+
+Esto permite extraer campos específicos usando la orden @command{recsel},
+por ejemplo:
+
address@hidden
+$ guix package -s malloc | recsel -p name,version,relevance
+name: jemalloc
+version: 4.5.0
+relevance: 6
+
+name: glibc
+version: 2.25
+relevance: 1
+
+name: libgc
+version: 7.6.0
+relevance: 1
address@hidden example
+
+De manera similar, para mostrar el nombre de todos los paquetes disponibles
+bajo los términos de la address@hidden versión 3:
+
address@hidden
+$ guix package -s "" | recsel -p name -e 'license ~ "LGPL 3"'
+name: elfutils
+
+name: gmp
address@hidden
address@hidden example
+
+Es también posible refinar los resultados de búsqueda usando varias opciones
address@hidden Por ejemplo, la siguiente orden devuelve un lista de juegos de
+mesa (board en inglés):
+
address@hidden
+$ guix package -s '\<board\>' -s game | recsel -p name
+name: gnubg
address@hidden
address@hidden example
+
+Si omitimos @code{-s game}, también obtendríamos paquetes de software que
+tengan que ver con placas de circuitos impresos ("circuit board" en inglés);
+borrar los signos mayor y menor alrededor de @code{board} añadiría paquetes
+que tienen que ver con teclados (keyboard en inglés).
+
+Y ahora para un ejemplo más elaborado. La siguiente orden busca bibliotecas
+criptográficas, descarta bibliotecas Haskell, Perl, Python y Ruby, e imprime
+el nombre y la sinopsis de los paquetes resultantes:
+
address@hidden
+$ guix package -s crypto -s library | \
+ recsel -e '! (name ~ "^(ghc|perl|python|ruby)")' -p name,synopsis
address@hidden example
+
address@hidden
address@hidden Expressions,,, recutils, GNU recutils manual}, para más
+información en @dfn{expresiones de selección} para @code{recsel -e}.
+
address@hidden address@hidden
+Muestra los detalles del @var{paquete}, tomado de la lista disponible de
+paquetes, en formato @code{recutils} (@pxref{Top, GNU recutils databases,,
+recutils, GNU recutils manual}).
+
address@hidden
+$ guix package --show=python | recsel -p name,version
+name: python
+version: 2.7.6
+
+name: python
+version: 3.3.5
address@hidden example
+
+Tambien puede especificar el nombre completo de un paquete para únicamente
+obtener detalles sobre una versión específica:
address@hidden
+$ guix package --show=python@@3.4 | recsel -p name,version
+name: python
+version: 3.4.3
address@hidden example
+
+
+
address@hidden address@hidden
address@hidden -I address@hidden
+Enumera los paquetes actualmente instalados en el perfil especificado, con
+los últimos paquetes instalados mostrados al final. Cuando se especifica
address@hidden, enumera únicamente los paquetes instalados cuyos nombres son
+aceptados por @var{regexp}.
+
+Por cada paquete instalado, imprime los siguientes elementos, separados por
+tabuladores: el nombre del paquete, la cadena de versión, la parte del
+paquete que está instalada (por ejemplo, @code{out} para la salida
+predeterminada, @code{include} para sus cabeceras, etc.), y la ruta de este
+paquete en el almacén.
+
address@hidden address@hidden
address@hidden -A address@hidden
+Enumera los paquetes disponibles actualmente en la distribución para este
+sistema (@pxref{Distribución GNU}). Cuando se especifica @var{regexp},
+enumera únicamente paquetes instalados cuyo nombre coincide con
address@hidden
+
+Por cada paquete, imprime los siguientes elementos separados por
+tabuladores: su nombre, su cadena de versión, las partes del paquete
+(@pxref{Paquetes con múltiples salidas}) y la dirección de las fuentes de su
+definición.
+
address@hidden address@hidden
address@hidden -l address@hidden
address@hidden generaciones
+Devuelve una lista de generaciones junto a sus fechas de creación; para cada
+generación, muestra los paquetes instalados, con los paquetes instalados más
+recientemente mostrados los últimos. Fíjese que la generación cero nunca se
+muestra.
+
+Por cada paquete instalado, imprime los siguientes elementos, separados por
+tabuladores: el nombre de un paquete, su cadena de versión, la parte del
+paquete que está instalada (@pxref{Paquetes con múltiples salidas}), y la
+ruta de este paquete en el almacén.
+
+Cuando se usa @var{patrón}, la orden devuelve únicamente las generaciones
+que se ajustan al patrón. Patrones válidos incluyen:
+
address@hidden
address@hidden @emph{Enteros y enteros separados por comas}. Ambos patrones
denotan
+números de generación. Por ejemplo, @code{--list-generations=1} devuelve la
+primera.
+
+Y @code{--list-generations=1,8,2} devuelve las tres generaciones en el orden
+especificado. No se permiten ni espacios ni una coma al final.
+
address@hidden @emph{Rangos}. @code{--list-generations=2..9} imprime
+las generaciones especificadas y todas las intermedias. Fíjese que el inicio
+de un rango debe ser menor a su fin.
+
+También es posible omitir el destino final. Por ejemplo,
address@hidden devuelve todas las generaciones empezando por
+la segunda.
+
address@hidden @emph{Duraciones}. Puede también obtener los últimos
@address@hidden, semanas,
+o meses pasando un entero junto a la primera letra de la duración. Por
+ejemplo, @code{--list-generations=20d} enumera las generaciones que tienen
+hasta 20 días de antigüedad.
address@hidden itemize
+
address@hidden address@hidden
address@hidden -d address@hidden
+Cuando se omite @var{patrón}, borra todas las generaciones excepto la
+actual.
+
+Esta orden acepta los mismos patrones que
address@hidden Cuando se especifica un @var{patrón}, borra las
+generaciones coincidentes. Cuando el @var{patrón} especifica una duración,
+las generaciones @emph{más antiguas} que la duración especificada son las
+borradas. Por ejemplo, @code{--delete-generations=1m} borra las generaciones
+de más de un mes de antigüedad.
+
+Si la generación actual entra en el patrón, @emph{no} es borrada. Tampoco la
+generación cero es borrada nunca.
+
+Fíjese que borrar generaciones previene volver atrás a
+ellas. Consecuentemente esta orden debe ser usada con cuidado.
+
address@hidden table
+
+Finalmente, ya que @command{guix package} puede lanzar procesos de
+construcción en realidad, acepta todas las opciones comunes de construcción
+(@pxref{Opciones comunes de construcción}). También acepta opciones de
transformación de
+paquetes, como @option{--with-source} (@pxref{Opciones de transformación de
paquetes}). No obstante, fíjese que las transformaciones del paquete se
+pierden al actualizar; para preservar las transformaciones entre
+actualizaciones, debe definir su propia variante del paquete en un módulo
+Guile y añadirlo a @code{GUIX_PACKAGE_PATH} (@pxref{Definición de paquetes}).
+
address@hidden Sustituciones
address@hidden Sustituciones
+
address@hidden sustituciones
address@hidden binarios pre-construidos
+Guix permite despliegues transparentes de fuentes/binarios, lo que significa
+que puede tanto construir cosas localmente, como descargar elementos
+preconstruidos de un servidor, o ambas. Llamamos a esos elementos
+preconstruidos @dfn{sustituciones}---son sustituciones de los resultados de
+construcciones locales. En muchos casos, descargar una sustitución es mucho
+más rápido que construirla localmente.
+
+Las sustituciones pueden ser cualquier cosa que resulte de una construcción
+de una derivación (@pxref{Derivaciones}). Por supuesto, en el caso común, son
+paquetes binarios preconstruidos, pero los archivos de fuentes, por ejemplo,
+que también resultan de construcciones de derivaciones, pueden estar
+disponibles como sustituciones.
+
address@hidden
+* Servidor oficial de sustituciones.:: Una fuente particular de
+ sustituciones.
+* Autorización de servidores de sustituciones:: Cómo habilitar o
+ deshabilitar
+ sustituciones.
+* Verificación de sustituciones:: Cómo verifica las sustituciones Guix.
+* Configuración de la pasarela.:: Cómo obtener sustituciones a través de
+ una pasarela.
+* Fallos en las sustituciones:: Qué pasa cuando una sustitución falla.
+* Sobre la confianza en binarios:: ¿Cómo puede usted confiar en esa masa
+ informe de datos binarios?
address@hidden menu
+
address@hidden Servidor oficial de sustituciones.
address@hidden Servidor oficial de sustituciones.
+
address@hidden hydra
address@hidden granja de construcción
+El servidor @address@hidden es una fachada a una granja de
+construcción oficial que construye paquetes de Guix continuamente para
+algunas arquitecturas, y los pone disponibles como sustituciones. Esta es la
+fuente predeterminada de sustituciones; puede ser forzada a cambiar pasando
+la opción @option{--substitute-urls} bien a @command{guix-daemon}
+(@pxref{daemon-substitute-urls,, @code{guix-daemon --substitute-urls}}) o
+bien a herramientas cliente como @command{guix package}
+(@pxref{client-substitute-urls,, client @option{--substitute-urls} option}).
+
+Las URLs de sustituciones pueden ser tanto HTTP como HTTPS. Se recomienda
+HTTPS porque las comunicaciones están cifradas; de modo contrario, usar HTTP
+hace visibles todas las comunicaciones para alguien que las intercepte,
+quien puede usar la información obtenida para determinar, por ejemplo, si su
+sistema tiene vulnerabilidades de seguridad sin parchear.
+
+Las sustituciones de la granja de construcción oficial están habilitadas por
+defecto cuando se usa la Distribución de sistema Guix (@pxref{Distribución
GNU}). No obstante, están deshabilitadas por defecto cuando se usa
+Guix en una distribución anfitriona, a menos que las haya habilitado
+explícitamente via uno de los pasos recomendados de instalación
+(@pxref{Instalación}). Los siguientes párrafos describen como habilitar o
+deshabilitar sustituciones para la granja oficial de construcción; el mismo
+procedimiento puede usarse para habilitar sustituciones de cualquier otro
+servidor que las proporcione.
+
address@hidden Autorización de servidores de sustituciones
address@hidden Autorización de servidores de sustituciones
+
address@hidden seguridad
address@hidden sustituciones, autorización de las mismas
address@hidden listas de control de acceso (ACL), para sustituciones
address@hidden ACL (listas de control de acceso), para sustituciones
+Para permitir a Guix descargar sustituciones de
address@hidden@value{SUBSTITUTE-SERVER}} o un espejo suyo, debe añadir su clave
+pública a la lista de control de acceso (ACL) de las importaciones de
+archivos, mediante el uso de la orden @command{guix archive}
+(@pxref{Invocación de guix archive}). Hacerlo implica que confía que
address@hidden@value{SUBSTITUTE-SERVER}} no ha sido comprometido y proporciona
+sustituciones genuinas.
+
+La clave pública para @address@hidden se instala junto a
+Guix, en @address@hidden/share/guix/@value{SUBSTITUTE-SERVER}.pub},
+donde @var{prefijo} es el prefij de instalación de Guix. Si ha instalado
+Guix desde las fuentes, debe asegurarse de que comprobó la firma GPG de
address@hidden@value{VERSION}.tar.gz}, el cual contiene el fichero de clave
+pública. Una vez hecho, puede ejecutar algo así:
+
address@hidden
+# guix archive --authorize <
@var{prefijo}/share/guix/@value{SUBSTITUTE-SERVER}.pub
address@hidden example
+
address@hidden Nota
+De manera similar, el fichero @file{hydra.gnu.org.pub} contiene la clave
+pública para una granja de construcción independiente que también es parte
+del proyecto, la cual se puede encontrar en
address@hidden://mirror.hydra.gnu.org}.
address@hidden quotation
+
+Una vez esté autorizada, la salida de una orden como @code{guix build}
+debería cambiar de algo como:
+
address@hidden
+$ guix build emacs --dry-run
+The following derivations would be built:
+ /gnu/store/yr7bnx8xwcayd6j95r2clmkdl1qh688w-emacs-24.3.drv
+ /gnu/store/x8qsh1hlhgjx6cwsjyvybnfv2i37z23w-dbus-1.6.4.tar.gz.drv
+ /gnu/store/1ixwp12fl950d15h2cj11c73733jay0z-alsa-lib-1.0.27.1.tar.bz2.drv
+ /gnu/store/nlma1pw0p603fpfiqy7kn4zm105r5dmw-util-linux-2.21.drv
address@hidden
address@hidden example
+
address@hidden
+a algo así:
+
address@hidden
+$ guix build emacs --dry-run
+112.3 MB would be downloaded:
+ /gnu/store/pk3n22lbq6ydamyymqkkz7i69wiwjiwi-emacs-24.3
+ /gnu/store/2ygn4ncnhrpr61rssa6z0d9x22si0va3-libjpeg-8d
+ /gnu/store/71yz6lgx4dazma9dwn2mcjxaah9w77jq-cairo-1.12.16
+ /gnu/store/7zdhgp0n1518lvfn8mb96sxqfmvqrl7v-libxrender-0.9.7
address@hidden
address@hidden example
+
address@hidden
+Esto indica que las sustituciones de @address@hidden son
+usables y serán descargadas, cuando sea posible, para construcciones
+futuras.
+
address@hidden sustituciones, cómo deshabilitarlas
+El mecanismo de sustituciones puede ser deshabilitado globalmente ejecutando
address@hidden con @code{--no-subsitutes} (@pxref{Invocación de guix-daemon}).
También puede ser deshabilitado temporalmente pasando la
+opción @code{--no-substitutes} a @command{guix package}, @command{guix
+build} y otras herramientas de línea de órdenes.
+
address@hidden Verificación de sustituciones
address@hidden Verificación de sustituciones
+
address@hidden firmas digitales
+Guix detecta y emite errores cuando se intenta usar una sustitución que ha
+sido adulterado. Del mismo modo, ignora las sustituciones que no están
+firmadas, o que no están firmadas por una de las firmas enumeradas en la
+ACL.
+
+No obstante hay una excepción: si un servidor no autorizado proporciona
+sustituciones que son @emph{idénticas bit-a-bit} a aquellas proporcionadas
+por un servidor autorizado, entonces el servidor no autorizado puede ser
+usado para descargas. Por ejemplo, asumiendo que hemos seleccionado dos
+servidores de sustituciones con esta opción:
+
address@hidden
+--substitute-urls="https://a.example.org https://b.example.org";
address@hidden example
+
address@hidden
address@hidden construcciones reproducibles
+Si la ACL contiene únicamente la clave para @code{b.example.org}, y si
address@hidden resulta que proporciona @emph{exactamente las mismas}
+sustituciones, Guix descargará sustituciones de @code{a.example.org} porque
+viene primero en la lista y puede ser considerado un espejo de
address@hidden En la práctica, máquinas de construcción
+independientes producen habitualmente los mismos binarios, gracias a las
+construcciones reproducibles bit-a-bit (véase a continuación).
+
+Cuando se usa HTTPS, el certificado X.509 del servidor @emph{no} se valida
+(en otras palabras, el servidor no está verificado), lo contrario del
+comportamiento habitual de los navegadores Web. Esto es debido a que Guix
+verifica la información misma de las sustituciones, como se ha explicado
+anteriormente, lo cual nos concierne (mientras que los certificados X.509
+tratan de verificar las conexiones entre nombres de dominio y claves
+públicas).
+
address@hidden Configuración de la pasarela.
address@hidden Configuración de la pasarela.
+
address@hidden http_proxy
+Las sustituciones se descargan por HTTP o HTTPS. La variable de entorno
address@hidden puede ser incluida en el entorno de @command{guix-daemon}
+y la respeta para las descargas de sustituciones. Fíjese que el valor de
address@hidden en el entorno en que @command{guix build}, @command{guix
+package} y otras aplicaciones cliente se ejecuten @emph{no tiene ningún
+efecto}.
+
address@hidden Fallos en las sustituciones
address@hidden Fallos en las sustituciones
+
+Incluso cuando una sustitución de una derivación está disponible, a veces el
+intento de sustitución puede fallar. Esto puede suceder por varias razones:
+el servidor de sustituciones puede estar desconectado, la sustitución puede
+haber sido borrada, la conexión puede interrumpirse, etc.
+
+Cuando las sustituciones están activadas y una sustitución para una
+derivación está disponible, pero el intento de sustitución falla, Guix
+intentará construir la derivación localmente dependiendo si se proporcionó
+la opción @code{--fallback} (@pxref{fallback-option,, common build option
address@hidden). Específicamente, si no se pasó @code{--fallback}, no se
+realizarán construcciones locales, y la derivación se considera se considera
+fallida. No obstante, si se pasó @code{--fallback}, Guix intentará construir
+la derivación localmente, y el éxito o fracaso de la derivación depende del
+éxito o fracaso de la construcción local. Fíjese que cuando las
+sustituciones están deshabilitadas o no hay sustituciones disponibles para
+la derivación en cuestión, la construcción local se realizará
address@hidden, independientemente de si se pasó la opción
address@hidden
+
+Para hacerse una idea de cuantas sustituciones hay disponibles en este
+momento, puede intentar ejecutar la orden @command{guix weather}
+(@pxref{Invocación de guix weather}). Esta orden proporciona estadísticas de
las
+sustituciones proporcionadas por un servidor.
+
address@hidden Sobre la confianza en binarios
address@hidden Sobre la confianza en binarios
+
address@hidden confianza, de binarios pre-construidos
+Hoy en día, el control individual sobre nuestra propia computación está a
+merced de instituciones, empresas y grupos con suficiente poder y
+determinación para subvertir la infraestructura de computación y explotar
+sus vulnerabilidades. Mientras que usar las sustituciones de
address@hidden@value{SUBSTITUTE-SERVER}} puede ser conveniente, recomendamos a
las
+usuarias también construir sus paquetes, o incluso mantener su propia granja
+de construcción, de modo que @address@hidden sea un
+objetivo menos interesante. Una manera de ayudar es publicando el software
+que construya usando @command{guix publish} de modo que otras tengan otro
+servidor más como opción para descargar sustituciones (@pxref{Invocación de
guix publish}).
+
+Guix tiene los cimientos para maximizar la reproducibilidad de las
+construcciones (@pxref{Características}). En la mayor parte de los casos,
+construcciones independientes de un paquete o derivación dada deben emitir
+resultados idénticos bit a bit. Por tanto, a través de un conjunto diverso
+de construcciones independientes de paquetes, podemos reforzar la integridad
+de nuestros sistemas. La orden @command{guix challenge} intenta ayudar a las
+usuarias en comprobar servidores de sustituciones, y asiste a las
+desarrolladoras encontrando construcciones no deterministas de paquetes
+(@pxref{Invocación de guix challenge}). Similarmente, la opción
@option{--check}
+de @command{guix build} permite a las usuarias si las sustituciones
+previamente instaladas son genuinas reconstruyendolas localmente
+(@pxref{build-check, @command{guix build --check}}).
+
+En el futuro, queremos que Guix permita la publicación y obtención de
+binarios hacia/desde otras usuarias, entre pares (P2P). En caso de
+interesarle hablar sobre este proyecto, unase a nosotras en
address@hidden@@gnu.org}.
+
address@hidden Paquetes con múltiples salidas
address@hidden Paquetes con múltiples salidas
+
address@hidden paquetes de salida múltiple
address@hidden salidas del paquete
address@hidden salidas
+
+Habitualmente, los paquetes definidos en Guix tienen una @dfn{salida}
+única---es decir, el paquete de fuentes proporcionará exactamente un
+directorio en el almacén. Cuando se ejecuta @command{guix package -i glibc},
+se instala la salida predeterminada del paquete GNU libc; la salida
+predeterminada se llama @code{out}, pero su nombre puede omitirse como se
+mostró en esta orden. En este caso particular, la salida predeterminada de
address@hidden contiene todos ficheros de cabecera C, bibliotecas dinámicas,
+bibliotecas estáticas, documentación Info y otros ficheros auxiliares.
+
+A veces es más apropiado separar varios tipos de ficheros producidos por un
+paquete único de fuentes en salidas separadas. Por ejemplo, la biblioteca C
+GLib (usada por GTK+ y paquetes relacionados) instala más de 20 MiB de
+documentación de referencia como páginas HTML. Para ahorrar espacio para
+usuarias que no la necesiten, la documentación va a una salida separada,
+llamada @code{doc}. Para instalar la salida principal de GLib, que contiene
+todo menos la documentación, se debe ejecutar:
+
address@hidden
+guix package -i glib
address@hidden example
+
address@hidden documentación
+La orden que instala su documentación es:
+
address@hidden
+guix package -i glib:doc
address@hidden example
+
+Algunos paquetes instalan programas con diferentes ``huellas de
+dependencias''. Por ejemplo, el paquete WordNet instala tanto herramientas
+de línea de órdenes como interfaces gráficas de usuaria (IGU). Las primeras
+dependen únicamente de la biblioteca de C, mientras que las últimas dependen
+en Tcl/Tk y las bibliotecas de X subyacentes. En este caso, dejamos las
+herramientas de línea de órdenes en la salida predeterminada, mientras que
+las IGU están en una salida separada. Esto permite a las usuarias que no
+necesitan una IGU ahorrar espacio. La orden @command{guix size} puede ayudar
+a exponer estas situaciones (@pxref{Invocación de guix size}). @command{guix
+graph} también puede ser útil (@pxref{Invocación de guix graph}).
+
+Hay varios de estos paquetes con salida múltiple en la distribución
+GNU. Otros nombres de salida convencionales incluyen @code{lib} para
+bibliotecas y posiblemente ficheros de cabecera, @code{bin} para programas
+independientes y @code{debug} para información de depuración
+(@pxref{Instalación de ficheros de depuración}). La salida de los paquetes se
enumera
+en la tercera columna del resultado de @command{guix package
+--list-available} (@pxref{Invocación de guix package}).
+
+
address@hidden Invocación de guix gc
address@hidden Invocación de @command{guix gc}
+
address@hidden recolector de basura
address@hidden espacio en disco
+Los paquetes instalados, pero no usados, pueden ser @dfn{recolectados}. La
+orden @command{guix gc} permite a las usuarias ejecutar explícitamente el
+recolector de basura para reclamar espacio del directorio
address@hidden/gnu/store}---¡borrar ficheros o directorios manualmente puede
dañar
+el almacén sin reparación posible!
+
address@hidden GC, raíces del recolector de basura
address@hidden raíces del recolector de basura
+El recolector de basura tiene un conjunto de @dfn{raíces} conocidas:
+cualquier fichero en @file{/gnu/store} alcanzable desde una raíz se
+considera @dfn{vivo} y no puede ser borrado; cualquier otro fichero se
+considera @dfn{muerto} y puede ser borrado. El conjunto de raíces del
+recolector de basura (``raíces del GC'' para abreviar) incluye los perfiles
+predeterminados de las usuarias; por defecto los enlaces bajo
address@hidden/var/guix/gcroots} representan dichas raíces. Por ejemplo, nuevas
+raíces del GC pueden añadirse con @command{guix build --root}
+(@pxref{Invocación de guix build}). La orden @command{guix gc --list-roots} las
+enumera.
+
+Antes de ejecutar @code{guix gc --collect-garbage} para liberar espacio,
+habitualmente es útil borrar generaciones antiguas de los perfiles de
+usuaria; de ese modo, las construcciones antiguas de paquetes referenciadas
+por dichas generaciones puede ser reclamada. Esto se consigue ejecutando
address@hidden package --delete-generations} (@pxref{Invocación de guix
package}).
+
+Nuestra recomendación es ejecutar una recolección de basura periódicamente,
+o cuando tenga poco espacio en el disco. Por ejemplo, para garantizar que al
+menos address@hidden están disponibles en su disco, simplemente ejecute:
+
address@hidden
+guix gc -F 5G
address@hidden example
+
+Es completamente seguro ejecutarla como un trabajo periódico no-interactivo
+(@pxref{Ejecución de tareas programadas}, para la configuración de un trabajo
de ese
+tipo). La ejecución de @command{guix gc} sin ningún parámetro recolectará
+tanta basura como se pueda, pero eso es no es normalmente conveniente: puede
+encontrarse teniendo que reconstruir o volviendo a bajar software que está
+``muerto'' desde el punto de vista del recolector pero que es necesario para
+construir otras piezas de software---por ejemplo, la cadena de herramientas
+de compilación.
+
+La orden @command{guix gc} tiene tres modos de operación: puede ser usada
+para recolectar ficheros muertos (predeterminado), para borrar ficheros
+específicos (la opción @code{--delete}), para mostrar información sobre la
+recolección de basura o para consultas más avanzadas. Las opciones de
+recolección de basura son las siguientes:
+
address@hidden @code
address@hidden address@hidden
address@hidden -C address@hidden
+Recolecta basura---es decir, ficheros no alcanzables de @file{/gnu/store} y
+subdirectorios. Esta operación es la predeterminada cuando no se especifican
+opciones.
+
+Cuando se proporciona @var{min}, para una vez que @var{min} bytes han sido
+recolectados. @var{min} puede ser un número de bytes, o puede incluir una
+unidad como sufijo, como @code{MiB} para mebibytes y @code{GB} para
+gigabytes (@pxref{Block size, size specifications,, coreutils, GNU
+Coreutils}).
+
+Cuando se omite @var{min}, recolecta toda la basura.
+
address@hidden address@hidden
address@hidden -F @var{libre}
+Recolecta basura hasta que haya espacio @var{libre} bajo @file{/gnu/store},
+si es posible: @var{libre} denota espacio de almacenamiento, por ejemplo
address@hidden, como se ha descrito previamente.
+
+Cuando @var{libre} o más está ya disponible en @file{/gnu/store}, no hace
+nada y sale inmediatamente.
+
address@hidden address@hidden
address@hidden -d address@hidden
+Antes de comenzar el proceso de recolección de basura, borra todas las
+generaciones anteriores a @var{duración}, para todos los perfiles de la
+usuaria; cuando se ejecuta como root esto aplica a los perfiles de
address@hidden las usuarias}.
+
+Por ejemplo, esta orden borra todas las generaciones de todos sus perfiles
+que tengan más de 2 meses de antigüedad (excepto generaciones que sean las
+actuales), y una vez hecho procede a liberar espacio hasta que al menos 10
+GiB estén disponibles:
+
address@hidden
+guix gc -d 2m -F 10G
address@hidden example
+
address@hidden --delete
address@hidden -D
+Intenta borrar todos los ficheros del almacén y directorios especificados
+como parámetros. Esto falla si alguno de los ficheros no están en el
+almacén, o todavía están vivos.
+
address@hidden --list-failures
+Enumera los elementos del almacén correspondientes a construcciones fallidas
+existentes en la caché.
+
+Esto no muestra nada a menos que el daemon se haya ejecutado pasando
address@hidden (@pxref{Invocación de guix-daemon,
address@hidden).
+
address@hidden --list-roots
+Enumera las raices del recolector de basura poseidas por la usuaria; cuando
+se ejecuta como root, enumera @emph{todas} las raices del recolector de
+basura.
+
address@hidden --clear-failures
+Borra los elementos especificados del almacén de la caché de construcciones
+fallidas.
+
+De nuevo, esta opción únicamente tiene sentido cuando el daemon se inicia
+con @option{--cache-failures}. De otro modo, no hace nada.
+
address@hidden --list-dead
+Muestra la lista de ficheros y directorios muertos todavía presentes en el
+almacén---es decir, ficheros y directorios que ya no se pueden alcanzar
+desde ninguna raíz.
+
address@hidden --list-live
+Muestra la lista de ficheros y directorios del almacén vivos.
+
address@hidden table
+
+Además, las referencias entre los ficheros del almacén pueden ser
+consultadas:
+
address@hidden @code
+
address@hidden --references
address@hidden --referrers
address@hidden dependencias de un paquete
+Enumera las referencias (o, respectivamente, los referentes) de los ficheros
+del almacén pasados como parámetros.
+
address@hidden --requisites
address@hidden -R
address@hidden clausura
+Enumera los requistos los ficheros del almacén pasados como parámetros. Los
+requisitos incluyen los mismos ficheros del almacén, sus referencias, las
+referencias de estas, recursivamente. En otras palabras, la lista devuelta
+es la @dfn{clausura transitiva} de los ficheros del almacén.
+
address@hidden de guix size}, para una herramienta que perfila el tamaño de la
+clausura de un elemento. @xref{Invocación de guix graph}, para una herramienta
de
+visualización del grafo de referencias.
+
address@hidden --derivers
address@hidden derivación
+Devuelve la/s derivación/es que conducen a los elementos del almacén dados
+(@pxref{Derivaciones}).
+
+Por ejemplo, esta orden:
+
address@hidden
+guix gc --derivers `guix package -I ^emacs$ | cut -f4`
address@hidden example
+
address@hidden
+devuelve el/los fichero/s @file{.drv} que conducen al paquete @code{emacs}
+instalado en su perfil.
+
+Fíjese que puede haber cero ficheros @file{.drv} encontrados, por ejemplo
+porque estos ficheros han sido recolectados. Puede haber más de un fichero
address@hidden encontrado debido a derivaciones de salida fija.
address@hidden table
+
+Por último, las siguientes opciones le permiten comprobar la integridad del
+almacén y controlar el uso del disco.
+
address@hidden @option
+
address@hidden address@hidden
address@hidden integridad, del almacén
address@hidden comprobación de integridad
+Verifica la integridad del almacén.
+
+Por defecto, comprueba que todos los elementos del almacén marcados como
+válidos en la base de datos del daemon realmente existen en
address@hidden/gnu/store}.
+
+Cuando se proporcionan, @var{opciones} debe ser una lista separada por comas
+que contenga uno o más valores @code{contents} and @code{repair}.
+
+Cuando se usa @option{--verify=contents}, el daemon calcula el hash del
+contenido de cada elemento del almacén y lo compara contra el hash de su
+base de datos. Las incongruencias se muestran como corrupciones de
+datos. Debido a que recorre @emph{todos los ficheros del almacén}, esta
+orden puede tomar mucho tiempo, especialmente en sistemas con una unidad de
+disco lenta.
+
address@hidden reparar el almacén
address@hidden corrupción, recuperarse de
+El uso de @option{--verify=repair} o @option{--verify=contents,repair} hace
+que el daemon intente reparar elementos corruptos del almacén obteniendo
+sustituciones para dichos elementos (@pxref{Sustituciones}). Debido a que la
+reparación no es atómica, y por tanto potencialmente peligrosa, está
+disponible únicamente a la administradora del sistema. Una alternativa
+ligera, cuando sabe exactamente qué elementos del almacén están corruptos,
+es @command{guix build --repair} (@pxref{Invocación de guix build}).
+
address@hidden --optimize
address@hidden deduplicación
+Optimiza el almacén sustituyendo ficheros idénticos por enlaces duros---esto
+es la @dfn{deduplicación}.
+
+El daemon realiza la deduplicación después de cada construcción
+satisfactoria o importación de archivos, a menos que se iniciase con
address@hidden (@pxref{Invocación de guix-daemon,
address@hidden). Por tanto, esta opción es útil
+primariamente cuando el daemon se estaba ejecutando con
address@hidden
+
address@hidden table
+
address@hidden Invocación de guix pull
address@hidden Invocación de @command{guix pull}
+
address@hidden actualizar Guix
address@hidden actualizar la versión de Guix
address@hidden @command{guix pull}
address@hidden pull
+Los paquetes se instalan o actualizan con la última versión disponible en la
+distribución disponible actualmente en su máquina local. Para actualizar
+dicha distribución, junto a las herramientas de Guix, debe ejecutar
address@hidden pull}: esta orden descarga el último código fuente de Guix y
+descripciones de paquetes, y lo despliega. El código fuente se descarga de
+un repositorio @uref{https://git-scm.com, Git}, por defecto el repositorio
+oficial de address@hidden, lo que no obstante puede ser personalizado.
+
+Una vez completada, @command{guix package} usará paquetes y versiones de
+paquetes de esta copia recién obtenida de Guix. No solo eso, sino que todas
+las órdenes de Guix y los módulos Scheme también se tomarán de la última
+versión. Nuevas sub-órdenes @command{guix} incorporadas por la actualización
+también estarán disponibles.
+
+Cualquier usuaria puede actualizar su copia de Guix usando @command{guix
+pull}, y el efecto está limitado a la usuaria que ejecutó @command{guix
+pull}. Por ejemplo, cuando la usuaria @code{root} ejecuta @command{guix
+pull}, esto no tiene ningún efecto en la versión del Guix que la usuaria
address@hidden ve, y viceversa.
+
+El resultado de ejecutar @command{guix pull} es un @dfn{perfil} disponible
+bajo @file{~/.config/guix/current} conteniendo el último Guix. Por tanto,
+asegurese de añadirlo al inicio de sus rutas de búsqueda de modo que use la
+última versión, de modo similar para el manual Info(@pxref{Documentación}).
+
address@hidden
+export PATH="$HOME/.config/guix/current/bin:$PATH"
+export INFOPATH="$HOME/.config/guix/current/share/info:$INFOPATH"
address@hidden example
+
+Las opciones @code{--list-generations} o @code{-l} enumeran las generaciones
+pasadas producidas por @command{guix pull}, junto a detalles de su
+procedencia:
+
address@hidden
+$ guix pull -l
+Generation 1 Jun 10 2018 00:18:18
+ guix 65956ad
+ repository URL: https://git.savannah.gnu.org/git/guix.git
+ branch: origin/master
+ commit: 65956ad3526ba09e1f7a40722c96c6ef7c0936fe
+
+Generation 2 Jun 11 2018 11:02:49
+ guix e0cc7f6
+ repository URL: https://git.savannah.gnu.org/git/guix.git
+ branch: origin/master
+ commit: e0cc7f669bec22c37481dd03a7941c7d11a64f1d
+ 2 new packages: keepalived, libnfnetlink
+ 6 packages upgraded: emacs-nix-mode@@2.0.4,
+ guile2.0-guix@@0.14.0-12.77a1aac, guix@@0.14.0-12.77a1aac,
+ heimdal@@7.5.0, milkytracker@@1.02.00, nix@@2.0.4
+
+Generation 3 Jun 13 2018 23:31:07 (current)
+ guix 844cc1c
+ repository URL: https://git.savannah.gnu.org/git/guix.git
+ branch: origin/master
+ commit: 844cc1c8f394f03b404c5bb3aee086922373490c
+ 28 new packages: emacs-helm-ls-git, emacs-helm-mu, @dots{}
+ 69 packages upgraded: borg@@1.1.6, cheese@@3.28.0, @dots{}
address@hidden example
+
address@hidden de guix describe, @command{guix describe}}, para otras formas de
+describir el estado actual de Guix.
+
+El perfil @code{~/.config/guix/current} funciona como cualquier otro perfil
+creado por @command{guix package} (@pxref{Invocación de guix package}). Esto
es,
+puede enumerar generaciones, volver a una generación previa---es decir, el
+Guix anterior---y más:
+
address@hidden
+$ guix package -p ~/.config/guix/current --roll-back
+switched from generation 3 to 2
+$ guix package -p ~/.config/guix/current --delete-generations=1
+deleting /var/guix/profiles/per-user/carlos/current-guix-1-link
address@hidden example
+
+La orden @command{guix pull} se invoca habitualmente sin parámetros, pero
+permite las siguientes opciones:
+
address@hidden @code
address@hidden address@hidden
address@hidden address@hidden
address@hidden address@hidden
+Download code for the @code{guix} channel from the specified @var{url}, at
+the given @var{commit} (a valid Git commit ID represented as a hexadecimal
+string), or @var{branch}.
+
address@hidden @file{channels.scm}, fichero de configuración
address@hidden fichero de configuración de canales
+Estas opciones se proporcionan por conveniencia, pero también puede
+especificar su configuración en el fichero
address@hidden/.config/guix/channels.scm} o usando la opción @option{--channels}
+(vea más adelante).
+
address@hidden address@hidden
address@hidden -C @var{fichero}
+Lee la lista de canales de @var{fichero} en vez de
address@hidden/.config/guix/channels.scm}. @var{fichero} debe contener código
+Scheme que evalue a una lista de objetos channel. @xref{Canales}, para más
+información.
+
address@hidden --news
address@hidden -N
+Display the list of packages added or upgraded since the previous
+generation.
+
+This is the same information as displayed upon @command{guix pull}
+completion, but without ellipses; it is also similar to the output of
address@hidden pull -l} for the last generation (see below).
+
address@hidden address@hidden
address@hidden -l address@hidden
+Enumera todas las generaciones de @file{~/.config/guix/current} o, si se
+proporciona un @var{patrón}, el subconjunto de generaciones que correspondan
+con el @var{patrón}. La sintaxis de @var{patrón} es la misma que @code{guix
+package --list-generations} (@pxref{Invocación de guix package}).
+
address@hidden de guix describe}, para una forma de mostrar información sobre
+únicamente la generación actual.
+
address@hidden address@hidden
address@hidden -p @var{perfil}
+Usa @var{perfil} en vez de @file{~/.config/guix/current}.
+
address@hidden --dry-run
address@hidden -n
+Muestra qué revisión/es del canal serían usadas y qué se construiría o
+sustituiría, sin efectuar ninguna acción real.
+
address@hidden address@hidden
address@hidden -s @var{sistema}
+Intenta construir paquetes para @var{sistema}---por ejemplo,
address@hidden vez del tipo de sistema de la máquina de
+construcción.
+
address@hidden --verbose
+Produce salida prolija, escribiendo los logs de construcción por la salida
+de error estándar.
+
address@hidden --bootstrap
+Use el Guile usado para el lanzamiento para construir el último Guix. Esta
+opción es útil para las desarrolladoras de Guix únicamente.
address@hidden table
+
+El mecanismo de @dfn{canales} le permite instruir a @command{guix pull} de
+qué repositorio y rama obtener los datos, así como repositorios
address@hidden que contengan módulos de paquetes que deben ser
+desplegados. @xref{Canales}, para más información.
+
+Además, @command{guix pull} acepta todas las opciones de construcción
+comunes (@pxref{Opciones comunes de construcción}).
+
address@hidden Canales
address@hidden Canales
+
address@hidden channels
address@hidden @file{channels.scm}, fichero de configuración
address@hidden fichero de configuración de canales
address@hidden @command{guix pull}, fichero de configuración
address@hidden configuración de @command{guix pull}
+Guix y su colección de paquetes son actualizados ejecutando @command{guix
+pull} (@pxref{Invocación de guix pull}). Por defecto @command{guix pull}
descarga
+y despliega el mismo Guix del repositorio oficial de address@hidden Esto
+puede ser personalizado definiendo @dfn{canales} en el fichero
address@hidden/.config/guix/channels.scm}. Un canal especifica una URL y una
rama
+de un repositorio Git para ser desplegado, y @command{guix pull} puede ser
+instruido para tomar los datos de uno o más canales. En otras palabras, los
+canales se pueden usar para @emph{personalizar} y para @emph{extender} Guix,
+como vemos a continuación.
+
address@hidden Uso de un canal de Guix personalizado
+
+El canal llamado @code{guix} especifica de donde el mismo Guix---sus
+herramientas de línea de órdenes y su colección de paquetes---debe ser
+descargado. Por ejemplo, suponga que quiere actualizar de su propia copia
+del repositorio Guix en @code{example.org}, y específicamente la rama
address@hidden, para ello puede escribir en
address@hidden/.config/guix/channels.scm} esta especificación:
+
address@hidden
+;; Le dice a 'guix pull' que use mi propio repositorio.
+(list (channel
+ (name 'guix)
+ (url "https://example.org/mi-guix.git";)
+ (branch "super-hacks")))
address@hidden lisp
+
address@hidden
+De aquí en adelante, @command{guix pull} obtendrá el código de la rama
address@hidden del repositorio en @code{example.org}.
+
address@hidden Especificación de canales adicionales
+
address@hidden extender la colección de paquetes (canales)
address@hidden paquetes personales (canales)
address@hidden canales, para paquetes personales
+También puede especificar @emph{canales adicionales} de los que obtener
+datos. Digamos que tiene un montón de variaciones personalizadas de paquetes
+que piensa que no tiene mucho sentido contribuir al proyecto Guix, pero
+quiere tener esos paquetes disponibles transparentemente en su línea de
+órdenes. Primero escribiría módulos que contengan esas definiciones de
+paquete (@pxref{Módulos de paquetes}), los mantendría en un repositorio Git, y
+entonces usted y cualquier otra persona podría usarlos como un canal
+adicional del que obtener paquetes. Limpio, ¿no?
+
address@hidden What follows stems from discussions at
address@hidden <https://debbugs.gnu.org/cgi/bugreport.cgi?bug=22629#134> as
well as
address@hidden earlier discussions on address@hidden
address@hidden Aviso
+Antes de que, querida usuaria, grite---``¡Guau, esto es @emph{la
+caña}!''---y publique su canal personal al mundo, nos gustaría compartir
+algunas palabras de precaución:
+
address@hidden
address@hidden
+Antes de publicar un canal, por favor considere contribuir sus definiciones
+de paquete al propio Guix (@pxref{Contribuir}). Guix como proyecto es
+abierto a software libre de todo tipo, y los paquetes en el propio Guix
+están disponibles para todas las usuarias de Guix y se benefician del
+proceso de gestión de calidad del proyecto.
+
address@hidden
+Cuando mantiene definiciones de paquete fuera de Guix, nosotras, las
+desarrolladoras de Guix, consideramos que @emph{la carga de la
+compatibilidad cae de su lado}. Recuerde que los módulos y definiciones de
+paquetes son solo código Scheme que usa varias interfaces programáticas
+(APIs). Queremos mantener la libertad de cambiar dichas interfaces para
+seguir mejorando Guix, posiblemente en formas que pueden romper su
+canal. Nunca cambiamos las interfaces gratuitamente, pero @emph{no} vamos
+tampoco a congelar las interfaces.
+
address@hidden
+Corolario: si está usando un canal externo y el canal se rompe, por favor
address@hidden del problema a las autoras del canal}, no al proyecto Guix.
address@hidden itemize
+
+¡Ha quedado advertida! Habiendo dicho esto, creemos que los canales externos
+son una forma práctica de ejercitar su libertad para aumentar la colección
+de paquetes de Guix y compartir su mejoras, que son pilares básicos del
address@hidden://www.gnu.org/philosophy/free-sw.html, software libre}. Por
+favor, envíenos un correo a @email{guix-devel@@gnu.org} si quiere hablar
+sobre esto.
address@hidden quotation
+
+Para usar un canal, escriba en @code{~/.config/guix/channels.scm} para
+instruir a @command{guix pull} para obtener datos de él @emph{además} de los
+canales Guix predeterminados:
+
address@hidden %default-channels
address@hidden
+;; Añade mis paquetes personales a aquellos que Guix provee.
+(cons (channel
+ (name 'mis-paquetes-personales)
+ (url "https://example.org/paquetes-personales.git";))
+ %default-channels)
address@hidden lisp
+
address@hidden
+Fíjese que el fragmento previo es (¡como siempre!)@: código Scheme; usamos
address@hidden para añadir un canal a la lista de canales a la que la variable
address@hidden hace referencia (@pxref{Pairs, @code{cons} and
+lists,, guile, GNU Guile Reference Manual}). Con el fichero en este lugar,
address@hidden pull} no solo construye Guix sino también los módulos de
+paquetes de su propio repositorio. El resultado en
address@hidden/.config/guix/current} es la unión de Guix con sus propios
módulos de
+paquetes:
+
address@hidden
+$ guix pull --list-generations
address@hidden
+Generation 19 Aug 27 2018 16:20:48
+ guix d894ab8
+ repository URL: https://git.savannah.gnu.org/git/guix.git
+ branch: master
+ commit: d894ab8e9bfabcefa6c49d9ba2e834dd5a73a300
+ mis-paquetes-personales dd3df5e
+ repository URL: https://example.org/paquetes-personales.git
+ branch: master
+ commit: dd3df5e2c8818760a8fc0bd699e55d3b69fef2bb
+ 11 new packages: mi-gimp, mi-emacs-con-cosas, @dots{}
+ 4 packages upgraded: emacs-racket-mode@@0.0.2-2.1b78827, @dots{}
address@hidden example
+
address@hidden
+La salida de @command{guix pull} previa muestra que la address@hidden
+incluye tanto Guix como paquetes del canal
address@hidden Entre los paquetes nuevos y actualizados que
+son enumerados, algunos como @code{mi-gimp} y @code{mi-emacs-con-cosas}
+pueden venir de @code{mis-paquetes-personales}, mientras que otros vienen
+del canal predeterminado de Guix.
+
+Para crear uncanal, cree un repositorio Git que contenga sus propios módulos
+de paquetes y haga que esté disponible. El repositorio puede contener
+cualquier cosa, pero un canal útil contendrá módulos Guile que exportan
+paquetes. Una vez comience a usar un canal, Guix se comportará como si el
+directorio raíz del repositorio Git de dicho canal hubiese sido añadido a la
+ruta de carga de Guile (@pxref{Load Paths,,, guile, GNU Guile Reference
+Manual}). Por ejemplo, si su canal contiene un fichero en
address@hidden/mis-herramientas.scm} que define un módulo, entonces
+dicho módulo estará disponible bajo el nombre @code{(mis-paquetes
+mis-herramientas)}, y podrá usarlo como cualquier otro módulo
+(@pxref{Módulos,,, guile, GNU Guile Reference Manual}).
+
address@hidden dependencias, canales
address@hidden metadatos, canales
address@hidden Declaración de dependencias de canales
+
+Las autoras de canales pueden decidir aumentar una colección de paquetes
+proporcionada por otros canales. Pueden declarar su canal como dependiente
+de otros canales en el fichero de metadatos @file{.guix-channel}, que debe
+encontrarse en la raíz del repositorio del canal.
+
+Este fichero de metadatos debe contener una expresión-S simple como esta:
+
address@hidden
+(channel
+ (version 0)
+ (dependencies
+ (channel
+ (name una-coleccion)
+ (url "https://example.org/primera-coleccion.git";))
+ (channel
+ (name otra-coleccion)
+ (url "https://example.org/segunda-coleccion.git";)
+ (branch "pruebas"))))
address@hidden lisp
+
+En el ejemplo previo, este canal se declara como dependiente de otros dos
+canales, que se obtendrán de manera automática. Los módulos proporcionados
+por el canal se compilarán en un entorno donde los módulos de todos estos
+canales declarados estén disponibles.
+
+De cara a la confianza proporcionada y el esfuerzo que supondrá su
+mantenimiento, debería evitar depender de canales que no controle, y debería
+intentar minimizar el número de dependencias.
+
address@hidden Replicación de Guix
+
address@hidden clavar, canales
address@hidden replicar Guix
address@hidden reproducibilidad, de Guix
+La salida de @command{guix pull --list-generations} previa muestra
+precisamente qué revisiones se usaron para construir esta instancia de
+Guix. Por tanto podemos replicarla, digamos, en otra máquina, proporcionando
+una especificaciones de canales en @file{~/.config/guix/channels.scm} que
+está ``clavada'' en estas revisiones:
+
address@hidden
+;; Despliega unas revisiones específicas de mis canales de interés.
+(list (channel
+ (name 'guix)
+ (url "https://git.savannah.gnu.org/git/guix.git";)
+ (commit "d894ab8e9bfabcefa6c49d9ba2e834dd5a73a300"))
+ (channel
+ (name 'mis-paquetes-personales)
+ (url "https://example.org/paquetes-personales.git";)
+ (branch "dd3df5e2c8818760a8fc0bd699e55d3b69fef2bb")))
address@hidden lisp
+
+La orden @command{guix describe --format=channels} puede incluso generar
+esta lista de canales directamente (@pxref{Invocación de guix describe}).
+
+En este punto las dos máquinas ejecutan @emph{exactamente el mismo Guix},
+con acceso a @emph{exactamente los mismos paquetes}. La salida de
address@hidden build gimp} en una máquina debe ser exactamente la misma, bit
+a bit, que la salida de la misma orden en la otra máquina. Esto también
+significa que ambas máquinas tienen acceso a todo el código fuente de Guix
+y, transitiamente, a todo el código fuente de cada paquete que define.
+
+Esto le proporciona superpoderes, permitiendole seguir la pista de la
+procedencia de los artefactos binarios con un grano muy fino, y reproducir
+entornos de software a su voluntad---un tipo de capacidad de
+``meta-reproducibilidad'', si lo desea. @xref{Inferiores}, para otro modo de
+tomar ventaja de estos superpoderes.
+
address@hidden Inferiores
address@hidden Inferiores
+
address@hidden TODO: Remove this once we're more confident about API stability.
address@hidden Nota
+La funcionalidad descrita aquí es una ``versión de evaluación tecnológica''
+en la versión @value{VERSION}. Como tal, la interfaz está sujeta a cambios.
address@hidden quotation
+
address@hidden inferiores
address@hidden composición de revisiones de Guix
+A veces necesita mezclar paquetes de revisiones de la revisión de Guix que
+está ejecutando actualmente con paquetes disponibles en una revisión
+diferente. Los @dfn{inferiores} de Guix le permiten conseguirlo componiendo
+diferentes revisiones de Guix de modo arbitrario.
+
address@hidden paquetes inferiores
+Técnicamente, un ``inferior'' es esencialmente un proceso Guix separado
+conectado con su Guix principal a través de una sesión interactiva
+(@pxref{Invocación de guix repl}). El módulo @code{(guix inferior)} le permite
+crear inferiores y comunicarse con ellos. También proporciona una interfaz
+de alto nivel para buscar y manipular los paquetes que un inferior
address@hidden de inferiores}.
+
+Cuando se combina con los canales (@pxref{Canales}), los inferiores
+proporcionan una forma simple de interactuar con una revisión separada de
+Guix. Por ejemplo, asumamos que desea instalar en su perfil el paquete
address@hidden actual, junto al paquete @code{guile-json} como existía en una
+revisión más antigua de Guix---quizá porque las versiones nuevas de
address@hidden tienen un API incompatible y quiere ejecutar su código
+contra la API antigua. Para hacerlo, puede escribir un manifiesto para
+usarlo con @code{guix package --manifest} (@pxref{Invocación de guix package});
+en dicho manifiesto puede crear un inferior para esa versión antigua de Guix
+que le interesa, y buscará el paquete @code{guile-json} en el inferior:
+
address@hidden
+(use-modules (guix inferior) (guix channels)
+ (srfi srfi-1)) ;para 'first'
+
+(define channels
+ ;; Esta es la revisión antigua de donde queremos
+ ;; extraer guile-json.
+ (list (channel
+ (name 'guix)
+ (url "https://git.savannah.gnu.org/git/guix.git";)
+ (commit
+ "65956ad3526ba09e1f7a40722c96c6ef7c0936fe"))))
+
+(define inferior
+ ;; Un inferior que representa la revisión previa.
+ (inferior-for-channels channels))
+
+;; Ahora crea un manifiesto con el paquete "guile" actual
+;; y el antiguo paquete "guile-json".
+(packages->manifest
+ (list (first (lookup-inferior-packages inferior "guile-json"))
+ (specification->package "guile")))
address@hidden lisp
+
+En su primera ejecución, @command{guix package --manifest} puede tener que
+construir el canal que especificó antes de crear el inferior; las siguientes
+ejecuciones serán mucho más rápidas porque la revisión de Guix estará en la
+caché.
+
+El módulo @code{(guix inferior)} proporciona los siguientes procedimientos
+para abrir un inferior:
+
address@hidden {Procedimiento Scheme} inferior-for-channels @var{canales} @
+ [#:cache-directory] [#:ttl]
+Devuelve un inferior para @var{canales}, una lista de canales. Usa la caché
+en @var{cache-directory}, donde las entradas pueden ser reclamadas después
+de @var{ttl} segundos. Este procedimiento abre una nueva conexión al daemon
+de construcción.
+
+Como efecto secundario, este procedimiento puede construir o sustituir
+binarios para @var{canales}, lo cual puede tomar cierto tiempo.
address@hidden deffn
+
address@hidden {Procedimiento Scheme} open-inferior @var{directorio} @
+ [#:command "bin/guix"]
+Abre el Guix inferior en @var{directorio}, ejecutando
address@hidden@var{directorio}/@var{command} repl} o su equivalente. Devuelve
address@hidden si el inferior no pudo ser ejecutado.
address@hidden deffn
+
address@hidden paquetes inferiores
+Los procedimientos enumerados a continuación le permiten obtener y manipular
+paquetes de inferiores.
+
address@hidden {Procedimiento Scheme} inferior-packages @var{inferior}
+Devuelve la lista de paquetes conocida por @var{inferior}.
address@hidden deffn
+
address@hidden {Procedimiento Scheme} lookup-inferior-packages @var{inferior}
@var{nombre} @
+ address@hidden
+Devuelve la lista ordenada de paquetes del inferior que corresponden con
address@hidden en @var{inferior}, con los números de versión más altos
+primero. Si @var{versión} tiene un valor verdadero, devuelve únicamente
+paquetes con un número de versión cuyo prefijo es @var{versión}.
address@hidden deffn
+
address@hidden {Procedimiento Scheme} inferior-package? @var{obj}
+Devuelve verdadero si @var{obj} es un paquete inferior.
address@hidden deffn
+
address@hidden {Procedimiento Scheme} inferior-package-name @var{paquete}
address@hidden {Procedimiento Scheme} inferior-package-version @var{paquete}
address@hidden {Procedimiento Scheme} inferior-package-synopsis @var{paquete}
address@hidden {Procedimiento Scheme} inferior-package-description @var{paquete}
address@hidden {Procedimiento Scheme} inferior-package-home-page @var{paquete}
address@hidden {Procedimiento Scheme} inferior-package-location @var{paquete}
address@hidden {Procedimiento Scheme} inferior-package-inputs @var{paquete}
address@hidden {Procedimiento Scheme} inferior-package-native-inputs
@var{paquete}
address@hidden {Procedimiento Scheme} inferior-package-propagated-inputs
@var{paquete}
address@hidden {Procedimiento Scheme}
inferior-package-transitive-propagated-inputs @var{paquete}
address@hidden {Procedimiento Scheme} inferior-package-native-search-paths
@var{paquete}
address@hidden {Procedimiento Scheme}
inferior-package-transitive-native-search-paths @var{paquete}
address@hidden {Procedimiento Scheme} inferior-package-search-paths
@var{paquete}
+Estos procedimientos son la contraparte de los accesos a los registros de
+pquete (@pxref{Referencia de ``package''}). La mayor parte funcionan
interrogando al
+inferior del que @var{paquete} viene, por lo que el inferior debe estar vivo
+cuando llama a dichos procedimientos.
address@hidden deffn
+
+Los paquetes de inferiores pueden ser usados transparentemente como
+cualquier otro paquete u objeto-tipo-fichero en expresiones-G
+(@pxref{Expresiones-G}). También se manejan transparentemente por el
+procedimiento @code{packages->manifest}, el cual se usa habitualmente en los
+manifiestos (@pxref{Invocación de guix package, the @option{--manifest} option
of
address@hidden package}}). Por tanto puede insertar un paquete de inferior
+prácticamente en cualquier lugar que pueda insertar un paquete normal: en
+manifiestos, en el campo @code{packages} de su declaración
address@hidden, etcétera.
+
address@hidden Invocación de guix describe
address@hidden Invocación de @command{guix describe}
+
address@hidden reproducibilidad
address@hidden replicar Guix
+A menudo desea responder a preguntas como: ``¿Qué revisión de Guix estoy
+usando?'' o ``¿Qué canales estoy usando?'' Esto es una información muy útil
+en muchas situaciones: si quiere @emph{replicar} un entorno en una máquina
+diferente o cuenta de usuaria, si desea informar de un error o determinar
+qué cambio en los canales que usa lo causó, o si quiere almacenar el estado
+de su sistema por razones de reproducibilidad. La orden @command{guix
+describe} responde a estas preguntas.
+
+Cuando se ejecuta desde un @command{guix} bajado con @command{guix pull},
address@hidden describe} muestra el/los canal/es desde el/los que se
+construyó, incluyendo la URL de su repositorio y los IDs de las revisiones
+(@pxref{Canales}):
+
address@hidden
+$ guix describe
+Generation 10 Sep 03 2018 17:32:44 (current)
+ guix e0fa68c
+ repository URL: https://git.savannah.gnu.org/git/guix.git
+ branch: master
+ commit: e0fa68c7718fffd33d81af415279d6ddb518f727
address@hidden example
+
+Si está familiarizado con el sistema de control de versiones Git, esto es
+similar a @command{git describe}; la salida también es similar a la de
address@hidden pull --list-generations}, pero limitada a la generación actual
+(@pxref{Invocación de guix pull, the @option{--list-generations} option}).
Debido
+a que el ID de revisión Git mostrado antes refiere sin ambigüedades al
+estado de Guix, esta información es todo lo necesario para describir la
+revisión de Guix que usa, y también para replicarla.
+
+Para facilitar la replicación de Guix, también se le puede solicitar a
address@hidden describe} devolver una lista de canales en vez de la
+descripción legible por humanos mostrada antes:
+
address@hidden
+$ guix describe -f channels
+(list (channel
+ (name 'guix)
+ (url "https://git.savannah.gnu.org/git/guix.git";)
+ (commit
+ "e0fa68c7718fffd33d81af415279d6ddb518f727")))
address@hidden example
+
address@hidden
+Puede almacenar esto en un fichero y pasarselo a @command{guix pull -C} en
+otra máquina o en un momento futuro, lo cual instanciará @emph{esta revisión
+exacta de Guix} (@pxref{Invocación de guix pull, the @option{-C} option}). De
+aquí en adelante, ya que puede desplegar la misma revisión de Guix, puede
+también @emph{replicar un entorno completo de software}. Nosotras
+humildemente consideramos que esto es @emph{impresionante}, ¡y esperamos que
+le guste a usted también!
+
+Los detalles de las opciones aceptadas por @command{guix describe} son las
+siguientes:
+
address@hidden @code
address@hidden address@hidden
address@hidden -f @var{formato}
+Produce salida en el @var{formato} especificado, uno de:
+
address@hidden @code
address@hidden human
+produce salida legible por humanos;
address@hidden channels
+produce una lista de especificaciones de canales que puede ser pasada a
address@hidden pull -C} o instalada como @file{~/.config/guix/channels.scm}
+(@pxref{Invocación de guix pull});
address@hidden json
address@hidden JSON
+produce una lista de especificaciones de canales en formato JSON;
address@hidden recutils
+produce una lista de especificaciones de canales en formato Recutils.
address@hidden table
+
address@hidden address@hidden
address@hidden -p @var{perfil}
+Muestra información acerca del @var{perfil}.
address@hidden table
+
address@hidden Invocación de guix archive
address@hidden Invocación de @command{guix archive}
+
address@hidden @command{guix archive}
address@hidden archive
+La orden @command{guix archive} permite a las usuarias @dfn{exportar}
+ficheros del almacén en un único archivador, e @dfn{importarlos}
+posteriormente en una máquina que ejecute Guix. En particular, permite que
+los ficheros del almacén sean transferidos de una máquina al almacén de otra
+máquina.
+
address@hidden Nota
+Si está buscando una forma de producir archivos en un formato adecuado para
+herramientas distintas a Guix, @pxref{Invocación de guix pack}.
address@hidden quotation
+
address@hidden exportar elementos del almacén
+Para exportar ficheros del almacén como un archivo por la salida estándar,
+ejecute:
+
address@hidden
+guix archive --export @var{opciones} @var{especificaciones}...
address@hidden example
+
address@hidden deben ser o bien nombres de ficheros del almacén o
+especificaciones de paquetes, como las de @command{guix package}
+(@pxref{Invocación de guix package}). Por ejemplo, la siguiente orden crea un
+archivo que contiene la salida @code{gui} del paquete @code{git} y la salida
+principal de @code{emacs}:
+
address@hidden
+guix archive --export git:gui /gnu/store/...-emacs-24.3 > great.nar
address@hidden example
+
+Si los paquetes especificados no están todavía construidos, @command{guix
+archive} los construye automáticamente. El proceso de construcción puede
+controlarse mediante las opciones de construcción comunes (@pxref{Opciones
comunes de construcción}).
+
+Para transferir el paquete @code{emacs} a una máquina conectada por SSH, se
+ejecutaría:
+
address@hidden
+guix archive --export -r emacs | ssh otra-maquina guix archive --import
address@hidden example
+
address@hidden
+De manera similar, un perfil de usuaria completo puede transferirse de una
+máquina a otra de esta manera:
+
address@hidden
+guix archive --export -r $(readlink -f ~/.guix-profile) | \
+ ssh otra-maquina guix-archive --import
address@hidden example
+
address@hidden
+No obstante, fíjese que, en ambos ejemplos, todo @code{emacs} y el perfil
+como también todas sus dependencias son transferidas (debido a la
address@hidden), independiente de lo que estuviese ya disponible en el almacén
de
+la máquina objetivo. La opción @code{--missing} puede ayudar a esclarecer
+qué elementos faltan en el almacén objetivo. La orden @command{guix copy}
+simplifica y optimiza este proceso completo, así que probablemente es lo que
+debería usar en este caso (@pxref{Invocación de guix copy}).
+
address@hidden nar, formato de archivo
address@hidden archivo normalizado (nar)
+Los archivos se almacenan en el formato de ``archivo normalizado'' o
+``nar'', el cual es comparable a `tar' en el espíritu, pero con diferencias
+que lo hacen más apropiado para nuestro propósito. Primero, en vez de
+almacenar todos los metadatos Unix de cada fichero, el formato nar solo
+menciona el tipo de fichero (normal, directorio o enlace simbólico); los
+permisos Unix y el par propietario/grupo se descartan. En segundo lugar, el
+orden en el cual las entradas de directorios se almacenan siempre siguen el
+orden de los nombres de ficheros de acuerdo a la ordenación de cadenas en la
+localización C. Esto hace la producción del archivo completamente
+determinista.
+
address@hidden FIXME: Add xref to daemon doc about signatures.
+Durante la exportación, el daemon firma digitalmente los contenidos del
+archivo, y la firma digital se adjunta. Durante la importación, el daemon
+verifica la firma y rechaza la importación en caso de una firma inválida o
+si la clave firmante no está autorizada.
+
+Las opciones principales son:
+
address@hidden @code
address@hidden --export
+Exporta los ficheros del almacén o paquetes (véase más adelante). Escribe el
+archivo resultante a la salida estándar.
+
+Las dependencias @emph{no} están incluidas en la salida, a menos que se use
address@hidden
+
address@hidden -r
address@hidden --recursive
+Cuando se combina con @code{--export}, instruye a @command{guix archive}
+para incluir las dependencias de los elementos dados en el archivo. Por
+tanto, el archivo resultante está auto-contenido: contiene la clausura de
+los elementos exportados del almacén.
+
address@hidden --import
+Lee un archivo de la entrada estándar, e importa los ficheros enumerados
+allí en el almacén. La operación se aborta si el archivo tiene una firma
+digital no válida, o si está firmado por una clave pública que no está entre
+las autorizadas (vea @code{--authorize} más adelante).
+
address@hidden --missing
+Lee una lista de nombres de ficheros del almacén de la entrada estándar, uno
+por línea, y escribe en la salida estándar el subconjunto de estos ficheros
+que faltan en el almacén.
+
address@hidden address@hidden
address@hidden firmar, archivos
+Genera un nuevo par de claves para el daemon. Esto es un prerrequisito antes
+de que los archivos puedan ser exportados con @code{--export}. Tenga en
+cuenta que esta operación normalmente toma tiempo, ya que se necesita
+obtener suficiente entropía para generar un par de claves.
+
+El par de claves generado se almacena típicamente bajo @file{/etc/guix}, en
address@hidden (clave pública) y @file{signing-key.sec} (clave
+privada, que se debe mantener secreta). Cuando @var{parámetros} se omite, se
+genera una clave ECDSA usando la curva Ed25519, o, en versiones de Libgcrypt
+previas a la 1.6.0, es una clave RSA de 4096 bits. De manera alternativa,
+los @var{parámetros} pueden especificar parámetros @code{genkey} adecuados
+para Libgcrypt (@pxref{General public-key related Functions,
address@hidden,, gcrypt, The Libgcrypt Reference Manual}).
+
address@hidden --authorize
address@hidden autorizar, archivos
+Autoriza importaciones firmadas con la clave pública pasada por la entrada
+estándar. La clave pública debe estar en el ``formato avanzado de
+expresiones-s''---es decir, el mismo formato que el fichero
address@hidden
+
+La lista de claves autorizadas se mantiene en el fichero editable por
+personas @file{/etc/guix/acl}. El fichero contiene
address@hidden://people.csail.mit.edu/rivest/Sexp.text, ``expresiones-s en
+formato avanzado''} y está estructurado como una lista de control de acceso
+en el formato @url{http://theworld.com/~cme/spki.txt, Infraestructura Simple
+de Clave Pública (SPKI)}.
+
address@hidden address@hidden
address@hidden -x @var{directorio}
+Lee un único elemento del archivo como es ofrecido por los servidores de
+sustituciones (@pxref{Sustituciones}) y lo extrae a @var{directorio}. Esta es
+una operación de bajo nivel necesitada únicamente para casos muy concretos;
+véase a continuación.
+
+Por ejemplo, la siguiente orden extrae la sustitución de Emacs ofrecida por
address@hidden@value{SUBSTITUTE-SERVER}} en @file{/tmp/emacs}:
+
address@hidden
+$ wget -O - \
+ https://@value{SUBSTITUTE-SERVER}/nar/@dots{}-emacs-24.5 \
+ | bunzip2 | guix archive -x /tmp/emacs
address@hidden example
+
+Los archivos de un único elemento son diferentes de los archivos de
+múltiples elementos producidos por @command{guix archive --export};
+contienen un único elemento del almacén, y @emph{no} embeben una firma. Por
+tanto esta operación @emph{no} verifica la firma y su salida debe
+considerarse insegura.
+
+El propósito primario de esta operación es facilitar la inspección de los
+contenidos de un archivo que provenga probablemente de servidores de
+sustituciones en los que no se confía.
+
address@hidden table
+
+
address@hidden
*********************************************************************
address@hidden Desarrollo
address@hidden Desarrollo
+
address@hidden desarrollo de software
+Si es una desarrolladora de software, Guix le proporciona herramientas que
+debería encontrar útiles---independientemente del lenguaje en el que
+desarrolle actualmente. Esto es sobre lo que trata este capítulo.
+
+La orden @command{guix environment} proporciona una manera conveniente de
+configurar un @dfn{entorno de desarrollo} que contenga todas las
+dependencias y herramientas necesarias para trabajar en el paquete de
+software de su elección. La orden @command{guix pack} le permite crear
address@hidden empaquetadas} que pueden ser distribuidas con facilidad a
+usuarias que no usen Guix.
+
address@hidden
+* Invocación de guix environment:: Configurar entornos de desarrollo.
+* Invocación de guix pack:: Creación de empaquetados de software.
address@hidden menu
+
address@hidden Invocación de guix environment
address@hidden Invocación de @command{guix environment}
+
address@hidden entornos de construcción reproducibles
address@hidden entornos de desarrollo
address@hidden @command{guix environment}
address@hidden entorno, entorno de construcción de paquetes
+El propósito de @command{guix environment} es ayudar a las hackers en la
+creación de entornos de desarrollo reproducibles sin modificar los paquetes
+de su perfil. La herramienta @command{guix environment} toma uno o más
+paquetes, construye todas sus entradas y crea un entorno shell para usarlos.
+
+La sintaxis general es:
+
address@hidden
+guix environment @var{opciones} @address@hidden
address@hidden example
+
+El ejemplo siguiente lanza un nuevo shell preparado para el desarrollo de
address@hidden:
+
address@hidden
+guix environment guile
address@hidden example
+
+Si las dependencias necesarias no están construidas todavía, @command{guix
+environment} las construye automáticamente. El entorno del nuevo shell es
+una versión aumentada del entorno en el que @command{guix environment} se
+ejecutó. Contiene las rutas de búsqueda necesarias para la construcción del
+paquete proporcionado añadidas a las variables ya existentes. Para crear un
+entorno ``puro'', donde las variables de entorno previas no existen, use la
+opción @address@hidden usuarias habitualmente aumentan de forma
+incorrecta las variables de entorno como @code{PATH} en su fichero
address@hidden/.bashrc}. Como consecuencia, cuando @code{guix environment} se
+ejecuta, Bash puede leer @file{~/.bashrc}, por tanto introduciendo
+``impurezas'' en esas variables de entorno. Es un error definir dichas
+variables de entorno en @file{~/.bashrc}; en vez de ello deben definirse en
address@hidden, el cual es únicamente cargado por el shell de ingreso
+al sistema. @xref{Bash Startup Files,,, bash, The GNU Bash Reference
+Manual}, para detalles sobre los ficheros de inicio de Bash.}.
+
address@hidden GUIX_ENVIRONMENT
address@hidden environment} define la variable @code{GUIX_ENVIRONMENT} en el
+shell que lanza; su valor es el nombre de fichero del perfil para este
+entorno. Esto permite a las usuarias, digamos, definir un prompt para
+entornos de desarrollo en su @file{.bashrc} (@pxref{Bash Startup Files,,,
+bash, The GNU Bash Reference Manual}):
+
address@hidden
+if [ -n "$GUIX_ENVIRONMENT" ]
+then
+ export PS1="\u@@\h \w [dev]\$ "
+fi
address@hidden example
+
address@hidden
+...@: o para explorar el perfil:
+
address@hidden
+$ ls "$GUIX_ENVIRONMENT/bin"
address@hidden example
+
+Adicionalmente, más de un paquete puede ser especificado, en cuyo caso se
+usa la unión de las entradas de los paquetes proporcionados. Por ejemplo, la
+siguiente orden lanza un shell donde todas las dependencias tanto de Guile
+como de Emacs están disponibles:
+
address@hidden
+guix environment guile emacs
address@hidden example
+
+A veces no se desea una sesión interactiva de shell. Una orden arbitraria
+puede invorcarse usando el valor @code{--} para separar la orden del resto
+de los parámetros:
+
address@hidden
+guix environment guile -- make -j4
address@hidden example
+
+En otras situaciones, es más conveniente especificar una lista de paquetes
+necesarios en el entorno. Por ejemplo, la siguiente orden ejecuta
address@hidden desde un entorno que contiene address@hidden y NumPy:
+
address@hidden
+guix environment --ad-hoc python2-numpy python-2.7 -- python
address@hidden example
+
+Más allá, se pueden desear las dependencias de un paquete y también algunos
+paquetes adicionales que no son dependencias ni en tiempo de construcción ni
+en el de ejecución, pero son útiles no obstante para el desarrollo. Por esta
+razón, la opción @code{--ad-hoc} es posicional. Los paquetes que aparecen
+antes de @code{--ad-hoc} se interpretan como paquetes cuyas dependencias se
+añadirán al entorno. Los paquetes que aparecen después se interpretan como
+paquetes que se añadirán directamente al entorno. Por ejemplo, la siguiente
+orden crea un entorno de desarrollo Guix que incluye adicionalmente Git y
+strace:
+
address@hidden
+guix environment guix --ad-hoc git strace
address@hidden example
+
+En ocasiones es deseable aislar el entorno tanto como sea posible, para
+obtener la máxima pureza y reproducibilidad. En particular, cuando se usa
+Guix en una distribución anfitriona que no es el sistema Guix, es deseable
+prevenir acceso a @file{/usr/bin} y otros recursos del sistema desde el
+entorno de desarrollo. Por ejemplo, la siguiente orden lanza un REPL Guile
+en un ``contenedor'' donde únicamente el almacén y el directorio actual
+están montados:
+
address@hidden
+guix environment --ad-hoc --container guile -- guile
address@hidden example
+
address@hidden Nota
+La opción @code{--container} requiere Linux-libre 3.19 o más nuevo.
address@hidden quotation
+
+Las opciones disponibles se resumen a continuación.
+
address@hidden @code
address@hidden address@hidden
address@hidden -r @var{fichero}
address@hidden entorno persistente
address@hidden raíz del recolector de basura, para entornos
+Hace que @var{fichero} sea un enlace simbólico al perfil para este entorno,
+y lo registra como una raíz del recolector de basura.
+
+Esto es útil si desea proteger su entorno de la recolección de basura,
+hacerlo ``persistente''.
+
+Cuando se omite esta opción, el entorno se protege de la recolección de
+basura únicamente por la duración de la sesión @command{guix
+environment}. Esto significa que la siguiente vez que vuelva a crear el
+mismo entorno, puede tener que reconstruir o volver a descargar
+paquetes. @xref{Invocación de guix gc}, para más información sobre las raices
del
+recolector de basura.
+
address@hidden address@hidden
address@hidden -e @var{expr}
+Crea un entorno para el paquete o lista de paquetes a los que evalúa
address@hidden
+
+Por ejemplo, ejecutando:
+
address@hidden
+guix environment -e '(@@ (gnu packages maths) petsc-openmpi)'
address@hidden example
+
+inicia un shell con el entorno para esta variante específica del paquete
+PETSc.
+
+Ejecutar:
+
address@hidden
+guix environment --ad-hoc -e '(@@ (gnu) %base-packages)'
address@hidden example
+
+inicia un shell con todos los paquetes básicos del sistema disponibles.
+
+Las órdenes previas usan únicamente la salida predeterminada de los paquetes
+dados. Para seleccionar otras salidas, tuplas de dos elementos pueden ser
+especificadas:
+
address@hidden
+guix environment --ad-hoc -e '(list (@@ (gnu packages bash) bash) "include")'
address@hidden example
+
address@hidden address@hidden
address@hidden -l @var{fichero}
+Crea un entorno para el paquete o la lista de paquetes a la que el código en
address@hidden evalúa.
+
+Como un ejemplo, @var{fichero} puede contener una definición como esta
+(@pxref{Definición de paquetes}):
+
address@hidden
address@hidden environment-gdb.scm
address@hidden example
+
address@hidden address@hidden
address@hidden -m @var{fichero}
+Crea un entorno para los paquetes contenidos en el objeto manifest devuelto
+por el código Scheme en @var{file}.
+
+Esto es similar a la opción del mismo nombre en @command{guix package}
+(@pxref{profile-manifest, @option{--manifest}}) y usa los mismos ficheros de
+manifiesto.
+
address@hidden --ad-hoc
+Incluye todos los paquetes especificados en el entorno resultante, como si
+un paquete @i{ad hoc} hubiese sido definido con ellos como entradas. Esta
+opción es útil para la creación rápida un entorno sin tener que escribir una
+expresión de paquete que contenga las entradas deseadas.
+
+Por ejemplo, la orden:
+
address@hidden
+guix environment --ad-hoc guile guile-sdl -- guile
address@hidden example
+
+ejecuta @command{guile} en un entorno donde están disponibles Guile y
+Guile-SDL.
+
+Fíjese que este ejemplo solicita implícitamente la salida predeterminada de
address@hidden y @code{guile-sdl}, pero es posible solicitar una salida
+específica---por ejemplo, @code{glib:bin} solicita la salida @code{bin} de
address@hidden (@pxref{Paquetes con múltiples salidas}).
+
+Esta opción puede componerse con el comportamiento predeterminado de
address@hidden environment}. Los paquetes que aparecen antes de
address@hidden se interpretan como paquetes cuyas dependencias se añadirán
+al entorno, el comportamiento predefinido. Los paquetes que aparecen después
+se interpretan como paquetes a añadir directamente al entorno.
+
address@hidden --pure
+Olvida las variables de entorno existentes cuando se construye un nuevo
+entorno, excepto aquellas especificadas con @option{--preserve} (véase más
+adelante). Esto tiene el efecto de crear un entorno en el que las rutas de
+búsqueda únicamente contienen las entradas del paquete.
+
address@hidden address@hidden
address@hidden -E @var{regexp}
+Cuando se usa junto a @option{--pure}, preserva las variables de entorno que
+corresponden con @var{regexp}---en otras palabras, las pone en una lista de
+variables de entorno que deben preservarse. Esta opción puede repetirse
+varias veces.
+
address@hidden
+guix environment --pure --preserve=^SLURM --ad-hoc openmpi @dots{} \
+ -- mpirun @dots{}
address@hidden example
+
+Este ejemplo ejecuta @command{mpirun} en un contexto donde las únicas
+variables de entorno definidas son @code{PATH}, variables de entorno cuyo
+nombre empiece con @code{SLURM}, así como las variables ``preciosas''
+habituales (@code{HOME}, @code{USER}, etc.).
+
address@hidden --search-paths
+Muestra las definiciones de variables de entorno que componen el entorno.
+
address@hidden address@hidden
address@hidden -s @var{sistema}
+Intenta construir para @var{sistema}---por ejemplo, @code{i686-linux}.
+
address@hidden --container
address@hidden -C
address@hidden container
+Ejecuta la @var{orden} en un contenedor aislado. El directorio actual fuera
+del contenedor es asociado al interior del contenedor. Adicionalmente, a
+menos que se fuerce con @code{--user}, un directorio de prueba de la usuaria
+se crea de forma que coincida con el directorio actual de la usuaria, y
address@hidden/etc/passwd} se configura adecuadamente.
+
+El proceso lanzado se ejecuta como el usuario actual fuera del
+contenedor. Dentro del contenedor, tiene el mismo UID y GID que el usuario
+actual, a menos que se proporcione @option{--user} (véase más adelante).
+
address@hidden --network
address@hidden -N
+Para contenedores, comparte el espacio de nombres de red con el sistema
+anfitrión. Los contenedores creados sin esta opción únicamente tienen acceso
+a la red local.
+
address@hidden --link-profile
address@hidden -P
+Para contenedores, enlaza el perfil del entorno a @file{~/.guix-profile}
+dentro del contenedor. Es equivalente a la ejecución de @command{ln -s
+$GUIX_ENVIRONMENT ~/.guix-profile} dentro del contenedor. El enlace fallará
+e interrumpirá el entorno si el directorio ya existe, lo cual será
+probablemente el caso si @command{guix environment} se invocó en el
+directorio de la usuaria.
+
+Determinados paquetes se configuran para buscar en @code{~/.guix-profile}
+ficheros de configuración y datos;@footnote{Por ejemplo, el paquete
address@hidden inspecciona @file{~/.guix-profile/share/fonts} en busca de
+nuevas tipografías.} @code{--link-profile} permite a estos programas operar
+de la manera esperada dentro del entorno.
+
address@hidden address@hidden
address@hidden -u @var{usuaria}
+Para contenedores, usa el nombre de usuaria @var{usuaria} en vez de la
+actual. La entrada generada en @file{/etc/passwd} dentro del contenedor
+contendrá el nombre @var{usuaria}; su directorio será
address@hidden/home/@var{usuaria}} y ningún dato GECOS de la usuaria se
copiará. Más
+aún, el UID y GID dentro del contenedor son 1000. @var{usuaria} no debe
+existir en el sistema.
+
+Adicionalmente, cualquier ruta compartida o expuesta (véanse @code{--share}
+y @code{--expose} respectivamente) cuyo destino esté dentro de la carpeta
+actual de la usuaria será reasociada en relación a
address@hidden/home/@var{usuaria}}; esto incluye la relación automática del
+directorio de trabajo actual.
+
address@hidden
+# expondrá las rutas /home/foo/ddt, /home/foo/prueba y /home/foo/objetivo
+cd $HOME/ddt
+guix environment --container --user=foo \
+ --expose=$HOME/prueba \
+ --expose=/tmp/objetivo=$HOME/objetivo
address@hidden example
+
+Mientras esto limita el escape de la identidad de la usuaria a través de las
+rutas de sus directorios y cada uno de los campos de usuaria, esto es
+únicamente un componente útil de una solución de privacidad/anonimato más
+amplia---no una solución completa.
+
address@hidden address@hidden@var{destino}]
+Para contenedores, expone el sistema de ficheros @var{fuente} del sistema
+anfitrión como un sistema de ficheros de solo-lectura @var{destino} dentro
+del contenedor. Si no se especifica @var{destino}, @var{fuente} se usa como
+el punto de montaje en el contenedor.
+
+El ejemplo a continuación lanza una sesión interactiva de Guile en un
+contenedor donde el directorio principal de la usuaria es accesible en modo
+solo-lectura a través del directorio @file{/intercambio}:
+
address@hidden
+guix environment --container --expose=$HOME=/intercambio --ad-hoc guile --
guile
address@hidden example
+
address@hidden address@hidden@var{destino}]
+Para contenedores, comparte el sistema de ficheros @var{fuente} del sistema
+anfitrión como el sistema de ficheros @var{destino} con permisos de
+escritura dentro del contenedor. Si no se especifica @var{destino},
address@hidden se usa como punto de montaje en el contenedor.
+
+El siguiente ejemplo lanza un entorno interactivo Guile en un contenedor en
+el que el directorio principal de la usuaria está disponible para tanto
+lectura como escritura via el directorio @file{/intercambio}:
+
address@hidden
+guix environment --container --share=$HOME=/intercambio --ad-hoc guile -- guile
address@hidden example
address@hidden table
+
+Además, @command{guix environment} acepta todas las opciones comunes de
+construcción que permite @command{guix build} (@pxref{Opciones comunes de
construcción})
+así como las opciones de transformación de paquetes (@pxref{Opciones de
transformación de paquetes}).
+
address@hidden Invocación de guix pack
address@hidden Invocación de @command{guix pack}
+
+De manera ocasional querrá dar software a gente que (¡todavía!) no tiene la
+suerte de usar Guix. Usted les diría que ejecuten @command{guix package -i
address@hidden, pero eso no es posible en este caso. Aquí es donde viene
address@hidden pack}.
+
address@hidden Nota
+Si está buscando formas de intercambiar binarios entre máquinas que ya
+ejecutan Guix, @pxref{Invocación de guix copy}, @ref{Invocación de guix
publish}, y
address@hidden de guix archive}.
address@hidden quotation
+
address@hidden pack
address@hidden empaquetado
address@hidden aplicación empaquetada
address@hidden empaquetado de software
+La orden @command{guix pack} crea un @dfn{paquete} reducido o
address@hidden de software}: crea un archivador tar u otro tipo que
+contiene los binarios del software en el que está interesada y todas sus
+dependencias. El archivo resultante puede ser usado en una máquina que no
+tiene Guix, y la gente puede ejecutar exactamente los mismos binarios que
+usted tiene con Guix. El paquete en sí es creado de forma reproducible
+bit-a-bit, para que cualquiera pueda verificar que realmente contiene los
+resultados de construcción que pretende distribuir.
+
+Por ejemplo, para crear un empaquetado que contenga Guile, Emacs, Geiser y
+todas sus dependencias, puede ejecutar:
+
address@hidden
+$ guix pack guile emacs geiser
address@hidden
+/gnu/store/@dots{}-pack.tar.gz
address@hidden example
+
+El resultado aquí es un archivador tar que contiene un directorio de
address@hidden/gnu/store} con todos los paquetes relevantes. El archivador
+resultante contiene un @dfn{perfil} con los tres paquetes de interés; el
+perfil es el mismo que se hubiera creado por @command{guix package -i}. Este
+es el mecanismo usado para crear el propio archivador de binarios separado
+de Guix (@pxref{Instalación binaria}).
+
+Las usuarias de este empaquetad tendrán que ejecutar
address@hidden/gnu/store/@dots{}-profile/bin/guile} para ejecutar guile, lo que
+puede resultar inconveniente. Para evitarlo, puede crear, digamos, un enlace
+simbólico @file{/opt/gnu/bin} al perfil:
+
address@hidden
+guix pack -S /opt/gnu/bin=bin guile emacs geiser
address@hidden example
+
address@hidden
+De este modo, las usuarias pueden escribir alegremente
address@hidden/opt/gnu/bin/guile} y disfrutar.
+
address@hidden binarios relocalizables, con @command{guix pack}
+¿Qué pasa se la receptora de su paquete no tiene privilegios de root en su
+máquina y por lo tanto no puede desempaquetarlo en la raíz del sistema de
+ficheros? En ese caso, lo que usted desea es usar la opción
address@hidden (véase a continuación). Esta opción produce
address@hidden relocalizables}, significando que pueden ser colocados en
+cualquier lugar de la jerarquía del sistema de ficheros: en el ejemplo
+anterior, las usuarias pueden desempaquetar el archivador en su directorio
+de usuaria y ejecutar directamente @file{./opt/gnu/bin/guile}.
+
address@hidden Docker, construir una imagen con guix pack
+De manera alternativa, puede producir un empaquetado en el formato de imagen
+Docker usando la siguiente orden:
+
address@hidden
+guix pack -f docker guile emacs geiser
address@hidden example
+
address@hidden
+El resultado es un archivador tar que puede ser pasado a la orden
address@hidden load}. Véase la
address@hidden://docs.docker.com/engine/reference/commandline/load/,
+documentación de Docker} para más información.
+
address@hidden Singularity, construir una imagen con guix pack
address@hidden SquashFS, construir una imagen con guix pack
+Otra opción más es producir una imagen SquashFS con la siguiente orden:
+
address@hidden
+guix pack -f squashfs guile emacs geiser
address@hidden example
+
address@hidden
+El resultado es una imagen de sistema de ficheros SquashFS que puede ser o
+bien montada, o bien usada directamente como una imagen contenedora de
+sistemas de ficheros con el @uref{http://singularity.lbl.gov, entorno de
+ejecución de contenedores Singularity}, usando órdenes como
address@hidden shell} o @command{singularity exec}.
+
+Varias opciones de la línea de órdenes le permiten personalizar su
+empaquetado:
+
address@hidden @code
address@hidden address@hidden
address@hidden -f @var{formato}
+Produce un empaquetado en el @var{formato} específico.
+
+Los formatos disponibles son:
+
address@hidden @code
address@hidden tarball
+Es el formato predeterminado. Produce un archivador que contiene todos los
+binarios y enlaces simbólicos especificados.
+
address@hidden docker
+Produce un archivador que sigue la
address@hidden://github.com/docker/docker/blob/master/image/spec/v1.2.md,
+especificación de imágenes Docker}.
+
address@hidden squashfs
+Produce una imagen SquashFS que contiene todos los binarios y enlaces
+simbólicos especificados, así como puntos de montaje vacíos para sistemas de
+ficheros virtuales como procfs.
address@hidden table
+
address@hidden binarios reposicionables
address@hidden --relocatable
address@hidden -R
+Produce @dfn{binarios reposicionables}---es decir, binarios que se pueden
+posicionar en cualquier lugar de la jerarquía del sistema de ficheros, y
+ejecutarse desde allí.
+
+When this option is passed once, the resulting binaries require support for
address@hidden namespaces} in the kernel Linux; when passed
address@hidden@footnote{Here's a trick to memorize it: @code{-RR}, which adds
+PRoot support, can be thought of as the abbreviation of ``Really
+Relocatable''. Neat, isn't it?}, relocatable binaries fall to back to PRoot
+if user namespaces are unavailable, and essentially work anywhere---see
+below for the implications.
+
+Por ejemplo, si crea un empaquetado que contiene Bash con:<
+
address@hidden
+guix pack -RR -S /mybin=bin bash
address@hidden example
+
address@hidden
+...@: puede copiar ese empaquetado a una máquina que no tiene Guix, y desde
+su directorio, como una usuaria normal, ejecutar:
+
address@hidden
+tar xf pack.tar.gz
+./mibin/sh
address@hidden example
+
address@hidden
+En ese shell, si escribe @code{ls /gnu/store}, notará que @file{/gnu/store}
+muestra y contiene todas las dependencias de @code{bash}, ¡incluso cuando la
+máquina no tiene el directorio @file{/gnu/store}! Esto es probablemente el
+modo más simple de desplegar software construido en Guix en una máquina
+no-Guix.
+
address@hidden Nota
+No obstante hay un punto a tener en cuenta: esta técnica descansa en la
+característica de @dfn{espacios de nombres de usuaria} del núcleo Linux, la
+cual permite a usuarias no privilegiadas montar o cambiar la raíz. Versiones
+antiguas de Linux no los implementan, y algunas distribuciones GNU/Linux los
+deshabilitan.
+
+Para producir binarios reposicionables que funcionen incluso en ausencia de
+espacios de nombre de usuaria, proporcione @option{--relocatable} o
address@hidden @emph{dos veces}. En ese caso, los binarios intentarán el uso de
+espacios de nombres de usuaria y usarán PRoot si no es posible.
+
+El programa @uref{https://proot-me.github.io/, PRoot} proporciona el soporte
+necesario para la virtualización del sistema de ficheros. Lo consigue
+mediante el uso de la llamada al sistema @code{ptrace} en el programa en
+ejecución. Esta aproximación tiene la ventaja de funcionar sin soporte
+especial en el núcleo, pero incurre en una sobrecarga en el tiempo de
+ejecución cada vez que se realiza una llamada al sistema.
address@hidden quotation
+
address@hidden address@hidden
address@hidden -e @var{expr}
+Considera el paquete al que evalúa @var{expr}
+
+Esto tiene el mismo propósito que la opción del mismo nombre en
address@hidden build} (@pxref{Opciones de construcción adicionales,
@code{--expression}
+in @command{guix build}}).
+
address@hidden address@hidden
address@hidden -m @var{fichero}
+Usa los paquetes contenidos en el objeto manifest devuelto por el código
+Scheme en @var{file}.
+
+Esto tiene un propósito similar al de la opción del mismo nombre en
address@hidden package} (@pxref{profile-manifest, @option{--manifest}}) y usa
+los mismos ficheros de manifiesto. Esto le permite definir una colección de
+paquetes una vez y usarla tanto para crear perfiles como para crear archivos
+en máquinas que no tienen instalado Guix. Fíjese que puede especificar
address@hidden bien} un fichero de manifiesto @emph{o bien} una lista de
paquetes,
+pero no ambas.
+
address@hidden address@hidden
address@hidden -s @var{sistema}
+Intenta construir paquetes para @var{sistema}---por ejemplo,
address@hidden vez del tipo de sistema de la máquina de
+construcción.
+
address@hidden address@hidden
address@hidden compilación cruzada
+Compilación cruzada para la @var{tripleta}, que debe ser una tripleta GNU
+válida, cómo @code{"mips64el-linux-gnu"} (@pxref{Specifying target triplets,
+GNU configuration triplets,, autoconf, Autoconf}).
+
address@hidden address@hidden
address@hidden -C @var{herramienta}
+Comprime el archivador resultante usando @var{herramienta}---un valor que
+puede ser @code{gzip}, @code{bzip2}, @code{xz}, @code{lzip} o @code{none}
+para no usar compresión.
+
address@hidden address@hidden
address@hidden -S @var{spec}
+Añade los enlaces simbólicos especificados por @var{spec} al
+empaquetado. Esta opción puede aparecer varias veces.
+
+La forma de @var{spec} es @address@hidden@var{destino}}, donde
address@hidden es el enlace simbólico que será creado y @var{destino} es el
+destino del enlace simbólico.
+
+Por ejemplo, @code{-S /opt/gnu/bin=bin} crea un enlace simbólico
address@hidden/opt/gnu/bin} apuntando al subdirectorio @file{bin} del perfil.
+
address@hidden --save-provenance
+Save provenance information for the packages passed on the command line.
+Provenance information includes the URL and commit of the channels in use
+(@pxref{Canales}).
+
+Provenance information is saved in the
address@hidden/gnu/store/@dots{}-profile/manifest} file in the pack, along with
the
+usual package metadata---the name and version of each package, their
+propagated inputs, and so on. It is useful information to the recipient of
+the pack, who then knows how the pack was (supposedly) obtained.
+
+This option is not enabled by default because, like timestamps, provenance
+information contributes nothing to the build process. In other words, there
+is an infinity of channel URLs and commit IDs that can lead to the same
+pack. Recording such ``silent'' metadata in the output thus potentially
+breaks the source-to-binary bitwise reproducibility property.
+
address@hidden --localstatedir
address@hidden address@hidden
+Incluye el ``directorio de estado local'', @file{/var/guix}, en el
+empaquetado resultante, y notablemente el perfil
address@hidden/var/guix/profiles/per-user/root/@var{nombre}}---por defecto
address@hidden es @code{guix-profile}, que corresponde con
address@hidden/.guix-profile}.
+
address@hidden/var/guix} contiene la base de datos del almacén (@pxref{El
almacén})
+así como las raíces del recolector de basura (@pxref{Invocación de guix gc}).
Proporcionarlo junto al empaquetado significa que el almacén está
+``completo'' y Guix puede trabajar con él; no proporcionarlo significa que
+el almacén está ``muerto'': no se pueden añadir o borrar nuevos elementos
+después de la extracción del empaquetado.
+
+Un caso de uso para esto es el archivador tar autocontenido de binarios de
+Guix (@pxref{Instalación binaria}).
+
address@hidden --bootstrap
+Usa los binarios del lanzamiento para construir el empaquetado. Esta opción
+es útil únicamente a las desarrolladoras de Guix.
address@hidden table
+
+Además, @command{guix pack} acepta todas las opciones comunes de
+construcción (@pxref{Opciones comunes de construcción}) y todas las opciones de
+transformación de paquetes (@pxref{Opciones de transformación de paquetes}).
+
+
address@hidden
*********************************************************************
address@hidden Interfaz programática
address@hidden Interfaz programática
+
+GNU Guix proporciona viarias interfaces programáticas Scheme (APIs) para
+definir, construir y consultar paquetes. La primera interfaz permite a las
+usuarias escribir definiciones de paquetes a alto nivel. Estas definiciones
+referencian conceptos familiares de empaquetamiento, como el nombre y la
+versión de un paquete, su sistema de construcción y sus dependencias. Estas
+definiciones se pueden convertir en acciones concretas de construcción.
+
+Las acciones de construcción son realizadas por el daemon Guix, en
+delegación de las usuarias. En una configuración estándar, el daemon tiene
+acceso de escritura al almacén---el directorio @file{/gnu/store}---mientras
+que las usuarias no. En la configuración recomendada el daemon también
+realiza las construcciones en chroots, bajo usuarias específicas de
+construcción, para minimizar la interferencia con el resto del sistema.
+
address@hidden derivación
+Las APIs de nivel más bajo están disponibles para interactuar con el daemon
+y el almacén. Para instruir al daemon para realizar una acción de
+construcción, las usuarias realmente proporcionan una @dfn{derivación}. Una
+derivación es una representación de bajo nivel de las acciones de
+construcción a tomar, y el entorno en el que deberían suceder---las
+derivaciones son a las definiciones de paquetes lo que es el ensamblador a
+los programas en C. El término ``derivación'' viene del hecho de que los
+resultados de la construcción @emph{derivan} de ellas.
+
+Este capítulo describe todas estas APIs en orden, empezando por las
+definiciones de alto nivel de paquetes.
+
address@hidden
+* Módulos de paquetes:: Paquetes bajo el punto de vista del
+ programador.
+* Definición de paquetes:: Definir nuevos paquetes.
+* Sistemas de construcción:: Especificar como se construyen los paquetes.
+* El almacén:: Manipular el almacén de paquetes.
+* Derivaciones:: Interfaz de bajo nivel de las derivaciones de
+ los paquetes.
+* La mónada del almacén:: Interfaz puramente funcional del almacén.
+* Expresiones-G:: Manipular expresiones de construcción.
+* Invocación de guix repl:: Enredar con Guix interactivamente.
address@hidden menu
+
address@hidden Módulos de paquetes
address@hidden Módulos de paquetes
+
+Desde un punto de vista programático, las definiciones de paquetes de la
+distribución GNU se proporcionan por módulos Guile en el espacio de nombres
address@hidden(gnu packages @dots{})address@hidden que los paquetes bajo el
+espacio de nombres de módulo @code{(gnu packages @dots{})} no son
+necesariamente ``paquetes GNU''. Este esquema de nombrado de módulos sigue
+la convención habitual de Guile para el nombrado de módulos: @code{gnu}
+significa que estos módulos se distribuyen como parte del sistema GNU, y
address@hidden identifica módulos que definen paquetes.} (@pxref{Módulos,
+Guile modules,, guile, GNU Guile Reference Manual}). Por ejemplo, el módulo
address@hidden(gnu packages emacs)} exporta una variable con nombre
@code{emacs},
+que está asociada a un objeto @code{<package>} (@pxref{Definición de
paquetes}).
+
+El espacio de nombres de módulos @code{(gnu packages @dots{})} se recorre
+automáticamente en busca de paquetes en las herramientas de línea de
+ordenes. Por ejemplo, cuando se ejecuta @code{guix package -i emacs}, todos
+los módulos @code{(gnu packages @dots{})} son procesados hasta encontrar uno
+que exporte un objeto de paquete cuyo nombre sea @code{emacs}. Esta búsqueda
+de paquetes se implementa en el módulo @code{(gnu packages)}.
+
address@hidden personalización, de paquetes
address@hidden ruta de búsqueda de módulos de paquetes
+Las usuarias pueden almacenar definiciones de paquetes en módulos con
+nombres diferentes---por ejemplo, @code{(mis-paquetes
+emacs)address@hidden que el nombre de fichero y el nombre de módulo deben
+coincidir. Por ejemplo, el módulo @code{(mis-paquetes emacs)} debe
+almacenarse en el fichero @file{mis-paquetes/emacs.scm} en relación con la
+ruta de carga especificada con @option{--load-path} o
address@hidden @xref{Modules and the File System,,, guile, GNU
+Guile Reference Manual}, para obtener detalles.}. Existen dos maneras de
+hacer visibles estas definiciones de paquetes a las interfaces de usuaria:
+
address@hidden
address@hidden
+Mediante la adición del directorio que contiene sus módulos de paquetes a la
+ruta de búsqueda con la opción @code{-L} de @command{guix package} y otras
+órdenes (@pxref{Opciones comunes de construcción}), o usando la variable de
entorno
address@hidden descrita más adelante.
+
address@hidden
+Mediante la definición de un @dfn{canal} y la configuración de @command{guix
+pull} de manera que se actualice desde él. Un canal es esencialmente un
+repositorio Git que contiene módulos de paquetes. @xref{Canales}, para más
+información sobre cómo definir y usar canales.
address@hidden enumerate
+
address@hidden funciona de forma similar a otras variables de
+rutas de búsqueda:
+
address@hidden {Variable de entorno} GUIX_PACKAGE_PATH
+Es una lista separada por dos puntos de directorios en los que se buscarán
+módulos de paquetes adicionales. Los directorios enumerados en esta variable
+tienen preferencia sobre los propios módulos de la distribución.
address@hidden defvr
+
+La distribución es @dfn{auto-contenida} y completamente @dfn{basada en el
+lanzamiento inicial}: cada paquete se construye basado únicamente en otros
+paquetes de la distribución. La raíz de este grafo de dependencias es un
+pequeño conjunto de @dfn{binarios del lanzamiento inicial}, proporcionados
+por el módulo @code{(gnu packages bootstrap)}. Para más información sobre el
+lanzamiento inicial, @pxref{Lanzamiento inicial}.
+
address@hidden Definición de paquetes
address@hidden Definición de paquetes
+
+La interfaz de alto nivel de las definiciones de paquetes está implementada
+en los módulos @code{(guix packages)} y @code{(guix build-system)}. Como un
+ejemplo, la definición de paquete, o @dfn{receta}, para el paquete GNU Hello
+es como sigue:
+
address@hidden
+(define-module (gnu packages hello)
+ #:use-module (guix packages)
+ #:use-module (guix download)
+ #:use-module (guix build-system gnu)
+ #:use-module (guix licenses)
+ #:use-module (gnu packages gawk))
+
+(define-public hello
+ (package
+ (name "hello")
+ (version "2.10")
+ (source (origin
+ (method url-fetch)
+ (uri (string-append "mirror://gnu/hello/hello-" version
+ ".tar.gz"))
+ (sha256
+ (base32
+ "0ssi1wpaf7plaswqqjwigppsg5fyh99vdlb9kzl7c9lng89ndq1i"))))
+ (build-system gnu-build-system)
+ (arguments '(#:configure-flags '("--enable-silent-rules")))
+ (inputs `(("gawk" ,gawk)))
+ (synopsis "Hello, GNU world: An example GNU package")
+ (description "Guess what GNU Hello prints!")
+ (home-page "http://www.gnu.org/software/hello/";)
+ (license gpl3+)))
address@hidden example
+
address@hidden
+Sin ser una experta en Scheme---pero conociendo un poco de inglés---, la
+lectora puede haber supuesto el significado de varios campos aquí. Esta
+expresión asocia la variable @code{hello} al objeto @code{<package>}, que
+esencialmente es un registro (@pxref{SRFI-9, Scheme records,, guile, GNU
+Guile Reference Manual}). Este objeto de paquete puede ser inspeccionado
+usando los procedimientos encontrados en el módulo @code{(guix packages)};
+por ejemplo, @code{(package-name hello)}
address@hidden"hello"}.
+
+Con suerte, puede que sea capaz de importar parte o toda la definición del
+paquete de su interés de otro repositorio, usando la orden @code{guix
+import} (@pxref{Invocación de guix import}).
+
+En el ejemplo previo, @var{hello} se define en un módulo para ella,
address@hidden(gnu packages hello)}. Técnicamente, esto no es estrictamente
+necesario, pero es conveniente hacerlo: todos los paquetes definidos en
+módulos bajo @code{(gnu packages @dots{})} se reconocen automáticamente en
+las herramientas de línea de órdenes (@pxref{Módulos de paquetes}).
+
+Hay unos pocos puntos que merece la pena destacar de la definición de
+paquete previa:
+
address@hidden
address@hidden
+El campo @code{source} del paquete es un objeto @code{<origin>}
+(@pxref{Referencia de ``origin''}, para la referencia completa). Aquí se usa el
+método @code{url-fetch} de @code{(guix download)}, lo que significa que la
+fuente es un fichero a descargar por FTP o HTTP.
+
+El prefijo @code{mirror://gnu} instruye a @code{url-fetch} para usar uno de
+los espejos GNU definidos en @code{(guix download)}.
+
+El campo @code{sha256} especifica el hash SHA256 esperado del fichero
+descargado. Es obligatorio, y permite a Guix comprobar la integridad del
+fichero. La forma @code{(base32 @dots{})} introduce la representación base32
+del hash. Puede obtener esta información con @code{guix download}
+(@pxref{Invocación de guix download}) y @code{guix hash} (@pxref{Invocación de
guix hash}).
+
address@hidden parches
+Cuando sea necesario, la forma @code{origin} también puede tener un campo
address@hidden con la lista de parches a ser aplicados, y un campo
address@hidden con una expresión Scheme para modificar el código fuente.
+
address@hidden
address@hidden Sistema de construcción GNU
+El campo @code{build-system} especifica el procedimiento de construcción del
+paquete (@pxref{Sistemas de construcción}). Aquí, @var{gnu-build-system}
representa el
+familiar sistema de construcción GNU, donde los paquetes pueden
+configurarse, construirse e instalarse con la secuencia de ordenes habitual
address@hidden/configure && make && make check && make install}.
+
address@hidden
+El campo @code{arguments} especifica las opciones para el sistema de
+construcción (@pxref{Sistemas de construcción}). Aquí son interpretadas por
address@hidden como una petición de ejecutar @file{configure} con la
+opción @code{--enable-silent-rules}.
+
address@hidden quote
address@hidden creación de literales
address@hidden '
address@hidden quote
+¿Qué son estas comillas simples (@code{'})? Son sintaxis Scheme para
+introducir una lista literal; @code{'} es sinónimo de
address@hidden @xref{Expression Syntax, quoting,, guile, GNU Guile Reference
+Manual}, para más detalles. Aquí el valor del campo @code{arguments} es una
+lista de parámetros pasada al sistema de construcción, como con @code{apply}
+(@pxref{Fly Evaluation, @code{apply},, guile, GNU Guile Reference Manual}).
+
+La secuencia almohadilla-dos puntos (@code{#:}) define una @dfn{palabra
+clave} Scheme (@pxref{Keywords,,, guile, GNU Guile Reference Manual}), y
address@hidden:configure-flags} es una palabra clave usada para pasar un
parámetro
+nominal al sistema de construcción (@pxref{Coding With Keywords,,, guile,
+GNU Guile Reference Manual}).
+
address@hidden
+El campo @code{inputs} especifica las entradas al proceso de
+construcción---es decir, dependencias de tiempo de construcción o ejecución
+del paquete. Aquí, definimos una entrada llamada @code{"gawk"}, cuyo valor
+es el de la variable @var{gawk}; @var{gawk} en sí apunta a un objeto
address@hidden<package>}.
+
address@hidden acento grave (quasiquote)
address@hidden `
address@hidden quasiquote
address@hidden coma (unquote)
address@hidden ,
address@hidden unquote
address@hidden ,@@
address@hidden unquote-splicing
+De nuevo, @code{`} (un acento grave, sinónimo de @code{quasiquote}) nos
+permite introducir una lista literal en el campo @code{inputs}, mientras que
address@hidden,} (una coma, sinónimo de @code{unquote}) nos permite insertar un
+valor en dicha lista (@pxref{Expression Syntax, unquote,, guile, GNU Guile
+Reference Manual}).
+
+Fíjese que no hace falta que GCC, Coreutils, Bash y otras herramientas
+esenciales se especifiquen como entradas aquí. En vez de eso,
address@hidden se hace cargo de asegurar que están presentes
+(@pxref{Sistemas de construcción}).
+
+No obstante, cualquier otra dependencia debe ser especificada en el campo
address@hidden Las dependencias no especificadas aquí simplemente no estarán
+disponibles para el proceso de construcción, provocando posiblemente un
+fallo de construcción.
address@hidden itemize
+
address@hidden de ``package''}, para una descripción completa de los campos
+posibles.
+
+Una vez la definición de paquete esté en su lugar, el paquete puede ser
+construido realmente usando la herramienta de línea de órdenes @code{guix
+build} (@pxref{Invocación de guix build}), pudiendo resolver cualquier fallo de
+construcción que encuentre (@pxref{Depuración de fallos de construcción}).
Puede volver
+a la definición del paquete fácilmente usando la orden @command{guix edit}
+(@pxref{Invocación de guix edit}). @xref{Guías de empaquetamiento}, para más
+información sobre cómo probar definiciones de paquetes, y @ref{Invocación de
guix lint}, para información sobre cómo comprobar la consistencia del estilo de
+una definición.
address@hidden GUIX_PACKAGE_PATH
+Por último, @pxref{Canales}, para información sobre cómo extender la
+distribución añadiendo sus propias definiciones de paquetes en un ``canal''.
+
+Finalmente, la actualización de la definición con una nueva versión oficial
+puede ser automatizada parcialmente por la orden @command{guix refresh}
+(@pxref{Invocación de guix refresh}).
+
+Tras el telón, una derivación correspondiente al objeto @code{<package>} es
+calculada mediante el procedimiento @code{package-derivation}. Esta
+derivación es almacenada en un fichero @code{.drv} bajo
address@hidden/gnu/store}. Las acciones de construcción que prescribe pueden
+entonces llevarse a cabo usando el procedimiento @code{build-derivations}
+(@pxref{El almacén}).
+
address@hidden {Procedimiento Scheme} package-derivation @var{almacén}
@var{paquete} address@hidden
+Devuelve el objeto @code{<derivation>} del @var{paquete} pra el
address@hidden (@pxref{Derivaciones}).
+
address@hidden debe ser un objeto @code{<package>} válido, y @var{sistema}
+debe ser una cadena que denote el tipo de sistema objetivo---por ejemplo,
address@hidden"x86_64-linux"} para un sistema GNU x86_64 basado en
+Linux. @var{almacén} debe ser una conexión al daemon, que opera en el
+almacén (@pxref{El almacén}).
address@hidden deffn
+
address@hidden
address@hidden compilación cruzada
+De manera similar, es posible calcular una derivación que construye de forma
+cruzada un paquete para otro sistema:
+
address@hidden {Procedimiento Scheme} package-cross-derivation @var{almacén} @
+ @var{paquete} @var{plataforma} address@hidden
+Devuelve el objeto @code{<derivation>} de @var{paquete} compilado de forma
+cruzada desde @var{sistema} a @var{plataforma}.
+
address@hidden debe ser una tripleta GNU válida que denote el hardware y
+sistema operativo objetivo, como @code{"mips64el-linux-gnu"}
+(@pxref{Configuration Names, GNU configuration triplets,, configure, GNU
+Configure and Build System}).
address@hidden deffn
+
address@hidden transformación de paquetes
address@hidden reescritura de la entrada
address@hidden reescritura del árbol de dependencias
+Los paquetes se pueden manipular de forma arbitraria. Un ejemplo de
+transformación útil es la @dfn{reescritura de entradas}, donde el árbol de
+dependencias de un paquete se reescribe reemplazando entradas específicas
+por otras:
+
address@hidden {Procedimiento Scheme} package-input-rewriting @var{reemplazos} @
+ address@hidden
+Devuelve un procedimiento que, cuando se le pasa un paquete, reemplaza sus
+dependencias directas e indirectas (pero no sus entradas implícitas) de
+acuerdo a @var{reemplazos}. @var{reemplazos} es una lista de pares de
+paquetes; el primer elemento de cada par es el paquete a reemplazar, el
+segundo es el reemplazo.
+
+Opcionalmente, @var{nombre-reescrito} es un procedimiento de un parámetro
+que toma el nombre del paquete y devuelve su nuevo nombre tras la
+reescritura.
address@hidden deffn
+
address@hidden
+Considere este ejemplo:
+
address@hidden
+(define libressl-en-vez-de-openssl
+ ;; Esto es un procedimiento para reemplazar OPENSSL
+ ;; por LIBRESSL, recursivamente.
+ (package-input-rewriting `((,openssl . ,libressl))))
+
+(define git-con-libressl
+ (libressl-en-vez-de-openssl git))
address@hidden example
+
address@hidden
+Aquí primero definimos un procedimiento de reescritura que substituye
address@hidden por @var{libressl}. Una vez hecho esto, lo usamos para definir
+una @dfn{variante} del paquete @var{git} que usa @var{libressl} en vez de
address@hidden Esto es exactamente lo que hace la opción de línea de órdenes
address@hidden (@pxref{Opciones de transformación de paquetes,
address@hidden).
+
+The following variant of @code{package-input-rewriting} can match packages
+to be replaced by name rather than by identity.
+
address@hidden {Procedimiento Scheme} package-input-rewriting/spec
@var{reemplazos}
+Return a procedure that, given a package, applies the given
address@hidden to all the package graph (excluding implicit inputs).
address@hidden is a list of spec/procedures pair; each spec is a package
+specification such as @code{"gcc"} or @code{"guile@@2"}, and each procedure
+takes a matching package and returns a replacement for that package.
address@hidden deffn
+
+The example above could be rewritten this way:
+
address@hidden
+(define libressl-en-vez-de-openssl
+ ;; Reemplaza todos los paquetes llamados "openssl" con LibreSSL.
+ (package-input-rewriting/spec `(("openssl" . ,(const libressl)))))
address@hidden example
+
+The key difference here is that, this time, packages are matched by spec and
+not by identity. In other words, any package in the graph that is called
address@hidden will be replaced.
+
+Un procedimiento más genérico para reescribir el grafo de dependencias de un
+paquete es @code{package-mapping}: acepta cambios arbitrarios sobre nodos
+del grafo.
+
address@hidden {Scheme Procedure} package-mapping @var{proc} address@hidden
+Devuelve un procedimiento que, dado un paquete, aplica @var{proc} a todos
+los paquetes de los que depende y devuelve el paquete resultante. El
+procedimiento para la recursión cuando @var{cortar?} devuelve verdadero para
+un paquete dado.
address@hidden deffn
+
address@hidden
+* Referencia de ``package'':: El tipo de datos de los paquetes.
+* Referencia de ``origin'':: El tipo de datos de orígenes.
address@hidden menu
+
+
address@hidden Referencia de ``package''
address@hidden Referencia de @code{package}
+
+Esta sección resume todas las opciones disponibles en declaraciones
address@hidden (@pxref{Definición de paquetes}).
+
address@hidden {Tipo de datos} package
+Este es el tipo de datos que representa la receta de un paquete.
+
address@hidden @asis
address@hidden @code{name}
+El nombre del paquete, como una cadena.
+
address@hidden @code{version}
+La versión del paquete, como una cadena.
+
address@hidden @code{source}
+Un objeto que determina cómo se debería obtener el código fuente del
+paquete. La mayor parte del tiempo, es un objeto @code{origin}, que denota
+un fichero obtenido de Internet (@pxref{Referencia de ``origin''}). También
puede
+ser cualquier otro objeto ``tipo-fichero'' como @code{local-file}, que
+denota un fichero del sistema local de ficheros (@pxref{Expresiones-G,
address@hidden).
+
address@hidden @code{build-system}
+El sistema de construcción que debe ser usado para construir el paquete
+(@pxref{Sistemas de construcción}).
+
address@hidden @code{arguments} (predeterminados: @code{'()})
+Los parámetros que deben ser pasados al sistema de construcción. Es una
+lista que normalmente contiene una secuencia de pares de palabra clave y
+valor.
+
address@hidden @code{inputs} (predeterminadas: @code{'()})
address@hidden @code{native-inputs} (predeterminadas: @code{'()})
address@hidden @code{propagated-inputs} (predeterminadas: @code{'()})
address@hidden entradas, de paquetes
+Estos campos enumeran las dependencias del paquete. Cada uno es una lista de
+tuplas, donde cada tupla tiene una etiqueta para la entrada (una cadena)
+como su primer elemento, un paquete, origen o derivación como su segundo
+elemento, y opcionalmente el nombre de la salida que debe ser usada, cuyo
+valor predeterminado es @code{"out"} (@pxref{Paquetes con múltiples salidas},
para más información sobre salidas de paquetes). Por ejemplo, la
+lista siguiente especifica tres entradas:
+
address@hidden
+`(("libffi" ,libffi)
+ ("libunistring" ,libunistring)
+ ("glib:bin" ,glib "bin")) ;la salida "bin" de Glib
address@hidden example
+
address@hidden compilación cruzada, dependencias de paquetes
+La distinción entre @code{native-inputs} y @code{inputs} es necesaria cuando
+se considera la compilación cruzada. Cuando se compila cruzadamente, las
+dependencias enumeradas en @code{inputs} son construidas para la
+arquitectura @emph{objetivo}; de modo contrario, las dependencias enumeradas
+en @code{native-inputs} se construyen para la arquitectura de la máquina de
address@hidden
+
address@hidden se usa típicamente para enumerar herramientas
+necesarias en tiempo de construcción, pero no en tiempo de ejecución, como
+Autoconf, Automake, pkg-config, Gettext o Bison. @command{guix lint} puede
+informar de probables errores en este área (@pxref{Invocación de guix lint}).
+
address@hidden
+Por último, @code{propagated-inputs} es similar a @code{inputs}, pero los
+paquetes especificados se instalarán automáticamente junto al paquete al que
+pertenecen (@pxref{package-cmd-propagated-inputs, @command{guix package}},
+para información sobre cómo @command{guix package} maneja las entradas
+propagadas).
+
+Por ejemplo esto es necesario cuando una biblioteca C/C++ necesita cabeceras
+de otra biblioteca para compilar, o cuando un fichero pkg-config se refiere
+a otro @i{via} su campo @code{Requires}.
+
+Otro ejemplo donde @code{propagated-inputs} es útil es en lenguajes que
+carecen de la facilidad de almacenar la ruta de búsqueda de tiempo de
+ejecución de la misma manera que el campo @code{RUNPATH} de los ficheros
+ELF; esto incluye Guile, Python, Perl y más. Para asegurarse que las
+bibliotecas escritas en esos lenguajes puedan encontrar en tiempo de
+ejecución el código de las bibliotecas de las que dependen, las dependencias
+de tiempo de ejecución deben enumerarse en @code{propagated-inputs} en vez
+de en @code{inputs}.
+
address@hidden @code{outputs} (predeterminada: @code{'("out")})
+La lista de nombres de salidas del paquete. @xref{Paquetes con múltiples
salidas}, para usos típicos de salidas adicionales.
+
address@hidden @code{native-search-paths} (predeterminadas: @code{'()})
address@hidden @code{search-paths} (predeterminadas: @code{'()})
+Una lista de objetos @code{search-path-specification} describiendo las
+variables de entorno de rutas de búsqueda respetadas por el paquete.
+
address@hidden @code{replacement} (predeterminado: @code{1.0})
+Esto debe ser o bien @code{#f} o bien un objeto package que será usado como
address@hidden para ete paquete. @xref{Actualizaciones de seguridad, injertos},
para
+más detalles.
+
address@hidden @code{synopsis}
+Una descripción en una línea del paquete.
+
address@hidden @code{description}
+Una descripción más elaborada del paquete.
+
address@hidden @code{license}
address@hidden licencia, de paquetes
+La licencia del paquete; un valor de @code{(guix licenses)}, o una lista de
+dichos valores.
+
address@hidden @code{home-page}
+La URL de la página principal del paquete, como una cadena.
+
address@hidden @code{supported-systems} (predeterminados:
@code{%supported-systems})
+La lista de sistemas en los que se mantiene el paquete, como cadenas de la
+forma @code{arquitectura-núcleo}, por ejemplo @code{"x86_64-linux"}.
+
address@hidden @code{maintainers} (predeterminadas: @code{'()})
+La lista de responsables del paquete, como objetos @code{maintainer}.
+
address@hidden @code{location} (predeterminada: la localización de los fuentes
de la forma @code{package})
+La localización de las fuentes del paquete. Es útil forzar su valor cuando
+se hereda de otro paquete, en cuyo caso este campo no se corrige
+automáticamente.
address@hidden table
address@hidden deftp
+
address@hidden {Scheme Syntax} this-package
+When used in the @emph{lexical scope} of a package field definition, this
+identifier resolves to the package being defined.
+
+The example below shows how to add a package as a native input of itself
+when cross-compiling:
+
address@hidden
+(package
+ (name "guile")
+ ;; ...
+
+ ;; When cross-compiled, Guile, for example, depends on
+ ;; a native version of itself. Add it here.
+ (native-inputs (if (%current-target-system)
+ `(("self" ,this-package))
+ '())))
address@hidden example
+
+It is an error to refer to @code{this-package} outside a package definition.
address@hidden deffn
+
address@hidden Referencia de ``origin''
address@hidden Referencia de @code{origin}
+
+Esta sección resume todas las opciones disponibles en declaraciones
address@hidden (@pxref{Definición de paquetes}).
+
address@hidden {Tipo de datos} origin
+Este es el tipo de datos que representa un origen de código fuente.
+
address@hidden @asis
address@hidden @code{uri}
+Un objeto que contiene el URI de las fuentes. El tipo de objeto depende del
+valor de @code{method} (véase a continuación). Por ejemplo, cuando se usa el
+método @var{url-fetch} de @code{(guix download)}, los valores válidos de
address@hidden son: una cadena que contiene una URL, o una lista de cadenas.
+
address@hidden @code{method}
+Un procedimiento que maneja el URI.
+
+Algunos ejemplos son:
+
address@hidden @asis
address@hidden @var{url-fetch} de @code{(guix download)}
+descarga un fichero de la URL HTTP, HTTPS o FTP especificada en el campo
address@hidden;
+
address@hidden git-fetch
address@hidden @var{git-fetch} de @code{(guix git-download)}
+clona el repositorio de control de versiones Git, y prepara la revisión
+especificada en el campo @code{uri} como un objeto @code{git-reference}; una
+referencia @code{git-reference} tiene esta forma:
+
address@hidden
+(git-reference
+ (url "git://git.debian.org/git/pkg-shadow/shadow")
+ (commit "v4.1.5.1"))
address@hidden example
address@hidden table
+
address@hidden @code{sha256}
+Un vector de bytes que contiene el hash SHA-256 de las fuentes. Típicamente
+la forma @code{base32} se usa aquí para generar el vector de bytes de una
+cadena en base-32.
+
+Puede obtener esta información usando @code{guix download} (@pxref{Invocación
de guix download}) o @code{guix hash} (@pxref{Invocación de guix hash}).
+
address@hidden @code{file-name} (predeterminado: @code{#f})
+El nombre de fichero bajo el que el código fuente se almacenará. Cuando este
+es @code{#f}, un valor predeterminado sensato se usará en la mayor parte de
+casos. En caso de que las fuentes se obtengan de una URL, el nombre de
+fichero de la URL se usará. Para copias de trabajo de sistemas de control de
+versiones, se recomienda proporcionar el nombre de fichero explícitamente ya
+que el predeterminado no es muy descriptivo.
+
address@hidden @code{patches} (predeterminados: @code{'()})
+Una lista de nombres de ficheros, orígenes u objetos tipo-fichero
+(@pxref{Expresiones-G, objetos tipo-fichero}) apuntando a parches que deben
+ser aplicados a las fuentes.
+
+La lista de parches debe ser incondicional. En particular, no puede depender
+del varlo de @code{%current-system} o @code{%current-target-system}.
+
address@hidden @code{snippet} (predeterminado: @code{#f})
+Una expresión-G (@pxref{Expresiones-G}) o expresión-S que se ejecutará en el
+directorio de fuentes. Esta es una forma conveniente de modificar el
+software, a veces más que un parche.
+
address@hidden @code{patch-flags} (predeterminadas: @code{'("-p1")})
+Una lista de opciones de línea de órdenes que deberían ser pasadas a la
+orden @code{patch}.
+
address@hidden @code{patch-inputs} (predeterminada: @code{#f})
+Paquetes o derivaciones de entrada al proceso de aplicación de los
+parches. Cuando es @code{#f}, se proporciona el conjunto habitual de
+entradas necesarias para la aplicación de parches, como address@hidden
+
address@hidden @code{modules} (predeterminados: @code{'()})
+Una lista de módulos Guile que debe ser cargada durante el proceso de
+aplicación de parches y mientras se ejecuta el código del campo
address@hidden
+
address@hidden @code{patch-guile} (predeterminado: @code{#f})
+El paquete Guile que debe ser usado durante la aplicación de parches. Cuando
+es @code{#f} se usa un valor predeterminado.
address@hidden table
address@hidden deftp
+
+
address@hidden Sistemas de construcción
address@hidden Sistemas de construcción
+
address@hidden sistema de construcción
+Cada definición de paquete especifica un @dfn{sistema de construcción} y
+parámetros para dicho sistema de construcción (@pxref{Definición de
paquetes}). Este campo @code{build-system} representa el procedimiento de
+construcción del paquete, así como las dependencias implícitas de dicho
+procedimiento de construcción.
+
+Los sistemas de construcción son objetos @code{<build-system>}. La interfaz
+para crear y manipularlos se proporciona en el módulo @code{(guix
+build-system)}, y otros módulos exportan sistemas de construcción reales.
+
address@hidden bag (representación de paquetes de bajo nivel)
+En su implementación, los sistemas de construcción primero compilan los
+objetos package a objetos @dfn{bag}. Una bolsa (traducción de @dfn{bag}) es
+como un paquete, pero con menos ornamentos---en otras palabras, una bolsa es
+una representación a un nivel más bajo de un paquete, que contiene todas las
+entradas de dicho paquete, incluyendo algunas implícitamente añadidas por el
+sistema de construcción. Esta representación intermedia se compila entonces
+a una derivación (@pxref{Derivaciones}).
+
+Los sistemas de construcción aceptan una lista opcional de
address@hidden En las definiciones de paquete, estos son pasados @i{vía}
+el campo @code{arguments} (@pxref{Definición de paquetes}). Normalmente son
+parámetros con palabras clave (@pxref{Optional Arguments, keyword arguments
+in Guile,, guile, GNU Guile Reference Manual}). El valor de estos parámetros
+normalmente se evalúa en la @dfn{capa de construcción}---es decir, por un
+proceso Guile lanzado por el daemon (@pxref{Derivaciones}).
+
+El sistema de construcción principal es @var{gnu-build-system}, el cual
+implementa el procedimiento estándar de construcción para GNU y muchos otros
+paquetes. Se proporciona por el módulo @code{(guix build-system gnu)}.
+
address@hidden {Variable Scheme} gnu-build-system
address@hidden representa el sistema de construcción GNU y sus
+variantes (@pxref{Configuration, configuration and makefile conventions,,
+standards, GNU Coding Standards}).
+
address@hidden fases de construcción
+En resumen, los paquetes que lo usan se configuran, construyen e instalan
+con la habitual secuencia de órdenes @code{./configure && make && make check
+&& make install}. En la práctica, algunos pasos adicionales son necesarios
+habitualmente. Todos estos pasos se dividen en @dfn{fases} separadas,
address@hidden que se inspeccionen los módulos @code{(guix
+build gnu-build-system)} para más detalles sobre las fases de construcción}:
+
address@hidden @code
address@hidden unpack
+Extrae el archivador tar de la fuente, y cambia el directorio actual al
+directorio recién extraído. Si la fuente es realmente un directorio, lo
+copia al árbol de construcción y entra en ese directorio.
+
address@hidden patch-source-shebangs
+Sustituye secuencias ``#!'' encontradas al inicio de los ficheros de fuentes
+para que hagan referencia a los nombres correctos de ficheros del
+almacén. Por ejemplo, esto cambia @code{#!/bin/sh} por
address@hidden/gnu/store/@dots{}-bash-4.3/bin/sh}.
+
address@hidden configure
+Ejecuta el guión @file{configure} con algunas opciones predeterminadas, como
address@hidden/gnu/store/@dots{}}, así como las opciones especificadas por
+el parámetro @code{#:configure-flags}.
+
address@hidden build
+Ejecuta @code{make} con la lista de opciones especificadas en
address@hidden:make-flags}. Si el parámetro @code{#:parallel-build?} es
verdadero
+(por defecto), construye con @code{make -j}.
+
address@hidden check
+Ejecuta @code{make check}, u otro objetivo especificado con
address@hidden:test-target}, a menos que se pasase @code{#:tests? #f}. Si el
+parámetro @code{#:parallel-tests?} es verdadero (por defecto), ejecuta
address@hidden check -j}.
+
address@hidden install
+Ejecuta @code{make install} con las opciones enumeradas en
address@hidden:make-flags}.
+
address@hidden patch-shebangs
+Sustituye las secuencias ``#!'' en los ficheros ejecutables instalados.
+
address@hidden strip
+Extrae los símbolos de depuración de ficheros ELF (a menos que el valor de
address@hidden:strip-binaries?} sea falso), copiandolos a la salida @code{debug}
+cuando esté disponible (@pxref{Instalación de ficheros de depuración}).
address@hidden table
+
address@hidden %standard-phases
+El módulo del lado de construcción @code{(guix build gnu-build-system)}
+define @var{%standard-phases} como la lista predeterminada de fases de
+construcción. @var{%standard-phases} es una lista de pares
+símbolo/procedimiento, donde el procedimiento implementa la fase real.
+
+La lista de fases usadas para un paquete particular se puede cambiar con el
+parámetro @code{#:phases}. Por ejemplo, pasar:
+
address@hidden
+#:phases (modify-phases %standard-phases (delete 'configure))
address@hidden example
+
+significa que todas las fases descritas anteriormente serán usadas, excepto
+la fase @code{configure}.
+
+Además, este sistema de construcción asegura que el entorno ``estándar''
+para paquetes GNU está disponible. Esto incluye herramientas como GCC, libc,
+Coreutils, Bash, Make, Diffutils, grep y sed (vea el módulo @code{(guix
+build system gnu)} para una lista completa). A estas las llamamos las
address@hidden implícitas} de un paquete, porque las definiciones de paquete
+no las mencionan.
address@hidden defvr
+
+Se han definido otros objetos @code{<build-system>} para implementar otras
+convenciones y herramientas usadas por paquetes de software libre. Heredan
+la mayor parte de @var{gnu-build-system}, y se diferencian principalmente en
+el conjunto de entradas implícitamente añadidas al proceso de construcción,
+y en la lista de fases ejecutadas. Algunos de estos sistemas de construcción
+se enumeran a continuación.
+
address@hidden {Variable Scheme} ant-build-system
address@hidden(guix build-system ant)} exporta esta variable. Implementa el
+procedimiento de construcción de paquetes Java que pueden construirse con
address@hidden://ant.apache.org/, la herramienta de construcción Ant}.
+
+Añade tanto @code{ant} como el @dfn{kit de desarrollo Java} (JDK), que
+proporciona el paquete @code{icedtea}, al conjunto de entradas. Se pueden
+especificar paquetes diferentes con los parámetros @code{#:ant} y
address@hidden:jdk}, respectivamente.
+
+Cuando el paquete original no proporciona un fichero Ant apropiado, el
+parámetro @code{#:jar-name} puede usarse para generar un fichero de
+construcción Ant @file{build.xml} mínimo con tareas para construir el
+archivo jar especificado. En este caso, el parámetro @code{#:source-dir} se
+puede usar para especificar el subdirectorio de fuentes, con ``src'' como
+valor predeterminado.
+
+El parámetro @code{#:main-class} puede usarse con el fichero de construcción
+Ant mínimo para especificar la clase main del archivo jar producido. Esto
+permite ejecutar el archivo jar. El parámetro @code{#:test-include} puede
+usarse para especificar la lista de tests junit a ejecutar. El valor
+predeterminado es @code{(list "**/*Test.java")}. @code{#:test-exclude} puede
+usarse para desactivar algunas pruebas. Su valor predeterminado es
address@hidden(list "**/Abstract*.java")} ya que las clases abstractas no se
pueden
+ejecutar como pruebas.
+
+El parámetro @code{#:build-target} se puede usar para especificar la tarea
+Ant que debe ser ejecutada durante la fase @code{build}. Por defecto se
+ejecuta la tarea ``jar''.
+
address@hidden defvr
+
address@hidden {Variable Scheme} androd-ndk-build-system
address@hidden distribución Android
address@hidden Sistema de construcción NDK de Android
+Esta variable es exportada por @code{(guix build-system
+android-ndk)}. Implementa un procedimiento de construcción para paquetes
+Android NDK (kit de desarrollo nativo) usando un proceso de construcción
+específico de Guix.
+
+El sistema de construcción asume que los paquetes instalan sus ficheros de
+interfaz pública (cabeceras) en el subdirectorio "include" de la salida
+"out" y sus bibliotecas en el subdirectorio "lib" de la salida "out".
+
+También se asume que la unión de todas las dependencias de un paquete no
+tiene ficheros en conflicto.
+
+En este momento no funciona la compilación cruzada - por lo que las
+bibliotecas y los ficheros de cabecera se asumen que son locales.
+
address@hidden defvr
+
address@hidden {Variable Scheme} asdf-build-system/source
address@hidden {Variable Scheme} asdf-build-system/sbcl
address@hidden {Variable Scheme} asdf-build-system/ecl
+
+Estas variables, exportadas por @code{(guix build-system asdf)}, implementan
+procedimientos de construcción para paquetes Common Lisp usando
address@hidden://common-lisp.net/project/asdf, ``ASDF'''}. ASDF es una utilidad
+de definición de sistema para programas y bibliotecas Common Lisp.
+
+El sistema @code{asdf-build-system/source} instala los paquetes en forma de
+fuentes, y puede ser cargado usando cualquier implementación common lisp,
+vía ASDF. Los otros, como @code{asdf-build-system/sbcl}, instalan sistemas
+binarios en el formato entendido por una implementación particular. Estos
+sistemas de construcción también pueden usarse para producir programas
+ejecutables, o imágenes lisp que contengan un conjunto precargado de
+paquetes.
+
+El sistema de construcción usa convenciones de nombres. Para paquetes
+binarios, el paquete debería estar prefijado con la implementación lisp,
+como @code{sbcl-} para @code{asdf-build-system/sbcl}.
+
+Adicionalmente, el paquete de fuentes correspondiente debe etiquetarse
+usando la misma convención que los paquetes python (vea @ref{Módulos Python}),
usando el prefijo @code{cl-}.
+
+Para paquetes binarios, cada sistema debe definirse como un paquete Guix. Si
+el campo @code{origin} de un paquete contiene varios sistemas, las
+variaciones del paquete pueden crearse para construir todos los
+sistemas. Los paquetes de fuentes, los cuales usan
address@hidden/source}, pueden contener varios sistemas.
+
+Para crear programa ejecutables e imágenes, se pueden usar los
+procedimientos del lado de construcción @code{build-program} y
address@hidden Deben llamarse en la fase de construcción después de la
+fase @code{create-symlinks}, de modo que el sistema recién construido pueda
+ser usado dentro de la imagen resultante. @code{build-program} necesita una
+lista de expresiones Common Lisp a través del parámetro
address@hidden:entry-prgogram}.
+
+Si el sistema no está definido en su propio fichero @code{.asd} del mismo
+nombre, entonces se debe usar el parámetro @code{#:asd-file} para
+especificar el fichero en el que se define el sistema. Más allá, si el
+paquete define un sistema para sus pruebas en su fichero separado, se
+cargará antes de la ejecución de las pruebas si se especifica el parámetro
address@hidden:test-asd-file}. Si no se especifica, se probarán si existen los
+ficheros @code{<sistema>-tests.asd}, @code{<system>-test.asd},
address@hidden y @code{test.asd}.
+
+Si por alguna razón el paquete debe ser nombrado de una forma diferente a la
+sugerida por las convenciones de nombres, el parámetro
address@hidden:asd-system-name} puede usarse para especificar el nombre del
+sistema.
+
address@hidden defvr
+
address@hidden {Variable Scheme} cargo-build-system
address@hidden lenguaje de programación Rust
address@hidden Cargo (sistema de construcción de Rust)
+Esta variable se exporta en @code{(guix build-system cargo)}. Permite la
+construcción de paquetes usando Cargo, la herramienta de construcción del
address@hidden://www.rust-lang.org, lenguaje de programación Rust}.
+
+En su fase @code{configure}, este sistema de construcción substituye las
+dependencias especificadas en el fichero @file{Cargo.toml} con entradas a
+los paquetes Guix. La fase @code{install} instala los binarios, y también
+instala el código fuente y el fichero @file{Cargo.toml}.
address@hidden defvr
+
address@hidden Clojure (lenguaje de programación)
address@hidden sistema de construcción simple de Clojure
address@hidden {Variable Scheme} clojure-build-system
+Esta variable se exporta en @code{(guix build-system clojure)}. Implementa
+un procedimiento de construcción simple para paquetes
address@hidden://clojure.org/, Clojure} usando directamente @code{compile} en
+Clojure. La compilación cruzada no está disponible todavía.
+
+Añade @code{clojure}, @code{icedtea} y @code{zip} al conjunto de
+entradas. Se pueden especificar paquetes diferentes con los parámetros
address@hidden:clojure}, @code{#:jdk} y @code{#:zip}, respectivamente.
+
+Una lista de directorios de fuentes, directorios de pruebas y nombres de jar
+pueden especificarse con los parámetros @code{#:source-dirs},
address@hidden:test-dirs} y @code{#:jar-names}, respectivamente. El directorio
de
+compilación y la clase principal pueden especificarse con los parámetros
address@hidden:compile-dir} y @code{#:main-class}, respectivamente. Otros
+parámetros se documentan más adelante.
+
+Este sistema de construcción es una extensión de @var{ant-build-system},
+pero con las siguientes fases cambiadas:
+
address@hidden @code
+
address@hidden build
+Esta fase llama @code{compile} en Clojure para compilar los ficheros de
+fuentes y ejecuta @command{jar} para crear archivadores jar tanto de
+ficheros de fuentes y compilados de acuerdo con las listas de inclusión y
+exclusión especificadas en @code{#:aot-include} y @code{#:aot-exclude},
+respectivamente. La lista de exclusión tiene prioridad sobre la de
+inclusión. Estas listas consisten en símbolos que representan bibliotecas
+Clojure o la palabra clave especial @code{#:all} que representa todas las
+bibliotecas encontradas en los directorios de fuentes. El parámetro
address@hidden:omit-source?} determina si las fuentes deben incluirse en los
+archivadores jar.
+
address@hidden check
+Esta fase ejecuta las pruebas de acuerdo a las listas de inclusión y
+exclusión especificadas en @code{#:test-include} y @code{#:test-exclude},
+respectivamente. Sus significados son análogos a los de @code{#:aot-include}
+y @code{#:aot-exclude}, excepto que la palabra clave especial @code{#:all}
+designa ahora a todas las bibliotecas Clojure encontradas en los directorios
+de pruebas. El parámetro @code{#:tests?} determina si se deben ejecutar las
+pruebas.
+
address@hidden install
+Esta fase instala todos los archivadores jar construidos previamente.
address@hidden table
+
+Además de las previas, este sistema de construcción contiene una fase
+adicional:
+
address@hidden @code
+
address@hidden install-doc
+Esta fase instala todos los ficheros de nivel superior con un nombre que
+corresponda con @var{%doc-regex}. Una expresión regular diferente se puede
+especificar con el parámetro @code{#:doc-regex}. Todos los ficheros dentro
+(recursivamente) de los directorios de documentación especificados en
address@hidden:doc-dirs} se instalan también.
address@hidden table
address@hidden defvr
+
address@hidden {Variable Scheme} cmake-build-system
+Esta variable se exporta en @code{(guix build-system cmake)}. Implementa el
+procedimiento de construcción para paquetes que usen la
address@hidden://www.cmake.org, herramienta de construcción CMake}.
+
+Automáticamente añade el paquete @code{cmake} al conjunto de entradas. El
+paquete usado se puede especificar con el parámetro @code{#:cmake}.
+
+El parámetro @code{#:configure-flags} se toma como una lista de opciones a
+pasar a @command{cmake}. El parámetro @code{#:build-type} especifica en
+términos abstractos las opciones pasadas al compilador; su valor
+predeterminado es @code{"RelWithDebInfo"} (quiere decir ``modo de entrega
+con información de depuración''), lo que aproximadamente significa que el
+código se compila con @code{-O2 -g}, lo cual es el caso predeterminado en
+paquetes basados en Autoconf.
address@hidden defvr
+
address@hidden {Variable Scheme} dune-build-system
+This variable is exported by @code{(guix build-system dune)}. It supports
+builds of packages using @uref{https://dune.build/, Dune}, a build tool for
+the OCaml programming language. It is implemented as an extension of the
address@hidden which is described below. As such, the
address@hidden:ocaml} and @code{#:findlib} parameters can be passed to this
build
+system.
+
+Automáticamente añade el paquete @code{dune} al conjunto de entradas. El
+paquete usado se puede especificar con el parámetro @code{#:dune}.
+
+There is no @code{configure} phase because dune packages typically don't
+need to be configured. The @code{#:build-flags} parameter is taken as a
+list of flags passed to the @code{dune} command during the build.
+
+The @code{#:jbuild?} parameter can be passed to use the @code{jbuild}
+command instead of the more recent @code{dune} command while building a
+package. Its default value is @code{#f}.
+
+The @code{#:package} parameter can be passed to specify a package name,
+which is useful when a package contains multiple packages and you want to
+build only one of them. This is equivalent to passing the @code{-p}
+argument to @code{dune}.
address@hidden defvr
+
address@hidden {Variable Scheme} go-build-system
+Esta variable se exporta en @code{(guix build-system go)}. Implementa el
+procedimiento de construcción para paquetes Go usando los
address@hidden://golang.org/cmd/go/#hdr-Compile_packages_and_dependencies,
+mecanismos de construcción de Go} estándares.
+
+Se espera que la usuaria proporcione un valor para el parámetro
address@hidden:import-path} y, en algunos caso, @code{#:unpack-path}. La
address@hidden://golang.org/doc/code.html#ImportPaths, ruta de importación}
+corresponde a la ruta del sistema de ficheros esperada por los guiones de
+construcción del paquete y los paquetes referenciados, y proporciona una
+forma de referenciar un paquete Go unívocamente. Está basado típicamente en
+una combinación de la URI remota del paquete de ficheros de fuente y la
+estructura jerárquica del sistema de ficheros. En algunos casos, necesitará
+desempaquetar el código fuente del paquete en una estructura de directorios
+diferente a la indicada en la ruta de importación, y @code{#:unpack-path}
+debe usarse en dichos casos.
+
+Los paquetes que proporcionan bibliotecas Go deben instalar su código fuente
+en la salida de la construcción. El parámetro @code{#:install-source?}, cuyo
+valor por defecto es @code{#t}, controla si se instalará o no el código
+fuente. Puede proporcionarse @code{#f} en paquetes que proporcionan
+únicamente ficheros ejecutables.
address@hidden defvr
+
address@hidden {Variable Scheme} glib-or-gtk-build-system
+Esta variable se exporta en @code{(guix build-system glib-or-gtk)}. Está
+pensada para usarse con paquetes que usan GLib o GTK+.
+
+Este sistema de construcción añade las siguientes dos fases a las definidas
+en @var{gnu-build-system}:
+
address@hidden @code
address@hidden glib-or-gtk-wrap
+La fase @code{glib-or-gtk-wrap} se asegura de que los programas en
address@hidden/} son capaces de encontrar los ``esquemas'' GLib y los
address@hidden://developer.gnome.org/gtk3/stable/gtk-running.html, módulos
+GTK+}. Esto se consigue recubriendo los programas en guiones de lanzamiento
+que establecen apropiadamente las variables de entorno @code{GTK_PATH}.
+
+Es posible excluir salidas específicas del paquete del proceso de
+recubrimiento enumerando sus nombres en el parámetro
address@hidden:glib-org-gtk-wrap-excluded-outputs}. Esto es útil cuando se sabe
que
+una salida no contiene binarios GLib o GTK+, y cuando empaquetar
+gratuitamente añadiría una dependencia de dicha salida en GLib y GTK+.
+
address@hidden glib-or-gtk-compile-schemas
+La fase @code{glib-or-gtk-compile-schemas} se asegura que todos los
address@hidden://developer.gnome.org/gio/stable/glib-compile-schemas.html,
+esquemas GSettings} o GLib se compilan. La compilación la realiza el
+programa @command{glib-compile-schemas}. Lo proporciona el paquete
address@hidden:bin} que se importa automáticamente por el sistema de
+construcción. El paquete @code{glib} que proporciona
address@hidden puede especificarse con el parámetro
address@hidden:glib}.
address@hidden table
+
+Ambas fases se ejecutan tras la fase @code{install}.
address@hidden defvr
+
address@hidden {Variable Scheme} guile-build-system
+Este sistema de construcción es para paquetes Guile que consisten
+exclusivamente en código Scheme y son tan simples que no tienen ni siquiera
+un fichero Makefile, menos un guión @file{configure}. Compila código Scheme
+usando @command{guild compile} (@pxref{Compilation,,, guile, GNU Guile
+Reference Manual}) e instala los ficheros @file{.scm} y @file{.go} en el
+lugar correcto. También instala documentación.
+
+Este sistema de construcción permite la compilación cruzada usando la opción
address@hidden de @command{guild compile}.
+
+Los paquetes construidos con @code{guile-build-system} deben proporcionar un
+paquete Guile en su campo @code{native-inputs}.
address@hidden defvr
+
address@hidden {Variable Scheme} minify-build-system
+Esta variable se exporta en @code{(guix build-system minify)}. Implementa un
+procedimiento de minificación para paquetes JavaScript simples.
+
+Añade @code{uglify-js} al conjunto de entradas y lo utiliza para comprimir
+todos los ficheros JavaScript en el directorio @file{src}. Un paquete de
+minificación diferente puede especificarse con el parámetro
address@hidden:uglify-js}, pero se espera que el paquete escriba el código
+minificado en la salida estándar.
+
+Cuando los ficheros JavaScript de entrada no se encuentran en el directorio
address@hidden, el parámetro @code{#:javascript-files} puede usarse para
+especificar una lista de nombres de fichero que proporcionar al minificador.
address@hidden defvr
+
address@hidden {Variable Scheme} ocaml-build-system
+Esta variable se exporta en @code{(guix build-system ocaml)}. Implementa un
+procedimiento de construcción para paquetes @uref{https://ocaml.org, OCaml},
+que consiste en seleccionar el conjunto correcto de órdenes a ejecutar para
+cada paquete. Los paquetes OCaml pueden esperar la ejecución de muchas
+ordenes diferentes. Este sistema de construcción probará algunas de ellas.
+
+Cuando el paquete tiene un fichero @file{setup.ml} presente en el nivel
+superior, se ejecuta @code{ocaml setup.ml -configure}, @code{ocaml setup.ml
+-build} y @code{ocaml setup.ml -install}. El sistema de construcción asumirá
+que este fichero se generó con @uref{http://oasis.forge.ocamlcore.org/
+OASIS} y se encargará de establecer el prefijo y la habilitación de las
+pruebas si no están deshabilitadas. Puede pasar opciones de configuración y
+construcción con @code{#:configure-flags} y @code{#:build-flags},
+respectivamente. El parámetro @code{#:test-flags} puede usarse para cambiar
+el conjunto de opciones usadas para activar las pruebas. El parámetro
address@hidden:use-make?} puede usarse para ignorar este sistema en las fases de
+construcción e instalación.
+
+Cuando el paquete tiene un fichero @file{configure}, se asume que es un
+guión de configuración hecho a mano que necesita un formato de parámetros
+diferente a los del sistema @code{gnu-build-system}. Puede añadir más
+opciones con el parámetro @code{#:configure-flags}.
+
+Cuando el paquete tiene un fichero @file{Makefile} (o @code{#:use-make?} es
address@hidden), será usado y se pueden proporcionar más opciones para las fases
+de construcción y e instalación con el parámetro @code{#:make-flags}.
+
+Por último, algunos paquetes no tienen estos ficheros y usan unas
+localizaciones de algún modo estándares para su sistema de construcción. En
+este caso, el sistema de construcción ejecutará @code{ocaml pkg/pkg.ml} o
address@hidden pkg/build.ml} y se hará cargo de proporcionar la ruta del módulo
+findlib necesario. Se pueden pasar opciones adicionales con el parámetro
address@hidden:build-flags}. De la instalación se hace cargo
address@hidden En este caso, el paquete @code{opam} debe añadirse
+al campo @code{native-inputs} de la definición del paquete.
+
+Fíjese que la mayoría de los paquetes OCaml asumen su instalación en el
+mismo directorio que OCaml, que no es el comportamiento deseado en guix. En
+particular, intentarán instalar ficheros @file{.so} en su directorio de
+módulos, normalmente lo adecuado puesto que es el directorio del compilador
+de OCaml. No obstante, en guix estas bibliotecas no se pueden encontrar allí
+y usamos @code{CAML_LD_LIBRARY_PATH}. Esta variable apunta a
address@hidden/ocaml/site-lib/stubslibs} y allí es donde las bibliotecas
address@hidden deben instalarse.
address@hidden defvr
+
address@hidden {Variable Scheme} python-build-system
+Esta variable se exporta en @code{(guix build-system python)}. Implementa el
+procedimiento más o menos estándar de construcción usado por paquetes
+Python, que consiste en la ejecución de @code{python setup.py build} y
address@hidden setup.py install --prefix=/gnu/store/@dots{}}.
+
+Para que instalan programas independientes Python bajo @code{bin/}, se
+encarga de envolver dichos programas de modo que su variable de entorno
address@hidden apunte a las bibliotecas Python de las que dependen.
+
+Se puede especificar el paquete Python usado para llevar a cabo la
+construcción con el parámetro @code{#:python}. Esta es habitualmente una
+forma de forzar la construcción de un paquete para una versión específica
+del intérprete Python, lo que puede ser necesario si el paquete es
+compatible únicamente con una versión del intérprete.
+
+Por defecto guix llama a @code{setup.py} bajo el control de
address@hidden de manera similar a @command{pip}. Algunos paquetes no son
+compatibles con setuptools (y pip), por lo que puede deshabilitar esta
+configuración estableciendo el parámetro @code{#:use-setuptools} a
address@hidden
address@hidden defvr
+
address@hidden {Variable Scheme} perl-build-system
+Esta variable se exporta en @code{(guix build-system perl)}. Implementa el
+procedimiento de construcción estándar para paquetes Perl, lo que o bien
+consiste en la ejecución de @code{perl Build.PL
+--prefix=/gnu/store/@dots{}}, seguido de @code{Build} y @code{Build
+install}; o en la ejecución de @code{perl Makefile.PL
+PREFIX=/gnu/store/@dots{}}, seguida de @code{make} y @code{make install},
+dependiendo de si @code{Build.PL} o @code{Makefile.PL} están presentes en la
+distribución del paquete. El primero tiene preferencia si existen tanto
address@hidden como @code{Makefile.PL} en la distribución del paquete. Esta
+preferencia puede invertirse especificando @code{#t} en el parámetro
address@hidden:make-maker?}.
+
+La invocación inicial de @code{perl Makefile.PL} o @code{perl Build.PL} pasa
+a su vez las opciones especificadas por los parámetros
address@hidden:make-maker-flags} o @code{#:module-build-flags}, respectivamente.
+
+El paquete Perl usado puede especificarse con @code{#:perl}.
address@hidden defvr
+
address@hidden {Variable Scheme} r-build-system
+Esta variable se exporta en @code{(guix build-system r)}. Implementa el
+procedimiento de construcción usados por paquetes
address@hidden://r-project.org, R}, lo que esencialmente es poco más que la
+ejecución de @code{R CMD INSTALL --library=/gnu/store/@dots{}} en un entorno
+donde @code{R_LIBS_SITE} contiene las rutas de todos los paquetes R de
+entrada. Las pruebas se ejecutan tras la instalación usando la función R
address@hidden::testInstalledPackage}.
address@hidden defvr
+
address@hidden {Variable Scheme} rakudo-build-system
+This variable is exported by @code{(guix build-system rakudo)} It implements
+the build procedure used by @uref{https://rakudo.org/, Rakudo} for
address@hidden://perl6.org/, Perl6} packages. It installs the package to
address@hidden/gnu/store/@dots{}/NAME-VERSION/share/perl6} and installs the
+binaries, library files and the resources, as well as wrap the files under
+the @code{bin/} directory. Tests can be skipped by passing @code{#f} to the
address@hidden parameter.
+
+Which rakudo package is used can be specified with @code{rakudo}. Which
+perl6-tap-harness package used for the tests can be specified with
address@hidden:prove6} or removed by passing @code{#f} to the
@code{with-prove6?}
+parameter. Which perl6-zef package used for tests and installing can be
+specified with @code{#:zef} or removed by passing @code{#f} to the
address@hidden parameter.
address@hidden defvr
+
address@hidden {Variable Scheme} texlive-build-system
+Esta variable se exporta en @code{(guix build-system texlive)}. Se usa para
+construir paquetes TeX en modo de procesamiento de lotes con el motor
+especificado. El sistema de construcción fija la variable @code{TEXINPUTS}
+para encontrar todos los ficheros de fuentes TeX en las entradas.
+
+Por defecto ejecuta @code{luatex} en todos los ficheros que terminan en
address@hidden Un motor y formato diferente puede especificarse con el
+parámetro @code{#:tex-format}. Los diferentes objetivos de construcción
+pueden especificarse con el parámetro @code{#:build-targets}, que espera una
+lista de nombres de fichero. El sistema de construcción añade únicamente
address@hidden y @code{texlive-latex-base} (ambos desde @code{(gnu
+packages tex)} a las entradas. Ambos pueden forzarse con los parámetros
address@hidden:texlive-bin} y @code{#:texlive-latex-base} respectivamente.
+
+El parámetro @code{#:tex-directory} le dice al sistema de construcción dónde
+instalar los ficheros construidos bajo el árbol texmf.
address@hidden defvr
+
address@hidden {Variable Scheme} ruby-build-system
+Esta variable se exporta en @code{(guix build-system ruby)}. Implementa el
+procedimiento de construcción de RubyGems usado por los paquetes Ruby, que
+implica la ejecución de @code{gem build} seguida de @code{gem install}.
+
+El campo @code{source} de un paquete que usa este sistema de construcción
+típicamente se refiere a un archivo gem, ya que este es el formato usado por
+las desarrolladoras Ruby cuando publican su software. El sistema de
+construcción desempaqueta el archivo gem, potencialmente parchea las
+fuentes, ejecuta la batería de pruebas, vuelve a empaquetar el archivo gem y
+lo instala. Adicionalmente, directorios y archivadores tar pueden
+referenciarse para permitir la construcción de archivos gem no publicados
+desde Git o un archivador tar de publicación de fuentes tradicional.
+
+Se puede especificar el paquete Ruby usado mediante el parámetro
address@hidden:ruby}. Una lista de opciones adicionales pueden pasarse a la
orden
address@hidden en el parámetro @code{#:gem-flags}.
address@hidden defvr
+
address@hidden {Variable Scheme} waf-build-system
+Esta variable se exporta en @code{(guix build-system waf)}. Implementa un
+procedimiento de construcción alrededor del guión @code{waf}. Las fases
address@hidden, @code{build} y @code{install}---se implementan
+pasando sus nombres como parámetros al guión @code{waf}.
+
+El guión @code{waf} es ejecutado por el intérprete Python. El paquete Python
+usado para la ejecución puede ser especificado con el parámetro
address@hidden:python}.
address@hidden defvr
+
address@hidden {Variable Scheme} scons-build-system
+Esta variable se exporta en @code{(guix build-system scons)}. Implementa en
+procedimiento de construcción usado por la herramienta de construcción de
+software SCons. Este sistema de construcción ejecuta @code{scons} para
+construir el paquete, @code{scons test} para ejecutar las pruebas y después
address@hidden install} para instalar el paquete.
+
+Las opciones adicionales a pasar a @code{scons} se pueden especificar con el
+parámetro @code{#:scons-flags}. La versión de Python usada para ejecutar
+SCons puede especificarse seleccionando el paquete SCons apropiado con el
+parámetro @code{#:scons}.
address@hidden defvr
+
address@hidden {Variable Scheme} haskell-build-system
+Esta variable se exporta en @code{(guix build-system haskell)}. Implementa
+el procedimiento de construcción Cabal usado por paquetes Haskell, el cual
+implica la ejecución de @code{runhaskell Setup.hs configure
+--prefix=/gnu/store/@dots{}} y @code{runhaskell Setup.hs build}. En vez de
+instalar el paquete ejecutando @code{runhaskell Setup.hs install}, para
+evitar el intento de registro de bibliotecas en el directorio de
+solo-lectura del compilador en el almacén, el sistema de construcción usa
address@hidden Setup.hs copy}, seguido de @code{runhaskell Setup.hs
+register}. Además, el sistema de construcción genera la documentación del
+paquete ejecutando @code{runhaskell Setup.hs haddock}, a menos que se pasase
address@hidden:haddock? #f}. Parámetros opcionales de Haddock pueden
proporcionarse
+con la ayuda del parámetro @code{#:haddock-flags}. Si el fichero
address@hidden no es encontrado, el sistema de construcción busca
address@hidden a su vez.
+
+El compilador Haskell usado puede especificarse con el parámetro
address@hidden:haskell} cuyo valor predeterminado es @code{ghc}.
address@hidden defvr
+
address@hidden {Variable Scheme} dub-build-system
+Esta variable se exporta en @code{(guix build-system dub)}. Implementa el
+procedimiento de construcción Dub usado por los paquetes D, que implica la
+ejecución de @code{dub build} y @code{dub run}. La instalación se lleva a
+cabo con la copia manual de los ficheros.
+
+El compilador D usado puede ser especificado con el parámetro @code{#:ldc}
+cuyo valor predeterminado es @code{ldc}.
address@hidden defvr
+
address@hidden {Variable Scheme} emacs-build-system
+Esta variable se exporta en @code{(guix build-system emacs)}. Implementa un
+procedimiento de instalación similar al propio sistema de empaquetado de
+Emacs (@pxref{Packages,,, emacs, The GNU Emacs Manual}).
+
+Primero crea el fichero @address@hidden, tras lo que
+compila todos los ficheros Emacs Lisp. De manera diferente al sistema de
+paquetes de Emacs, los ficheros de documentación Info se mueven al
+directorio estándar de documentación y se borra el fichero @file{dir}. Cada
+paquete se instala en su propio directorio bajo
address@hidden/emacs/site-lisp/guix.d}.
address@hidden defvr
+
address@hidden {Variable Scheme} font-build-system
+Esta variable se exporta en @code{(guix build-system font)}. Implementa un
+procedimiento de instalación para paquetes de fuentes donde las proveedoras
+originales proporcionan ficheros de tipografía TrueType, OpenType, etc.@:
+precompilados que simplemente necesitan copiarse en su lugar. Copia los
+ficheros de tipografías a las localizaciones estándar en el directorio de
+salida.
address@hidden defvr
+
address@hidden {Variable Scheme} meson-build-system
+Esta variable se exporta en @code{(guix build-system meson)}. Implementa el
+procedimiento de construcción para paquetes que usan
address@hidden://mesonbuild.com, Meson} como su sistema de construcción.
+
+Añade Meson y @uref{https://ninja-build.org/, Ninja} al conjunto de
+entradas, y pueden cambiarse con los parámetros @code{#:meson} y
address@hidden:ninja} en caso necesario. La versión de Meson predeterminada es
address@hidden, la cual es especial puesto que no limpia el
address@hidden de los binarios y bibliotecas durante la instalación.
+
+Este sistema de construcción es una extensión de @var{gnu-build-system},
+pero con las siguientes fases cambiadas por otras específicas para Meson.
+
address@hidden @code
+
address@hidden configure
+Esta fase ejecuta @code{meson} con las opciones especificadas en
address@hidden:configure-flags}. La opción @code{--build-type} siempre se fija a
address@hidden a menos que se especifique algo distinto en
address@hidden:build-type}.
+
address@hidden build
+Esta fase ejecuta @code{ninja} para construir el paquete en paralelo por
+defecto, pero esto puede cambiarse con @code{#:parallel-build?}.
+
address@hidden check
+Esta fase ejecuta @code{ninja} con el objetivo especificado en
address@hidden:test-target}, cuyo valor predeterminado es @code{"test"}.
+
address@hidden install
+Esta fase ejecuta @code{ninja install} y no puede cambiarse.
address@hidden table
+
+Aparte de estas, el sistema de ejecución también añade las siguientes fases:
+
address@hidden @code
+
address@hidden fix-runpath
+Esta fase se asegura de que todos los binarios pueden encontrar las
+bibliotecas que necesitan. Busca las bibliotecas necesarias en
+subdirectorios del paquete en construcción, y añade estas a @code{RUNPATH}
+en caso necesario. También elimina referencias a bibliotecas introducidas en
+la fase de construcción por @code{meson-for-build}, como las dependencias de
+las pruebas, que no se necesitan realmente para la ejecución del programa.
+
address@hidden glib-or-gtk-wrap
+Esta fase es la fase proporcionada por @code{glib-or-gtk-build-system}, y no
+está activa por defecto. Puede activarse con @code{#:glib-or-gtk}.
+
address@hidden glib-or-gtk-compile-schemas
+Esta fase es la fase proporcionada por @code{glib-or-gtk-build-system}, y no
+está activa por defecto. Puede activarse con @code{#:glib-or-gtk}.
address@hidden table
address@hidden defvr
+
address@hidden {Scheme Variable} linux-module-build-system
address@hidden allows building Linux kernel modules.
+
address@hidden fases de construcción
+This build system is an extension of @var{gnu-build-system}, but with the
+following phases changed:
+
address@hidden @code
+
address@hidden configure
+This phase configures the environment so that the Linux kernel's Makefile
+can be used to build the external kernel module.
+
address@hidden build
+This phase uses the Linux kernel's Makefile in order to build the external
+kernel module.
+
address@hidden install
+This phase uses the Linux kernel's Makefile in order to install the external
+kernel module.
address@hidden table
+
+It is possible and useful to specify the Linux kernel to use for building
+the module (in the "arguments" form of a package using the
+linux-module-build-system, use the key #:linux to specify it).
address@hidden defvr
+
+Por último, para paquetes que no necesiten nada tan sofisticado se
+proporciona un sistema de construcción ``trivial''. Es trivial en el sentido
+de que no proporciona prácticamente funcionalidad: no incorpora entradas
+implícitas y no tiene una noción de fases de construcción.
+
address@hidden {Variable Scheme} trivial-build-system
+Esta variable se exporta en @code{(guix build-system trivial)}.
+
+Este sistema de construcción necesita un parámetro @code{#:builder}. Este
+parámetro debe ser una expresión Scheme que construya la(s) salida(s) del
+paquete---como en @code{build-expression->derivation} (@pxref{Derivaciones,
address@hidden>derivation}}).
address@hidden defvr
+
address@hidden El almacén
address@hidden El almacén
+
address@hidden almacén
address@hidden elementos del almacén
address@hidden rutas del almacén
+
+Conceptualmente, el @dfn{almacén} es el lugar donde se almacenan las
+derivaciones cuya construcción fue satisfactoria---por defecto,
address@hidden/gnu/store}. Los subdirectorios en el almacén se denominan
address@hidden del almacén} o @dfn{rutas del almacén} en ocasiones. El
+almacén tiene una base de datos asociada que contiene información como las
+rutas del almacén a las que referencia cada ruta del almacén, y la lista de
+elementos @emph{válidos} del almacén---los resultados de las construcciones
+satisfactorias. Esta base de datos reside en
address@hidden@var{localstatedir}/guix/db}, donde @var{localstatedir} es el
+directorio de estado especificado @i{vía} @option{--localstatedir} en tiempo
+de configuración, normalmente @file{/var}.
+
+El almacén @emph{siempre} es accedido a través del daemon en delegación de
+sus clientes (@pxref{Invocación de guix-daemon}). Para manipular el almacén,
los
+clientes se conectan al daemon por un socket de dominio Unix, le envían
+peticiones y leen el resultado---esto son llamadas a procedimientos remotos,
+o RPC.
+
address@hidden Nota
+Las usuarias @emph{nunca} deben modificar ficheros directamente bajo el
+directorio @file{/gnu/store}. Esto llevaría a inconsistencias y rompería las
+premisas de inmutabilidad del modelo funcional de Guix
+(@pxref{Introducción}).
+
address@hidden de guix gc, @command{guix gc --verify}}, para información sobre
+cómo comprobar la integridad del almacén e intentar recuperarse de
+modificaciones accidentales.
address@hidden quotation
+
+El módulo @code{(guix store)} proporciona procedimientos para conectarse al
+daemon y realizar RPCs. Estos se describen más adelante. Por defecto,
address@hidden, y por tanto todas las órdenes @command{guix}, se
+conectan al daemon local o a la URI especificada en la variable de entorno
address@hidden
+
address@hidden {Variable de entorno} GUIX_DAEMON_SOCKET
+Cuando se ha definido, el valor de esta variable debe ser un nombre de
+fichero o una URI designando el punto de conexión del daemon. Cuando es un
+nombre de fichero, denota un socket de dominio Unix al que
+conectarse. Además de nombres de ficheros, los esquemas de URI aceptados
+son:
+
address@hidden @code
address@hidden file
address@hidden unix
+Estos son equivalentes a los sockets de dominio
+Unix. @code{file:///var/guix/daemon-socket/socket} es equivalente a
address@hidden/var/guix/daemon-socket/socket}.
+
address@hidden guix
address@hidden daemon, acceso remoto
address@hidden acceso remoto al daemon
address@hidden daemon, configuración en cluster
address@hidden daemon, configuración en cluster
+Estas URI denotan conexiones sobre TCP/IP, sin cifrado ni verificación de la
+máquina remota. La URI debe especificar el nombre de máquina y opcionalmente
+un número de puerto (por defecto se usa el puerto 44146):
+
address@hidden
+guix://principal.guix.example.org:1234
address@hidden example
+
+Esta configuración es apropiada para redes locales, como clusters, donde
+únicamente los nodos de confianza pueden conectarse al daemon de
+construcción en @code{principal.guix.example.org}.
+
+La opción @code{--listen} de @command{guix-daemon} puede usarse para
+indicarle que escuche conexiones TCP (@pxref{Invocación de guix-daemon,
address@hidden).
+
address@hidden ssh
address@hidden acceso SSH a los daemons de construcción
+Estas URI le permiten conectarse a un daemon remoto sobre address@hidden
+característica necesita Guile-SSH (@pxref{Requisitos}).}. Una URL típica
+debería ser algo así:
+
address@hidden
+ssh://carlos@@guix.example.org:22
address@hidden example
+
+Como con @command{guix copy}, se tienen en cuenta los ficheros habituales de
+configuración del cliente OpenSSH (@pxref{Invocación de guix copy}).
address@hidden table
+
+Esquemas URI adicionales pueden ser aceptados en el futuro.
+
address@hidden XXX: Remove this note when the protocol incurs fewer round trips
address@hidden and when (guix derivations) no longer relies on file system
access.
address@hidden Nota
+La conexión con daemon de construcción remotos se considera experimental en
address@hidden Por favor, contacte con nosotras para compartir cualquier
+problema o sugerencias que pueda tener (@pxref{Contribuir}).
address@hidden quotation
address@hidden defvr
+
address@hidden {Procedimiento Scheme} open-connection address@hidden
[#:reserve-space? #t]
+Abre una conexión al daemon a través del socket de dominio Unix apuntado por
address@hidden (una cadena). Cuando @var{reserve-space?} es verdadero, le indica
+que reserve un poco de espacio extra en el sistema de ficheros de modo que
+el recolector de basura pueda operar incluso cuando el disco se
+llene. Devuelve un objeto servidor.
+
+El valor por defecto de @var{uri} es @var{%default-socket-path}, que ese la
+ruta esperada según las opciones pasadas a @code{configure}.
address@hidden deffn
+
address@hidden {Procedimiento Scheme} close-connection @var{servidor}
+Cierra la conexión al @var{servidor}.
address@hidden deffn
+
address@hidden {Variable Scheme} current-build-output-port
+Esta variable está enlazada a un parámetro SRFI-39, que referencia al puerto
+donde los logs de construcción y error enviados por el daemon deben
+escribirse.
address@hidden defvr
+
+Los procedimientos que realizan RPCs toman todos como primer parámetro un
+objeto servidor.
+
address@hidden {Procedimiento Scheme} valid-path? @var{servidor} @var{ruta}
address@hidden elementos inválidos del almacén
+Devuelve @code{#t} cuando @var{ruta} designa un elemento válido del almacén
+y @code{#f} en otro caso (un elemento no-válido puede existir en el disco
+pero aun así no ser válido, por ejemlo debido a que es el resultado de una
+construcción interumpida o fallida).
+
+Una condición @code{&store-protocol-error} se eleva si @var{ruta} no
+contiene como prefijo el directorio del almacén (@file{/gnu/store}).
address@hidden deffn
+
address@hidden {Procedimiento Scheme} add-text-to-store @var{servidor}
@var{nombre} @var{texto} address@hidden
+Añade @var{texto} bajo el fichero @var{nombre} en el almacén, y devuelve su
+ruta en el almacén. @var{referencias} es la lista de rutas del almacén
+referenciadas por la ruta del almacén resultante.
address@hidden deffn
+
address@hidden {Procedimiento Scheme} build-derivations @var{servidor}
@var{derivaciones}
+Construye @var{derivaciones} (una lista de objetos @code{<derivation>} o
+rutas de derivaciones) y devuelve el control cuando se termina de
+construirlas. Devuelve @code{#t} en caso de éxito.
address@hidden deffn
+
+Fijese que el módulo @code{(guix monads)} proporciona una mónada así como
+versiones monádicas de los procedimientos previos, con el objetivo de hacer
+más conveniente el trabajo con código que accede al almacén (@pxref{La mónada
del almacén}).
+
address@hidden FIXME
address@hidden sección actualmente está incompleta.}
+
address@hidden Derivaciones
address@hidden Derivaciones
+
address@hidden derivaciones
+Las acciones de construcción a bajo nivel y el entorno en el que se realizan
+se representan mediante @dfn{derivaciones}. Una derivación contiene las
+siguientes piezas de información:
+
address@hidden
address@hidden
+Las salidas de la derivación---las derivaciones producen al menos un fichero
+o directorio en el almacén, pero pueden producir más.
+
address@hidden
address@hidden tiempo de construcción, dependencias
address@hidden dependencias, tiempo de construcción
+Las entradas de las derivaciones---es decir, sus dependencias de tiempo de
+construcción---, que pueden ser otras derivaciones o simples ficheros en el
+almacén (parches, guiones de construcción, etc.).
+
address@hidden
+El tipo de sistema objetivo de la derivación---por ejemplo,
address@hidden
+
address@hidden
+El nombre de fichero del guión de construcción en el almacén, junto a los
+parámetros que se le deben pasar.
+
address@hidden
+Una lista de variables de entorno a ser definidas.
+
address@hidden itemize
+
address@hidden ruta de derivación
+Las derivaciones permiten a los clientes del daemon comunicar acciones de
+construcción al almacén. Existen en dos formas: como una representación en
+memoria, tanto en el lado del cliente como el del daemon, y como ficheros en
+el almacén cuyo nombre termina en @code{.drv}---estos ficheros se conocen
+como @dfn{rutas de derivación}. Las rutas de derivación pueden pasarse al
+procedimiento @code{build-derivations} para realizar las acciones de
+construcción que prescriben (@pxref{El almacén}).
+
address@hidden derivaciones de salida fija
+Operaciones como la descarga de ficheros y las instantáneas de un control de
+versiones para las cuales el hash del contenido esperado se conoce
+previamente se modelan como @dfn{derivaciones de salida fija}. Al contrario
+que las derivaciones normales, las salidas de una derivación de salida fija
+son independientes de sus entradas---por ejemplo, la descarga del código
+fuente produce el mismo resultado independientemente del método de descarga
+y las herramientas usadas.
+
address@hidden references
address@hidden tiempo de ejecución, dependencias
address@hidden dependencias, tiempo de ejecución
+The outputs of derivations---i.e., the build results---have a set of
address@hidden, as reported by the @code{references} RPC or the
address@hidden gc --references} command (@pxref{Invocación de guix gc}).
+References are the set of run-time dependencies of the build results.
+References are a subset of the inputs of the derivation; this subset is
+automatically computed by the build daemon by scanning all the files in the
+outputs.
+
+El módulo @code{(guix derivations)} proporciona una representación de
+derivaciones como objetos Scheme, junto a procedimientos para crear y
+manipular de otras formas derivaciones. La primitiva de más bajo nivel para
+crear una derivación es el procedimiento @code{derivation}:
+
address@hidden {Procedimiento Scheme} derivation @var{almacén} @var{nombre}
@var{constructor} @
+ @var{args} [#:outputs '("out")] [#:hash #f] [#:hash-algo #f] @
+ [#:recursive? #f] [#:inputs '()] [#:env-vars '()] @
+ [#:system (%current-system)] [#:references-graphs #f] @
+ [#:allowed-references #f] [#:disallowed-references #f] @
+ [#:leaked-env-vars #f] [#:local-build? #f] @
+ [#:substitutable? #t] [#:properties '()]
+Construye una derivación con los parámetros proporcionados, y devuelve el
+objeto @code{<derivation>} resultante.
+
+Cuando se proporcionan @var{hash} y @var{hash-algo}, una @dfn{derivación de
+salida fija} se crea---es decir, una cuyo resultado se conoce de antemano,
+como la descarga de un fichero. Si, además, @var{recursive?} es verdadero,
+entonces la salida fijada puede ser un fichero ejecutable o un directorio y
address@hidden debe ser el hash de un archivador que contenga esta salida.
+
+Cuando @var{references-graphs} es verdadero, debe ser una lista de pares de
+nombre de fichero/ruta del almacén. En ese caso, el grafo de referencias de
+cada ruta del almacén se exporta en el entorno de construcción del fichero
+correspondiente, en un formato de texto simple.
+
+Cuando @var{allowed-references} es verdadero, debe ser una lista de
+elementos del almacén o salidas a las que puede hacer referencia la salida
+de la derivación. Del mismo modo, @var{disallowed-references}, en caso de
+ser verdadero, debe ser una lista de cosas a las que las salidas @emph{no}
+pueden hacer referencia.
+
+Cuando @var{leaked-env-vars} es verdadero, debe ser una lista de cadenas que
+denoten variables de entorno que se permite ``escapar'' del entorno del
+daemon al entorno de construcción. Esto es únicamente aplicable a
+derivaciones de salida fija---es decir, cuando @var{hash} es verdadero. El
+uso principal es permitir que variables como @code{http_proxy} sean pasadas
+a las derivaciones que descargan ficheros.
+
+Cuando @var{local-build?} es verdadero, declara que la derivación no es una
+buena candidata para delegación y debe ser construida localmente
+(@pxref{Configuración de delegación del daemon}). Este es el caso para
pequeñas derivaciones
+donde los costes de transferencia de datos sobrepasarían los beneficios.
+
+Cuando @var{substitutable?} es falso, declara que las sustituciones de la
+salida de la derivación no deben usarse (@pxref{Sustituciones}). Esto es útil,
+por ejemplo, cuando se construyen paquetes que capturan detalles sobre el
+conjunto de instrucciones de la CPU anfitriona.
+
address@hidden debe ser una lista asociada que describe ``propiedades'' de
+la derivación. Debe mantenerse tal cual, sin interpretar, en la derivación.
address@hidden deffn
+
address@hidden
+Esto es un ejemplo con un guión de shell como constructor, asumiendo que
address@hidden es una conexión abierta al daemon, @var{bash} apunta al
+ejecutable Bash en el almacén:
+
address@hidden
+(use-modules (guix utils)
+ (guix store)
+ (guix derivations))
+
+(let ((constructor ; añade el guión de Bash al almacén
+ (add-text-to-store store "mi-constructor.sh"
+ "echo hola mundo > $out\n" '())))
+ (derivation almacen "foo"
+ bash `("-e" ,builder)
+ #:inputs `((,bash) (,constructor))
+ #:env-vars '(("HOME" . "/sindirectorio"))))
address@hidden #<derivation /gnu/store/@dots{}-foo.drv =>
/gnu/store/@dots{}-foo>
address@hidden lisp
+
+Como puede suponerse, el uso directo de esta primitiva es algo
+enrevesado. Una mejor aproximación es escribir guiones de construcción en
+Scheme, ¡por supuesto! La mejor forma de hacerlo es escribir el código de
+construcción como una ``expresión-G'', y pasarla a
address@hidden>derivation}. Para más información, @pxref{Expresiones-G}.
+
+En otros tiempos, @code{gexp->derivation} no existía y la creación de
+derivaciones con código de construcción escrito en Scheme se conseguía con
address@hidden>derivation}, documentada más adelante. Este
+procedimiento está ahora obsoleto en favor del procedimiento
address@hidden>derivation} mucho más conveniente.
+
address@hidden {Procedimiento Scheme} build-expression->derivation
@var{almacén} @
+ @var{nombre} @var{exp} @
+ [#:system (%current-system)] [#:inputs '()] @
+ [#:outputs '("out")] [#:hash #f] [#:hash-algo #f] @
+ [#:recursive? #f] [#:env-vars '()] [#:modules '()] @
+ [#:references-graphs #f] [#:allowed-references #f] @
+ [#:disallowed-references #f] @
+ [#:local-build? #f] [#:substitutable? #t] [#:guile-for-build #f]
+Devuelve una derivación que ejecuta la expresión Scheme @var{exp} como un
+constructor para la derivación @var{nombre}. @var{inputs} debe ser una lista
+de tupletas @code{(nombre ruta-drv sub-drv)}; cuando @var{sub-drv} se omite,
+se asume @code{"out"}. @var{modules} es una lista de nombres de módulos
+Guile de la ruta actual de búsqueda a copiar en el almacén, compilados, y
+poner a disposición en la ruta de carga durante la ejecución de
address@hidden ejemplo, @code{((guix build utils) (guix build
+gnu-build-system))}.
+
address@hidden se evalúa en un entorno donde @code{%outputs} está asociada a una
+lista de pares salida/ruta, y donde @code{%build-inputs} está asociada a una
+lista de pares cadena/ruta-de-salida que provienen de @var{inputs}. De
+manera opcional, @var{env-vars} es una lista de pares de cadenas que
+especifican el nombre y el valor de las variables de entorno visibles al
+constructor. El constructor termina pasando el resultado de @var{exp} a
address@hidden; por tanto, cuando @var{exp} devuelve @code{#f}, la construcción
+se considera fallida.
+
address@hidden se construye usando @var{guile-for-build} (una derivación).
Cuando
address@hidden se omite o es @code{#f}, el valor del fluido
address@hidden se usa en su lugar.
+
+Véase el procedimiento @code{derivation} para el significado de
address@hidden, @var{allowed-references},
address@hidden, @var{local-build?} y @var{substitutable?}.
address@hidden deffn
+
address@hidden
+Aquí está un ejemplo de derivación de salida única que crea un directorio
+que contiene un fichero:
+
address@hidden
+(let ((constructor '(let ((salida (assoc-ref %outputs "out")))
+ (mkdir salida) ; crea /gnu/store/@dots{}-goo
+ (call-with-output-file (string-append salida "/prueba")
+ (lambda (p)
+ (display '(hola guix) p))))))
+ (build-expression->derivation almacen "goo" constructor))
+
address@hidden #<derivation /gnu/store/@dots{}-goo.drv => @dots{}>
address@hidden lisp
+
+
address@hidden La mónada del almacén
address@hidden La mónada del almacén
+
address@hidden mónada
+
+Los procedimientos que operan en el almacén descritos en la sección previa
+toman todos una conexión abierta al daemon de construcción en su primer
+parámetro. Aunque el modelo subyacente es funcional, tienen o bien efectos
+secundarios o dependen del estado actual del almacén.
+
+Lo anterior es inconveniente: la conexión al daemon de construcción tiene
+que proporcionarse en todas estas funciones, haciendo imposible la
+composición de funciones que no toman ese parámetro con funciones que sí lo
+hacen. Lo último puede ser problemático: ya que las operaciones del almacén
+tienen efectos secundarios y/o dependen del estado externo, deben ser
+secuenciadas de manera adecuada.
+
address@hidden valores monádicos
address@hidden funciones monádicas
+Aquí es donde entra en juego el módulo @code{(guix monads)}. Este módulo
+proporciona un entorno para trabajar con @dfn{mónadas}, y una mónada
+particularmente útil para nuestros usos, la @dfn{mónada del almacén}. Las
+mónadas son una construcción que permite dos cosas: asociar ``contexto'' con
+valores (en nuestro caso, el contexto es el almacén), y la construcción de
+secuencias de computaciones (aquí computaciones incluye accesos al
+almacén). Los valores en una mónada---valores que transportan este contexto
+adicional---se llaman @dfn{valores monádicos}; los procedimientos que
+devuelven dichos valores se llaman @dfn{procedimientos monádicos}.
+
+Considere este procedimiento ``normal'':
+
address@hidden
+(define (enlace-sh almacen)
+ ;; Devuelve una derivación que enlaza el ejecutable 'bash'.
+ (let* ((drv (package-derivation store bash))
+ (out (derivation->output-path drv))
+ (sh (string-append out "/bin/bash")))
+ (build-expression->derivation store "sh"
+ `(symlink ,sh %output))))
address@hidden example
+
+Mediante el uso de @code{(guix monads)} y @code{(guix gexp)}, puede
+reescribirse como una función monádica:
+
address@hidden
+(define (enlace-sh)
+ ;; Lo mismo, pero devuelve un valor monádico.
+ (mlet %store-monad ((drv (package->derivation bash)))
+ (gexp->derivation "sh"
+ #~(symlink (string-append #$drv "/bin/bash")
+ #$output))))
address@hidden example
+
+Hay varias cosas a tener en cuenta en la segunda versión: el parámetro
address@hidden ahora es implícito y es ``hilado en las llamadas a los
+procedimientos monádicos @code{package->derivation} y
address@hidden>derivation}, y el valor monádico devuelto por
address@hidden>derivation} es @dfn{asociado} mediante el uso de @code{mlet}
+en vez de un simple @code{let}.
+
+Al final, la llamada a @code{package->derivation} puede omitirse ya que
+tendrá lugar implícitamente, como veremos más adelante
+(@pxref{Expresiones-G}):
+
address@hidden
+(define (enlace-sh)
+ (gexp->derivation "sh"
+ #~(symlink (string-append #$bash "/bin/bash")
+ #$output)))
address@hidden example
+
address@hidden See
address@hidden
<https://syntaxexclamation.wordpress.com/2014/06/26/escaping-continuations/>
address@hidden for the funny quote.
+La ejecución del procedimiento monádico @code{enlace-para-sh} no tiene
+ningún efecto. Como alguien dijo una vez, ``sales de una mónada como sales
+de un edificio en llamas: corriendo'' (run en inglés). Por tanto, para salir
+de la mónada y obtener el efecto deseado se debe usar @code{run-with-store}:
+
address@hidden
+(run-with-store (open-connection) (enlace-sh))
address@hidden /gnu/store/...-enlace-para-sh
address@hidden example
+
+Fíjese que el módulo @code{(guix monad-repl)} extiende la sesión interactiva
+de Guile con nuevos ``meta-comandos'' para facilitar el trabajo con
+procedimientos monádicos: @code{run-in-store} y @code{enter-store-monad}. El
+primero se usa para ``ejecutar'' un valor monádico único a través del
+almacén:
+
address@hidden
+scheme@@(guile-user)> ,run-in-store (package->derivation hello)
+$1 = #<derivation /gnu/store/@dots{}-hello-2.9.drv => @dots{}>
address@hidden example
+
+El último entra en un entorno interactivo recursivo, donde todos los valores
+devueltos se ejecutan automáticamente a través del almacén:
+
address@hidden
+scheme@@(guile-user)> ,enter-store-monad
+store-monad@@(guile-user) [1]> (package->derivation hello)
+$2 = #<derivation /gnu/store/@dots{}-hello-2.9.drv => @dots{}>
+store-monad@@(guile-user) [1]> (text-file "foo" "Hello!")
+$3 = "/gnu/store/@dots{}-foo"
+store-monad@@(guile-user) [1]> ,q
+scheme@@(guile-user)>
address@hidden example
+
address@hidden
+Fijese que los valores no-monádicos no pueden devolverse en el entorno
+interactivo @code{store-monad}.
+
+Las formas sintácticas principales para tratar con mónadas en general se
+proporcionan por el módulo @code{(guix monads)} y se describen a
+continuación.
+
address@hidden {Sintaxis Scheme} with-monad @var{mónada} @var{cuerpo} ...
+Evalua cualquier forma @code{>>=} o @code{return} en @var{cuerpo} como
+estando en @var{mónada}.
address@hidden deffn
+
address@hidden {Sintaxis Scheme} return @var{val}
+Devuelve el valor monádico que encapsula @var{val}.
address@hidden deffn
+
address@hidden {Sintaxis Scheme} >>= @var{mval} @var{mproc} ...
address@hidden el valor monádico @var{mval}, pasando su ``contenido'' a los
+procedimientos monádicos @address@hidden@footnote{Esta operación es
+habitualmente conocida como ``bind'' (asociación), pero ese nombre denota un
+procedimiento no relacionado en Guile. Por tanto usamos este símbolo en
+cierto modo críptico heredado del lenguaje Haskell.}. Puede haber un
address@hidden o varios, como en este ejemplo:
+
address@hidden
+(run-with-state
+ (with-monad %state-monad
+ (>>= (return 1)
+ (lambda (x) (return (+ 1 x)))
+ (lambda (x) (return (* 2 x)))))
+ 'un-estado)
+
address@hidden 4
address@hidden un-estado
address@hidden example
address@hidden deffn
+
address@hidden {Sintaxis Scheme} mlet @var{mónada} ((@var{var} @var{mval}) ...)
@
+ @var{cuerpo} ...
address@hidden {Sintaxis Scheme} mlet* @var{mónada} ((@var{var} @var{mval})
...) @
+ @var{cuerpo} ... Asocia las variables @var{var} a los valores monádicos
address@hidden en @var{cuerpo}, el cual es una secuencia de expresiones. Como
+con el operador bind, esto puede pensarse como el ``desempaquetado'' del
+valor crudo no-monádico dentro del ámbito del @var{cuerpo}. La forma
+(@var{var} -> @var{val}) asocia @var{var} al valor ``normal'' @var{val},
+como en @code{let}. Las operaciones de asociación ocurren en secuencia de
+izquierda a derecha. La última expresión de @var{cuerpo} debe ser una
+expresión monádica, y su resultado se convertirá en el resultado de
address@hidden o @code{mlet*} cuando se ejecute en la @var{mónada}.
+
address@hidden es a @code{mlet} lo que @code{let*} es a @code{let}
+(@pxref{Local Bindings,,, guile, GNU Guile Reference Manual}).
address@hidden deffn
+
address@hidden {Sistema Scheme} mbegin @var{mónada} @var{mexp} ...
+Asocia @var{mexp} y las siguientes expresiones monádicas en secuencia,
+devolviendo el resultado de la última expresión. Cada expresión en la
+secuencia debe ser una expresión monádica.
+
+Esto es similar a @code{mlet}, excepto que los valores devueltos por las
+expresiones monádicas se ignoran. En ese sentido el funcionamiento es
+análogo a @code{begin} pero aplicado a expresiones monádicas.
address@hidden deffn
+
address@hidden {Sistema Scheme} mwhen @var{condición} @var{mexp0} @var{mexp*}
...
+Cuando @var{condición} es verdadero, evalúa la secuencia de expresiones
+monádicas @address@hidden como dentro de @code{mbegin}. Cuando
address@hidden es falso, devuelve @code{*unespecified*} en la mónada
+actual. Todas las expresiones en la secuencia deben ser expresiones
+monádicas.
address@hidden deffn
+
address@hidden {Sistema Scheme} munless @var{condición} @var{mexp0} @var{mexp*}
...
+Cuando @var{condición} es falso, evalúa la secuencia de expresiones
+monádicas @address@hidden como dentro de @code{mbegin}. Cuando
address@hidden es verdadero, devuelve @code{*unespecified*} en la mónada
+actual. Todas las expresiones en la secuencia deben ser expresiones
+monádicas.
address@hidden deffn
+
address@hidden mónada de estado
+El módulo @code{(guix monads)} proporciona la @dfn{mónada de estado}, que
+permite que un valor adicional---el estado---sea @emph{hilado} a través de
+las llamadas a procedimientos monádicos.
+
address@hidden {Variable Scheme} %state-monad
+La mónada de estado. Procedimientos en la mónada de estado pueden acceder y
+cambiar el estado hilado.
+
+Considere el siguiente ejemplo. El procedimiento @code{cuadrado} devuelve un
+valor en la mónada de estado.
+
address@hidden
+(define (cuadrado x)
+ (mlet %state-monad ((count (current-state)))
+ (mbegin %state-monad
+ (set-current-state (+ 1 count))
+ (return (* x x)))))
+
+(run-with-state (sequence %state-monad (map cuadrado (iota 3))) 0)
address@hidden (0 1 4)
address@hidden 3
address@hidden example
+
+Cuando se ``ejecuta'' a través de @var{%state-monad}, obtenemos un valor
+adicional de estado, que ese el número de llamadas a @code{cuadrado}.
address@hidden defvr
+
address@hidden {Procedimiento monádico} current-state
+Devuelve el estado actual como un valor monádico.
address@hidden deffn
+
address@hidden {Procedimiento monádico} set-current-state @var{valor}
+Establece el estado actual a @var{valor} y devuelve el estado previo como un
+valor monádico.
address@hidden deffn
+
address@hidden {Procedimiento monádico} state-push @var{valor}
+Apila @var{valor} al estado actual, que se asume que es una lista, y
+devuelve el estado previo como un valor monádico.
address@hidden deffn
+
address@hidden {Procedimiento monádico} state-pop
+Desapila un valor del estado actual y lo devuelve como un valor monádico. El
+estado se asume que es una lista.
address@hidden deffn
+
address@hidden {Procedimiento Scheme} run-with-state @var{mval} address@hidden
+Ejecuta un valor monádico @var{mval} comenzando con @var{estado} como el
+estado inicial. Devuelve dos valores: el valor resultante y el estado
+resultante.
address@hidden deffn
+
+La interfaz principal a la mónada del almacén, proporcionada por el módulo
address@hidden(guix store)}, es como sigue.
+
address@hidden {Variable Scheme} %store-monad
+La mónada del almacén---un alias para @var{%state-monad}.
+
+Los valores en la mónada del almacén encapsulan los accesos al
+almacén. Cuando su efecto es necesario, un valor de la mónada del almacén
+será ``evaluado'' pasandolo al procedimiento @code{run-with-store} (vea más
+adelante).
address@hidden defvr
+
address@hidden {Procedimiento Scheme} run-with-store @var{almacén} @var{mval}
[#:guile-for-build] [#:system (%current-system)]
+Ejecuta @var{mval}, un valor monádico en la mónada del almacén, en
address@hidden, una conexión abierta al almacén.
address@hidden deffn
+
address@hidden {Procedimiento monádico} text-file @var{nombre} @var{texto}
address@hidden
+Devuelve como un valor monádico el nombre absoluto del fichero en el almacén
+del fichero que contiene @var{ŧexto}, una cadena. @var{referencias} es una
+lista de elementos del almacén a los que el fichero de texto referencia; su
+valor predeterminado es la lista vacía.
address@hidden deffn
+
address@hidden {Procedimiento monádico} binary-file @var{nombre} @var{datos}
address@hidden
+Devuelve como un valor monádico el nombre absoluto del fichero en el almacén
+del fichero que contiene @var{datos}, un vector de bytes. @var{referencias}
+es una lista de elementos del almacén a los que el fichero binario
+referencia; su valor predeterminado es la lista vacía.
address@hidden deffn
+
address@hidden {Procedimiento monádico} interned-file @var{fichero}
address@hidden @
+ [#:recursive? #t] [#:select? (const #t)]
+Devuelve el nombre del @var{fichero} una vez internado en el almacén. Usa
address@hidden como su nombre del almacén, o el nombre base de @var{fichero}
+si @var{nombre} se omite.
+
+Cuando @var{recursive?} es verdadero, los contenidos del @var{fichero} se
+añaden recursivamente; si @var{fichero} designa un fichero plano y
address@hidden es verdadero, sus contenidos se añaden, y sus bits de
+permisos se mantienen.
+
+Cuando @var{recursive?} es verdadero, llama a @code{(@var{select?}
address@hidden @var{stat})} por cada entrada del directorio, donde
address@hidden es el nombre absoluto de fichero de la entrada y @var{stat} es
+el resultado de @code{lstat}; excluyendo las entradas para las cuales
address@hidden no devuelve verdadero.
+
+El ejemplo siguiente añade un fichero al almacén, bajo dos nombres
+diferentes:
+
address@hidden
+(run-with-store (open-connection)
+ (mlet %store-monad ((a (interned-file "README"))
+ (b (interned-file "README" "LEGU-MIN")))
+ (return (list a b))))
+
address@hidden ("/gnu/store/address@hidden" "/gnu/store/address@hidden")
address@hidden example
+
address@hidden deffn
+
+El módulo @code{(guix packages)} exporta los siguientes procedimientos
+monádicos relacionados con paquetes:
+
address@hidden {Procedimiento monádico} package-file @var{paquete}
address@hidden @
+ [#:system (%current-system)] [#:target #f] @
+ [#:output "out"]
+Devuelve como un valor monádico el nombre absoluto de fichero de
address@hidden dentro del directorio de salida @var{output} del
address@hidden Cuando se omite @var{fichero}, devuelve el nombre del
+directorio de salida @var{output} del @var{paquete}. Cuando @var{target} es
+verdadero, se usa como una tripleta de compilación cruzada.
address@hidden deffn
+
address@hidden {Procedimiento monádico} package->derivation @var{paquete}
address@hidden
address@hidden {Procedimiento monádico} package->cross-derivation @var{paquete}
@
+ @var{objetivo} address@hidden
+Versión monádica de @code{package-derivation} y
address@hidden (@pxref{Definición de paquetes}).
address@hidden deffn
+
+
address@hidden Expresiones-G
address@hidden Expresiones-G
+
address@hidden expresión-G
address@hidden escape de código de construcción
+Por tanto tenemos ``derivaciones'', que representan una secuencia de
+acciones de construcción a realizar para producir un elemento en el almacén
+(@pxref{Derivaciones}). Estas acciones de construcción se llevan a cabo
+cuando se solicita al daemon construir realmente la derivación; se ejecutan
+por el daemon en un contenedor (@pxref{Invocación de guix-daemon}).
+
address@hidden estratos de código
+No debería ser ninguna sorpresa que nos guste escribir estas acciones de
+construcción en Scheme. Cuando lo hacemos, terminamos con dos @dfn{estratos}
+de código address@hidden término @dfn{estrato} en este contexto se debe
+a Manuel Serrano et al.@: en el contexto de su trabajo en Hop. Oleg
+Kiselyov, quien ha escrito profundos
address@hidden://okmij.org/ftp/meta-programming/#meta-scheme, ensayos sobre el
+tema}, se refiere a este tipo de generación de código como separación en
+etapas o @dfn{staging}.}: el ``código anfitrión''---código que define
+paquetes, habla al daemon, etc.---y el ``código de construcción''---código
+que realmente realiza las acciones de construcción, como la creación de
+directorios, la invocación de @command{make}, etc.
+
+Para describir una derivación y sus acciones de construcción, típicamente se
+necesita embeber código de construcción dentro del código anfitrión. Se
+resume en la manipulación de código de construcción como datos, y la
+homoiconicidad de Scheme---el código tiene representación directa como
+datos---es útil para ello. Pero necesitamos más que el mecanismo normal de
address@hidden en Scheme para construir expresiones de construcción.
+
+El módulo @code{(guix gexp)} implementa las @dfn{expresiones-G}, una forma
+de expresiones-S adaptada para expresiones de construcción. Las
+expresiones-G, o @dfn{gexps}, consiste esencialmente en tres formas
+sintácticas: @code{gexp}, @code{ungexp} y @code{ungexp-splicing} (o
+simplemente: @code{#~}, @code{#$} y @code{#$@@}), que son comparables a
address@hidden, @code{unquote} y @code{unquote-splicing}, respectivamente
+(@pxref{Expression Syntax, @code{quasiquote},, guile, GNU Guile Reference
+Manual}). No obstante, hay importantes diferencias:
+
address@hidden
address@hidden
+Las expresiones-G están destinadas a escribirse en un fichero y ser
+ejecutadas o manipuladas por otros procesos.
+
address@hidden
+Cuando un objeto de alto nivel como un paquete o una derivación se expande
+dentro de una expresión-G, el resultado es el mismo que la introducción de
+su nombre de fichero de salida.
+
address@hidden
+Las expresiones-G transportan información acerca de los paquetes o
+derivaciones que referencian, y estas referencias se añaden automáticamente
+como entradas al proceso de construcción que las usa.
address@hidden itemize
+
address@hidden bajada de nivel, de objetos de alto nivel en expresiones-G
+Este mecanismo no se limita a objetos de paquete ni derivación: pueden
+definirse @dfn{compiladores} capaces de ``bajar el nivel'' de otros objetos
+de alto nivel a derivaciones o ficheros en el almacén, de modo que esos
+objetos puedan introducirse también en expresiones-G. Por ejemplo, un tipo
+útil de objetos de alto nivel que pueden insertarse en una expresión-G son
+los ``objetos tipo-fichero'', los cuales facilitan la adición de ficheros al
+almacén y su referencia en derivaciones y demás (vea @code{local-file} y
address@hidden más adelante).
+
+Para ilustrar la idea, aquí está un ejemplo de expresión-G:
+
address@hidden
+(define exp-construccion
+ #~(begin
+ (mkdir #$output)
+ (chdir #$output)
+ (symlink (string-append #$coreutils "/bin/ls")
+ "enumera-ficheros")))
address@hidden example
+
+Esta expresión-G puede pasarse a @code{gexp->derivation}; obtenemos una
+derivación que construye un directorio que contiene exactamente un enlace
+simbólico a @file{/gnu/store/@dots{}-coreutils-8.22/bin/ls}:
+
address@hidden
+(gexp->derivation "la-cosa" exp-construccion)
address@hidden example
+
+Como se puede esperar, la cadena @code{"/gnu/store/@dots{}-coreutils-8.22"}
+se sustituye por la referencia al paquete @var{coreutils} en el código de
+construcción real, y @var{coreutils} se marca automáticamente como una
+entrada a la derivación. Del mismo modo, @code{#$output} (equivalente a
address@hidden(ungexp output)}) se reemplaza por una cadena que contiene el
nombre
+del directorio de la salida de la derivación.
+
address@hidden compilación cruzada
+En un contexto de compilación cruzada, es útil distinguir entre referencias
+a construcciones @emph{nativas} del paquete---que pueden ejecutarse en el
+sistema anfitrión---de referencias de compilaciones cruzadas de un
+paquete. Para dicho fin, @code{#+} tiene el mismo papel que @code{#$}, pero
+es una referencia a una construcción nativa del paquete:
+
address@hidden
+(gexp->derivation "vi"
+ #~(begin
+ (mkdir #$output)
+ (system* (string-append #+coreutils "/bin/ln")
+ "-s"
+ (string-append #$emacs "/bin/emacs")
+ (string-append #$output "/bin/vi")))
+ #:target "mips64el-linux-gnu")
address@hidden example
+
address@hidden
+En el ejemplo previo, se usa la construcción nativa de @var{coreutils}, de
+modo que @command{ln} pueda realmente ejecutarse en el anfitrión; pero se
+hace referencia a la construcción de compilación cruzada de @var{emacs}.
+
address@hidden módulos importados, para expresiones-G
address@hidden with-imported-modules
+Otra característica de las expresiones-G son los @dfn{módulos importados}: a
+veces deseará ser capaz de usar determinados módulos Guile del ``entorno
+anfitrión'' en la expresión-G, de modo que esos módulos deban ser importados
+en el ``entorno de construcción''. La forma @code{with-imported-modules} le
+permite expresarlo:
+
address@hidden
+(let ((build (with-imported-modules '((guix build utils))
+ #~(begin
+ (use-modules (guix build utils))
+ (mkdir-p (string-append #$output "/bin"))))))
+ (gexp->derivation "directorio-vacio"
+ #~(begin
+ #$build
+ (display "éxito!\n")
+ #t)))
address@hidden example
+
address@hidden
+En este ejemplo, el módulo @code{(guix build utils)} se incorpora
+automáticamente dentro del entorno de construcción aislado de nuestra
+expresión-G, de modo que @code{(use-modules (guix build utils))} funciona
+como se espera.
+
address@hidden clausura de módulos
address@hidden source-module-closure
+De manera habitual deseará que la @emph{clausura} del módulo se importe---es
+decir, el módulo en sí y todos los módulos de los que depende---en vez del
+módulo únicamente; si no se hace, cualquier intento de uso del módulo
+fallará porque faltan módulos dependientes. El procedimiento
address@hidden computa la clausura de un módulo mirando en las
+cabeceras de sus ficheros de fuentes, lo que es útil en este caso:
+
address@hidden
+(use-modules (guix modules)) ;para 'source-module-closure'
+
+(with-imported-modules (source-module-closure
+ '((guix build utils)
+ (gnu build vm)))
+ (gexp->derivation "algo-con-maq-virtuales"
+ #~(begin
+ (use-modules (guix build utils)
+ (gnu build vm))
+ @dots{})))
address@hidden example
+
address@hidden extensiones, para expresiones G
address@hidden with-extensions
+De la misma manera, a veces deseará importar no únicamente módulos puros de
+Scheme, pero también ``extensiones'' como enlaces Guile a bibliotecas C u
+otros paquetes ``completos''. Si, digamos, necesitase el paquete
address@hidden disponible en el lado de construcción, esta sería la forma
+de hacerlo:
+
address@hidden
+(use-modules (gnu packages guile)) ;para 'guile-json'
+
+(with-extensions (list guile-json)
+ (gexp->derivation "algo-con-json"
+ #~(begin
+ (use-modules (json))
+ @dots{})))
address@hidden example
+
+La forma sintáctica para construir expresiones-G se resume a continuación.
+
address@hidden {Sintaxis Scheme} address@hidden
address@hidden {Sintaxis Scheme} (gexp @var{exp})
+Devuelve una expresión-G que contiene @var{exp}. @var{exp} puede contener
+una o más de las siguientes formas:
+
address@hidden @code
address@hidden address@hidden
address@hidden (ungexp @var{obj})
+Introduce una referencia a @var{obj}. @var{obj} puede tener uno de los tipos
+permitidos, por ejemplo un paquete o derivación, en cuyo caso la forma
address@hidden se substituye por el nombre de fichero de su salida---por
+ejemplo, @code{"/gnu/store/@dots{}-coreutils-8.22}.
+
+Si @var{obj} es una lista, se recorre y las referencias a objetos permitidos
+se substituyen de manera similar.
+
+Si @var{obj} es otra expresión-G, su contenido se inserta y sus dependencias
+se añaden a aquellas de la expresión-G que la contiene.
+
+Si @var{obj} es otro tipo de objeto, se inserta tal cual es.
+
address@hidden address@hidden:@var{salida}
address@hidden (ungexp @var{obj} @var{salida})
+Como la forma previa, pero referenciando explícitamente la @var{salida} de
address@hidden es útil cuando @var{obj} produce múltiples salidas
+(@pxref{Paquetes con múltiples salidas}).
+
address@hidden address@hidden
address@hidden address@hidden:salida
address@hidden (ungexp-native @var{obj})
address@hidden (ungexp-native @var{obj} @var{salida})
+Lo mismo que @code{ungexp}, pero produce una referencia a la construcción
address@hidden de @var{obj} cuando se usa en un contexto de compilación
+cruzada.
+
address@hidden #$output[:@var{salida}]
address@hidden (ungexp output address@hidden)
+Inserta una referencia a la salida de la derivación @var{salida}, o a la
+salida principal cuando @var{salida} se omite.
+
+Esto únicamente tiene sentido para expresiones-G pasadas a
address@hidden>derivation}.
+
address@hidden #$@@@var{lst}
address@hidden (ungexp-splicing @var{lst})
+Lo mismo que la forma previa, pero expande el contenido de la lista
address@hidden como parte de la lista que la contiene.
+
address@hidden #+@@@var{lst}
address@hidden (ungexp-native-splicing @var{lst})
+Lo mismo que la forma previa, pero hace referencia a las construcciones
+nativas de los objetos listados en @var{lst}.
+
address@hidden table
+
+Las expresiones-G creadas por @code{gexp} o @code{#~} son objetos del tipo
address@hidden en tiempo de ejecución (vea más adelante).
address@hidden deffn
+
address@hidden {Sintaxis Scheme} with-imported-modules @var{módulos}
@address@hidden
+Marca las expresiones-G definidas en el @address@hidden como si
+requiriesen @var{módulos} en su entorno de ejecución.
+
+Cada elemento en @var{módulos} puede ser el nombre de un módulo, como
address@hidden(guix build utils)}, o puede ser el nombre de un módulo, seguido
de
+una flecha, seguido de un objeto tipo-fichero:
+
address@hidden
+`((guix build utils)
+ (guix gcrypt)
+ ((guix config) => ,(scheme-file "config.scm"
+ #~(define-module @dots{}))))
address@hidden example
+
address@hidden
+En el ejemplo previo, los dos primeros módulos se toman de la ruta de
+búsqueda, y el último se crea desde el objeto tipo-fichero proporcionado.
+
+Esta forma tiene ámbito @emph{léxico}: tiene efecto en las expresiones-G
+definidas en @address@hidden, pero no en aquellas definidas, digamos, en
+procedimientos llamados por @address@hidden
address@hidden deffn
+
address@hidden {Sintaxis Scheme} with-extensions @var{extensiones}
@address@hidden
+Marca que las expresiones definidas en @address@hidden requieren
address@hidden en su entorno de construcción y
+ejecución. @var{extensiones} es típicamente una lista de objetos de paquetes
+como los que se definen en el módulo @code{(gnu packages guile)}.
+
+De manera concreta, los paquetes listados en @var{extensiones} se añaden a
+la ruta de carga mientras se compilan los módulos importados en
address@hidden@dots{}; también se añaden a la ruta de carga en la expresión-G
+devuelta por @address@hidden
address@hidden deffn
+
address@hidden {Procedimiento Scheme} gexp? @var{obj}
+Devuelve @code{#t} si @var{obj} es una expresión-G.
address@hidden deffn
+
+Las expresiones-G están destinadas a escribirse en disco, tanto en código
+que construye alguna derivación, como en ficheros planos en el almacén. Los
+procedimientos monádicos siguientes le permiten hacerlo (@pxref{La mónada del
almacén}, para más información sobre mónadas).
+
address@hidden {Procedimiento monádico} gexp->derivation @var{nombre} @var{exp}
@
+ [#:system (%current-system)] [#:target #f] [#:graft? #t] @
+ [#:hash #f] [#:hash-algo #f] @
+ [#:recursive? #f] [#:env-vars '()] [#:modules '()] @
+ [#:module-path @var{%load-path}] @
+ [#:effective-version "2.2"] @
+ [#:references-graphs #f] [#:allowed-references #f] @
+ [#:disallowed-references #f] @
+ [#:leaked-env-vars #f] @
+ [#:script-name (string-append @var{name} "-builder")] @
+ [#:deprecation-warnings #f] @
+ [#:local-build? #f] [#:substitutable? #t] @
+ [#:properties '()] [#:guile-for-build #f]
+Devuelve una derivación @var{nombre} que ejecuta @var{exp} (una expresión-G)
+con @var{guile-for-build} (una derivación) en el sistema @var{system};
address@hidden se almacena en un fichero llamado @var{script-name}. Cuando
address@hidden es verdadero, se usa como la tripleta de compilación cruzada
+para paquetes a los que haga referencia @var{exp}.
+
address@hidden está obsoleto en favor de @code{with-imported-modules}. Su
+significado es hacer que los módulos @var{modules} estén disponibles en el
+contexto de evaluación de @var{exp}; @var{modules} es una lista de nombres
+de módulos Guile buscados en @var{module-path} para ser copiados al almacén,
+compilados y disponibles en la ruta de carga durante la ejecución de
address@hidden ejemplo, @code{((guix build utils) (gui build
+gnu-build-system))}.
+
address@hidden determina la cadena a usar cuando se añaden las
+extensiones de @var{exp} (vea @code{with-extensions}) a la ruta de
+búsqueda---por ejemplo, @code{"2.2"}.
+
address@hidden determina si los paquetes a los que @var{exp} hace referencia
+deben ser injertados cuando sea posible.
+
+Cuando @var{references-graphs} es verdadero, debe ser una lista de tuplas de
+una de las formas siguientes:
+
address@hidden
+(@var{nombre-fichero} @var{paquete})
+(@var{nombre-fichero} @var{paquete} @var{salida})
+(@var{nombre-fichero} @var{derivación})
+(@var{nombre-fichero} @var{derivación} @var{salida})
+(@var{nombre-fichero} @var{elemento-almacén})
address@hidden example
+
+El lado derecho de cada elemento de @var{references-graphs} se convierte
+automáticamente en una entrada del proceso de construcción de @var{exp}. En
+el entorno de construcción, cada @var{nombre-fichero} contiene el grafo de
+referencias del elemento correspondiente, en un formato de texto simple.
+
address@hidden debe ser o bien @code{#f} o una lista de nombres y
+paquetes de salida. En el último caso, la lista denota elementos del almacén
+a los que el resultado puede hacer referencia. Cualquier referencia a otro
+elemento del almacén produce un error de construcción. De igual manera con
address@hidden, que enumera elementos a los que las salidas no
+deben hacer referencia.
+
address@hidden determina si mostrar avisos de obsolescencia
+durante la compilación de los módulos. Puede ser @code{#f}, @code{#t} o
address@hidden'detailed}.
+
+El resto de parámetros funcionan como en @code{derivation}
+(@pxref{Derivaciones}).
address@hidden deffn
+
address@hidden objetos tipo-fichero
+Los procedimientos @code{local-file}, @code{plain-file},
address@hidden, @code{program-file} y @code{scheme-file} a
+continuación devuelven @dfn{objetos tipo-fichero}. Esto es, cuando se
+expanden en una expresión-G, estos objetos dirigen a un fichero en el
+almacén. Considere esta expresión-G:
+
address@hidden
+#~(system* #$(file-append glibc "/sbin/nscd") "-f"
+ #$(local-file "/tmp/mi-nscd.conf"))
address@hidden example
+
+El efecto aquí es el ``internamiento'' de @file{/tmp/mi-nscd.conf} mediante
+su copia al almacén. Una vez expandida, por ejemplo @i{vía}
address@hidden>derivation}, la expresión-G hace referencia a la copia bajo
address@hidden/gnu/store}; por tanto, la modificación o el borrado del fichero
en
address@hidden/tmp} no tiene ningún efecto en lo que la expresión-G
+hace. @code{plain-file} puede usarse de manera similar; se diferencia en que
+el contenido del fichero se proporciona directamente como una cadena.
+
address@hidden {Procedimiento Scheme} local-file @var{fichero} address@hidden @
+ [#:recursive? #f] [#:select? (const #t)]
+Devuelve un objeto que representa el fichero local @var{fichero} a añadir al
+almacén; este objeto puede usarse en una expresión-G. Si @var{fichero} es un
+nombre de fichero relativo, se busca de forma relativa al fichero fuente
+donde esta forma aparece. @var{fichero} se añadirá al almacén bajo
address@hidden defecto el nombre base de @var{fichero}.
+
+Cuando @var{recursive?} es verdadero, los contenidos del @var{fichero} se
+añaden recursivamente; si @var{fichero} designa un fichero plano y
address@hidden es verdadero, sus contenidos se añaden, y sus bits de
+permisos se mantienen.
+
+Cuando @var{recursive?} es verdadero, llama a @code{(@var{select?}
address@hidden @var{stat})} por cada entrada del directorio, donde
address@hidden es el nombre absoluto de fichero de la entrada y @var{stat} es
+el resultado de @code{lstat}; excluyendo las entradas para las cuales
address@hidden no devuelve verdadero.
+
+Esta es la contraparte declarativa del procedimiento monádico
address@hidden (@pxref{La mónada del almacén, @code{interned-file}}).
address@hidden deffn
+
address@hidden {Procedimiento Scheme} plain-file @var{nombre} @var{contenido}
+Devuelve un objeto que representa un fichero de texto llamado @var{nombre}
+con el @var{contenido} proporcionado (una cadena o un vector de bytes) para
+ser añadido al almacén.
+
+Esta es la contraparte declarativa de @code{text-file}.
address@hidden deffn
+
address@hidden {Procedimiento Scheme} computed-file @var{nombre} @var{gexp} @
+ [#:options '(#:local-build? #t)]
+Devuelve un objeto que representa el elemento del almacén @var{nombre}, un
+fichero o un directorio computado por @var{gexp}. @var{options} es una lista
+de parámetros adicionales a pasar a @code{gexp->derivation}.
+
+Esta es la contraparte declarativa de @code{gexp->derivation}.
address@hidden deffn
+
address@hidden {Procedimiento monádico} gexp->script @var{nombre} @var{exp} @
+ [#:guile (default-guile)] [#:module-path %load-path]
+Devuelve un guión ejecutable @var{nombre} que ejecuta @var{exp} usando
address@hidden, con los módulos importados por @var{exp} en su ruta de
+búsqueda. Busca los módulos de @var{exp} en @var{module-path}.
+
+El ejemplo siguiente construye un guión que simplemente invoca la orden
address@hidden:
+
address@hidden
+(use-modules (guix gexp) (gnu packages base))
+
+(gexp->script "enumera-ficheros"
+ #~(execl #$(file-append coreutils "/bin/ls")
+ "ls"))
address@hidden example
+
+Cuando se ejecuta a través del almacén (@pxref{La mónada del almacén,
address@hidden), obtenemos una derivación que produce un fichero
+ejecutable @file{/gnu/store/@dots{}-enumera-ficheros} más o menos así:
+
address@hidden
+#!/gnu/store/@dots{}-guile-2.0.11/bin/guile -ds
+!#
+(execl "/gnu/store/@dots{}-coreutils-8.22"/bin/ls" "ls")
address@hidden example
address@hidden deffn
+
address@hidden {Procedimiento Scheme} program-file @var{nombre} @var{exp} @
+ [#:guile #f] [#:module-path %load-path]
+Devuelve un objeto que representa el elemento ejecutable del almacén
address@hidden que ejecuta @var{gexp}. @var{guile} es el paquete Guile usado
+para ejecutar el guión. Los módulos importados por @var{gexp} se buscan en
address@hidden
+
+Esta es la contraparte declarativa de @code{gexp->script}.
address@hidden deffn
+
address@hidden {Procedimiento monádico} gexp->file @var{nombre} @var{exp} @
+ [#:set-load-path? #t] [#:module-path %load-path] @
+ [#:splice? #f] @
+ [#:guile (default-guile)]
+Devuelve una derivación que construye un fichero @var{nombre} que contiene
address@hidden Cuando @var{splice?} es verdadero, se considera que @var{exp} es
+una lista de expresiones que deben ser expandidas en el fichero resultante.
+
+Cuando @var{set-load-path} es verdadero, emite código en el fichero
+resultante para establecer @code{%load-path} y @code{%load-compiled-path} de
+manera que respeten los módulos importados por @var{exp}. Busca los módulos
+de @var{exp} en @var{module-path}.
+
+El fichero resultante hace referencia a todas las dependencias de @var{exp}
+o a un subconjunto de ellas.
address@hidden deffn
+
address@hidden {Procedimiento Scheme} scheme-file @var{nombre} @var{exp}
[#:splice? #f]
+Devuelve un objeto que representa el fichero Scheme @var{nombre} que
+contiene @var{exp}.
+
+Esta es la contraparte declarativa de @code{gexp->file}.
address@hidden deffn
+
address@hidden {Procedimiento monádico} text-file* @var{nombre} @var{texto}
@dots{}
+Devuelve como un valor monádico una derivación que construye un fichero de
+texto que contiene todo @var{texto}. @var{texto} puede ser una lista de,
+además de cadenas, objetos de cualquier tipo que pueda ser usado en
+expresiones-G: paquetes, derivaciones, ficheros locales, objetos, etc. El
+fichero del almacén resultante hace referencia a todos ellos.
+
+Esta variante debe preferirse sobre @code{text-file} cuando el fichero a
+crear haga referencia a elementos del almacén. Esto es el caso típico cuando
+se construye un fichero de configuración que embebe nombres de ficheros del
+almacén, como este:
+
address@hidden
+(define (perfil.sh)
+ ;; Devuelve el nombre de un guión shell en el almacén
+ ;; que establece la variable de entorno 'PATH'
+ (text-file* "perfil.sh"
+ "export PATH=" coreutils "/bin:"
+ grep "/bin:" sed "/bin\n"))
address@hidden example
+
+En este ejemplo, el fichero @file{/gnu/store/@dots{}-perfil.sh} resultante
+hará referencia a @var{coreutils}, @var{grep} y @var{sed}, por tanto
+evitando que se recolecten como basura durante su tiempo de vida.
address@hidden deffn
+
address@hidden {Procedimiento Scheme} mixed-text-file @var{nombre} @var{texto}
@dots{}
+Devuelve un objeto que representa el fichero del almacén @var{nombre} que
+contiene @var{texto}. @var{texto} es una secuencia de cadenas y objetos
+tipo-fichero, como en:
+
address@hidden
+(mixed-text-file "perfil"
+ "export PATH=" coreutils "/bin:" grep "/bin")
address@hidden example
+
+Esta es la contraparte declarativa de @code{text-file*}.
address@hidden deffn
+
address@hidden {Procedimiento Scheme} file-union @var{nombre} @var{ficheros}
+Devuelve un @code{<computed-file>} que construye un directorio que contiene
+todos los @var{ficheros}. Cada elemento en @var{ficheros} debe ser una lista
+de dos elementos donde el primer elemento es el nombre de fichero a usar en
+el nuevo directorio y el segundo elemento es una expresión-G que denota el
+fichero de destino. Aquí está un ejemplo:
+
address@hidden
+(file-union "etc"
+ `(("hosts" ,(plain-file "hosts"
+ "127.0.0.1 localhost"))
+ ("bashrc" ,(plain-file "bashrc"
+ "alias ls='ls --color=auto'"))))
address@hidden example
+
+Esto emite un directorio @code{etc} que contiene estos dos ficheros.
address@hidden deffn
+
address@hidden {Procedimiento Scheme} directory-union @var{nombre} @var{cosas}
+Devuelve un directorio que es la unión de @var{cosas}, donde @var{cosas} es
+una lista de objetos tipo-fichero que denotan directorios. Por ejemplo:
+
address@hidden
+(directory-union "guile+emacs" (list guile emacs))
address@hidden example
+
+emite un directorio que es la unión de los paquetes @code{guile} y
address@hidden
address@hidden deffn
+
address@hidden {Procedimientos Scheme} file-append @var{obj} @var{sufijo}
@dots{}
+Devuelve un objeto tipo-fichero que se expande a la concatenación de
address@hidden y @var{sufijo}, donde @var{obj} es un objeto que se puede bajar
de
+nivel y cada @var{sufijo} es una cadena.
+
+Como un ejemplo, considere esta expresión-G:
+
address@hidden
+(gexp->script "ejecuta-uname"
+ #~(system* #$(file-append coreutils
+ "/bin/uname")))
address@hidden example
+
+El mismo efecto podría conseguirse con:
+
address@hidden
+(gexp->script "ejecuta-uname"
+ #~(system* (string-append #$coreutils
+ "/bin/uname")))
address@hidden example
+
+Hay una diferencia no obstante: en el caso de @code{file-append}, el guión
+resultante contiene una ruta absoluta de fichero como una cadena, mientras
+que en el segundo caso, el guión resultante contiene una expresión
address@hidden(string-append @dots{})} para construir el nombre de fichero
@emph{en
+tiempo de ejecución}.
address@hidden deffn
+
+
+Por supuesto, además de expresiones-G embebidas en código ``anfitrión'', hay
+también módulos que contienen herramientas de construcción. Para clarificar
+que están destinados para su uso en el estrato de construcción, estos
+módulos se mantienen en el espacio de nombres @code{(guix build @dots{})}.
+
address@hidden bajada de nivel, de objetos de alto nivel en expresiones-G
+Internamente, los objetos de alto nivel se @dfn{bajan de nivel}, usando su
+compilador, a derivaciones o elementos del almacén. Por ejemplo, bajar de
+nivel un paquete emite una derivación, y bajar de nivel un @var{plain-file}
+emite un elemento del almacén. Esto se consigue usando el procedimiento
+monádico @code{lower-object}.
+
address@hidden {Procedimiento monádico} lower-object @var{obj} address@hidden @
+ [#:target #f]
+Devuelve como un valor en @var{%store-monad} la derivación o elemento del
+almacén que corresponde a @var{obj} en @var{sistema}, compilando de manera
+cruzada para @var{target} si @var{target} es verdadero. @var{obj} debe ser
+un objeto que tiene asociado un compilador de expresiones-G, como
address@hidden<package>}.
address@hidden deffn
+
address@hidden Invocación de guix repl
address@hidden Invocación de @command{guix repl}
+
address@hidden REPL, bucle de lectura-evaluación-impresión
+La orden @command{guix repl} lanza un @dfn{bucle de
+lectura-evaluación-impresión} Guile (REPL) para programación interactiva
+(@pxref{Using Guile Interactively,,, guile, GNU Guile Reference
+Manual}). Comparado a simplemente lanzar la orden @command{guile},
address@hidden repl} garantiza que todos los módulos Guix y todas sus
+dependencias están disponibles en la ruta de búsqueda. Puede usarla de esta
+manera:
+
address@hidden
+$ guix repl
+scheme@@(guile-user)> ,use (gnu packages base)
+scheme@@(guile-user)> coreutils
+$1 = #<package coreutils@@8.29 gnu/packages/base.scm:327 3e28300>
address@hidden example
+
address@hidden inferiores
+Además, @command{guix repl} implementa un protocolo del REPL simple legible
+por máquinas para su uso por @code{(guix inferior)}, una facilidad para
+interactuar con @dfn{inferiores}, procesos separados que ejecutan una
+revisión de Guix potencialmente distinta.
+
+Las opciones disponibles son las siguientes:
+
address@hidden @code
address@hidden address@hidden
address@hidden -t @var{tipo}
+Inicia un REPL del @var{TIPO} dado, que puede ser uno de los siguientes:
+
address@hidden @code
address@hidden guile
+Es el predeterminado, y lanza una sesión interactiva Guile estándar con
+todas las características.
address@hidden machine
+Lanza un REPL que usa el protocolo legible por máquinas. Este es el
+protocolo con el que el módulo @code{(guix inferior)} se comunica.
address@hidden table
+
address@hidden address@hidden
+Por defecto, @command{guix repl} lee de la entrada estándar y escribe en la
+salida estándar. Cuando se pasa esta opción, en vez de eso escuchará las
+conexiones en @var{destino}. Estos son ejemplos de opciones válidas:
+
address@hidden @code
address@hidden --listen=tcp:37146
+Acepta conexiones locales por el puerto 37146.
+
address@hidden --listen=unix:/tmp/socket
+Acepta conexiones a través del socket de dominio Unix @file{/tmp/socket}.
address@hidden table
address@hidden table
+
address@hidden
*********************************************************************
address@hidden Utilidades
address@hidden Utilidades
+
+Esta sección describe las utilidades de línea de órdenes de Guix. Algunas de
+ellas están orientadas principalmente para desarrolladoras y usuarias que
+escriban definiciones de paquetes nuevas, mientras que otras son útiles de
+manera más general. Complementan la interfaz programática Scheme de Guix de
+modo conveniente.
+
address@hidden
+* Invocación de guix build:: Construir paquetes desde la línea de
+ órdenes.
+* Invocación de guix edit:: Editar las definiciones de paquetes.
+* Invocación de guix download:: Descargar un fichero e imprimir su hash.
+* Invocación de guix hash:: Calcular el hash criptográfico de un fichero.
+* Invocación de guix import:: Importar definiciones de paquetes.
+* Invocación de guix refresh:: Actualizar definiciones de paquetes.
+* Invocación de guix lint:: Encontrar errores en definiciones de paquetes.
+* Invocación de guix size:: Perfilar el uso del disco.
+* Invocación de guix graph:: Visualizar el grafo de paquetes.
+* Invocación de guix publish:: Compartir sustituciones.
+* Invocación de guix challenge:: Poner a prueba servidores de
+ sustituciones.
+* Invocación de guix copy:: Copiar a y desde un almacén remoto.
+* Invocación de guix container:: Aislamiento de procesos.
+* Invocación de guix weather:: Comprobar la disponibilidad de
+ sustituciones.
+* Invocación de guix processes:: Enumerar los procesos cliente.
address@hidden menu
+
address@hidden Invocación de guix build
address@hidden Invocación de @command{guix build}
+
address@hidden construcción de paquetes
address@hidden @command{guix build}
+La orden @command{guix build} construye paquetes o derivaciones y sus
+dependencias, e imprime las rutas del almacén resultantes. Fíjese que no
+modifica el perfil de la usuaria---este es el trabajo de la orden
address@hidden package} (@pxref{Invocación de guix package}). Por tanto, es útil
+principalmente para las desarrolladoras de la distribución.
+
+La sintaxis general es:
+
address@hidden
+guix build @var{opciones} @address@hidden
address@hidden example
+
+Como ejemplo, la siguiente orden construye las últimas versiones de Emacs y
+Guile, muestra sus log de construcción, y finalmente muestra los directorios
+resultantes:
+
address@hidden
+guix build emacs guile
address@hidden example
+
+De forma similar, la siguiente orden construye todos los paquetes
+disponibles:
+
address@hidden
+guix build --quiet --keep-going \
+ `guix package -A | cut -f1,2 --output-delimiter=@@`
address@hidden example
+
address@hidden puede ser tanto el nombre de un paquete que se
+encuentra en la distribución de software como @code{coreutils} o
address@hidden@@8.20}, o una derivación como
address@hidden/gnu/store/@dots{}-coreutils-8.19.drv}. En el primer caso, el
paquete
+de nombre (y opcionalmente versión) correspondiente se busca entre los
+módulos de la distribución GNU (@pxref{Módulos de paquetes}).
+
+De manera alternativa, la opción @code{--expression} puede ser usada para
+especificar una expresión Scheme que evalúa a un paquete; esto es útil para
+la desambiguación entre varios paquetes del mismo nombre o si se necesitan
+variaciones del paquete.
+
+Puede haber cero o más @var{opciones}. Las opciones disponibles se describen
+en la subsección siguiente.
+
address@hidden
+* Opciones comunes de construcción:: Opciones de construcción para la
+ mayoría de órdenes.
+* Opciones de transformación de paquetes:: Crear variantes de paquetes.
+* Opciones de construcción adicionales:: Opciones específicas de 'guix
+ build'.
+* Depuración de fallos de construcción:: Experiencia de empaquetamiento
+ en la vida real.
address@hidden menu
+
address@hidden Opciones comunes de construcción
address@hidden Opciones comunes de construcción
+
+Un número de opciones que controlan el proceso de construcción son comunes a
address@hidden build} y otras órdenes que pueden lanzar construcciones, como
address@hidden package} o @command{guix archive}. Son las siguientes:
+
address@hidden @code
+
address@hidden address@hidden
address@hidden -L @var{directorio}
+Añade @var{directorio} al frente de la ruta de búsqueda de módulos de
+paquetes (@pxref{Módulos de paquetes}).
+
+Esto permite a las usuarias definir sus propios paquetes y hacerlos visibles
+a las herramientas de línea de órdenes.
+
address@hidden --keep-failed
address@hidden -K
+Mantiene los árboles de construcción de las construcciones fallidas. Por
+tanto, si una construcción falla, su árbol de construcción se mantiene bajo
address@hidden/tmp}, en un directorio cuyo nombre se muestra al final del log de
+construcción. Esto es útil cuando se depuran problemas en la
+construcción. @xref{Depuración de fallos de construcción}, para trucos y
consejos sobre
+cómo depurar problemas en la construcción.
+
+Esta opción no tiene efecto cuando se conecta a un daemon remoto con una URI
address@hidden://} (@pxref{El almacén, the @code{GUIX_DAEMON_SOCKET} variable}).
+
address@hidden --keep-going
address@hidden -k
+Seguir adelante cuando alguna de las derivaciones de un fallo durante la
+construcción; devuelve una única vez todas las construcciones que se han
+completado o bien han fallado.
+
+El comportamiento predeterminado es parar tan pronto una de las derivaciones
+especificadas falle.
+
address@hidden --dry-run
address@hidden -n
+No construye las derivaciones.
+
address@hidden
address@hidden --fallback
+Cuando la sustitución de un binario preconstruido falle, intenta la
+construcción local de paquetes (@pxref{Fallos en las sustituciones}).
+
address@hidden address@hidden
address@hidden
+Considera @var{urls} la lista separada por espacios de URLs de fuentes de
+sustituciones, anulando la lista predeterminada de URLs de
address@hidden (@pxref{daemon-substitute-urls,, @command{guix-daemon
+URLs}}).
+
+Significa que las sustituciones puede ser descargadas de @var{urls},
+mientras que estén firmadas por una clave autorizada por la administradora
+del sistema (@pxref{Sustituciones}).
+
+Cuando @var{urls} es la cadena vacía, las sustituciones están efectivamente
+deshabilitadas.
+
address@hidden --no-substitutes
+No usa sustituciones para la construcción de productos. Esto es, siempre
+realiza las construcciones localmente en vez de permitir la descarga de
+binarios pre-construidos (@pxref{Sustituciones}).
+
address@hidden --no-grafts
+No ``injerta'' paquetes. En la práctica esto significa que las
+actualizaciones de paquetes disponibles como injertos no se
+aplican. @xref{Actualizaciones de seguridad}, para más información sobre los
injertos.
+
address@hidden address@hidden
+Construye cada derivación @var{n} veces seguidas, y lanza un error si los
+resultados de las construcciones consecutivas no son idénticos bit-a-bit.
+
+Esto es útil para la detección de procesos de construcción
+no-deterministas. Los procesos de construcción no-deterministas son un
+problema puesto que prácticamente imposibilitan a las usuarias la
address@hidden de la autenticidad de binarios proporcionados por
+terceras partes. @xref{Invocación de guix challenge}, para más sobre esto.
+
+Fíjese que, actualmente, los resultados de las construcciones discordantes
+no se mantienen, por lo que debe que investigar manualmente en caso de un
+error---por ejemplo, mediante la extracción de uno de los resultados con
address@hidden archive --export} (@pxref{Invocación de guix archive}), seguida
de una
+reconstrucción, y finalmente la comparación de los dos resultados.
+
address@hidden --no-build-hook
+No intenta delegar construcciones a través del ``hook de construcción'' del
+daemon (@pxref{Configuración de delegación del daemon}). Es decir, siempre
realiza las
+construcciones de manera local en vez de delegando construcciones a máquinas
+remotas.
+
address@hidden address@hidden
+Cuando la construcción o sustitución permanece en silencio más de
address@hidden, la finaliza e informa de un fallo de construcción.
+
+Por defecto, se respeta la configuración del daemon (@pxref{Invocación de
guix-daemon, @code{--max-silent-time}}).
+
address@hidden address@hidden
+Del mismo modo, cuando el proceso de construcción o sustitución dura más de
address@hidden, lo termina e informa un fallo de construcción.
+
+Por defecto, se respeta la configuración del daemon (@pxref{Invocación de
guix-daemon, @code{--timeout}}).
+
address@hidden Note: This option is actually not part of
%standard-build-options but
address@hidden most programs honor it.
address@hidden verbosity, of the command-line tools
address@hidden logs de construcción, nivel de descripción
address@hidden -v @var{nivel}
address@hidden address@hidden
+Use the given verbosity @var{level}, an integer. Choosing 0 means that no
+output is produced, 1 is for quiet output, and 2 shows all the build log
+output on standard error.
+
address@hidden address@hidden
address@hidden -c @var{n}
+Permite usar @var{n} núcleos de la CPU para la construcción. El valor
+especial @code{0} significa usar tantos como núcleos haya en la CPU.
+
address@hidden address@hidden
address@hidden -M @var{n}
+Permite como máximo @var{n} trabajos de construcción en
+paralelo. @xref{Invocación de guix-daemon, @code{--max-jobs}}, para detalles
+acerca de esta opción y la opción equivalente de @command{guix-daemon}.
+
address@hidden address@hidden
+Produce debugging output coming from the build daemon. @var{level} must be
+an integer between 0 and 5; higher means more verbose output. Setting a
+level of 4 or more may be helpful when debugging setup issues with the build
+daemon.
+
address@hidden table
+
+Tras las cortinas, @command{guix build} es esencialmente una interfaz al
+procedimiento @code{package-derivation} del módulo @code{(guix packages)}, y
+al procedimiento @code{build-derivations} del módulo @code{(guix
+derivations)}.
+
+Además de las opciones proporcionadas explícitamente en la línea de órdenes,
address@hidden build} y otras órdenes @command{guix} que permiten la
+construcción respetan el contenido de la variable de entorno
address@hidden
+
address@hidden {Variable de entorno} GUIX_BUILD_OPTIONS
+Las usuarias pueden definir esta variable para que contenga una lista de
+opciones de línea de órdenes que se usarán automáticamente por @command{guix
+build} y otras órdenes @command{guix} que puedan realizar construcciones,
+como en el ejemplo siguiente:
+
address@hidden
+$ export GUIX_BUILD_OPTIONS="--no-substitutes -c 2 -L /foo/bar"
address@hidden example
+
+Estas opciones se analizan independientemente, y el resultado se añade a
+continuación de las opciones de línea de órdenes.
address@hidden defvr
+
+
address@hidden Opciones de transformación de paquetes
address@hidden Opciones de transformación de paquetes
+
address@hidden variaciones de paquetes
+Otro conjunto de opciones de línea de órdenes permitidas por @command{guix
+build} y también @command{guix package} son las @dfn{opciones de
+transformación de paquetes}. Son opciones que hacen posible la definición de
address@hidden de paquetes}---por ejemplo, paquetes construidos con un
+código fuente diferente. Es una forma conveniente de crear paquetes
+personalizados al vuelo sin tener que escribir las definiciones de las
+variaciones del paquete (@pxref{Definición de paquetes}).
+
address@hidden @code
+
address@hidden address@hidden
address@hidden address@hidden@var{fuente}
address@hidden address@hidden@@@address@hidden
+Usa @var{fuente} como la fuente de @var{paquete}, y @var{versión} como su
+número de versión. @var{fuente} debe ser un nombre de fichero o una URL,
+como en @command{guix download} (@pxref{Invocación de guix download}).
+
+Cuando se omite @var{paquete}, se toma el nombre de paquete especificado en
+la línea de ordenes que coincide con el nombre base de @var{fuente}---por
+ejemplo, si @var{fuente} fuese @code{/src/guile-2.0.10.tar.gz}, el paquete
+correspondiente sería @code{guile}.
+
+Del mismo modo, si se omite @var{versión}, la cadena de versión se deduce de
address@hidden; en el ejemplo previo sería @code{2.0.10}.
+
+Esta opción permite a las usuarias probar versiones del paquete distintas a
+las proporcionadas en la distribución. El ejemplo siguiente descarga
address@hidden de un espejo GNU y lo usa como la fuente para el
+paquete @code{ed}:
+
address@hidden
+guix build ed --with-source=mirror://gnu/ed/ed-1.7.tar.gz
address@hidden example
+
+Como desarrolladora, @code{--with-source} facilita la prueba de versiones
+candidatas para la publicación:
+
address@hidden
+guix build guile --with-source=../guile-2.0.9.219-e1bb7.tar.xz
address@hidden example
+
address@hidden o la construcción desde una revisión en un entorno limpio:
+
address@hidden
+$ git clone git://git.sv.gnu.org/guix.git
+$ guix build guix --with-source=guix@@1.0=./guix
address@hidden example
+
address@hidden address@hidden@var{reemplazo}
+Substituye dependencias de @var{paquete} por dependencias de
address@hidden @var{paquete} debe ser un nombre de paquete, y
address@hidden debe ser una especificación de paquete como @code{guile} o
address@hidden@@1.8}.
+
+Por ejemplo, la orden siguiente construye Guix, pero substituye su
+dependencia de la versión estable actual de Guile con una dependencia en la
+versión antigua de Guile, @code{guile@@2.0}:
+
address@hidden
+guix build --with-input=guile=guile@@2.0 guix
address@hidden example
+
+Esta sustitución se realiza de forma recursiva y en profundidad. Por lo que
+en este ejemplo, tanto @code{guix} como su dependencia @code{guile-json}
+(que también depende de @code{guile}) se reconstruyen contra
address@hidden@@2.0}.
+
+Se implementa usando el procedimiento Scheme @code{package-input-rewriting}
+(@pxref{Definición de paquetes, @code{package-input-rewriting}}).
+
address@hidden address@hidden@var{reemplazo}
+Es similar a @code{--with-input} pero con una diferencia importante: en vez
+de reconstruir la cadena de dependencias completa, @var{reemplazo} se
+construye y se @dfn{injerta} en los binarios que inicialmente hacían
+referencia a @var{paquete}. @xref{Actualizaciones de seguridad}, para más
información
+sobre injertos.
+
+Por ejemplo, la orden siguiente injerta la versión 3.5.4 de GnuTLS en Wget y
+todas sus dependencias, substituyendo las referencias a la versión de GnuTLS
+que tienen actualmente:
+
address@hidden
+guix build --with-graft=gnutls=gnutls@@3.5.4 wget
address@hidden example
+
+Esta opción tiene la ventaja de ser mucho más rápida que la reconstrucción
+de todo. Pero hay una trampa: funciona si y solo si @var{paquete} y
address@hidden son estrictamente compatibles---por ejemplo, si proporcionan
+una biblioteca, la interfaz binaria de aplicación (ABI) de dichas
+bibliotecas debe ser compatible. Si @var{reemplazo} es incompatible de
+alguna manera con @var{paquete}, el paquete resultante puede no ser
+usable. ¡Úsela con precaución!
+
address@hidden address@hidden@var{url}
address@hidden Git, usar la última revisión
address@hidden última revisión, construcción
+Build @var{package} from the latest commit of the @code{master} branch of
+the Git repository at @var{url}. Git sub-modules of the repository are
+fetched, recursively.
+
+For example, the following command builds the NumPy Python library against
+the latest commit of the master branch of Python itself:
+
address@hidden
+guix build python-numpy \
+ --with-git-url=python=https://github.com/python/cpython
address@hidden example
+
+This option can also be combined with @code{--with-branch} or
address@hidden (see below).
+
address@hidden integración continua
+Obviously, since it uses the latest commit of the given branch, the result
+of such a command varies over time. Nevertheless it is a convenient way to
+rebuild entire software stacks against the latest commit of one or more
+packages. This is particularly useful in the context of continuous
+integration (CI).
+
+Checkouts are kept in a cache under @file{~/.cache/guix/checkouts} to speed
+up consecutive accesses to the same repository. You may want to clean it up
+once in a while to save disk space.
+
address@hidden address@hidden@var{rama}
+Build @var{package} from the latest commit of @var{branch}. If the
address@hidden field of @var{package} is an origin with the @code{git-fetch}
+method (@pxref{Referencia de ``origin''}) or a @code{git-checkout} object, the
+repository URL is taken from that @code{source}. Otherwise you have to use
address@hidden to specify the URL of the Git repository.
+
+For instance, the following command builds @code{guile-sqlite3} from the
+latest commit of its @code{master} branch, and then builds @code{guix}
+(which depends on it) and @code{cuirass} (which depends on @code{guix})
+against this specific @code{guile-sqlite3} build:
+
address@hidden
+guix build --with-branch=guile-sqlite3=master cuirass
address@hidden example
+
address@hidden address@hidden@var{revisión}
+This is similar to @code{--with-branch}, except that it builds from
address@hidden rather than the tip of a branch. @var{commit} must be a valid
+Git commit SHA1 identifier.
address@hidden table
+
address@hidden Opciones de construcción adicionales
address@hidden Opciones de construcción adicionales
+
+Las opciones de línea de ordenes presentadas a continuación son específicas
+de @command{guix build}.
+
address@hidden @code
+
address@hidden --quiet
address@hidden -q
+Build quietly, without displaying the build log; this is equivalent to
address@hidden Upon completion, the build log is kept in @file{/var}
+(or similar) and can always be retrieved using the @option{--log-file}
+option.
+
address@hidden address@hidden
address@hidden -f @var{fichero}
+Construye el paquete, derivación u otro objeto tipo-fichero al que evalúa el
+código en @var{fichero} (@pxref{Expresiones-G, file-like objects}).
+
+Como un ejemplo, @var{fichero} puede contener una definición como esta
+(@pxref{Definición de paquetes}):
+
address@hidden
address@hidden package-hello.scm
address@hidden example
+
address@hidden address@hidden
address@hidden -e @var{expr}
+Construye el paquete o derivación al que @var{expr} evaulua.
+
+Por ejemplo, @var{expr} puede ser @code{(@@ (gnu packages guile)
+guile-1.8)}, que designa sin ambigüedad a esta variante específica de la
+versión 1.8 de Guile.
+
+De manera alternativa, @var{expr} puede ser una expresión-G, en cuyo caso se
+usa como un programa de construcción pasado a @code{gexp->derivation}
+(@pxref{Expresiones-G}).
+
+Por último, @var{expr} puede hacer referencia a un procedimiento mónadico
+sin parámetros (@pxref{La mónada del almacén}). El procedimiento debe devolver
una
+derivación como un valor monádico, el cual después se pasa a través de
address@hidden
+
address@hidden --source
address@hidden -S
+Construye las derivaciones de las fuentes de los paquetes, en vez de los
+paquetes mismos.
+
+Por ejemplo, @code{guix build -S gcc} devuelve algo como
address@hidden/gnu/store/@dots{}-gcc-4.7.2.tar.bz2}, el cual es el archivador
tar de
+fuentes de GCC.
+
+El archivador tar devuelto es el resultado de aplicar cualquier parche y
+fragmento de código en el origen (campo @code{origin}) del paquete
+(@pxref{Definición de paquetes}).
+
address@hidden --sources
+Obtiene y devuelve las fuentes de @var{paquete-o-derivación} y todas sus
+dependencias, recursivamente. Esto es útil para obtener una copia local de
+todo el código fuente necesario para construir los @var{paquetes},
+permitiendole construirlos llegado el momento sin acceso a la red. Es una
+extensión de la opción @code{--source} y puede aceptar uno de los siguientes
+valores opcionales como parámetro:
+
address@hidden @code
address@hidden package
+Este valor hace que la opción @code{--sources} se comporte de la misma
+manera que la opción @code{--source}.
+
address@hidden all
+Construye las derivaciones de las fuentes de todos los paquetes, incluyendo
+cualquier fuente que pueda enumerarse como entrada (campo
address@hidden). Este es el valor predeterminado.
+
address@hidden
+$ guix build --sources tzdata
+The following derivations will be built:
+ /gnu/store/@dots{}-tzdata2015b.tar.gz.drv
+ /gnu/store/@dots{}-tzcode2015b.tar.gz.drv
address@hidden example
+
address@hidden transitive
+Construye las derivaciones de fuentes de todos los paquetes, así como todas
+las entradas transitivas de los paquetes. Esto puede usarse, por ejemplo,
+para obtener las fuentes de paquetes para una construcción posterior sin
+conexión a la red.
+
address@hidden
+$ guix build --sources=transitive tzdata
+The following derivations will be built:
+ /gnu/store/@dots{}-tzcode2015b.tar.gz.drv
+ /gnu/store/@dots{}-findutils-4.4.2.tar.xz.drv
+ /gnu/store/@dots{}-grep-2.21.tar.xz.drv
+ /gnu/store/@dots{}-coreutils-8.23.tar.xz.drv
+ /gnu/store/@dots{}-make-4.1.tar.xz.drv
+ /gnu/store/@dots{}-bash-4.3.tar.xz.drv
address@hidden
address@hidden example
+
address@hidden table
+
address@hidden address@hidden
address@hidden -s @var{sistema}
+Attempt to build for @var{system}---e.g., @code{i686-linux}---instead of the
+system type of the build host. The @command{guix build} command allows you
+to repeat this option several times, in which case it builds for all the
+specified systems; other commands ignore extraneous @option{-s} options.
+
address@hidden Nota
+La opción @code{--system} es para compilación @emph{nativa} y no debe
+confundirse con la compilación cruzada. Véase @code{--target} más adelante
+para información sobre compilación cruzada.
address@hidden quotation
+
+Un ejemplo de uso de esta opción es en sistemas basados en Linux, que pueden
+emular diferentes personalidades. Por ejemplo, pasar
address@hidden en un sistema @code{x86_64-linux} o
address@hidden en un sistema @code{aarch64-linux} le permite
+construir paquetes en un entorno de 32-bits completo.
+
address@hidden Nota
+La construcción para un sistema @code{armhf-linux} está habilitada
+incondicionalmente en máquinas @code{aarch64-linux}, aunque determinados
+procesadores aarch64 no permiten esta funcionalidad, notablemente el
+ThunderX.
address@hidden quotation
+
+De manera similar, cuando la emulación transparente con QEMU y
address@hidden está habilitada (@pxref{Servicios de virtualización,
address@hidden), puede construir para cualquier sistema
+para el que un manejador QEMU de @code{binfmt_misc} esté instalado.
+
+Las construcciones para un sistema distinto al de la máquina que usa pueden
+delegarse también a una máquina remota de la arquitectura
+correcta. @xref{Configuración de delegación del daemon}, para más información
sobre
+delegación.
+
address@hidden address@hidden
address@hidden compilación cruzada
+Compilación cruzada para la @var{tripleta}, que debe ser una tripleta GNU
+válida, cómo @code{"mips64el-linux-gnu"} (@pxref{Specifying target triplets,
+GNU configuration triplets,, autoconf, Autoconf}).
+
address@hidden
address@hidden --check
address@hidden determinismo, comprobación
address@hidden reproducibilidad, comprobación
+Reconstruye @var{paquete-o-derivación}, que ya está disponible en el
+almacén, y emite un error si los resultados de la construcción no son
+idénticos bit-a-bit.
+
+Este mecanismo le permite comprobar si sustituciones previamente instaladas
+son genuinas (@pxref{Sustituciones}), o si el resultado de la construcción de
+un paquete es determinista. @xref{Invocación de guix challenge}, para más
+información de referencia y herramientas.
+
+Cuando se usa conjuntamente con @option{--keep-failed}, la salida que
+difiere se mantiene en el almacén, bajo
address@hidden/gnu/store/@dots{}-check}. Esto hace fácil buscar diferencias
entre
+los dos resultados.
+
address@hidden --repair
address@hidden reparar elementos del almacén
address@hidden corrupción, recuperarse de
+Intenta reparar los elementos del almacén especificados, si están corruptos,
+volviendo a descargarlos o reconstruyendolos.
+
+Esta operación no es atómica y por lo tanto está restringida a @code{root}.
+
address@hidden --derivations
address@hidden -d
+Devuelve las rutas de derivación, no las rutas de salida, de los paquetes
+proporcionados.
+
address@hidden address@hidden
address@hidden -r @var{fichero}
address@hidden GC, añadir raíces
address@hidden raíces del recolector de basura, añadir
+Hace que @var{fichero} sea un enlace simbólico al resultado, y lo registra
+como una raíz del recolector de basura.
+
+Consecuentemente, los resultados de esta invocación de @command{guix build}
+se protegen de la recolección de basura hasta que @var{fichero} se
+elimine. Cuando se omite esa opción, los resultados son candidatos a la
+recolección de basura en cuanto la construcción se haya
+completado. @xref{Invocación de guix gc}, para más sobre las raíces del
+recolector de basura.
+
address@hidden --log-file
address@hidden logs de construcción, acceso
+Devuelve los nombres de ficheros o URL de los log de construcción para el
address@hidden proporcionado, o emite un error si no se
+encuentran los log de construcción.
+
+Esto funciona independientemente de cómo se especificasen los paquetes o
+derivaciones. Por ejemplo, las siguientes invocaciones son equivalentes:
+
address@hidden
+guix build --log-file `guix build -d guile`
+guix build --log-file `guix build guile`
+guix build --log-file guile
+guix build --log-file -e '(@@ (gnu packages guile) guile-2.0)'
address@hidden example
+
+Si un log no está disponible localmente, y a menos que se proporcione
address@hidden, la orden busca el log correspondiente en uno de los
+servidores de sustituciones (como se especificaron con
address@hidden).
+
+Por lo que dado el caso, imaginese que desea ver el log de construcción de
+GDB en MIPS, pero realmente está en una máquina @code{x86_64}:
+
address@hidden
+$ guix build --log-file gdb -s mips64el-linux
+https://@value{SUBSTITUTE-SERVER}/log/@dots{}-gdb-7.10
address@hidden example
+
+¡Puede acceder libremente a una biblioteca inmensa de log de construcción!
address@hidden table
+
address@hidden Depuración de fallos de construcción
address@hidden Depuración de fallos de construcción
+
address@hidden fallos de construcción, depuración
+Cuando esté definiendo un paquete nuevo (@pxref{Definición de paquetes}),
+probablemente se encuentre que dedicando algún tiempo a depurar y afinar la
+construcción hasta obtener un resultado satisfactorio. Para hacerlo, tiene
+que lanzar manualmente las órdenes de construcción en un entorno tan similar
+como sea posible al que el daemon de construcción usa.
+
+Para ello, la primera cosa a hacer es usar la opción @option{--keep-failed}
+o @option{-K} de @command{guix build}, lo que mantiene el árbol de la
+construcción fallida en @file{/tmp} o el directorio que especificase con
address@hidden (@pxref{Invocación de guix build, @code{--keep-failed}}).
+
+De ahí en adelante, puede usar @command{cd} para ir al árbol de la
+construcción fallida y cargar el fichero @file{environment-variables}, que
+contiene todas las definiciones de variables de entorno que existían cuando
+la construcción falló. Digamos que está depurando un fallo en la
+construcción del paquete @code{foo}; una sesión típica sería así:
+
address@hidden
+$ guix build foo -K
address@hidden @i{build fails}
+$ cd /tmp/guix-build-foo.drv-0
+$ source ./environment-variables
+$ cd foo-1.2
address@hidden example
+
+Ahora puede invocar órdenes (casi) como si fuese el daemon y encontrar los
+errores en su proceso de construcción.
+
+A veces ocurre que, por ejemplo, las pruebas de un paquete pasan cuando las
+ejecuta manualmente pero fallan cuando el daemon las ejecuta. Esto puede
+suceder debido a que el daemon construye dentro de contenedores donde, al
+contrario que en nuestro entorno previo, el acceso a la red no está
+disponible, @file{/bin/sh} no existe, etc. (@pxref{Configuración del entorno
de construcción}).
+
+En esos casos, puede tener que inspeccionar el proceso de construcción desde
+un contenedor similar al creado por el daemon de construcción:
+
address@hidden
+$ guix build -K foo
address@hidden
+$ cd /tmp/guix-build-foo.drv-0
+$ guix environment --no-grafts -C foo --ad-hoc strace gdb
+[env]# source ./environment-variables
+[env]# cd foo-1.2
address@hidden example
+
+Aquí, @command{guix environment -C} crea un contenedor y lanza un shell
+nuevo en él (@pxref{Invocación de guix environment}). El fragmento
address@hidden strace gdb} añade las ordenes @command{strace} y
address@hidden al contenedor, las cuales pueden resultar útiles durante la
+depuración. La opción @option{--no-grafts} asegura que obtenemos exactamente
+el mismo entorno, con paquetes sin injertos (@pxref{Actualizaciones de
seguridad}, para
+más información sobre los injertos).
+
+Para acercarnos más al contenedor usado por el daemon de construcción,
+podemos eliminar @file{/bin/sh}:
+
address@hidden
+[env]# rm /bin/sh
address@hidden example
+
+(No se preocupe, es inocuo: todo esto ocurre en el contenedor de usar y
+tirar creado por @command{guix environment}).
+
+La orden @command{strace} probablemente no esté en la ruta de búsqueda, pero
+podemos ejecutar:
+
address@hidden
+[env]# $GUIX_ENVIRONMENT/bin/strace -f -o log make check
address@hidden example
+
+De este modo, no solo habrá reproducido las variables de entorno que usa el
+daemon, también estará ejecutando el proceso de construcción en un
+contenedor similar al usado por el daemon.
+
+
address@hidden Invocación de guix edit
address@hidden Invocación de @command{guix edit}
+
address@hidden @command{guix edit}
address@hidden definición de paquete, edición
+¡Tantos paquetes, tantos ficheros de fuentes! La orden @command{guix edit}
+facilita la vida de las usuarias y empaquetadoras apuntando su editor al
+fichero de fuentes que contiene la definición de los paquetes
+especificados. Por ejemplo:
+
address@hidden
+guix edit gcc@@4.9 vim
address@hidden example
+
address@hidden
+lanza el programa especificado en la variable de entorno @code{VISUAL} o en
address@hidden para ver la receta de address@hidden y la de Vim.
+
+Si está usando una copia de trabajo de Git de Guix (@pxref{Construcción desde
Git}), o ha creado sus propios paquetes en @code{GUIX_PACKAGE_PATH}
+(@pxref{Módulos de paquetes}), será capaz de editar las recetas de los
+paquetes. En otros casos, podrá examinar las recetas en modo de lectura
+únicamente para paquetes actualmente en el almacén.
+
+
address@hidden Invocación de guix download
address@hidden Invocación de @command{guix download}
+
address@hidden @command{guix download}
address@hidden descargando las fuentes de paquetes
+Durante la escritura de una definición de paquete, las desarrolladoras
+típicamente tienen que descargar un archivador tar de fuentes, calcular su
+hash SHA256 y escribir ese hash en la definición del paquete
+(@pxref{Definición de paquetes}). La herramienta @command{guix download} ayuda
+con esta tarea: descarga un fichero de la URI proporcionada, lo añade al
+almacén e imprime tanto su nombre de fichero en el almacén como su hash
+SHA256.
+
+El hecho de que el fichero descargado se añada al almacén ahorra ancho de
+banda: cuando el desarrollador intenta construir el paquete recién definido
+con @command{guix build}, el archivador de fuentes no tiene que descargarse
+de nuevo porque ya está en el almacén. También es una forma conveniente de
+conservar ficheros temporalmente, que pueden ser borrados en un momento dado
+(@pxref{Invocación de guix gc}).
+
+La orden @command{guix download} acepta las mismas URI que las usadas en las
+definiciones de paquetes. En particular, permite URI @code{mirror://}. Las
+URI @code{https} (HTTP sobre TLS) se aceptan @emph{cuando} el enlace Guile
+con GnuTLS está disponible en el entorno de la usuaria; cuando no está
+disponible se emite un error. @xref{Guile Preparations, how to install the
+GnuTLS bindings for Guile,, gnutls-guile, GnuTLS-Guile}, para más
+información.
+
address@hidden download} verifica los certificados del servidor HTTPS
+cargando las autoridades X.509 del directorio al que apunta la variable de
+entorno @code{SSL_CERT_DIR} (@pxref{Certificados X.509}), a menos que se use
address@hidden
+
+Las siguientes opciones están disponibles:
+
address@hidden @code
address@hidden address@hidden
address@hidden -f @var{fmt}
+Escribe el hash en el formato especificado por @var{fmt}. Para más
+información sobre los valores aceptados en @var{fmt}, @pxref{Invocación de
guix hash}.
+
address@hidden --no-check-certificate
+No valida los certificados X.509 de los servidores HTTPS.
+
+Cuando se usa esta opción, no tiene @emph{absolutamente ninguna garantía} de
+que está comunicando con el servidor responsable de la URL auténtico, lo que
+le hace vulnerables a ataques de intercepción (``man-in-the-middle'').
+
address@hidden address@hidden
address@hidden -o @var{fichero}
+Almacena el fichero descargado en @var{fichero} en vez de añadirlo al
+almacén.
address@hidden table
+
address@hidden Invocación de guix hash
address@hidden Invocación de @command{guix hash}
+
address@hidden @command{guix hash}
+La orden @command{guix hash} calcula el hash SHA256 de un fichero. Es
+principalmente una conveniente herramienta para cualquiera que contribuya a
+la distribución: calcula el hash criptográfico de un fichero, que puede
+usarse en la definición de un paquete (@pxref{Definición de paquetes}).
+
+La sintaxis general es:
+
address@hidden
+guix hash @var{opciones} @var{fichero}
address@hidden example
+
+Cuando @var{fichero} es @code{-} (un guión), @command{guix hash} calcula el
+hash de los datos leídos por la entrada estándar. @command{guix hash} tiene
+las siguientes opciones:
+
address@hidden @code
+
address@hidden address@hidden
address@hidden -f @var{fmt}
+Escribe el hash en el formato especificado por @var{fmt}.
+
+Los formatos disponibles son: @code{nix-base32}, @code{base32},
address@hidden (se puede usar también @code{hex} y @code{hexadecimal}).
+
+Si no se especifica la opción @option{--format}, @command{guix hash}
+mostrará el hash en @code{nix-base32}. Esta representación es la usada en
+las definiciones de paquetes.
+
address@hidden --recursive
address@hidden -r
+Calcula el hash de @var{fichero} recursivamente.
+
address@hidden FIXME: Replace xref above with xref to an ``Archive'' section
when
address@hidden it exists.
+Es este caso el hash se calcula en un archivador que contiene @var{fichero},
+incluyendo su contenido si es un directorio. Algunos de los metadatos de
address@hidden son parte del archivador; por ejemplo, cuando @var{fichero} es
+un fichero normal, el hash es diferente dependiendo de si @var{fichero} es
+ejecutable o no. Los metadatos como las marcas de tiempo no influyen en el
+hash (@pxref{Invocación de guix archive}).
+
address@hidden --exclude-vcs
address@hidden -x
+Cuando se combina con @option{--recursive}, excluye los directorios del
+sistema de control de versiones (@file{.bzr}, @file{.git}, @file{.hg},
+etc.).
+
address@hidden git-fetch
+Como un ejemplo, así es como calcularía el hash de una copia de trabajo Git,
+lo cual es útil cuando se usa el método @code{git-fetch} (@pxref{Referencia de
``origin''}):
+
address@hidden
+$ git clone http://example.org/foo.git
+$ cd foo
+$ guix hash -rx .
address@hidden example
address@hidden table
+
address@hidden Invocación de guix import
address@hidden Invocación de @command{guix import}
+
address@hidden importar paquetes
address@hidden importación de un paquete
address@hidden conversión de un paquete
address@hidden Invocación de @command{guix import}
+La orden @command{guix import} es útil para quienes desean añadir un paquete
+a la distribución con el menor trabajo posible---una demanda legítima. La
+orden conoce algunos repositorios de los que puede ``importar'' metadatos de
+paquetes. El resultado es una definición de paquete, o una plantilla de
+ella, en el formato que conocemos (@pxref{Definición de paquetes}).
+
+La sintaxis general es:
+
address@hidden
+guix import @var{importador} @address@hidden
address@hidden example
+
address@hidden especifica la fuente de la que se importan los metadatos
+del paquete, @var{opciones} especifica un identificador de paquete y otras
+opciones específicas del @var{importador}. Actualmente, los ``importadores''
+disponibles son:
+
address@hidden @code
address@hidden gnu
+Importa los metadatos del paquete GNU seleccionado. Proporciona una
+plantilla para la última versión de dicho paquete GNU, incluyendo el hash de
+su archivador tar de fuentes, y su sinopsis y descripción canónica.
+
+Información adicional como las dependencias del paquete y su licencia deben
+ser deducidas manualmente.
+
+Por ejemplo, la siguiente orden devuelve una definición de paquete para
address@hidden
+
address@hidden
+guix import gnu hello
address@hidden example
+
+Las opciones específicas de línea de ordenes son:
+
address@hidden @code
address@hidden address@hidden
+Como en @code{guix refresh}, especifica la política de tratamiento de las
+claves OpenPGP no encontradas cuando se verifica la firma del
+paquete. @xref{Invocación de guix refresh, @code{--key-download}}.
address@hidden table
+
address@hidden pypi
address@hidden pypi
+Importa metadatos desde el @uref{https://pypi.python.org/, índice de
+paquetes Python (PyPI)}. La información se toma de la descripción con
+formato JSON disponible en @code{pypi.python.org} y habitualmente incluye
+toda la información relevante, incluyendo las dependencias del paquete. Para
+una máxima eficiencia, se recomienda la instalación de la utilidad
address@hidden, de manera que el importador pueda extraer los archivos
+wheel de Python y obtener datos de ellos.
+
+La siguiente orden importa los meta-datos para el paquete de Python
address@hidden:
+
address@hidden
+guix import pypi itsdangerous
address@hidden example
+
address@hidden @code
address@hidden --recursive
address@hidden -r
+Recorre el grafo de dependencias del paquete original proporcionado
+recursivamente y genera expresiones de paquete para todos aquellos paquetes
+que no estén todavía en Guix.
address@hidden table
+
address@hidden gem
address@hidden gem
+Importa metadatos desde @uref{https://rubygems.org/, RubyGems}. La
+información se extrae de la descripción en formato JSON disponible en
address@hidden e incluye la información más relevante, incluyendo las
+dependencias en tiempo de ejecución. Hay algunos puntos a tener en cuenta,
+no obstante. Los metadatos no distinguen entre sinopsis y descripción, por
+lo que se usa la misma cadena para ambos campos. Adicionalmente, los
+detalles de las dependencias no-Ruby necesarias para construir extensiones
+nativas no está disponible y se deja como ejercicio a la empaquetadora.
+
+La siguiente orden importa los meta-datos para el paquete de Ruby
address@hidden:
+
address@hidden
+guix import gem rails
address@hidden example
+
address@hidden @code
address@hidden --recursive
address@hidden -r
+Recorre el grafo de dependencias del paquete original proporcionado
+recursivamente y genera expresiones de paquete para todos aquellos paquetes
+que no estén todavía en Guix.
address@hidden table
+
address@hidden cpan
address@hidden CPAN
+Importa metadatos desde @uref{https://www.metacpan.org/, MetaCPAN}. La
+información se extrae de la descripción en formato JSON disponible a través
+del @uref{https://fastapi.metacpan.org/, API de MetaCPAN} e incluye la
+información más relevante, como las dependencias de otros módulos. La
+información de la licencia debe ser comprobada atentamente. Si Perl está
+disponible en el almacén, se usará la utilidad @code{corelist} para borrar
+los módulos básicos de la lista de dependencias.
+
+La siguiente orden importa los metadatos del módulo Perl
address@hidden::Boolean}:
+
address@hidden
+guix import cpan Acme::Boolean
address@hidden example
+
address@hidden cran
address@hidden CRAN
address@hidden Bioconductor
+Importa metadatos desde @uref{https://cran.r-project.org/, CRAN}, el
+repositorio central para el @uref{http://r-project.org, entorno estadístico
+y gráfico address@hidden
+
+La información se extrae del fichero @code{DESCRIPTION} del paquete.
+
+La siguiente orden importa los metadatos del paquete de R @code{Cairo}:
+
address@hidden
+guix import cran Cairo
address@hidden example
+
+Cuando se añade @code{--recursive}, el importador recorrerá el grafo de
+dependencias del paquete original proporcionado recursivamente y generará
+expresiones de paquetes para todos aquellos que no estén todavía en Guix.
+
+Cuando se agrega @code{--archive=bioconductor}, los metadatos se importan de
address@hidden://www.bioconductor.org, Bioconductor}, un repositorio de
+paquetes R para el análisis y comprensión de datos genéticos de alto caudal
+en bioinformática.
+
+La información se extrae del fichero @code{DESCRIPTION} del paquete
+publicado en la interfaz web del repositorio SVN de Bioconductor.
+
+La siguiente orden importa los metadatos del paquete de R
address@hidden:
+
address@hidden
+guix import cran --archive=bioconductor GenomicRanges
address@hidden example
+
address@hidden texlive
address@hidden Tex Live
address@hidden CTAN
+Importa metadatos desde @uref{http://www.ctan.org/, CTAN}, la completa red
+de archivos TeX para paquetes TeX que son parte de la
address@hidden://www.tug.org/texlive/, distribución TeX Live}.
+
+La información del paquete se obtiene a través del API XML proporcionado por
+CTAN, mientras que el código fuente se descarga del repositorio SVN del
+proyecto TeX Live. Se hace porque CTAN no guarda archivos con versiones.
+
+La siguiente orden importa los metadatos del paquete de TeX @code{fontspec}:
+
address@hidden
+guix import texlive fontspec
address@hidden example
+
+Cuando se añade @code{--archive=DIRECTORIO}, el código fuente no se descarga
+del subdirectorio @file{latex} del árbol @file{texmf-dist/source} en el
+repositorio SVN de Tex Live, sino de el directorio especificado bajo la
+misma raíz.
+
+La siguiente orden importa los metadatos del paquete @code{ifxetex} de CTAN
+mientras que obtiene las fuentes del directorio @file{texmf/source/generic}:
+
address@hidden
+guix import texlive --archive=generic ifxetex
address@hidden example
+
address@hidden json
address@hidden JSON, importación
+Importa metadatos de paquetes desde un fichero JSON local. Considere el
+siguiente ejemplo de definición de paquete en formato JSON:
+
address@hidden
address@hidden
+ "name": "hello",
+ "version": "2.10",
+ "source": "mirror://gnu/hello/hello-2.10.tar.gz",
+ "build-system": "gnu",
+ "home-page": "https://www.gnu.org/software/hello/";,
+ "synopsis": "Hello, GNU world: An example GNU package",
+ "description": "GNU Hello prints a greeting.",
+ "license": "GPL-3.0+",
+ "native-inputs": ["gcc@@6"]
address@hidden
address@hidden example
+
+Los nombres de los campos son los mismos que para el registro
address@hidden<package>} (@xref{Definición de paquetes}). Las referencias a
otros
+paquetes se proporcionan como listas JSON de cadenas de especificación de
+paquete entrecomilladas como @code{guile} o @code{guile@@2.0}.
+
+El importador también permite una definición de fuentes más explícita usando
+los campos comunes de los registros @code{<origin>}:
+
address@hidden
address@hidden
+ @dots{}
+ "source": @{
+ "method": "url-fetch",
+ "uri": "mirror://gnu/hello/hello-2.10.tar.gz",
+ "sha256": @{
+ "base32": "0ssi1wpaf7plaswqqjwigppsg5fyh99vdlb9kzl7c9lng89ndq1i"
+ @}
+ @}
+ @dots{}
address@hidden
address@hidden example
+
+La siguiente orden importa los metadatos desde el fichero JSON
address@hidden y devuelve una expresión de ``package'':
+
address@hidden
+guix import json hello.json
address@hidden example
+
address@hidden nix
+Importa metadatos desde una copia local de las fuentes de la
address@hidden://nixos.org/nixpkgs/, distribución address@hidden depende
+de la orden @command{nix-instantiate} de @uref{http://nixos.org/nix/,
+Nix}.}. Las definiciones de paquete en Nixpkgs típicamente están escritas en
+una mezcla de lenguaje Nix y código Bash. Esta orden únicamente importa la
+estructura de alto nivel del paquete escrita en lenguaje Nix. Normalmente
+incluye todos los campos básicos de una definición de paquete.
+
+Cuando se importa un paquete GNU, la sinopsis y la descripción se
+substituyen por la variante canónica oficial.
+
+Habitualmente, tendrá que ejecutar primero:
+
address@hidden
+export NIX_REMOTE=daemon
address@hidden example
+
address@hidden
+de modo que @command{nix-instantiate} no intente abrir la base de datos Nix.
+
+Como un ejemplo, la orden siguiente importa la definición de paquete de
+LibreOffice (más precisamente, importa la definición del paquete asociado al
+atributo de nivel superior @code{libreoffice}):
+
address@hidden
+guix import nix ~/path/to/nixpkgs libreoffice
address@hidden example
+
address@hidden hackage
address@hidden hackage
+Importa metadatos desde el archivo central de paquetes de la comunidad
+Haskell @uref{https://hackage.haskell.org/, Hackage}. La información se
+obtiene de ficheros Cabal e incluye toda la información relevante,
+incluyendo las dependencias del paquete.
+
+Las opciones específicas de línea de ordenes son:
+
address@hidden @code
address@hidden --stdin
address@hidden -s
+Lee un fichero Cabal por la entrada estándar.
address@hidden --no-test-dependencies
address@hidden -t
+No incluye las dependencias necesarias únicamente para las baterías de
+pruebas.
address@hidden address@hidden
address@hidden -e @var{alist}
address@hidden es una lista asociativa Scheme que define el entorno en el que
+los condicionales Cabal se evalúan. Los valores aceptados son: @code{os},
address@hidden, @code{impl} y una cadena que representa el nombre de la
+condición. El valor asociado a la condición tiene que ser o bien el símbolo
address@hidden o bien @code{false}. Los valores predeterminados asociados a las
+claves @code{os}, @code{arch} y @code{impl} son @samp{linux}, @samp{x86_64}
+y @samp{ghc}, respectivamente.
address@hidden --recursive
address@hidden -r
+Recorre el grafo de dependencias del paquete original proporcionado
+recursivamente y genera expresiones de paquete para todos aquellos paquetes
+que no estén todavía en Guix.
address@hidden table
+
+La siguiente orden importa los metadatos de la última versión del paquete
+Haskell @code{HTTP} sin incluir las dependencias de las pruebas y
+especificando la opción @samp{network-uri} con valor @code{false}:
+
address@hidden
+guix import hackage -t -e "'((\"network-uri\" . false))" HTTP
address@hidden example
+
+Se puede especificar opcionalmente una versión específica del paquete
+añadiendo al nombre del paquete una arroba y el número de versión como en el
+siguiente ejemplo:
+
address@hidden
+guix import hackage mtl@@2.1.3.1
address@hidden example
+
address@hidden stackage
address@hidden stackage
+El importador @code{stackage} es un recubrimiento sobre el de
address@hidden Toma un nombre de paquete, busca la versión de paquete
+incluida en una publicación de la versión de mantenimiento extendido (LTS)
address@hidden://www.stackage.org, Stackage} y usa el importador @code{hackage}
+para obtener sus metadatos. Fíjese que es su decisión seleccionar una
+publicación LTS compatible con el compilador GHC usado en Guix.
+
+Las opciones específicas de línea de ordenes son:
+
address@hidden @code
address@hidden --no-test-dependencies
address@hidden -t
+No incluye las dependencias necesarias únicamente para las baterías de
+pruebas.
address@hidden address@hidden
address@hidden -l @var{versión}
address@hidden es la versión LTS de publicación deseada. Si se omite se usa
+la última publicación.
address@hidden --recursive
address@hidden -r
+Recorre el grafo de dependencias del paquete original proporcionado
+recursivamente y genera expresiones de paquete para todos aquellos paquetes
+que no estén todavía en Guix.
address@hidden table
+
+La siguiente orden importa los metadatos del paquete Haskell @code{HTTP}
+incluido en la versión de publicación LTS de Stackage 7.18:
+
address@hidden
+guix import stackage --lts-version=7.18 HTTP
address@hidden example
+
address@hidden elpa
address@hidden elpa
+Importa metadatos desde el repositorio de archivos de paquetes Emacs Lisp
+(ELPA) (@pxref{Packages,,, emacs, The GNU Emacs Manual}).
+
+Las opciones específicas de línea de ordenes son:
+
address@hidden @code
address@hidden address@hidden
address@hidden -a @var{repo}
address@hidden identifica el repositorio de archivos del que obtener la
+información. Actualmente los repositorios disponibles y sus identificadores
+son:
address@hidden -
address@hidden
address@hidden://elpa.gnu.org/packages, GNU}, seleccionado con el identificador
address@hidden Es el predeterminado.
+
+Los paquetes de @code{elpa.gnu.org} están firmados con una de las claves que
+contiene el anillo de claves GnuPG en
address@hidden/emacs/25.1/etc/package-keyring.gpg} (o similar) en el paquete
address@hidden (@pxref{Package Installation, ELPA package signatures,, emacs,
+The GNU Emacs Manual}).
+
address@hidden
address@hidden://stable.melpa.org/packages, MELPA-Stable}, seleccionado con el
+identificador @code{melpa-stable}.
+
address@hidden
address@hidden://melpa.org/packages, MELPA}, seleccionado con el identificador
address@hidden
address@hidden itemize
+
address@hidden --recursive
address@hidden -r
+Recorre el grafo de dependencias del paquete original proporcionado
+recursivamente y genera expresiones de paquete para todos aquellos paquetes
+que no estén todavía en Guix.
address@hidden table
+
address@hidden crate
address@hidden crate
+Importa metadatos desde el repositorio de paquetes Rust
address@hidden://crates.io, crates.io}.
+
address@hidden opam
address@hidden OPAM
address@hidden OCaml
+Importa metadatos desde el repositorio de paquetes
address@hidden://opam.ocaml.org/, OPAM} usado por la comunidad OCaml.
address@hidden table
+
+La estructura del código de @command{guix import} es modular. Sería útil
+tener más importadores para otros formatos de paquetes, y su ayuda es
+bienvenida aquí (@pxref{Contribuir}).
+
address@hidden Invocación de guix refresh
address@hidden Invocación de @command{guix refresh}
+
address@hidden @command{guix refresh}
+La principal audiencia de @command{guix refresh} son desarrolladoras de la
+distribución de software GNU. Por defecto, informa de cualquier paquete
+proporcionado por la distribución que esté anticuado comparado con la última
+versión oficial, de esta manera:
+
address@hidden
+$ guix refresh
+gnu/packages/gettext.scm:29:13: gettext would be upgraded from 0.18.1.1 to
0.18.2.1
+gnu/packages/glib.scm:77:12: glib would be upgraded from 2.34.3 to 2.37.0
address@hidden example
+
+De manera alternativa, se pueden especificar los paquetes a considerar, en
+cuyo caso se emite un aviso para paquetes que carezcan de actualizador:
+
address@hidden
+$ guix refresh coreutils guile guile-ssh
+gnu/packages/ssh.scm:205:2: warning: no updater for guile-ssh
+gnu/packages/guile.scm:136:12: guile would be upgraded from 2.0.12 to 2.0.13
address@hidden example
+
address@hidden refresh} navega por los repositorios oficiales de cada paquete
+y determina el número de versión mayor entre las publicaciones
+encontradas. La orden sabe cómo actualizar tipos específicos de paquetes:
+paquetes GNU, paquetes ELPA, etc.---vea la documentación de @option{--type}
+más adelante. Hay muchos paquetes, no obstante, para los que carece de un
+método para determinar si está disponible una versión oficial posterior. No
+obstante, el mecanismo es extensible, ¡no tenga problema en contactarnos
+para añadir un método nuevo!
+
address@hidden @code
+
address@hidden --recursive
+Consider the packages specified, and all the packages upon which they
+depend.
+
address@hidden
+$ guix refresh --recursive coreutils
+gnu/packages/acl.scm:35:2: warning: no updater for acl
+gnu/packages/m4.scm:30:12: info: 1.4.18 is already the latest version of m4
+gnu/packages/xml.scm:68:2: warning: no updater for expat
+gnu/packages/multiprecision.scm:40:12: info: 6.1.2 is already the latest
version of gmp
address@hidden
address@hidden example
+
address@hidden table
+
+A veces el nombre oficial es diferente al nombre de paquete usado en Guix, y
address@hidden refresh} necesita un poco de ayuda. La mayor parte de los
+actualizadores utilizan la propiedad @code{upstream-name} en las
+definiciones de paquetes, que puede usarse para obtener dicho efecto:
+
address@hidden
+(define-public network-manager
+ (package
+ (name "network-manager")
+ ;; @dots{}
+ (properties '((upstream-name . "NetworkManager")))))
address@hidden example
+
+Cuando se proporciona @code{--update}, modifica los ficheros de fuentes de
+la distribución para actualizar los números de versión y hash de los
+archivadores tar de fuentes en las recetas de los paquetes (@pxref{Definición
de paquetes}). Esto se consigue con la descarga del último archivador de
+fuentes del paquete y su firma OpenPGP asociada, seguida de la verificación
+del archivador descargado y su firma mediante el uso de @command{gpg}, y
+finalmente con el cálculo de su hash. Cuando la clave pública usada para
+firmar el archivador no se encuentra en el anillo de claves de la usuaria,
+se intenta automáticamente su obtención desde un servidor de claves
+públicas; cuando se encuentra, la clave se añade al anillo de claves de la
+usuaria; en otro caso, @command{guix refresh} informa de un error.
+
+Se aceptan las siguientes opciones:
+
address@hidden @code
+
address@hidden address@hidden
address@hidden -e @var{expr}
+Considera el paquete al que evalúa @var{expr}
+
+Es útil para hacer una referencia precisa de un paquete concreto, como en
+este ejemplo:
+
address@hidden
+guix refresh -l -e '(@@@@ (gnu packages commencement) glibc-final)'
address@hidden example
+
+Esta orden enumera los paquetes que dependen de la libc ``final''
+(esencialmente todos los paquetes).
+
address@hidden --update
address@hidden -u
+Actualiza los ficheros fuente de la distribución (recetas de paquetes) en su
+lugar. Esto se ejecuta habitualmente desde una copia de trabajo del árbol de
+fuentes de Guix (@pxref{Ejecución de Guix antes de estar instalado}):
+
address@hidden
+$ ./pre-inst-env guix refresh -s non-core -u
address@hidden example
+
address@hidden de paquetes}, para más información sobre la definición de
+paquetes.
+
address@hidden address@hidden
address@hidden -s @var{subconjunto}
+Selecciona todos los paquetes en @var{subconjunto}, o bien @code{core} o
+bien @code{non-core}.
+
+El subconjunto @code{core} hace referencia a todos los paquetes en el núcleo
+de la distribución---es decir, paquetes que se usan para construir ``todo lo
+demás''. Esto incluye GCC, libc, Binutils, Bash, etc. Habitualmente, cambiar
+uno de esos paquetes en la distribución conlleva la reconstrucción de todos
+los demás. Por tanto, esas actualizaciones son una inconveniencia para las
+usuarias en términos de tiempo de construcción o ancho de banda usado por la
+actualización.
+
+El subconjunto @code{non-core} hace referencia a los paquetes restantes. Es
+típicamente útil en casos donde una actualización de paquetes básicos no
+sería conveniente.
+
address@hidden address@hidden
address@hidden -m @var{fichero}
+Selecciona todos los paquetes del manifiesto en @var{fichero}. Es útil para
+comprobar si algún paquete del manifiesto puede actualizarse.
+
address@hidden address@hidden
address@hidden -t @var{actualizador}
+Selecciona únicamente paquetes manejados por @var{actualizador} (puede ser
+una lista separada por comas de actualizadores). Actualmente,
address@hidden puede ser:
+
address@hidden @code
address@hidden gnu
+el actualizador de paquetes GNU;
address@hidden gnome
+el actualizador para paquetes GNOME;
address@hidden kde
+el actualizador para paquetes KDE;
address@hidden xorg
+el actualizador para paquetes X.org;
address@hidden kernel.org
+el actualizador para paquetes alojados en kernel.org;
address@hidden elpa
+el actualizador para paquetes @uref{http://elpa.gnu.org/, ELPA};
address@hidden cran
+el actualizador para paquetes @uref{https://cran.r-project.org/, CRAN};
address@hidden bioconductor
+el actualizador para paquetes R @uref{https://www.bioconductor.org/,
+Bioconductor};
address@hidden cpan
+el actualizador para paquetes @uref{http://www.cpan.org/, CPAN};
address@hidden pypi
+el actualizador para paquetes @uref{https://pypi.python.org, PyPI}.
address@hidden gem
+el actualizador para paquetes @uref{https://rubygems.org, RubyGems}.
address@hidden github
+el actualizador para paquetes @uref{https://github.com, GitHub}.
address@hidden hackage
+el actualizador para paquetes @uref{https://hackage.haskell.org, Hackage}.
address@hidden stackage
+el actualizador para paquetes @uref{https://www.stackage.org, Stackage}.
address@hidden crate
+el actualizador para paquetes @uref{https://crates.io, Crates}.
address@hidden launchpad
+el actualizador para paquetes @uref{https://launchpad.net, Launchpad}.
address@hidden table
+
+Por ejemplo, la siguiente orden únicamente comprueba actualizaciones de
+paquetes Emacs alojados en @code{elpa.gnu.org} y actualizaciones de paquetes
+CRAN:
+
address@hidden
+$ guix refresh --type=elpa,cran
+gnu/packages/statistics.scm:819:13: r-testthat would be upgraded from 0.10.0
to 0.11.0
+gnu/packages/emacs.scm:856:13: emacs-auctex would be upgraded from 11.88.6 to
11.88.9
address@hidden example
+
address@hidden table
+
+Además, @command{guix refresh} puede recibir uno o más nombres de paquetes,
+como en este ejemplo:
+
address@hidden
+$ ./pre-inst-env guix refresh -u emacs idutils gcc@@4.8
address@hidden example
+
address@hidden
+La orden previa actualiza específicamente los paquetes @code{emacs} y
address@hidden La opción @code{--select} no tendría efecto en este caso.
+
+Cuando se considera la actualización de un paquete, a veces es conveniente
+conocer cuantos paquetes se verían afectados por la actualización y su
+compatibilidad debería comprobarse. Para ello la siguiente opción puede
+usarse cuando se proporcionan uno o más nombres de paquete a @command{guix
+refresh}:
+
address@hidden @code
+
address@hidden --list-updaters
address@hidden -L
+Enumera los actualizadores disponibles y finaliza (vea la opción previa
address@hidden).
+
+Para cada actualizador, muestra la fracción de paquetes que cubre; al final
+muestra la fracción de paquetes cubiertos por todos estos actualizadores.
+
address@hidden --list-dependent
address@hidden -l
+Enumera los paquetes de nivel superior dependientes que necesitarían una
+reconstrucción como resultado de la actualización de uno o más paquetes.
+
address@hidden de guix graph, el tipo @code{reverse-package} de @command{guix
+graph}}, para información sobre cómo visualizar la lista de paquetes que
+dependen de un paquete.
+
address@hidden table
+
+Sea consciente de que la opción @code{--list-dependent} únicamente
address@hidden las reconstrucciones necesarias como resultado de una
+actualización. Más reconstrucciones pueden ser necesarias bajo algunas
+circunstancias.
+
address@hidden
+$ guix refresh --list-dependent flex
+Building the following 120 packages would ensure 213 dependent packages are
rebuilt:
+hop@@2.4.0 geiser@@0.4 notmuch@@0.18 mu@@0.9.9.5 cflow@@1.4 idutils@@4.6
@dots{}
address@hidden example
+
+La orden previa enumera un conjunto de paquetes que puede ser construido
+para comprobar la compatibilidad con una versión actualizada del paquete
address@hidden
+
address@hidden @code
+
address@hidden --list-transitive
+Enumera todos los paquetes de los que uno o más paquetes dependen.
+
address@hidden
+$ guix refresh --list-transitive flex
+flex@@2.6.4 depends on the following 25 packages: perl@@5.28.0 help2man@@1.47.6
+bison@@3.0.5 indent@@2.2.10 tar@@1.30 gzip@@1.9 bzip2@@1.0.6 xz@@5.2.4
file@@5.33 @dots{}
address@hidden example
+
address@hidden table
+
+La orden previa enumera un conjunto de paquetes que, en caso de cambiar,
+causarían la reconstrucción de @code{flex}.
+
+Las siguientes opciones pueden usarse para personalizar la operación de
+GnuPG:
+
address@hidden @code
+
address@hidden address@hidden
+Use @var{orden} como la orden de GnuPG 2.x. Se busca @var{orden} en
address@hidden
+
address@hidden address@hidden
+Usa @var{fichero} como el anillo de claves para claves de
+proveedoras. @var{fichero} debe estar en el @dfn{formato keybox}. Los
+ficheros Keybox normalmente tienen un nombre terminado en @file{.kbx} y
address@hidden Guard (GPG) puede manipular estos ficheros (@pxref{kbxutil,
address@hidden,, gnupg, Using the GNU Privacy Guard}, para información
+sobre una herramienta para manipular ficheros keybox).
+
+Cuando se omite esta opción, @command{guix refresh} usa
address@hidden/.config/guix/upstream/trustedkeys.kbx} como el anillo de claves
para
+las firmas de proveedoras. Las firmas OpenPGP son comprobadas contra claves
+de este anillo; las claves que falten son descargadas a este anillo de
+claves también (véase @option{--key-download} a continuación).
+
+Puede exportar claves de su anillo de claves GPG predeterminado en un
+fichero keybox usando órdenes como esta:
+
address@hidden
+gpg --export rms@@gnu.org | kbxutil --import-openpgp >> mianillo.kbx
address@hidden example
+
+Del mismo modo, puede obtener claves de un archivo keybox específico así:
+
address@hidden
+gpg --no-default-keyring --keyring mianillo.kbx \
+ --recv-keys @value{OPENPGP-SIGNING-KEY-ID}
address@hidden example
+
address@hidden Configuration Options, @option{--keyring},, gnupg, Using the GNU
+Privacy Guard}, para más información sobre la opción @option{--keyring} de
+GPG.
+
address@hidden address@hidden
+Maneja las claves no encontradas de acuerdo a la @var{política}, que puede
+ser una de:
+
address@hidden @code
address@hidden always
+Siempre descarga las claves OpenPGP no encontradas del servidor de claves, y
+las añade al anillo de claves GnuPG de la usuaria.
+
address@hidden never
+Nunca intenta descargar claves OpenPGP no encontradas. Simplemente propaga
+el error.
+
address@hidden interactive
+Cuando se encuentra un paquete firmado por una clave OpenPGP desconocida,
+pregunta a la usuaria si descargarla o no. Este es el comportamiento
+predeterminado.
address@hidden table
+
address@hidden address@hidden
+Use @var{dirección} como el servidor de claves OpenPGP cuando se importa una
+clave pública.
+
address@hidden table
+
+The @code{github} updater uses the @uref{https://developer.github.com/v3/,
+GitHub API} to query for new releases. When used repeatedly e.g.@: when
+refreshing all packages, GitHub will eventually refuse to answer any further
+API requests. By default 60 API requests per hour are allowed, and a full
+refresh on all GitHub packages in Guix requires more than this.
+Authentication with GitHub through the use of an API token alleviates these
+limits. To use an API token, set the environment variable
address@hidden to a token procured from
address@hidden://github.com/settings/tokens} or otherwise.
+
+
address@hidden Invocación de guix lint
address@hidden Invocación de @command{guix lint}
+
address@hidden @command{guix lint}
address@hidden paquete, comprobación de errores
+La orden @command{guix lint} sirve para ayudar a las desarrolladoras de
+paquetes a evitar errores comunes y usar un estilo consistente. Ejecuta un
+número de comprobaciones en un conjunto de paquetes proporcionado para
+encontrar errores comunes en sus definiciones. Los @dfn{comprobadores}
+disponibles incluyen (véase @code{--list-checkers} para una lista completa):
+
address@hidden @code
address@hidden synopsis
address@hidden description
+Valida ciertas reglas tipográficas y de estilo en la descripción y sinopsis
+de cada paquete.
+
address@hidden inputs-should-be-native
+Identifica entradas que probablemente deberían ser entradas nativas.
+
address@hidden source
address@hidden home-page
address@hidden mirror-url
address@hidden github-url
address@hidden source-file-name
+Comprueba las URL @code{home-page} y @code{source} e informa aquellas que no
+sean válidas. Sugiere una URL @code{mirror://} cuando sea aplicable. Si la
+URL @code{source} redirecciona a una URL GitHub, recomienda el uso de la URL
+GitHub. Comprueba que el nombre de fichero de las fuentes es significativo,
+por ejemplo que no es simplemente un número de versión o revisión git, sin
+un nombre @code{file-name} declarado (@pxref{Referencia de ``origin''}).
+
address@hidden source-unstable-tarball
+Parse the @code{source} URL to determine if a tarball from GitHub is
+autogenerated or if it is a release tarball. Unfortunately GitHub's
+autogenerated tarballs are sometimes regenerated.
+
address@hidden cve
address@hidden vulnerabilidades de seguridad
address@hidden CVE, vulnerabilidades y exposiciones comunes
+Informa de vulnerabilidades encontradas en las bases de datos de
+vulnerabilidades y exposiciones comunes (CVE) del año actual y el pasado
address@hidden://nvd.nist.gov/download.cfm#CVE_FEED, publicadas por el NIST de
+EEUU}.
+
+Para ver información acerca de una vulnerabilidad particular, visite páginas
+como:
+
address@hidden
address@hidden
address@hidden://web.nvd.nist.gov/view/vuln/detail?vulnId=CVE-YYYY-ABCD}
address@hidden
address@hidden://cve.mitre.org/cgi-bin/cvename.cgi?name=CVE-YYYY-ABCD}
address@hidden itemize
+
address@hidden
+donde @code{CVE-YYYY-ABCD} es el identificador CVE---por ejemplo,
address@hidden
+
+Las desarrolladoras de paquetes pueden especificar en las recetas del
+paquete el nombre y versión en la @uref{https://nvd.nist.gov/cpe.cfm,
+plataforma común de enumeración (CPE)} del paquete cuando difieren del
+nombre o versión que usa Guix, como en este ejemplo:
+
address@hidden
+(package
+ (name "grub")
+ ;; @dots{}
+ ;; CPE llama a este paquete "grub2".
+ (properties '((cpe-name . "grub2")
+ (cpe-version . "2.3")))
address@hidden example
+
address@hidden See <http://www.openwall.com/lists/oss-security/2017/03/15/3>.
+Algunas entradas en la base de datos CVE no especifican a qué versión del
+paquete hacen referencia, y por lo tanto ``permanecen visibles'' para
+siempre. Las desarrolladoras de paquetes que encuentren alertas CVE y
+verifiquen que pueden ignorarse, pueden declararlas como en este ejemplo:
+
address@hidden
+(package
+ (name "t1lib")
+ ;; @dots{}
+ ;; Estas alertas de CVE no aplican y pueden ignorarse
+ ;; con seguridad.
+ (properties `((lint-hidden-cve . ("CVE-2011-0433"
+ "CVE-2011-1553"
+ "CVE-2011-1554"
+ "CVE-2011-5244")))))
address@hidden example
+
address@hidden formatting
+Avisa de problemas de formato obvios en el código fuente: espacios en blanco
+al final de las líneas, uso de tabuladores, etc.
address@hidden table
+
+La sintaxis general es:
+
address@hidden
+guix lint @var{opciones} @address@hidden
address@hidden example
+
+Si no se proporciona ningún paquete en la linea de órdenes, todos los
+paquetes se comprueban. Las @var{opciones} pueden ser cero o más de las
+siguientes:
+
address@hidden @code
address@hidden --list-checkers
address@hidden -l
+Enumera y describe todos los comprobadores disponibles que se ejecutarán
+sobre los paquetes y finaliza.
+
address@hidden --checkers
address@hidden -c
+Habilita únicamente los comprobadores especificados en una lista separada
+por comas que use los nombres devueltos por @code{--list-checkers}.
+
address@hidden table
+
address@hidden Invocación de guix size
address@hidden Invocación de @command{guix size}
+
address@hidden tamaño
address@hidden tamaño del paquete
address@hidden clausura
address@hidden @command{guix size}
+La orden @command{guix size} ayuda a las desarrolladoras de paquetes a
+perfilar el uso de disco de los paquetes. Es fácil pasar por encima el
+impacto que produce añadir una dependencia adicional a un paquete, o el
+impacto del uso de una salida única para un paquete que puede ser dividido
+fácilmente (@pxref{Paquetes con múltiples salidas}). Estos son los problemas
+típicos que @command{guix size} puede resaltar.
+
+Se le pueden proporcionar una o más especificaciones de paquete como
address@hidden@@4.8} o @code{guile:debug}, o un nombre de fichero en el
+almacén. Considere este ejemplo:
+
address@hidden
+$ guix size coreutils
+store item total self
+/gnu/store/@dots{}-gcc-5.5.0-lib 60.4 30.1 38.1%
+/gnu/store/@dots{}-glibc-2.27 30.3 28.8 36.6%
+/gnu/store/@dots{}-coreutils-8.28 78.9 15.0 19.0%
+/gnu/store/@dots{}-gmp-6.1.2 63.1 2.7 3.4%
+/gnu/store/@dots{}-bash-static-4.4.12 1.5 1.5 1.9%
+/gnu/store/@dots{}-acl-2.2.52 61.1 0.4 0.5%
+/gnu/store/@dots{}-attr-2.4.47 60.6 0.2 0.3%
+/gnu/store/@dots{}-libcap-2.25 60.5 0.2 0.2%
+total: 78.9 MiB
address@hidden example
+
address@hidden clausura
+Los elementos del almacén enumerados aquí constituyen la @dfn{clausura
+transitiva} de Coreutils---es decir, Coreutils y todas sus dependencias,
+recursivamente---como sería devuelto por:
+
address@hidden
+$ guix gc -R /gnu/store/@dots{}-coreutils-8.23
address@hidden example
+
+Aquí la salida muestra tres columnas junto a los elementos del almacén. La
+primera columna, etiquetada ``total'', muestra el tamaño en mebibytes (MiB)
+de la clausura del elemento del almacén---es decir, su propio tamaño sumado
+al tamaño de todas sus dependencias. La siguiente columna, etiquetada
+``self'', muestra el tamaño del elemento en sí. La última columna muestra la
+relación entre el tamaño del elemento en sí frente al espacio ocupado por
+todos los elementos enumerados.
+
+En este ejemplo, vemos que la clausura de Coreutils ocupa address@hidden, cuya
+mayor parte son libc y las bibliotecas auxiliares de GCC para tiempo de
+ejecución. (Que libc y las bibliotecas de GCC representen una fracción
+grande de la clausura no es un problema en sí, puesto que siempre están
+disponibles en el sistema de todas maneras).
+
+Cuando los paquetes pasados a @command{guix size} están disponibles en el
address@hidden precisamente, @command{guix size} busca la variante
address@hidden injertos} de los paquetes, como el devuelto por @code{guix build
address@hidden --no-grafts}. @xref{Actualizaciones de seguridad}, para
información sobre
+injertos.} consultando al daemon para determinar sus dependencias, y mide su
+tamaño en el almacén, de forma similar a @command{du -ms --apparent-size}
+(@pxref{du invocation,,, coreutils, GNU Coreutils}).
+
+Cuando los paquetes proporcionados @emph{no} están en el almacén,
address@hidden size} informa en base de las sustituciones disponibles
+(@pxref{Sustituciones}). Esto hace posible perfilar el espacio en disco
+incluso de elementos del almacén que no están en el disco, únicamente
+disponibles de forma remota.
+
+Puede especificar también varios nombres de paquetes:
+
address@hidden
+$ guix size coreutils grep sed bash
+store item total self
+/gnu/store/@dots{}-coreutils-8.24 77.8 13.8 13.4%
+/gnu/store/@dots{}-grep-2.22 73.1 0.8 0.8%
+/gnu/store/@dots{}-bash-4.3.42 72.3 4.7 4.6%
+/gnu/store/@dots{}-readline-6.3 67.6 1.2 1.2%
address@hidden
+total: 102.3 MiB
address@hidden example
+
address@hidden
+En este ejemplo vemos que la combinación de los cuatro paquetes toma
address@hidden en total, lo cual es mucho menos que la suma de cada
+clausura, ya que tienen muchas dependencias en común.
+
+Las opciones disponibles son:
+
address@hidden @option
+
address@hidden address@hidden
+Usa la información de sustituciones de
address@hidden @xref{client-substitute-urls, la misma opción en @code{guix
+build}}.
+
address@hidden address@hidden
+Ordena las líneas de acuerdo a @var{clave}, una de las siguientes opciones:
+
address@hidden @code
address@hidden self
+el tamaño de cada elemento (predeterminada);
address@hidden clausura
+el tamaño total de la clausura del elemento.
address@hidden table
+
address@hidden address@hidden
+Escribe un mapa gráfico del uso del disco en formato PNG en el
address@hidden
+
+Para el ejemplo previo, el mapa tiene esta pinta:
+
address@hidden/coreutils-size-map,5in,, mapa del uso del disco de Coreutils
+producido por @command{guix size}}
+
+Esta opción necesita que la biblioteca
address@hidden://wingolog.org/software/guile-charting/, Guile-Charting} esté
+instalada y visible en la ruta de búsqueda de módulos Guile. Cuando no es el
+caso, @command{guix size} produce un error al intentar cargarla.
+
address@hidden address@hidden
address@hidden -s @var{sistema}
+Considera paquetes para @var{sistema}---por ejemplo, @code{x86_64-linux}.
+
address@hidden table
+
address@hidden Invocación de guix graph
address@hidden Invocación de @command{guix graph}
+
address@hidden GAD (DAG en Inglés)
address@hidden @command{guix graph}
address@hidden dependencias de un paquete
+Los paquetes y sus dependencias forman un @dfn{grafo}, específicamente un
+grafo acíclico dirigido (GAD, DAG en Inglés). Puede hacerse difícil
+rápidamente tener un modelo mental del GAD del paquete, por lo que la orden
address@hidden graph} proporciona una representación virtual del GAD. Por
+defecto, @command{guix graph} emite una representación en GAD en el formato
+de entrada de @uref{http://graphviz.org/,Graphviz}, por lo que su salida
+puede ser pasada directamente a la herramienta @command{dot} de
+Graphviz. También puede emitir una página HTMP con código JavaScript
+embebido para mostrar un ``diagrama de acorde'' en un navegador Web, usando
+la biblioteca @uref{https://d3js.org/, d3.js}, o emitir consultas Cypher
+para construir un grafo en una base de datos de grafos que acepte el
+lenguaje de consultas @uref{http://www.opencypher.org/, openCypher}. La
+sintaxis general es:
+
address@hidden
+guix graph @var{opciones} @address@hidden
address@hidden example
+
+Por ejemplo, la siguiente orden genera un fichero PDF que representa el GAD
+para address@hidden Utilities, mostrando sus dependencias en tiempo de
+construcción:
+
address@hidden
+guix graph coreutils | dot -Tpdf > gad.pdf
address@hidden example
+
+La salida es algo así:
+
address@hidden/coreutils-graph,2in,,Grafo de dependencias de GNU Coreutils}
+
+Bonito y pequeño grafo, ¿no?
+
+¡Pero hay más de un grafo! El grafo previo es conciso: es el grafo de los
+objetos package, omitiendo las entradas implícitas como GCC, libc, grep,
+etc. Es habitualmente útil tener un grafo conciso así, pero a veces una
+puede querer ver más detalles. @command{guix graph} implementa varios tipos
+de grafos, permitiendole seleccionar el nivel de detalle:
+
address@hidden @code
address@hidden package
+Este es el tipo por defecto usado en el ejemplo previo. Muestra el GAD de
+objetos package, excluyendo dependencias implícitas. Es conciso, pero deja
+fuera muchos detalles.
+
address@hidden reverse-package
+Esto muestra el GAD @emph{inverso} de paquetes. Por ejemplo:
+
address@hidden
+guix graph --type=reverse-package ocaml
address@hidden example
+
+...@: yields the graph of packages that @emph{explicitly} depend on OCaml
+(if you are also interested in cases where OCaml is an implicit dependency,
+see @code{reverse-bag} below.)
+
+Fíjese que esto puede producir grafos inmensos para los paquetes básicos. Si
+todo lo que quiere saber es el número de paquetes que dependen de uno
+determinado, use @command{guix refresh --list-dependent} (@pxref{Invocación de
guix refresh, @option{--list-dependent}}).
+
address@hidden bag-emerged
+Este es el GAD del paquete, @emph{incluyendo} entradas implícitas.
+
+Por ejemplo, la siguiente orden:
+
address@hidden
+guix graph --type=bag-emerged coreutils | dot -Tpdf > gad.pdf
address@hidden example
+
+...@: emite este grafo más grande:
+
address@hidden/coreutils-bag-graph,,5in,Grafo de dependencias detallado de
+GNU Coreutils}
+
+En la parte inferior del grafo, vemos todas las entradas implícitas de
address@hidden (@pxref{Sistemas de construcción, @code{gnu-build-system}}).
+
+Ahora bien, fijese que las dependencias de estas entradas implícitas---es
+decir, las @dfn{dependencias del lanzamiento inicial}
+(@pxref{Lanzamiento inicial})---no se muestran aquí para mantener una salida
+concisa.
+
address@hidden bag
+Similar a @code{bag-emerged}, pero esta vez incluye todas las dependencias
+del lanzamiento inicial.
+
address@hidden bag-with-origins
+Similar a @code{bag}, pero también muestra los orígenes y sus dependencias.
+
address@hidden reverse-bag
+This shows the @emph{reverse} DAG of packages. Unlike
address@hidden, it also takes implicit dependencies into account.
+For example:
+
address@hidden
+guix graph -t reverse-bag dune
address@hidden example
+
address@hidden
+...@: yields the graph of all packages that depend on Dune, directly or
+indirectly. Since Dune is an @emph{implicit} dependency of many packages
address@hidden @code{dune-build-system}, this shows a large number of packages,
+whereas @code{reverse-package} would show very few if any.
+
address@hidden derivación
+Esta es la representación más detallada: muestra el GAD de derivaciones
+(@pxref{Derivaciones}) y elementos simples del almacén. Comparada con las
+representaciones previas, muchos nodos adicionales son visibles, incluyendo
+los guiones de construcción, parches, módulos Guile, etc.
+
+Para este tipo de grafo, también es posible pasar un nombre de fichero
address@hidden en vez del nombre del paquete, como en:
+
address@hidden
+guix graph -t derivation `guix system build -d mi-configuracion.scm`
address@hidden example
+
address@hidden module
+Este es el grafo de los @dfn{módulos de paquete} (@pxref{Módulos de
paquetes}). Por ejemplo, la siguiente orden muestra el grafo para el módulo
+de paquetes que define el paquete @code{guile}:
+
address@hidden
+guix graph -t module guile | dot -Tpdf > grafo-del-modulo.pdf
address@hidden example
address@hidden table
+
+Todos los tipos previos corresponden a las @emph{dependencias durante la
+construcción}. El grafo siguiente representa las @emph{dependencias en
+tiempo de ejecución}:
+
address@hidden @code
address@hidden references
+Este es el grafo de @dfn{referencias} de la salida de un paquete, como lo
+devuelve @command{guix gc --references} (@pxref{Invocación de guix gc}).
+
+Si la salida del paquete proporcionado no está disponible en el almacén,
address@hidden graph} intenta obtener la información de dependencias desde
+las sustituciones.
+
+Aquí también puede proporcionar un nombre de fichero del almacén en vez de
+un nombre de paquete. Por ejemplo, la siguiente orden produce el grafo de
+referencias de su perfil (¡el cuál puede ser grande!):
+
address@hidden
+guix graph -t references `readlink -f ~/.guix-profile`
address@hidden example
+
address@hidden referrers
+Este es el grafo de @dfn{referentes} de la salida de un paquete, como lo
+devuelve @command{guix gc --referrers} (@pxref{Invocación de guix gc}).
+
+Depende exclusivamente de información en su almacén. Por ejemplo, supongamos
+que la versión actual de Inkscape está disponible en 10 perfiles en su
+máquina; @command{guix graph -t referrers inkscape} mostrará un grafo cuya
+raíz es Inkscape y con esos 10 perfiles enlazados a ella.
+
+Puede ayudar a determinar qué impide que un elemento del almacén sea
+recolectado.
+
address@hidden table
+
+Las opciones disponibles son las siguientes:
+
address@hidden @option
address@hidden address@hidden
address@hidden -t @var{tipo}
+Produce un grafo de salida de @var{tipo}, donde @var{tipo} debe ser uno de
+los valores enumerados previamente.
+
address@hidden --list-types
+Enumera los tipos de grafos implementados.
+
address@hidden address@hidden
address@hidden -b @var{motor}
+Produce un grafo usando el @var{motor} seleccionado.
+
address@hidden --list-backends
+Enumera los motores de grafos implementados.
+
+Actualmente, los motores disponibles son Graphviz y d3.js.
+
address@hidden address@hidden
address@hidden -e @var{expr}
+Considera el paquete al que evalúa @var{expr}
+
+Es útil para hacer una referencia precisa de un paquete concreto, como en
+este ejemplo:
+
address@hidden
+guix graph -e '(@@@@ (gnu packages commencement) gnu-make-final)'
address@hidden example
+
address@hidden address@hidden
address@hidden -s @var{sistema}
+Muestra el grafo para @var{sistema}---por ejemplo, @code{i686-linux}.
+
+El grafo de dependencias del paquete es altamente independiente de la
+arquitectura, pero existen algunas partes dependientes de la arquitectura
+que esta opción le permite visualizar.
address@hidden table
+
+
+
address@hidden Invocación de guix publish
address@hidden Invocación de @command{guix publish}
+
address@hidden @command{guix publish}
+El propósito de @command{guix publish} es permitir a las usuarias compartir
+fácilmente su almacén con otras, quienes pueden usarlo como servidor de
+sustituciones (@pxref{Sustituciones}).
+
+Cuando @command{guix publish} se ejecuta, lanza un servidor HTTP que permite
+a cualquiera que tenga acceso a través de la red obtener sustituciones de
+él. Esto significa que cualquier máquina que ejecute Guix puede actuar como
+si fuese una granja de construcción, ya que la interfaz HTTP es compatible
+con Hydra, el software detrás de la granja de construcción
address@hidden@value{SUBSTITUTE-SERVER}}.
+
+Por seguridad, cada sustitución se firma, permitiendo a las receptoras
+comprobar su autenticidad e integridad (@pxref{Sustituciones}). Debido a que
address@hidden publish} usa la clave de firma del sistema, que es únicamente
+legible por la administradora del sistema, debe iniciarse como root; la
+opción @code{--user} hace que renuncie a sus privilegios tan pronto como sea
+posible.
+
+El par claves de firma debe generarse antes de ejecutar @command{guix
+publish}, usando @command{guix archive --generate-key} (@pxref{Invocación de
guix archive}).
+
+La sintaxis general es:
+
address@hidden
+guix publish @address@hidden
address@hidden example
+
+La ejecución de @command{guix publish} sin ningún parámetro adicional
+lanzará un servidor HTTP en el puerto 8080:
+
address@hidden
+guix publish
address@hidden example
+
+Una vez el servidor de publicación ha sido autorizado (@pxref{Invocación de
guix archive}), el daemon puede descargar sustituciones de él:
+
address@hidden
+guix-daemon --substitute-urls=http://example.org:8080
address@hidden example
+
+Por defecto, @command{guix publish} comprime los archivos al vuelo cuando es
+necesario. Este modo ``al vuelo'' es conveniente ya que no necesita
+configuración y está disponible inmediatamente. No obstante, cuando se
+proporciona servicio a muchos clientes, se recomienda usar la opción
address@hidden, que habilita el almacenamiento en caché de los archivos
+antes de enviarlos a los clientes---véase a continuación para más
+detalles. La orden @command{guix weather} proporciona una forma fácil de
+comprobar lo que proporciona un servidor (@pxref{Invocación de guix weather}).
+
+Además @command{guix publish} también sirve como un espejo de acceso por
+contenido a ficheros de fuentes a los que los registros @code{origin} hacen
+referencia (@pxref{Referencia de ``origin''}). Por ejemplo, si asumimos que
address@hidden publish} se ejecuta en @code{example.org}, la siguiente URL
+devuelve directamente el fichero @file{hello-2.10.tar.gz} con el hash SHA256
+proporcionado (representado en formato @code{nix-base32}, @pxref{Invocación de
guix hash}).
+
address@hidden
+http://example.org/file/hello-2.10.tar.gz/sha256/address@hidden
address@hidden example
+
+Obviamente estas URL funcionan solamente para ficheros que se encuentran en
+el almacén; en otros casos devuelven un 404 (``No encontrado'').
+
address@hidden logs de construcción, publicación
+Los log de construcción están disponibles desde URL @code{/log} como:
+
address@hidden
+http://example.org/log/address@hidden
address@hidden example
+
address@hidden
+Cuando @command{guix-daemon} está configurado para almacenar comprimidos los
+log de construcción, como sucede de forma predeterminada (@pxref{Invocación de
guix-daemon}), las URL @code{/log} devuelven los log igualmente comprimidos,
+con un @code{Content-Type} adecuado y/o una cabecera
address@hidden Recomendamos ejecutar @command{guix-daemon} con
address@hidden ya que los navegadores Web pueden extraer el
+contenido automáticamente, lo cual no es el caso con la compresión bzip2.
+
+Las siguientes opciones están disponibles:
+
address@hidden @code
address@hidden address@hidden
address@hidden -p @var{puerto}
+Escucha peticiones HTTP en @var{puerto}.
+
address@hidden address@hidden
+Escucha en la interfaz de red de la @var{dirección}. El comportamiento
+predeterminado es aceptar conexiones de cualquier interfaz.
+
address@hidden address@hidden
address@hidden -u @var{usuaria}
+Cambia los privilegios a los de @var{usuaria} tan pronto como sea
+posible---es decir, una vez el socket del servidor esté abierto y la clave
+de firma haya sido leída.
+
address@hidden address@hidden
address@hidden -C address@hidden
+Comprime los datos con el @var{nivel} dado. Cuando el @var{nivel} es cero,
+deshabilita la compresión. El rango 1 a 9 corresponde a distintos niveles de
+compresión gzip: 1 es el más rápido, y 9 es el mejor (intensivo a nivel de
+CPU). El valor predeterminado es 3.
+
+A menos que se use @option{--cache}, la compresión ocurre al vuelo y los
+flujos comprimidos no se almacenan en caché. Por tanto, para reducir la
+carga en la máquina que ejecuta @command{guix publish}, puede ser una buena
+idea elegir un nivel de compresión bajo, ejecutar @command{guix publish}
+detrás de un proxy con caché o usar @option{--cache}. El uso de
address@hidden tiene la ventaja de que permite a @command{guix publish}
+añadir la cabecera HTTP @code{Content-Length} a sus respuestas.
+
address@hidden address@hidden
address@hidden -c @var{directorio}
+Almacena en caché los archivos y metadatos (URL @code{.narinfo}) en
address@hidden y únicamente proporciona archivos que están en la caché.
+
+Cuando se omite esta opción, los archivos y metadatos se crean al
+vuelo. Esto puede reducir el ancho de banda disponible, especialmente cuando
+la compresión está habilitada, ya que se puede llegar al límite de la
+CPU. Otra desventaja del modo predeterminado es que la longitud de los
+archivos no se conoce con anterioridad, por lo que @command{guix publish} no
+puede añadir la cabecera HTTP @code{Content-Length} a sus respuestas, lo que
+a su vez previene que los clientes conozcan la cantidad de datos a
+descargar.
+
+De manera contraria, cuando se usa @option{--cache}, la primera petición de
+un elemento del almacén (a través de una URL @code{.narinfo}) devuelve 404 e
+inicia un proceso en segundo plano para @dfn{cocinar} el archivo---calcular
+su @code{.narinfo} y comprimirlo, en caso necesario. Una vez el archivo está
+alojado en la caché de @var{directorio}, las siguientes peticiones obtendrán
+un resultado satisfactorio y se ofrecerá el contenido directamente desde la
+caché, lo que garantiza que los clientes obtienen el mejor ancho de banda
+posible.
+
+El proceso de ``cocinado'' se realiza por hilos de trabajo. Por defecto, se
+crea un hilo por núcleo de la CPU, pero puede ser personalizado. Véase
address@hidden a continuación.
+
+Cuando se usa @option{--ttl}, las entradas en caché se borran
+automáticamente cuando hayan expirado.
+
address@hidden address@hidden
+Cuando se usa @option{--cache}, solicita la creación de @var{N} hilos de
+trabajo para ``cocinar'' archivos.
+
address@hidden address@hidden
+Produce cabeceras HTTP @code{Cache-Control} que anuncian un tiempo-de-vida
+(TTL) de @var{ttl}. @var{ttl} debe indicar una duración: @code{5d} significa
+5 días, @code{1m} significa un mes, etc.
+
+Esto permite a la usuaria de Guix mantener información de sustituciones en
+la caché durante @var{ttl}. No obstante, fíjese que @code{guix publish} no
+garantiza en sí que los elementos del almacén que proporciona de hecho
+permanezcan disponibles hasta que @var{ttl} expire.
+
+Adicionalmente, cuando se usa @option{--cache}, las entradas en caché que no
+hayan sido accedidas en @var{ttl} y no tengan un elemento correspondiente en
+el almacén pueden ser borradas.
+
address@hidden address@hidden
+Usa @var{ruta} como el prefijo para las URL de los archivos ``nar''
+(@pxref{Invocación de guix archive, archivadores normalizados}).
+
+Por defecto, los archivos nar se proporcionan en una URL como
address@hidden/nar/gzip/@dots{}-coreutils-8.25}. Esta opción le permite cambiar
la
+parte @code{/nar} por @var{ruta}.
+
address@hidden address@hidden
address@hidden address@hidden
+Usa los @var{fichero}s específicos como el par de claves pública y privada
+usadas para firmar los elementos del almacén publicados.
+
+Los ficheros deben corresponder al mismo par de claves (la clave privada se
+usa para la firma y la clave pública simplemente se anuncia en los metadatos
+de la firma). Deben contener claves en el formato canónico de expresiones-S
+como el producido por @command{guix archive --generate-key} (@pxref{Invocación
de guix archive}). Por defecto, se usan @file{/etc/guix/signing-key.pub} y
address@hidden/etc/guix/signing-key.sec}.
+
address@hidden address@hidden
address@hidden -r address@hidden
+Lanza un servidor REPL Guile (@pxref{REPL Servers,,, guile, GNU Guile
+Reference Manual}) en @var{puerto} (37146 por defecto). Esto se usa
+principalmente para la depuración de un servidor @command{guix publish} en
+ejecución.
address@hidden table
+
+Habilitar @command{guix publish} en el sistema Guix consiste en solo una
+línea: simplemente instancie un servicio @code{guix-publish-service-type} en
+el campo @code{services} de su declaración del sistema operativo
address@hidden (@pxref{guix-publish-service-type,
address@hidden)
+
+Si en vez de eso ejecuta Guix en una distribución distinta, siga estas
+instrucciones:
+
address@hidden
address@hidden
+Si su distribución anfitriona usa el sistema de inicio systemd:
+
address@hidden
+# ln -s ~root/.guix-profile/lib/systemd/system/guix-publish.service \
+ /etc/systemd/system/
+# systemctl start guix-publish && systemctl enable guix-publish
address@hidden example
+
address@hidden
+Si su distribución anfitriona usa el sistema de inicio Upstart:
+
address@hidden
+# ln -s ~root/.guix-profile/lib/upstart/system/guix-publish.conf /etc/init/
+# start guix-publish
address@hidden example
+
address@hidden
+En otro caso, proceda de forma similar con el sistema de inicio de su
+distribución.
address@hidden itemize
+
address@hidden Invocación de guix challenge
address@hidden Invocación de @command{guix challenge}
+
address@hidden construcciones reproducibles
address@hidden construcciones verificables
address@hidden @command{guix challenge}
address@hidden reto (challenge)
+¿Los binarios que proporciona este servidor realmente corresponden al código
+fuente que dice construir? ¿Es determinista el proceso de construcción de un
+paquete? Estas son las preguntas que la orden @command{guix challenge}
+intenta responder.
+
+La primera es obviamente una cuestión importante: antes de usar un servidor
+de sustituciones (@pxref{Sustituciones}), es importante haber
address@hidden que proporciona los binarios correctos, y por tanto
address@hidden a address@hidden: challenge en inglés.}. La segunda es
+lo que permite la primera: si las construcciones de los paquetes son
+deterministas, construcciones independientes deberían emitir el mismo
+resultado, bit a bit; si el servidor proporciona un binario diferente al
+obtenido localmente, o bien está corrupto o bien tiene intenciones
+perniciosas.
+
+Sabemos que el hash que se muestra en los nombres de fichero en
address@hidden/gnu/store} es el hash de todas las entradas del proceso que
construyó
+el fichero o directorio---compiladores, bibliotecas, guiones de
+construcción, etc. (@pxref{Introducción}). Asumiendo procesos de
+construcción deterministas, un nombre de fichero del almacén debe
+corresponder exactamente a una salida de construcción. @command{guix
+challenge} comprueba si existe, realmente, una asociación unívoca comparando
+la salida de la construcción de varias construcciones independientes de
+cualquier elemento del almacén proporcionado.
+
+La salida de la orden muestra algo así:
+
address@hidden
+$ guix challenge --substitute-urls="https://@value{SUBSTITUTE-SERVER}
https://guix.example.org";
+updating list of substitutes from 'https://@value{SUBSTITUTE-SERVER}'... 100.0%
+updating list of substitutes from 'https://guix.example.org'... 100.0%
+/gnu/store/@dots{}-openssl-1.0.2d contents differ:
+ local hash: 0725l22r5jnzazaacncwsvp9kgf42266ayyp814v7djxs7nk963q
+ https://@value{SUBSTITUTE-SERVER}/nar/@dots{}-openssl-1.0.2d:
0725l22r5jnzazaacncwsvp9kgf42266ayyp814v7djxs7nk963q
+ https://guix.example.org/nar/@dots{}-openssl-1.0.2d:
1zy4fmaaqcnjrzzajkdn3f5gmjk754b43qkq47llbyak9z0qjyim
+/gnu/store/@dots{}-git-2.5.0 contents differ:
+ local hash: 00p3bmryhjxrhpn2gxs2fy0a15lnip05l97205pgbk5ra395hyha
+ https://@value{SUBSTITUTE-SERVER}/nar/@dots{}-git-2.5.0:
069nb85bv4d4a6slrwjdy8v1cn4cwspm3kdbmyb81d6zckj3nq9f
+ https://guix.example.org/nar/@dots{}-git-2.5.0:
0mdqa9w1p6cmli6976v4wi0sw9r4p5prkj7lzfd1877wk11c9c73
+/gnu/store/@dots{}-pius-2.1.1 contents differ:
+ local hash: 0k4v3m9z1zp8xzzizb7d8kjj72f9172xv078sq4wl73vnq9ig3ax
+ https://@value{SUBSTITUTE-SERVER}/nar/@dots{}-pius-2.1.1:
0k4v3m9z1zp8xzzizb7d8kjj72f9172xv078sq4wl73vnq9ig3ax
+ https://guix.example.org/nar/@dots{}-pius-2.1.1:
1cy25x1a4fzq5rk0pmvc8xhwyffnqz95h2bpvqsz2mpvlbccy0gs
+
address@hidden
+
+6,406 store items were analyzed:
+ - 4,749 (74.1%) were identical
+ - 525 (8.2%) differed
+ - 1,132 (17.7%) were inconclusive
address@hidden smallexample
+
address@hidden
+En este ejemplo, @command{guix challenge} primero recorre el almacén para
+determinar el conjunto de derivaciones construidas localmente---en oposición
+a elementos del almacén que fueron descargados de un servidor de
+sustituciones---y consulta a todos los servidores de sustituciones. Una vez
+hecho informa de los elementos del almacén para los cuales los servidores
+obtuvieron un resultado diferente de el obtenido en la construcción local.
+
address@hidden no-determinismo, en la construcción de paquetes
+Como un ejemplo, @code{guix.example.org} siempre obtiene una respuesta
+diferente. Por otro modo, @address@hidden coincide con las
+construcciones locales, excepto en el caso de Git. Esto puede indicar que el
+proceso de construcción de Git no es determinista, lo que significa que su
+salida varia en función de varias cosas que Guix no controla completamente,
+aunque la construcción de paquetes se realice en entornos aislados
+(@pxref{Características}). Las fuentes más comunes de indeterminismo incluyen
la
+adición de marcas de tiempo en los resultados de la construcción, la
+inclusión de números aleatorios y las enumeraciones de directorios ordenadas
+por número de nodos-i. Véase @uref{https://reproducible-builds.org/docs/}
+para más información.
+
+Para encontrar cuál es el problema con este binario Git, podemos hacer algo
+parecido a esto (@pxref{Invocación de guix archive}):
+
address@hidden
+$ wget -q -O - https://@value{SUBSTITUTE-SERVER}/nar/@dots{}-git-2.5.0 \
+ | guix archive -x /tmp/git
+$ diff -ur --no-dereference /gnu/store/@dots{}-git.2.5.0 /tmp/git
address@hidden example
+
+Esta orden muestra la diferencia entre los ficheros resultantes de la
+construcción local y los ficheros resultantes de la construcción en
address@hidden@value{SUBSTITUTE-SERVER}} (@pxref{Overview, Comparing and Merging
+Files,, diffutils, Comparing and Merging Files}). La orden @command{diff}
+funciona muy bien en ficheros de texto. Cuando ficheros binarios difieren,
+una opción mejor es @uref{https://diffoscope.org/,Diffoscope}, una
+herramienta que ayuda en la visualización de diferencias en todo tipo de
+ficheros.
+
+Una vez haya realizado este trabajo, puede determinar si las diferencias son
+debidas a un procedimiento de construcción no-determinista o a un servidor
+con intenciones ocultas. Intentamos duramente eliminar las fuentes de
+indeterminismo en los paquetes para facilitar la verificación de
+sustituciones, pero por supuesto es un proceso que implica no solo a Guix,
+sino a una gran parte de la comunidad del software libre. Entre tanto,
address@hidden challenge} es una herramienta para ayudar a afrontar el
+problema.
+
+Si esta escribiendo paquetes para Guix, le recomendamos que compruebe si
address@hidden@value{SUBSTITUTE-SERVER}} y otros servidores de sustituciones
+obtienen el mismo resultado de construcción que el obtenido por usted:
+
address@hidden
+$ guix challenge @var{paquete}
address@hidden example
+
address@hidden
+donde @var{paquete} es una especificación de paquete como @code{guile@@2.0}
+o @code{glibc:debug}.
+
+La sintaxis general es:
+
address@hidden
+guix challenge @var{opciones} address@hidden@dots{}]
address@hidden example
+
+Cuando se encuentra una diferencia entre el hash de un elemento construido
+localmente y el proporcionado por un servidor de sustituciones; o entre las
+sustituciones proporcionadas por distintos servidores, esto es mostrado como
+en el ejemplo previo y el valor de salida es 2 (otros valores no-cero de la
+salida denominan otros tipos de error).
+
+La única opción de importancia es:
+
address@hidden @code
+
address@hidden address@hidden
+Considera @var{urls} la lista separada por espacios de URL de fuentes de
+sustituciones con las que realizar la comparación.
+
address@hidden --verbose
address@hidden -v
+Muestra detalles sobre coincidencias (contenidos idénticos) además de
+información sobre las discrepancias.
+
address@hidden table
+
address@hidden Invocación de guix copy
address@hidden Invocación de @command{guix copy}
+
address@hidden copiar, elementos del almacén, por SSH
address@hidden SSH, copiar elementos del almacén
address@hidden compartir elementos del almacén entre máquinas
address@hidden transferir elementos del almacén entre máquinas
+La orden @command{guix copy} copia elementos del almacén de una máquina al
+de otra a través de una conexión de shell seguro (SSH)@footnote{Esta orden
+únicamente está disponible cuando ha encontrado
+Guile-SSH. @xref{Requisitos}, para detalles.}. Por ejemplo, la siguiente
+orden copia el paquete @code{coreutils}, el perfil de la usuaria y todas sus
+dependencias a @var{dirección}, ingresando en el sistema como @var{usuaria}:
+
address@hidden
+guix copy address@hidden@@@var{dirección} \
+ coreutils `readlink -f ~/.guix-profile`
address@hidden example
+
+Si alguno de los elementos del almacén a copiar ya están presentes en
address@hidden, no se envían realmente.
+
+La siguiente orden obtiene @code{libreoffice} y @code{gimp} de
address@hidden, asumiendo que estén disponibles allí:
+
address@hidden
+guix copy address@hidden libreoffice gimp
address@hidden example
+
+La conexión SSH se establece usando el cliente Guile-SSH, que es compatible
+con OpenSSH: tiene en cuenta @file{~/.ssh/known_hosts} y
address@hidden/.ssh/config}, y usa el agente SSH para la identificación.
+
+La clave usada para firmar los elementos enviados debe estar aceptada por la
+máquina remota. Del mismo modo, la clave usada por la máquina remota para
+firmar los elementos recibidos debe estar en @file{/etc/guix/acl} de modo
+que sea aceptada por su propio daemon. @xref{Invocación de guix archive}, para
+más información sobre la verificación de elementos del almacén.
+
+La sintaxis general es:
+
address@hidden
+guix copy address@hidden|address@hidden @address@hidden
address@hidden example
+
+Siempre debe especificar una de las siguientes opciones:
+
address@hidden @code
address@hidden address@hidden
address@hidden address@hidden
+Especifica la máquina a la que mandar o desde la que recibir. @var{spec}
+debe ser una especificación SSH como @code{example.org},
address@hidden@@example.org}, or @code{carlos@@example.org:2222}.
address@hidden table
+
+Los @var{elementos} pueden ser tanto nombres de paquetes, como @code{gimp},
+como elementos del almacén, como @file{/gnu/store/@dots{}-idutils-4.6}.
+
+Cuando se especifica el nombre del paquete a enviar, primero se construye si
+es necesario, a menos que se use @option{--dry-run}. Se aceptan las opciones
+comunes de construcción (@pxref{Opciones comunes de construcción}).
+
+
address@hidden Invocación de guix container
address@hidden Invocación de @command{guix container}
address@hidden container
address@hidden @command{guix container}
address@hidden Nota
+En la versión @value{VERSION}, esta herramienta es experimental. La interfaz
+está sujeta a cambios radicales en el futuro.
address@hidden quotation
+
+El propósito de @command{guix container} es la manipulación de procesos en
+ejecución dentro de entornos aislados, normalmente conocido como un
+``contenedor'', típicamente creado por las órdenes @command{guix
+environment} (@pxref{Invocación de guix environment}) y @command{guix system
+container} (@pxref{Invocación de guix system}).
+
+La sintaxis general es:
+
address@hidden
+guix container @var{acción} @address@hidden
address@hidden example
+
address@hidden especifica la operación a realizar con el contenedor, y
address@hidden especifica los parámetros específicos del contexto para la
+acción.
+
+Las siguientes acciones están disponibles:
+
address@hidden @code
address@hidden exec
+Ejecute una orden en el contexto de un contenedor en ejecución.
+
+La sintaxis es:
+
address@hidden
+guix container exec @var{pid} @var{programa} @address@hidden
address@hidden example
+
address@hidden especifica el ID del proceso del contenedor en
+ejecución. @var{programa} especifica el nombre del fichero ejecutable dentro
+del sistema de ficheros raíz del contenedor. @var{parámetros} son opciones
+adicionales que se pasarán a @var{programa}.
+
+La siguiente orden lanza un shell interactivo de ingreso al sistema dentro
+de un contenedor del sistema, iniciado por @command{guix system container},
+y cuyo ID de proceso es 9001:
+
address@hidden
+guix container exec 9001 /run/current-system/profile/bin/bash --login
address@hidden example
+
+Fíjese que el @var{pid} no puede ser el proceso creador del contenedor. Debe
+ser el PID 1 del contenedor o uno de sus procesos hijos.
+
address@hidden table
+
address@hidden Invocación de guix weather
address@hidden Invocación de @command{guix weather}
+
+De manera ocasional tendrá un mal día al no estar las sustituciones
+disponibles y le toque construir los paquetes a usted misma
+(@pxref{Sustituciones}). La orden @command{guix weather} informa de la
+disponibilidad de sustituciones en los servidores especificados de modo que
+pueda tener una idea sobre cómo será su día hoy. A veces puede ser una
+información útil como usuaria, pero es principalmente útil para quienes
+ejecuten @command{guix publish} (@pxref{Invocación de guix publish}).
+
address@hidden estadísticas, para sustituciones
address@hidden disponibilidad de sustituciones
address@hidden disponibilidad de sustituciones
address@hidden weather, disponibilidad de sustituciones
+Esta es una ejecución de ejemplo:
+
address@hidden
+$ guix weather --substitute-urls=https://guix.example.org
+computing 5,872 package derivations for x86_64-linux...
+looking for 6,128 store items on https://guix.example.org..
+updating list of substitutes from 'https://guix.example.org'... 100.0%
+https://guix.example.org
+ 43.4% substitutes available (2,658 out of 6,128)
+ 7,032.5 MiB of nars (compressed)
+ 19,824.2 MiB on disk (uncompressed)
+ 0.030 seconds per request (182.9 seconds in total)
+ 33.5 requests per second
+
+ 9.8% (342 out of 3,470) of the missing items are queued
+ 867 queued builds
+ x86_64-linux: 518 (59.7%)
+ i686-linux: 221 (25.5%)
+ aarch64-linux: 128 (14.8%)
+ build rate: 23.41 builds per hour
+ x86_64-linux: 11.16 builds per hour
+ i686-linux: 6.03 builds per hour
+ aarch64-linux: 6.41 builds per hour
address@hidden example
+
address@hidden integración continua, estadísticas
+As you can see, it reports the fraction of all the packages for which
+substitutes are available on the server---regardless of whether substitutes
+are enabled, and regardless of whether this server's signing key is
+authorized. It also reports the size of the compressed archives (``nars'')
+provided by the server, the size the corresponding store items occupy in the
+store (assuming deduplication is turned off), and the server's throughput.
+The second part gives continuous integration (CI) statistics, if the server
+supports it. In addition, using the @option{--coverage} option,
address@hidden weather} can list ``important'' package substitutes missing on
+the server (see below).
+
+Para conseguirlo, @command{guix weather} consulta los metadatos HTTP(S)
+(@dfn{narinfo}s) de todos los elementos relevantes del almacén. Como
address@hidden challenge}, ignora las firmas en esas sustituciones, lo cual
+es inocuo puesto que la orden únicamente obtiene estadísticas y no puede
+instalar esas sustituciones.
+
+Entre otras cosas, es posible consultar tipos específicos de sistema y
+conjuntos específicos de paquetes. Las opciones disponibles se enumeran a
+continuación.
+
address@hidden @code
address@hidden address@hidden
address@hidden es la lista separada por espacios de URL de servidores de
+sustituciones a consultar. Cuando se omite esta opción, el conjunto
+predeterminado de servidores de sustituciones es el consultado.
+
address@hidden address@hidden
address@hidden -s @var{sistema}
+Consulta sustituciones para @var{sistema}---por ejemplo,
address@hidden Esta opción se puede repetir, en cuyo caso
address@hidden weather} consultará las sustituciones para varios tipos de
+sistema.
+
address@hidden address@hidden
+En vez de consultar las sustituciones de todos los paquetes, consulta
+únicamente los especificados en @var{fichero}. @var{fichero} debe contener
+un @dfn{manifiesto}, como el usado en la opción @code{-m} de @command{guix
+package} (@pxref{Invocación de guix package}).
+
address@hidden address@hidden
address@hidden -c address@hidden
+Report on substitute coverage for packages: list packages with at least
address@hidden dependents (zero by default) for which substitutes are
+unavailable. Dependent packages themselves are not listed: if @var{b}
+depends on @var{a} and @var{a} has no substitutes, only @var{a} is listed,
+even though @var{b} usually lacks substitutes as well. The result looks
+like this:
+
address@hidden
+$ guix weather --substitute-urls=https://ci.guix.es.info -c 10
+computing 8,983 package derivations for x86_64-linux...
+looking for 9,343 store items on https://ci.guix.es.info...
+updating substitutes from 'https://ci.guix.es.info'... 100.0%
+https://ci.guix.es.info
+ 64.7% substitutes available (6,047 out of 9,343)
address@hidden
+2502 packages are missing from 'https://ci.guix.es.info' for 'x86_64-linux',
among which:
+ 58 kcoreaddons@@5.49.0 /gnu/store/@dots{}-kcoreaddons-5.49.0
+ 46 qgpgme@@1.11.1 /gnu/store/@dots{}-qgpgme-1.11.1
+ 37 perl-http-cookiejar@@0.008
/gnu/store/@dots{}-perl-http-cookiejar-0.008
+ @dots{}
address@hidden example
+
+What this example shows is that @code{kcoreaddons} and presumably the 58
+packages that depend on it have no substitutes at @code{ci.guix.es.info};
+likewise for @code{qgpgme} and the 46 packages that depend on it.
+
+If you are a Guix developer, or if you are taking care of this build farm,
+you'll probably want to have a closer look at these packages: they may
+simply fail to build.
address@hidden table
+
address@hidden Invocación de guix processes
address@hidden Invocación de @command{guix processes}
+
+La orden @command{guix processes} puede ser útil a desarrolladoras y
+administradoras de sistemas, especialmente en máquinas multiusuaria y en
+granjas de construcción: enumera las sesiones actuales (conexiones al
+daemon), así como información sobre los procesos address@hidden
+sesiones remotas, cuando @command{guix-daemon} se ha iniciado con
address@hidden especificando un punto de conexión TCP, @emph{no} son
+enumeradas.}. A continuación puede verse un ejemplo de la información que
+devuelve:
+
address@hidden
+$ sudo guix processes
+SessionPID: 19002
+ClientPID: 19090
+ClientCommand: guix environment --ad-hoc python
+
+SessionPID: 19402
+ClientPID: 19367
+ClientCommand: guix publish -u guix-publish -p 3000 -C 9 @dots{}
+
+SessionPID: 19444
+ClientPID: 19419
+ClientCommand: cuirass --cache-directory /var/cache/cuirass @dots{}
+LockHeld: /gnu/store/@dots{}-perl-ipc-cmd-0.96.lock
+LockHeld: /gnu/store/@dots{}-python-six-bootstrap-1.11.0.lock
+LockHeld: /gnu/store/@dots{}-libjpeg-turbo-2.0.0.lock
+ChildProcess: 20495: guix offload x86_64-linux 7200 1 28800
+ChildProcess: 27733: guix offload x86_64-linux 7200 1 28800
+ChildProcess: 27793: guix offload x86_64-linux 7200 1 28800
address@hidden example
+
+En este ejemplo vemos que @command{guix-daemon} tiene tres clientes:
address@hidden environment}, @command{guix publish} y la herramienta de
+integración continua Cuirass; sus identificadores de proceso (PID) se
+muestran en el campo @code{ClientPID}. El campo @code{SessionPID}
+proporciona el PID del subproceso de @command{guix-daemon} de cada sesión en
+particular.
+
+El campo @code{LockHeld} muestra qué elementos del almacén están bloqueados
+actualmente por cada sesión, lo que corresponde a elementos del almacén en
+construcción o sustitución (el campo @code{LockHeld} no se muestra cuando
address@hidden processes} no se ejecutó como root). Por último, mediante el
+campo @code{ChildProcess} entendemos que esas tres construcciones están
+siendo delegadas (@pxref{Configuración de delegación del daemon}).
+
+La salida está en formato Recutils por lo que podemos usar la útil orden
address@hidden para seleccionar sesiones de interés (@pxref{Selection
+Expressions,,, recutils, GNU recutils manual}). Como un ejemplo, la
+siguiente orden muestra la línea de órdenes y el PID del cliente que inició
+la construcción de un paquete Perl:
+
address@hidden
+$ sudo guix processes | \
+ recsel -p ClientPID,ClientCommand -e 'LockHeld ~ "perl"'
+ClientPID: 19419
+ClientCommand: cuirass --cache-directory /var/cache/cuirass @dots{}
address@hidden example
+
+
address@hidden Configuración del sistema
address@hidden Configuración del sistema
+
address@hidden configuración del sistema
+La Distribución de Sistema Guix permite un mecanismo de configuración del
+sistema completo consistente. Con esto queremos decir que todos los aspectos
+de la configuración global del sistema---como los servicios disponibles, la
+zona horaria y la configuración de localización, las cuentas de
+usuarias---se declaran en un lugar único. Dicha @dfn{configuración del
+sistema} puede ser @dfn{instanciada}---es decir, hecha efectiva.
+
address@hidden Yes, we're talking of Puppet, Chef, & co. here. ↑
+Una de las ventajas de poner toda la configuración del sistema bajo el
+control de Guix es que permite actualizaciones transaccionales del sistema,
+y hace posible volver a una instanciación previa del sistema, en caso de que
+haya algún problema con la nueva (@pxref{Características}). Otra ventaja es que
+hace fácil replicar exactamente la misma configuración entre máquinas
+diferentes, o en diferentes momentos, sin tener que utilizar herramientas de
+administración adicionales sobre las propias herramientas del sistema.
+
+Esta sección describe este mecanismo. Primero nos enfocaremos en el punto de
+vista de la administradora del sistema---explicando cómo se configura e
+instancia el sistema. Después mostraremos cómo puede extenderse este
+mecanismo, por ejemplo para añadir nuevos servicios del sistema.
+
address@hidden
+* Uso de la configuración del sistema:: Personalizar su sistema GNU.
+* Referencia de ``operating-system'':: Detalle de las declaraciones de
+ sistema operativo.
+* Sistemas de ficheros:: Configurar el montaje de sistemas de ficheros.
+* Dispositivos traducidos:: Procesamiento extra de dispositivos de bloques.
+* Cuentas de usuaria:: Especificar las cuentas de usuaria.
+* Distribución de teclado:: Cómo interpreta el sistema las pulsaciones
+ del teclado.
+* Localizaciones:: Configuración de idioma y convenciones
+ culturales.
+* Servicios:: Especificar los servicios del sistema.
+* Programas con setuid:: Programas que se ejecutan con privilegios de
+ root.
+* Certificados X.509:: Verificar servidores HTTPS.
+* Selector de servicios de nombres:: Configurar el selector de servicios de
+ nombres de libc.
+* Disco en RAM inicial:: Arranque de Linux-Libre.
+* Configuración del gestor de arranque:: Configurar el gestor de arranque.
+* Invocación de guix system:: Instanciar una configuración del sistema.
+* Ejecutar Guix en una máquina virtual:: Cómo ejecutar el sistema Guix en
+ una máquina virtual.
+* Definición de servicios:: Añadir nuevas definiciones de servicios.
address@hidden menu
+
address@hidden Uso de la configuración del sistema
address@hidden Uso de la configuración del sistema
+
+El sistema operativo se configura proporcionando una declaración
address@hidden en un fichero que pueda ser proporcionado a la orden
address@hidden system} (@pxref{Invocación de guix system}). Una configuración
+simple, con los servicios predeterminados del sistema, el núcleo Linux-Libre
+predeterminado, un disco de RAM inicial y un cargador de arranque puede ser
+como sigue:
+
address@hidden operating-system
address@hidden
address@hidden os-config-bare-bones.texi
address@hidden lisp
+
+Este ejemplo debería ser auto-descriptivo. Algunos de los campos definidos
+anteriormente, como @code{host-name} y @code{bootloader}, son
+necesarios. Otros como @code{packages} y @code{services}, pueden omitirse,
+en cuyo caso obtienen un valor por defecto.
+
+Más adelante se muestran los efectos de algunos de los campos más
+importantes (@pxref{Referencia de ``operating-system''}, para detalles acerca
de
+todos los campos disponibles), y cómo @dfn{instanciar} el sistema operativo
+usando @command{guix system}.
+
address@hidden Cargador de arranque
+
address@hidden arranque obsoleto, en máquinas Intel
address@hidden arranque por BIOS, en máquinas Intel
address@hidden arranque UEFI
address@hidden arranque EFI
+El campo @code{bootloader} describe el método que será usado para arrancar
+su sistema. Las máquinas basadas en procesadores Intel pueden arrancar en el
+``obsoleto'' modo BIOS, como en el ejemplo previo. No obstante, máquinas más
+recientes usan la @dfn{Interfaz Unificada Extensible de Firmware} (UEFI)
+para arrancar. En ese caso, el capo @code{bootloader} debe contener algo
+parecido a esto:
+
address@hidden
+(bootloader-configuration
+ (bootloader grub-efi-bootloader)
+ (target "/boot/efi"))
address@hidden example
+
address@hidden del gestor de arranque}, para más información sobre las opciones
de
+configuración disponibles.
+
address@hidden Paquetes visibles globalmente
+
address@hidden %base-packages
+El campo @code{packages} enumera los paquetes que serán visibles globalmente
+en el sistema, para todas las cuentas de usuaria---es decir, en la variable
+de entorno @code{PATH} de cada usuaria---además de los perfiles por usuaria
+(@pxref{Invocación de guix package}). La variable @var{%base-packages}
+proporciona todas las herramientas esperadas para tareas básicas y de
+administración---incluyendo las utilidades básicas GNU, las herramientas de
+red GNU, el editor de texto ligero GNU Zile, @command{find}, @command{grep},
+etc. El ejemplo previo se añade address@hidden a estos, tomado del módulo
address@hidden(gnu packages screen)} (@pxref{Módulos de paquetes}). La sintaxis
address@hidden(list package output)} puede usarse para añadir una salida
específica
+de un paquete:
+
address@hidden
+(use-modules (gnu packages))
+(use-modules (gnu packages dns))
+
+(operating-system
+ ;; ...
+ (packages (cons (list bind "utils")
+ %base-packages)))
address@hidden lisp
+
address@hidden specification->package
+Referirse a los paquetes por nombre de variable, como antes a @code{bind},
+tiene la ventaja de evitar ambigüedades; también permite que errores
+tipográficos y demás obtengan un diagnóstico directo como ``variables sin
+definir''. La parte problemática es que se necesita conocer qué módulo
+define qué paquete, y aumentar adecuadamente la línea de
address@hidden Para evitar esto, se puede usar el procedimiento
address@hidden>package} del módulo @code{(gnu packages)}, que devuelve
+el mejor paquete para un nombre dado, o nombre y versión:
+
address@hidden
+(use-modules (gnu packages))
+
+(operating-system
+ ;; ...
+ (packages (append (map specification->package
+ '("tcpdump" "htop" "gnupg@@2.0"))
+ %base-packages)))
address@hidden lisp
+
address@hidden Servicios del sistema
+
address@hidden services
address@hidden %base-services
+The @code{services} field lists @dfn{system services} to be made available
+when the system starts (@pxref{Servicios}). The @code{operating-system}
+declaration above specifies that, in addition to the basic services, we want
+the OpenSSH secure shell daemon listening on port 2222 (@pxref{Servicios de
red, @code{openssh-service-type}}). Under the hood,
address@hidden arranges so that @command{sshd} is started with
+the right command-line options, possibly with supporting configuration files
+generated as needed (@pxref{Definición de servicios}).
+
address@hidden personalización, de servicios
address@hidden modify-services
+De manera ocasional, en vez de usar los servicios básicos tal y como vienen,
+puede querer personalizarlos. Para hacerlo, use @code{modify-services}
+(@pxref{Referencia de servicios, @code{modify-services}}) para modificar la
lista.
+
+Por ejemplo, supongamos que quiere modificar @code{guix-daemon} y Mingetty
+(el punto de acceso al sistema por consola) en la lista @var{%base-services}
+(@pxref{Servicios base, @code{%base-services}}). Para hacerlo, puede escribir
+lo siguiente en su declaración de sistema operativo:
+
address@hidden
+(define %mis-servicios
+ ;; Mi propia lista de servicios
+ (modify-services %base-services
+ (guix-service-type config =>
+ (guix-configuration
+ (inherit config)
+ (use-substitutes? #f)
+ (extra-options '("--gc-keep-derivations"))))
+ (mingetty-service-type config =>
+ (mingetty-configuration
+ (inherit config)))))
+
+(operating-system
+ ;; @dots{}
+ (services %mis-servicios))
address@hidden lisp
+
+Esto modifica la configuración---es decir, los parámetros de los
+servicios---de la instancia @code{guix-service-type}, y de todas las
+instancias de @code{mingetty-service-type} en la lista
address@hidden Observe cómo se consigue: primero, enlazamos la
+configuración actual al identificador @code{config} en el @var{cuerpo}, y
+entonces escribimos el @var{cuerpo} de manera que evalue a la configuración
+deseada. En particular, fíjese como se usa @code{inherit} para crear una
+nueva configuración que tiene los mismos valores que la configuración
+antigua, pero con unas pocas modificaciones.
+
address@hidden disco cifrado
+La configuración para un uso típico de ``escritorio'', con una partición de
+raíz cifrada, el servidor gráfico X11, GNOME y Xfce (las usuarias pueden
+escoger cual de estos entornos de escritorio usarán en la pantalla de inicio
+de sesión pulsando @kbd{F1}), gestión de red, gestión de energía y más,
+podría ser así:
+
address@hidden
address@hidden os-config-desktop.texi
address@hidden lisp
+
+Un sistema gráfico con una selección de gestores de ventanas ligeros en vez
+de entornos de escritorio completos podría ser así:
+
address@hidden
address@hidden os-config-lightweight-desktop.texi
address@hidden lisp
+
+Este ejemplo se refiere al sistema de ficheros @file{/boot/efi} por su UUID
address@hidden Substituya este UUID con el UUID correcto en su sistema,
+como el devuelto por la orden @command{blkid}.
+
address@hidden de escritorio}, para la lista exacta de servicios proporcionados
+por @var{%desktop-services}. @xref{Certificados X.509}, para información
+sobre el paquete @code{nss-certs} usado aquí.
+
+De nuevo, @var{%desktop-services} es simplemente una lista de objetos de
+servicios. Si desea borrar servicios de aquí, puede hacerlo usando
+procedimientos de filtrado de listas (@pxref{SRFI-1 Filtering and
+Partitioning,,, guile, GNU Guile Reference Manual}). Por ejemplo, la
+siguiente expresión devuelve una lista que contiene todos los servicios en
address@hidden excepto el servicio Avahi:
+
address@hidden
+(remove (lambda (service)
+ (eq? (service-kind service) avahi-service-type))
+ %desktop-services)
address@hidden example
+
address@hidden Instanciación del sistema
+
+Asumiendo que la declaración de @code{operating-system} se encuentra en el
+fichero @file{my-conf-del-sistema.scm}, la orden @command{guix system
+mi-conf-del-sistema.scm} instancia esa configuración, y la convierte en la
+entrada predeterminada de GRUB en el arranque (@pxref{Invocación de guix
system}).
+
+La manera habitual de cambiar la configuración del sistema es actualizar
+este fichero y volver a ejecutar @command{guix system reconfigure}. Nunca se
+deberían tocar los ficheros en @file{/etc} o ejecutar órdenes que modifiquen
+el estado del sistema como @command{useradd} o @command{grub-install}. De
+hecho, debe evitarlo ya que no únicamente anularía su garantía sino que
+también le impediría volver a una versión previa de su sistema, en caso de
+necesitarlo.
+
address@hidden vuelta-atrás, del sistema operativo
+Hablando de vuelta atrás, cada vez que ejecuta @command{guix system
+reconfigure} se crea una nueva @dfn{generación} del sistema---sin modificar
+o borrar generaciones previas. Las generaciones previas tienen una entrada
+en el menú del cargador de arranque, permitiendole arrancarlas en caso de
+que algo funcionase mal en las últimas generaciones. Tranquilizador, ¿no? La
+orden @command{guix system list-generations} enumera las generaciones del
+sistema disponibles en el disco. Es también posible volver a una versión
+previa con las órdenes @command{guix system roll-back} y @command{guix
+system switch-generation}.
+
+Aunque la orden @command{guix system reconfigure} no modificará las
+generaciones previas, debe tener cuidado cuando la generación actual no es
+la última (por ejemplo, después de invocar @command{guix system roll-back}),
+ya que la operación puede sobreescribir una generación posterior
+(@pxref{Invocación de guix system}).
+
address@hidden La interfaz programática
+
+A nivel Scheme, el grueso de una declaración @code{operating-system} se
+instancia con el siguiente procedimiento monádico (@pxref{La mónada del
almacén}):
+
address@hidden {Procedimiento monádico} operating-system-derivation so
+Devuelve una derivación que construye @var{so}, un objeto
address@hidden (@pxref{Derivaciones}).
+
+La salida de la derivación es un único directorio que hace referencia a
+todos los paquetes, ficheros de configuración y otros ficheros auxiliares
+necesarios para instanciar @var{so}.
address@hidden deffn
+
+This procedure is provided by the @code{(gnu system)} module. Along with
address@hidden(gnu services)} (@pxref{Servicios}), this module contains the
guts of
+Guix System. Make sure to visit it!
+
+
address@hidden Referencia de ``operating-system''
address@hidden Referencia de @code{operating-system}
+
+Esta sección resume todas las opciones disponibles en las declaraciones de
address@hidden (@pxref{Uso de la configuración del sistema}).
+
address@hidden {Tipo de datos} operating-system
+Este es el tipo de datos que representa la configuración del sistema
+operativo. Con ello queremos decir toda la configuración global del sistema,
+no la configuración específica de las usuarias (@pxref{Uso de la configuración
del sistema}).
+
address@hidden @asis
address@hidden @code{kernel} (predeterminado: @code{linux-libre})
+El objeto del paquete del núcleo del sistema operativo
address@hidden únicamente está disponible el núcleo
+Linux-libre. En el futuro será posible usar address@hidden
+
address@hidden @code{kernel-arguments} (default: @code{'("quiet")})
+Lista de cadenas o expresiones-G que representan parámetros adicionales a
+pasar en la línea de órdenes del núcleo---por ejemplo,
address@hidden("console=ttyS0")}.
+
address@hidden @code{bootloader}
+El objeto de configuración del cargador de arranque del
+sistema. @xref{Configuración del gestor de arranque}.
+
address@hidden @code{label}
+This is the label (a string) as it appears in the bootloader's menu entry.
+The default label includes the kernel name and version.
+
address@hidden @code{keyboard-layout} (predeterminada: @code{#f})
+This field specifies the keyboard layout to use in the console. It can be
+either @code{#f}, in which case the default keyboard layout is used (usually
+US English), or a @code{<keyboard-layout>} record.
+
+This keyboard layout is in effect as soon as the kernel has booted. For
+instance, it is the keyboard layout in effect when you type a passphrase if
+your root file system is on a @code{luks-device-mapping} mapped device
+(@pxref{Dispositivos traducidos}).
+
address@hidden Nota
+This does @emph{not} specify the keyboard layout used by the bootloader, nor
+that used by the graphical display server. @xref{Configuración del gestor de
arranque},
+for information on how to specify the bootloader's keyboard layout.
@xref{Sistema X Window}, for information on how to specify the keyboard layout
used by the X
+Window System.
address@hidden quotation
+
address@hidden @code{initrd-modules} (predeterminados:
@code{%base-initrd-modules})
address@hidden initrd
address@hidden disco inicial de RAM
+La lista de módulos del núcleo Linux que deben estar disponibles en el disco
+inicial de RAM. @xref{Disco en RAM inicial}.
+
address@hidden @code{initrd} (predeterminado: @code{base-initrd})
+Un procedimiento que devuelve un disco inicial de RAM para el núcleo
+Linux. Este campo se proporciona para permitir personalizaciones de bajo
+nivel y no debería ser necesario para un uso habitual. @xref{Disco en RAM
inicial}.
+
address@hidden @code{firmware} (predeterminado: @code{%base-firmware})
address@hidden firmware
+Lista de paquetes de firmware que pueden ser cargados por el núcleo del
+sistema operativo.
+
+El valor predeterminado incluye el firmware necesario para dispositivos WiFi
+basados en Atheros y Broadcom (módulos Linux-libre @code{ath9k} y
address@hidden, respectivamente). @xref{Consideraciones sobre el hardware},
para más
+información sobre hardware soportado.
+
address@hidden @code{host-name}
+El nombre de la máquina.
+
address@hidden @code{hosts-file}
address@hidden el fichero hosts
+Un objeto tipo-fichero (@pxref{Expresiones-G, objetos tipo-fichero}) para
+ser usado como @file{/etc/hosts} (@pxref{Host Names,,, libc, The GNU C
+Library Reference Manual}). El predeterminado es un fichero con entradas
+para @code{localhost} y @var{host-name}.
+
address@hidden @code{mapped-devices} (predeterminados: @code{'()})
+Una lista de dispositivos traducidos. @xref{Dispositivos traducidos}.
+
address@hidden @code{file-systems}
+Una lista de sistemas de ficheros. @xref{Sistemas de ficheros}.
+
address@hidden @code{swap-devices} (predeterminados: @code{'()})
address@hidden dispositivos de intercambio
+Una lista de cadenas que identifiquen dispositivos o ficheros a usar como
+``espacio de intercambio'' (@pxref{Memory Concepts,,, libc, The GNU C
+Library Reference Manual}). Por ejemplo @code{'("/dev/sda3")} o
address@hidden'("/fichero-intercambio")}. Es posible especificar un fichero de
+intercambio en un sistema de ficheros en un dispositivo traducido, siempre
+que la traducción y el sistema de ficheros se especifiquen
+también. @xref{Dispositivos traducidos} y @ref{Sistemas de ficheros}.
+
address@hidden @code{users} (predeterminadas: @code{%base-user-accounts})
address@hidden @code{groups} (predeterminados: @var{%base-groups})
+Lista de cuentas de usuaria y grupos. @xref{Cuentas de usuaria}.
+
+Si la lista de @code{usuarias} carece de una cuenta de usuaria con
address@hidden, una cuenta ``root'' con address@hidden se añade automáticamente.
+
address@hidden @code{skeletons} (predeterminados: @code{(default-skeletons)})
+Una lista de tuplas de nombre de fichero de destino/objeto tipo-fichero
+(@pxref{Expresiones-G, objetos tipo-fichero}). Estos son los ficheros de
+esqueleto que se añadirán al directorio de las cuentas de usuaria que se
+creen.
+
+Por ejemplo, un valor válido puede parecer algo así:
+
address@hidden
+`((".bashrc" ,(plain-file "bashrc" "echo Hola\n"))
+ (".guile" ,(plain-file "guile"
+ "(use-modules (ice-9 readline))
+ (activate-readline)")))
address@hidden example
+
address@hidden @code{issue} (predeterminado: @var{%default-issue})
+Una cadena que denota el contenido del fichero @file{/etc/issue}, que se
+muestra cuando las usuarias ingresan al sistema en una consola de texto.
+
address@hidden @code{packages} (predeterminados: @var{%base-packages})
+El conjunto de paquetes instalados en el perfil global, que es accesible en
address@hidden/run/current-system/profile}.
+
+El conjunto predeterminado incluye utilidades básicas y es una buena
+práctica instalar utilidades no-básicas en los perfiles de las usuarias
+(@pxref{Invocación de guix package}).
+
address@hidden @code{timezone}
+Una cadena que identifica la zona horaria---por ejemplo,
address@hidden"Europe/Paris"}.
+
+Puede ejecutar la orden @command{tzselect} para encontrar qué cadena de zona
+horaria corresponde con su región. Elegir una zona horaria no válida provoca
+un fallo en @command{guix system}.
+
address@hidden @code{locale} (predeterminado: @code{"en_US.utf8"})
+El nombre de la localización predeterminada (@pxref{Locale Names,,, libc,
+The GNU C Library Reference Manual}). @xref{Localizaciones}, para más
información.
+
address@hidden @code{locale-definitions} (predeterminadas:
@var{%default-locale-definitions})
+La lista de definiciones de localizaciones a compilar y que puede ser usada
+en tiempo de ejecución. @xref{Localizaciones}.
+
address@hidden @code{locale-libcs} (predeterminadas: @code{(list @var{glibc})})
+La lista de paquetes address@hidden cuyos datos de localización y
+herramientas son usadas para las definiciones de
+localizaciones. @xref{Localizaciones}, para consideraciones de compatibilidad
que
+justifican esta opción.
+
address@hidden @code{name-service-switch} (predeterminado: @var{%default-nss})
+Configuración del selector de servicios de nombres de libc (NSS)---un objeto
address@hidden<name-service-switch>}. @xref{Selector de servicios de nombres},
para detalles.
+
address@hidden considera
+Una lista de objetos service denotando los servicios del
+sistema. @xref{Servicios}.
+
address@hidden servicios esenciales
address@hidden @code{essential-services} (predeterminados: ...)
+The list of ``essential services''---i.e., things like instances of
address@hidden and @code{host-name-service-type} (@pxref{Referencia de
servicios}), which are derived from the operating system definition itself.
+As a user you should @emph{never} need to touch this field.
+
address@hidden @code{pam-services} (predeterminados: @code{(base-pam-services)})
address@hidden PAM
address@hidden módulos de verificación conectables
address@hidden FIXME: Add xref to PAM services section.
+Servicios de los @dfn{módulos de verificación conectables} (PAM) de Linux.
+
address@hidden @code{setuid-programs} (predeterminados: @var{%setuid-programs})
+Lista de expresiones-G con valores de cadena que denotan los programas
+setuid. @xref{Programas con setuid}.
+
address@hidden @code{sudoers-file} (predeterminado:
@var{%sudoers-specification})
address@hidden fichero sudoers
+El contenido de @file{/etc/sudoers} como un objeto tipo-fichero
+(@pxref{Expresiones-G, @code{local-file} y @code{plain-file}}).
+
+Este fichero especifica qué usuarias pueden usar la orden @command{sudo}, lo
+que se les permite hacer y qué privilegios pueden obtener. El comportamiento
+predefinido es que únicamente @code{root} y los miembros del grupo
address@hidden pueden usar @code{sudo}.
+
address@hidden table
+
address@hidden {Scheme Syntax} this-operating-system
+When used in the @emph{lexical scope} of an operating system field
+definition, this identifier resolves to the operating system being defined.
+
+The example below shows how to refer to the operating system being defined
+in the definition of the @code{label} field:
+
address@hidden
+(use-modules (gnu) (guix))
+
+(operating-system
+ ;; ...
+ (label (package-full-name
+ (operating-system-kernel this-operating-system))))
address@hidden example
+
+It is an error to refer to @code{this-operating-system} outside an operating
+system definition.
address@hidden deffn
+
address@hidden deftp
+
address@hidden Sistemas de ficheros
address@hidden Sistemas de ficheros
+
+La lista de sistemas de ficheros que deben montarse se especifica en el
+campo @code{file-systems} de la declaración del sistema operativo
+(@pxref{Uso de la configuración del sistema}). Cada sistema de ficheros se
+declara usando la forma @code{file-system}, como en el siguiente ejemplo:
+
address@hidden
+(file-system
+ (mount-point "/home")
+ (device "/dev/sda3")
+ (type "ext4"))
address@hidden example
+
+Como es habitual, algunos de los campos son obligatorios---aquellos
+mostrados en el ejemplo previo---mientras que otros pueden omitirse. Se
+describen a continuación.
+
address@hidden {Tipo de datos} file-system
+Objetos de este tipo representan los sistemas de ficheros a
+montar. Contienen los siguientes campos:
+
address@hidden @asis
address@hidden @code{type}
+Este campo es una cadena que especifica el tipo de sistema de ficheros---por
+ejemplo, @code{"ext4"}.
+
address@hidden @code{mount-point}
+Designa la ruta donde el sistema de ficheros debe montarse.
+
address@hidden @code{device}
+Nombra la ``fuente'' del sistema de ficheros. Puede ser una de estas tres
+opciones: una etiqueta de sistema de ficheros, un UUID de sistema de
+ficheros o el nombre de un nodo @file{/dev}. Las etiquetas y UUID ofrecen
+una forma de hacer referencia a sistemas de ficheros sin codificar su nombre
+de dispositivo address@hidden que, aunque es tentador usa
address@hidden/dev/disk/by-uuid} y nombres de dispositivo similares para
obtener el
+mismo resultado, no es lo recomendado: estos nodo especiales de dispositivos
+se crean por el daemon udev y puede no estar disponible cuando el
+dispositivo sea montado.}.
+
address@hidden file-system-label
+Las etiquetas del sistema de ficheros se crean mediante el uso del
+procedimiento @code{file-system-label}, los UUID se crean mediante el uso de
address@hidden y los nodos @file{/dev} son simples cadenas. A continuación se
+proporciona un ejemplo de un sistema de ficheros al que se hace referencia
+mediante su etiqueta, como es mostrada por la orden @command{e2label}:
+
address@hidden
+(file-system
+ (mount-point "/home")
+ (type "ext4")
+ (device (file-system-label "mi-home")))
address@hidden example
+
address@hidden uuid
+Los UUID se convierten dede su representación en forma de cadena (como se
+muestra con la orden @command{tune2fs -l}) mediante el uso de la forma
address@hidden@footnote{La forma @code{uuid} espera un UUID de 16 bytes como se
+define en la @uref{https://tools.ietf.org/html/rfc4122, address@hidden Este
+es el formato de UUID que usan la familia de sistemas de ficheros ext2 y
+otros, pero es diferente de los ``UUID'' de los sistemas de ficheros FAT,
+por ejemplo.}, como sigue:
+
address@hidden
+(file-system
+ (mount-point "/home")
+ (type "ext4")
+ (device (uuid "4dab5feb-d176-45de-b287-9b0a6e4c01cb")))
address@hidden example
+
+Cuando la fuente de un sistema de ficheros es un dispositivo traducido
+(@pxref{Dispositivos traducidos}), su campo @code{device} @emph{debe} hacer
+referencia al nombre del dispositivo traducido---por ejemplo,
address@hidden"/dev/mapper/particion-raiz"}. Esto es necesario para que el
sistema
+sepa que el montaje del sistema de ficheros depende del establecimiento de
+la traducción de dispositivos correspondiente.
+
address@hidden @code{flags} (predeterminadas: @code{'()})
+Una lista de símbolos que denotan opciones del montaje. Las opciones
+reconocidas incluyen @code{read-only} (modo de sólo lectura),
address@hidden (montaje enlazado), @code{no-dev} (prohibición del acceso
+a ficheros especiales), @code{no-suid} (ignora los bits setuid y setgid) y
address@hidden (prohibición de la ejecución de programas).
+
address@hidden @code{options} (predeterminadas: @code{#f})
+Esto es o bien @code{#f}, o bien una cadena que contiene opciones de
+montaje.
+
address@hidden @code{mount?} (predeterminado: @code{#t})
+Este valor indica si debe montarse el sistema de ficheros automáticamente al
+iniciar el sistema. Cuando se establece como @code{#f}, el sistema de
+ficheros tiene una entrada en @file{/etc/fstab} (el cual es leído por la
+orden @command{mount}) pero no se montará automáticamente.
+
address@hidden @code{needed-for-boot?} (predeterminado: @code{#f})
+Este valor lógico indica si el sistema de ficheros es necesario para el
+arranque. Si es verdadero, el sistema de ficheros se monta al cargar el
+disco inicial de RAM (initrd). Este es siempre el caso, por ejemplo, para el
+sistema de ficheros raíz.
+
address@hidden @code{check?} (predeterminado: @code{#t})
+Este valor lógico indica si el sistema de ficheros se debe comprobar en
+busca de errores antes de montarse.
+
address@hidden @code{create-mount-point?} (predeterminado: @code{#f})
+Cuando es verdadero, el punto de montaje es creado si no existía
+previamente.
+
address@hidden @code{dependencies} (predeterminadas: @code{'()})
+Una lista de objetos @code{<file-system>} o @code{<mapped-device>} que
+representan sistemas de ficheros que deben montarse o dispositivos
+traducidos que deben abrirse antes (y desmontarse o cerrarse después) que el
+declarado.
+
+Como ejemplo, considere la siguiente jerarquía de montajes:
address@hidden/sys/fs/cgroup} es una dependencia de @file{/sys/fs/cgroup/cpu} y
address@hidden/sys/fs/cgroup/memory}.
+
+Otro ejemplo es un sistema de ficheros que depende de un dispositivo
+traducido, por ejemplo una partición cifrada (@pxref{Dispositivos traducidos}).
address@hidden table
address@hidden deftp
+
+El módulo @code{(gnu system file-systems)} exporta las siguientes variables
+útiles.
+
address@hidden {Variable Scheme} %base-file-systems
+Estos son los sistemas de ficheros esenciales que se necesitan en sistemas
+normales, como @var{%pseudo-terminal-file-system} y @var{%immutable-store}
+(véase a continuación). Las declaraciones de sistemas operativos deben
+contener siempre estos al menos.
address@hidden defvr
+
address@hidden {Variable Scheme} %pseudo-terminal-file-systems
+El sistema de ficheros que debe montarse como @file{/dev/pts}. Permite la
+creación de @dfn{pseudoterminales} a través de @code{openpty} y funciones
+similares (@pxref{Pseudo-Terminals,,, libc, The GNU C Library Reference
+Manual}). Los pseudoterminales son usados por emuladores de terminales como
address@hidden
address@hidden defvr
+
address@hidden {Variable Scheme} %shared-memory-file-system
+Este sistema de ficheros se monta como @file{/dev/shm} y se usa para
+permitir el uso de memoria compartida entre procesos (@pxref{Memory-mapped
+I/O, @code{shm_open},, libc, The GNU C Library Reference Manual}).
address@hidden defvr
+
address@hidden {Variable Scheme} %immutable-store
+Este sistema de ficheros crea un montaje enlazado (``bind-mount'') de
address@hidden/gnu/store}, permitiendo solo el acceso de lectura para todas las
+usuarias incluyendo a @code{root}. Esto previene modificaciones accidentales
+por software que se ejecuta como @code{root} o por las administradoras del
+sistema.
+
+El daemon sí es capaz de escribir en el almacén: vuelve a montar
address@hidden/gnu/store} en modo lectura-escritura en su propio ``espacio de
+nombres''.
address@hidden defvr
+
address@hidden {Variable Scheme} %binary-format-file-system
+El sistema de ficheros @code{binfmt_misc}, que permite que el manejo de
+tipos de ficheros ejecutables arbitrarios se delegue al espacio de
+usuaria. Necesita la carga del módulo del núcleo @code{binfmt.ko}.
address@hidden defvr
+
address@hidden {Variable Scheme} %fuse-control-file-system
+El sistema de ficheros @code{fusectl}, que permite a usuarias sin
+privilegios montar y desmontar sistemas de ficheros de espacio de usuaria
+FUSE. Necesita la carga del módulo del núcleo @code{fuse.ko}.
address@hidden defvr
+
address@hidden Dispositivos traducidos
address@hidden Dispositivos traducidos
+
address@hidden traducción de dispositivos
address@hidden dispositivos traducidos
+El núcleo Linux tiene una noción de @dfn{traducción de dispositivos}: un
+dispositivo de bloques, como una partición de disco duro, puede
address@hidden en otro dispositivo, habitualmente en @code{/dev/mapper/},
+con un procesamiento adicional sobre los datos que fluyen a través de
address@hidden que address@hidden no diferencia entre el concepto de un
+``dispositivo traducido'' y el de un sistema de ficheros: ambos se reducen a
address@hidden operaciones de entrada/salida realizadas en un fichero a
+operaciones en su almacenamiento subyacente. Por tanto, Hurd implementa
+dispositivos traducidos, como sistemas de ficheros, usando el mecanismo
+genérico de @dfn{traducción} (@pxref{Translators,,, hurd, The GNU Hurd
+Reference Manual}).}. Un ejemplo típico es la traducción de dispositivos
+para el cifrado: todas las escrituras en el dispositivo traducido se cifran,
+y todas las lecturas se descifran, de forma transparente. Guix extiende esta
+noción considerando cualquier dispositivo o conjunto de dispositivos que son
address@hidden de alguna manera para crear un nuevo dispositivo; por
+ejemplo, los dispositivos RAID se obtienen @dfn{ensamblando} otros
+dispositivos, como discos duros o particiones, en uno nuevo que se comporta
+como una partición. Otros ejemplos, todavía no implementados, son los
+volúmenes lógicos LVM.
+
+Los dispositivos traducidos se declaran mediante el uso de la forma
address@hidden, definida a continuación; ejemplos más adelante.
+
address@hidden {Tipo de datos} mapped-device
+Objetos de este tipo representan traducciones de dispositivo que se llevarán
+a cabo cuando el sistema arranque.
+
address@hidden @code
address@hidden source
+Puede ser tanto una cadena que especifica el nombre de un dispositivo de
+bloques a traducir, como @code{"/dev/sda3"}, o una lista de dichas cadenas
+cuando varios dispositivos necesitan ser ensamblados para crear uno nuevo.
+
address@hidden target
+Esta cadena especifica el nombre del dispositivo traducido resultante. Para
+traductores del núcleo como dispositivos de cifrado del tipo
address@hidden, especificar @code{"mi-particion"} produce la
+creación del dispositivo @code{"/dev/mapper/mi-particion"}. Para
+dispositivos RAID de tipo @code{raid-device-mapping}, el nombre del
+dispositivo completo como @code{"/dev/md0"} debe ser proporcionado.
+
address@hidden type
+Debe ser un objeto @code{mapped-device-kind}, que especifica cómo
address@hidden se traduce a @var{target}.
address@hidden table
address@hidden deftp
+
address@hidden {Variable Scheme} luks-device-mapping
+Define el cifrado de bloques LUKS mediante el uso de la orden
address@hidden del paquete del mismo nombre. Depende del módulo
address@hidden del núcleo Linux.
address@hidden defvr
+
address@hidden {Variable Scheme} raid-device-mapping
+Define un dispositivo RAID, el cual se ensambla mediante el uso de la orden
address@hidden del paquete del mismo nombre. Requiere la carga del módulo del
+núcleo Linux para el nivel RAID apropiado, como @code{raid456} para RAID-4,
+RAID-5 o RAID-6, o @code{raid10} para RAID-10.
address@hidden defvr
+
address@hidden cifrado de disco
address@hidden LUKS
+El siguiente ejemplo especifica una traducción de @file{/dev/sda3} a
address@hidden/dev/mapper/home} mediante el uso de LUKS---la
address@hidden://gitlab.com/cryptsetup/cryptsetup,configuración de claves
+unificada de Linux}, un mecanismo estándar para cifrado de disco. El
+dispositivo @file{/dev/mapper/home} puede usarse entonces como el campo
address@hidden de una declaración @code{file-system} (@pxref{Sistemas de
ficheros}).
+
address@hidden
+(mapped-device
+ (source "/dev/sda3")
+ (target "home")
+ (type luks-device-mapping))
address@hidden example
+
+De manera alternativa, para independizarse de la numeración de dispositivos,
+puede obtenerse el UUID LUKS (@dfn{identificador único}) del dispositivo
+fuente con una orden así:
+
address@hidden
+cryptsetup luksUUID /dev/sda3
address@hidden example
+
+y usarlo como sigue:
+
address@hidden
+(mapped-device
+ (source (uuid "cb67fc72-0d54-4c88-9d4b-b225f30b0f44"))
+ (target "home")
+ (type luks-device-mapping))
address@hidden example
+
address@hidden cifrado del intercambio
+También es deseable cifrar el espacio de intercambio, puesto que el espacio
+de intercambio puede contener información sensible. Una forma de conseguirlo
+es usar un fichero de intercambio en un sistema de ficheros en un
+dispositivo traducido a través del cifrado LUKS. @xref{Preparación para la
instalación,,Particionado del disco}, para un ejemplo.
+
+Un dispositivo RAID formado por las particiones @file{/dev/sda1} y
address@hidden/dev/sdb1} puede declararse como se muestra a continuación:
+
address@hidden
+(mapped-device
+ (source (list "/dev/sda1" "/dev/sdb1"))
+ (target "/dev/md0")
+ (type raid-device-mapping))
address@hidden example
+
+El dispositivo @file{/dev/md0} puede usarse entonces como el campo
address@hidden de una declaración @code{file-system} (@pxref{Sistemas de
ficheros}). Fíjese que no necesita proporcionar el nivel RAID; se selecciona
+durante la creación inicial y formato del dispositivo RAID y después se
+determina automáticamente.
+
+
address@hidden Cuentas de usuaria
address@hidden Cuentas de usuaria
+
address@hidden usuarias
address@hidden cuentas
address@hidden cuentas de usuaria
+Los grupos y cuentas de usuaria se gestionan completamente a través de la
+declaración @code{operating-system}. Se especifican con las formas
address@hidden y @code{user-group}:
+
address@hidden
+(user-account
+ (name "alicia")
+ (group "users")
+ (supplementary-groups '("wheel" ;permite usar sudo, etc.
+ "audio" ;tarjeta de sonido
+ "video" ;dispositivos de vídeo como cámaras
+ "cdrom")) ;el veterano CD-ROM
+ (comment "hermana de Roberto")
+ (home-directory "/home/alicia"))
address@hidden example
+
+Durante el arranque o tras la finalización de @command{guix system
+reconfigure}, el sistema se asegura de que únicamente las cuentas de usuaria
+y grupos especificados en la declaración @code{operating-system} existen, y
+con las propiedades especificadas. Por tanto, la creación o modificación de
+cuentas o grupos realizadas directamente invocando órdenes como
address@hidden se pierden al reconfigurar o reiniciar el sistema. Esto
+asegura que el sistema permanece exactamente como se declaró.
+
address@hidden {Tipo de datos} user-account
+Objetos de este tipo representan cuentas de usuaria. Los siguientes miembros
+pueden ser especificados:
+
address@hidden @asis
address@hidden @code{name}
+El nombre de la cuenta de usuaria.
+
address@hidden @code{group}
address@hidden grupos
+Este es el nombre (una cadena) o identificador (un número) del grupo de
+usuarias al que esta cuenta pertenece.
+
address@hidden @code{supplementary-groups} (predeterminados: @code{'()})
+Opcionalmente, esto puede definirse como una lista de nombres de grupo a los
+que esta cuenta pertenece.
+
address@hidden @code{uid} (predeterminado: @code{#f})
+Este es el ID de usuaria para esta cuenta (un número), o @code{#f}. En el
+último caso, un número es seleccionado automáticamente por el sistema cuando
+la cuenta es creada.
+
address@hidden @code{comment} (predeterminado: @code{""})
+Un comentario sobre la cuenta, como el nombre completo de la propietaria.
+
address@hidden @code{home-directory}
+Este es el nombre del directorio de usuaria de la cuenta.
+
address@hidden @code{create-home-directory?} (predeterminado: @code{#t})
+Indica si el directorio de usuaria de esta cuenta debe ser creado si no
+existe todavía.
+
address@hidden @code{shell} (predeterminado: Bash)
+Esto es una expresión-G denotando el nombre de fichero de un programa que
+será usado como shell (@pxref{Expresiones-G}).
+
address@hidden @code{system?} (predeterminado: @code{#f})
+Este valor lógico indica si la cuenta es una cuenta ``del sistema''. Las
+cuentas del sistema se tratan a veces de forma especial; por ejemplo, los
+gestores gráficos de inicio no las enumeran.
+
address@hidden
address@hidden contraseña, para cuentas de usuaria
address@hidden @code{password} (predeterminada: @code{#f})
+Normalmente debería dejar este campo a @code{#f}, inicializar la contraseña
+de usuaria como @code{root} con la orden @command{passwd}, y entonces dejar
+a las usuarias cambiarla con @command{passwd}. Las contraseñas establecidas
+con @command{passwd} son, por supuesto, preservadas entre reinicios y
+reconfiguraciones.
+
+If you @emph{do} want to set an initial password for an account, then this
+field must contain the encrypted password, as a string. You can use the
address@hidden procedure for this purpose:
+
address@hidden
+(user-account
+ (name "charlie")
+ (group "users")
+
+ ;; Specify a SHA-512-hashed initial password.
+ (password (crypt "InitialPassword!" "$6$abc")))
address@hidden example
+
address@hidden Nota
+The hash of this initial password will be available in a file in
address@hidden/gnu/store}, readable by all the users, so this method must be
used
+with care.
address@hidden quotation
+
address@hidden Storage,,, libc, The GNU C Library Reference Manual}, for
+more information on password encryption, and @ref{Encryption,,, guile, GNU
+Guile Reference Manual}, for information on Guile's @code{crypt} procedure.
+
address@hidden table
address@hidden deftp
+
address@hidden grupos
+Las declaraciones de grupos son más simples incluso:
+
address@hidden
+(user-group (name "estudiantes"))
address@hidden example
+
address@hidden {Tipo de datos} user-group
+Este tipo es para grupos de usuarias. Hay únicamente unos pocos campos:
+
address@hidden @asis
address@hidden @code{name}
+En nombre del grupo.
+
address@hidden @code{id} (predeterminado: @code{#f})
+El identificador del grupo (un número). Si es @code{#f}, un nuevo número es
+reservado automáticamente cuando se crea el grupo.
+
address@hidden @code{system?} (predeterminado: @code{#f})
+Este valor booleano indica si el grupo es un grupo ``del sistema''. Los
+grupos del sistema tienen identificadores numéricos bajos.
+
address@hidden @code{password} (predeterminada: @code{#f})
+¿Qué? ¿Los grupos de usuarias pueden tener una contraseña? Bueno,
+aparentemente sí. A menos que sea @code{#f}, este campo especifica la
+contraseña del grupo.
+
address@hidden table
address@hidden deftp
+
+Por conveniencia, una variable contiene una lista con todos los grupos de
+usuarias básicos que se puede esperar:
+
address@hidden {Variable Scheme} %base-groups
+Esta es la lista de grupos de usuarias básicos que las usuarias y/o los
+paquetes esperan que estén presentes en el sistema. Esto incluye grupos como
+``root'', ``wheel'' y ``users'', así como grupos usados para controlar el
+acceso a dispositivos específicos como ``audio'', ``disk'' y ``cdrom''.
address@hidden defvr
+
address@hidden {Variable Scheme} %base-user-accounts
+Esta es la lista de cuentas de usuaria básicas que los programas pueden
+esperar encontrar en un sistema GNU/Linux, como la cuenta ``nobody''.
+
+Fíjese que la cuenta de ``root'' no se incluye aquí. Es un caso especial y
+se añade automáticamente esté o no especificada.
address@hidden defvr
+
address@hidden Distribución de teclado
address@hidden Distribución de teclado
+
address@hidden distribución de teclado
address@hidden mapa del teclas
+To specify what each key of your keyboard does, you need to tell the
+operating system what @dfn{keyboard layout} you want to use. The default,
+when nothing is specified, is the US English QWERTY layout for 105-key PC
+keyboards. However, German speakers will usually prefer the German QWERTZ
+layout, French speakers will want the AZERTY layout, and so on; hackers
+might prefer Dvorak or bépo, and they might even want to further customize
+the effect of some of the keys. This section explains how to get that done.
+
address@hidden distribución de teclado, definición
+There are three components that will want to know about your keyboard
+layout:
+
address@hidden
address@hidden
+The @emph{bootloader} may want to know what keyboard layout you want to use
+(@pxref{Configuración del gestor de arranque, @code{keyboard-layout}}). This
is useful
+if you want, for instance, to make sure that you can type the passphrase of
+your encrypted root partition using the right layout.
+
address@hidden
+The @emph{operating system kernel}, Linux, will need that so that the
+console is properly configured (@pxref{Referencia de ``operating-system'',
address@hidden).
+
address@hidden
+The @emph{graphical display server}, usually Xorg, also has its own idea of
+the keyboard layout (@pxref{Sistema X Window, @code{keyboard-layout}}).
address@hidden itemize
+
+Guix allows you to configure all three separately but, fortunately, it
+allows you to share the same keyboard layout for all three components.
+
address@hidden XKB, distribuciones de teclado
+Keyboard layouts are represented by records created by the
address@hidden procedure of @code{(gnu system keyboard)}. Following
+the X Keyboard extension (XKB), each layout has four attributes: a name
+(often a language code such as ``fi'' for Finnish or ``jp'' for Japanese),
+an optional variant name, an optional keyboard model name, and a possibly
+empty list of additional options. In most cases the layout name is all you
+care about. Here are a few example:
+
address@hidden
+;; The German QWERTZ layout. Here we assume a standard
+;; "pc105" keyboard model.
+(keyboard-layout "de")
+
+;; The bépo variant of the French layout.
+(keyboard-layout "fr" "bepo")
+
+;; The Catalan layout.
+(keyboard-layout "es" "cat")
+
+;; The Latin American Spanish layout. In addition, the
+;; "Caps Lock" key is used as an additional "Ctrl" key,
+;; and the "Menu" key is used as a "Compose" key to enter
+;; accented letters.
+(keyboard-layout "latam"
+ #:options '("ctrl:nocaps" "compose:menu"))
+
+;; The Russian layout for a ThinkPad keyboard.
+(keyboard-layout "ru" #:model "thinkpad")
+
+;; The "US international" layout, which is the US layout plus
+;; dead keys to enter accented characters. This is for an
+;; Apple MacBook keyboard.
+(keyboard-layout "us" "intl" #:model "macbook78")
address@hidden example
+
+See the @file{share/X11/xkb} directory of the @code{xkeyboard-config}
+package for a complete list of supported layouts, variants, and models.
+
address@hidden distribución de teclado, configuración
+Let's say you want your system to use the Turkish keyboard layout throughout
+your system---bootloader, console, and Xorg. Here's what your system
+configuration would look like:
+
address@hidden set-xorg-configuration
address@hidden
+;; Using the Turkish layout for the bootloader, the console,
+;; and for Xorg.
+
+(operating-system
+ ;; ...
+ (keyboard-layout (keyboard-layout "tr")) ;for the console
+ (bootloader (bootloader-configuration
+ (bootloader grub-efi-bootloader)
+ (target "/boot/efi")
+ (keyboard-layout keyboard-layout))) ;for GRUB
+ (services (cons (set-xorg-configuration
+ (xorg-configuration ;for Xorg
+ (keyboard-layout keyboard-layout)))
+ %desktop-services)))
address@hidden lisp
+
+In the example above, for GRUB and for Xorg, we just refer to the
address@hidden field defined above, but we could just as well refer
+to a different layout. The @code{set-xorg-configuration} procedure
+communicates the desired Xorg configuration to the graphical log-in manager,
+by default GDM.
+
+We've discussed how to specify the @emph{default} keyboard layout of your
+system when it starts, but you can also adjust it at run time:
+
address@hidden
address@hidden
+If you're using GNOME, its settings panel has a ``Region & Language'' entry
+where you can select one or more keyboard layouts.
+
address@hidden
+Under Xorg, the @command{setxkbmap} command (from the same-named package)
+allows you to change the current layout. For example, this is how you would
+change the layout to US Dvorak:
+
address@hidden
+setxkbmap us dvorak
address@hidden example
+
address@hidden
+The @code{loadkeys} command changes the keyboard layout in effect in the
+Linux console. However, note that @code{loadkeys} does @emph{not} use the
+XKB keyboard layout categorization described above. The command below loads
+the French bépo layout:
+
address@hidden
+loadkeys fr-bepo
address@hidden example
address@hidden itemize
+
address@hidden Localizaciones
address@hidden Localizaciones
+
address@hidden localización
+Una @dfn{localización} define convenciones culturales para una lengua y
+región del mundo particular (@pxref{Localizaciones,,, libc, The GNU C Library
+Reference Manual}). Cada localización tiene un nombre que típicamente tiene
+la forma de @address@hidden@address@hidden
+ejemplo, @code{fr_LU.utf8} designa la localización para la lengua francesa,
+con las convenciones culturales de Luxemburgo, usando la codificación UTF-8.
+
address@hidden definición de localización
+Normalmente deseará especificar la localización predeterminada para la
+máquina usando el campo @code{locale} de la declaración
address@hidden (@pxref{Referencia de ``operating-system'', @code{locale}}).
+
+La localización seleccionada es automáticamente añadida a las
address@hidden de localización} conocidas en el sistema si es necesario,
+con su codificación inferida de su nombre---por ejemplo, se asume que
address@hidden usa la codificación @code{UTF-8}. Definiciones de
+localización adicionales pueden ser especificadas en el campo
address@hidden de @code{operating-system}---esto es util, por
+ejemplo, si la codificación no puede ser inferida del nombre de la
+localización. El conjunto predeterminado de definiciones de localización
+incluye algunas localizaciones ampliamente usadas, pero no todas las
+disponibles, para ahorrar espacio.
+
+Por ejemplo, para añadir la localización del frisio del norte para Alemania,
+el valor de dicho campo puede ser:
+
address@hidden
+(cons (locale-definition
+ (name "fy_DE.utf8") (source "fy_DE"))
+ %default-locale-definitions)
address@hidden example
+
+De mismo modo, para ahorrar espacio, se puede desear que
address@hidden contenga únicamente las localizaciones que son
+realmente usadas, como en:
+
address@hidden
+(list (locale-definition
+ (name "ja_JP.eucjp") (source "ja_JP")
+ (charset "EUC-JP")))
address@hidden example
+
address@hidden LOCPATH
+Las definiciones de localización compiladas están disponibles en
address@hidden/run/current-system/locale/X.Y}, donde @code{X.Y} es la versión de
+libc, que es la ruta donde la address@hidden contenida en Guix buscará los
+datos de localización. Esto puede ser sobreescrito usando la variable de
+entorno @code{LOCPATH} (@pxref{locales-and-locpath, @code{LOCPATH} and
+locale packages}).
+
+La forma @code{locale-definition} es proporcionada por el módulo @code{(gnu
+system locale)}. Los detalles se proporcionan a continuación.
+
address@hidden {Tipo de datos} locale-definition
+Este es el tipo de datos de una definición de localización.
+
address@hidden @asis
+
address@hidden @code{name}
+El nombre de la localización. @xref{Locale Names,,, libc, The GNU C Library
+Reference Manual}, para más información sobre nombres de localizaciones.
+
address@hidden @code{source}
+El nombre de la fuente para dicha localización. Esto típicamente es la parte
address@hidden@address@hidden del nombre de localización.
+
address@hidden @code{charset} (predeterminado: @code{"UTF-8"})
+La ``codificación de caracteres'' o ``conjunto de caracteres'' para dicha
+localización, @uref{http://www.iana.org/assignments/character-sets, como se
+define por IANA}.
+
address@hidden table
address@hidden deftp
+
address@hidden {Variable Scheme} %default-locale-definitions
+Una lista de localizaciones UTF-8 usadas de forma común, usada como valor
+predeterminado del campo @code{locale-definitions} en las declaraciones
address@hidden
+
address@hidden nombre de localización
address@hidden codificación normalizada en los nombres de localizaciones
+Estas definiciones de localizaciones usan la @dfn{codificación normalizada}
+para el fragmento tras el punto en el nombre (@pxref{Using gettextized
+software, normalized codeset,, libc, The GNU C Library Reference
+Manual}). Por lo que por ejemplo es válido @code{uk_UA.utf8} pero @emph{no},
+digamos, @code{uk_UA.UTF-8}.
address@hidden defvr
+
address@hidden Consideraciones sobre la compatibilidad de datos de localización
+
address@hidden incompatibilidad, de datos de localización
+Las declaraciones @code{operating-system} proporcionan un campo
address@hidden para especificar los paquetes address@hidden que se
+usarán para compilar las declaraciones de localizaciones
+(@pxref{Referencia de ``operating-system''}). ``¿Por qué debo preocuparme?'',
puede
+preguntarse. Bueno, sucede que el formato binario de los datos de
+localización es ocasionalmente incompatible de una versión de libc a otra.
+
address@hidden See <https://sourceware.org/ml/libc-alpha/2015-09/msg00575.html>
address@hidden and
<https://lists.gnu.org/archive/html/guix-devel/2015-08/msg00737.html>.
+Por ejemplo, un programa enlazado con la versión 2.21 de libc no puede leer
+datos de localización producidos con libc 2.22; peor aún, ese programa
address@hidden en vez de simplemente ignorar los datos de localización
address@hidden versiones 2.23 y posteriores de address@hidden
+simplemente ignorarán los datos de localización incompatibles, lo cual ya es
+un avance.}. De manera similar, un programa enlazado con libc 2.22 puede
+leer la mayor parte, pero no todo, de los datos de localización de libc 2.21
+(específicamente, los datos @code{LC_COLLATE} son incompatibles); por tanto
+las llamadas a @code{setlocale} pueden fallar, pero los programas no
+abortarán.
+
+El ``problema'' con Guix es que las usuarias tienen mucha libertad: pueden
+elegir cuando e incluso si actualizar el software en sus perfiles, y pueden
+estar usando una versión de libc diferente de la que la administradora del
+sistema usó para construir los datos de localización comunes a todo el
+sistema.
+
+Por suerte, las usuarias sin privilegios también pueden instalar sus propios
+datos de localización y definir @var{GUIX_LOCPATH} adecuadamente
+(@pxref{locales-and-locpath, @code{GUIX_LOCPATH} y paquetes de
+localizaciones}).
+
+No obstante, es mejor si los datos de localización globales del sistema en
address@hidden/run/current-system/locale} se construyen para todas las
versiones de
+libc realmente en uso en el sistema, de manera que todos los programas
+puedan acceder a ellos---esto es especialmente crucial en un sistema
+multiusuaria. Para hacerlo, la administradora puede especificar varios
+paquetes libc en el campo @code{locale-libcs} de @code{operating-system}:
+
address@hidden
+(use-package-modules base)
+
+(operating-system
+ ;; @dots{}
+ (locale-libcs (list glibc-2.21 (canonical-package glibc))))
address@hidden example
+
+Este ejemplo llevaría a un sistema que contiene definiciones de localización
+tanto para libc 2.21 como para la versión actual de libc en
address@hidden/run/current-system/locale}.
+
+
address@hidden Servicios
address@hidden Servicios
+
address@hidden servicios del sistema
+Una parte importante de la preparación de una declaración
address@hidden es listar los @dfn{servicios del sistema} y su
+configuración (@pxref{Uso de la configuración del sistema}). Los servicios del
+sistema típicamente son daemon lanzados cuando el sistema arrancha, u otras
+acciones necesarias en ese momento---por ejemplo, configurar el acceso de
+red.
+
+Guix has a broad definition of ``service'' (@pxref{Composición de servicios}),
+but many services are managed by the address@hidden (@pxref{Servicios de
Shepherd}). On a running system, the @command{herd} command allows you to
+list the available services, show their status, start and stop them, or do
+other specific operations (@pxref{Jump Start,,, shepherd, The GNU Shepherd
+Manual}). For example:
+
address@hidden
+# herd status
address@hidden example
+
+La orden previa, ejecutada como @code{root}, enumera los servicios
+actualmente definidos. La orden @command{herd doc} muestra una sinopsis del
+servicio proporcionado y sus acciones asociadas:
+
address@hidden
+# herd doc nscd
+Run libc's name service cache daemon (nscd).
+
+# herd doc nscd action invalidate
+invalidate: Invalidate the given cache--e.g., 'hosts' for host name lookups.
address@hidden example
+
+Las ordenes internas @command{start}, @command{stop} y @command{restart}
+tienen el efecto de arrancar, parar y reiniciar el servicio,
+respectivamente. Por ejemplo, las siguientes órdenes paran el servicio nscd
+y reinician el servidor gráfico Xorg:
+
address@hidden
+# herd stop nscd
+Service nscd has been stopped.
+# herd restart xorg-server
+Service xorg-server has been stopped.
+Service xorg-server has been started.
address@hidden example
+
+Las siguientes secciones documentan los servicios disponibles, comenzando
+con los servicios básicos, que pueden ser usados en una declaración
address@hidden
+
address@hidden
+* Servicios base:: Servicios esenciales del sistema.
+* Ejecución de tareas programadas:: El servicio mcron.
+* Rotación de logs:: El servicio rottlog.
+* Servicios de red:: Configuración de red, daemon SSH, etc.
+* Sistema X Window:: Interfaz gráfica.
+* Servicios de impresión:: Soporte de impresoras locales y remotas.
+* Servicios de escritorio:: D-Bus y servicios de escritorio.
+* Servicios de sonido:: Servicios de ALSA y Pulseaudio.
+* Servicios de bases de datos:: Bases de datos SQL, almacenes de
+ clave-valor, etc.
+* Servicios de correo:: IMAP, POP3, SMTP y todo eso.
+* Servicios de mensajería:: Servicios de mensajería.
+* Servicios de telefonía:: Servicios de telefonía.
+* Servicios de monitorización:: Servicios de monitorización.
+* Servicios Kerberos:: Servicios Kerberos.
+* Servicios LDAP:: Servicios LDAP.
+* Servicios Web:: Servidores Web.
+* Servicios de certificados:: Certificados TLS via Let's Encrypt.
+* Servicios DNS:: Demonios DNS.
+* Servicios VPN:: Demonios VPN.
+* Sistema de ficheros en red:: Servicios relacionados con NFS.
+* Integración continua:: El servicio Cuirass.
+* Servicios de gestión de energía:: Extender la vida de la batería.
+* Servicios de audio:: El MPD.
+* Servicios de virtualización:: Servicios de virtualización.
+* Servicios de control de versiones:: Proporcionar acceso remoto a
+ repositorios Git.
+* Servicios de juegos:: Servidores de juegos.
+* Servicios misceláneos:: Otros servicios.
address@hidden menu
+
address@hidden Servicios base
address@hidden Servicios base
+
+El módulo @code{(gnu services base)} proporciona definiciones para los
+servicios básicos que se esperan en el sistema. Los servicios exportados por
+este módulo se enumeran a continuación.
+
address@hidden {Variable Scheme} %base-services
+Esta variable contiene una lista de servicios básicos (@pxref{Tipos de
servicios y servicios}, para más información sobre los objetos servicio) que se
+pueden esperar en el sistema: un servicio de ingreso al sistema (mingetty)
+en cada tty, syslogd, el daemon de la caché del servicio de nombres (nscd),
+el gestor de dispositivos udev, y más.
+
+Este es el valor predeterminado del campo @code{services} de las
+declaraciones @code{operating-system}. De manera habitual, cuando se
+personaliza el sistema, es deseable agregar servicios a
address@hidden, de esta forma:
+
address@hidden
+(append (list (service avahi-service-type)
+ (service openssh-service-type))
+ %base-services)
address@hidden example
address@hidden defvr
+
address@hidden {Variable Scheme} special-files-service-type
+El servicio que establece ``ficheros especiales'' como @file{/bin/sh}; una
+instancia suya es parte de @code{%base-services}.
+
+El valor asociado con servicios @code{special-file-service-type} debe ser
+una lista de tuplas donde el primer elemento es el ``fichero especial'' y el
+segundo elemento es su destino. El valor predeterminado es:
+
address@hidden @file{/bin/sh}
address@hidden @file{sh}, en @file{/bin}
address@hidden
+`(("/bin/sh" ,(file-append @var{bash} "/bin/sh")))
address@hidden example
+
address@hidden @file{/usr/bin/env}
address@hidden @file{env}, en @file{/usr/bin}
+Si quiere añadir, digamos, @code{/usr/bin/env} a su sistema, puede cambiar
+su valor por:
+
address@hidden
+`(("/bin/sh" ,(file-append @var{bash} "/bin/sh"))
+ ("/usr/bin/env" ,(file-append @var{coreutils} "/bin/env")))
address@hidden example
+
+Ya que es parte de @code{%base-services}, puede usar @code{modify-services}
+para personalizar el conjunto de ficheros especiales (@pxref{Referencia de
servicios, @code{modify-services}}). Pero una forma simple de añadir un
+fichero especial es usar el procedimiento @code{extra-special-file} (véase a
+continuación).
address@hidden defvr
+
address@hidden {Procedimiento Scheme} extra-special-file @var{fichero}
@var{destino}
+Usa @var{destino} como el ``fichero especial'' @var{fichero}.
+
+Por ejemplo, la adición de las siguientes líneas al campo @code{services} de
+su declaración de sistema operativo genera @file{/usr/bin/env} como un
+enlace simbólico:
+
address@hidden
+(extra-special-file "/usr/bin/env"
+ (file-append coreutils "/bin/env"))
address@hidden example
address@hidden deffn
+
address@hidden {Procedimiento Scheme} host-name-service @var{nombre}
+Devuelve un servicio que establece el nombre de máquina a @var{nombre}.
address@hidden deffn
+
address@hidden {Procedimiento Scheme} login-service @var{config}
+Devuelve un servicio para ejecutar el ingreso al sistema de acuerdo con
address@hidden, un objeto @code{<login-configuration>}, que especifica el
+mensaje del día, entre otras cosas.
address@hidden deffn
+
address@hidden {Tipo de datos} login-configuration
+Este es el tipo de datos que representa la configuración del ingreso al
+sistema.
+
address@hidden @asis
+
address@hidden @code{motd}
address@hidden mensaje del día
+Un objeto tipo-fichero que contiene el ``mensaje del día''.
+
address@hidden @code{allow-empty-passwords?} (predeterminado: @code{#t})
+Permite contraseñas vacías por defecto para que las primeras usuarias puedan
+ingresar en el sistema cuando la cuenta de ``root'' está recién creada.
+
address@hidden table
address@hidden deftp
+
address@hidden {Procedimiento Scheme} mingetty-service @var{config}
+Devuelve un servicio para ejecutar mingetty de acuerdo con @var{config}, un
+objeto @code{<mingetty-configuration>}, que especifica el tty a ejecutar
+entre otras cosas.
address@hidden deffn
+
address@hidden {Tipo de datos} mingetty-configuration
+Este es el tipo de datos que representa la configuración de Mingetty, el
+cual proporciona la implementación predeterminada de ingreso al sistema en
+las consolas virtuales.
+
address@hidden @asis
+
address@hidden @code{tty}
+El sistema de la consola en la que se ejecuta este Mingetty---por ejemplo,
address@hidden"tty1"}.
+
address@hidden @code{auto-login} (predeterminado: @code{#f})
+Cuando sea verdadero, este campo debe ser una cadena que denote el nombre de
+usuaria bajo el cual el sistema ingresa automáticamente. Cuando es
address@hidden, se deben proporcionar un nombre de usuaria y una contraseña para
+ingresar en el sistema.
+
address@hidden @code{login-program} (predeterminado: @code{#f})
+Debe ser @code{#f}, en cuyo caso se usa el programa predeterminado de
+ingreso al sistema (@command{login} de las herramientas Shadow), o una
+expresión-G que determine el nombre del programa de ingreso al sistema.
+
address@hidden @code{login-pause?} (predeterminado: @code{#f})
+Cuando es @code{#t} en conjunción con @var{auto-login}, la usuaria deberá
+presionar una tecla para lanzar el shell de ingreso al sistema.
+
address@hidden @code{mingetty} (predeterminado: @var{mingetty})
+El paquete Mingetty usado.
+
address@hidden table
address@hidden deftp
+
address@hidden {Procedure Scheme} agetty-service @var{config}
+Devuelve un servicio para ejecutar agetty de acuerdo con @var{config}, un
+objeto @code{<agetty-configuration>}, que especifica el tty a ejecutar entre
+otras cosas.<
address@hidden deffn
+
address@hidden {Tipo de datos} agetty-configuration
+Este es el tipo de datos que representa la configuración de agetty, que
+implementa el ingreso al sistema en las consolas virtuales y serie. Véase la
+página de manual @code{agetty(8)} para más información.
+
address@hidden @asis
+
address@hidden @code{tty}
+The name of the console this agetty runs on, as a string---e.g.,
address@hidden"ttyS0"}. This argument is optional, it will default to a
reasonable
+default serial port used by the kernel Linux.
+
+For this, if there is a value for an option @code{agetty.tty} in the kernel
+command line, agetty will extract the device name of the serial port from it
+and use that.
+
+If not and if there is a value for an option @code{console} with a tty in
+the Linux command line, agetty will extract the device name of the serial
+port from it and use that.
+
+In both cases, agetty will leave the other serial device settings (baud rate
+etc.)@: alone---in the hope that Linux pinned them to the correct values.
+
address@hidden @code{baud-rate} (predeterminado: @code{#f})
+A string containing a comma-separated list of one or more baud rates, in
+descending order.
+
address@hidden @code{term} (predeterminado: @code{#f})
+A string containing the value used for the @code{TERM} environment variable.
+
address@hidden @code{eight-bits?} (predeterminado: @code{#f})
+When @code{#t}, the tty is assumed to be 8-bit clean, and parity detection
+is disabled.
+
address@hidden @code{auto-login} (predeterminado: @code{#f})
+When passed a login name, as a string, the specified user will be logged in
+automatically without prompting for their login name or password.
+
address@hidden @code{no-reset?} (predeterminado: @code{#f})
+When @code{#t}, don't reset terminal cflags (control modes).
+
address@hidden @code{host} (predeterminado: @code{#f})
+This accepts a string containing the "login_host", which will be written
+into the @file{/var/run/utmpx} file.
+
address@hidden @code{remote?} (predeterminado: @code{#f})
+When set to @code{#t} in conjunction with @var{host}, this will add an
address@hidden fakehost option to the command line of the login program
specified
+in @var{login-program}.
+
address@hidden @code{flow-control?} (predeterminado: @code{#f})
+When set to @code{#t}, enable hardware (RTS/CTS) flow control.
+
address@hidden @code{no-issue?} (predeterminado: @code{#f})
+When set to @code{#t}, the contents of the @file{/etc/issue} file will not
+be displayed before presenting the login prompt.
+
address@hidden @code{init-string} (predeterminada: @code{#f})
+This accepts a string that will be sent to the tty or modem before sending
+anything else. It can be used to initialize a modem.
+
address@hidden @code{no-clear?} (predeterminado: @code{#f})
+When set to @code{#t}, agetty will not clear the screen before showing the
+login prompt.
+
address@hidden @code{login-program} (predeterminado: (file-append shadow
"/bin/login"))
+This must be either a gexp denoting the name of a log-in program, or unset,
+in which case the default value is the @command{login} from the Shadow tool
+suite.
+
address@hidden @code{local-line} (predeterminado: @code{#f})
+Control the CLOCAL line flag. This accepts one of three symbols as
+arguments, @code{'auto}, @code{'always}, or @code{'never}. If @code{#f}, the
+default value chosen by agetty is @code{'auto}.
+
address@hidden @code{extract-baud?} (predeterminado: @code{#f})
+When set to @code{#t}, instruct agetty to try to extract the baud rate from
+the status messages produced by certain types of modems.
+
address@hidden @code{skip-login?} (predeterminado: @code{#f})
+When set to @code{#t}, do not prompt the user for a login name. This can be
+used with @var{login-program} field to use non-standard login systems.
+
address@hidden @code{no-newline?} (predeterminado: @code{#f})
+When set to @code{#t}, do not print a newline before printing the
address@hidden/etc/issue} file.
+
address@hidden Is this dangerous only when used with login-program, or always?
address@hidden @code{login-options} (predeterminadas: @code{#f})
+This option accepts a string containing options that are passed to the login
+program. When used with the @var{login-program}, be aware that a malicious
+user could try to enter a login name containing embedded options that could
+be parsed by the login program.
+
address@hidden @code{login-pause} (predeterminada: @code{#f})
+When set to @code{#t}, wait for any key before showing the login prompt.
+This can be used in conjunction with @var{auto-login} to save memory by
+lazily spawning shells.
+
address@hidden @code{chroot} (predeterminado: @code{#f})
+Change root to the specified directory. This option accepts a directory
+path as a string.
+
address@hidden @code{hangup?} (predeterminado: @code{#f})
+Use the Linux system call @code{vhangup} to do a virtual hangup of the
+specified terminal.
+
address@hidden @code{keep-baud?} (predeterminado: @code{#f})
+When set to @code{#t}, try to keep the existing baud rate. The baud rates
+from @var{baud-rate} are used when agetty receives a @key{BREAK} character.
+
address@hidden @code{timeout} (predeterminado: @code{#f})
+When set to an integer value, terminate if no user name could be read within
address@hidden seconds.
+
address@hidden @code{detect-case?} (predeterminado: @code{#f})
+When set to @code{#t}, turn on support for detecting an uppercase-only
+terminal. This setting will detect a login name containing only uppercase
+letters as indicating an uppercase-only terminal and turn on some
+upper-to-lower case conversions. Note that this will not support Unicode
+characters.
+
address@hidden @code{wait-cr?} (predeterminado: @code{#f})
+When set to @code{#t}, wait for the user or modem to send a carriage-return
+or linefeed character before displaying @file{/etc/issue} or login prompt.
+This is typically used with the @var{init-string} option.
+
address@hidden @code{no-hints?} (predeterminado: @code{#f})
+When set to @code{#t}, do not print hints about Num, Caps, and Scroll locks.
+
address@hidden @code{no-hostname?} (predeterminado: @code{#f})
+By default, the hostname is printed. When this option is set to @code{#t},
+no hostname will be shown at all.
+
address@hidden @code{long-hostname?} (predeterminado: @code{#f})
+By default, the hostname is only printed until the first dot. When this
+option is set to @code{#t}, the fully qualified hostname by
address@hidden or @code{getaddrinfo} is shown.
+
address@hidden @code{erase-characters} (predeterminado: @code{#f})
+This option accepts a string of additional characters that should be
+interpreted as backspace when the user types their login name.
+
address@hidden @code{kill-characters} (predeterminado: @code{#f})
+This option accepts a string that should be interpreted to mean "ignore all
+previous characters" (also called a "kill" character) when the types their
+login name.
+
address@hidden @code{chdir} (predeterminado: @code{#f})
+This option accepts, as a string, a directory path that will be changed to
+before login.
+
address@hidden @code{delay} (predeterminado: @code{#f})
+This options accepts, as an integer, the number of seconds to sleep before
+opening the tty and displaying the login prompt.
+
address@hidden @code{nice} (predeterminado: @code{#f})
+This option accepts, as an integer, the nice value with which to run the
address@hidden program.
+
address@hidden @code{extra-options} (predeterminadas: @code{'()})
+This option provides an "escape hatch" for the user to provide arbitrary
+command-line arguments to @command{agetty} as a list of strings.
+
address@hidden table
address@hidden deftp
+
address@hidden {Procedimiento Scheme} kmscon-service-type @var{config}
+Return a service to run
address@hidden://www.freedesktop.org/wiki/Software/kmscon,kmscon} according to
address@hidden, a @code{<kmscon-configuration>} object, which specifies the
+tty to run, among other things.
address@hidden deffn
+
address@hidden {Tipo de datos} kmscon-configuration
+Este es el tipo de datos que representa la configuración de Kmscon, que
+implementa el ingreso al sistema en consolas virtuales.
+
address@hidden @asis
+
address@hidden @code{virtual-terminal}
+El sistema de la consola en la que se ejecuta este Kmscon---por ejemplo,
address@hidden"tty1"}.
+
address@hidden @code{login-program} (predeterminado: @code{#~(string-append
#$shadow "/bin/login")})
+A gexp denoting the name of the log-in program. The default log-in program
+is @command{login} from the Shadow tool suite.
+
address@hidden @code{login-arguments} (predeterminados: @code{'("-p")})
+A list of arguments to pass to @command{login}.
+
address@hidden @code{auto-login} (predeterminado: @code{#f})
+When passed a login name, as a string, the specified user will be logged in
+automatically without prompting for their login name or password.
+
address@hidden @code{hardware-acceleration?} (predeterminado: #f)
+Determina si se usará aceleración hardware.
+
address@hidden @code{kmscon} (predeterminado: @var{kmscon})
+El paquete Kmscon usado.
+
address@hidden table
address@hidden deftp
+
address@hidden daemon de caché del servicio de nombres
address@hidden nscd
address@hidden {Procedimiento Scheme} nscd-service address@hidden [#:glibc
glibc] @
+ [#:name-services '()]
+Devuelve un servicio que ejecuta el daemon de la caché del servicio de
+nombres (nscd) con la @var{configuración} proporcionada---un objeto
address@hidden<nscd-configuration>}. @xref{Selector de servicios de nombres},
para un ejemplo.
+
+Por conveniencia, el servicio ncsd de Shepherd proporciona las siguientes
+acciones:
+
address@hidden @code
address@hidden invalidate
address@hidden invalidación de caché, nscd
address@hidden nscd, invalidación de caché
+Esto invalida la caché dada. Por ejemplo, ejecutar:
+
address@hidden
+herd invalidate nscd hosts
address@hidden example
+
address@hidden
+invalida la caché de búsqueda de nombres de máquinas de nscd.
+
address@hidden statistics
+Ejecutar @command{herd statistics nscd} muestra información del uso nscd y
+la caché.
address@hidden table
+
address@hidden deffn
+
address@hidden {Variable Scheme} %nscd-default-configuration
+This is the default @code{<nscd-configuration>} value (see below) used by
address@hidden It uses the caches defined by
address@hidden; see below.
address@hidden defvr
+
address@hidden {Tipo de datos} nscd-configuration
+Este tipo de datos representa la configuración del daemon de caché del
+servicio de nombres (nscd).
+
address@hidden @asis
+
address@hidden @code{name-services} (predeterminados: @code{'()})
+List of packages denoting @dfn{name services} that must be visible to the
+nscd---e.g., @code{(list @var{nss-mdns})}.
+
address@hidden @code{glibc} (predeterminada: @var{glibc})
+Package object denoting the GNU C Library providing the @command{nscd}
+command.
+
address@hidden @code{log-file} (predeterminado: @code{"/var/log/nscd.log"})
+Name of the nscd log file. This is where debugging output goes when
address@hidden is strictly positive.
+
address@hidden @code{debug-level} (predeterminado: @code{0})
+Integer denoting the debugging levels. Higher numbers mean that more
+debugging output is logged.
+
address@hidden @code{caches} (predeterminadas: @var{%nscd-default-caches})
+List of @code{<nscd-cache>} objects denoting things to be cached; see below.
+
address@hidden table
address@hidden deftp
+
address@hidden {Tipo de datos} nscd-cache
+Tipo de datos que representa una base de datos de caché de nscd y sus
+parámetros.
+
address@hidden @asis
+
address@hidden @code{base de datos}
+This is a symbol representing the name of the database to be cached. Valid
+values are @code{passwd}, @code{group}, @code{hosts}, and @code{services},
+which designate the corresponding NSS database (@pxref{NSS Basics,,, libc,
+The GNU C Library Reference Manual}).
+
address@hidden @code{positive-time-to-live}
address@hidden @code{negative-time-to-live} (predeterminado: @code{20})
+A number representing the number of seconds during which a positive or
+negative lookup result remains in cache.
+
address@hidden @code{check-files?} (predeterminado: @code{#t})
+Whether to check for updates of the files corresponding to @var{database}.
+
+For instance, when @var{database} is @code{hosts}, setting this flag
+instructs nscd to check for updates in @file{/etc/hosts} and to take them
+into account.
+
address@hidden @code{persistent?} (predeterminada: @code{#t})
+Whether the cache should be stored persistently on disk.
+
address@hidden @code{shared?} (predeterminado: @code{#t})
+Whether the cache should be shared among users.
+
address@hidden @code{max-database-size} (predeterminado: address@hidden)
+Maximum size in bytes of the database cache.
+
address@hidden XXX: 'suggested-size' and 'auto-propagate?' seem to be expert
address@hidden settings, so leave them out.
+
address@hidden table
address@hidden deftp
+
address@hidden {Variable Scheme} %nscd-default-caches
+List of @code{<nscd-cache>} objects used by default by
address@hidden (see above).
+
+It enables persistent and aggressive caching of service and host name
+lookups. The latter provides better host name lookup performance,
+resilience in the face of unreliable name servers, and also better
+privacy---often the result of host name lookups is in local cache, so
+external name servers do not even need to be queried.
address@hidden defvr
+
address@hidden
address@hidden syslog
address@hidden logging
address@hidden {Tipo de datos} syslog-configuration
+Este tipo de datos representa la configuración del daemon syslog.
+
address@hidden @asis
address@hidden @code{syslogd} (predeterminado: @code{#~(string-append
#$inetutils "/libexec/syslogd")})
+El daemon syslog usado.
+
address@hidden @code{config-file} (predeterminado: @code{%default-syslog.conf})
+El fichero de configuración de syslog usado.
+
address@hidden table
address@hidden deftp
+
address@hidden
address@hidden syslog
address@hidden {Procedimiento Scheme} syslog-service @var{config}
+Return a service that runs a syslog daemon according to @var{config}.
+
address@hidden invocation,,, inetutils, GNU Inetutils}, para más información
+sobre la sintaxis del fichero de configuración.
address@hidden deffn
+
address@hidden {Variable Scheme} guix-service-type
+This is the type of the service that runs the build daemon,
address@hidden (@pxref{Invocación de guix-daemon}). Its value must be a
address@hidden record as described below.
address@hidden defvr
+
address@hidden
address@hidden {Tipo de datos} guix-configuration
+This data type represents the configuration of the Guix build daemon.
address@hidden de guix-daemon}, for more information.
+
address@hidden @asis
address@hidden @code{guix} (predeterminado: @var{guix})
+El paquete Guix usado.
+
address@hidden @code{build-group} (predeterminado: @code{"guixbuild"})
+El nombre del grupo de las cuentas de usuarias de construcción.
+
address@hidden @code{build-accounts} (predeterminadas: @code{10})
+Número de cuentas de usuarias de construcción a crear.
+
address@hidden @code{authorize-key?} (predeterminado: @code{#t})
address@hidden sustituciones, autorización de las mismas
+Determina si se autoriza las claves de sustituciones listadas en
address@hidden la de
address@hidden@value{SUBSTITUTE-SERVER}} (@pxref{Sustituciones}).
+
address@hidden %default-authorized-guix-keys
address@hidden @code{authorized-keys} (predeterminadas:
@var{%default-authorized-guix-keys})
+La lista de ficheros de claves autorizadas para importaciones de archivos,
+como una lista de expresiones-G que evalúan a cadenas (@pxref{Invocación de
guix archive}). Por defecto, contiene las de @address@hidden
+(@pxref{Sustituciones}).
+
address@hidden @code{use-substitutes?} (predeterminado: @code{#t})
+Determina si se usarán sustituciones.
+
address@hidden @code{substitute-urls} (predeterminado:
@var{%default-substitute-urls})
+La lista de URLs donde se buscarán sustituciones por defecto.
+
address@hidden @code{max-silent-time} (predeterminado: @code{0})
address@hidden @code{timeout} (predeterminado: @code{0})
+The number of seconds of silence and the number of seconds of activity,
+respectively, after which a build process times out. A value of zero
+disables the timeout.
+
address@hidden @code{log-compression} (predeterminado: @code{'bzip2})
+El tipo de compresión usado en los log de construcción---o bien @code{gzip},
+o bien @code{bzip2} o @code{none}.
+
address@hidden @code{extra-options} (predeterminadas: @code{'()})
+Lista de opciones de línea de órdenes adicionales para
address@hidden
+
address@hidden @code{log-file} (predeterminado:
@code{"/var/log/guix-daemon.log"})
+Fichero al que se escriben la salida estándar y la salida estándar de error
+de @command{guix-daemon}.
+
address@hidden @code{http-proxy} (predeterminado: @code{#f})
+El proxy HTTP que se usa para la descarga de derivaciones de salida fija y
+sustituciones.
+
address@hidden @code{tmpdir} (predeterminado: @code{#f})
+Una ruta de directorio donde @command{guix-daemon} realiza las
+construcciones.
+
address@hidden table
address@hidden deftp
+
address@hidden {Procedimiento Scheme} udev-service [#:udev @var{eudev} #:rules
@code{'()}]
+Run @var{udev}, which populates the @file{/dev} directory dynamically. udev
+rules can be provided as a list of files through the @var{rules} variable.
+The procedures @var{udev-rule} and @var{file->udev-rule} from @code{(gnu
+services base)} simplify the creation of such rule files.
address@hidden deffn
+
address@hidden {Procedimiento Scheme} udev-rule address@hidden @var{contenido}]
+Devuelve un fichero de reglas de udev con nombre @var{nombre-fichero} que
+contiene las reglas definidas en el literal @var{contenido}.
+
+En el ejemplo siguiente se define una regla para un dispositivo USB que será
+almacenada en el fichero @file{90-usb-cosa.rules}. Esta regla ejecuta un
+script cuando se detecta un dispositivo USB con un identificador de producto
+dado.
+
address@hidden
+(define %regla-ejemplo-udev
+ (udev-rule
+ "90-usb-cosa.rules"
+ (string-append "ACTION==\"add\", SUBSYSTEM==\"usb\", "
+ "address@hidden@}==\"Ejemplo\", "
+ "RUN+=\"/ruta/al/ejecutable\"")))
address@hidden example
+
+The @command{herd rules udev} command, as root, returns the name of the
+directory containing all the active udev rules.
address@hidden deffn
+
+Here we show how the default @var{udev-service} can be extended with it.
+
address@hidden
+(operating-system
+ ;; @dots{}
+ (services
+ (modify-services %desktop-services
+ (udev-service-type config =>
+ (udev-configuration (inherit config)
+ (rules (append (udev-configuration-rules config)
+ (list %regla-ejemplo-udev))))))))
address@hidden example
+
address@hidden {Procedimiento Scheme} file->udev-rule address@hidden
@var{fichero}]
+Devuelve un fichero de udev con nombre @var{nombre-fichero} que contiene las
+reglas definidas en @var{fichero}, un objeto tipo-fichero.
+
+El ejemplo siguiente muestra cómo podemos usar un fichero de reglas
+existente.
+
address@hidden
+(use-modules (guix download) ;para url-fetch
+ (guix packages) ;para origin
+ ;; @dots{})
+
+(define %reglas-android-udev
+ (file->udev-rule
+ "51-android-udev.rules"
+ (let ((version "20170910"))
+ (origin
+ (method url-fetch)
+ (uri (string-append "https://raw.githubusercontent.com/M0Rf30/";
+ "android-udev-rules/" version "/51-android.rules"))
+ (sha256
+ (base32 "0lmmagpyb6xsq6zcr2w1cyx9qmjqmajkvrdbhjx32gqf1d9is003"))))))
address@hidden example
address@hidden deffn
+
+Adicionalmente, las definiciones de paquete Gui pueden ser incluidas en
address@hidden para extender las reglas udev con las definiciones encontradas
+bajo su subdirectorio @file{lib/udev/rules.d}. En vez del ejemplo previo de
address@hidden>udev-rule}, podíamos haber usado el paquete
address@hidden que existe en Guix en el módulo @code{(gnu packages
+android)}.
+
+El siguiente ejemplo muestra cómo usar el paquete @var{android-udev-rules}
+para que la herramienta de Android @command{adb} pueda detectar dispositivos
+sin privilegios de root. También detalla como crear el grupo
address@hidden, el cual se requiere para el funcionamiento correcto de las
+reglas definidas dentro del paquete @var{android-udev-rules}. Para crear tal
+grupo, debemos definirlo tanto como parte de @var{supplementary-groups} de
+la declaración de nuestra cuenta de usuaria @var{user-account}, así como en
+el campo @var{groups} del registro @var{operating-system}.
+
address@hidden
+(use-modules (gnu packages android) ;para android-udev-rules
+ (gnu system shadow) ;para user-group
+ ;; @dots{})
+
+(operating-system
+ ;; @dots{}
+ (users (cons (user-acount
+ ;; @dots{}
+ (supplementary-groups
+ '("adbusers" ;para adb
+ "wheel" "netdev" "audio" "video"))
+ ;; @dots{})))
+
+ (groups (cons (user-group (system? #t) (name "adbusers"))
+ %base-groups))
+
+ ;; @dots{}
+
+ (services
+ (modify-services %desktop-services
+ (udev-service-type
+ config =>
+ (udev-configuration (inherit config)
+ (rules (cons android-udev-rules
+ (udev-configuration-rules config))))))))
address@hidden example
+
address@hidden {Variable Scheme} urandom-seed-service-type
+Save some entropy in @var{%random-seed-file} to seed @file{/dev/urandom}
+when rebooting. It also tries to seed @file{/dev/urandom} from
address@hidden/dev/hwrng} while booting, if @file{/dev/hwrng} exists and is
+readable.
address@hidden defvr
+
address@hidden {Variable Scheme} %random-seed-file
+This is the name of the file where some random bytes are saved by
address@hidden to seed @file{/dev/urandom} when rebooting. It
+defaults to @file{/var/lib/random-seed}.
address@hidden defvr
+
address@hidden ratón
address@hidden gpm
address@hidden {Variable Scheme} gpm-service-type
+This is the type of the service that runs GPM, the @dfn{general-purpose
+mouse daemon}, which provides mouse support to the Linux console. GPM
+allows users to use the mouse in the console, notably to select, copy, and
+paste text.
+
+The value for services of this type must be a @code{gpm-configuration} (see
+below). This service is not part of @var{%base-services}.
address@hidden defvr
+
address@hidden {Tipo de datos} gpm-configuration
+Tipo de datos que representa la configuración de GPM.
+
address@hidden @asis
address@hidden @code{opciones} (predeterminadas: @code{%default-gpm-options})
+Command-line options passed to @command{gpm}. The default set of options
+instruct @command{gpm} to listen to mouse events on @file{/dev/input/mice}.
address@hidden Line,,, gpm, gpm manual}, for more information.
+
address@hidden @code{gpm} (predeterminado: @code{gpm})
+El paquete GPM usado.
+
address@hidden table
address@hidden deftp
+
address@hidden
address@hidden {Variable Scheme} guix-publish-service-type
+This is the service type for @command{guix publish} (@pxref{Invocación de guix
publish}). Its value must be a @code{guix-configuration} object, as
+described below.
+
+This assumes that @file{/etc/guix} already contains a signing key pair as
+created by @command{guix archive --generate-key} (@pxref{Invocación de guix
archive}). If that is not the case, the service will fail to start.
address@hidden deffn
+
address@hidden {Tipo de datos} guix-publish-configuration
+Tipo de datos que representa la configuración del servicio @code{guix
+publish}.
+
address@hidden @asis
address@hidden @code{guix} (predeterminado: @code{guix})
+El paquete Guix usado.
+
address@hidden @code{port} (predeterminado: @code{80})
+El puerto TCP en el que se esperan conexiones.
+
address@hidden @code{host} (predeterminado: @code{"localhost"})
+The host (and thus, network interface) to listen to. Use @code{"0.0.0.0"}
+to listen on all the network interfaces.
+
address@hidden @code{compression-level} (predeterminado: @code{3})
+The gzip compression level at which substitutes are compressed. Use
address@hidden to disable compression altogether, and @code{9} to get the best
+compression ratio at the expense of increased CPU usage.
+
address@hidden @code{nar-path} (predeterminado: @code{"nar"})
+The URL path at which ``nars'' can be fetched. @xref{Invocación de guix
publish,
address@hidden, for details.
+
address@hidden @code{cache} (predeterminado: @code{#f})
+When it is @code{#f}, disable caching and instead generate archives on
+demand. Otherwise, this should be the name of a directory---e.g.,
address@hidden"/var/cache/guix/publish"}---where @command{guix publish} caches
+archives and meta-data ready to be sent. @xref{Invocación de guix publish,
address@hidden, for more information on the tradeoffs involved.
+
address@hidden @code{workers} (predeterminado: @code{#f})
+When it is an integer, this is the number of worker threads used for
+caching; when @code{#f}, the number of processors is used. @xref{Invocación
de guix publish, @option{--workers}}, for more information.
+
address@hidden @code{ttl} (predeterminado: @code{#f})
+When it is an integer, this denotes the @dfn{time-to-live} in seconds of the
+published archives. @xref{Invocación de guix publish, @option{--ttl}}, for
more
+information.
address@hidden table
address@hidden deftp
+
address@hidden
address@hidden {Procedimiento Scheme} rngd-service [#:rng-tools
@var{rng-tools}] @
+ [#:device "/dev/hwrng"] Return a service that runs the
@command{rngd}
+program from @var{rng-tools} to add @var{device} to the kernel's entropy
+pool. The service will fail if @var{device} does not exist.
address@hidden deffn
+
address@hidden
address@hidden límites por sesión
address@hidden ulimit
address@hidden prioridad
address@hidden tiempo real
address@hidden jackd
address@hidden {Procedimiento Scheme} pam-limits-service [#:limits @code{'()}]
+
+Return a service that installs a configuration file for the
address@hidden://linux-pam.org/Linux-PAM-html/sag-pam_limits.html,
address@hidden module}. The procedure optionally takes a list of
address@hidden values, which can be used to specify @code{ulimit}
+limits and nice priority limits to user sessions.
+
+The following limits definition sets two hard and soft limits for all login
+sessions of users in the @code{realtime} group:
+
address@hidden
+(pam-limits-service
+ (list
+ (pam-limits-entry "@@realtime" 'both 'rtprio 99)
+ (pam-limits-entry "@@realtime" 'both 'memlock 'unlimited)))
address@hidden example
+
+The first entry increases the maximum realtime priority for non-privileged
+processes; the second entry lifts any restriction of the maximum address
+space that can be locked in memory. These settings are commonly used for
+real-time audio systems.
address@hidden deffn
+
address@hidden Ejecución de tareas programadas
address@hidden Ejecución de tareas programadas
+
address@hidden cron
address@hidden mcron
address@hidden scheduling jobs
+The @code{(gnu services mcron)} module provides an interface to
address@hidden, a daemon to run jobs at scheduled times (@pxref{Top,,,
+mcron, address@hidden). address@hidden is similar to the traditional Unix
address@hidden daemon; the main difference is that it is implemented in
+Guile Scheme, which provides a lot of flexibility when specifying the
+scheduling of jobs and their actions.
+
+The example below defines an operating system that runs the
address@hidden (@pxref{Invoking updatedb,,, find, Finding Files}) and
+the @command{guix gc} commands (@pxref{Invocación de guix gc}) daily, as well
as
+the @command{mkid} command on behalf of an unprivileged user (@pxref{mkid
+invocation,,, idutils, ID Database Utilities}). It uses gexps to introduce
+job definitions that are passed to mcron (@pxref{Expresiones-G}).
+
address@hidden
+(use-modules (guix) (gnu) (gnu services mcron))
+(use-package-modules base idutils)
+
+(define trabajo-updatedb
+ ;; Ejecuta 'updatedb' a las 3AM cada día. Aquí escribimos
+ ;; las acciones del trabajo como un procedimiento Scheme.
+ #~(job '(next-hour '(3))
+ (lambda ()
+ (execl (string-append #$findutils "/bin/updatedb")
+ "updatedb"
+ "--prunepaths=/tmp /var/tmp /gnu/store"))))
+
+(define trabajo-recolector-basura
+ ;; Recolecta basura 5 minutos después de media noche,
+ ;; todos los días. La acción del trabajo es una orden
+ ;; del shell.
+ #~(job "5 0 * * *" ;sintaxis de Vixie cron
+ "guix gc -F 1G"))
+
+(define trabajo-idutils
+ ;; Actualiza el índice de la base de datos como "carlos" a las
+ ;; 12:15 y a las 19:15. Esto se ejecuta desde su directorio.
+ #~(job '(next-minute-from (next-hour '(12 19)) '(15))
+ (string-append #$idutils "/bin/mkid src")
+ #:user "carlos"))
+
+(operating-system
+ ;; @dots{}
+ (services (cons (service mcron-service-type
+ (mcron-configuration
+ (jobs (list trabajo-recolector-basura
+ trabajo-updatedb
+ trabajo-idutils))))
+ %base-services)))
address@hidden lisp
+
address@hidden Syntax, mcron job specifications,, mcron, address@hidden, for
+more information on mcron job specifications. Below is the reference of the
+mcron service.
+
+On a running system, you can use the @code{schedule} action of the service
+to visualize the mcron jobs that will be executed next:
+
address@hidden
+# herd schedule mcron
address@hidden example
+
address@hidden
+The example above lists the next five tasks that will be executed, but you
+can also specify the number of tasks to display:
+
address@hidden
+# herd schedule mcron 10
address@hidden example
+
address@hidden {Variable Scheme} mcron-service-type
+This is the type of the @code{mcron} service, whose value is an
address@hidden object.
+
+This service type can be the target of a service extension that provides it
+additional job specifications (@pxref{Composición de servicios}). In other
+words, it is possible to define services that provide additional mcron jobs
+to run.
address@hidden defvr
+
address@hidden {Tipo de datos} mcron-configuration
+Tipo de datos que representa la configuración de mcron.
+
address@hidden @asis
address@hidden @code{mcron} (predeterminado: @var{mcron})
+El paquete mcron usado.
+
address@hidden @code{jobs}
+This is a list of gexps (@pxref{Expresiones-G}), where each gexp corresponds
+to an mcron job specification (@pxref{Syntax, mcron job specifications,,
+mcron, address@hidden).
address@hidden table
address@hidden deftp
+
+
address@hidden Rotación de logs
address@hidden Rotación de logs
+
address@hidden rottlog
address@hidden rotación de logs
address@hidden logging
+Log files such as those found in @file{/var/log} tend to grow endlessly, so
+it's a good idea to @dfn{rotate} them once in a while---i.e., archive their
+contents in separate files, possibly compressed. The @code{(gnu services
+admin)} module provides an interface to address@hidden, a log rotation
+tool (@pxref{Top,,, rottlog, GNU Rot[t]log Manual}).
+
+The example below defines an operating system that provides log rotation
+with the default settings, for commonly encountered log files.
+
address@hidden
+(use-modules (guix) (gnu))
+(use-service-modules admin mcron)
+(use-package-modules base idutils)
+
+(operating-system
+ ;; @dots{}
+ (services (cons (service rottlog-service-type)
+ %base-services)))
address@hidden lisp
+
address@hidden {Variable Scheme} rottlog-service-type
+This is the type of the Rottlog service, whose value is a
address@hidden object.
+
+Other services can extend this one with new @code{log-rotation} objects (see
+below), thereby augmenting the set of files to be rotated.
+
+This service type can define mcron jobs (@pxref{Ejecución de tareas
programadas}) to
+run the rottlog service.
address@hidden defvr
+
address@hidden {Tipo de datos} rottlog-configuration
+Tipo de datos que representa la configuración de rottlog.
+
address@hidden @asis
address@hidden @code{rottlog} (predeterminado: @code{rottlog})
+El paquete Rottlog usado.
+
address@hidden @code{rc-file} (predeterminado: @code{(file-append rottlog
"/etc/rc")})
+The Rottlog configuration file to use (@pxref{Mandatory RC Variables,,,
+rottlog, GNU Rot[t]log Manual}).
+
address@hidden @code{rotations} (predeterminadas: @code{%default-rotations})
+A list of @code{log-rotation} objects as defined below.
+
address@hidden @code{jobs}
+This is a list of gexps where each gexp corresponds to an mcron job
+specification (@pxref{Ejecución de tareas programadas}).
address@hidden table
address@hidden deftp
+
address@hidden {Tipo de datos} log-rotation
+Tipo de datos que representa la rotación de un grupo de ficheros de log.
+
+Taking an example from the Rottlog manual (@pxref{Period Related File
+Examples,,, rottlog, GNU Rot[t]log Manual}), a log rotation might be defined
+like this:
+
address@hidden
+(log-rotation
+ (frequency 'daily)
+ (files '("/var/log/apache/*"))
+ (options '("storedir apache-archives"
+ "rotate 6"
+ "notifempty"
+ "nocompress")))
address@hidden example
+
+La lista de campos es como sigue:
+
address@hidden @asis
address@hidden @code{frequency} (predeterminada: @code{'weekly})
+La frecuencia de rotación de logs, un símbolo.
+
address@hidden @code{files}
+La lista de ficheros o patrones extendidos de fichero a rotar.
+
address@hidden @code{options} (predeterminadas: @code{'()})
+The list of rottlog options for this rotation (@pxref{Configuration
+parameters,,, rottlog, GNU Rot[t]lg Manual}).
+
address@hidden @code{post-rotate} (predeterminado: @code{#f})
+Either @code{#f} or a gexp to execute once the rotation has completed.
address@hidden table
address@hidden deftp
+
address@hidden {Variable Scheme} %default-rotations
+Specifies weekly rotation of @var{%rotated-files} and a couple of other
+files.
address@hidden defvr
+
address@hidden {Variable Scheme} %rotated-files
+The list of syslog-controlled files to be rotated. By default it is:
address@hidden'("/var/log/messages" "/var/log/secure")}.
address@hidden defvr
+
address@hidden Servicios de red
address@hidden Servicios de red
+
+El módulo @code{(gnu services networking)} proporciona servicios para
+configurar la interfaz de red.
+
address@hidden DHCP, servicio de red
address@hidden {Variable Scheme} dhcp-client-service-type
+This is the type of services that run @var{dhcp}, a Dynamic Host
+Configuration Protocol (DHCP) client, on all the non-loopback network
+interfaces. Its value is the DHCP client package to use, @code{isc-dhcp} by
+default.
address@hidden defvr
+
address@hidden {Procedimiento Scheme} dhcpd-service-type
+This type defines a service that runs a DHCP daemon. To create a service of
+this type, you must supply a @code{<dhcpd-configuration>}. For example:
+
address@hidden
+(service dhcpd-service-type
+ (dhcpd-configuration
+ (config-file (local-file "mi-dhcpd.conf"))
+ (interfaces '("enp0s25"))))
address@hidden example
address@hidden deffn
+
address@hidden {Tipo de datos} dhcpd-configuration
address@hidden @asis
address@hidden @code{package} (predeterminado: @code{isc-dhcp})
+The package that provides the DHCP daemon. This package is expected to
+provide the daemon at @file{sbin/dhcpd} relative to its output directory.
+The default package is the @uref{http://www.isc.org/products/DHCP, ISC's
+DHCP server}.
address@hidden @code{config-file} (predeterminado: @code{#f})
+The configuration file to use. This is required. It will be passed to
address@hidden via its @code{-cf} option. This may be any ``file-like''
+object (@pxref{Expresiones-G, file-like objects}). See @code{man
+dhcpd.conf} for details on the configuration file syntax.
address@hidden @code{version} (predeterminada: @code{"4"})
+The DHCP version to use. The ISC DHCP server supports the values ``4'',
+``6'', and ``4o6''. These correspond to the @code{dhcpd} program options
address@hidden, @code{-6}, and @code{-4o6}. See @code{man dhcpd} for details.
address@hidden @code{run-directory} (predeterminado: @code{"/run/dhcpd"})
+The run directory to use. At service activation time, this directory will
+be created if it does not exist.
address@hidden @code{pid-file} (predeterminado: @code{"/run/dhcpd/dhcpd.pid"})
+The PID file to use. This corresponds to the @code{-pf} option of
address@hidden See @code{man dhcpd} for details.
address@hidden @code{interfaces} (predeterminadas: @code{'()})
+The names of the network interfaces on which dhcpd should listen for
+broadcasts. If this list is not empty, then its elements (which must be
+strings) will be appended to the @code{dhcpd} invocation when starting the
+daemon. It may not be necessary to explicitly specify any interfaces here;
+see @code{man dhcpd} for details.
address@hidden table
address@hidden deftp
+
address@hidden {Variable Scheme} static-networking-service-type
address@hidden TODO Document <static-networking> data structures.
+This is the type for statically-configured network interfaces.
address@hidden defvr
+
address@hidden {Procedimiento Scheme} static-networking-service @var{interfaz}
@var{ip} @
+ [#:netmask #f] [#:gateway #f] [#:name-servers @code{'()}] @
[#:requirement
address@hidden'(udev)}] Return a service that starts @var{interface} with
address
address@hidden If @var{netmask} is true, use it as the network mask. If
address@hidden is true, it must be a string specifying the default network
+gateway. @var{requirement} can be used to declare a dependency on another
+service before configuring the interface.
+
+This procedure can be called several times, one for each network interface
+of interest. Behind the scenes what it does is extend
address@hidden with additional network interfaces to
+handle.
+
+Por ejemplo:
+
address@hidden
+(static-networking-service "eno1" "192.168.1.82"
+ #:gateway "192.168.1.2"
+ #:name-servers '("192.168.1.2"))
address@hidden example
address@hidden deffn
+
address@hidden wicd
address@hidden sin cables
address@hidden WiFi
address@hidden gestión de red
address@hidden {Procedimiento Scheme} wicd-service [#:wicd @var{wicd}]
+Return a service that runs @url{https://launchpad.net/wicd,Wicd}, a network
+management daemon that aims to simplify wired and wireless networking.
+
+This service adds the @var{wicd} package to the global profile, providing
+several commands to interact with the daemon and configure networking:
address@hidden, a graphical user interface, and the
address@hidden and @command{wicd-curses} user interfaces.
address@hidden deffn
+
address@hidden ModemManager
+
address@hidden {Variable Scheme} modem-manager-service-type
+This is the service type for the
address@hidden://wiki.gnome.org/Projects/ModemManager, ModemManager}
+service. The value for this service type is a
address@hidden record.
+
+Este servicio es parte de @code{%desktop-services} (@pxref{Servicios de
escritorio}).
address@hidden defvr
+
address@hidden {Tipo de datos} modem-manager-configuration
+Tipo de datos que representa la configuración de ModemManager.
+
address@hidden @asis
address@hidden @code{modem-manager} (predeterminado: @code{modem-manager})
+El paquete de ModemManager usado.
+
address@hidden table
address@hidden deftp
+
address@hidden NetworkManager
+
address@hidden {Variable Scheme} network-manager-service-type
+This is the service type for the
address@hidden://wiki.gnome.org/Projects/NetworkManager, NetworkManager}
+service. The value for this service type is a
address@hidden record.
+
+Este servicio es parte de @code{%desktop-services} (@pxref{Servicios de
escritorio}).
address@hidden defvr
+
address@hidden {Tipo de datos} network-manager-configuration
+Tipo de datos que representa la configuración de NetworkManager.
+
address@hidden @asis
address@hidden @code{network-manager} (predeterminado: @code{network-manager})
+El paquete de NetworkManager usado.
+
address@hidden @code{dns} (predeterminado: @code{"default"})
+Processing mode for DNS, which affects how NetworkManager uses the
address@hidden configuration file.
+
address@hidden @samp
address@hidden default
+NetworkManager will update @code{resolv.conf} to reflect the nameservers
+provided by currently active connections.
+
address@hidden dnsmasq
+NetworkManager will run @code{dnsmasq} as a local caching nameserver, using
+a "split DNS" configuration if you are connected to a VPN, and then update
address@hidden to point to the local nameserver.
+
address@hidden none
+NetworkManager will not modify @code{resolv.conf}.
address@hidden table
+
address@hidden @code{vpn-plugins} (predeterminados: @code{'()})
+This is the list of available plugins for virtual private networks (VPNs).
+An example of this is the @code{network-manager-openvpn} package, which
+allows NetworkManager to manage VPNs @i{via} OpenVPN.
+
address@hidden table
address@hidden deftp
+
address@hidden Connman
address@hidden {Variable Scheme} connman-service-type
+This is the service type to run @url{https://01.org/connman,Connman}, a
+network connection manager.
+
+Its value must be an @code{connman-configuration} record as in this example:
+
address@hidden
+(service connman-service-type
+ (connman-configuration
+ (disable-vpn? #t)))
address@hidden example
+
+See below for details about @code{connman-configuration}.
address@hidden deffn
+
address@hidden {Tipo de datos} connman-configuration
+Tipo de datos que representa la configuración de connman.
+
address@hidden @asis
address@hidden @code{connman} (predeterminado: @var{connman})
+El paquete connman usado.
+
address@hidden @code{disable-vpn?} (predeterminado: @code{#f})
+Cuando es verdadero, deshabilita el módulo vpn de connman.
address@hidden table
address@hidden deftp
+
address@hidden WPA Supplicant
address@hidden {Variable Scheme} wpa-supplicant-service-type
+This is the service type to run @url{https://w1.fi/wpa_supplicant/,WPA
+supplicant}, an authentication daemon required to authenticate against
+encrypted WiFi or ethernet networks.
address@hidden defvr
+
address@hidden {Tipo de datos} wpa-supplicant-configuration
+Tipo de datos que representa la configuración de WPA Supplicant.
+
+Toma los siguientes parámetros:
+
address@hidden @asis
address@hidden @code{wpa-supplicant} (predeterminado: @code{wpa-supplicant})
+El paquete de WPA Supplicant usado.
+
address@hidden @code{dbus?} (predeterminado: @code{#t})
+Si se escuchan o no peticiones en D-Bus.
+
address@hidden @code{pid-file} (predeterminado:
@code{"/var/run/wpa_supplicant.pid"})
+Dónde se almacena el fichero con el PID.
+
address@hidden @code{interface} (predeterminado: @code{#f})
+If this is set, it must specify the name of a network interface that WPA
+supplicant will control.
+
address@hidden @code{config-file} (predeterminado: @code{#f})
+Fichero de configuración opcional usado.
+
address@hidden @code{extra-options} (predeterminadas: @code{'()})
+Lista de parámetros adicionales a pasar al daemon en la línea de órdenes.
address@hidden table
address@hidden deftp
+
address@hidden iptables
address@hidden {Variable Scheme} iptables-service-type
+This is the service type to set up an iptables configuration. iptables is a
+packet filtering framework supported by the Linux kernel. This service
+supports configuring iptables for both IPv4 and IPv6. A simple example
+configuration rejecting all incoming connections except those to the ssh
+port 22 is shown below.
+
address@hidden
+(service iptables-service-type
+ (iptables-configuration
+ (ipv4-rules (plain-file "iptables.rules" "*filter
+:INPUT ACCEPT
+:FORWARD ACCEPT
+:OUTPUT ACCEPT
+-A INPUT -p tcp --dport 22 -j ACCEPT
+-A INPUT -j REJECT --reject-with icmp-port-unreachable
+COMMIT
+"))
+ (ipv6-rules (plain-file "ip6tables.rules" "*filter
+:INPUT ACCEPT
+:FORWARD ACCEPT
+:OUTPUT ACCEPT
+-A INPUT -p tcp --dport 22 -j ACCEPT
+-A INPUT -j REJECT --reject-with icmp6-port-unreachable
+COMMIT
+"))))
address@hidden lisp
address@hidden defvr
+
address@hidden {Tipo de datos} iptables-configuration
+El tipo de datos que representa la configuración de iptables.
+
address@hidden @asis
address@hidden @code{iptables} (predeterminado: @code{iptables})
+The iptables package that provides @code{iptables-restore} and
address@hidden
address@hidden @code{ipv4-rules} (predeterminado:
@code{%iptables-accept-all-rules})
+The iptables rules to use. It will be passed to @code{iptables-restore}.
+This may be any ``file-like'' object (@pxref{Expresiones-G, file-like
+objects}).
address@hidden @code{ipv6-rules} (predeterminadas:
@code{%iptables-accept-all-rules})
+The ip6tables rules to use. It will be passed to @code{ip6tables-restore}.
+This may be any ``file-like'' object (@pxref{Expresiones-G, file-like
+objects}).
address@hidden table
address@hidden deftp
+
address@hidden NTP (protocolo de tiempo de red), servicio
address@hidden reloj de tiempo real
address@hidden {Variable Scheme} ntp-service-type
+This is the type of the service running the @uref{http://www.ntp.org,
+Network Time Protocol (NTP)} daemon, @command{ntpd}. The daemon will keep
+the system clock synchronized with that of the specified NTP servers.
+
+The value of this service is an @code{ntpd-configuration} object, as
+described below.
address@hidden defvr
+
address@hidden {Tipo de datos} ntp-configuration
+Este es el tipo de datos para la configuración del servicio NTP.
+
address@hidden @asis
address@hidden @code{servers} (predeterminados: @code{%ntp-servers})
+This is the list of servers (host names) with which @command{ntpd} will be
+synchronized.
+
address@hidden @code{allow-large-adjustment?} (predeterminado: @code{#f})
+This determines whether @command{ntpd} is allowed to make an initial
+adjustment of more than 1,000 seconds.
+
address@hidden @code{ntp} (predeterminado: @code{ntp})
+El paquete NTP usado.
address@hidden table
address@hidden deftp
+
address@hidden {Variable Scheme} %ntp-servers
+List of host names used as the default NTP servers. These are servers of
+the @uref{https://www.ntppool.org/en/, NTP Pool Project}.
address@hidden defvr
+
address@hidden OpenNTPD
address@hidden {Procedimiento Scheme} openntpd-service-type
+Run the @command{ntpd}, the Network Time Protocol (NTP) daemon, as
+implemented by @uref{http://www.openntpd.org, OpenNTPD}. The daemon will
+keep the system clock synchronized with that of the given servers.
+
address@hidden
+(service
+ openntpd-service-type
+ (openntpd-configuration
+ (listen-on '("127.0.0.1" "::1"))
+ (sensor '("udcf0 correction 70000"))
+ (constraint-from '("www.gnu.org"))
+ (constraints-from '("https://www.google.com/";))
+ (allow-large-adjustment? #t)))
+
address@hidden example
address@hidden deffn
+
address@hidden {Tipo de datos} openntpd-configuration
address@hidden @asis
address@hidden @code{openntpd} (predeterminado: @code{(file-append openntpd
"/sbin/ntpd")})
+El ejecutable openntpd usado.
address@hidden @code{listen-on} (predeterminadas: @code{'("127.0.0.1" "::1")})
+Una lista de direcciones IP o nombres de máquina en los que el daemon ntpd
+debe escuchar conexiones.
address@hidden @code{query-from} (predeterminadas: @code{'()})
+Una lista de direcciones IP locales que el daemon ntpd debe usar para
+consultas salientes.
address@hidden @code{sensor} (predeterminados: @code{'()})
+Specify a list of timedelta sensor devices ntpd should use. @code{ntpd}
+will listen to each sensor that acutally exists and ignore non-existant
+ones. See @uref{https://man.openbsd.org/ntpd.conf, upstream documentation}
+for more information.
address@hidden @code{server} (predeterminadas: @var{%ntp-servers})
+Specify a list of IP addresses or hostnames of NTP servers to synchronize
+to.
address@hidden @code{servers} (predeterminados: @code{'()})
+Specify a list of IP addresses or hostnames of NTP pools to synchronize to.
address@hidden @code{constraint-from} (predeterminado: @code{'()})
address@hidden can be configured to query the ‘Date’ from trusted HTTPS servers
+via TLS. This time information is not used for precision but acts as an
+authenticated constraint, thereby reducing the impact of unauthenticated NTP
+man-in-the-middle attacks. Specify a list of URLs, IP addresses or
+hostnames of HTTPS servers to provide a constraint.
address@hidden @code{constraints-from} (predeterminadas: @code{'()})
+As with constraint from, specify a list of URLs, IP addresses or hostnames
+of HTTPS servers to provide a constraint. Should the hostname resolve to
+multiple IP addresses, @code{ntpd} will calculate a median constraint from
+all of them.
address@hidden @code{allow-large-adjustment?} (predeterminado: @code{#f})
+Determines if @code{ntpd} is allowed to make an initial adjustment of more
+than 180 seconds.
address@hidden table
address@hidden deftp
+
address@hidden inetd
address@hidden {Variable Scheme} inetd-service-type
+This service runs the @command{inetd} (@pxref{inetd invocation,,, inetutils,
+GNU Inetutils}) daemon. @command{inetd} listens for connections on internet
+sockets, and lazily starts the specified server program when a connection is
+made on one of these sockets.
+
+The value of this service is an @code{inetd-configuration} object. The
+following example configures the @command{inetd} daemon to provide the
+built-in @command{echo} service, as well as an smtp service which forwards
+smtp traffic over ssh to a server @code{smtp-server} behind a gateway
address@hidden:
+
address@hidden
+(service
+ inetd-service-type
+ (inetd-configuration
+ (entries (list
+ (inetd-entry
+ (name "echo")
+ (socket-type 'stream)
+ (protocol "tcp")
+ (wait? #f)
+ (user "root"))
+ (inetd-entry
+ (node "127.0.0.1")
+ (name "smtp")
+ (socket-type 'stream)
+ (protocol "tcp")
+ (wait? #f)
+ (user "root")
+ (program (file-append openssh "/bin/ssh"))
+ (arguments
+ '("ssh" "-qT" "-i" "/ruta/a/la/clave_ssh"
+ "-W" "smtp-server:25" "usuaria@@máquina")))))
address@hidden example
+
+See below for more details about @code{inetd-configuration}.
address@hidden deffn
+
address@hidden {Tipo de datos} inetd-configuration
+Tipo de datos que representa la configuración de @command{inetd}.
+
address@hidden @asis
address@hidden @code{program} (predeterminado: @code{(file-append inetutils
"/libexec/inetd")})
+El ejecutable @command{inetd} usado.
+
address@hidden @code{entries} (predeterminadas: @code{'()})
+A list of @command{inetd} service entries. Each entry should be created by
+the @code{inetd-entry} constructor.
address@hidden table
address@hidden deftp
+
address@hidden {Tipo de datos} inetd-entry
+Data type representing an entry in the @command{inetd} configuration. Each
+entry corresponds to a socket where @command{inetd} will listen for
+requests.
+
address@hidden @asis
address@hidden @code{node} (predeterminado: @code{#f})
+Optional string, a comma-separated list of local addresses @command{inetd}
+should use when listening for this service. @xref{Configuration file,,,
+inetutils, GNU Inetutils} for a complete description of all options.
address@hidden @code{name}
+A string, the name must correspond to an entry in @code{/etc/services}.
address@hidden @code{socket-type}
+One of @code{'stream}, @code{'dgram}, @code{'raw}, @code{'rdm} or
address@hidden'seqpacket}.
address@hidden @code{protocol}
+A string, must correspond to an entry in @code{/etc/protocols}.
address@hidden @code{wait?} (predeterminado: @code{#t})
+Whether @command{inetd} should wait for the server to exit before listening
+to new service requests.
address@hidden @code{user}
+A string containing the user (and, optionally, group) name of the user as
+whom the server should run. The group name can be specified in a suffix,
+separated by a colon or period, i.e.@: @code{"user"}, @code{"user:group"} or
address@hidden"user.group"}.
address@hidden @code{program} (predeterminado: @code{"internal"})
+The server program which will serve the requests, or @code{"internal"} if
address@hidden should use a built-in service.
address@hidden @code{arguments} (predeterminados: @code{'()})
+A list strings or file-like objects, which are the server program's
+arguments, starting with the zeroth argument, i.e.@: the name of the program
+itself. For @command{inetd}'s internal services, this entry must be
address@hidden'()} or @code{'("internal")}.
address@hidden table
+
address@hidden file,,, inetutils, GNU Inetutils} for a more detailed
+discussion of each configuration field.
address@hidden deftp
+
address@hidden Tor
address@hidden {Variable Scheme} tor-service-type
+This is the type for a service that runs the @uref{https://torproject.org,
+Tor} anonymous networking daemon. The service is configured using a
address@hidden<tor-configuration>} record. By default, the Tor daemon runs as
the
address@hidden unprivileged user, which is a member of the @code{tor} group.
+
address@hidden defvr
+
address@hidden {Tipo de datos} tor-configuration
address@hidden @asis
address@hidden @code{tor} (predeterminado: @code{tor})
+The package that provides the Tor daemon. This package is expected to
+provide the daemon at @file{bin/tor} relative to its output directory. The
+default package is the @uref{https://www.torproject.org, Tor Project's}
+implementation.
+
address@hidden @code{config-file} (predeterminado: @code{(plain-file "empty"
"")})
+The configuration file to use. It will be appended to a default
+configuration file, and the final configuration file will be passed to
address@hidden via its @code{-f} option. This may be any ``file-like'' object
+(@pxref{Expresiones-G, file-like objects}). See @code{man tor} for details
+on the configuration file syntax.
+
address@hidden @code{hidden-services} (predeterminados: @code{'()})
+The list of @code{<hidden-service>} records to use. For any hidden service
+you include in this list, appropriate configuration to enable the hidden
+service will be automatically added to the default configuration file. You
+may conveniently create @code{<hidden-service>} records using the
address@hidden procedure described below.
+
address@hidden @code{socks-socket-type} (predeterminado: @code{'tcp})
+The default socket type that Tor should use for its SOCKS socket. This must
+be either @code{'tcp} or @code{'unix}. If it is @code{'tcp}, then by
+default Tor will listen on TCP port 9050 on the loopback interface (i.e.,
+localhost). If it is @code{'unix}, then Tor will listen on the UNIX domain
+socket @file{/var/run/tor/socks-sock}, which will be made writable by
+members of the @code{tor} group.
+
+If you want to customize the SOCKS socket in more detail, leave
address@hidden at its default value of @code{'tcp} and use
address@hidden to override the default by providing your own
address@hidden option.
address@hidden table
address@hidden deftp
+
address@hidden servicio oculto
address@hidden {Procedimiento Scheme} tor-hidden-service @var{nombre}
@var{relación}
+Define un @dfn{servicio oculto} Tor llamado @var{nombre} y que implementa la
address@hidden @var{relación} es una lista de tuplas puerto/máquina, como:
+
address@hidden
+ '((22 "127.0.0.1:22")
+ (80 "127.0.0.1:8080"))
address@hidden example
+
+En este ejemplo, el puerto 22 del servicio oculto se asocia con el puerto 22
+local, y el puerto 80 se asocia con el puerto 8080 local.
+
+Esto crea un directorio @file{/var/lib/tor/hidden-services/@var{nombre}},
+donde el fichero @file{hostname} contiene el nombre de máquina @code{.onion}
+para el servicio oculto.
+
+Véase @uref{https://www.torproject.org/docs/tor-hidden-service.html.en, la
+documentación del proyecto Tor} para más información.
address@hidden deffn
+
+El módulo @code{(gnu services rsync)} proporciona los siguientes servicios:
+
+You might want an rsync daemon if you have files that you want available so
+anyone (or just yourself) can download existing files or upload new files.
+
address@hidden {Variable Scheme} rsync-service-type
+This is the type for the @uref{https://rsync.samba.org, rsync} rsync daemon,
address@hidden record as in this example:
+
address@hidden
+(service rsync-service-type)
address@hidden example
+
+See below for details about @code{rsync-configuration}.
address@hidden deffn
+
address@hidden {Tipo de datos} rsync-configuration
+Tipo de datos que representa la configuración para @code{rsync-service}.
+
address@hidden @asis
address@hidden @code{package} (predeterminado: @var{rsync})
+Paquete @code{rsync} usado.
+
address@hidden @code{port-number} (predeterminado: @code{873})
+TCP port on which @command{rsync} listens for incoming connections. If port
+is less than @code{1024} @command{rsync} needs to be started as the
address@hidden user and group.
+
address@hidden @code{pid-file} (predeterminado:
@code{"/var/run/rsyncd/rsyncd.pid"})
+Name of the file where @command{rsync} writes its PID.
+
address@hidden @code{lock-file} (predeterminado:
@code{"/var/run/rsyncd/rsyncd.lock"})
+Name of the file where @command{rsync} writes its lock file.
+
address@hidden @code{log-file} (predeterminado: @code{"/var/log/rsyncd.log"})
+Name of the file where @command{rsync} writes its log file.
+
address@hidden @code{use-chroot?} (predeterminado: @var{#t})
+Whether to use chroot for @command{rsync} shared directory.
+
address@hidden @code{share-path} (predeterminado: @file{/srv/rsync})
+Location of the @command{rsync} shared directory.
+
address@hidden @code{share-comment} (predeterminado: @code{"Rsync share"})
+Comment of the @command{rsync} shared directory.
+
address@hidden @code{read-only?} (predeterminado: @var{#f})
+Read-write permissions to shared directory.
+
address@hidden @code{timeout} (predeterminado: @code{300})
+I/O timeout in seconds.
+
address@hidden @code{user} (predeterminada: @var{"root"})
+Propietaria del proceso @code{rsync}.
+
address@hidden @code{group} (predeterminado: @var{"root"})
+Grupo del proceso @code{rsync}.
+
address@hidden @code{uid} (predeterminado: @var{"rsyncd"})
+Nombre o ID de usuaria bajo la cual se efectúan las transferencias desde y
+hacia el módulo cuando el daemon se ejecuta como @code{root}.
+
address@hidden @code{gid} (predeterminado: @var{"rsyncd"})
+Nombre o ID de grupo que se usa cuando se accede al módulo.
+
address@hidden table
address@hidden deftp
+
+Es más, @code{(gnu services ssh)} proporciona los siguientes servicios.
address@hidden SSH
address@hidden servidor SSH
+
address@hidden {Procedimiento Scheme} lsh-service [#:host-key
"/etc/lsh/host-key"] @
+ [#:daemonic? #t] [#:interfaces '()] [#:port-number 22] @
+ [#:allow-empty-passwords? #f] [#:root-login? #f] @
+ [#:syslog-output? #t] [#:x11-forwarding? #t] @
+ [#:tcp/ip-forwarding? #t] [#:password-authentication? #t] @
+ [#:public-key-authentication? #t] [#:initialize? #t]
+Ejecuta el programa @command{lshd} de @var{lsh} para escuchar en el puerto
address@hidden @var{host-key} debe designar a un fichero que contiene la
+clave de la máquina, y que sea legible únicamente por root.
+
+When @var{daemonic?} is true, @command{lshd} will detach from the
+controlling terminal and log its output to syslogd, unless one sets
address@hidden to false. Obviously, it also makes lsh-service depend
+on existence of syslogd service. When @var{pid-file?} is true,
address@hidden writes its PID to the file called @var{pid-file}.
+
+When @var{initialize?} is true, automatically create the seed and host key
+upon service activation if they do not exist yet. This may take long and
+require interaction.
+
+When @var{initialize?} is false, it is up to the user to initialize the
+randomness generator (@pxref{lsh-make-seed,,, lsh, LSH Manual}), and to
+create a key pair with the private key stored in file @var{host-key}
+(@pxref{lshd basics,,, lsh, LSH Manual}).
+
+When @var{interfaces} is empty, lshd listens for connections on all the
+network interfaces; otherwise, @var{interfaces} must be a list of host names
+or addresses.
+
address@hidden specifies whether to accept log-ins with empty
+passwords, and @var{root-login?} specifies whether to accept log-ins as
+root.
+
+The other options should be self-descriptive.
address@hidden deffn
+
address@hidden SSH
address@hidden servidor SSH
address@hidden {Variable Scheme} openssh-service-type
+This is the type for the @uref{http://www.openssh.org, OpenSSH} secure shell
+daemon, @command{sshd}. Its value must be an @code{openssh-configuration}
+record as in this example:
+
address@hidden
+(service openssh-service-type
+ (openssh-configuration
+ (x11-forwarding? #t)
+ (permit-root-login 'without-password)
+ (authorized-keys
+ `(("alicia" ,(local-file "alicia.pub"))
+ ("rober" ,(local-file "rober.pub"))))))
address@hidden example
+
+See below for details about @code{openssh-configuration}.
+
+This service can be extended with extra authorized keys, as in this example:
+
address@hidden
+(service-extension openssh-service-type
+ (const `(("carlos"
+ ,(local-file "carlos.pub")))))
address@hidden example
address@hidden deffn
+
address@hidden {Tipo de datos} openssh-configuration
+Este es el registro de configuración para @command{sshd} de OpenSSH.
+
address@hidden @asis
address@hidden @code{pid-file} (predeterminado: @code{"/var/run/sshd.pid"})
+Name of the file where @command{sshd} writes its PID.
+
address@hidden @code{port-number} (predeterminado: @code{22})
+TCP port on which @command{sshd} listens for incoming connections.
+
address@hidden @code{permit-root-login} (predeterminado: @code{#f})
+This field determines whether and when to allow logins as root. If
address@hidden, root logins are disallowed; if @code{#t}, they are allowed. If
+it's the symbol @code{'without-password}, then root logins are permitted but
+not with password-based authentication.
+
address@hidden @code{allow-empty-passwords?} (predeterminado: @code{#f})
+When true, users with empty passwords may log in. When false, they may not.
+
address@hidden @code{password-authentication?} (predeterminado: @code{#t})
+When true, users may log in with their password. When false, they have
+other authentication methods.
+
address@hidden @code{public-key-authentication?} (predeterminado: @code{#t})
+When true, users may log in using public key authentication. When false,
+users have to use other authentication method.
+
+Authorized public keys are stored in @file{~/.ssh/authorized_keys}. This is
+used only by protocol version 2.
+
address@hidden @code{x11-forwarding?} (predeterminado: @code{#f})
+When true, forwarding of X11 graphical client connections is enabled---in
+other words, @command{ssh} options @option{-X} and @option{-Y} will work.
+
address@hidden @code{allow-agent-forwarding?} (predeterminado: @code{#t})
+Whether to allow agent forwarding.
+
address@hidden @code{allow-tcp-forwarding?} (predeterminado: @code{#t})
+Whether to allow TCP forwarding.
+
address@hidden @code{gateway-ports?} (predeterminado: @code{#f})
+Whether to allow gateway ports.
+
address@hidden @code{challenge-response-authentication?} (predeterminado:
@code{#f})
+Specifies whether challenge response authentication is allowed (e.g.@: via
+PAM).
+
address@hidden @code{use-pam?} (predeterminado: @code{#t})
+Enables the Pluggable Authentication Module interface. If set to @code{#t},
+this will enable PAM authentication using
address@hidden and
address@hidden, in addition to PAM account and session
+module processing for all authentication types.
+
+Because PAM challenge response authentication usually serves an equivalent
+role to password authentication, you should disable either
address@hidden or
address@hidden
+
address@hidden @code{print-last-log?} (predeterminado: @code{#t})
+Especifica si @command{sshd} debe imprimir la fecha y hora del último
+ingreso al sistema de la usuaria cuando una usuaria ingresa
+interactivamente.
+
address@hidden @code{subsystems} (predeterminados: @code{'(("sftp"
"internal-sftp"))})
+Configures external subsystems (e.g.@: file transfer daemon).
+
+This is a list of two-element lists, each of which containing the subsystem
+name and a command (with optional arguments) to execute upon subsystem
+request.
+
+The command @command{internal-sftp} implements an in-process SFTP server.
+Alternately, one can specify the @command{sftp-server} command:
address@hidden
+(service openssh-service-type
+ (openssh-configuration
+ (subsystems
+ `(("sftp" ,(file-append openssh "/libexec/sftp-server"))))))
address@hidden example
+
address@hidden @code{accepted-environment} (predeterminado: @code{'()})
+List of strings describing which environment variables may be exported.
+
+Each string gets on its own line. See the @code{AcceptEnv} option in
address@hidden sshd_config}.
+
+This example allows ssh-clients to export the @code{COLORTERM} variable. It
+is set by terminal emulators, which support colors. You can use it in your
+shell's ressource file to enable colors for the prompt and commands if this
+variable is set.
+
address@hidden
+(service openssh-service-type
+ (openssh-configuration
+ (accepted-environment '("COLORTERM"))))
address@hidden example
+
address@hidden @code{authorized-keys} (predeterminadas: @code{'()})
address@hidden claves autorizadas, SSH
address@hidden SSH, claves autorizadas
+This is the list of authorized keys. Each element of the list is a user
+name followed by one or more file-like objects that represent SSH public
+keys. For example:
+
address@hidden
+(openssh-configuration
+ (authorized-keys
+ `(("rekado" ,(local-file "rekado.pub"))
+ ("chris" ,(local-file "chris.pub"))
+ ("root" ,(local-file "rekado.pub") ,(local-file "chris.pub")))))
address@hidden example
+
address@hidden
+registers the specified public keys for user accounts @code{rekado},
address@hidden, and @code{root}.
+
+Additional authorized keys can be specified @i{via}
address@hidden
+
+Note that this does @emph{not} interfere with the use of
address@hidden/.ssh/authorized_keys}.
+
address@hidden @code{log-level} (predeterminado: @code{'info})
+This is a symbol specifying the logging level: @code{quiet}, @code{fatal},
address@hidden, @code{info}, @code{verbose}, @code{debug}, etc. See the man
+page for @file{sshd_config} for the full list of level names.
+
address@hidden @code{extra-content} (predeterminado: @code{""})
+This field can be used to append arbitrary text to the configuration file.
+It is especially useful for elaborate configurations that cannot be
+expressed otherwise. This configuration, for example, would generally
+disable root logins, but permit them from one specific IP address:
+
address@hidden
+(openssh-configuration
+ (extra-content "\
+Match Address 192.168.0.1
+ PermitRootLogin yes"))
address@hidden example
+
address@hidden table
address@hidden deftp
+
address@hidden {Procedimiento Scheme} dropbear-service address@hidden
+Run the @uref{https://matt.ucc.asn.au/dropbear/dropbear.html,Dropbear SSH
+daemon} with the given @var{config}, 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:
+
address@hidden
+(dropbear-service (dropbear-configuration
+ (port-number 1234)))
address@hidden example
address@hidden deffn
+
address@hidden {Tipo de datos} dropbear-configuration
+This data type represents the configuration of a Dropbear SSH daemon.
+
address@hidden @asis
address@hidden @code{dropbear} (predeterminado: @var{dropbear})
+El paquete de Dropbear usado.
+
address@hidden @code{port-number} (predeterminado: 22)
+Puerto TCP donde el daemon espera conexiones entrantes.
+
address@hidden @code{syslog-output?} (predeterminado: @code{#t})
+Whether to enable syslog output.
+
address@hidden @code{pid-file} (predeterminado: @code{"/var/run/dropbear.pid"})
+File name of the daemon's PID file.
+
address@hidden @code{root-login?} (predeterminado: @code{#f})
+Whether to allow @code{root} logins.
+
address@hidden @code{allow-empty-passwords?} (predeterminado: @code{#f})
+Whether to allow empty passwords.
+
address@hidden @code{password-authentication?} (predeterminado: @code{#t})
+Whether to enable password-based authentication.
address@hidden table
address@hidden deftp
+
address@hidden {Variable Scheme} %facebook-host-aliases
+This variable contains a string for use in @file{/etc/hosts} (@pxref{Host
+Names,,, libc, The GNU C Library Reference Manual}). Each line contains a
+entry that maps a known server name of the Facebook on-line service---e.g.,
address@hidden the local address@hidden or its IPv6
+equivalent, @code{::1}.
+
+This variable is typically used in the @code{hosts-file} field of an
address@hidden declaration (@pxref{Referencia de ``operating-system'',
address@hidden/etc/hosts}}):
+
address@hidden
+(use-modules (gnu) (guix))
+
+(operating-system
+ (host-name "micompu")
+ ;; ...
+ (hosts-file
+ ;; Crea un fichero /etc/hosts file con alias para "localhost"
+ ;; y "micompu", así como los servidores de facebook.
+ (plain-file "hosts"
+ (string-append (local-host-aliases host-name)
+ %facebook-host-aliases))))
address@hidden example
+
+Este mecanismo puede impedir a los programas que se ejecutan localmente,
+como navegadores Web, el acceso a Facebook.
address@hidden defvr
+
+El módulo @code{(gnu services avahi)} proporciona la siguiente definición.
+
address@hidden {Scheme Variable} avahi-service-type
+This is the service that runs @command{avahi-daemon}, a system-wide
+mDNS/DNS-SD responder that allows for service discovery and
+``zero-configuration'' host name lookups (see @uref{http://avahi.org/}).
+Its value must be a @code{zero-configuration} record---see below.
+
+This service extends the name service cache daemon (nscd) so that it can
+resolve @code{.local} host names using
address@hidden://0pointer.de/lennart/projects/nss-mdns/, nss-mdns}.
@xref{Selector de servicios de nombres}, for information on host name
resolution.
+
+Additionally, add the @var{avahi} package to the system profile so that
+commands such as @command{avahi-browse} are directly usable.
address@hidden defvr
+
address@hidden {Data Type} avahi-configuration
+Data type representation the configuration for Avahi.
+
address@hidden @asis
+
address@hidden @code{host-name} (default: @code{#f})
+If different from @code{#f}, use that as the host name to publish for this
+machine; otherwise, use the machine's actual host name.
+
address@hidden @code{publish?} (default: @code{#t})
+When true, allow host names and services to be published (broadcast) over
+the network.
+
address@hidden @code{publish-workstation?} (default: @code{#t})
+When true, @command{avahi-daemon} publishes the machine's host name and IP
+address via mDNS on the local network. To view the host names published on
+your local network, you can run:
+
address@hidden
+avahi-browse _workstation._tcp
address@hidden example
+
address@hidden @code{wide-area?} (default: @code{#f})
+When true, DNS-SD over unicast DNS is enabled.
+
address@hidden @code{ipv4?} (default: @code{#t})
address@hidden @code{ipv6?} (default: @code{#t})
+These fields determine whether to use IPv4/IPv6 sockets.
+
address@hidden @code{domains-to-browse} (default: @code{'()})
+This is a list of domains to browse.
address@hidden table
address@hidden deftp
+
address@hidden {Variable Scheme} openvswitch-service-type
+This is the type of the @uref{http://www.openvswitch.org, Open vSwitch}
+service, whose value should be an @code{openvswitch-configuration} object.
address@hidden deffn
+
address@hidden {Tipo de datos} openvswitch-configuration
+Data type representing the configuration of Open vSwitch, a multilayer
+virtual switch which is designed to enable massive network automation
+through programmatic extension.
+
address@hidden @asis
address@hidden @code{package} (predeterminado: @var{openvswitch})
+Package object of the Open vSwitch.
+
address@hidden table
address@hidden deftp
+
address@hidden Sistema X Window
address@hidden Sistema X Window
+
address@hidden X11
address@hidden Sistema de ventanas X
address@hidden gestor de ingreso en el sistema
+Support for the X Window graphical display system---specifically Xorg---is
+provided by the @code{(gnu services xorg)} module. Note that there is no
address@hidden procedure. Instead, the X server is started by the
address@hidden manager}, by default the GNOME Display Manager (GDM).
+
address@hidden GDM
address@hidden GNOME, login manager
+GDM of course allows users to log in into window managers and desktop
+environments other than GNOME; for those using GNOME, GDM is required for
+features such as automatic screen locking.
+
address@hidden gestor de ventanas
+To use X11, you must install at least one @dfn{window manager}---for example
+the @code{windowmaker} or @code{openbox} packages---preferably by adding it
+to the @code{packages} field of your operating system definition
+(@pxref{Referencia de ``operating-system'', system-wide packages}).
+
address@hidden {Scheme Variable} gdm-service-type
+This is the type for the @uref{https://wiki.gnome.org/Projects/GDM/, GNOME
+Desktop Manager} (GDM), a program that manages graphical display servers and
+handles graphical user logins. Its value must be a @code{gdm-configuration}
+(see below.)
+
address@hidden tipos de sesión (X11)
address@hidden X11, tipos de sesión
+GDM looks for @dfn{session types} described by the @file{.desktop} files in
address@hidden/run/current-system/profile/share/xsessions} and allows users to
+choose a session from the log-in screen. Packages such as @code{gnome},
address@hidden, and @code{i3} provide @file{.desktop} files; adding them to the
+system-wide set of packages automatically makes them available at the log-in
+screen.
+
+In addition, @file{~/.xsession} files are honored. When available,
address@hidden/.xsession} must be an executable that starts a window manager
and/or
+other X clients.
address@hidden defvr
+
address@hidden {Data Type} gdm-configuration
address@hidden @asis
address@hidden @code{auto-login?} (predeterminado: @code{#f})
address@hidden @code{default-user} (default: @code{#f})
+When @code{auto-login?} is false, GDM presents a log-in screen.
+
+When @code{auto-login?} is true, GDM logs in directly as
address@hidden
+
address@hidden @code{gnome-shell-assets} (default: ...)
+List of GNOME Shell assets needed by GDM: icon theme, fonts, etc.
+
address@hidden @code{xorg-configuration} (default: @code{(xorg-configuration)})
+Configuration of the Xorg graphical server.
+
address@hidden @code{xsession} (default: @code{(xinitrc)})
+Script to run before starting a X session.
+
address@hidden @code{dbus-daemon} (default: @code{dbus-daemon-wrapper})
+File name of the @code{dbus-daemon} executable.
+
address@hidden @code{gdm} (default: @code{gdm})
+The GDM package to use.
address@hidden table
address@hidden deftp
+
address@hidden {Variable Scheme} slim-service-type
+Este es el tipo para el gestor de ingreso al sistema gráfico para X11 SLiM.
+
+Like GDM, SLiM looks for session types described by @file{.desktop} files
+and allows users to choose a session from the log-in screen using @kbd{F1}.
+It also honors @file{~/.xsession} files.
address@hidden defvr
+
address@hidden {Tipo de datos} slim-configuration
+Data type representing the configuration of @code{slim-service-type}.
+
address@hidden @asis
address@hidden @code{allow-empty-passwords?} (predeterminado: @code{#t})
+Whether to allow logins with empty passwords.
+
address@hidden @code{auto-login?} (predeterminado: @code{#f})
address@hidden @code{default-user} (predeterminado: @code{""})
+When @code{auto-login?} is false, SLiM presents a log-in screen.
+
+When @code{auto-login?} is true, SLiM logs in directly as
address@hidden
+
address@hidden @code{theme} (predeterminado: @code{%default-slim-theme})
address@hidden @code{theme-name} (predeterminado:
@code{%default-slim-theme-name})
+The graphical theme to use and its name.
+
address@hidden @code{auto-login-session} (predeterminado: @code{#f})
+If true, this must be the name of the executable to start as the default
+session---e.g., @code{(file-append windowmaker "/bin/windowmaker")}.
+
+If false, a session described by one of the available @file{.desktop} files
+in @code{/run/current-system/profile} and @code{~/.guix-profile} will be
+used.
+
address@hidden Nota
+You must install at least one window manager in the system profile or in
+your user profile. Failing to do that, if @code{auto-login-session} is
+false, you will be unable to log in.
address@hidden quotation
+
address@hidden @code{xorg-configuration} (default @code{(xorg-configuration)})
+Configuration of the Xorg graphical server.
+
address@hidden @code{xauth} (predeterminado: @code{xauth})
+El paquete XAuth usado.
+
address@hidden @code{shepherd} (predeterminado: @code{shepherd})
+The Shepherd package used when invoking @command{halt} and @command{reboot}.
+
address@hidden @code{sessreg} (predeterminado: @code{sessreg})
+The sessreg package used in order to register the session.
+
address@hidden @code{slim} (predeterminado: @code{slim})
+El paquete SLiM usado.
address@hidden table
address@hidden deftp
+
address@hidden {Variable Scheme} %default-theme
address@hidden {Variable Scheme} %default-theme-name
+The default SLiM theme and its name.
address@hidden defvr
+
+
address@hidden {Tipo de datos} sddm-configuration
+This is the data type representing the sddm service configuration.
+
address@hidden @asis
address@hidden @code{display-server} (predeterminado: "x11")
+Select display server to use for the greeter. Valid values are "x11" or
+"wayland".
+
address@hidden @code{numlock} (predeterminado: "on")
+Valid values are "on", "off" or "none".
+
address@hidden @code{halt-command} (predeterminado @code{#~(string-apppend
#$shepherd "/sbin/halt")})
+Command to run when halting.
+
address@hidden @code{reboot-command} (predeterminado @code{#~(string-append
#$shepherd "/sbin/reboot")})
+Command to run when rebooting.
+
address@hidden @code{theme} (predeterminado "maldives")
+Theme to use. Default themes provided by SDDM are "elarun" or "maldives".
+
address@hidden @code{themes-directory} (predeterminado
"/run/current-system/profile/share/sddm/themes")
+Directory to look for themes.
+
address@hidden @code{faces-directory} (predeterminado
"/run/current-system/profile/share/sddm/faces")
+Directory to look for faces.
+
address@hidden @code{default-path} (predeterminado
"/run/current-system/profile/bin")
+Default PATH to use.
+
address@hidden @code{minimum-uid} (predeterminado 1000)
+Minimum UID to display in SDDM.
+
address@hidden @code{maximum-uid} (predeterminado 2000)
+Maximum UID to display in SDDM
+
address@hidden @code{remember-last-user?} (predeterminado #t)
+Remember last user.
+
address@hidden @code{remember-last-session?} (predeterminado #t)
+Remember last session.
+
address@hidden @code{hide-users} (predeterminado "")
+Usernames to hide from SDDM greeter.
+
address@hidden @code{hide-shells} (predeterminado @code{#~(string-append
#$shadow "/sbin/nologin")})
+Users with shells listed will be hidden from the SDDM greeter.
+
address@hidden @code{session-command} (predeterminado @code{#~(string-append
#$sddm "/share/sddm/scripts/wayland-session")})
+Script to run before starting a wayland session.
+
address@hidden @code{sessions-directory} (predeterminado
"/run/current-system/profile/share/wayland-sessions")
+Directory to look for desktop files starting wayland sessions.
+
address@hidden @code{xorg-configuration} (default @code{(xorg-configuration)})
+Configuration of the Xorg graphical server.
+
address@hidden @code{xauth-path} (predeterminado @code{#~(string-append #$xauth
"/bin/xauth")})
+Path to xauth.
+
address@hidden @code{xephyr-path} (predeterminado @code{#~(string-append
#$xorg-server "/bin/Xephyr")})
+Path to Xephyr.
+
address@hidden @code{xdisplay-start} (predeterminado @code{#~(string-append
#$sddm "/share/sddm/scripts/Xsetup")})
+Script to run after starting xorg-server.
+
address@hidden @code{xdisplay-stop} (predeterminado @code{#~(string-append
#$sddm "/share/sddm/scripts/Xstop")})
+Script to run before stopping xorg-server.
+
address@hidden @code{xsession-command} (predeterminado: @code{xinitrc})
+Script to run before starting a X session.
+
address@hidden @code{xsessions-directory} (predeterminado:
"/run/current-system/profile/share/xsessions")
+Directory to look for desktop files starting X sessions.
+
address@hidden @code{minimum-vt} (predeterminado: 7)
+Minimum VT to use.
+
address@hidden @code{auto-login-user} (predeterminado "")
+User to use for auto-login.
+
address@hidden @code{auto-login-session} (predeterminado "")
+Desktop file to use for auto-login.
+
address@hidden @code{relogin?} (predeterminado #f)
+Relogin after logout.
+
address@hidden table
address@hidden deftp
+
address@hidden gestor de ingreso en el sistema
address@hidden X11, ingreso al sistema
address@hidden {Procedimiento Scheme} sddm-service config
+Return a service that spawns the SDDM graphical login manager for config of
+type @code{<sddm-configuration>}.
+
address@hidden
+ (sddm-service (sddm-configuration
+ (auto-login-user "Alicia")
+ (auto-login-session "xfce.desktop")))
address@hidden example
address@hidden deffn
+
address@hidden Xorg, configuration
address@hidden {Data Type} xorg-configuration
+This data type represents the configuration of the Xorg graphical display
+server. Note that there is not Xorg service; instead, the X server is
+started by a ``display manager'' such as GDM, SDDM, and SLiM. Thus, the
+configuration of these display managers aggregates an
address@hidden record.
+
address@hidden @asis
address@hidden @code{modules} (default: @code{%default-xorg-modules})
+This is a list of @dfn{module packages} loaded by the Xorg server---e.g.,
address@hidden, @code{xf86-input-keyboard}, and so on.
+
address@hidden @code{fonts} (default: @code{%default-xorg-fonts})
+This is a list of font directories to add to the server's @dfn{font path}.
+
address@hidden @code{drivers} (default: @code{'()})
+This must be either the empty list, in which case Xorg chooses a graphics
+driver automatically, or a list of driver names that will be tried in this
+order---e.g., @code{("modesetting" "vesa")}.
+
address@hidden @code{resolutions} (default: @code{'()})
+When @code{resolutions} is the empty list, Xorg chooses an appropriate
+screen resolution. Otherwise, it must be a list of resolutions---e.g.,
address@hidden((1024 768) (640 480))}.
+
address@hidden keyboard layout, for Xorg
address@hidden keymap, for Xorg
address@hidden @code{keyboard-layout} (predeterminada: @code{#f})
+If this is @code{#f}, Xorg uses the default keyboard layout---usually US
+English (``qwerty'') for a 105-key PC keyboard.
+
+Otherwise this must be a @code{keyboard-layout} object specifying the
+keyboard layout in use when Xorg is running. @xref{Distribución de teclado},
for
+more information on how to specify the keyboard layout.
+
address@hidden @code{extra-config} (default: @code{'()})
+This is a list of strings or objects appended to the configuration file. It
+is used to pass extra text to be added verbatim to the configuration file.
+
address@hidden @code{server} (default: @code{xorg-server})
+This is the package providing the Xorg server.
+
address@hidden @code{server-arguments} (default:
@code{%default-xorg-server-arguments})
+This is the list of command-line arguments to pass to the X server. The
+default is @code{-nolisten tcp}.
address@hidden table
address@hidden deftp
+
address@hidden {Scheme Procedure} set-xorg-configuration @var{config} @
+ address@hidden Tell the log-in manager (of type
address@hidden) to use @var{config}, an
+<xorg-configuration> record.
+
+Since the Xorg configuration is embedded in the log-in manager's
+configuration---e.g., @code{gdm-configuration}---this procedure provides a
+shorthand to set the Xorg configuration.
address@hidden deffn
+
address@hidden {Scheme Procedure} xorg-start-command address@hidden
+Return a @code{startx} script in which the modules, fonts, etc. specified in
address@hidden, are available. The result should be used in place of
address@hidden
+
+Usually the X server is started by a login manager.
address@hidden deffn
+
+
address@hidden {Procedimiento Scheme} screen-locker-service @var{paquete}
address@hidden
+Añade @var{paquete}, un paquete para un bloqueador de sesión o un
+salvapantallas cuya orden es @var{programa}, al conjunto de programas setuid
+y añade una entrada PAM para él. Por ejemplo:
+
address@hidden
+(screen-locker-service xlockmore "xlock")
address@hidden lisp
+
+permite usar el viejo XlockMore.
address@hidden deffn
+
+
address@hidden Servicios de impresión
address@hidden Servicios de impresión
+
address@hidden printer support with CUPS
+The @code{(gnu services cups)} module provides a Guix service definition for
+the CUPS printing service. To add printer support to a Guix system, add a
address@hidden to the operating system definition:
+
address@hidden {Variable Scheme} cups-service-type
+The service type for the CUPS print server. Its value should be a valid
+CUPS configuration (see below). To use the default settings, simply write:
address@hidden
+(service cups-service-type)
address@hidden example
address@hidden deffn
+
+The CUPS configuration controls the basic things about your CUPS
+installation: what interfaces it listens on, what to do if a print job
+fails, how much logging to do, and so on. To actually add a printer, you
+have to visit the @url{http://localhost:631} URL, or use a tool such as
+GNOME's printer configuration services. By default, configuring a CUPS
+service will generate a self-signed certificate if needed, for secure
+connections to the print server.
+
+Suppose you want to enable the Web interface of CUPS and also add support
+for Epson printers @i{via} the @code{escpr} package and for HP printers
address@hidden the @code{hplip-minimal} package. You can do that directly, like
+this (you need to use the @code{(gnu packages cups)} module):
+
address@hidden
+(service cups-service-type
+ (cups-configuration
+ (web-interface? #t)
+ (extensions
+ (list cups-filters escpr hplip-minimal))))
address@hidden example
+
+Note: If you wish to use the Qt5 based GUI which comes with the hplip
+package then it is suggested that you install the @code{hplip} package,
+either in your OS configuration file or as your user.
+
+The available configuration parameters follow. Each parameter definition is
+preceded by its type; for example, @samp{string-list foo} indicates that the
address@hidden parameter should be specified as a list of strings. There is
+also a way to specify the configuration as a string, if you have an old
address@hidden file that you want to port over from some other system;
+see the end for more details.
+
address@hidden The following documentation was initially generated by
address@hidden (generate-documentation) in (gnu services cups). Manually
maintained
address@hidden documentation is better, so we shouldn't hesitate to edit below
as
address@hidden needed. However if the change you want to make to this
documentation
address@hidden can be done in an automated way, it's probably easier to change
address@hidden (generate-documentation) than to make it below and have to deal
with
address@hidden the churn as CUPS updates.
+
+
+Available @code{cups-configuration} fields are:
+
address@hidden address@hidden parameter} package cups
+El paquete CUPS.
address@hidden deftypevr
+
address@hidden address@hidden parameter} package-list extensions
+Drivers and other extensions to the CUPS package.
address@hidden deftypevr
+
address@hidden address@hidden parameter} files-configuration files-configuration
+Configuration of where to write logs, what directories to use for print
+spools, and related privileged configuration parameters.
+
+Available @code{files-configuration} fields are:
+
address@hidden address@hidden parameter} log-location access-log
+Defines the access log filename. Specifying a blank filename disables
+access log generation. The value @code{stderr} causes log entries to be
+sent to the standard error file when the scheduler is running in the
+foreground, or to the system log daemon when run in the background. The
+value @code{syslog} causes log entries to be sent to the system log daemon.
+The server name may be included in filenames using the string @code{%s}, as
+in @code{/var/log/cups/%s-access_log}.
+
+Defaults to @samp{"/var/log/cups/access_log"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} file-name cache-dir
+Where CUPS should cache data.
+
+Defaults to @samp{"/var/cache/cups"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string config-file-perm
+Specifies the permissions for all configuration files that the scheduler
+writes.
+
+Note that the permissions for the printers.conf file are currently masked to
+only allow access from the scheduler user (typically root). This is done
+because printer device URIs sometimes contain sensitive authentication
+information that should not be generally known on the system. There is no
+way to disable this security feature.
+
+Defaults to @samp{"0640"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} log-location error-log
+Defines the error log filename. Specifying a blank filename disables access
+log generation. The value @code{stderr} causes log entries to be sent to
+the standard error file when the scheduler is running in the foreground, or
+to the system log daemon when run in the background. The value
address@hidden causes log entries to be sent to the system log daemon. The
+server name may be included in filenames using the string @code{%s}, as in
address@hidden/var/log/cups/%s-error_log}.
+
+Defaults to @samp{"/var/log/cups/error_log"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string fatal-errors
+Specifies which errors are fatal, causing the scheduler to exit. The kind
+strings are:
+
address@hidden @code
address@hidden none
+No errors are fatal.
+
address@hidden all
+All of the errors below are fatal.
+
address@hidden browse
+Browsing initialization errors are fatal, for example failed connections to
+the DNS-SD daemon.
+
address@hidden config
+Configuration file syntax errors are fatal.
+
address@hidden listen
+Listen or Port errors are fatal, except for IPv6 failures on the loopback or
address@hidden addresses.
+
address@hidden log
+Log file creation or write errors are fatal.
+
address@hidden permissions
+Bad startup file permissions are fatal, for example shared TLS certificate
+and key files with world-read permissions.
address@hidden table
+
+Defaults to @samp{"all -browse"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean file-device?
+Specifies whether the file pseudo-device can be used for new printer
+queues. The URI @uref{file:///dev/null} is always allowed.
+
+El valor predeterminado es @samp{#f}
address@hidden deftypevr
+
address@hidden address@hidden parameter} string group
+Specifies the group name or ID that will be used when executing external
+programs.
+
+Defaults to @samp{"lp"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string log-file-perm
+Specifies the permissions for all log files that the scheduler writes.
+
+Defaults to @samp{"0644"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} log-location page-log
+Defines the page log filename. Specifying a blank filename disables access
+log generation. The value @code{stderr} causes log entries to be sent to
+the standard error file when the scheduler is running in the foreground, or
+to the system log daemon when run in the background. The value
address@hidden causes log entries to be sent to the system log daemon. The
+server name may be included in filenames using the string @code{%s}, as in
address@hidden/var/log/cups/%s-page_log}.
+
+Defaults to @samp{"/var/log/cups/page_log"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string remote-root
+Specifies the username that is associated with unauthenticated accesses by
+clients claiming to be the root user. The default is @code{remroot}.
+
+Defaults to @samp{"remroot"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} file-name request-root
+Specifies the directory that contains print jobs and other HTTP request
+data.
+
+Defaults to @samp{"/var/spool/cups"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} sandboxing sandboxing
+Specifies the level of security sandboxing that is applied to print filters,
+backends, and other child processes of the scheduler; either @code{relaxed}
+or @code{strict}. This directive is currently only used/supported on macOS.
+
+Defaults to @samp{strict}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} file-name server-keychain
+Specifies the location of TLS certificates and private keys. CUPS will look
+for public and private keys in this directory: a @code{.crt} files for
+PEM-encoded certificates and corresponding @code{.key} files for PEM-encoded
+private keys.
+
+Defaults to @samp{"/etc/cups/ssl"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} file-name server-root
+Specifies the directory containing the server configuration files.
+
+Defaults to @samp{"/etc/cups"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean sync-on-close?
+Specifies whether the scheduler calls fsync(2) after writing configuration
+or state files.
+
+El valor predeterminado es @samp{#f}
address@hidden deftypevr
+
address@hidden address@hidden parameter} space-separated-string-list
system-group
+Specifies the group(s) to use for @code{@@SYSTEM} group authentication.
address@hidden deftypevr
+
address@hidden address@hidden parameter} file-name temp-dir
+Specifies the directory where temporary files are stored.
+
+Defaults to @samp{"/var/spool/cups/tmp"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string user
+Specifies the user name or ID that is used when running external programs.
+
+Defaults to @samp{"lp"}.
address@hidden deftypevr
address@hidden deftypevr
+
address@hidden address@hidden parameter} access-log-level access-log-level
+Specifies the logging level for the AccessLog file. The @code{config} level
+logs when printers and classes are added, deleted, or modified and when
+configuration files are accessed or updated. The @code{actions} level logs
+when print jobs are submitted, held, released, modified, or canceled, and
+any of the conditions for @code{config}. The @code{all} level logs all
+requests.
+
+Defaults to @samp{actions}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean auto-purge-jobs?
+Specifies whether to purge job history data automatically when it is no
+longer required for quotas.
+
+El valor predeterminado es @samp{#f}
address@hidden deftypevr
+
address@hidden address@hidden parameter} browse-local-protocols
browse-local-protocols
+Specifies which protocols to use for local printer sharing.
+
+Defaults to @samp{dnssd}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean browse-web-if?
+Specifies whether the CUPS web interface is advertised.
+
+El valor predeterminado es @samp{#f}
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean browsing?
+Specifies whether shared printers are advertised.
+
+El valor predeterminado es @samp{#f}
address@hidden deftypevr
+
address@hidden address@hidden parameter} string classification
+Specifies the security classification of the server. Any valid banner name
+can be used, including "classified", "confidential", "secret", "topsecret",
+and "unclassified", or the banner can be omitted to disable secure printing
+functions.
+
+El valor predeterminado es @samp{""}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean classify-override?
+Specifies whether users may override the classification (cover page) of
+individual print jobs using the @code{job-sheets} option.
+
+El valor predeterminado es @samp{#f}
address@hidden deftypevr
+
address@hidden address@hidden parameter} default-auth-type default-auth-type
+Specifies the default type of authentication to use.
+
+Defaults to @samp{Basic}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} default-encryption default-encryption
+Specifies whether encryption will be used for authenticated requests.
+
+Defaults to @samp{Required}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string default-language
+Specifies the default language to use for text and web content.
+
+Defaults to @samp{"en"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string default-paper-size
+Specifies the default paper size for new print queues. @samp{"Auto"} uses a
+locale-specific default, while @samp{"None"} specifies there is no default
+paper size. Specific size names are typically @samp{"Letter"} or
address@hidden"A4"}.
+
+Defaults to @samp{"Auto"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string default-policy
+Specifies the default access policy to use.
+
+Defaults to @samp{"default"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean default-shared?
+Specifies whether local printers are shared by default.
+
+Defaults to @samp{#t}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer
dirty-clean-interval
+Specifies the delay for updating of configuration and state files, in
+seconds. A value of 0 causes the update to happen as soon as possible,
+typically within a few milliseconds.
+
+El valor predeterminado es @samp{30}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} error-policy error-policy
+Specifies what to do when an error occurs. Possible values are
address@hidden, which will discard the failed print job; @code{retry-job},
+which will retry the job at a later time; @code{retry-this-job}, which
+retries the failed job immediately; and @code{stop-printer}, which stops the
+printer.
+
+Defaults to @samp{stop-printer}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer filter-limit
+Specifies the maximum cost of filters that are run concurrently, which can
+be used to minimize disk, memory, and CPU resource problems. A limit of 0
+disables filter limiting. An average print to a non-PostScript printer
+needs a filter limit of about 200. A PostScript printer needs about half
+that (100). Setting the limit below these thresholds will effectively limit
+the scheduler to printing a single job at any time.
+
+El valor predeterminado es @samp{0}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer filter-nice
+Specifies the scheduling priority of filters that are run to print a job.
+The nice value ranges from 0, the highest priority, to 19, the lowest
+priority.
+
+El valor predeterminado es @samp{0}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} host-name-lookups host-name-lookups
+Specifies whether to do reverse lookups on connecting clients. The
address@hidden setting causes @code{cupsd} to verify that the hostname
+resolved from the address matches one of the addresses returned for that
+hostname. Double lookups also prevent clients with unregistered addresses
+from connecting to your server. Only set this option to @code{#t} or
address@hidden if absolutely required.
+
+El valor predeterminado es @samp{#f}
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer job-kill-delay
+Specifies the number of seconds to wait before killing the filters and
+backend associated with a canceled or held job.
+
+El valor predeterminado es @samp{30}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer job-retry-interval
+Specifies the interval between retries of jobs in seconds. This is
+typically used for fax queues but can also be used with normal print queues
+whose error policy is @code{retry-job} or @code{retry-current-job}.
+
+El valor predeterminado es @samp{30}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer job-retry-limit
+Specifies the number of retries that are done for jobs. This is typically
+used for fax queues but can also be used with normal print queues whose
+error policy is @code{retry-job} or @code{retry-current-job}.
+
+Defaults to @samp{5}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean keep-alive?
+Specifies whether to support HTTP keep-alive connections.
+
+Defaults to @samp{#t}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer keep-alive-timeout
+Specifies how long an idle client connection remains open, in seconds.
+
+El valor predeterminado es @samp{30}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer limit-request-body
+Specifies the maximum size of print files, IPP requests, and HTML form
+data. A limit of 0 disables the limit check.
+
+El valor predeterminado es @samp{0}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} multiline-string-list listen
+Listens on the specified interfaces for connections. Valid values are of
+the form @var{address}:@var{port}, where @var{address} is either an IPv6
+address enclosed in brackets, an IPv4 address, or @code{*} to indicate all
+addresses. Values can also be file names of local UNIX domain sockets. The
+Listen directive is similar to the Port directive but allows you to restrict
+access to specific interfaces or networks.
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer listen-back-log
+Specifies the number of pending connections that will be allowed. This
+normally only affects very busy servers that have reached the MaxClients
+limit, but can also be triggered by large numbers of simultaneous
+connections. When the limit is reached, the operating system will refuse
+additional connections until the scheduler can accept the pending ones.
+
+Defaults to @samp{128}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} location-access-control-list
location-access-controls
+Specifies a set of additional access controls.
+
+Available @code{location-access-controls} fields are:
+
address@hidden address@hidden parameter} file-name path
+Specifies the URI path to which the access control applies.
address@hidden deftypevr
+
address@hidden address@hidden parameter} access-control-list access-controls
+Access controls for all access to this path, in the same format as the
address@hidden of @code{operation-access-control}.
+
+Defaults to @samp{()}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} method-access-control-list
method-access-controls
+Access controls for method-specific access to this path.
+
+Defaults to @samp{()}.
+
+Available @code{method-access-controls} fields are:
+
address@hidden address@hidden parameter} boolean reverse?
+If @code{#t}, apply access controls to all methods except the listed
+methods. Otherwise apply to only the listed methods.
+
+El valor predeterminado es @samp{#f}
address@hidden deftypevr
+
address@hidden address@hidden parameter} method-list methods
+Methods to which this access control applies.
+
+Defaults to @samp{()}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} access-control-list access-controls
+Access control directives, as a list of strings. Each string should be one
+directive, such as "Order allow,deny".
+
+Defaults to @samp{()}.
address@hidden deftypevr
address@hidden deftypevr
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer log-debug-history
+Specifies the number of debugging messages that are retained for logging if
+an error occurs in a print job. Debug messages are logged regardless of the
+LogLevel setting.
+
+Defaults to @samp{100}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} log-level log-level
+Specifies the level of logging for the ErrorLog file. The value @code{none}
+stops all logging while @code{debug2} logs everything.
+
+Defaults to @samp{info}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} log-time-format log-time-format
+Specifies the format of the date and time in the log files. The value
address@hidden logs whole seconds while @code{usecs} logs microseconds.
+
+Defaults to @samp{standard}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer max-clients
+Specifies the maximum number of simultaneous clients that are allowed by the
+scheduler.
+
+Defaults to @samp{100}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer
max-clients-per-host
+Specifies the maximum number of simultaneous clients that are allowed from a
+single address.
+
+Defaults to @samp{100}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer max-copies
+Specifies the maximum number of copies that a user can print of each job.
+
+Defaults to @samp{9999}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer max-hold-time
+Specifies the maximum time a job may remain in the @code{indefinite} hold
+state before it is canceled. A value of 0 disables cancellation of held
+jobs.
+
+El valor predeterminado es @samp{0}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer max-jobs
+Specifies the maximum number of simultaneous jobs that are allowed. Set to
+0 to allow an unlimited number of jobs.
+
+Defaults to @samp{500}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer
max-jobs-per-printer
+Specifies the maximum number of simultaneous jobs that are allowed per
+printer. A value of 0 allows up to MaxJobs jobs per printer.
+
+El valor predeterminado es @samp{0}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer max-jobs-per-user
+Specifies the maximum number of simultaneous jobs that are allowed per
+user. A value of 0 allows up to MaxJobs jobs per user.
+
+El valor predeterminado es @samp{0}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer max-job-time
+Specifies the maximum time a job may take to print before it is canceled, in
+seconds. Set to 0 to disable cancellation of "stuck" jobs.
+
+Defaults to @samp{10800}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer max-log-size
+Specifies the maximum size of the log files before they are rotated, in
+bytes. The value 0 disables log rotation.
+
+Defaults to @samp{1048576}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer
multiple-operation-timeout
+Specifies the maximum amount of time to allow between files in a multiple
+file print job, in seconds.
+
+Defaults to @samp{300}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string page-log-format
+Specifies the format of PageLog lines. Sequences beginning with percent
+(@samp{%}) characters are replaced with the corresponding information, while
+all other characters are copied literally. The following percent sequences
+are recognized:
+
address@hidden @samp
address@hidden %%
+insert a single percent character
+
address@hidden address@hidden@}
+insert the value of the specified IPP attribute
+
address@hidden %C
+insert the number of copies for the current page
+
address@hidden %P
+insert the current page number
+
address@hidden %T
+insert the current date and time in common log format
+
address@hidden %j
+insert the job ID
+
address@hidden %p
+insert the printer name
+
address@hidden %u
+insert the username
address@hidden table
+
+A value of the empty string disables page logging. The string @code{%p %u
+%j %T %P %C address@hidden@} address@hidden@} address@hidden@}
address@hidden@} address@hidden@}} creates a page log with the standard items.
+
+El valor predeterminado es @samp{""}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} environment-variables
environment-variables
+Passes the specified environment variable(s) to child processes; a list of
+strings.
+
+Defaults to @samp{()}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} policy-configuration-list policies
+Specifies named access control policies.
+
+Available @code{policy-configuration} fields are:
+
address@hidden address@hidden parameter} string name
+Name of the policy.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string job-private-access
+Specifies an access list for a job's private values. @code{@@ACL} maps to
+the printer's requesting-user-name-allowed or requesting-user-name-denied
+values. @code{@@OWNER} maps to the job's owner. @code{@@SYSTEM} maps to
+the groups listed for the @code{system-group} field of the
address@hidden configuration, which is reified into the
address@hidden(5)} file. Other possible elements of the access list
+include specific user names, and @code{@@@var{group}} to indicate members of
+a specific group. The access list may also be simply @code{all} or
address@hidden
+
+Defaults to @samp{"@@OWNER @@SYSTEM"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string job-private-values
+Specifies the list of job values to make private, or @code{all},
address@hidden, or @code{none}.
+
+Defaults to @samp{"job-name job-originating-host-name
+job-originating-user-name phone"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string subscription-private-access
+Specifies an access list for a subscription's private values. @code{@@ACL}
+maps to the printer's requesting-user-name-allowed or
+requesting-user-name-denied values. @code{@@OWNER} maps to the job's
+owner. @code{@@SYSTEM} maps to the groups listed for the
address@hidden field of the @code{files-config} configuration, which is
+reified into the @code{cups-files.conf(5)} file. Other possible elements of
+the access list include specific user names, and @code{@@@var{group}} to
+indicate members of a specific group. The access list may also be simply
address@hidden or @code{default}.
+
+Defaults to @samp{"@@OWNER @@SYSTEM"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string subscription-private-values
+Specifies the list of job values to make private, or @code{all},
address@hidden, or @code{none}.
+
+Defaults to @samp{"notify-events notify-pull-method notify-recipient-uri
+notify-subscriber-user-name notify-user-data"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} operation-access-control-list
access-controls
+Access control by IPP operation.
+
+Defaults to @samp{()}.
address@hidden deftypevr
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean-or-non-negative-integer
preserve-job-files
+Specifies whether job files (documents) are preserved after a job is
+printed. If a numeric value is specified, job files are preserved for the
+indicated number of seconds after printing. Otherwise a boolean value
+applies indefinitely.
+
+Defaults to @samp{86400}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean-or-non-negative-integer
preserve-job-history
+Specifies whether the job history is preserved after a job is printed. If a
+numeric value is specified, the job history is preserved for the indicated
+number of seconds after printing. If @code{#t}, the job history is
+preserved until the MaxJobs limit is reached.
+
+Defaults to @samp{#t}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer reload-timeout
+Specifies the amount of time to wait for job completion before restarting
+the scheduler.
+
+El valor predeterminado es @samp{30}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string rip-cache
+Specifies the maximum amount of memory to use when converting documents into
+bitmaps for a printer.
+
+Defaults to @samp{"128m"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string server-admin
+Specifies the email address of the server administrator.
+
+Defaults to @samp{"root@@localhost.localdomain"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} host-name-list-or-* server-alias
+The ServerAlias directive is used for HTTP Host header validation when
+clients connect to the scheduler from external interfaces. Using the
+special name @code{*} can expose your system to known browser-based DNS
+rebinding attacks, even when accessing sites through a firewall. If the
+auto-discovery of alternate names does not work, we recommend listing each
+alternate name with a ServerAlias directive instead of using @code{*}.
+
+Defaults to @samp{*}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string server-name
+Specifies the fully-qualified host name of the server.
+
+Defaults to @samp{"localhost"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} server-tokens server-tokens
+Specifies what information is included in the Server header of HTTP
+responses. @code{None} disables the Server header. @code{ProductOnly}
+reports @code{CUPS}. @code{Major} reports @code{CUPS 2}. @code{Minor}
+reports @code{CUPS 2.0}. @code{Minimal} reports @code{CUPS 2.0.0}.
address@hidden reports @code{CUPS 2.0.0 (@var{uname})} where @var{uname} is the
+output of the @code{uname} command. @code{Full} reports @code{CUPS 2.0.0
+(@var{uname}) IPP/2.0}.
+
+Defaults to @samp{Minimal}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string set-env
+Set the specified environment variable to be passed to child processes.
+
+Defaults to @samp{"variable value"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} multiline-string-list ssl-listen
+Listens on the specified interfaces for encrypted connections. Valid values
+are of the form @var{address}:@var{port}, where @var{address} is either an
+IPv6 address enclosed in brackets, an IPv4 address, or @code{*} to indicate
+all addresses.
+
+Defaults to @samp{()}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} ssl-options ssl-options
+Sets encryption options. By default, CUPS only supports encryption using
+TLS v1.0 or higher using known secure cipher suites. The @code{AllowRC4}
+option enables the 128-bit RC4 cipher suites, which are required for some
+older clients that do not implement newer ones. The @code{AllowSSL3} option
+enables SSL v3.0, which is required for some older clients that do not
+support TLS v1.0.
+
+Defaults to @samp{()}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean strict-conformance?
+Specifies whether the scheduler requires clients to strictly adhere to the
+IPP specifications.
+
+El valor predeterminado es @samp{#f}
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer timeout
+Specifies the HTTP request timeout, in seconds.
+
+Defaults to @samp{300}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean web-interface?
+Specifies whether the web interface is enabled.
+
+El valor predeterminado es @samp{#f}
address@hidden deftypevr
+
+At this point you're probably thinking ``oh dear, Guix manual, I like you
+but you can stop already with the configuration options''. Indeed.
+However, one more point: it could be that you have an existing
address@hidden that you want to use. In that case, you can pass an
address@hidden as the configuration of a
address@hidden
+
+Available @code{opaque-cups-configuration} fields are:
+
address@hidden address@hidden parameter} package cups
+El paquete CUPS.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string cupsd.conf
+The contents of the @code{cupsd.conf}, as a string.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string cups-files.conf
+The contents of the @code{cups-files.conf} file, as a string.
address@hidden deftypevr
+
+For example, if your @code{cupsd.conf} and @code{cups-files.conf} are in
+strings of the same name, you could instantiate a CUPS service like this:
+
address@hidden
+(service cups-service-type
+ (opaque-cups-configuration
+ (cupsd.conf cupsd.conf)
+ (cups-files.conf cups-files.conf)))
address@hidden example
+
+
address@hidden Servicios de escritorio
address@hidden Servicios de escritorio
+
+The @code{(gnu services desktop)} module provides services that are usually
+useful in the context of a ``desktop'' setup---that is, on a machine running
+a graphical display server, possibly with graphical user interfaces, etc.
+It also defines services that provide specific desktop environments like
+GNOME, Xfce or MATE.
+
+To simplify things, the module defines a variable containing the set of
+services that users typically expect on a machine with a graphical
+environment and networking:
+
address@hidden {Variable Scheme} %desktop-services
+This is a list of services that builds upon @var{%base-services} and adds or
+adjusts services for a typical ``desktop'' setup.
+
+In particular, it adds a graphical login manager (@pxref{Sistema X Window,
address@hidden), screen lockers, a network management tool
+(@pxref{Servicios de red, @code{network-manager-service-type}}), energy
+and color management services, the @code{elogind} login and seat manager,
+the Polkit privilege service, the GeoClue location service, the
+AccountsService daemon that allows authorized users change system passwords,
+an NTP client (@pxref{Servicios de red}), the Avahi daemon, and has the
+name service switch service configured to be able to use @code{nss-mdns}
+(@pxref{Selector de servicios de nombres, mDNS}).
address@hidden defvr
+
+The @var{%desktop-services} variable can be used as the @code{services}
+field of an @code{operating-system} declaration (@pxref{Referencia de
``operating-system'', @code{services}}).
+
+Additionally, the @code{gnome-desktop-service-type},
address@hidden, @code{mate-desktop-service-type} and
address@hidden procedures can add GNOME, Xfce,
+MATE and/or Enlightenment to a system. To ``add GNOME'' means that
+system-level services like the backlight adjustment helpers and the power
+management utilities are added to the system, extending @code{polkit} and
address@hidden appropriately, allowing GNOME to operate with elevated
+privileges on a limited number of special-purpose system interfaces.
+Additionally, adding a service made by @code{gnome-desktop-service-type}
+adds the GNOME metapackage to the system profile. Likewise, adding the Xfce
+service not only adds the @code{xfce} metapackage to the system profile, but
+it also gives the Thunar file manager the ability to open a ``root-mode''
+file management window, if the user authenticates using the administrator's
+password via the standard polkit graphical interface. To ``add MATE'' means
+that @code{polkit} and @code{dbus} are extended appropriately, allowing MATE
+to operate with elevated privileges on a limited number of special-purpose
+system interfaces. Additionally, adding a service of type
address@hidden adds the MATE metapackage to the system
+profile. ``Adding Enlightenment'' means that @code{dbus} is extended
+appropriately, and several of Enlightenment's binaries are set as setuid,
+allowing Enlightenment's screen locker and other functionality to work as
+expetected.
+
+The desktop environments in Guix use the Xorg display server by default. If
+you'd like to use the newer display server protocol called Wayland, you need
+to use the @code{sddm-service} instead of GDM as the graphical login
+manager. You should then select the ``GNOME (Wayland)'' session in SDDM.
+Alternatively you can also try starting GNOME on Wayland manually from a TTY
+with the command ``XDG_SESSION_TYPE=wayland exec dbus-run-session
+gnome-session``. Currently only GNOME has support for Wayland.
+
address@hidden {Scheme Variable} gnome-desktop-service-type
+This is the type of the service that adds the @uref{https://www.gnome.org,
+GNOME} desktop environment. Its value is a
address@hidden object (see below.)
+
+This service adds the @code{gnome} package to the system profile, and
+extends polkit with the actions from @code{gnome-settings-daemon}.
address@hidden defvr
+
address@hidden {Data Type} gnome-desktop-configuration
+Configuration record for the GNOME desktop environment.
+
address@hidden @asis
address@hidden @code{gnome} (default @code{gnome})
+The GNOME package to use.
address@hidden table
address@hidden deftp
+
address@hidden {Scheme Variable} xfce-desktop-service-type
+This is the type of a service to run the @uref{Xfce, https://xfce.org/}
+desktop environment. Its value is an @code{xfce-desktop-configuration}
+object (see below.)
+
+This service that adds the @code{xfce} package to the system profile, and
+extends polkit with the ability for @code{thunar} to manipulate the file
+system as root from within a user session, after the user has authenticated
+with the administrator's password.
address@hidden defvr
+
address@hidden {Data Type} xfce-desktop-configuration
+Configuration record for the Xfce desktop environment.
+
address@hidden @asis
address@hidden @code{xfce} (default @code{xfce})
+The Xfce package to use.
address@hidden table
address@hidden deftp
+
address@hidden {Scheme Variable} mate-desktop-service-type
+This is the type of the service that runs the
address@hidden://mate-desktop.org/, MATE desktop environment}. Its value is a
address@hidden object (see below.)
+
+This service adds the @code{mate} package to the system profile, and extends
+polkit with the actions from @code{mate-settings-daemon}.
address@hidden deffn
+
address@hidden {Data Type} mate-desktop-configuration
+Configuration record for the MATE desktop environment.
+
address@hidden @asis
address@hidden @code{mate} (default @code{mate})
+The MATE package to use.
address@hidden table
address@hidden deftp
+
address@hidden {Scheme Variable} enlightenment-desktop-service-type
+Return a service that adds the @code{enlightenment} package to the system
+profile, and extends dbus with actions from @code{efl}.
address@hidden deffn
+
address@hidden {Tipo de datos} enlightenment-desktop-service-configuration
address@hidden @asis
address@hidden @code{enlightenment} (predeterminado @code{enlightenment})
+El paquete enlightenment usado.
address@hidden table
address@hidden deftp
+
+Because the GNOME, Xfce and MATE desktop services pull in so many packages,
+the default @code{%desktop-services} variable doesn't include any of them by
+default. To add GNOME, Xfce or MATE, just @code{cons} them onto
address@hidden in the @code{services} field of your
address@hidden:
+
address@hidden
+(use-modules (gnu))
+(use-service-modules desktop)
+(operating-system
+ ...
+ ;; cons* adds items to the list given as its last argument.
+ (services (cons* (service gnome-desktop-service-type)
+ (service xfce-desktop-service)
+ %desktop-services))
+ ...)
address@hidden example
+
+These desktop environments will then be available as options in the
+graphical login window.
+
+The actual service definitions included in @code{%desktop-services} and
+provided by @code{(gnu services dbus)} and @code{(gnu services desktop)} are
+described below.
+
address@hidden {Procedimiento Scheme} dbus-service [#:dbus @var{dbus}]
[#:services '()]
+Return a service that runs the ``system bus'', using @var{dbus}, with
+support for @var{services}.
+
address@hidden://dbus.freedesktop.org/, D-Bus} is an inter-process communication
+facility. Its system bus is used to allow system services to communicate
+and to be notified of system-wide events.
+
address@hidden must be a list of packages that provide an
address@hidden/dbus-1/system.d} directory containing additional D-Bus
+configuration and policy files. For example, to allow avahi-daemon to use
+the system bus, @var{services} must be equal to @code{(list avahi)}.
address@hidden deffn
+
address@hidden {Procedimiento Scheme} elogind-service [#:config @var{config}]
+Return a service that runs the @code{elogind} login and seat management
+daemon. @uref{https://github.com/elogind/elogind, Elogind} exposes a D-Bus
+interface that can be used to know which users are logged in, know what kind
+of sessions they have open, suspend the system, inhibit system suspend,
+reboot the system, and other tasks.
+
+Elogind handles most system-level power events for a computer, for example
+suspending the system when a lid is closed, or shutting it down when the
+power button is pressed.
+
+The @var{config} keyword argument specifies the configuration for elogind,
+and should be the result of an @code{(elogind-configuration (@var{parameter}
address@hidden)...)} invocation. Available parameters and their default values
+are:
+
address@hidden @code
address@hidden kill-user-processes?
address@hidden
address@hidden kill-only-users
address@hidden()}
address@hidden kill-exclude-users
address@hidden("root")}
address@hidden inhibit-delay-max-seconds
address@hidden
address@hidden handle-power-key
address@hidden
address@hidden handle-suspend-key
address@hidden
address@hidden handle-hibernate-key
address@hidden
address@hidden handle-lid-switch
address@hidden
address@hidden handle-lid-switch-docked
address@hidden
address@hidden power-key-ignore-inhibited?
address@hidden
address@hidden suspend-key-ignore-inhibited?
address@hidden
address@hidden hibernate-key-ignore-inhibited?
address@hidden
address@hidden lid-switch-ignore-inhibited?
address@hidden
address@hidden holdoff-timeout-seconds
address@hidden
address@hidden idle-action
address@hidden
address@hidden idle-action-seconds
address@hidden(* 30 60)}
address@hidden runtime-directory-size-percent
address@hidden
address@hidden runtime-directory-size
address@hidden
address@hidden remove-ipc?
address@hidden
address@hidden suspend-state
address@hidden("mem" "standby" "freeze")}
address@hidden suspend-mode
address@hidden()}
address@hidden hibernate-state
address@hidden("disk")}
address@hidden hibernate-mode
address@hidden("platform" "shutdown")}
address@hidden hybrid-sleep-state
address@hidden("disk")}
address@hidden hybrid-sleep-mode
address@hidden("suspend" "platform" "shutdown")}
address@hidden table
address@hidden deffn
+
address@hidden {Procedimiento Scheme} accountsservice-service @
+ [#:accountsservice @var{accountsservice}] Return a service that runs
+AccountsService, a system service that can list available accounts, change
+their passwords, and so on. AccountsService integrates with PolicyKit to
+enable unprivileged users to acquire the capability to modify their system
+configuration.
address@hidden://www.freedesktop.org/wiki/Software/AccountsService/, the
+accountsservice web site} for more information.
+
+The @var{accountsservice} keyword argument is the @code{accountsservice}
+package to expose as a service.
address@hidden deffn
+
address@hidden {Procedimiento Scheme} polkit-service @
+ [#:polkit @var{polkit}] Return a service that runs the
address@hidden://www.freedesktop.org/wiki/Software/polkit/, Polkit privilege
+management service}, which allows system administrators to grant access to
+privileged operations in a structured way. By querying the Polkit service,
+a privileged system component can know when it should grant additional
+capabilities to ordinary users. For example, an ordinary user can be
+granted the capability to suspend the system if the user is logged in
+locally.
address@hidden deffn
+
address@hidden {Scheme Variable} upower-service-type
+Service that runs @uref{http://upower.freedesktop.org/, @command{upowerd}},
+a system-wide monitor for power consumption and battery levels, with the
+given configuration settings.
+
+It implements the @code{org.freedesktop.UPower} D-Bus interface, and is
+notably used by GNOME.
address@hidden defvr
+
address@hidden {Data Type} upower-configuration
+Data type representation the configuration for UPower.
+
address@hidden @asis
+
address@hidden @code{upower} (default: @var{upower})
+Package to use for @code{upower}.
+
address@hidden @code{watts-up-pro?} (default: @code{#f})
+Enable the Watts Up Pro device.
+
address@hidden @code{poll-batteries?} (default: @code{#t})
+Enable polling the kernel for battery level changes.
+
address@hidden @code{ignore-lid?} (default: @code{#f})
+Ignore the lid state, this can be useful if it's incorrect on a device.
+
address@hidden @code{use-percentage-for-policy?} (default: @code{#f})
+Whether battery percentage based policy should be used. The default is to
+use the time left, change to @code{#t} to use the percentage.
+
address@hidden @code{percentage-low} (default: @code{10})
+When @code{use-percentage-for-policy?} is @code{#t}, this sets the
+percentage at which the battery is considered low.
+
address@hidden @code{percentage-critical} (default: @code{3})
+When @code{use-percentage-for-policy?} is @code{#t}, this sets the
+percentage at which the battery is considered critical.
+
address@hidden @code{percentage-action} (default: @code{2})
+When @code{use-percentage-for-policy?} is @code{#t}, this sets the
+percentage at which action will be taken.
+
address@hidden @code{time-low} (default: @code{1200})
+When @code{use-time-for-policy?} is @code{#f}, this sets the time remaining
+in seconds at which the battery is considered low.
+
address@hidden @code{time-critical} (default: @code{300})
+When @code{use-time-for-policy?} is @code{#f}, this sets the time remaining
+in seconds at which the battery is considered critical.
+
address@hidden @code{time-action} (default: @code{120})
+When @code{use-time-for-policy?} is @code{#f}, this sets the time remaining
+in seconds at which action will be taken.
+
address@hidden @code{critical-power-action} (default: @code{'hybrid-sleep})
+The action taken when @code{percentage-action} or @code{time-action} is
+reached (depending on the configuration of
address@hidden).
+
+Possible values are:
+
address@hidden @bullet
address@hidden
address@hidden'power-off}
+
address@hidden
address@hidden'hibernate}
+
address@hidden
address@hidden'hybrid-sleep}.
address@hidden itemize
+
address@hidden table
address@hidden deftp
+
address@hidden {Procedimiento Scheme} udisks-service [#:udisks @var{udisks}]
+Return a service for @uref{http://udisks.freedesktop.org/docs/latest/,
+UDisks}, a @dfn{disk management} daemon that provides user interfaces with
+notifications and ways to mount/unmount disks. Programs that talk to UDisks
+include the @command{udisksctl} command, part of UDisks, and GNOME Disks.
address@hidden deffn
+
address@hidden {Procedimiento Scheme} colord-service [#:colord @var{colord}]
+Return a service that runs @command{colord}, a system service with a D-Bus
+interface to manage the color profiles of input and output devices such as
+screens and scanners. It is notably used by the GNOME Color Manager
+graphical tool. See @uref{http://www.freedesktop.org/software/colord/, the
+colord web site} for more information.
address@hidden deffn
+
address@hidden {Scheme Procedure} geoclue-application name [#:allowed? #t]
[#:system? #f] [#:users '()]
+Return a configuration allowing an application to access GeoClue location
+data. @var{name} is the Desktop ID of the application, without the
address@hidden part. If @var{allowed?} is true, the application will have
+access to location information by default. The boolean @var{system?} value
+indicates whether an application is a system component or not. Finally
address@hidden is a list of UIDs of all users for which this application is
+allowed location info access. An empty users list means that all users are
+allowed.
address@hidden deffn
+
address@hidden {Variable Scheme} %standard-geoclue-applications
+The standard list of well-known GeoClue application configurations, granting
+authority to the GNOME date-and-time utility to ask for the current location
+in order to set the time zone, and allowing the IceCat and Epiphany web
+browsers to request location information. IceCat and Epiphany both query
+the user before allowing a web page to know the user's location.
address@hidden defvr
+
address@hidden {Procedimiento Scheme} geoclue-service [#:colord @var{colord}] @
+ [#:whitelist '()] @ [#:wifi-geolocation-url
+"https://location.services.mozilla.com/v1/geolocate?key=geoclue";] @
+[#:submit-data? #f] [#:wifi-submission-url
+"https://location.services.mozilla.com/v1/submit?key=geoclue";] @
+[#:submission-nick "geoclue"] @ [#:applications
+%standard-geoclue-applications] Return a service that runs the GeoClue
+location service. This service provides a D-Bus interface to allow
+applications to request access to a user's physical location, and optionally
+to add information to online location databases. See
address@hidden://wiki.freedesktop.org/www/Software/GeoClue/, the GeoClue web
+site} for more information.
address@hidden deffn
+
address@hidden {Procedimiento Scheme} bluetooth-service [#:bluez @var{bluez}] @
+ address@hidden:auto-enable? #f}] Return a service that runs the
@command{bluetoothd}
+daemon, which manages all the Bluetooth devices and provides a number of
+D-Bus interfaces. When AUTO-ENABLE? is true, the bluetooth controller is
+powered automatically at boot, which can be useful when using a bluetooth
+keyboard or mouse.
+
+Users need to be in the @code{lp} group to access the D-Bus service.
address@hidden deffn
+
address@hidden Servicios de sonido
address@hidden Servicios de sonido
+
address@hidden sound support
address@hidden ALSA
address@hidden PulseAudio, sound support
+
+The @code{(gnu services sound)} module provides a service to configure the
+Advanced Linux Sound Architecture (ALSA) system, which makes PulseAudio the
+preferred ALSA output driver.
+
address@hidden {Variable Scheme} alsa-service-type
+This is the type for the @uref{https://alsa-project.org/, Advanced Linux
+Sound Architecture} (ALSA) system, which generates the
address@hidden/etc/asound.conf} configuration file. The value for this type is
a
address@hidden record as in this example:
+
address@hidden
+(service alsa-service-type)
address@hidden example
+
+See below for details about @code{alsa-configuration}.
address@hidden deffn
+
address@hidden {Tipo de datos} alsa-configuration
+Data type representing the configuration for @code{alsa-service}.
+
address@hidden @asis
address@hidden @code{alsa-plugins} (predeterminados: @var{alsa-plugins})
+El paquete @code{alsa-plugins} usado.
+
address@hidden @code{pulseaudio?} (predeterminado: @var{#t})
+Whether ALSA applications should transparently be made to use the
address@hidden://www.pulseaudio.org/, PulseAudio} sound server.
+
+Using PulseAudio allows you to run several sound-producing applications at
+the same time and to individual control them @i{via} @command{pavucontrol},
+among other things.
+
address@hidden @code{extra-options} (predeterminado: @var{""})
+String to append to the @file{/etc/asound.conf} file.
+
address@hidden table
address@hidden deftp
+
+Individual users who want to override the system configuration of ALSA can
+do it with the @file{~/.asoundrc} file:
+
address@hidden
+# In guix, we have to specify the absolute path for plugins.
+pcm_type.jack @{
+ lib "/home/alice/.guix-profile/lib/alsa-lib/libasound_module_pcm_jack.so"
address@hidden
+
+# Routing ALSA to jack:
+# <http://jackaudio.org/faq/routing_alsa.html>.
+pcm.rawjack @{
+ type jack
+ playback_ports @{
+ 0 system:playback_1
+ 1 system:playback_2
+ @}
+
+ capture_ports @{
+ 0 system:capture_1
+ 1 system:capture_2
+ @}
address@hidden
+
+pcm.!default @{
+ type plug
+ slave @{
+ pcm "rawjack"
+ @}
address@hidden
address@hidden example
+
+See @uref{https://www.alsa-project.org/main/index.php/Asoundrc} for the
+details.
+
+
address@hidden Servicios de bases de datos
address@hidden Servicios de bases de datos
+
address@hidden base de datos
address@hidden SQL
+El módulo @code{(gnu services databases)} proporciona los siguientes
+servicios.
+
address@hidden {Procedimiento Scheme} postgresql-service [#:postgresql
postgresql] @
+ [#:config-file] [#:data-directory ``/var/lib/postgresql/data''] @
[#:port
+5432] [#:locale ``en_US.utf8''] [#:extension-packages '()] Return a service
+that runs @var{postgresql}, the PostgreSQL database server.
+
+The PostgreSQL daemon loads its runtime configuration from
address@hidden, creates a database cluster with @var{locale} as the
+default locale, stored in @var{data-directory}. It then listens on
address@hidden
+
address@hidden postgresql extension-packages
+Additional extensions are loaded from packages listed in
address@hidden Extensions are available at runtime. For
+instance, to create a geographic database using the @code{postgis}
+extension, a user can configure the postgresql-service as in this example:
+
address@hidden postgis
address@hidden
+(use-package-modules databases geo)
+
+(operating-system
+ ...
+ ;; postgresql is required to run `psql' but postgis is not required for
+ ;; proper operation.
+ (packages (cons* postgresql %base-packages))
+ (services
+ (cons*
+ (postgresql-service #:extension-packages (list postgis))
+ %base-services)))
address@hidden example
+
+Then the extension becomes visible and you can initialise an empty
+geographic database in this way:
+
address@hidden
+psql -U postgres
+> create database postgistest;
+> \connect postgistest;
+> create extension postgis;
+> create extension postgis_topology;
address@hidden example
+
+There is no need to add this field for contrib extensions such as hstore or
+dblink as they are already loadable by postgresql. This field is only
+required to add extensions provided by other packages.
address@hidden deffn
+
address@hidden {Procedimiento Scheme} mysql-service [#:config
(mysql-configuration)]
+Return a service that runs @command{mysqld}, the MySQL or MariaDB database
+server.
+
+El parámetro opcional @var{config} especifica la configuración para
address@hidden, que debe ser un objeto @code{<mysql-configuration>}.
address@hidden deffn
+
address@hidden {Tipo de datos} mysql-configuration
+Data type representing the configuration of @var{mysql-service}.
+
address@hidden @asis
address@hidden @code{mysql} (predeterminado: @var{mariadb})
+Package object of the MySQL database server, can be either @var{mariadb} or
address@hidden
+
+For MySQL, a temporary root password will be displayed at activation time.
+For MariaDB, the root password is empty.
+
address@hidden @code{port} (predeterminado: @code{3306})
+TCP port on which the database server listens for incoming connections.
address@hidden table
address@hidden deftp
+
address@hidden {Variable Scheme} memcached-service-type
+This is the service type for the @uref{https://memcached.org/, Memcached}
+service, which provides a distributed in memory cache. The value for the
+service type is a @code{memcached-configuration} object.
address@hidden defvr
+
address@hidden
+(service memcached-service-type)
address@hidden example
+
address@hidden {Tipo de datos} memcached-configuration
+Data type representing the configuration of memcached.
+
address@hidden @asis
address@hidden @code{memcached} (predeterminado: @code{memcached})
+El paquete de Memcached usado.
+
address@hidden @code{interfaces} (predeterminadas: @code{'("0.0.0.0")})
+Network interfaces on which to listen.
+
address@hidden @code{tcp-port} (predeterminado: @code{11211})
+Port on which to accept connections on,
+
address@hidden @code{udp-port} (predeterminado: @code{11211})
+Port on which to accept UDP connections on, a value of 0 will disable
+listening on a UDP socket.
+
address@hidden @code{additional-options} (predeterminadas: @code{'()})
+Additional command line options to pass to @code{memcached}.
address@hidden table
address@hidden deftp
+
address@hidden {Variable Scheme} mongodb-service-type
+This is the service type for @uref{https://www.mongodb.com/, MongoDB}. The
+value for the service type is a @code{mongodb-configuration} object.
address@hidden defvr
+
address@hidden
+(service mongodb-service-type)
address@hidden example
+
address@hidden {Tipo de datos} mongodb-configuration
+Tipo de datos que representa la configuración de GPM.
+
address@hidden @asis
address@hidden @code{mongodb} (predeterminado: @code{mongodb})
+El paquete MongoDB usado.
+
address@hidden @code{config-file} (predeterminado:
@code{%default-mongodb-configuration-file})
+The configuration file for MongoDB.
+
address@hidden @code{data-directory} (predeterminado: @code{"/var/lib/mongodb"})
+This value is used to create the directory, so that it exists and is owned
+by the mongodb user. It should match the data-directory which MongoDB is
+configured to use through the configuration file.
address@hidden table
address@hidden deftp
+
address@hidden {Variable Scheme} redis-service-type
+This is the service type for the @uref{https://redis.io/, Redis} key/value
+store, whose value is a @code{redis-configuration} object.
address@hidden defvr
+
address@hidden {Tipo de datos} redis-configuration
+Data type representing the configuration of redis.
+
address@hidden @asis
address@hidden @code{redis} (predeterminado: @code{redis})
+The Redis package to use.
+
address@hidden @code{bind} (predeterminada: @code{"127.0.0.1"})
+La interfaz de red en la que se escucha.
+
address@hidden @code{port} (predeterminado: @code{6379})
+Port on which to accept connections on, a value of 0 will disable listening
+on a TCP socket.
+
address@hidden @code{working-directory} (predeterminado:
@code{"/var/lib/redis"})
+Directory in which to store the database and related files.
address@hidden table
address@hidden deftp
+
address@hidden Servicios de correo
address@hidden Servicios de correo
+
address@hidden mail
address@hidden email
+The @code{(gnu services mail)} module provides Guix service definitions for
+email services: IMAP, POP3, and LMTP servers, as well as mail transport
+agents (MTAs). Lots of acronyms! These services are detailed in the
+subsections below.
+
address@hidden Servicio Dovecot
+
address@hidden {Procedimiento Scheme} dovecot-service [#:config
(dovecot-configuration)]
+Return a service that runs the Dovecot IMAP/POP3/LMTP mail server.
address@hidden deffn
+
+By default, Dovecot does not need much configuration; the default
+configuration object created by @code{(dovecot-configuration)} will suffice
+if your mail is delivered to @code{~/Maildir}. A self-signed certificate
+will be generated for TLS-protected connections, though Dovecot will also
+listen on cleartext ports by default. There are a number of options,
+though, which mail administrators might need to change, and as is the case
+with other services, Guix allows the system administrator to specify these
+parameters via a uniform Scheme interface.
+
+Por ejemplo, para especificar que el correo se encuentra en
address@hidden:~/.correo}, se debe instanciar el servicio de Dovecot de esta
+manera:
+
address@hidden
+(dovecot-service #:config
+ (dovecot-configuration
+ (mail-location "maildir:~/.correo")))
address@hidden example
+
+The available configuration parameters follow. Each parameter definition is
+preceded by its type; for example, @samp{string-list foo} indicates that the
address@hidden parameter should be specified as a list of strings. There is
+also a way to specify the configuration as a string, if you have an old
address@hidden file that you want to port over from some other system;
+see the end for more details.
+
address@hidden The following documentation was initially generated by
address@hidden (generate-documentation) in (gnu services mail). Manually
maintained
address@hidden documentation is better, so we shouldn't hesitate to edit below
as
address@hidden needed. However if the change you want to make to this
documentation
address@hidden can be done in an automated way, it's probably easier to change
address@hidden (generate-documentation) than to make it below and have to deal
with
address@hidden the churn as dovecot updates.
+
+Available @code{dovecot-configuration} fields are:
+
address@hidden address@hidden parameter} package dovecot
+El paquete dovecot.
address@hidden deftypevr
+
address@hidden address@hidden parameter} comma-separated-string-list listen
+A list of IPs or hosts where to listen for connections. @samp{*} listens on
+all IPv4 interfaces, @samp{::} listens on all IPv6 interfaces. If you want
+to specify non-default ports or anything more complex, customize the address
+and port fields of the @samp{inet-listener} of the specific services you are
+interested in.
address@hidden deftypevr
+
address@hidden address@hidden parameter} protocol-configuration-list protocols
+List of protocols we want to serve. Available protocols include
address@hidden, @samp{pop3}, and @samp{lmtp}.
+
+Available @code{protocol-configuration} fields are:
+
address@hidden address@hidden parameter} string name
+El nombre del protocolo.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string auth-socket-path
+UNIX socket path to the master authentication server to find users. This is
+used by imap (for shared users) and lda. It defaults to
address@hidden"/var/run/dovecot/auth-userdb"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} space-separated-string-list
mail-plugins
+Space separated list of plugins to load.
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer
mail-max-userip-connections
+Maximum number of IMAP connections allowed for a user from each IP address.
+NOTE: The username is compared case-sensitively. Defaults to @samp{10}.
address@hidden deftypevr
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} service-configuration-list services
+List of services to enable. Available services include @samp{imap},
address@hidden, @samp{pop3}, @samp{pop3-login}, @samp{auth}, and
address@hidden
+
+Available @code{service-configuration} fields are:
+
address@hidden address@hidden parameter} string kind
+The service kind. Valid values include @code{director}, @code{imap-login},
address@hidden, @code{lmtp}, @code{imap}, @code{pop3}, @code{auth},
address@hidden, @code{dict}, @code{tcpwrap}, @code{quota-warning}, or
+anything else.
address@hidden deftypevr
+
address@hidden address@hidden parameter} listener-configuration-list listeners
+Listeners for the service. A listener is either a
address@hidden, a @code{fifo-listener-configuration}, or
+an @code{inet-listener-configuration}. Defaults to @samp{()}.
+
+Available @code{unix-listener-configuration} fields are:
+
address@hidden address@hidden parameter} string path
+Path to the file, relative to @code{base-dir} field. This is also used as
+the section name.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string mode
+The access mode for the socket. Defaults to @samp{"0600"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string user
+The user to own the socket. Defaults to @samp{""}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string group
+The group to own the socket. Defaults to @samp{""}.
address@hidden deftypevr
+
+
+Available @code{fifo-listener-configuration} fields are:
+
address@hidden address@hidden parameter} string path
+Path to the file, relative to @code{base-dir} field. This is also used as
+the section name.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string mode
+The access mode for the socket. Defaults to @samp{"0600"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string user
+The user to own the socket. Defaults to @samp{""}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string group
+The group to own the socket. Defaults to @samp{""}.
address@hidden deftypevr
+
+
+Available @code{inet-listener-configuration} fields are:
+
address@hidden address@hidden parameter} string protocol
+The protocol to listen for.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string address
+The address on which to listen, or empty for all addresses. Defaults to
address@hidden""}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer port
+The port on which to listen.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean ssl?
+Whether to use SSL for this service; @samp{yes}, @samp{no}, or
address@hidden Defaults to @samp{#t}.
address@hidden deftypevr
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer client-limit
+Maximum number of simultaneous client connections per process. Once this
+number of connections is received, the next incoming connection will prompt
+Dovecot to spawn another process. If set to 0, @code{default-client-limit}
+is used instead.
+
+El valor predeterminado es @samp{0}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer service-count
+Number of connections to handle before starting a new process. Typically
+the only useful values are 0 (unlimited) or 1. 1 is more secure, but 0 is
+faster. <doc/wiki/LoginProcess.txt>. Defaults to @samp{1}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer process-limit
+Maximum number of processes that can exist for this service. If set to 0,
address@hidden is used instead.
+
+El valor predeterminado es @samp{0}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer process-min-avail
+Number of processes to always keep waiting for more connections. Defaults
+to @samp{0}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer vsz-limit
+If you set @samp{service-count 0}, you probably need to grow this. Defaults
+to @samp{256000000}.
address@hidden deftypevr
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} dict-configuration dict
+Dict configuration, as created by the @code{dict-configuration} constructor.
+
+Available @code{dict-configuration} fields are:
+
address@hidden address@hidden parameter} free-form-fields entries
+A list of key-value pairs that this dict should hold. Defaults to
address@hidden()}.
address@hidden deftypevr
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} passdb-configuration-list passdbs
+A list of passdb configurations, each one created by the
address@hidden constructor.
+
+Available @code{passdb-configuration} fields are:
+
address@hidden address@hidden parameter} string driver
+The driver that the passdb should use. Valid values include @samp{pam},
address@hidden, @samp{shadow}, @samp{bsdauth}, and @samp{static}. Defaults
+to @samp{"pam"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} space-separated-string-list args
+Space separated list of arguments to the passdb driver. Defaults to
address@hidden""}.
address@hidden deftypevr
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} userdb-configuration-list userdbs
+List of userdb configurations, each one created by the
address@hidden constructor.
+
+Available @code{userdb-configuration} fields are:
+
address@hidden address@hidden parameter} string driver
+The driver that the userdb should use. Valid values include @samp{passwd}
+and @samp{static}. Defaults to @samp{"passwd"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} space-separated-string-list args
+Space separated list of arguments to the userdb driver. Defaults to
address@hidden""}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} free-form-args override-fields
+Override fields from passwd. Defaults to @samp{()}.
address@hidden deftypevr
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} plugin-configuration
plugin-configuration
+Plug-in configuration, created by the @code{plugin-configuration}
+constructor.
address@hidden deftypevr
+
address@hidden address@hidden parameter} list-of-namespace-configuration
namespaces
+List of namespaces. Each item in the list is created by the
address@hidden constructor.
+
+Available @code{namespace-configuration} fields are:
+
address@hidden address@hidden parameter} string name
+Name for this namespace.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string type
+Namespace type: @samp{private}, @samp{shared} or @samp{public}. Defaults to
address@hidden"private"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string separator
+Hierarchy separator to use. You should use the same separator for all
+namespaces or some clients get confused. @samp{/} is usually a good one.
+The default however depends on the underlying mail storage format. Defaults
+to @samp{""}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string prefix
+Prefix required to access this namespace. This needs to be different for
+all namespaces. For example @samp{Public/}. Defaults to @samp{""}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string location
+Physical location of the mailbox. This is in the same format as
+mail_location, which is also the default for it. Defaults to @samp{""}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean inbox?
+There can be only one INBOX, and this setting defines which namespace has
+it. Defaults to @samp{#f}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean hidden?
+If namespace is hidden, it's not advertised to clients via NAMESPACE
+extension. You'll most likely also want to set @samp{list? #f}. This is
+mostly useful when converting from another server with different namespaces
+which you want to deprecate but still keep working. For example you can
+create hidden namespaces with prefixes @samp{~/mail/}, @samp{~%u/mail/} and
address@hidden/}. Defaults to @samp{#f}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean list?
+Show the mailboxes under this namespace with the LIST command. This makes
+the namespace visible for clients that do not support the NAMESPACE
+extension. The special @code{children} value lists child mailboxes, but
+hides the namespace prefix. Defaults to @samp{#t}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean subscriptions?
+Namespace handles its own subscriptions. If set to @code{#f}, the parent
+namespace handles them. The empty prefix should always have this as
address@hidden). Defaults to @samp{#t}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} mailbox-configuration-list mailboxes
+List of predefined mailboxes in this namespace. Defaults to @samp{()}.
+
+Available @code{mailbox-configuration} fields are:
+
address@hidden address@hidden parameter} string name
+Name for this mailbox.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string auto
address@hidden will automatically create this mailbox. @samp{subscribe} will
+both create and subscribe to the mailbox. Defaults to @samp{"no"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} space-separated-string-list special-use
+List of IMAP @code{SPECIAL-USE} attributes as specified by RFC 6154. Valid
+values are @code{\All}, @code{\Archive}, @code{\Drafts}, @code{\Flagged},
address@hidden, @code{\Sent}, and @code{\Trash}. Defaults to @samp{()}.
address@hidden deftypevr
+
address@hidden deftypevr
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} file-name base-dir
+Base directory where to store runtime data. Defaults to
address@hidden"/var/run/dovecot/"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string login-greeting
+Greeting message for clients. Defaults to @samp{"Dovecot ready."}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} space-separated-string-list
login-trusted-networks
+List of trusted network ranges. Connections from these IPs are allowed to
+override their IP addresses and ports (for logging and for authentication
+checks). @samp{disable-plaintext-auth} is also ignored for these networks.
+Typically you would specify your IMAP proxy servers here. Defaults to
address@hidden()}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} space-separated-string-list
login-access-sockets
+List of login access check sockets (e.g.@: tcpwrap). Defaults to @samp{()}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean verbose-proctitle?
+Show more verbose process titles (in ps). Currently shows user name and IP
+address. Useful for seeing who is actually using the IMAP processes (e.g.@:
+shared mailboxes or if the same uid is used for multiple accounts).
+Defaults to @samp{#f}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean shutdown-clients?
+Should all processes be killed when Dovecot master process shuts down.
+Setting this to @code{#f} means that Dovecot can be upgraded without forcing
+existing client connections to close (although that could also be a problem
+if the upgrade is e.g.@: due to a security fix). Defaults to @samp{#t}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer
doveadm-worker-count
+If non-zero, run mail commands via this many connections to doveadm server,
+instead of running them directly in the same process. Defaults to @samp{0}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string doveadm-socket-path
+UNIX socket or host:port used for connecting to doveadm server. Defaults to
address@hidden"doveadm-server"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} space-separated-string-list
import-environment
+List of environment variables that are preserved on Dovecot startup and
+passed down to all of its child processes. You can also give key=value
+pairs to always set specific settings.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean disable-plaintext-auth?
+Disable LOGIN command and all other plaintext authentications unless SSL/TLS
+is used (LOGINDISABLED capability). Note that if the remote IP matches the
+local IP (i.e.@: you're connecting from the same computer), the connection
+is considered secure and plaintext authentication is allowed. See also
+ssl=required setting. Defaults to @samp{#t}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer auth-cache-size
+Authentication cache size (e.g.@: @samp{#e10e6}). 0 means it's disabled.
+Note that bsdauth, PAM and vpopmail require @samp{cache-key} to be set for
+caching to be used. Defaults to @samp{0}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string auth-cache-ttl
+Time to live for cached data. After TTL expires the cached record is no
+longer used, *except* if the main database lookup returns internal failure.
+We also try to handle password changes automatically: If user's previous
+authentication was successful, but this one wasn't, the cache isn't used.
+For now this works only with plaintext authentication. Defaults to @samp{"1
+hour"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string auth-cache-negative-ttl
+TTL for negative hits (user not found, password mismatch). 0 disables
+caching them completely. Defaults to @samp{"1 hour"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} space-separated-string-list auth-realms
+List of realms for SASL authentication mechanisms that need them. You can
+leave it empty if you don't want to support multiple realms. Many clients
+simply use the first one listed here, so keep the default realm first.
+Defaults to @samp{()}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string auth-default-realm
+Default realm/domain to use if none was specified. This is used for both
+SASL realms and appending @@domain to username in plaintext logins.
+Defaults to @samp{""}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string auth-username-chars
+List of allowed characters in username. If the user-given username contains
+a character not listed in here, the login automatically fails. This is just
+an extra check to make sure user can't exploit any potential quote escaping
+vulnerabilities with SQL/LDAP databases. If you want to allow all
+characters, set this value to empty. Defaults to
address@hidden"abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ01234567890.-_@@"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string auth-username-translation
+Username character translations before it's looked up from databases. The
+value contains series of from -> to characters. For example @samp{#@@/@@}
+means that @samp{#} and @samp{/} characters are translated to @samp{@@}.
+Defaults to @samp{""}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string auth-username-format
+Username formatting before it's looked up from databases. You can use the
+standard variables here, e.g.@: %Lu would lowercase the username, %n would
+drop away the domain if it was given, or @samp{%n-AT-%d} would change the
address@hidden@@} into @samp{-AT-}. This translation is done after
address@hidden changes. Defaults to @samp{"%Lu"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string auth-master-user-separator
+If you want to allow master users to log in by specifying the master
+username within the normal username string (i.e.@: not using SASL
+mechanism's support for it), you can specify the separator character here.
+The format is then <username><separator><master username>. UW-IMAP uses
address@hidden as the separator, so that could be a good choice. Defaults to
address@hidden""}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string auth-anonymous-username
+Username to use for users logging in with ANONYMOUS SASL mechanism.
+Defaults to @samp{"anonymous"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer
auth-worker-max-count
+Maximum number of dovecot-auth worker processes. They're used to execute
+blocking passdb and userdb queries (e.g.@: MySQL and PAM). They're
+automatically created and destroyed as needed. Defaults to @samp{30}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string auth-gssapi-hostname
+Host name to use in GSSAPI principal names. The default is to use the name
+returned by gethostname(). Use @samp{$ALL} (with quotes) to allow all
+keytab entries. Defaults to @samp{""}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string auth-krb5-keytab
+Kerberos keytab to use for the GSSAPI mechanism. Will use the system
+default (usually @file{/etc/krb5.keytab}) if not specified. You may need to
+change the auth service to run as root to be able to read this file.
+Defaults to @samp{""}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean auth-use-winbind?
+Do NTLM and GSS-SPNEGO authentication using Samba's winbind daemon and
address@hidden helper. <doc/wiki/Authentication/Mechanisms/Winbind.txt>.
+Defaults to @samp{#f}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} file-name auth-winbind-helper-path
+Path for Samba's @samp{ntlm-auth} helper binary. Defaults to
address@hidden"/usr/bin/ntlm_auth"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string auth-failure-delay
+Time to delay before replying to failed authentications. Defaults to
address@hidden"2 secs"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean auth-ssl-require-client-cert?
+Require a valid SSL client certificate or the authentication fails.
+Defaults to @samp{#f}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean auth-ssl-username-from-cert?
+Take the username from client's SSL certificate, using
address@hidden()} which returns the subject's DN's
+CommonName. Defaults to @samp{#f}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} space-separated-string-list
auth-mechanisms
+List of wanted authentication mechanisms. Supported mechanisms are:
address@hidden, @samp{login}, @samp{digest-md5}, @samp{cram-md5}, @samp{ntlm},
address@hidden, @samp{apop}, @samp{anonymous}, @samp{gssapi}, @samp{otp},
address@hidden, and @samp{gss-spnego}. NOTE: See also
address@hidden setting.
address@hidden deftypevr
+
address@hidden address@hidden parameter} space-separated-string-list
director-servers
+List of IPs or hostnames to all director servers, including ourself. Ports
+can be specified as ip:port. The default port is the same as what director
+service's @samp{inet-listener} is using. Defaults to @samp{()}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} space-separated-string-list
director-mail-servers
+List of IPs or hostnames to all backend mail servers. Ranges are allowed
+too, like 10.0.0.10-10.0.0.30. Defaults to @samp{()}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string director-user-expire
+How long to redirect users to a specific server after it no longer has any
+connections. Defaults to @samp{"15 min"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string director-username-hash
+How the username is translated before being hashed. Useful values include
+%Ln if user can log in with or without @@domain, %Ld if mailboxes are shared
+within domain. Defaults to @samp{"%Lu"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string log-path
+Log file to use for error messages. @samp{syslog} logs to syslog,
address@hidden/dev/stderr} logs to stderr. Defaults to @samp{"syslog"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string info-log-path
+Log file to use for informational messages. Defaults to @samp{log-path}.
+Defaults to @samp{""}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string debug-log-path
+Log file to use for debug messages. Defaults to @samp{info-log-path}.
+Defaults to @samp{""}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string syslog-facility
+Syslog facility to use if you're logging to syslog. Usually if you don't
+want to use @samp{mail}, you'll use local0..local7. Also other standard
+facilities are supported. Defaults to @samp{"mail"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean auth-verbose?
+Log unsuccessful authentication attempts and the reasons why they failed.
+Defaults to @samp{#f}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean auth-verbose-passwords?
+In case of password mismatches, log the attempted password. Valid values
+are no, plain and sha1. sha1 can be useful for detecting brute force
+password attempts vs. user simply trying the same password over and over
+again. You can also truncate the value to n chars by appending ":n" (e.g.@:
+sha1:6). Defaults to @samp{#f}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean auth-debug?
+Even more verbose logging for debugging purposes. Shows for example SQL
+queries. Defaults to @samp{#f}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean auth-debug-passwords?
+In case of password mismatches, log the passwords and used scheme so the
+problem can be debugged. Enabling this also enables @samp{auth-debug}.
+Defaults to @samp{#f}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean mail-debug?
+Enable mail process debugging. This can help you figure out why Dovecot
+isn't finding your mails. Defaults to @samp{#f}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean verbose-ssl?
+Show protocol level SSL errors. Defaults to @samp{#f}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string log-timestamp
+Prefix for each line written to log file. % codes are in strftime(3)
+format. Defaults to @samp{"\"%b %d %H:%M:%S \""}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} space-separated-string-list
login-log-format-elements
+List of elements we want to log. The elements which have a non-empty
+variable value are joined together to form a comma-separated string.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string login-log-format
+Login log format. %s contains @samp{login-log-format-elements} string, %$
+contains the data we want to log. Defaults to @samp{"%$: %s"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string mail-log-prefix
+Log prefix for mail processes. See doc/wiki/Variables.txt for list of
+possible variables you can use. Defaults to
address@hidden"\"%s(%u)<address@hidden@}><address@hidden@}>: \""}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string deliver-log-format
+Format to use for logging mail deliveries. You can use variables:
address@hidden @code
address@hidden %$
+Delivery status message (e.g.@: @samp{saved to INBOX})
address@hidden %m
+Message-ID
address@hidden %s
+Subject
address@hidden %f
+From address
address@hidden %p
+Tamaño físico
address@hidden %w
+Tamaño virtual.
address@hidden table
+Defaults to @samp{"msgid=%m: %$"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string mail-location
+Location for users' mailboxes. The default is empty, which means that
+Dovecot tries to find the mailboxes automatically. This won't work if the
+user doesn't yet have any mail, so you should explicitly tell Dovecot the
+full location.
+
+If you're using mbox, giving a path to the INBOX file (e.g.@: /var/mail/%u)
+isn't enough. You'll also need to tell Dovecot where the other mailboxes
+are kept. This is called the "root mail directory", and it must be the
+first path given in the @samp{mail-location} setting.
+
+There are a few special variables you can use, eg.:
+
address@hidden @samp
address@hidden %u
+username
address@hidden %n
+user part in user@@domain, same as %u if there's no domain
address@hidden %d
+domain part in user@@domain, empty if there's no domain
address@hidden %h
+home director
address@hidden table
+
+See doc/wiki/Variables.txt for full list. Some examples:
address@hidden @samp
address@hidden maildir:~/Maildir
address@hidden mbox:~/mail:INBOX=/var/mail/%u
address@hidden mbox:/var/mail/%d/%1n/%n:INDEX=/var/indexes/%d/%1n/%
address@hidden table
+El valor predeterminado es @samp{""}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string mail-uid
+System user and group used to access mails. If you use multiple, userdb can
+override these by returning uid or gid fields. You can use either numbers
+or names. <doc/wiki/UserIds.txt>. Defaults to @samp{""}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string mail-gid
+
+El valor predeterminado es @samp{""}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string mail-privileged-group
+Group to enable temporarily for privileged operations. Currently this is
+used only with INBOX when either its initial creation or dotlocking fails.
+Typically this is set to "mail" to give access to /var/mail. Defaults to
address@hidden""}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string mail-access-groups
+Grant access to these supplementary groups for mail processes. Typically
+these are used to set up access to shared mailboxes. Note that it may be
+dangerous to set these if users can create symlinks (e.g.@: if "mail" group
+is set here, ln -s /var/mail ~/mail/var could allow a user to delete others'
+mailboxes, or ln -s /secret/shared/box ~/mail/mybox would allow reading
+it). Defaults to @samp{""}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean mail-full-filesystem-access?
+Allow full file system access to clients. There's no access checks other
+than what the operating system does for the active UID/GID. It works with
+both maildir and mboxes, allowing you to prefix mailboxes names with e.g.@:
+/path/ or ~user/. Defaults to @samp{#f}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean mmap-disable?
+Don't use mmap() at all. This is required if you store indexes to shared
+file systems (NFS or clustered file system). Defaults to @samp{#f}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean dotlock-use-excl?
+Rely on @samp{O_EXCL} to work when creating dotlock files. NFS supports
address@hidden since version 3, so this should be safe to use nowadays by
+default. Defaults to @samp{#t}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string mail-fsync
+When to use fsync() or fdatasync() calls:
address@hidden @code
address@hidden optimized
+Whenever necessary to avoid losing important data
address@hidden always
+Useful with e.g.@: NFS when write()s are delayed
address@hidden never
+Never use it (best performance, but crashes can lose data).
address@hidden table
+Defaults to @samp{"optimized"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean mail-nfs-storage?
+Mail storage exists in NFS. Set this to yes to make Dovecot flush NFS
+caches whenever needed. If you're using only a single mail server this
+isn't needed. Defaults to @samp{#f}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean mail-nfs-index?
+Mail index files also exist in NFS. Setting this to yes requires
address@hidden #t} and @samp{fsync-disable? #f}. Defaults to
address@hidden
address@hidden deftypevr
+
address@hidden address@hidden parameter} string lock-method
+Locking method for index files. Alternatives are fcntl, flock and dotlock.
+Dotlocking uses some tricks which may create more disk I/O than other
+locking methods. NFS users: flock doesn't work, remember to change
address@hidden Defaults to @samp{"fcntl"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} file-name mail-temp-dir
+Directory in which LDA/LMTP temporarily stores incoming mails >128 kB.
+Defaults to @samp{"/tmp"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer first-valid-uid
+Valid UID range for users. This is mostly to make sure that users can't log
+in as daemons or other system users. Note that denying root logins is
+hardcoded to dovecot binary and can't be done even if @samp{first-valid-uid}
+is set to 0. Defaults to @samp{500}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer last-valid-uid
+
+El valor predeterminado es @samp{0}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer first-valid-gid
+Valid GID range for users. Users having non-valid GID as primary group ID
+aren't allowed to log in. If user belongs to supplementary groups with
+non-valid GIDs, those groups are not set. Defaults to @samp{1}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer last-valid-gid
+
+El valor predeterminado es @samp{0}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer
mail-max-keyword-length
+Maximum allowed length for mail keyword name. It's only forced when trying
+to create new keywords. Defaults to @samp{50}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} colon-separated-file-name-list
valid-chroot-dirs
+List of directories under which chrooting is allowed for mail processes
+(i.e.@: /var/mail will allow chrooting to /var/mail/foo/bar too). This
+setting doesn't affect @samp{login-chroot} @samp{mail-chroot} or auth chroot
+settings. If this setting is empty, "/./" in home dirs are ignored.
+WARNING: Never add directories here which local users can modify, that may
+lead to root exploit. Usually this should be done only if you don't allow
+shell access for users. <doc/wiki/Chrooting.txt>. Defaults to @samp{()}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string mail-chroot
+Default chroot directory for mail processes. This can be overridden for
+specific users in user database by giving /./ in user's home directory
+(e.g.@: /home/./user chroots into /home). Note that usually there is no
+real need to do chrooting, Dovecot doesn't allow users to access files
+outside their mail directory anyway. If your home directories are prefixed
+with the chroot directory, append "/."@: to @samp{mail-chroot}.
+<doc/wiki/Chrooting.txt>. Defaults to @samp{""}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} file-name auth-socket-path
+UNIX socket path to master authentication server to find users. This is
+used by imap (for shared users) and lda. Defaults to
address@hidden"/var/run/dovecot/auth-userdb"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} file-name mail-plugin-dir
+Directory where to look up mail plugins. Defaults to
address@hidden"/usr/lib/dovecot"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} space-separated-string-list
mail-plugins
+List of plugins to load for all services. Plugins specific to IMAP, LDA,
+etc.@: are added to this list in their own .conf files. Defaults to
address@hidden()}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer
mail-cache-min-mail-count
+The minimum number of mails in a mailbox before updates are done to cache
+file. This allows optimizing Dovecot's behavior to do less disk writes at
+the cost of more disk reads. Defaults to @samp{0}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string mailbox-idle-check-interval
+When IDLE command is running, mailbox is checked once in a while to see if
+there are any new mails or other changes. This setting defines the minimum
+time to wait between those checks. Dovecot can also use dnotify, inotify
+and kqueue to find out immediately when changes occur. Defaults to
address@hidden"30 secs"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean mail-save-crlf?
+Save mails with CR+LF instead of plain LF. This makes sending those mails
+take less CPU, especially with sendfile() syscall with Linux and FreeBSD.
+But it also creates a bit more disk I/O which may just make it slower. Also
+note that if other software reads the mboxes/maildirs, they may handle the
+extra CRs wrong and cause problems. Defaults to @samp{#f}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean maildir-stat-dirs?
+By default LIST command returns all entries in maildir beginning with a
+dot. Enabling this option makes Dovecot return only entries which are
+directories. This is done by stat()ing each entry, so it causes more disk
+I/O. (For systems setting struct @samp{dirent->d_type} this check is free
+and it's done always regardless of this setting). Defaults to @samp{#f}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean maildir-copy-with-hardlinks?
+When copying a message, do it with hard links whenever possible. This makes
+the performance much better, and it's unlikely to have any side effects.
+Defaults to @samp{#t}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean maildir-very-dirty-syncs?
+Assume Dovecot is the only MUA accessing Maildir: Scan cur/ directory only
+when its mtime changes unexpectedly or when we can't find the mail
+otherwise. Defaults to @samp{#f}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} space-separated-string-list
mbox-read-locks
+Which locking methods to use for locking mbox. There are four available:
+
address@hidden @code
address@hidden dotlock
+Create <mailbox>.lock file. This is the oldest and most NFS-safe solution.
+If you want to use /var/mail/ like directory, the users will need write
+access to that directory.
address@hidden dotlock-try
+Same as dotlock, but if it fails because of permissions or because there
+isn't enough disk space, just skip it.
address@hidden fcntl
+Use this if possible. Works with NFS too if lockd is used.
address@hidden flock
+May not exist in all systems. Doesn't work with NFS.
address@hidden lockf
+May not exist in all systems. Doesn't work with NFS.
address@hidden table
+
+You can use multiple locking methods; if you do the order they're declared
+in is important to avoid deadlocks if other MTAs/MUAs are using multiple
+locking methods as well. Some operating systems don't allow using some of
+them simultaneously.
address@hidden deftypevr
+
address@hidden address@hidden parameter} space-separated-string-list
mbox-write-locks
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string mbox-lock-timeout
+Maximum time to wait for lock (all of them) before aborting. Defaults to
address@hidden"5 mins"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string mbox-dotlock-change-timeout
+If dotlock exists but the mailbox isn't modified in any way, override the
+lock file after this much time. Defaults to @samp{"2 mins"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean mbox-dirty-syncs?
+When mbox changes unexpectedly we have to fully read it to find out what
+changed. If the mbox is large this can take a long time. Since the change
+is usually just a newly appended mail, it'd be faster to simply read the new
+mails. If this setting is enabled, Dovecot does this but still safely
+fallbacks to re-reading the whole mbox file whenever something in mbox isn't
+how it's expected to be. The only real downside to this setting is that if
+some other MUA changes message flags, Dovecot doesn't notice it
+immediately. Note that a full sync is done with SELECT, EXAMINE, EXPUNGE
+and CHECK commands. Defaults to @samp{#t}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean mbox-very-dirty-syncs?
+Like @samp{mbox-dirty-syncs}, but don't do full syncs even with SELECT,
+EXAMINE, EXPUNGE or CHECK commands. If this is set, @samp{mbox-dirty-syncs}
+is ignored. Defaults to @samp{#f}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean mbox-lazy-writes?
+Delay writing mbox headers until doing a full write sync (EXPUNGE and CHECK
+commands and when closing the mailbox). This is especially useful for POP3
+where clients often delete all mails. The downside is that our changes
+aren't immediately visible to other MUAs. Defaults to @samp{#t}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer
mbox-min-index-size
+If mbox size is smaller than this (e.g.@: 100k), don't write index files.
+If an index file already exists it's still read, just not updated. Defaults
+to @samp{0}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer mdbox-rotate-size
+Maximum dbox file size until it's rotated. Defaults to @samp{10000000}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string mdbox-rotate-interval
+Maximum dbox file age until it's rotated. Typically in days. Day begins
+from midnight, so 1d = today, 2d = yesterday, etc. 0 = check disabled.
+Defaults to @samp{"1d"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean mdbox-preallocate-space?
+When creating new mdbox files, immediately preallocate their size to
address@hidden This setting currently works only in Linux with
+some file systems (ext4, xfs). Defaults to @samp{#f}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string mail-attachment-dir
+sdbox and mdbox support saving mail attachments to external files, which
+also allows single instance storage for them. Other backends don't support
+this for now.
+
+WARNING: This feature hasn't been tested much yet. Use at your own risk.
+
+Directory root where to store mail attachments. Disabled, if empty.
+Defaults to @samp{""}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer
mail-attachment-min-size
+Attachments smaller than this aren't saved externally. It's also possible
+to write a plugin to disable saving specific attachments externally.
+Defaults to @samp{128000}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string mail-attachment-fs
+File system backend to use for saving attachments:
address@hidden @code
address@hidden posix
+No SiS done by Dovecot (but this might help FS's own deduplication)
address@hidden sis posix
+SiS with immediate byte-by-byte comparison during saving
address@hidden sis-queue posix
+SiS with delayed comparison and deduplication.
address@hidden table
+Defaults to @samp{"sis posix"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string mail-attachment-hash
+Hash format to use in attachment filenames. You can add any text and
+variables: @address@hidden@}}, @address@hidden@}}, @address@hidden@}},
address@hidden@address@hidden, @address@hidden@}}, @address@hidden@}}.
Variables can be
+truncated, e.g.@: @address@hidden:address@hidden returns only first 80 bits.
+Defaults to @samp{"address@hidden@}"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer
default-process-limit
+
+Defaults to @samp{100}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer
default-client-limit
+
+Defaults to @samp{1000}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer default-vsz-limit
+Default VSZ (virtual memory size) limit for service processes. This is
+mainly intended to catch and kill processes that leak memory before they eat
+up everything. Defaults to @samp{256000000}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string default-login-user
+Login user is internally used by login processes. This is the most
+untrusted user in Dovecot system. It shouldn't have access to anything at
+all. Defaults to @samp{"dovenull"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string default-internal-user
+Internal user is used by unprivileged processes. It should be separate from
+login user, so that login processes can't disturb other processes. Defaults
+to @samp{"dovecot"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string ssl?
+SSL/TLS support: yes, no, required. <doc/wiki/SSL.txt>. Defaults to
address@hidden"required"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string ssl-cert
+PEM encoded X.509 SSL/TLS certificate (public key). Defaults to
address@hidden"</etc/dovecot/default.pem"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string ssl-key
+PEM encoded SSL/TLS private key. The key is opened before dropping root
+privileges, so keep the key file unreadable by anyone but root. Defaults to
address@hidden"</etc/dovecot/private/default.pem"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string ssl-key-password
+If key file is password protected, give the password here. Alternatively
+give it when starting dovecot with -p parameter. Since this file is often
+world-readable, you may want to place this setting instead to a different.
+Defaults to @samp{""}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string ssl-ca
+PEM encoded trusted certificate authority. Set this only if you intend to
+use @samp{ssl-verify-client-cert? #t}. The file should contain the CA
+certificate(s) followed by the matching CRL(s). (e.g.@: @samp{ssl-ca
+</etc/ssl/certs/ca.pem}). Defaults to @samp{""}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean ssl-require-crl?
+Require that CRL check succeeds for client certificates. Defaults to
address@hidden
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean ssl-verify-client-cert?
+Request client to send a certificate. If you also want to require it, set
address@hidden #t} in auth section. Defaults to
address@hidden
address@hidden deftypevr
+
address@hidden address@hidden parameter} string ssl-cert-username-field
+Which field from certificate to use for username. commonName and
+x500UniqueIdentifier are the usual choices. You'll also need to set
address@hidden #t}. Defaults to @samp{"commonName"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string ssl-min-protocol
+Minimum SSL protocol version to accept. Defaults to @samp{"TLSv1"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string ssl-cipher-list
+SSL ciphers to use. Defaults to
address@hidden"ALL:!kRSA:!SRP:!kDHd:!DSS:!aNULL:!eNULL:!EXPORT:!DES:!3DES:!MD5:!PSK:!RC4:!ADH:!LOW@@STRENGTH"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string ssl-crypto-device
+SSL crypto device to use, for valid values run "openssl engine". Defaults
+to @samp{""}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string postmaster-address
+Address to use when sending rejection mails. %d expands to recipient
+domain. Defaults to @samp{"postmaster@@%d"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string hostname
+Hostname to use in various parts of sent mails (e.g.@: in Message-Id) and
+in LMTP replies. Default is the system's real hostname@@domain. Defaults
+to @samp{""}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean quota-full-tempfail?
+If user is over quota, return with temporary failure instead of bouncing the
+mail. Defaults to @samp{#f}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} file-name sendmail-path
+Binary to use for sending mails. Defaults to @samp{"/usr/sbin/sendmail"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string submission-host
+If non-empty, send mails via this SMTP host[:port] instead of sendmail.
+Defaults to @samp{""}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string rejection-subject
+Subject: header to use for rejection mails. You can use the same variables
+as for @samp{rejection-reason} below. Defaults to @samp{"Rejected: %s"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string rejection-reason
+Human readable error message for rejection mails. You can use variables:
+
address@hidden @code
address@hidden %n
+CRLF
address@hidden %r
+reason
address@hidden %s
+original subject
address@hidden %t
+recipient
address@hidden table
+Defaults to @samp{"Your message to <%t> was automatically rejected:%n%r"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string recipient-delimiter
+Delimiter character between local-part and detail in email address.
+Defaults to @samp{"+"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string lda-original-recipient-header
+Header where the original recipient address (SMTP's RCPT TO: address) is
+taken from if not available elsewhere. With dovecot-lda -a parameter
+overrides this. A commonly used header for this is X-Original-To. Defaults
+to @samp{""}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean lda-mailbox-autocreate?
+Should saving a mail to a nonexistent mailbox automatically create it?.
+Defaults to @samp{#f}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean lda-mailbox-autosubscribe?
+Should automatically created mailboxes be also automatically subscribed?.
+Defaults to @samp{#f}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer
imap-max-line-length
+Maximum IMAP command line length. Some clients generate very long command
+lines with huge mailboxes, so you may need to raise this if you get "Too
+long argument" or "IMAP command line too large" errors often. Defaults to
address@hidden
address@hidden deftypevr
+
address@hidden address@hidden parameter} string imap-logout-format
+IMAP logout format string:
address@hidden @code
address@hidden %i
+número total de bytes leídos del cliente
address@hidden %o
+número total de bytes enviados al cliente.
address@hidden table
+See @file{doc/wiki/Variables.txt} for a list of all the variables you can
+use. Defaults to @samp{"in=%i out=%o address@hidden@}
address@hidden@} address@hidden@} address@hidden@}
address@hidden@} address@hidden@}
address@hidden@}"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string imap-capability
+Override the IMAP CAPABILITY response. If the value begins with '+', add
+the given capabilities on top of the defaults (e.g.@: +XFOO XBAR). Defaults
+to @samp{""}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string imap-idle-notify-interval
+How long to wait between "OK Still here" notifications when client is
+IDLEing. Defaults to @samp{"2 mins"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string imap-id-send
+ID field names and values to send to clients. Using * as the value makes
+Dovecot use the default value. The following fields have default values
+currently: name, version, os, os-version, support-url, support-email.
+Defaults to @samp{""}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string imap-id-log
+ID fields sent by client to log. * means everything. Defaults to
address@hidden""}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} space-separated-string-list
imap-client-workarounds
+Workarounds for various client bugs:
+
address@hidden @code
address@hidden delay-newmail
+Send EXISTS/RECENT new mail notifications only when replying to NOOP and
+CHECK commands. Some clients ignore them otherwise, for example OSX Mail
+(<v2.1). Outlook Express breaks more badly though, without this it may show
+user "Message no longer in server" errors. Note that OE6 still breaks even
+with this workaround if synchronization is set to "Headers Only".
+
address@hidden tb-extra-mailbox-sep
+Thunderbird gets somehow confused with LAYOUT=fs (mbox and dbox) and adds
+extra @samp{/} suffixes to mailbox names. This option causes Dovecot to
+ignore the extra @samp{/} instead of treating it as invalid mailbox name.
+
address@hidden tb-lsub-flags
+Show \Noselect flags for LSUB replies with LAYOUT=fs (e.g.@: mbox). This
+makes Thunderbird realize they aren't selectable and show them greyed out,
+instead of only later giving "not selectable" popup error.
address@hidden table
+Defaults to @samp{()}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string imap-urlauth-host
+Host allowed in URLAUTH URLs sent by client. "*" allows all. Defaults to
address@hidden""}.
address@hidden deftypevr
+
+
+Whew! Lots of configuration options. The nice thing about it though is that
+Guix has a complete interface to Dovecot's configuration language. This
+allows not only a nice way to declare configurations, but also offers
+reflective capabilities as well: users can write code to inspect and
+transform configurations from within Scheme.
+
+However, it could be that you just want to get a @code{dovecot.conf} up and
+running. In that case, you can pass an @code{opaque-dovecot-configuration}
+as the @code{#:config} parameter to @code{dovecot-service}. As its name
+indicates, an opaque configuration does not have easy reflective
+capabilities.
+
+Available @code{opaque-dovecot-configuration} fields are:
+
address@hidden address@hidden parameter} package dovecot
+El paquete dovecot.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string string
+The contents of the @code{dovecot.conf}, as a string.
address@hidden deftypevr
+
+For example, if your @code{dovecot.conf} is just the empty string, you could
+instantiate a dovecot service like this:
+
address@hidden
+(dovecot-service #:config
+ (opaque-dovecot-configuration
+ (string "")))
address@hidden example
+
address@hidden Servicio OpenSMTPD
+
address@hidden {Variable Scheme} opensmtpd-service-type
+This is the type of the @uref{https://www.opensmtpd.org, OpenSMTPD} service,
+whose value should be an @code{opensmtpd-configuration} object as in this
+example:
+
address@hidden
+(service opensmtpd-service-type
+ (opensmtpd-configuration
+ (config-file (local-file "./mi-smtpd.conf"))))
address@hidden example
address@hidden deffn
+
address@hidden {Tipo de datos} opensmtpd-configuration
+Data type representing the configuration of opensmtpd.
+
address@hidden @asis
address@hidden @code{package} (predeterminado: @var{opensmtpd})
+El objeto paquete del servidor SMTP OpenSMTPD.
+
address@hidden @code{config-file} (predeterminado:
@var{%default-opensmtpd-file})
+File-like object of the OpenSMTPD configuration file to use. By default it
+listens on the loopback network interface, and allows for mail from users
+and daemons on the local machine, as well as permitting email to remote
+servers. Run @command{man smtpd.conf} for more information.
+
address@hidden table
address@hidden deftp
+
address@hidden Servicio Exim
+
address@hidden mail transfer agent (MTA)
address@hidden MTA (mail transfer agent)
address@hidden SMTP
+
address@hidden {Variable Scheme} exim-service-type
+This is the type of the @uref{https://exim.org, Exim} mail transfer agent
+(MTA), whose value should be an @code{exim-configuration} object as in this
+example:
+
address@hidden
+(service exim-service-type
+ (exim-configuration
+ (config-file (local-file "./mi-exim.conf"))))
address@hidden example
address@hidden deffn
+
+In order to use an @code{exim-service-type} service you must also have a
address@hidden service present in your
address@hidden (even if it has no aliases).
+
address@hidden {Tipo de datos} exim-configuration
+Tipo de datos que representa la configuración de exim.
+
address@hidden @asis
address@hidden @code{package} (predeterminado: @var{exim})
+Package object of the Exim server.
+
address@hidden @code{config-file} (predeterminado: @code{#f})
+File-like object of the Exim configuration file to use. If its value is
address@hidden then use the default configuration file from the package provided
+in @code{package}. The resulting configuration file is loaded after setting
+the @code{exim_user} and @code{exim_group} configuration variables.
+
address@hidden table
address@hidden deftp
+
address@hidden Servicios de alias de correo
+
address@hidden correo electrónico, alias
address@hidden alias, para direcciones de correo electrónico
+
address@hidden {Variable Scheme} mail-aliases-service-type
+This is the type of the service which provides @code{/etc/aliases},
+specifying how to deliver mail to users on this system.
+
address@hidden
+(service mail-aliases-service-type
+ '(("postmaster" "rober")
+ ("rober" "rober@@example.com" "rober@@example2.com")))
address@hidden example
address@hidden deffn
+
+The configuration for a @code{mail-aliases-service-type} service is an
+association list denoting how to deliver mail that comes to this
+system. Each entry is of the form @code{(alias addresses ...)}, with
address@hidden specifying the local alias and @code{addresses} specifying
+where to deliver this user's mail.
+
+The aliases aren't required to exist as users on the local system. In the
+above example, there doesn't need to be a @code{postmaster} entry in the
address@hidden's @code{user-accounts} in order to deliver the
address@hidden mail to @code{bob} (which subsequently would deliver mail
+to @code{bob@@example.com} and @code{bob@@example2.com}).
+
address@hidden GNU Mailutils IMAP4 Daemon
address@hidden GNU Mailutils IMAP4 Daemon
+
address@hidden {Scheme Variable} imap4d-service-type
+This is the type of the GNU Mailutils IMAP4 Daemon (@pxref{imap4d,,,
+mailutils, GNU Mailutils Manual}), whose value should be an
address@hidden object as in this example:
+
address@hidden
+(service imap4d-service-type
+ (imap4d-configuration
+ (config-file (local-file "imap4d.conf"))))
address@hidden example
address@hidden deffn
+
address@hidden {Data Type} imap4d-configuration
+Data type representing the configuration of @command{imap4d}.
+
address@hidden @asis
address@hidden @code{package} (default: @code{mailutils})
+The package that provides @command{imap4d}.
+
address@hidden @code{config-file} (default: @code{%default-imap4d-config-file})
+File-like object of the configuration file to use, by default it will listen
+on TCP port 143 of @code{localhost}. @xref{Conf-imap4d,,, mailutils, GNU
+Mailutils Manual}, for details.
+
address@hidden table
address@hidden deftp
+
address@hidden Servicios de mensajería
address@hidden Servicios de mensajería
+
address@hidden messaging
address@hidden jabber
address@hidden XMPP
+The @code{(gnu services messaging)} module provides Guix service definitions
+for messaging services: currently only Prosody is supported.
+
address@hidden Servicio Prosody
+
address@hidden {Variable Scheme} prosody-service-type
+This is the type for the @uref{https://prosody.im, Prosody XMPP
+communication server}. Its value must be a @code{prosody-configuration}
+record as in this example:
+
address@hidden
+(service prosody-service-type
+ (prosody-configuration
+ (modules-enabled (cons "groups" "mam" %default-modules-enabled))
+ (int-components
+ (list
+ (int-component-configuration
+ (hostname "conference.example.net")
+ (plugin "muc")
+ (mod-muc (mod-muc-configuration)))))
+ (virtualhosts
+ (list
+ (virtualhost-configuration
+ (domain "example.net"))))))
address@hidden example
+
+See below for details about @code{prosody-configuration}.
+
address@hidden deffn
+
+By default, Prosody does not need much configuration. Only one
address@hidden field is needed: it specifies the domain you wish
+Prosody to serve.
+
+You can perform various sanity checks on the generated configuration with
+the @code{prosodyctl check} command.
+
+Prosodyctl will also help you to import certificates from the
address@hidden directory so that the @code{prosody} user can access
+them. See @url{https://prosody.im/doc/letsencrypt}.
+
address@hidden
+prosodyctl --root cert import /etc/letsencrypt/live
address@hidden example
+
+The available configuration parameters follow. Each parameter definition is
+preceded by its type; for example, @samp{string-list foo} indicates that the
address@hidden parameter should be specified as a list of strings. Types
+starting with @code{maybe-} denote parameters that won't show up in
address@hidden when their value is @code{'disabled}.
+
+There is also a way to specify the configuration as a string, if you have an
+old @code{prosody.cfg.lua} file that you want to port over from some other
+system; see the end for more details.
+
+The @code{file-object} type designates either a file-like object
+(@pxref{Expresiones-G, file-like objects}) or a file name.
+
address@hidden The following documentation was initially generated by
address@hidden (generate-documentation) in (gnu services messaging). Manually
maintained
address@hidden documentation is better, so we shouldn't hesitate to edit below
as
address@hidden needed. However if the change you want to make to this
documentation
address@hidden can be done in an automated way, it's probably easier to change
address@hidden (generate-documentation) than to make it below and have to deal
with
address@hidden the churn as Prosody updates.
+
+Available @code{prosody-configuration} fields are:
+
address@hidden address@hidden parameter} package prosody
+El paquete Prosody.
address@hidden deftypevr
+
address@hidden address@hidden parameter} file-name data-path
+Location of the Prosody data storage directory. See
address@hidden://prosody.im/doc/configure}. Defaults to
address@hidden"/var/lib/prosody"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} file-object-list plugin-paths
+Additional plugin directories. They are searched in all the specified paths
+in order. See @url{https://prosody.im/doc/plugins_directory}. Defaults to
address@hidden()}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} file-name certificates
+Every virtual host and component needs a certificate so that clients and
+servers can securely verify its identity. Prosody will automatically load
+certificates/keys from the directory specified here. Defaults to
address@hidden"/etc/prosody/certs"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string-list admins
+This is a list of accounts that are admins for the server. Note that you
+must create the accounts separately. See
address@hidden://prosody.im/doc/admins} and
address@hidden://prosody.im/doc/creating_accounts}. Example: @code{(admins
+'("user1@@example.com" "user2@@example.net"))} Defaults to @samp{()}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean use-libevent?
+Enable use of libevent for better performance under high load. See
address@hidden://prosody.im/doc/libevent}. Defaults to @samp{#f}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} module-list modules-enabled
+This is the list of modules Prosody will load on startup. It looks for
address@hidden in the plugins folder, so make sure that exists
+too. Documentation on modules can be found at:
address@hidden://prosody.im/doc/modules}. Defaults to @samp{("roster"
+"saslauth" "tls" "dialback" "disco" "carbons" "private" "blocklist" "vcard"
+"version" "uptime" "time" "ping" "pep" "register" "admin_adhoc")}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string-list modules-disabled
address@hidden"offline"}, @samp{"c2s"} and @samp{"s2s"} are auto-loaded, but
should
+you want to disable them then add them to this list. Defaults to @samp{()}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} file-object groups-file
+Path to a text file where the shared groups are defined. If this path is
+empty then @samp{mod_groups} does nothing. See
address@hidden://prosody.im/doc/modules/mod_groups}. Defaults to
address@hidden"/var/lib/prosody/sharedgroups.txt"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean allow-registration?
+Disable account creation by default, for security. See
address@hidden://prosody.im/doc/creating_accounts}. Defaults to @samp{#f}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-ssl-configuration ssl
+These are the SSL/TLS-related settings. Most of them are disabled so to use
+Prosody's defaults. If you do not completely understand these options, do
+not add them to your config, it is easy to lower the security of your server
+using them. See @url{https://prosody.im/doc/advanced_ssl_config}.
+
+Available @code{ssl-configuration} fields are:
+
address@hidden address@hidden parameter} maybe-string protocol
+This determines what handshake to use.
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-file-name key
+Path to your private key file.
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-file-name certificate
+Path to your certificate file.
address@hidden deftypevr
+
address@hidden address@hidden parameter} file-object capath
+Path to directory containing root certificates that you wish Prosody to
+trust when verifying the certificates of remote servers. Defaults to
address@hidden"/etc/ssl/certs"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-file-object cafile
+Path to a file containing root certificates that you wish Prosody to trust.
+Similar to @code{capath} but with all certificates concatenated together.
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-string-list verify
+A list of verification options (these mostly map to OpenSSL's
address@hidden()} flags).
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-string-list options
+A list of general options relating to SSL/TLS. These map to OpenSSL's
address@hidden()}. For a full list of options available in LuaSec, see
+the LuaSec source.
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-non-negative-integer depth
+How long a chain of certificate authorities to check when looking for a
+trusted root certificate.
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-string ciphers
+An OpenSSL cipher string. This selects what ciphers Prosody will offer to
+clients, and in what order.
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-file-name dhparam
+A path to a file containing parameters for Diffie-Hellman key exchange. You
+can create such a file with: @code{openssl dhparam -out
+/etc/prosody/certs/dh-2048.pem 2048}
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-string curve
+Curve for Elliptic curve Diffie-Hellman. Prosody's default is
address@hidden"secp384r1"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-string-list verifyext
+A list of "extra" verification options.
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-string password
+Password for encrypted private keys.
address@hidden deftypevr
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean c2s-require-encryption?
+Whether to force all client-to-server connections to be encrypted or not.
+See @url{https://prosody.im/doc/modules/mod_tls}. Defaults to @samp{#f}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string-list disable-sasl-mechanisms
+Set of mechanisms that will never be offered. See
address@hidden://prosody.im/doc/modules/mod_saslauth}. Defaults to
address@hidden("DIGEST-MD5")}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean s2s-require-encryption?
+Whether to force all server-to-server connections to be encrypted or not.
+See @url{https://prosody.im/doc/modules/mod_tls}. Defaults to @samp{#f}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean s2s-secure-auth?
+Whether to require encryption and certificate authentication. This provides
+ideal security, but requires servers you communicate with to support
+encryption AND present valid, trusted certificates. See
address@hidden://prosody.im/doc/s2s#security}. Defaults to @samp{#f}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string-list s2s-insecure-domains
+Many servers don't support encryption or have invalid or self-signed
+certificates. You can list domains here that will not be required to
+authenticate using certificates. They will be authenticated using DNS. See
address@hidden://prosody.im/doc/s2s#security}. Defaults to @samp{()}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string-list s2s-secure-domains
+Even if you leave @code{s2s-secure-auth?} disabled, you can still require
+valid certificates for some domains by specifying a list here. See
address@hidden://prosody.im/doc/s2s#security}. Defaults to @samp{()}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string authentication
+Select the authentication backend to use. The default provider stores
+passwords in plaintext and uses Prosody's configured data storage to store
+the authentication data. If you do not trust your server please see
address@hidden://prosody.im/doc/modules/mod_auth_internal_hashed} for
+information about using the hashed backend. See also
address@hidden://prosody.im/doc/authentication} Defaults to
address@hidden"internal_plain"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-string log
+Set logging options. Advanced logging configuration is not yet supported by
+the Prosody service. See @url{https://prosody.im/doc/logging}. Defaults to
address@hidden"*syslog"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} file-name pidfile
+File to write pid in. See @url{https://prosody.im/doc/modules/mod_posix}.
+Defaults to @samp{"/var/run/prosody/prosody.pid"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-non-negative-integer
http-max-content-size
+Maximum allowed size of the HTTP body (in bytes).
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-string http-external-url
+Some modules expose their own URL in various ways. This URL is built from
+the protocol, host and port used. If Prosody sits behind a proxy, the
+public URL will be @code{http-external-url} instead. See
address@hidden://prosody.im/doc/http#external_url}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} virtualhost-configuration-list
virtualhosts
+A host in Prosody is a domain on which user accounts can be created. For
+example if you want your users to have addresses like
address@hidden"john.smith@@example.com"} then you need to add a host
address@hidden"example.com"}. All options in this list will apply only to this
+host.
+
+Note: the name "virtual" host is used in configuration to avoid confusion
+with the actual physical host that Prosody is installed on. A single
+Prosody instance can serve many domains, each one defined as a VirtualHost
+entry in Prosody's configuration. Conversely a server that hosts a single
+domain would have just one VirtualHost entry.
+
+See @url{https://prosody.im/doc/configure#virtual_host_settings}.
+
+Available @code{virtualhost-configuration} fields are:
+
+all these @code{prosody-configuration} fields: @code{admins},
address@hidden, @code{modules-enabled}, @code{modules-disabled},
address@hidden, @code{allow-registration?}, @code{ssl},
address@hidden, @code{disable-sasl-mechanisms},
address@hidden, @code{s2s-secure-auth?},
address@hidden, @code{s2s-secure-domains},
address@hidden, @code{log}, @code{http-max-content-size},
address@hidden, @code{raw-content}, plus:
address@hidden address@hidden parameter} string domain
+Domain you wish Prosody to serve.
address@hidden deftypevr
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} int-component-configuration-list
int-components
+Components are extra services on a server which are available to clients,
+usually on a subdomain of the main server (such as
address@hidden"mycomponent.example.com"}). Example components might be chatroom
+servers, user directories, or gateways to other protocols.
+
+Internal components are implemented with Prosody-specific plugins. To add
+an internal component, you simply fill the hostname field, and the plugin
+you wish to use for the component.
+
+See @url{https://prosody.im/doc/components}. Defaults to @samp{()}.
+
+Available @code{int-component-configuration} fields are:
+
+all these @code{prosody-configuration} fields: @code{admins},
address@hidden, @code{modules-enabled}, @code{modules-disabled},
address@hidden, @code{allow-registration?}, @code{ssl},
address@hidden, @code{disable-sasl-mechanisms},
address@hidden, @code{s2s-secure-auth?},
address@hidden, @code{s2s-secure-domains},
address@hidden, @code{log}, @code{http-max-content-size},
address@hidden, @code{raw-content}, plus:
address@hidden address@hidden parameter} string hostname
+Hostname of the component.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string plugin
+Plugin you wish to use for the component.
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-mod-muc-configuration mod-muc
+Multi-user chat (MUC) is Prosody's module for allowing you to create hosted
+chatrooms/conferences for XMPP users.
+
+General information on setting up and using multi-user chatrooms can be
+found in the "Chatrooms" documentation
+(@url{https://prosody.im/doc/chatrooms}), which you should read if you are
+new to XMPP chatrooms.
+
+See also @url{https://prosody.im/doc/modules/mod_muc}.
+
+Available @code{mod-muc-configuration} fields are:
+
address@hidden address@hidden parameter} string name
+The name to return in service discovery responses. Defaults to
address@hidden"Prosody Chatrooms"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string-or-boolean
restrict-room-creation
+If @samp{#t}, this will only allow admins to create new chatrooms.
+Otherwise anyone can create a room. The value @samp{"local"} restricts room
+creation to users on the service's parent domain. E.g.@:
address@hidden@@example.com} can create rooms on @samp{rooms.example.com}. The
+value @samp{"admin"} restricts to service administrators only. Defaults to
address@hidden
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer
max-history-messages
+Maximum number of history messages that will be sent to the member that has
+just joined the room. Defaults to @samp{20}.
address@hidden deftypevr
+
address@hidden deftypevr
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} ext-component-configuration-list
ext-components
+External components use XEP-0114, which most standalone components support.
+To add an external component, you simply fill the hostname field. See
address@hidden://prosody.im/doc/components}. Defaults to @samp{()}.
+
+Available @code{ext-component-configuration} fields are:
+
+all these @code{prosody-configuration} fields: @code{admins},
address@hidden, @code{modules-enabled}, @code{modules-disabled},
address@hidden, @code{allow-registration?}, @code{ssl},
address@hidden, @code{disable-sasl-mechanisms},
address@hidden, @code{s2s-secure-auth?},
address@hidden, @code{s2s-secure-domains},
address@hidden, @code{log}, @code{http-max-content-size},
address@hidden, @code{raw-content}, plus:
address@hidden address@hidden parameter} string component-secret
+Password which the component will use to log in.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string hostname
+Hostname of the component.
address@hidden deftypevr
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer-list
component-ports
+Port(s) Prosody listens on for component connections. Defaults to
address@hidden(5347)}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string component-interface
+Interface Prosody listens on for component connections. Defaults to
address@hidden"127.0.0.1"}.
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-raw-content raw-content
+Raw content that will be added to the configuration file.
address@hidden deftypevr
+
+It could be that you just want to get a @code{prosody.cfg.lua} up and
+running. In that case, you can pass an @code{opaque-prosody-configuration}
+record as the value of @code{prosody-service-type}. As its name indicates,
+an opaque configuration does not have easy reflective capabilities.
+Available @code{opaque-prosody-configuration} fields are:
+
address@hidden address@hidden parameter} package prosody
+El paquete prosody.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string prosody.cfg.lua
+The contents of the @code{prosody.cfg.lua} to use.
address@hidden deftypevr
+
+For example, if your @code{prosody.cfg.lua} is just the empty string, you
+could instantiate a prosody service like this:
+
address@hidden
+(service prosody-service-type
+ (opaque-prosody-configuration
+ (prosody.cfg.lua "")))
address@hidden example
+
address@hidden end of Prosody auto-generated documentation
+
address@hidden Servicio BitlBee
+
address@hidden IRC (Internet Relay Chat)
address@hidden pasarela IRC
address@hidden://bitlbee.org,BitlBee} is a gateway that provides an IRC
interface
+to a variety of messaging protocols such as XMPP.
+
address@hidden {Variable Scheme} bitlbee-service-type
+This is the service type for the @url{http://bitlbee.org,BitlBee} IRC
+gateway daemon. Its value is a @code{bitlbee-configuration} (see below).
+
+To have BitlBee listen on port 6667 on localhost, add this line to your
+services:
+
address@hidden
+(service bitlbee-service-type)
address@hidden example
address@hidden defvr
+
address@hidden {Tipo de datos} bitlbee-configuration
+This is the configuration for BitlBee, with the following fields:
+
address@hidden @asis
address@hidden @code{interface} (predeterminada: @code{"127.0.0.1"})
address@hidden @code{port} (predeterminado: @code{6667})
+Escucha en la interfaz de red correspondiente a la dirección IP especificada
+en @var{interface}, en el puerto @var{port}.
+
+When @var{interface} is @code{127.0.0.1}, only local clients can connect;
+when it is @code{0.0.0.0}, connections can come from any networking
+interface.
+
address@hidden @code{package} (predeterminado: @code{bitlbee})
+El paquete BitlBee usado.
+
address@hidden @code{plugins} (predeterminados: @code{'()})
+List of plugin packages to use---e.g., @code{bitlbee-discord}.
+
address@hidden @code{extra-settings} (predeterminado: @code{""})
+Configuration snippet added as-is to the BitlBee configuration file.
address@hidden table
address@hidden deftp
+
address@hidden Quassel Service
+
address@hidden IRC (Internet Relay Chat)
address@hidden://quassel-irc.org/,Quassel} is a distributed IRC client, meaning
+that one or more clients can attach to and detach from the central core.
+
address@hidden {Scheme Variable} quassel-service-type
+This is the service type for the @url{https://quassel-irc.org/,Quassel} IRC
+backend daemon. Its value is a @code{quassel-configuration} (see below).
address@hidden defvr
+
address@hidden {Data Type} quassel-configuration
+This is the configuration for Quassel, with the following fields:
+
address@hidden @asis
address@hidden @code{quassel} (default: @code{quassel})
+The Quassel package to use.
+
address@hidden @code{interface} (default: @code{"::,0.0.0.0"})
address@hidden @code{port} (default: @code{4242})
+Listen on the network interface(s) corresponding to the IPv4 or IPv6
+interfaces specified in the comma delimited @var{interface}, on @var{port}.
+
address@hidden @code{loglevel} (default: @code{"Info"})
+The level of logging desired. Accepted values are Debug, Info, Warning and
+Error.
address@hidden table
address@hidden deftp
+
address@hidden Servicios de telefonía
address@hidden Servicios de telefonía
+
address@hidden Murmur (servidor VoIP)
address@hidden servidor VoIP
+This section describes how to set up and run a Murmur server. Murmur is the
+server of the @uref{https://mumble.info, Mumble} voice-over-IP (VoIP) suite.
+
address@hidden {Tipo de datos} murmur-configuration
+The service type for the Murmur server. An example configuration can look
+like this:
+
address@hidden
+(service murmur-service-type
+ (murmur-configuration
+ (welcome-text
+ "Welcome to this Mumble server running on Guix!")
+ (cert-required? #t) ;disallow text password logins
+ (ssl-cert "/etc/letsencrypt/live/mumble.example.com/fullchain.pem")
+ (ssl-key "/etc/letsencrypt/live/mumble.example.com/privkey.pem")))
address@hidden example
+
+After reconfiguring your system, you can manually set the murmur
address@hidden password with the command that is printed during the
+activation phase.
+
+It is recommended to register a normal Mumble user account and grant it
+admin or moderator rights. You can use the @code{mumble} client to login as
+new normal user, register yourself, and log out. For the next step login
+with the name @code{SuperUser} use the @code{SuperUser} password that you
+set previously, and grant your newly registered mumble user administrator or
+moderator rights and create some channels.
+
+Available @code{murmur-configuration} fields are:
+
address@hidden @asis
address@hidden @code{package} (predeterminado: @code{mumble})
+Package that contains @code{bin/murmurd}.
+
address@hidden @code{user} (predeterminado: @code{"murmur"})
+User who will run the Murmur server.
+
address@hidden @code{group} (predeterminado: @code{"murmur"})
+Group of the user who will run the murmur server.
+
address@hidden @code{port} (predeterminado: @code{64738})
+Puerto en el que escucha el servidor.
+
address@hidden @code{welcome-text} (predeterminado: @code{""})
+Welcome text sent to clients when they connect.
+
address@hidden @code{server-password} (predeterminada: @code{""})
+Password the clients have to enter in order to connect.
+
address@hidden @code{max-users} (predeterminados: @code{100})
+Maximum of users that can be connected to the server at once.
+
address@hidden @code{max-user-bandwidth} (predeterminado: @code{#f})
+Maximum voice traffic a user can send per second.
+
address@hidden @code{database-file} (predeterminado:
@code{"/var/lib/murmur/db.sqlite"})
+File name of the sqlite database. The service's user will become the owner
+of the directory.
+
address@hidden @code{log-file} (predeterminado:
@code{"/var/log/murmur/murmur.log"})
+File name of the log file. The service's user will become the owner of the
+directory.
+
address@hidden @code{autoban-attempts} (predeterminados: @code{10})
+Maximum number of logins a user can make in @code{autoban-timeframe} without
+getting auto banned for @code{autoban-time}.
+
address@hidden @code{autoban-timeframe} (predeterminado: @code{120})
+Timeframe for autoban in seconds.
+
address@hidden @code{autoban-time} (predeterminado: @code{300})
+Amount of time in seconds for which a client gets banned when violating the
+autoban limits.
+
address@hidden @code{opus-threshold} (predeterminado: @code{100})
+Percentage of clients that need to support opus before switching over to
+opus audio codec.
+
address@hidden @code{channel-nesting-limit} (predeterminado: @code{10})
+How deep channels can be nested at maximum.
+
address@hidden @code{channelname-regex} (predeterminado: @code{#f})
+A string in form of a Qt regular expression that channel names must conform
+to.
+
address@hidden @code{username-regex} (predeterminado: @code{#f})
+A string in form of a Qt regular expression that user names must conform to.
+
address@hidden @code{text-message-length} (predeterminado: @code{5000})
+Maximum size in bytes that a user can send in one text chat message.
+
address@hidden @code{image-message-length} (predeterminado: @code{(* 128 1024)})
+Maximum size in bytes that a user can send in one image message.
+
address@hidden @code{cert-required?} (predeterminado: @code{#f})
+If it is set to @code{#t} clients that use weak password authentification
+will not be accepted. Users must have completed the certificate wizard to
+join.
+
address@hidden @code{remember-channel?} (predeterminado: @code{#f})
+Should murmur remember the last channel each user was in when they
+disconnected and put them into the remembered channel when they rejoin.
+
address@hidden @code{allow-html?} (predeterminado: @code{#f})
+Should html be allowed in text messages, user comments, and channel
+descriptions.
+
address@hidden @code{allow-ping?} (predeterminado: @code{#f})
+Setting to true exposes the current user count, the maximum user count, and
+the server's maximum bandwidth per client to unauthenticated users. In the
+Mumble client, this information is shown in the Connect dialog.
+
+Disabling this setting will prevent public listing of the server.
+
address@hidden @code{bonjour?} (predeterminado: @code{#f})
+Should the server advertise itself in the local network through the bonjour
+protocol.
+
address@hidden @code{send-version?} (predeterminado: @code{#f})
+Should the murmur server version be exposed in ping requests.
+
address@hidden @code{log-days} (predeterminado: @code{31})
+Murmur also stores logs in the database, which are accessible via RPC. The
+default is 31 days of months, but you can set this setting to 0 to keep logs
+forever, or -1 to disable logging to the database.
+
address@hidden @code{obfuscate-ips?} (predeterminado: @code{#t})
+Should logged ips be obfuscated to protect the privacy of users.
+
address@hidden @code{ssl-cert} (predeterminado: @code{#f})
+File name of the SSL/TLS certificate used for encrypted connections.
+
address@hidden
+(ssl-cert "/etc/letsencrypt/live/example.com/fullchain.pem")
address@hidden example
address@hidden @code{ssl-key} (predeterminada: @code{#f})
+Filepath to the ssl private key used for encrypted connections.
address@hidden
+(ssl-key "/etc/letsencrypt/live/example.com/privkey.pem")
address@hidden example
+
address@hidden @code{ssl-dh-params} (predeterminado: @code{#f})
+File name of a PEM-encoded file with Diffie-Hellman parameters for the
+SSL/TLS encryption. Alternatively you set it to @code{"@@ffdhe2048"},
address@hidden"@@ffdhe3072"}, @code{"@@ffdhe4096"}, @code{"@@ffdhe6144"} or
address@hidden"@@ffdhe8192"} to use bundled parameters from RFC 7919.
+
address@hidden @code{ssl-ciphers} (predeterminado: @code{#f})
+The @code{ssl-ciphers} option chooses the cipher suites to make available
+for use in SSL/TLS.
+
+This option is specified using
address@hidden://www.openssl.org/docs/apps/ciphers.html#CIPHER-LIST-FORMAT,
+OpenSSL cipher list notation}.
+
+It is recommended that you try your cipher string using 'openssl ciphers
+<string>' before setting it here, to get a feel for which cipher suites you
+will get. After setting this option, it is recommend that you inspect your
+Murmur log to ensure that Murmur is using the cipher suites that you
+expected it to.
+
+Note: Changing this option may impact the backwards compatibility of your
+Murmur server, and can remove the ability for older Mumble clients to be
+able to connect to it.
+
address@hidden @code{public-registration} (predeterminado: @code{#f})
+Must be a @code{<murmur-public-registration-configuration>} record or
address@hidden
+
+You can optionally register your server in the public server list that the
address@hidden client shows on startup. You cannot register your server if
+you have set a @code{server-password}, or set @code{allow-ping} to
address@hidden
+
+It might take a few hours until it shows up in the public list.
+
address@hidden @code{file} (predeterminado: @code{#f})
+Optional alternative override for this configuration.
address@hidden table
address@hidden deftp
+
address@hidden {Tipo de datos} murmur-public-registration-configuration
+Configuration for public registration of a murmur service.
+
address@hidden @asis
address@hidden @code{name}
+This is a display name for your server. Not to be confused with the
+hostname.
+
address@hidden @code{password}
+A password to identify your registration. Subsequent updates will need the
+same password. Don't lose your password.
+
address@hidden @code{url}
+This should be a @code{http://} or @code{https://} link to your web site.
+
address@hidden @code{hostname} (predeterminado: @code{#f})
+By default your server will be listed by its IP address. If it is set your
+server will be linked by this host name instead.
address@hidden table
address@hidden deftp
+
+
+
address@hidden Servicios de monitorización
address@hidden Servicios de monitorización
+
address@hidden Servicio Tailon
+
address@hidden://tailon.readthedocs.io/, Tailon} is a web application for
+viewing and searching log files.
+
+The following example will configure the service with default values. By
+default, Tailon can be accessed on port 8080 (@code{http://localhost:8080}).
+
address@hidden
+(service tailon-service-type)
address@hidden example
+
+The following example customises more of the Tailon configuration, adding
address@hidden to the list of allowed commands.
+
address@hidden
+(service tailon-service-type
+ (tailon-configuration
+ (config-file
+ (tailon-configuration-file
+ (allowed-commands '("tail" "grep" "awk" "sed"))))))
address@hidden example
+
+
address@hidden {Tipo de datos} tailon-configuration
+Data type representing the configuration of Tailon. This type has the
+following parameters:
+
address@hidden @asis
address@hidden @code{config-file} (predeterminado:
@code{(tailon-configuration-file)})
+The configuration file to use for Tailon. This can be set to a
address@hidden record value, or any gexp
+(@pxref{Expresiones-G}).
+
+For example, to instead use a local file, the @code{local-file} function can
+be used:
+
address@hidden
+(service tailon-service-type
+ (tailon-configuration
+ (config-file (local-file "./mi-tailon.conf"))))
address@hidden example
+
address@hidden @code{package} (predeterminado: @code{tailon})
+El paquete tailon usado.
+
address@hidden table
address@hidden deftp
+
address@hidden {Tipo de datos} tailon-configuration-file
+Tipo de datos que representa las opciones de configuración de Tailon. Este
+tipo tiene los siguientes parámetros:
+
address@hidden @asis
address@hidden @code{files} (predeterminados: @code{(list "/var/log")})
+List of files to display. The list can include strings for a single file or
+directory, or a list, where the first item is the name of a subsection, and
+the remaining items are the files or directories in that subsection.
+
address@hidden @code{bind} (predeterminado: @code{"localhost:8080"})
+Address and port to which Tailon should bind on.
+
address@hidden @code{relative-root} (predeterminado: @code{#f})
+URL path to use for Tailon, set to @code{#f} to not use a path.
+
address@hidden @code{allow-transfers?} (predeterminado: @code{#t})
+Allow downloading the log files in the web interface.
+
address@hidden @code{follow-names?} (predeterminado: @code{#t})
+Allow tailing of not-yet existent files.
+
address@hidden @code{tail-lines} (predeterminado: @code{200})
+Number of lines to read initially from each file.
+
address@hidden @code{allowed-commands} (predeterminadas: @code{(list "tail"
"grep" "awk")})
+Órdenes cuya ejecución está permitida. Por defecto, @code{sed} está
+deshabilitado.
+
address@hidden @code{debug?} (predeterminado: @code{#f})
+Set @code{debug?} to @code{#t} to show debug messages.
+
address@hidden @code{wrap-lines} (predeterminado: @code{#t})
+Initial line wrapping state in the web interface. Set to @code{#t} to
+initially wrap lines (the default), or to @code{#f} to initially not wrap
+lines.
+
address@hidden @code{http-auth} (predeterminado: @code{#f})
+HTTP authentication type to use. Set to @code{#f} to disable authentication
+(the default). Supported values are @code{"digest"} or @code{"basic"}.
+
address@hidden @code{users} (predeterminado: @code{#f})
+If HTTP authentication is enabled (see @code{http-auth}), access will be
+restricted to the credentials provided here. To configure users, use a list
+of pairs, where the first element of the pair is the username, and the 2nd
+element of the pair is the password.
+
address@hidden
+(tailon-configuration-file
+ (http-auth "basic")
+ (users '(("usuaria1" . "contraseña1")
+ ("usuaria2" . "contraseña2"))))
address@hidden example
+
address@hidden table
address@hidden deftp
+
+
address@hidden Servicio Darkstat
address@hidden darkstat
+Darkstat is a packet sniffer that captures network traffic, calculates
+statistics about usage, and serves reports over HTTP.
+
address@hidden {Variable Scheme} darkstat-service-type
+This is the service type for the @uref{https://unix4lyfe.org/darkstat/,
+darkstat} service, its value must be a @code{darkstat-configuration} record
+as in this example:
+
address@hidden
+(service darkstat-service-type
+ (darkstat-configuration
+ (interface "eno1")))
address@hidden example
address@hidden defvar
+
address@hidden {Tipo de datos} darkstat-configuration
+Tipo de datos que representa la configuración de @command{darkstat}.
+
address@hidden @asis
address@hidden @code{package} (predeterminado: @code{darkstat})
+El paquete darkstat usado.
+
address@hidden @code{interface}
+Captura el tráfico en la interfaz de red especificada.
+
address@hidden @code{port} (predeterminado: @code{"667"})
+Bind the web interface to the specified port.
+
address@hidden @code{bind-address} (predeterminada: @code{"127.0.0.1"})
+Bind the web interface to the specified address.
+
address@hidden @code{base} (predeterminada: @code{"/"})
+Specify the path of the base URL. This can be useful if @command{darkstat}
+is accessed via a reverse proxy.
+
address@hidden table
address@hidden deftp
+
address@hidden Servicio del exportador de nodos Prometheus
+
address@hidden prometheus-node-exporter
+The Prometheus ``node exporter'' makes hardware and operating system
+statistics provided by the Linux kernel available for the Prometheus
+monitoring system. This service should be deployed on all physical nodes
+and virtual machines, where monitoring these statistics is desirable.
+
address@hidden {Variable Scheme} prometheus-node-exporter-service-type
+This is the service type for the
address@hidden://github.com/prometheus/node_exporter/,
+prometheus-node-exporter} service, its value must be a
address@hidden record as in this example:
+
address@hidden
+(service prometheus-node-exporter-service-type
+ (prometheus-node-exporter-configuration
+ (web-listen-address ":9100")))
address@hidden example
address@hidden defvar
+
address@hidden {Tipo de datos} prometheus-node-exporter-configuration
+Tipo de datos que representa la configuración de @command{node_exporter}.
+
address@hidden @asis
address@hidden @code{package} (predeterminado:
@code{go-github-com-prometheus-node-exporter})
+El paquete prometheus-node-exporter usado.
+
address@hidden @code{web-listen-address} (predeterminada: @code{":9100"})
+Bind the web interface to the specified address.
+
address@hidden table
address@hidden deftp
+
address@hidden Zabbix server
address@hidden zabbix zabbix-server
+Zabbix provides monitoring metrics, among others network utilization, CPU
+load and disk space consumption:
+
address@hidden
address@hidden High performance, high capacity (able to monitor hundreds of
thousands of devices).
address@hidden Auto-discovery of servers and network devices and interfaces.
address@hidden Low-level discovery, allows to automatically start monitoring
new items, file systems or network interfaces among others.
address@hidden Distributed monitoring with centralized web administration.
address@hidden Native high performance agents.
address@hidden SLA, and ITIL KPI metrics on reporting.
address@hidden High-level (business) view of monitored resources through
user-defined visual console screens and dashboards.
address@hidden Remote command execution through Zabbix proxies.
address@hidden itemize
+
address@hidden %start of fragment
+
+Available @code{zabbix-server-configuration} fields are:
+
address@hidden address@hidden parameter} package zabbix-server
+The zabbix-server package.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string user
+User who will run the Zabbix server.
+
+Defaults to @samp{"zabbix"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} group group
+Group who will run the Zabbix server.
+
+Defaults to @samp{"zabbix"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string db-host
+Database host name.
+
+Defaults to @samp{"127.0.0.1"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string db-name
+Database name.
+
+Defaults to @samp{"zabbix"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string db-user
+Database user.
+
+Defaults to @samp{"zabbix"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string db-password
+Database password. Please, use @code{include-files} with
address@hidden inside a specified file instead.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} number db-port
+Database port.
+
+Defaults to @samp{5432}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string log-type
+Specifies where log messages are written to:
+
address@hidden @bullet
address@hidden
address@hidden - syslog.
+
address@hidden
address@hidden - file specified with @code{log-file} parameter.
+
address@hidden
address@hidden - standard output.
+
address@hidden itemize
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string log-file
+Log file name for @code{log-type} @code{file} parameter.
+
+Defaults to @samp{"/var/log/zabbix/server.log"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string pid-file
+Name of PID file.
+
+Defaults to @samp{"/var/run/zabbix/zabbix_server.pid"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string ssl-ca-location
+The location of certificate authority (CA) files for SSL server certificate
+verification.
+
+Defaults to @samp{"/etc/ssl/certs/ca-certificates.crt"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string ssl-cert-location
+Location of SSL client certificates.
+
+Defaults to @samp{"/etc/ssl/certs"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string extra-options
+Extra options will be appended to Zabbix server configuration file.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} include-files include-files
+You may include individual files or all files in a directory in the
+configuration file.
+
+Defaults to @samp{()}.
+
address@hidden deftypevr
+
address@hidden %end of fragment
+
address@hidden Zabbix agent
address@hidden zabbix zabbix-agent
+
+Zabbix agent gathers information for Zabbix server.
+
address@hidden %start of fragment
+
+Available @code{zabbix-agent-configuration} fields are:
+
address@hidden address@hidden parameter} package zabbix-agent
+The zabbix-agent package.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string user
+User who will run the Zabbix agent.
+
+Defaults to @samp{"zabbix"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} group group
+Group who will run the Zabbix agent.
+
+Defaults to @samp{"zabbix"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string hostname
+Unique, case sensitive hostname which is required for active checks and must
+match hostname as configured on the server.
+
+Defaults to @samp{"Zabbix server"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string log-type
+Specifies where log messages are written to:
+
address@hidden @bullet
address@hidden
address@hidden - syslog.
+
address@hidden
address@hidden - file specified with @code{log-file} parameter.
+
address@hidden
address@hidden - standard output.
+
address@hidden itemize
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string log-file
+Log file name for @code{log-type} @code{file} parameter.
+
+Defaults to @samp{"/var/log/zabbix/agent.log"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string pid-file
+Name of PID file.
+
+Defaults to @samp{"/var/run/zabbix/zabbix_agent.pid"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} list server
+List of IP addresses, optionally in CIDR notation, or hostnames of Zabbix
+servers and Zabbix proxies. Incoming connections will be accepted only from
+the hosts listed here.
+
+Defaults to @samp{("127.0.0.1")}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} list server-active
+List of IP:port (or hostname:port) pairs of Zabbix servers and Zabbix
+proxies for active checks. If port is not specified, default port is used.
+If this parameter is not specified, active checks are disabled.
+
+Defaults to @samp{("127.0.0.1")}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string extra-options
+Extra options will be appended to Zabbix server configuration file.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} include-files include-files
+You may include individual files or all files in a directory in the
+configuration file.
+
+Defaults to @samp{()}.
+
address@hidden deftypevr
+
address@hidden %end of fragment
+
address@hidden Zabbix front-end
address@hidden zabbix zabbix-front-end
+
+This service provides a WEB interface to Zabbix server.
+
address@hidden %start of fragment
+
+Available @code{zabbix-front-end-configuration} fields are:
+
address@hidden address@hidden parameter} nginx-server-configuration-list nginx
+Configuración de NGINX.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string db-host
+Database host name.
+
+Defaults to @samp{"localhost"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} number db-port
+Database port.
+
+Defaults to @samp{5432}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string db-name
+Database name.
+
+Defaults to @samp{"zabbix"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string db-user
+Database user.
+
+Defaults to @samp{"zabbix"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string db-password
+Database password. Please, use @code{db-secret-file} instead.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string db-secret-file
+Secret file which will be appended to @file{zabbix.conf.php} file. This
+file contains credentials for use by Zabbix front-end. You are expected to
+create it manually.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string zabbix-host
+Zabbix server hostname.
+
+Defaults to @samp{"localhost"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} number zabbix-port
+Zabbix server port.
+
+Defaults to @samp{10051}.
+
address@hidden deftypevr
+
+
address@hidden %end of fragment
+
address@hidden Servicios Kerberos
address@hidden Servicios Kerberos
address@hidden Kerberos
+
+The @code{(gnu services kerberos)} module provides services relating to the
+authentication protocol @dfn{Kerberos}.
+
address@hidden Servicio Krb5
+
+Programs using a Kerberos client library normally expect a configuration
+file in @file{/etc/krb5.conf}. This service generates such a file from a
+definition provided in the operating system declaration. It does not cause
+any daemon to be started.
+
+No ``keytab'' files are provided by this service---you must explicitly
+create them. This service is known to work with the MIT client library,
address@hidden Other implementations have not been tested.
+
address@hidden {Variable Scheme} krb5-service-type
+A service type for Kerberos 5 clients.
address@hidden defvr
+
address@hidden
+Este es un ejemplo de su uso:
address@hidden
+(service krb5-service-type
+ (krb5-configuration
+ (default-realm "EXAMPLE.COM")
+ (allow-weak-crypto? #t)
+ (realms (list
+ (krb5-realm
+ (name "EXAMPLE.COM")
+ (admin-server "groucho.example.com")
+ (kdc "karl.example.com"))
+ (krb5-realm
+ (name "ARGRX.EDU")
+ (admin-server "kerb-admin.argrx.edu")
+ (kdc "keys.argrx.edu"))))))
address@hidden lisp
+
address@hidden
+This example provides a address@hidden client configuration which:
address@hidden
address@hidden Recognizes two realms, @i{viz:} ``EXAMPLE.COM'' and
``ARGRX.EDU'', both
+of which have distinct administration servers and key distribution centers;
address@hidden Will default to the realm ``EXAMPLE.COM'' if the realm is not
explicitly
+specified by clients;
address@hidden Accepts services which only support encryption types known to be
weak.
address@hidden itemize
+
+The @code{krb5-realm} and @code{krb5-configuration} types have many fields.
+Only the most commonly used ones are described here. For a full list, and
+more detailed explanation of each, see the MIT
address@hidden://web.mit.edu/kerberos/krb5-devel/doc/admin/conf_files/krb5_conf.html,,krb5.conf}
+documentation.
+
+
address@hidden {Tipo de datos} krb5-realm
address@hidden realm, kerberos
address@hidden @asis
address@hidden @code{name}
+This field is a string identifying the name of the realm. A common
+convention is to use the fully qualified DNS name of your organization,
+converted to upper case.
+
address@hidden @code{admin-server}
+This field is a string identifying the host where the administration server
+is running.
+
address@hidden @code{kdc}
+This field is a string identifying the key distribution center for the
+realm.
address@hidden table
address@hidden deftp
+
address@hidden {Tipo de datos} krb5-configuration
+
address@hidden @asis
address@hidden @code{allow-weak-crypto?} (predeterminado: @code{#f})
+If this flag is @code{#t} then services which only offer encryption
+algorithms known to be weak will be accepted.
+
address@hidden @code{default-realm} (predeterminado: @code{#f})
+This field should be a string identifying the default Kerberos realm for the
+client. You should set this field to the name of your Kerberos realm. If
+this value is @code{#f} then a realm must be specified with every Kerberos
+principal when invoking programs such as @command{kinit}.
+
address@hidden @code{realms}
+This should be a non-empty list of @code{krb5-realm} objects, which clients
+may access. Normally, one of them will have a @code{name} field matching
+the @code{default-realm} field.
address@hidden table
address@hidden deftp
+
+
address@hidden Servicio PAM krb5
address@hidden pam-krb5
+
+The @code{pam-krb5} service allows for login authentication and password
+management via Kerberos. You will need this service if you want PAM enabled
+applications to authenticate users using Kerberos.
+
address@hidden {Variable Scheme} pam-krb5-service-type
+A service type for the Kerberos 5 PAM module.
address@hidden defvr
+
address@hidden {Tipo de datos} pam-krb5-configuration
+Data type representing the configuration of the Kerberos 5 PAM module This
+type has the following parameters:
address@hidden @asis
address@hidden @code{pam-krb5} (predeterminado: @code{pam-krb5})
+El paquete pam-krb5 usado.
+
address@hidden @code{minimum-uid} (predeterminado: @code{1000})
+The smallest user ID for which Kerberos authentications should be
+attempted. Local accounts with lower values will silently fail to
+authenticate.
address@hidden table
address@hidden deftp
+
+
address@hidden Servicios LDAP
address@hidden Servicios LDAP
address@hidden LDAP
address@hidden nslcd, LDAP service
+
+The @code{(gnu services authentication)} module provides the
address@hidden, which can be used to authenticate against an LDAP
+server. In addition to configuring the service itself, you may want to add
address@hidden as a name service to the Name Service Switch. @xref{Selector de
servicios de nombres} for detailed information.
+
+Here is a simple operating system declaration with a default configuration
+of the @code{nslcd-service-type} and a Name Service Switch configuration
+that consults the @code{ldap} name service last:
+
address@hidden
+(use-service-modules authentication)
+(use-modules (gnu system nss))
+...
+(operating-system
+ ...
+ (services
+ (cons*
+ (service nslcd-service-type)
+ (service dhcp-client-service-type)
+ %base-services))
+ (name-service-switch
+ (let ((services (list (name-service (name "db"))
+ (name-service (name "files"))
+ (name-service (name "ldap")))))
+ (name-service-switch
+ (inherit %mdns-host-lookup-nss)
+ (password services)
+ (shadow services)
+ (group services)
+ (netgroup services)
+ (gshadow services)))))
address@hidden example
+
address@hidden %start of generated documentation for nslcd-configuration
+
+Available @code{nslcd-configuration} fields are:
+
address@hidden address@hidden parameter} package nss-pam-ldapd
+The @code{nss-pam-ldapd} package to use.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-number threads
+The number of threads to start that can handle requests and perform LDAP
+queries. Each thread opens a separate connection to the LDAP server. The
+default is to start 5 threads.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string uid
+This specifies the user id with which the daemon should be run.
+
+Defaults to @samp{"nslcd"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string gid
+This specifies the group id with which the daemon should be run.
+
+Defaults to @samp{"nslcd"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} log-option log
+This option controls the way logging is done via a list containing SCHEME
+and LEVEL. The SCHEME argument may either be the symbols "none" or
+"syslog", or an absolute file name. The LEVEL argument is optional and
+specifies the log level. The log level may be one of the following symbols:
+"crit", "error", "warning", "notice", "info" or "debug". All messages with
+the specified log level or higher are logged.
+
+Defaults to @samp{("/var/log/nslcd" info)}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} list uri
+The list of LDAP server URIs. Normally, only the first server will be used
+with the following servers as fall-back.
+
+Defaults to @samp{("ldap://localhost:389/";)}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-string ldap-version
+The version of the LDAP protocol to use. The default is to use the maximum
+version supported by the LDAP library.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-string binddn
+Specifies the distinguished name with which to bind to the directory server
+for lookups. The default is to bind anonymously.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-string bindpw
+Specifies the credentials with which to bind. This option is only
+applicable when used with binddn.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-string rootpwmoddn
+Specifies the distinguished name to use when the root user tries to modify a
+user's password using the PAM module.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-string rootpwmodpw
+Specifies the credentials with which to bind if the root user tries to
+change a user's password. This option is only applicable when used with
+rootpwmoddn
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-string sasl-mech
+Specifies the SASL mechanism to be used when performing SASL authentication.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-string sasl-realm
+Specifies the SASL realm to be used when performing SASL authentication.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-string sasl-authcid
+Specifies the authentication identity to be used when performing SASL
+authentication.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-string sasl-authzid
+Specifies the authorization identity to be used when performing SASL
+authentication.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-boolean sasl-canonicalize?
+Determines whether the LDAP server host name should be canonicalised. If
+this is enabled the LDAP library will do a reverse host name lookup. By
+default, it is left up to the LDAP library whether this check is performed
+or not.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-string krb5-ccname
+Set the name for the GSS-API Kerberos credentials cache.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string base
+The directory search base.
+
+Defaults to @samp{"dc=example,dc=com"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} scope-option scope
+Specifies the search scope (subtree, onelevel, base or children). The
+default scope is subtree; base scope is almost never useful for name service
+lookups; children scope is not supported on all servers.
+
+Defaults to @samp{(subtree)}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-deref-option deref
+Specifies the policy for dereferencing aliases. The default policy is to
+never dereference aliases.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-boolean referrals
+Specifies whether automatic referral chasing should be enabled. The default
+behaviour is to chase referrals.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} list-of-map-entries maps
+This option allows for custom attributes to be looked up instead of the
+default RFC 2307 attributes. It is a list of maps, each consisting of the
+name of a map, the RFC 2307 attribute to match and the query expression for
+the attribute as it is available in the directory.
+
+Defaults to @samp{()}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} list-of-filter-entries filters
+A list of filters consisting of the name of a map to which the filter
+applies and an LDAP search filter expression.
+
+Defaults to @samp{()}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-number bind-timelimit
+Specifies the time limit in seconds to use when connecting to the directory
+server. The default value is 10 seconds.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-number timelimit
+Specifies the time limit (in seconds) to wait for a response from the LDAP
+server. A value of zero, which is the default, is to wait indefinitely for
+searches to be completed.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-number idle-timelimit
+Specifies the period if inactivity (in seconds) after which the con‐ nection
+to the LDAP server will be closed. The default is not to time out
+connections.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-number reconnect-sleeptime
+Specifies the number of seconds to sleep when connecting to all LDAP servers
+fails. By default one second is waited between the first failure and the
+first retry.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-number reconnect-retrytime
+Specifies the time after which the LDAP server is considered to be
+permanently unavailable. Once this time is reached retries will be done
+only once per this time period. The default value is 10 seconds.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-ssl-option ssl
+Specifies whether to use SSL/TLS or not (the default is not to). If
+'start-tls is specified then StartTLS is used rather than raw LDAP over SSL.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-tls-reqcert-option tls-reqcert
+Specifies what checks to perform on a server-supplied certificate. The
+meaning of the values is described in the ldap.conf(5) manual page.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-string tls-cacertdir
+Specifies the directory containing X.509 certificates for peer authen‐
+tication. This parameter is ignored when using GnuTLS.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-string tls-cacertfile
+Specifies the path to the X.509 certificate for peer authentication.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-string tls-randfile
+Specifies the path to an entropy source. This parameter is ignored when
+using GnuTLS.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-string tls-ciphers
+Specifies the ciphers to use for TLS as a string.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-string tls-cert
+Specifies the path to the file containing the local certificate for client
+TLS authentication.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-string tls-key
+Specifies the path to the file containing the private key for client TLS
+authentication.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-number pagesize
+Set this to a number greater than 0 to request paged results from the LDAP
+server in accordance with RFC2696. The default (0) is to not request paged
+results.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-ignore-users-option
nss-initgroups-ignoreusers
+This option prevents group membership lookups through LDAP for the specified
+users. Alternatively, the value 'all-local may be used. With that value
+nslcd builds a full list of non-LDAP users on startup.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-number nss-min-uid
+This option ensures that LDAP users with a numeric user id lower than the
+specified value are ignored.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-number nss-uid-offset
+This option specifies an offset that is added to all LDAP numeric user ids.
+This can be used to avoid user id collisions with local users.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-number nss-gid-offset
+This option specifies an offset that is added to all LDAP numeric group
+ids. This can be used to avoid user id collisions with local groups.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-boolean nss-nested-groups
+If this option is set, the member attribute of a group may point to another
+group. Members of nested groups are also returned in the higher level group
+and parent groups are returned when finding groups for a specific user. The
+default is not to perform extra searches for nested groups.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-boolean nss-getgrent-skipmembers
+If this option is set, the group member list is not retrieved when looking
+up groups. Lookups for finding which groups a user belongs to will remain
+functional so the user will likely still get the correct groups assigned on
+login.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-boolean nss-disable-enumeration
+If this option is set, functions which cause all user/group entries to be
+loaded from the directory will not succeed in doing so. This can
+dramatically reduce LDAP server load in situations where there are a great
+number of users and/or groups. This option is not recommended for most
+configurations.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-string validnames
+This option can be used to specify how user and group names are verified
+within the system. This pattern is used to check all user and group names
+that are requested and returned from LDAP.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-boolean ignorecase
+This specifies whether or not to perform searches using case-insensitive
+matching. Enabling this could open up the system to authorization bypass
+vulnerabilities and introduce nscd cache poisoning vulnerabilities which
+allow denial of service.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-boolean pam-authc-ppolicy
+This option specifies whether password policy controls are requested and
+handled from the LDAP server when performing user authentication.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-string pam-authc-search
+By default nslcd performs an LDAP search with the user's credentials after
+BIND (authentication) to ensure that the BIND operation was successful. The
+default search is a simple check to see if the user's DN exists. A search
+filter can be specified that will be used instead. It should return at
+least one entry.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-string pam-authz-search
+This option allows flexible fine tuning of the authorisation check that
+should be performed. The search filter specified is executed and if any
+entries match, access is granted, otherwise access is denied.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-string
pam-password-prohibit-message
+If this option is set password modification using pam_ldap will be denied
+and the specified message will be presented to the user instead. The
+message can be used to direct the user to an alternative means of changing
+their password.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} list pam-services
+List of pam service names for which LDAP authentication should suffice.
+
+Defaults to @samp{()}.
+
address@hidden deftypevr
+
address@hidden %end of generated documentation for nslcd-configuration
+
+
address@hidden Servicios Web
address@hidden Servicios Web
+
address@hidden web
address@hidden www
address@hidden HTTP
+El módulo @code{(gnu services web)} proporciona el servidor HTTP Apache, el
+servidor web nginx y también un recubrimiento del daemon de fastcgi.
+
address@hidden Servidor HTTP Apache
+
address@hidden {Variable Scheme} httpd-service-type
+Service type for the @uref{https://httpd.apache.org/,Apache HTTP} server
+(@dfn{httpd}). The value for this service type is a
address@hidden record.
+
+A simple example configuration is given below.
+
address@hidden
+(service httpd-service-type
+ (httpd-configuration
+ (config
+ (httpd-config-file
+ (server-name "www.example.com")
+ (document-root "/srv/http/www.example.com")))))
address@hidden example
+
+Other services can also extend the @code{httpd-service-type} to add to the
+configuration.
+
address@hidden
+(simple-service 'mi-servidor-extra httpd-service-type
+ (list
+ (httpd-virtualhost
+ "*:80"
+ (list (string-append
+ "ServerName "www.example.com
+ DocumentRoot \"/srv/http/www.example.com\"")))))
address@hidden example
address@hidden deffn
+
+The details for the @code{httpd-configuration}, @code{httpd-module},
address@hidden and @code{httpd-virtualhost} record types are given
+below.
+
address@hidden {Tipo de datos} httpd-configuration
+This data type represents the configuration for the httpd service.
+
address@hidden @asis
address@hidden @code{package} (predeterminado: @code{httpd})
+El paquete httpd usado.
+
address@hidden @code{pid-file} (predeterminado: @code{"/var/run/httpd"})
+El fichero pid usado por el servicio de Shepherd.
+
address@hidden @code{config} (predeterminado: @code{(httpd-config-file)})
+The configuration file to use with the httpd service. The default value is a
address@hidden record, but this can also be a different
+G-expression that generates a file, for example a @code{plain-file}. A file
+outside of the store can also be specified through a string.
+
address@hidden table
address@hidden deffn
+
address@hidden {Tipo de datos} httpd-module
+This data type represents a module for the httpd service.
+
address@hidden @asis
address@hidden @code{name}
+The name of the module.
+
address@hidden @code{file}
+The file for the module. This can be relative to the httpd package being
+used, the absolute location of a file, or a G-expression for a file within
+the store, for example @code{(file-append mod-wsgi "/modules/mod_wsgi.so")}.
+
address@hidden table
address@hidden deffn
+
address@hidden {Variable Scheme} %default-httpd-modules
+A default list of @code{httpd-module} objects.
address@hidden defvr
+
address@hidden {Tipo de datos} httpd-config-file
+This data type represents a configuration file for the httpd service.
+
address@hidden @asis
address@hidden @code{modules} (predeterminados: @code{%default-httpd-modules})
+The modules to load. Additional modules can be added here, or loaded by
+additional configuration.
+
+For example, in order to handle requests for PHP files, you can use Apache’s
address@hidden module along with @code{php-fpm-service-type}:
+
address@hidden
+(service httpd-service-type
+ (httpd-configuration
+ (config
+ (httpd-config-file
+ (modules (cons*
+ (httpd-module
+ (name "proxy_module")
+ (file "modules/mod_proxy.so"))
+ (httpd-module
+ (name "proxy_fcgi_module")
+ (file "modules/mod_proxy_fcgi.so"))
+ %default-httpd-modules))
+ (extra-config (list "\
+<FilesMatch \\.php$>
+ SetHandler \"proxy:unix:/var/run/php-fpm.sock|fcgi://localhost/\"
+</FilesMatch>"))))))
+(service php-fpm-service-type
+ (php-fpm-configuration
+ (socket "/var/run/php-fpm.sock")
+ (socket-group "httpd")))
address@hidden example
+
address@hidden @code{server-root} (predeterminado: @code{httpd})
+The @code{ServerRoot} in the configuration file, defaults to the httpd
+package. Directives including @code{Include} and @code{LoadModule} are taken
+as relative to the server root.
+
address@hidden @code{server-name} (predeterminado: @code{#f})
+The @code{ServerName} in the configuration file, used to specify the request
+scheme, hostname and port that the server uses to identify itself.
+
+This doesn't need to be set in the server config, and can be specifyed in
+virtual hosts. The default is @code{#f} to not specify a @code{ServerName}.
+
address@hidden @code{document-root} (predeterminado: @code{"/srv/http"})
+The @code{DocumentRoot} from which files will be served.
+
address@hidden @code{listen} (predeterminado: @code{'("80")})
+The list of values for the @code{Listen} directives in the config file. The
+value should be a list of strings, when each string can specify the port
+number to listen on, and optionally the IP address and protocol to use.
+
address@hidden @code{pid-file} (predeterminado: @code{"/var/run/httpd"})
+The @code{PidFile} to use. This should match the @code{pid-file} set in the
address@hidden so that the Shepherd service is configured
+correctly.
+
address@hidden @code{error-log} (predeterminado:
@code{"/var/log/httpd/error_log"})
+The @code{ErrorLog} to which the server will log errors.
+
address@hidden @code{user} (predeterminada: @code{"httpd"})
+La usuaria como la que el servidor responderá a las peticiones.
+
address@hidden @code{group} (predeterminado: @code{"httpd"})
+El grupo como el que el servidor responderá a las peticiones.
+
address@hidden @code{extra-config} (predeterminadas: @code{(list "TypesConfig
etc/httpd/mime.types")})
+A flat list of strings and G-expressions which will be added to the end of
+the configuration file.
+
+Any values which the service is extended with will be appended to this list.
+
address@hidden table
address@hidden deffn
+
address@hidden {Tipo de datos} httpd-virtualhost
+This data type represents a virtualhost configuration block for the httpd
+service.
+
+These should be added to the extra-config for the httpd-service.
+
address@hidden
+(simple-service 'mi-servidor-extra httpd-service-type
+ (list
+ (httpd-virtualhost
+ "*:80"
+ (list (string-append
+ "ServerName "www.example.com
+ DocumentRoot \"/srv/http/www.example.com\"")))))
address@hidden example
+
address@hidden @asis
address@hidden @code{addresses-and-ports}
+The addresses and ports for the @code{VirtualHost} directive.
+
address@hidden @code{contents}
+The contents of the @code{VirtualHost} directive, this should be a list of
+strings and G-expressions.
+
address@hidden table
address@hidden deffn
+
address@hidden NGINX
+
address@hidden {Variable Scheme} nginx-service-type
+Service type for the @uref{https://nginx.org/,NGinx} web server. The value
+for this service type is a @code{<nginx-configuration>} record.
+
+A simple example configuration is given below.
+
address@hidden
+(service nginx-service-type
+ (nginx-configuration
+ (server-blocks
+ (list (nginx-server-configuration
+ (server-name '("www.example.com"))
+ (root "/srv/http/www.example.com"))))))
address@hidden example
+
+In addition to adding server blocks to the service configuration directly,
+this service can be extended by other services to add server blocks, as in
+this example:
+
address@hidden
+(simple-service 'mi-servidor-extra nginx-service-type
+ (list (nginx-server-configuration
+ (root "/srv/http/sitio-extra")
+ (try-files (list "$uri" "$uri/index.html")))))
address@hidden example
address@hidden deffn
+
+At startup, @command{nginx} has not yet read its configuration file, so it
+uses a default file to log error messages. If it fails to load its
+configuration file, that is where error messages are logged. After the
+configuration file is loaded, the default error log file changes as per
+configuration. In our case, startup error messages can be found in
address@hidden/var/run/nginx/logs/error.log}, and after configuration in
address@hidden/var/log/nginx/error.log}. The second location can be changed
with
+the @var{log-directory} configuration option.
+
address@hidden {Tipo de datos} nginx-configuration
+This data type represents the configuration for NGinx. Some configuration
+can be done through this and the other provided record types, or
+alternatively, a config file can be provided.
+
address@hidden @asis
address@hidden @code{nginx} (predeterminado: @code{nginx})
+El paquete nginx usado.
+
address@hidden @code{log-directory} (predeterminado: @code{"/var/log/nginx"})
+The directory to which NGinx will write log files.
+
address@hidden @code{run-directory} (predeterminado: @code{"/var/run/nginx"})
+The directory in which NGinx will create a pid file, and write temporary
+files.
+
address@hidden @code{server-blocks} (predeterminados: @code{'()})
+A list of @dfn{server blocks} to create in the generated configuration file,
+the elements should be of type @code{<nginx-server-configuration>}.
+
+The following example would setup NGinx to serve @code{www.example.com} from
+the @code{/srv/http/www.example.com} directory, without using HTTPS.
address@hidden
+(service nginx-service-type
+ (nginx-configuration
+ (server-blocks
+ (list (nginx-server-configuration
+ (server-name '("www.example.com"))
+ (root "/srv/http/www.example.com"))))))
address@hidden example
+
address@hidden @code{upstream-blocks} (predeterminados: @code{'()})
+A list of @dfn{upstream blocks} to create in the generated configuration
+file, the elements should be of type @code{<nginx-upstream-configuration>}.
+
+Configuring upstreams through the @code{upstream-blocks} can be useful when
+combined with @code{locations} in the @code{<nginx-server-configuration>}
+records. The following example creates a server configuration with one
+location configuration, that will proxy requests to a upstream
+configuration, which will handle requests with two servers.
+
address@hidden
+(service
+ nginx-service-type
+ (nginx-configuration
+ (server-blocks
+ (list (nginx-server-configuration
+ (server-name '("www.example.com"))
+ (root "/srv/http/www.example.com")
+ (locations
+ (list
+ (nginx-location-configuration
+ (uri "/path1")
+ (body '("proxy_pass http://server-proxy;";))))))))
+ (upstream-blocks
+ (list (nginx-upstream-configuration
+ (name "server-proxy")
+ (servers (list "server1.example.com"
+ "server2.example.com")))))))
address@hidden example
+
address@hidden @code{file} (predeterminado: @code{#f})
+If a configuration @var{file} is provided, this will be used, rather than
+generating a configuration file from the provided @code{log-directory},
address@hidden, @code{server-blocks} and @code{upstream-blocks}. For
+proper operation, these arguments should match what is in @var{file} to
+ensure that the directories are created when the service is activated.
+
+This can be useful if you have an existing configuration file, or it's not
+possible to do what is required through the other parts of the
+nginx-configuration record.
+
address@hidden @code{server-names-hash-bucket-size} (predeterminado: @code{#f})
+Bucket size for the server names hash tables, defaults to @code{#f} to use
+the size of the processors cache line.
+
address@hidden @code{server-names-hash-bucket-max-size} (predeterminado:
@code{#f})
+Maximum bucket size for the server names hash tables.
+
address@hidden @code{extra-content} (predeterminado: @code{""})
+Extra content for the @code{http} block. Should be string or a string
+valued G-expression.
+
address@hidden table
address@hidden deffn
+
address@hidden {Tipo de datos} nginx-server-configuration
+Data type representing the configuration of an nginx server block. This
+type has the following parameters:
+
address@hidden @asis
address@hidden @code{listen} (predeterminadas: @code{'("80" "443 ssl")})
+Each @code{listen} directive sets the address and port for IP, or the path
+for a UNIX-domain socket on which the server will accept requests. Both
+address and port, or only address or only port can be specified. An address
+may also be a hostname, for example:
+
address@hidden
+'("127.0.0.1:8000" "127.0.0.1" "8000" "*:8000" "localhost:8000")
address@hidden example
+
address@hidden @code{server-name} (predeterminados: @code{(list 'default)})
+A list of server names this server represents. @code{'default} represents
+the default server for connections matching no other server.
+
address@hidden @code{root} (predeterminada: @code{"/srv/http"})
+Raíz del sitio web que nginx proporcionará.
+
address@hidden @code{locations} (predeterminado: @code{'()})
+A list of @dfn{nginx-location-configuration} or
address@hidden records to use within this server
+block.
+
address@hidden @code{index} (predeterminado: @code{(list "index.html")})
+Index files to look for when clients ask for a directory. If it cannot be
+found, Nginx will send the list of files in the directory.
+
address@hidden @code{try-files} (predeterminado: @code{'()})
+A list of files whose existence is checked in the specified order.
address@hidden will use the first file it finds to process the request.
+
address@hidden @code{ssl-certificate} (predeterminado: @code{#f})
+Where to find the certificate for secure connections. Set it to @code{#f}
+if you don't have a certificate or you don't want to use HTTPS.
+
address@hidden @code{ssl-certificate-key} (predeterminado: @code{#f})
+Where to find the private key for secure connections. Set it to @code{#f}
+if you don't have a key or you don't want to use HTTPS.
+
address@hidden @code{server-tokens?} (predeterminado: @code{#f})
+Whether the server should add its configuration to response.
+
address@hidden @code{raw-content} (predeterminado: @code{'()})
+A list of raw lines added to the server block.
+
address@hidden table
address@hidden deftp
+
address@hidden {Tipo de datos} nginx-upstream-configuration
+Data type representing the configuration of an nginx @code{upstream} block.
+This type has the following parameters:
+
address@hidden @asis
address@hidden @code{name}
+Name for this group of servers.
+
address@hidden @code{servers}
+Specify the addresses of the servers in the group. The address can be
+specified as a IP address (e.g.@: @samp{127.0.0.1}), domain name (e.g.@:
address@hidden) or a path to a UNIX socket using the prefix
address@hidden:}. For addresses using an IP address or domain name, the default
+port is 80, and a different port can be specified explicitly.
+
address@hidden table
address@hidden deftp
+
address@hidden {Tipo de datos} nginx-location-configuration
+Data type representing the configuration of an nginx @code{location} block.
+This type has the following parameters:
+
address@hidden @asis
address@hidden @code{uri}
+URI which this location block matches.
+
address@hidden body}
address@hidden @code{body}
+Body of the location block, specified as a list of strings. This can contain
+many configuration directives. For example, to pass requests to a upstream
+server group defined using an @code{nginx-upstream-configuration} block, the
+following directive would be specified in the body @samp{(list "proxy_pass
+http://upstream-name;";)}.
+
address@hidden table
address@hidden deftp
+
address@hidden {Tipo de datos} nginx-named-location-configuration
+Data type representing the configuration of an nginx named location block.
+Named location blocks are used for request redirection, and not used for
+regular request processing. This type has the following parameters:
+
address@hidden @asis
address@hidden @code{name}
+Name to identify this location block.
+
address@hidden @code{body}
address@hidden body}, as the body for named location
+blocks can be used in a similar way to the
address@hidden body}. One restriction is that the body
+of a named location block cannot contain location blocks.
+
address@hidden table
address@hidden deftp
+
address@hidden Varnish Cache
address@hidden Varnish
+Varnish is a fast cache server that sits in between web applications and end
+users. It proxies requests from clients and caches the accessed URLs such
+that multiple requests for the same resource only creates one request to the
+back-end.
+
address@hidden {Variable Scheme} varnish-service-type
+Service type for the Varnish daemon.
address@hidden defvr
+
address@hidden {Tipo de datos} varnish-configuration
+Data type representing the @code{varnish} service configuration. This type
+has the following parameters:
+
address@hidden @asis
address@hidden @code{package} (predeterminado: @code{varnish})
+El paquete Varnish usado.
+
address@hidden @code{name} (predeterminado: @code{"default"})
+A name for this Varnish instance. Varnish will create a directory in
address@hidden/var/varnish/} with this name and keep temporary files there. If
the
+name starts with a forward slash, it is interpreted as an absolute directory
+name.
+
+Pass the @code{-n} argument to other Varnish programs to connect to the
+named instance, e.g.@: @command{varnishncsa -n default}.
+
address@hidden @code{backend} (predeterminado: @code{"localhost:8080"})
+The backend to use. This option has no effect if @code{vcl} is set.
+
address@hidden @code{vcl} (predeterminado: #f)
+The @dfn{VCL} (Varnish Configuration Language) program to run. If this is
address@hidden, Varnish will proxy @code{backend} using the default
+configuration. Otherwise this must be a file-like object with valid VCL
+syntax.
+
address@hidden Varnish does not support HTTPS, so keep this URL to avoid
confusion.
+For example, to mirror @url{http://www.gnu.org,www.gnu.org} with VCL you can
+do something along these lines:
+
address@hidden
+(define %espejo-gnu
+ (plain-file
+ "gnu.vcl"
+ "vcl 4.1;
+backend gnu @{ .host = "www.gnu.org"; @}"))
+
+(operating-system
+ ...
+ (services (cons (service varnish-service-type
+ (varnish-configuration
+ (listen '(":80"))
+ (vcl %espejo-gnu)))
+ %base-services)))
address@hidden example
+
+The configuration of an already running Varnish instance can be inspected
+and changed using the @command{varnishadm} program.
+
+Consult the @url{https://varnish-cache.org/docs/,Varnish User Guide} and
address@hidden://book.varnish-software.com/4.0/,Varnish Book} for comprehensive
+documentation on Varnish and its configuration language.
+
address@hidden @code{listen} (predeterminada: @code{'("localhost:80")})
+Lista de direcciones en las que Varnish escucha.
+
address@hidden @code{storage} (predeterminado: @code{'("malloc,128m")})
+List of storage backends that will be available in VCL.
+
address@hidden @code{parameters} (predeterminados: @code{'()})
+List of run-time parameters in the form @code{'(("parameter" . "value"))}.
+
address@hidden @code{extra-options} (predeterminadas: @code{'()})
+Additional arguments to pass to the @command{varnishd} process.
+
address@hidden table
address@hidden deftp
+
address@hidden FastCGI
address@hidden fastcgi
address@hidden fcgiwrap
+FastCGI is an interface between the front-end and the back-end of a web
+service. It is a somewhat legacy facility; new web services should
+generally just talk HTTP between the front-end and the back-end. However
+there are a number of back-end services such as PHP or the optimized HTTP
+Git repository access that use FastCGI, so we have support for it in Guix.
+
+To use FastCGI, you configure the front-end web server (e.g., nginx) to
+dispatch some subset of its requests to the fastcgi backend, which listens
+on a local TCP or UNIX socket. There is an intermediary @code{fcgiwrap}
+program that sits between the actual backend process and the web server.
+The front-end indicates which backend program to run, passing that
+information to the @code{fcgiwrap} process.
+
address@hidden {Variable Scheme} fcgiwrap-service-type
+A service type for the @code{fcgiwrap} FastCGI proxy.
address@hidden defvr
+
address@hidden {Tipo de datos} fcgiwrap-configuration
+Data type representing the configuration of the @code{fcgiwrap} service.
+This type has the following parameters:
address@hidden @asis
address@hidden @code{package} (predeterminado: @code{fcgiwrap})
+El paquete fcgiwrap usado.
+
address@hidden @code{socket} (predeterminado: @code{tcp:127.0.0.1:9000})
+The socket on which the @code{fcgiwrap} process should listen, as a string.
+Valid @var{socket} values include @code{unix:@var{/path/to/unix/socket}},
address@hidden:@var{dot.ted.qu.ad}:@var{port}} and
address@hidden:address@hidden:port}.
+
address@hidden @code{user} (predeterminado: @code{fcgiwrap})
address@hidden @code{group} (predeterminado: @code{fcgiwrap})
+The user and group names, as strings, under which to run the @code{fcgiwrap}
+process. The @code{fastcgi} service will ensure that if the user asks for
+the specific user or group names @code{fcgiwrap} that the corresponding user
+and/or group is present on the system.
+
+It is possible to configure a FastCGI-backed web service to pass HTTP
+authentication information from the front-end to the back-end, and to allow
address@hidden to run the back-end process as a corresponding local user.
+To enable this capability on the back-end., run @code{fcgiwrap} as the
address@hidden user and group. Note that this capability also has to be
+configured on the front-end as well.
address@hidden table
address@hidden deftp
+
address@hidden php-fpm
+PHP-FPM (FastCGI Process Manager) is an alternative PHP FastCGI
+implementation with some additional features useful for sites of any size.
+
+These features include:
address@hidden @bullet
address@hidden Adaptive process spawning
address@hidden Basic statistics (similar to Apache's mod_status)
address@hidden Advanced process management with graceful stop/start
address@hidden Ability to start workers with different
uid/gid/chroot/environment
+and different php.ini (replaces safe_mode)
address@hidden Stdout & stderr logging
address@hidden Emergency restart in case of accidental opcode cache destruction
address@hidden Accelerated upload support
address@hidden Support for a "slowlog"
address@hidden Enhancements to FastCGI, such as fastcgi_finish_request() -
+a special function to finish request & flush all data while continuing to do
+something time-consuming (video converting, stats processing, etc.)
address@hidden itemize
+...@: and much more.
+
address@hidden {Variable Scheme} php-fpm-service-type
+Un tipo de servicio para @code{php-fpm}.
address@hidden defvr
+
address@hidden {Tipo de datos} php-fpm-configuration
+Tipo de datos para la configuración del servicio php-fpm.
address@hidden @asis
address@hidden @code{php} (predeterminado: @code{php})
+El paquete php usado.
address@hidden @code{socket} (predeterminado: @code{(string-append
"/var/run/php" (version-major (package-version php)) "-fpm.sock")})
+La dirección desde la que FastCGI acepta peticiones. Las sintaxis válidas
+son:
address@hidden @asis
address@hidden @code{"dir.ecc.ión.ip:puerto"}
+Escucha con un socket TCP en la dirección especificada en un puerto
+específico.
address@hidden @code{"puerto"}
+Escucha en un socket TCP en todas las direcciones sobre un puerto
+específico.
address@hidden @code{"/ruta/a/socket/unix"}
+Escucha en un socket Unix.
address@hidden table
+
address@hidden @code{user} (predeterminada: @code{php-fpm})
+User who will own the php worker processes.
address@hidden @code{group} (predeterminado: @code{php-fpm})
+Group of the worker processes.
address@hidden @code{socket-user} (predeterminado: @code{php-fpm})
+User who can speak to the php-fpm socket.
address@hidden @code{socket-group} (predeterminado: @code{php-fpm})
+Group that can speak to the php-fpm socket.
address@hidden @code{pid-file} (predeterminado: @code{(string-append
"/var/run/php" (version-major (package-version php)) "-fpm.pid")})
+The process id of the php-fpm process is written to this file once the
+service has started.
address@hidden @code{log-file} (predeterminado: @code{(string-append
"/var/log/php" (version-major (package-version php)) "-fpm.log")})
+Log for the php-fpm master process.
address@hidden @code{process-manager} (predeterminado:
@code{(php-fpm-dynamic-process-manager-configuration)})
+Detailed settings for the php-fpm process manager. Must be either:
address@hidden @asis
address@hidden @code{<php-fpm-dynamic-process-manager-configuration>}
address@hidden @code{<php-fpm-static-process-manager-configuration>}
address@hidden @code{<php-fpm-on-demand-process-manager-configuration>}
address@hidden table
address@hidden @code{display-errors} (predeterminado @code{#f})
+Determines whether php errors and warning should be sent to clients and
+displayed in their browsers. This is useful for local php development, but
+a security risk for public sites, as error messages can reveal passwords and
+personal data.
address@hidden @code{timezone} (default @code{#f})
+Specifies @code{php_admin_value[date.timezone]} parameter.
address@hidden @code{workers-logfile} (predeterminado @code{(string-append
"/var/log/php" (version-major (package-version php)) "-fpm.www.log")})
+This file will log the @code{stderr} outputs of php worker processes. Can
+be set to @code{#f} to disable logging.
address@hidden @code{file} (predeterminado @code{#f})
+An optional override of the whole configuration. You can use the
address@hidden function or an absolute filepath for it.
address@hidden table
address@hidden deftp
+
address@hidden {Tipo de datos} php-fpm-dynamic-process-manager-configuration
+Data Type for the @code{dynamic} php-fpm process manager. With the
address@hidden process manager, spare worker processes are kept around based
+on it's configured limits.
address@hidden @asis
address@hidden @code{max-children} (predeterminados: @code{5})
+Maximum of worker processes.
address@hidden @code{start-servers} (predeterminados: @code{2})
+How many worker processes should be started on start-up.
address@hidden @code{min-spare-servers} (predeterminado: @code{1})
+How many spare worker processes should be kept around at minimum.
address@hidden @code{max-spare-servers} (predeterminados: @code{3})
+How many spare worker processes should be kept around at maximum.
address@hidden table
address@hidden deftp
+
address@hidden {Tipo de datos} php-fpm-static-process-manager-configuration
+Data Type for the @code{static} php-fpm process manager. With the
address@hidden process manager, an unchanging number of worker processes are
+created.
address@hidden @asis
address@hidden @code{max-children} (predeterminados: @code{5})
+Maximum of worker processes.
address@hidden table
address@hidden deftp
+
address@hidden {Tipo de datos} php-fpm-on-demand-process-manager-configuration
+Data Type for the @code{on-demand} php-fpm process manager. With the
address@hidden process manager, worker processes are only created as
+requests arrive.
address@hidden @asis
address@hidden @code{max-children} (predeterminados: @code{5})
+Maximum of worker processes.
address@hidden @code{process-idle-timeout} (predeterminado: @code{10})
+The time in seconds after which a process with no requests is killed.
address@hidden table
address@hidden deftp
+
+
address@hidden {Procedimiento Scheme} nginx-php-fpm-location @
+ [#:nginx-package nginx] @ [socket (string-append "/var/run/php" @
+(version-major (package-version php)) @ "-fpm.sock")] A helper function to
+quickly add php to an @code{nginx-server-configuration}.
address@hidden deffn
+
+A simple services setup for nginx with php can look like this:
address@hidden
+(services (cons* (service dhcp-client-service-type)
+ (service php-fpm-service-type)
+ (service nginx-service-type
+ (nginx-server-configuration
+ (server-name '("example.com"))
+ (root "/srv/http/")
+ (locations
+ (list (nginx-php-location)))
+ (listen '("80"))
+ (ssl-certificate #f)
+ (ssl-certificate-key #f)))
+ %base-services))
address@hidden example
+
address@hidden cat-avatar-generator
+The cat avatar generator is a simple service to demonstrate the use of
+php-fpm in @code{Nginx}. It is used to generate cat avatar from a seed, for
+instance the hash of a user's email address.
+
address@hidden {Scheme Procedure} cat-avatar-generator-service @
+ [#:cache-dir "/var/cache/cat-avatar-generator"] @ [#:package
+cat-avatar-generator] @ [#:configuration (nginx-server-configuration)]
+Returns an nginx-server-configuration that inherits @code{configuration}.
+It extends the nginx configuration to add a server block that serves
address@hidden, a version of cat-avatar-generator. During execution,
+cat-avatar-generator will be able to use @code{cache-dir} as its cache
+directory.
address@hidden deffn
+
+A simple setup for cat-avatar-generator can look like this:
address@hidden
+(services (cons* (cat-avatar-generator-service
+ #:configuration
+ (nginx-server-configuration
+ (server-name '("example.com"))))
+ ...
+ %base-services))
address@hidden example
+
address@hidden Hpcguix-web
+
address@hidden hpcguix-web
+The @uref{hpcguix-web, https://github.com/UMCUGenetics/hpcguix-web/} program
+is a customizable web interface to browse Guix packages, initially designed
+for users of high-performance computing (HPC) clusters.
+
address@hidden {Variable Scheme} hpcguix-web-service-type
+El tipo de servicio para @code{hpcguix-web}.
address@hidden defvr
+
address@hidden {Tipo de datos} hpcguix-web-configuration
+El tipo de datos para la configuración del servicio hpcguix-web.
+
address@hidden @asis
address@hidden @code{specs}
+A gexp (@pxref{Expresiones-G}) specifying the hpcguix-web service
+configuration. The main items available in this spec are:
+
address@hidden @asis
address@hidden @code{title-prefix} (predeterminado: @code{"hpcguix | "})
+El prefijo del título de la página.
+
address@hidden @code{guix-command} (predeterminada: @code{"guix"})
+La orden @command{guix}.
+
address@hidden @code{package-filter-proc} (predeterminado: @code{(const #t)})
+A procedure specifying how to filter packages that are displayed.
+
address@hidden @code{package-page-extension-proc} (predeterminado: @code{(const
'())})
+Extension package for @code{hpcguix-web}.
+
address@hidden @code{menu} (predeterminadas: @code{'()})
+Entradas adicionales en el menú de la página.
+
address@hidden @code{channels} (predeterminados: @code{%default-channels})
+List of channels from which the package list is built (@pxref{Canales}).
+
address@hidden @code{package-list-expiration} (predeterminado: @code{(* 12
3600)})
+The expiration time, in seconds, after which the package list is rebuilt
+from the latest instances of the given channels.
address@hidden table
+
+See the hpcguix-web repository for a
address@hidden://github.com/UMCUGenetics/hpcguix-web/blob/master/hpcweb-configuration.scm,
+complete example}.
+
address@hidden @code{package} (predeterminado: @code{hpcguix-web})
+The hpcguix-web package to use.
address@hidden table
address@hidden deftp
+
+A typical hpcguix-web service declaration looks like this:
+
address@hidden
+(service hpcguix-web-service-type
+ (hpcguix-web-configuration
+ (specs
+ #~(define site-config
+ (hpcweb-configuration
+ (title-prefix "Guix-HPC - ")
+ (menu '(("/about" "ABOUT"))))))))
address@hidden example
+
address@hidden Nota
+The hpcguix-web service periodically updates the package list it publishes
+by pulling channels from Git. To that end, it needs to access X.509
+certificates so that it can authenticate Git servers when communicating over
+HTTPS, and it assumes that @file{/etc/ssl/certs} contains those
+certificates.
+
+Thus, make sure to add @code{nss-certs} or another certificate package to
+the @code{packages} field of your configuration. @ref{Certificados X.509},
+for more information on X.509 certificates.
address@hidden quotation
+
address@hidden Servicios de certificados
address@hidden Servicios de certificados
+
address@hidden Web
address@hidden HTTP, HTTPS
address@hidden Let's Encrypt
address@hidden certificados TLS
+The @code{(gnu services certbot)} module provides a service to automatically
+obtain a valid TLS certificate from the Let's Encrypt certificate
+authority. These certificates can then be used to serve content securely
+over HTTPS or other TLS-based protocols, with the knowledge that the client
+will be able to verify the server's authenticity.
+
address@hidden://letsencrypt.org/, Let's Encrypt} provides the @code{certbot}
+tool to automate the certification process. This tool first securely
+generates a key on the server. It then makes a request to the Let's Encrypt
+certificate authority (CA) to sign the key. The CA checks that the request
+originates from the host in question by using a challenge-response protocol,
+requiring the server to provide its response over HTTP. If that protocol
+completes successfully, the CA signs the key, resulting in a certificate.
+That certificate is valid for a limited period of time, and therefore to
+continue to provide TLS services, the server needs to periodically ask the
+CA to renew its signature.
+
+The certbot service automates this process: the initial key generation, the
+initial certification request to the Let's Encrypt service, the web server
+challenge/response integration, writing the certificate to disk, the
+automated periodic renewals, and the deployment tasks associated with the
+renewal (e.g.@: reloading services, copying keys with different
+permissions).
+
+Certbot is run twice a day, at a random minute within the hour. It won't do
+anything until your certificates are due for renewal or revoked, but running
+it regularly would give your service a chance of staying online in case a
+Let's Encrypt-initiated revocation happened for some reason.
+
+By using this service, you agree to the ACME Subscriber Agreement, which can
+be found there: @url{https://acme-v01.api.letsencrypt.org/directory}.
+
address@hidden {Variable Scheme} certbot-service-type
+A service type for the @code{certbot} Let's Encrypt client. Its value must
+be a @code{certbot-configuration} record as in this example:
+
address@hidden
+(define %nginx-deploy-hook
+ (program-file
+ "nginx-deploy-hook"
+ #~(let ((pid (call-with-input-file "/var/run/nginx/pid" read)))
+ (kill pid SIGHUP))))
+
+(service certbot-service-type
+ (certbot-configuration
+ (email "foo@@example.net")
+ (certificates
+ (list
+ (certificate-configuration
+ (domains '("example.net" "www.example.net"))
+ (deploy-hook %nginx-deploy-hook))
+ (certificate-configuration
+ (domains '("bar.example.net")))))))
address@hidden example
+
+See below for details about @code{certbot-configuration}.
address@hidden defvr
+
address@hidden {Tipo de datos} certbot-configuration
+Data type representing the configuration of the @code{certbot} service.
+This type has the following parameters:
+
address@hidden @asis
address@hidden @code{package} (predeterminado: @code{certbot})
+El paquete certbot usado.
+
address@hidden @code{webroot} (predeterminado: @code{/var/www})
+The directory from which to serve the Let's Encrypt challenge/response
+files.
+
address@hidden @code{certificates} (predeterminados: @code{()})
+A list of @code{certificates-configuration}s for which to generate
+certificates and request signatures. Each certificate has a @code{name} and
+several @code{domains}.
+
address@hidden @code{email}
+Mandatory email used for registration, recovery contact, and important
+account notifications.
+
address@hidden @code{rsa-key-size} (predeterminado: @code{2048})
+Tamaño de la clave RSA.
+
address@hidden @code{default-location} (predeterminada: @i{vea a continuación})
+The default @code{nginx-location-configuration}. Because @code{certbot}
+needs to be able to serve challenges and responses, it needs to be able to
+run a web server. It does so by extending the @code{nginx} web service with
+an @code{nginx-server-configuration} listening on the @var{domains} on port
+80, and which has a @code{nginx-location-configuration} for the
address@hidden/.well-known/} URI path subspace used by Let's Encrypt.
@xref{Servicios Web}, for more on these nginx configuration data types.
+
+Requests to other URL paths will be matched by the @code{default-location},
+which if present is added to all @code{nginx-server-configuration}s.
+
+By default, the @code{default-location} will issue a redirect from
address@hidden://@var{domain}/...} to @code{https://@var{domain}/...}, leaving
+you to define what to serve on your site via @code{https}.
+
+Pass @code{#f} to not issue a default location.
address@hidden table
address@hidden deftp
+
address@hidden {Tipo de datos} certificate-configuration
+Data type representing the configuration of a certificate. This type has
+the following parameters:
+
address@hidden @asis
address@hidden @code{name} (predeterminado: @i{vea a continuación})
+This name is used by Certbot for housekeeping and in file paths; it doesn't
+affect the content of the certificate itself. To see certificate names, run
address@hidden certificates}.
+
+Its default is the first provided domain.
+
address@hidden @code{domains} (predeterminado: @code{()})
+The first domain provided will be the subject CN of the certificate, and all
+domains will be Subject Alternative Names on the certificate.
+
address@hidden @code{deploy-hook} (predeterminado: @code{#f})
+Command to be run in a shell once for each successfully issued certificate.
+For this command, the shell variable @code{$RENEWED_LINEAGE} will point to
+the config live subdirectory (for example,
address@hidden"/etc/letsencrypt/live/example.com"}) containing the new
certificates
+and keys; the shell variable @code{$RENEWED_DOMAINS} will contain a
+space-delimited list of renewed certificate domains (for example,
address@hidden"example.com www.example.com"}.
+
address@hidden table
address@hidden deftp
+
+For each @code{certificate-configuration}, the certificate is saved to
address@hidden/etc/letsencrypt/live/@var{name}/fullchain.pem} and the key is
saved
+to @code{/etc/letsencrypt/live/@var{name}/privkey.pem}.
address@hidden Servicios DNS
address@hidden Servicios DNS
address@hidden DNS (domain name system)
address@hidden domain name system (DNS)
+
+The @code{(gnu services dns)} module provides services related to the
address@hidden name system} (DNS). It provides a server service for hosting an
address@hidden DNS server for multiple zones, slave or master. This
+service uses @uref{https://www.knot-dns.cz/, Knot DNS}. And also a caching
+and forwarding DNS server for the LAN, which uses
address@hidden://www.thekelleys.org.uk/dnsmasq/doc.html, dnsmasq}.
+
address@hidden Servicio Knot
+
+An example configuration of an authoritative server for two zones, one
+master and one slave, is:
+
address@hidden
+(define-zone-entries example.org.zone
+;; Name TTL Class Type Data
+ ("@@" "" "IN" "A" "127.0.0.1")
+ ("@@" "" "IN" "NS" "ns")
+ ("ns" "" "IN" "A" "127.0.0.1"))
+
+(define master-zone
+ (knot-zone-configuration
+ (domain "example.org")
+ (zone (zone-file
+ (origin "example.org")
+ (entries example.org.zone)))))
+
+(define slave-zone
+ (knot-zone-configuration
+ (domain "plop.org")
+ (dnssec-policy "default")
+ (master (list "plop-master"))))
+
+(define plop-master
+ (knot-remote-configuration
+ (id "plop-master")
+ (address (list "208.76.58.171"))))
+
+(operating-system
+ ;; ...
+ (services (cons* (service knot-service-type
+ (knot-configuration
+ (remotes (list plop-master))
+ (zones (list master-zone slave-zone))))
+ ;; ...
+ %base-services)))
address@hidden lisp
+
address@hidden {Variable Scheme} knot-service-type
+This is the type for the Knot DNS server.
+
+Knot DNS is an authoritative DNS server, meaning that it can serve multiple
+zones, that is to say domain names you would buy from a registrar. This
+server is not a resolver, meaning that it can only resolve names for which
+it is authoritative. This server can be configured to serve zones as a
+master server or a slave server as a per-zone basis. Slave zones will get
+their data from masters, and will serve it as an authoritative server. From
+the point of view of a resolver, there is no difference between master and
+slave.
+
+The following data types are used to configure the Knot DNS server:
address@hidden deffn
+
address@hidden {Tipo de datos} knot-key-configuration
+Data type representing a key. This type has the following parameters:
+
address@hidden @asis
address@hidden @code{id} (predeterminado: @code{""})
+An identifier for other configuration fields to refer to this key. IDs must
+be unique and must not be empty.
+
address@hidden @code{algorithm} (predeterminado: @code{#f})
+The algorithm to use. Choose between @code{#f}, @code{'hmac-md5},
address@hidden'hmac-sha1}, @code{'hmac-sha224}, @code{'hmac-sha256},
address@hidden'hmac-sha384} and @code{'hmac-sha512}.
+
address@hidden @code{secret} (predeterminado: @code{""})
+The secret key itself.
+
address@hidden table
address@hidden deftp
+
address@hidden {Tipo de datos} knot-acl-configuration
+Data type representing an Access Control List (ACL) configuration. This
+type has the following parameters:
+
address@hidden @asis
address@hidden @code{id} (predeterminado: @code{""})
+An identifier for ether configuration fields to refer to this key. IDs must
+be unique and must not be empty.
+
address@hidden @code{address} (predeterminada: @code{'()})
+An ordered list of IP addresses, network subnets, or network ranges
+represented with strings. The query must match one of them. Empty value
+means that address match is not required.
+
address@hidden @code{key} (predeterminada: @code{'()})
+An ordered list of references to keys represented with strings. The string
+must match a key ID defined in a @code{knot-key-configuration}. No key
+means that a key is not require to match that ACL.
+
address@hidden @code{action} (predeterminada: @code{'()})
+An ordered list of actions that are permitted or forbidden by this ACL.
+Possible values are lists of zero or more elements from @code{'transfer},
address@hidden'notify} and @code{'update}.
+
address@hidden @code{deny?} (predeterminado: @code{#f})
+When true, the ACL defines restrictions. Listed actions are forbidden.
+When false, listed actions are allowed.
+
address@hidden table
address@hidden deftp
+
address@hidden {Tipo de datos} zone-entry
+Data type represnting a record entry in a zone file. This type has the
+following parameters:
+
address@hidden @asis
address@hidden @code{name} (predeterminado: @code{"@@"})
+The name of the record. @code{"@@"} refers to the origin of the zone.
+Names are relative to the origin of the zone. For example, in the
address@hidden zone, @code{"ns.example.org"} actually refers to
address@hidden Names ending with a dot are absolute,
+which means that @code{"ns.example.org."} refers to @code{ns.example.org}.
+
address@hidden @code{ttl} (predeterminado: @code{""})
+The Time-To-Live (TTL) of this record. If not set, the default TTL is used.
+
address@hidden @code{class} (predeterminada: @code{"IN"})
+The class of the record. Knot currently supports only @code{"IN"} and
+partially @code{"CH"}.
+
address@hidden @code{type} (predeterminado: @code{"A"})
+The type of the record. Common types include A (IPv4 address), AAAA (IPv6
+address), NS (Name Server) and MX (Mail eXchange). Many other types are
+defined.
+
address@hidden @code{data} (predeterminados: @code{""})
+The data contained in the record. For instance an IP address associated
+with an A record, or a domain name associated with an NS record. Remember
+that domain names are relative to the origin unless they end with a dot.
+
address@hidden table
address@hidden deftp
+
address@hidden {Tipo de datos} zone-file
+Data type representing the content of a zone file. This type has the
+following parameters:
+
address@hidden @asis
address@hidden @code{entries} (predeterminadas: @code{'()})
+The list of entries. The SOA record is taken care of, so you don't need to
+put it in the list of entries. This list should probably contain an entry
+for your primary authoritative DNS server. Other than using a list of
+entries directly, you can use @code{define-zone-entries} to define a object
+containing the list of entries more easily, that you can later pass to the
address@hidden field of the @code{zone-file}.
+
address@hidden @code{origin} (predeterminado: @code{""})
+The name of your zone. This parameter cannot be empty.
+
address@hidden @code{ns} (predeterminado: @code{"ns"})
+The domain of your primary authoritative DNS server. The name is relative
+to the origin, unless it ends with a dot. It is mandatory that this primary
+DNS server corresponds to an NS record in the zone and that it is associated
+to an IP address in the list of entries.
+
address@hidden @code{mail} (predeterminado: @code{"hostmaster"})
+An email address people can contact you at, as the owner of the zone. This
+is translated as @code{<mail>@@<origin>}.
+
address@hidden @code{serial} (predeterminado: @code{1})
+The serial number of the zone. As this is used to keep track of changes by
+both slaves and resolvers, it is mandatory that it @emph{never} decreases.
+Always increment it when you make a change in your zone.
+
address@hidden @code{refresh} (predeterminado: @code{(* 2 24 3600)})
+The frequency at which slaves will do a zone transfer. This value is a
+number of seconds. It can be computed by multiplications or with
address@hidden(string->duration)}.
+
address@hidden @code{retry} (predeterminado: @code{(* 15 60)})
+The period after which a slave will retry to contact its master when it
+fails to do so a first time.
+
address@hidden @code{expiry} (predeterminado: @code{(* 14 24 3600)})
+Default TTL of records. Existing records are considered correct for at most
+this amount of time. After this period, resolvers will invalidate their
+cache and check again that it still exists.
+
address@hidden @code{nx} (predeterminado: @code{3600})
+Default TTL of inexistant records. This delay is usually short because you
+want your new domains to reach everyone quickly.
+
address@hidden table
address@hidden deftp
+
address@hidden {Tipo de datos} knot-remote-configuration
+Data type representing a remote configuration. This type has the following
+parameters:
+
address@hidden @asis
address@hidden @code{id} (predeterminado: @code{""})
+An identifier for other configuration fields to refer to this remote. IDs
+must be unique and must not be empty.
+
address@hidden @code{address} (predeterminada: @code{'()})
+An ordered list of destination IP addresses. Addresses are tried in
+sequence. An optional port can be given with the @@ separator. For
+instance: @code{(list "1.2.3.4" "2.3.4.5@@53")}. Default port is 53.
+
address@hidden @code{via} (predeterminada: @code{'()})
+An ordered list of source IP addresses. An empty list will have Knot choose
+an appropriate source IP. An optional port can be given with the @@
+separator. The default is to choose at random.
+
address@hidden @code{key} (predeterminada: @code{#f})
+A reference to a key, that is a string containing the identifier of a key
+defined in a @code{knot-key-configuration} field.
+
address@hidden table
address@hidden deftp
+
address@hidden {Tipo de datos} knot-keystore-configuration
+Data type representing a keystore to hold dnssec keys. This type has the
+following parameters:
+
address@hidden @asis
address@hidden @code{id} (predeterminado: @code{""})
+The id of the keystore. It must not be empty.
+
address@hidden @code{backend} (predeterminado: @code{'pem})
+El motor en el que se almacenan las claves. Puede ser @code{'pem} o
address@hidden'pkcs11}.
+
address@hidden @code{config} (predeterminada: @code{"/var/lib/knot/keys/keys"})
+The configuration string of the backend. An example for the PKCS#11 is:
address@hidden"pkcs11:token=knot;pin-value=1234
+/gnu/store/.../lib/pkcs11/libsofthsm2.so"}. For the pem backend, the string
+reprensents a path in the file system.
+
address@hidden table
address@hidden deftp
+
address@hidden {Tipo de datos} knot-policy-configuration
+Data type representing a dnssec policy. Knot DNS is able to automatically
+sign your zones. It can either generate and manage your keys automatically
+or use keys that you generate.
+
+Dnssec is usually implemented using two keys: a Key Signing Key (KSK) that
+is used to sign the second, and a Zone Signing Key (ZSK) that is used to
+sign the zone. In order to be trusted, the KSK needs to be present in the
+parent zone (usually a top-level domain). If your registrar supports
+dnssec, you will have to send them your KSK's hash so they can add a DS
+record in their zone. This is not automated and need to be done each time
+you change your KSK.
+
+The policy also defines the lifetime of keys. Usually, ZSK can be changed
+easily and use weaker cryptographic functions (they use lower parameters) in
+order to sign records quickly, so they are changed often. The KSK however
+requires manual interaction with the registrar, so they are changed less
+often and use stronger parameters because they sign only one record.
+
+Este tipo tiene los siguientes parámetros:
+
address@hidden @asis
address@hidden @code{id} (predeterminado: @code{""})
+The id of the policy. It must not be empty.
+
address@hidden @code{keystore} (predeterminado: @code{"default"})
+A reference to a keystore, that is a string containing the identifier of a
+keystore defined in a @code{knot-keystore-configuration} field. The
address@hidden"default"} identifier means the default keystore (a kasp database
that
+was setup by this service).
+
address@hidden @code{manual?} (predeterminado: @code{#f})
+Whether the key management is manual or automatic.
+
address@hidden @code{single-type-signing?} (predeterminado: @code{#f})
+When @code{#t}, use the Single-Type Signing Scheme.
+
address@hidden @code{algorithm} (predeterminado: @code{"ecdsap256sha256"})
+An algorithm of signing keys and issued signatures.
+
address@hidden @code{ksk-size} (predeterminado: @code{256})
+The length of the KSK. Note that this value is correct for the default
+algorithm, but would be unsecure for other algorithms.
+
address@hidden @code{zsk-size} (predeterminado: @code{256})
+The length of the ZSK. Note that this value is correct for the default
+algorithm, but would be unsecure for other algorithms.
+
address@hidden @code{dnskey-ttl} (predeterminado: @code{'default})
+The TTL value for DNSKEY records added into zone apex. The special
address@hidden'default} value means same as the zone SOA TTL.
+
address@hidden @code{zsk-lifetime} (predeterminado: @code{(* 30 24 3600)})
+The period between ZSK publication and the next rollover initiation.
+
address@hidden @code{propagation-delay} (predeterminado: @code{(* 24 3600)})
+An extra delay added for each key rollover step. This value should be high
+enough to cover propagation of data from the master server to all slaves.
+
address@hidden @code{rrsig-lifetime} (predeterminado: @code{(* 14 24 3600)})
+A validity period of newly issued signatures.
+
address@hidden @code{rrsig-refresh} (predeterminado: @code{(* 7 24 3600)})
+A period how long before a signature expiration the signature will be
+refreshed.
+
address@hidden @code{nsec3?} (predeterminado: @code{#f})
+When @code{#t}, NSEC3 will be used instead of NSEC.
+
address@hidden @code{nsec3-iterations} (predeterminado: @code{5})
+The number of additional times the hashing is performed.
+
address@hidden @code{nsec3-salt-length} (predeterminado: @code{8})
+The length of a salt field in octets, which is appended to the original
+owner name before hashing.
+
address@hidden @code{nsec3-salt-lifetime} (predeterminado: @code{(* 30 24
3600)})
+The validity period of newly issued salt field.
+
address@hidden table
address@hidden deftp
+
address@hidden {Tipo de datos} knot-zone-configuration
+Data type representing a zone served by Knot. This type has the following
+parameters:
+
address@hidden @asis
address@hidden @code{domain} (predeterminado: @code{""})
+The domain served by this configuration. It must not be empty.
+
address@hidden @code{file} (predeterminado: @code{""})
+The file where this zone is saved. This parameter is ignored by master
+zones. Empty means default location that depends on the domain name.
+
address@hidden @code{zone} (predeterminado: @code{(zone-file)})
+The content of the zone file. This parameter is ignored by slave zones. It
+must contain a zone-file record.
+
address@hidden @code{master} (predeterminado: @code{'()})
+A list of master remotes. When empty, this zone is a master. When set,
+this zone is a slave. This is a list of remotes identifiers.
+
address@hidden @code{ddns-master} (predeterminado: @code{#f})
+The main master. When empty, it defaults to the first master in the list of
+masters.
+
address@hidden @code{notify} (predeterminado: @code{'()})
+A list of slave remote identifiers.
+
address@hidden @code{acl} (predeterminado: @code{'()})
+A list of acl identifiers.
+
address@hidden @code{semantic-checks?} (predeterminado: @code{#f})
+When set, this adds more semantic checks to the zone.
+
address@hidden @code{disable-any?} (predeterminado: @code{#f})
+When set, this forbids queries of the ANY type.
+
address@hidden @code{zonefile-sync} (predeterminado: @code{0})
+The delay between a modification in memory and on disk. 0 means immediate
+synchronization.
+
address@hidden @code{serial-policy} (predeterminado: @code{'increment})
+A policy between @code{'increment} and @code{'unixtime}.
+
address@hidden table
address@hidden deftp
+
address@hidden {Tipo de datos} knot-configuration
+Data type representing the Knot configuration. This type has the following
+parameters:
+
address@hidden @asis
address@hidden @code{knot} (predeterminado: @code{knot})
+El paquete Knot.
+
address@hidden @code{run-directory} (predeterminado: @code{"/var/run/knot"})
+The run directory. This directory will be used for pid file and sockets.
+
address@hidden @code{listen-v4} (predeterminada: @code{"0.0.0.0"})
+La dirección IP en la que escuchar.
+
address@hidden @code{listen-v6} (predeterminada: @code{"::"})
+La dirección IP en la que escuchar.
+
address@hidden @code{listen-port} (predeterminado: @code{53})
+El puerto en el que escuchar.
+
address@hidden @code{keys} (predeterminada: @code{'()})
+The list of knot-key-configuration used by this configuration.
+
address@hidden @code{acls} (predeterminado: @code{'()})
+The list of knot-acl-configuration used by this configuration.
+
address@hidden @code{remotes} (predeterminada: @code{'()})
+The list of knot-remote-configuration used by this configuration.
+
address@hidden @code{zones} (predeterminada: @code{'()})
+The list of knot-zone-configuration used by this configuration.
+
address@hidden table
address@hidden deftp
+
address@hidden Servicio Dnsmasq
+
address@hidden {Variable Scheme} dnsmasq-service-type
+This is the type of the dnsmasq service, whose value should be an
address@hidden object as in this example:
+
address@hidden
+(service dnsmasq-service-type
+ (dnsmasq-configuration
+ (no-resolv? #t)
+ (servers '("192.168.1.1"))))
address@hidden example
address@hidden deffn
+
address@hidden {Tipo de datos} dnsmasq-configuration
+Data type representing the configuration of dnsmasq.
+
address@hidden @asis
address@hidden @code{package} (predeterminado: @var{dnsmasq})
+Package object of the dnsmasq server.
+
address@hidden @code{no-hosts?} (predeterminado: @code{#f})
+When true, don't read the hostnames in /etc/hosts.
+
address@hidden @code{port} (predeterminado: @code{53})
+The port to listen on. Setting this to zero completely disables DNS
+responses, leaving only DHCP and/or TFTP functions.
+
address@hidden @code{local-service?} (predeterminado: @code{#t})
+Accept DNS queries only from hosts whose address is on a local subnet, ie a
+subnet for which an interface exists on the server.
+
address@hidden @code{listen-addresses} (predeterminadas: @code{'()})
+Escucha en las direcciones IP proporcionadas.
+
address@hidden @code{resolv-file} (predeterminado: @code{"/etc/resolv.conf"})
+The file to read the IP address of the upstream nameservers from.
+
address@hidden @code{no-resolv?} (predeterminado: @code{#f})
+When true, don't read @var{resolv-file}.
+
address@hidden @code{servers} (predeterminados: @code{'()})
+Specify IP address of upstream servers directly.
+
address@hidden @code{cache-size} (predeterminado: @code{150})
+Set the size of dnsmasq's cache. Setting the cache size to zero disables
+caching.
+
address@hidden @code{negative-cache?} (predeterminado: @code{#t})
+When false, disable negative caching.
+
address@hidden table
address@hidden deftp
+
address@hidden Servicio ddclient
+
address@hidden ddclient
+The ddclient service described below runs the ddclient daemon, which takes
+care of automatically updating DNS entries for service providers such as
address@hidden://dyn.com/dns/, Dyn}.
+
+The following example show instantiates the service with its default
+configuration:
+
address@hidden
+(service ddclient-service-type)
address@hidden example
+
+Note that ddclient needs to access credentials that are stored in a
address@hidden file}, by default @file{/etc/ddclient/secrets} (see
address@hidden below.) You are expected to create this file manually,
+in an ``out-of-band'' fashion (you @emph{could} make this file part of the
+service configuration, for instance by using @code{plain-file}, but it will
+be world-readable @i{via} @file{/gnu/store}.) See the examples in the
address@hidden/ddclient} directory of the @code{ddclient} package.
+
address@hidden %start of fragment
+
+Los campos disponibles de @code{ddclient-configuration} son:
+
address@hidden address@hidden parameter} package ddclient
+El paquete ddclient.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} integer daemon
+The period after which ddclient will retry to check IP and domain name.
+
+Defaults to @samp{300}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean syslog
+Use syslog for the output.
+
+Defaults to @samp{#t}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string mail
+Mail to user.
+
+Defaults to @samp{"root"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string mail-failure
+Mail failed update to user.
+
+Defaults to @samp{"root"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string pid
+The ddclient PID file.
+
+Defaults to @samp{"/var/run/ddclient/ddclient.pid"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean ssl
+Enable SSL support.
+
+Defaults to @samp{#t}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string user
+Specifies the user name or ID that is used when running ddclient program.
+
+Defaults to @samp{"ddclient"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string group
+Group of the user who will run the ddclient program.
+
+Defaults to @samp{"ddclient"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string secret-file
+Secret file which will be appended to @file{ddclient.conf} file. This file
+contains credentials for use by ddclient. You are expected to create it
+manually.
+
+Defaults to @samp{"/etc/ddclient/secrets.conf"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} list extra-options
+Extra options will be appended to @file{ddclient.conf} file.
+
+Defaults to @samp{()}.
+
address@hidden deftypevr
+
+
address@hidden %end of fragment
+
+
address@hidden Servicios VPN
address@hidden Servicios VPN
address@hidden VPN (red virtual privada)
address@hidden red virtual privada (VPN)
+
+The @code{(gnu services vpn)} module provides services related to
address@hidden private networks} (VPNs). It provides a @emph{client} service
+for your machine to connect to a VPN, and a @emph{servire} service for your
+machine to host a VPN. Both services use @uref{https://openvpn.net/,
+OpenVPN}.
+
address@hidden {Procedimiento Scheme} openvpn-client-service @
+ [#:config (openvpn-client-configuration)]
+
+Devuelve un servicio que ejecuta @command{openvpn}, un daemon VPN, como
+cliente.
address@hidden deffn
+
address@hidden {Procedimiento Scheme} openvpn-server-service @
+ [#:config (openvpn-server-configuration)]
+
+Devuelve un servicio que ejecuta @command{openvpn}, un daemon VPN, como
+servidor.
+
+Pueden ejecutarse simultáneamente.
address@hidden deffn
+
address@hidden %automatically generated documentation
+
+Los campos disponibles de @code{openvpn-client-configuration} son:
+
address@hidden address@hidden parameter} package openvpn
+El paquete OpenVPN.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string pid-file
+The OpenVPN pid file.
+
+Defaults to @samp{"/var/run/openvpn/openvpn.pid"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} proto proto
+The protocol (UDP or TCP) used to open a channel between clients and
+servers.
+
+Defaults to @samp{udp}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} dev dev
+The device type used to represent the VPN connection.
+
+Defaults to @samp{tun}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string ca
+The certificate authority to check connections against.
+
+Defaults to @samp{"/etc/openvpn/ca.crt"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string cert
+The certificate of the machine the daemon is running on. It should be
+signed by the authority given in @code{ca}.
+
+Defaults to @samp{"/etc/openvpn/client.crt"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string key
+The key of the machine the daemon is running on. It must be the key whose
+certificate is @code{cert}.
+
+Defaults to @samp{"/etc/openvpn/client.key"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean comp-lzo?
+Whether to use the lzo compression algorithm.
+
+Defaults to @samp{#t}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean persist-key?
+Don't re-read key files across SIGUSR1 or --ping-restart.
+
+Defaults to @samp{#t}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean persist-tun?
+Don't close and reopen TUN/TAP device or run up/down scripts across SIGUSR1
+or --ping-restart restarts.
+
+Defaults to @samp{#t}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} number verbosity
+Verbosity level.
+
+Defaults to @samp{3}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} tls-auth-client tls-auth
+Add an additional layer of HMAC authentication on top of the TLS control
+channel to protect against DoS attacks.
+
+El valor predeterminado es @samp{#f}
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} key-usage verify-key-usage?
+Whether to check the server certificate has server usage extension.
+
+Defaults to @samp{#t}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} bind bind?
+Bind to a specific local port number.
+
+El valor predeterminado es @samp{#f}
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} resolv-retry resolv-retry?
+Retry resolving server address.
+
+Defaults to @samp{#t}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} openvpn-remote-list remote
+A list of remote servers to connect to.
+
+Defaults to @samp{()}.
+
+Los campos disponibles de @code{openvpn-remote-configuration} son:
+
address@hidden address@hidden parameter} string name
+Nombre del servidor.
+
+Defaults to @samp{"my-server"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} number port
+Port number the server listens to.
+
+Defaults to @samp{1194}.
+
address@hidden deftypevr
+
address@hidden deftypevr
address@hidden %end of automatic openvpn-client documentation
+
address@hidden %automatically generated documentation
+
+Available @code{openvpn-server-configuration} fields are:
+
address@hidden address@hidden parameter} package openvpn
+El paquete OpenVPN.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string pid-file
+The OpenVPN pid file.
+
+Defaults to @samp{"/var/run/openvpn/openvpn.pid"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} proto proto
+The protocol (UDP or TCP) used to open a channel between clients and
+servers.
+
+Defaults to @samp{udp}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} dev dev
+The device type used to represent the VPN connection.
+
+Defaults to @samp{tun}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string ca
+The certificate authority to check connections against.
+
+Defaults to @samp{"/etc/openvpn/ca.crt"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string cert
+The certificate of the machine the daemon is running on. It should be
+signed by the authority given in @code{ca}.
+
+Defaults to @samp{"/etc/openvpn/client.crt"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string key
+The key of the machine the daemon is running on. It must be the key whose
+certificate is @code{cert}.
+
+Defaults to @samp{"/etc/openvpn/client.key"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean comp-lzo?
+Whether to use the lzo compression algorithm.
+
+Defaults to @samp{#t}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean persist-key?
+Don't re-read key files across SIGUSR1 or --ping-restart.
+
+Defaults to @samp{#t}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean persist-tun?
+Don't close and reopen TUN/TAP device or run up/down scripts across SIGUSR1
+or --ping-restart restarts.
+
+Defaults to @samp{#t}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} number verbosity
+Verbosity level.
+
+Defaults to @samp{3}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} tls-auth-server tls-auth
+Add an additional layer of HMAC authentication on top of the TLS control
+channel to protect against DoS attacks.
+
+El valor predeterminado es @samp{#f}
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} number port
+Specifies the port number on which the server listens.
+
+Defaults to @samp{1194}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} ip-mask server
+An ip and mask specifying the subnet inside the virtual network.
+
+Defaults to @samp{"10.8.0.0 255.255.255.0"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} cidr6 server-ipv6
+A CIDR notation specifying the IPv6 subnet inside the virtual network.
+
+El valor predeterminado es @samp{#f}
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string dh
+The Diffie-Hellman parameters file.
+
+Defaults to @samp{"/etc/openvpn/dh2048.pem"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string ifconfig-pool-persist
+The file that records client IPs.
+
+Defaults to @samp{"/etc/openvpn/ipp.txt"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} gateway redirect-gateway?
+When true, the server will act as a gateway for its clients.
+
+El valor predeterminado es @samp{#f}
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean client-to-client?
+When true, clients are allowed to talk to each other inside the VPN.
+
+El valor predeterminado es @samp{#f}
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} keepalive keepalive
+Causes ping-like messages to be sent back and forth over the link so that
+each side knows when the other side has gone down. @code{keepalive}
+requires a pair. The first element is the period of the ping sending, and
+the second element is the timeout before considering the other side down.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} number max-clients
+The maximum number of clients.
+
+Defaults to @samp{100}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string status
+The status file. This file shows a small report on current connection. It
+is truncated and rewritten every minute.
+
+Defaults to @samp{"/var/run/openvpn/status"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} openvpn-ccd-list client-config-dir
+The list of configuration for some clients.
+
+Defaults to @samp{()}.
+
+Available @code{openvpn-ccd-configuration} fields are:
+
address@hidden address@hidden parameter} string name
+Nombre del cliente.
+
+Defaults to @samp{"client"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} ip-mask iroute
+Client own network
+
+El valor predeterminado es @samp{#f}
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} ip-mask ifconfig-push
+Client VPN IP.
+
+El valor predeterminado es @samp{#f}
+
address@hidden deftypevr
+
address@hidden deftypevr
+
+
address@hidden %end of automatic openvpn-server documentation
+
+
address@hidden Sistema de ficheros en red
address@hidden Sistema de ficheros en red
address@hidden NFS
+
+The @code{(gnu services nfs)} module provides the following services, which
+are most commonly used in relation to mounting or exporting directory trees
+as @dfn{network file systems} (NFS).
+
address@hidden RPC Bind Service
address@hidden rpcbind
+
+The RPC Bind service provides a facility to map program numbers into
+universal addresses. Many NFS related services use this facility. Hence it
+is automatically started when a dependent service starts.
+
address@hidden {Variable Scheme} rpcbind-service-type
+A service type for the RPC portmapper daemon.
address@hidden defvr
+
+
address@hidden {Tipo de datos} rpcbind-configuration
+Data type representing the configuration of the RPC Bind Service. This type
+has the following parameters:
address@hidden @asis
address@hidden @code{rpcbind} (default: @code{rpcbind})
+The rpcbind package to use.
+
address@hidden @code{warm-start?} (default: @code{#t})
+If this parameter is @code{#t}, then the daemon will read a state file on
+startup thus reloading state information saved by a previous instance.
address@hidden table
address@hidden deftp
+
+
address@hidden Pipefs Pseudo File System
address@hidden pipefs
address@hidden rpc_pipefs
+
+The pipefs file system is used to transfer NFS related data between the
+kernel and user space programs.
+
address@hidden {Variable Scheme} pipefs-service-type
+A service type for the pipefs pseudo file system.
address@hidden defvr
+
address@hidden {Tipo de datos} pipefs-configuration
+Data type representing the configuration of the pipefs pseudo file system
+service. This type has the following parameters:
address@hidden @asis
address@hidden @code{mount-point} (default: @code{"/var/lib/nfs/rpc_pipefs"})
+The directory to which the file system is to be attached.
address@hidden table
address@hidden deftp
+
+
address@hidden Servicio del daemon GSS
address@hidden GSSD
address@hidden GSS
address@hidden global security system
+
+The @dfn{global security system} (GSS) daemon provides strong security for
+RPC based protocols. Before exchanging RPC requests an RPC client must
+establish a security context. Typically this is done using the Kerberos
+command @command{kinit} or automatically at login time using PAM services
+(@pxref{Servicios Kerberos}).
+
address@hidden {Variable Scheme} gss-service-type
+Un tipo de servicio para el daemon del sistema de seguridad global (GSS).
address@hidden defvr
+
address@hidden {Tipo de datos} gss-configuration
+Data type representing the configuration of the GSS daemon service. This
+type has the following parameters:
address@hidden @asis
address@hidden @code{nfs-utils} (predeterminado: @code{nfs-utils})
+The package in which the @command{rpc.gssd} command is to be found.
+
address@hidden @code{pipefs-directory} (predeterminado:
@code{"/var/lib/nfs/rpc_pipefs"})
+The directory where the pipefs file system is mounted.
+
address@hidden table
address@hidden deftp
+
+
address@hidden Servicio del daemon IDMAP
address@hidden idmapd
address@hidden name mapper
+
+The idmap daemon service provides mapping between user IDs and user names.
+Typically it is required in order to access file systems mounted via NFSv4.
+
address@hidden {Variable Scheme} idmap-service-type
+A service type for the Identity Mapper (IDMAP) daemon.
address@hidden defvr
+
address@hidden {Tipo de datos} idmap-configuration
+Data type representing the configuration of the IDMAP daemon service. This
+type has the following parameters:
address@hidden @asis
address@hidden @code{nfs-utils} (predeterminado: @code{nfs-utils})
+The package in which the @command{rpc.idmapd} command is to be found.
+
address@hidden @code{pipefs-directory} (predeterminado:
@code{"/var/lib/nfs/rpc_pipefs"})
+The directory where the pipefs file system is mounted.
+
address@hidden @code{domain} (predeterminado: @code{#f})
+The local NFSv4 domain name. This must be a string or @code{#f}. If it is
address@hidden then the daemon will use the host's fully qualified domain name.
+
address@hidden table
address@hidden deftp
+
address@hidden Integración continua
address@hidden Integración continua
+
address@hidden integración continua
address@hidden://git.savannah.gnu.org/cgit/guix/guix-cuirass.git, Cuirass} is a
+continuous integration tool for Guix. It can be used both for development
+and for providing substitutes to others (@pxref{Sustituciones}).
+
+El módulo @code{(gnu services cuirass)} proporciona el siguiente servicio.
+
address@hidden {Procedimiento Scheme} cuirass-service-type
+The type of the Cuirass service. Its value must be a
address@hidden object, as described below.
address@hidden defvr
+
+To add build jobs, you have to set the @code{specifications} field of the
+configuration. Here is an example of a service that polls the Guix
+repository and builds the packages from a manifest. Some of the packages
+are defined in the @code{"custom-packages"} input, which is the equivalent
+of @code{GUIX_PACKAGE_PATH}.
+
address@hidden
+(define %cuirass-specs
+ #~(list
+ '((#:name . "my-manifest")
+ (#:load-path-inputs . ("guix"))
+ (#:package-path-inputs . ("custom-packages"))
+ (#:proc-input . "guix")
+ (#:proc-file . "build-aux/cuirass/gnu-system.scm")
+ (#:proc . cuirass-jobs)
+ (#:proc-args . ((subset . "manifests")
+ (systems . ("x86_64-linux"))
+ (manifests . (("config" . "guix/manifest.scm")))))
+ (#:inputs . (((#:name . "guix")
+ (#:url . "git://git.savannah.gnu.org/guix.git")
+ (#:load-path . ".")
+ (#:branch . "master")
+ (#:no-compile? . #t))
+ ((#:name . "config")
+ (#:url . "git://git.example.org/config.git")
+ (#:load-path . ".")
+ (#:branch . "master")
+ (#:no-compile? . #t))
+ ((#:name . "custom-packages")
+ (#:url . "git://git.example.org/custom-packages.git")
+ (#:load-path . ".")
+ (#:branch . "master")
+ (#:no-compile? . #t)))))))
+
+(service cuirass-service-type
+ (cuirass-configuration
+ (specifications %cuirass-specs)))
address@hidden example
+
+While information related to build jobs is located directly in the
+specifications, global settings for the @command{cuirass} process are
+accessible in other @code{cuirass-configuration} fields.
+
address@hidden {Tipo de datos} cuirass-configuration
+Data type representing the configuration of Cuirass.
+
address@hidden @asis
address@hidden @code{log-file} (predeterminado: @code{"/var/log/cuirass.log"})
+Location of the log file.
+
address@hidden @code{cache-directory} (predeterminado:
@code{"/var/cache/cuirass"})
+Location of the repository cache.
+
address@hidden @code{user} (predeterminado: @code{"cuirass"})
+Owner of the @code{cuirass} process.
+
address@hidden @code{group} (predeterminado: @code{"cuirass"})
+Owner's group of the @code{cuirass} process.
+
address@hidden @code{interval} (predeterminado: @code{60})
+Number of seconds between the poll of the repositories followed by the
+Cuirass jobs.
+
address@hidden @code{database} (predeterminada:
@code{"/var/lib/cuirass/cuirass.db"})
+Location of sqlite database which contains the build results and previously
+added specifications.
+
address@hidden @code{ttl} (predeterminado: @code{(* 30 24 3600)})
+Specifies the time-to-live (TTL) in seconds of garbage collector roots that
+are registered for build results. This means that build results are
+protected from garbage collection for at least @var{ttl} seconds.
+
address@hidden @code{port} (predeterminado: @code{8081})
+Número de puerto usado por el servidor HTTP.
+
address@hidden address@hidden
+Listen on the network interface for @var{host}. The default is to accept
+connections from localhost.
+
address@hidden @code{specifications} (predeterminada: @code{#~'()})
+A gexp (@pxref{Expresiones-G}) that evaluates to a list of specifications,
+where a specification is an association list (@pxref{Associations Lists,,,
+guile, GNU Guile Reference Manual}) whose keys are keywords
+(@code{#:keyword-example}) as shown in the example above.
+
address@hidden @code{use-substitutes?} (predeterminado: @code{#f})
+This allows using substitutes to avoid building every dependencies of a job
+from source.
+
address@hidden @code{one-shot?} (predeterminado: @code{#f})
+Only evaluate specifications and build derivations once.
+
address@hidden @code{fallback?} (predeterminado: @code{#f})
+When substituting a pre-built binary fails, fall back to building packages
+locally.
+
address@hidden @code{cuirass} (predeterminado: @code{cuirass})
+El paquete Cuirass usado.
address@hidden table
address@hidden deftp
+
address@hidden Servicios de gestión de energía
address@hidden Servicios de gestión de energía
+
address@hidden tlp
address@hidden gestión de energía con TLP
address@hidden Daemon TLP
+
+El módulo @code{(gnu services pm)} proporciona una definición de servicio
+Guix para la herramienta de gestión de energía de Linux TLP.
+
+TLP enables various powersaving modes in userspace and kernel. Contrary to
address@hidden, it is not a passive, monitoring tool, as it will
+apply custom settings each time a new power source is detected. More
+information can be found at @uref{http://linrunner.de/en/tlp/tlp.html, TLP
+home page}.
+
address@hidden {Variable Scheme} tlp-service-type
+The service type for the TLP tool. Its value should be a valid TLP
+configuration (see below). To use the default settings, simply write:
address@hidden
+(service tlp-service-type)
address@hidden example
address@hidden deffn
+
+By default TLP does not need much configuration but most TLP parameters can
+be tweaked using @code{tlp-configuration}.
+
+Each parameter definition is preceded by its type; for example,
address@hidden foo} indicates that the @code{foo} parameter should be
+specified as a boolean. Types starting with @code{maybe-} denote parameters
+that won't show up in TLP config file when their value is @code{'disabled}.
+
address@hidden The following documentation was initially generated by
address@hidden (generate-tlp-documentation) in (gnu services pm). Manually
maintained
address@hidden documentation is better, so we shouldn't hesitate to edit below
as
address@hidden needed. However if the change you want to make to this
documentation
address@hidden can be done in an automated way, it's probably easier to change
address@hidden (generate-documentation) than to make it below and have to deal
with
address@hidden the churn as TLP updates.
+
+Available @code{tlp-configuration} fields are:
+
address@hidden address@hidden parameter} package tlp
+El paquete TLP.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean tlp-enable?
+Set to true if you wish to enable TLP.
+
+Defaults to @samp{#t}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string tlp-default-mode
+Default mode when no power supply can be detected. Alternatives are AC and
+BAT.
+
+Defaults to @samp{"AC"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer
disk-idle-secs-on-ac
+Number of seconds Linux kernel has to wait after the disk goes idle, before
+syncing on AC.
+
+El valor predeterminado es @samp{0}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer
disk-idle-secs-on-bat
+Same as @code{disk-idle-ac} but on BAT mode.
+
+Defaults to @samp{2}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer
max-lost-work-secs-on-ac
+Dirty pages flushing periodicity, expressed in seconds.
+
+Defaults to @samp{15}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer
max-lost-work-secs-on-bat
+Same as @code{max-lost-work-secs-on-ac} but on BAT mode.
+
+Defaults to @samp{60}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-space-separated-string-list
cpu-scaling-governor-on-ac
+CPU frequency scaling governor on AC mode. With intel_pstate driver,
+alternatives are powersave and performance. With acpi-cpufreq driver,
+alternatives are ondemand, powersave, performance and conservative.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-space-separated-string-list
cpu-scaling-governor-on-bat
+Same as @code{cpu-scaling-governor-on-ac} but on BAT mode.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-non-negative-integer
cpu-scaling-min-freq-on-ac
+Set the min available frequency for the scaling governor on AC.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-non-negative-integer
cpu-scaling-max-freq-on-ac
+Set the max available frequency for the scaling governor on AC.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-non-negative-integer
cpu-scaling-min-freq-on-bat
+Set the min available frequency for the scaling governor on BAT.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-non-negative-integer
cpu-scaling-max-freq-on-bat
+Set the max available frequency for the scaling governor on BAT.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-non-negative-integer
cpu-min-perf-on-ac
+Limit the min P-state to control the power dissipation of the CPU, in AC
+mode. Values are stated as a percentage of the available performance.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-non-negative-integer
cpu-max-perf-on-ac
+Limit the max P-state to control the power dissipation of the CPU, in AC
+mode. Values are stated as a percentage of the available performance.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-non-negative-integer
cpu-min-perf-on-bat
+Same as @code{cpu-min-perf-on-ac} on BAT mode.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-non-negative-integer
cpu-max-perf-on-bat
+Same as @code{cpu-max-perf-on-ac} on BAT mode.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-boolean cpu-boost-on-ac?
+Enable CPU turbo boost feature on AC mode.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-boolean cpu-boost-on-bat?
+Same as @code{cpu-boost-on-ac?} on BAT mode.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean sched-powersave-on-ac?
+Allow Linux kernel to minimize the number of CPU cores/hyper-threads used
+under light load conditions.
+
+El valor predeterminado es @samp{#f}
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean sched-powersave-on-bat?
+Same as @code{sched-powersave-on-ac?} but on BAT mode.
+
+Defaults to @samp{#t}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean nmi-watchdog?
+Enable Linux kernel NMI watchdog.
+
+El valor predeterminado es @samp{#f}
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-string phc-controls
+For Linux kernels with PHC patch applied, change CPU voltages. An example
+value would be @samp{"F:V F:V F:V F:V"}.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string energy-perf-policy-on-ac
+Set CPU performance versus energy saving policy on AC. Alternatives are
+performance, normal, powersave.
+
+Defaults to @samp{"performance"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string energy-perf-policy-on-bat
+Same as @code{energy-perf-policy-ac} but on BAT mode.
+
+Defaults to @samp{"powersave"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} space-separated-string-list
disks-devices
+Dispositivos de disco duro.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} space-separated-string-list
disk-apm-level-on-ac
+Hard disk advanced power management level.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} space-separated-string-list
disk-apm-level-on-bat
+Same as @code{disk-apm-bat} but on BAT mode.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-space-separated-string-list
disk-spindown-timeout-on-ac
+Hard disk spin down timeout. One value has to be specified for each
+declared hard disk.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-space-separated-string-list
disk-spindown-timeout-on-bat
+Same as @code{disk-spindown-timeout-on-ac} but on BAT mode.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-space-separated-string-list
disk-iosched
+Select IO scheduler for disk devices. One value has to be specified for
+each declared hard disk. Example alternatives are cfq, deadline and noop.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string sata-linkpwr-on-ac
+SATA aggressive link power management (ALPM) level. Alternatives are
+min_power, medium_power, max_performance.
+
+Defaults to @samp{"max_performance"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string sata-linkpwr-on-bat
+Same as @code{sata-linkpwr-ac} but on BAT mode.
+
+Defaults to @samp{"min_power"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-string sata-linkpwr-blacklist
+Exclude specified SATA host devices for link power management.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-on-off-boolean
ahci-runtime-pm-on-ac?
+Enable Runtime Power Management for AHCI controller and disks on AC mode.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-on-off-boolean
ahci-runtime-pm-on-bat?
+Same as @code{ahci-runtime-pm-on-ac} on BAT mode.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer
ahci-runtime-pm-timeout
+Seconds of inactivity before disk is suspended.
+
+Defaults to @samp{15}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string pcie-aspm-on-ac
+PCI Express Active State Power Management level. Alternatives are default,
+performance, powersave.
+
+Defaults to @samp{"performance"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string pcie-aspm-on-bat
+Same as @code{pcie-aspm-ac} but on BAT mode.
+
+Defaults to @samp{"powersave"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string radeon-power-profile-on-ac
+Radeon graphics clock speed level. Alternatives are low, mid, high, auto,
+default.
+
+Defaults to @samp{"high"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string radeon-power-profile-on-bat
+Same as @code{radeon-power-ac} but on BAT mode.
+
+Defaults to @samp{"low"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string radeon-dpm-state-on-ac
+Radeon dynamic power management method (DPM). Alternatives are battery,
+performance.
+
+Defaults to @samp{"performance"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string radeon-dpm-state-on-bat
+Same as @code{radeon-dpm-state-ac} but on BAT mode.
+
+Defaults to @samp{"battery"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string radeon-dpm-perf-level-on-ac
+Radeon DPM performance level. Alternatives are auto, low, high.
+
+Defaults to @samp{"auto"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string radeon-dpm-perf-level-on-bat
+Same as @code{radeon-dpm-perf-ac} but on BAT mode.
+
+Defaults to @samp{"auto"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} on-off-boolean wifi-pwr-on-ac?
+Wifi power saving mode.
+
+El valor predeterminado es @samp{#f}
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} on-off-boolean wifi-pwr-on-bat?
+Same as @code{wifi-power-ac?} but on BAT mode.
+
+Defaults to @samp{#t}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} y-n-boolean wol-disable?
+Disable wake on LAN.
+
+Defaults to @samp{#t}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer
sound-power-save-on-ac
+Timeout duration in seconds before activating audio power saving on Intel
+HDA and AC97 devices. A value of 0 disables power saving.
+
+El valor predeterminado es @samp{0}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} non-negative-integer
sound-power-save-on-bat
+Same as @code{sound-powersave-ac} but on BAT mode.
+
+Defaults to @samp{1}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} y-n-boolean
sound-power-save-controller?
+Disable controller in powersaving mode on Intel HDA devices.
+
+Defaults to @samp{#t}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean bay-poweroff-on-bat?
+Enable optical drive in UltraBay/MediaBay on BAT mode. Drive can be powered
+on again by releasing (and reinserting) the eject lever or by pressing the
+disc eject button on newer models.
+
+El valor predeterminado es @samp{#f}
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string bay-device
+Name of the optical drive device to power off.
+
+Defaults to @samp{"sr0"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string runtime-pm-on-ac
+Runtime Power Management for PCI(e) bus devices. Alternatives are on and
+auto.
+
+Defaults to @samp{"on"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string runtime-pm-on-bat
+Same as @code{runtime-pm-ac} but on BAT mode.
+
+Defaults to @samp{"auto"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean runtime-pm-all?
+Runtime Power Management for all PCI(e) bus devices, except blacklisted
+ones.
+
+Defaults to @samp{#t}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-space-separated-string-list
runtime-pm-blacklist
+Exclude specified PCI(e) device addresses from Runtime Power Management.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} space-separated-string-list
runtime-pm-driver-blacklist
+Exclude PCI(e) devices assigned to the specified drivers from Runtime Power
+Management.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean usb-autosuspend?
+Enable USB autosuspend feature.
+
+Defaults to @samp{#t}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-string usb-blacklist
+Exclude specified devices from USB autosuspend.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean usb-blacklist-wwan?
+Exclude WWAN devices from USB autosuspend.
+
+Defaults to @samp{#t}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-string usb-whitelist
+Include specified devices into USB autosuspend, even if they are already
+excluded by the driver or via @code{usb-blacklist-wwan?}.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-boolean
usb-autosuspend-disable-on-shutdown?
+Enable USB autosuspend before shutdown.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean
restore-device-state-on-startup?
+Restore radio device state (bluetooth, wifi, wwan) from previous shutdown on
+system startup.
+
+El valor predeterminado es @samp{#f}
+
address@hidden deftypevr
+
address@hidden thermald
address@hidden escalado de frecuencia de la CPU con thermald
address@hidden Daemon Thermald
+
+El módulo @code{(gnu services pm)} proporciona una interfaz con thermald, un
+servicio de escalado de frecuencia de la CPU que ayuda a prevenir el
+sobrecalentamiento.
+
address@hidden {Variable Scheme} thermald-service-type
+This is the service type for @uref{https://01.org/linux-thermal-daemon/,
+thermald}, the Linux Thermal Daemon, which is responsible for controlling
+the thermal state of processors and preventing overheating.
address@hidden defvr
+
address@hidden {Tipo de datos} thermald-configuration
+Tipo de datos que representa la configuración de
address@hidden
+
address@hidden @asis
address@hidden @code{ignore-cpuid-check?} (predeterminado: @code{#f})
+Ignore cpuid check for supported CPU models.
+
address@hidden @code{thermald} (predeterminado: @var{thermald})
+Package object of thermald.
+
address@hidden table
address@hidden deftp
+
address@hidden Servicios de audio
address@hidden Servicios de audio
+
+El módulo @code{(gnu services audio)} proporciona un servicio para iniciar
+MPD (el daemon de reproducción de música).
+
address@hidden mpd
address@hidden Daemon de reproducción de música (MPD)
+
+El daemon de reproducción de música (MPD) es un servicio que puede
+reproducir música mientras se controla desde la máquina local o sobre una
+red por una multitud de clientes.
+
+El siguiente ejemplo muestra como se puede ejecutar @code{mpd} como
address@hidden"rober"} en el puerto @code{6666}. Usa pulseaudio para su salida.
+
address@hidden
+(service mpd-service-type
+ (mpd-configuration
+ (user "rober")
+ (port "6666")))
address@hidden example
+
address@hidden {Variable Scheme} mpd-service-type
+El tipo de servicio para @command{mpd}.
address@hidden defvr
+
address@hidden {Tipo de datos} mpd-configuration
+Data type representing the configuration of @command{mpd}.
+
address@hidden @asis
address@hidden @code{user} (predeterminada: @code{"mpd"})
+Usuaria que ejecuta mpd.
+
address@hidden @code{music-dir} (predeterminado: @code{"~/Music"})
+The directory to scan for music files.
+
address@hidden @code{playlist-dir} (predeterminado: @code{"~/.mpd/playlists"})
+The directory to store playlists.
+
address@hidden @code{db-file} (default: @code{"~/.mpd/tag_cache"})
+The location of the music database.
+
address@hidden @code{state-file} (default: @code{"~/.mpd/state"})
+The location of the file that stores current MPD's state.
+
address@hidden @code{sticker-file} (default: @code{"~/.mpd/sticker.sql"})
+The location of the sticker database.
+
address@hidden @code{port} (predeterminado: @code{"6600"})
+Puerto sobre el que se ejecuta mpd.
+
address@hidden @code{address} (predeterminada: @code{"any"})
+The address that mpd will bind to. To use a Unix domain socket, an absolute
+path can be specified here.
+
address@hidden table
address@hidden deftp
+
address@hidden Servicios de virtualización
address@hidden Servicios de virtualización
+
+The @code{(gnu services virtualization)} module provides services for the
+libvirt and virtlog daemons, as well as other virtualization-related
+services.
+
address@hidden Demonio Libvirt
address@hidden is the server side daemon component of the libvirt
+virtualization management system. This daemon runs on host servers and
+performs required management tasks for virtualized guests.
+
address@hidden {Variable Scheme} libvirt-service-type
+This is the type of the @uref{https://libvirt.org, libvirt daemon}. Its
+value must be a @code{libvirt-configuration}.
+
address@hidden
+(service libvirt-service-type
+ (libvirt-configuration
+ (unix-sock-group "libvirt")
+ (tls-port "16555")))
address@hidden example
address@hidden deffn
+
address@hidden Auto-generated with (generate-libvirt-documentation)
+Available @code{libvirt-configuration} fields are:
+
address@hidden address@hidden parameter} package libvirt
+Paquete libvirt.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean listen-tls?
+Flag listening for secure TLS connections on the public TCP/IP port. must
+set @code{listen} for this to have any effect.
+
+It is necessary to setup a CA and issue server certificates before using
+this capability.
+
+Defaults to @samp{#t}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean listen-tcp?
+Listen for unencrypted TCP connections on the public TCP/IP port. must set
address@hidden for this to have any effect.
+
+Using the TCP socket requires SASL authentication by default. Only SASL
+mechanisms which support data encryption are allowed. This is DIGEST_MD5
+and GSSAPI (Kerberos5)
+
+El valor predeterminado es @samp{#f}
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string tls-port
+Port for accepting secure TLS connections This can be a port number, or
+service name
+
+Defaults to @samp{"16514"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string tcp-port
+Port for accepting insecure TCP connections This can be a port number, or
+service name
+
+Defaults to @samp{"16509"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string listen-addr
+IP address or hostname used for client connections.
+
+Defaults to @samp{"0.0.0.0"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean mdns-adv?
+Flag toggling mDNS advertisement of the libvirt service.
+
+Alternatively can disable for all services on a host by stopping the Avahi
+daemon.
+
+El valor predeterminado es @samp{#f}
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string mdns-name
+Default mDNS advertisement name. This must be unique on the immediate
+broadcast network.
+
+Defaults to @samp{"Virtualization Host <hostname>"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string unix-sock-group
+UNIX domain socket group ownership. This can be used to allow a 'trusted'
+set of users access to management capabilities without becoming root.
+
+Defaults to @samp{"root"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string unix-sock-ro-perms
+UNIX socket permissions for the R/O socket. This is used for monitoring VM
+status only.
+
+Defaults to @samp{"0777"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string unix-sock-rw-perms
+UNIX socket permissions for the R/W socket. Default allows only root. If
+PolicyKit is enabled on the socket, the default will change to allow
+everyone (eg, 0777)
+
+Defaults to @samp{"0770"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string unix-sock-admin-perms
+UNIX socket permissions for the admin socket. Default allows only owner
+(root), do not change it unless you are sure to whom you are exposing the
+access to.
+
+Defaults to @samp{"0777"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string unix-sock-dir
+The directory in which sockets will be found/created.
+
+Defaults to @samp{"/var/run/libvirt"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string auth-unix-ro
+Authentication scheme for UNIX read-only sockets. By default socket
+permissions allow anyone to connect
+
+Defaults to @samp{"polkit"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string auth-unix-rw
+Authentication scheme for UNIX read-write sockets. By default socket
+permissions only allow root. If PolicyKit support was compiled into
+libvirt, the default will be to use 'polkit' auth.
+
+Defaults to @samp{"polkit"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string auth-tcp
+Authentication scheme for TCP sockets. If you don't enable SASL, then all
+TCP traffic is cleartext. Don't do this outside of a dev/test scenario.
+
+Defaults to @samp{"sasl"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string auth-tls
+Authentication scheme for TLS sockets. TLS sockets already have encryption
+provided by the TLS layer, and limited authentication is done by
+certificates.
+
+It is possible to make use of any SASL authentication mechanism as well, by
+using 'sasl' for this option
+
+Defaults to @samp{"none"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} optional-list access-drivers
+API access control scheme.
+
+By default an authenticated user is allowed access to all APIs. Access
+drivers can place restrictions on this.
+
+Defaults to @samp{()}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string key-file
+Server key file path. If set to an empty string, then no private key is
+loaded.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string cert-file
+Server key file path. If set to an empty string, then no certificate is
+loaded.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string ca-file
+Server key file path. If set to an empty string, then no CA certificate is
+loaded.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string crl-file
+Certificate revocation list path. If set to an empty string, then no CRL is
+loaded.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean tls-no-sanity-cert
+Disable verification of our own server certificates.
+
+When libvirtd starts it performs some sanity checks against its own
+certificates.
+
+El valor predeterminado es @samp{#f}
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean tls-no-verify-cert
+Disable verification of client certificates.
+
+Client certificate verification is the primary authentication mechanism.
+Any client which does not present a certificate signed by the CA will be
+rejected.
+
+El valor predeterminado es @samp{#f}
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} optional-list tls-allowed-dn-list
+Whitelist of allowed x509 Distinguished Name.
+
+Defaults to @samp{()}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} optional-list sasl-allowed-usernames
+Whitelist of allowed SASL usernames. The format for username depends on the
+SASL authentication mechanism.
+
+Defaults to @samp{()}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string tls-priority
+Override the compile time default TLS priority string. The default is
+usually "NORMAL" unless overridden at build time. Only set this is it is
+desired for libvirt to deviate from the global default settings.
+
+Defaults to @samp{"NORMAL"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} integer max-clients
+Maximum number of concurrent client connections to allow over all sockets
+combined.
+
+Defaults to @samp{5000}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} integer max-queued-clients
+Maximum length of queue of connections waiting to be accepted by the
+daemon. Note, that some protocols supporting retransmission may obey this
+so that a later reattempt at connection succeeds.
+
+Defaults to @samp{1000}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} integer max-anonymous-clients
+Maximum length of queue of accepted but not yet authenticated clients. Set
+this to zero to turn this feature off
+
+Defaults to @samp{20}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} integer min-workers
+Number of workers to start up initially.
+
+Defaults to @samp{5}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} integer max-workers
+Maximum number of worker threads.
+
+If the number of active clients exceeds @code{min-workers}, then more
+threads are spawned, up to max_workers limit. Typically you'd want
+max_workers to equal maximum number of clients allowed.
+
+Defaults to @samp{20}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} integer prio-workers
+Number of priority workers. If all workers from above pool are stuck, some
+calls marked as high priority (notably domainDestroy) can be executed in
+this pool.
+
+Defaults to @samp{5}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} integer max-requests
+Total global limit on concurrent RPC calls.
+
+Defaults to @samp{20}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} integer max-client-requests
+Limit on concurrent requests from a single client connection. To avoid one
+client monopolizing the server this should be a small fraction of the global
+max_requests and max_workers parameter.
+
+Defaults to @samp{5}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} integer admin-min-workers
+Same as @code{min-workers} but for the admin interface.
+
+Defaults to @samp{1}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} integer admin-max-workers
+Same as @code{max-workers} but for the admin interface.
+
+Defaults to @samp{5}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} integer admin-max-clients
+Same as @code{max-clients} but for the admin interface.
+
+Defaults to @samp{5}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} integer admin-max-queued-clients
+Same as @code{max-queued-clients} but for the admin interface.
+
+Defaults to @samp{5}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} integer admin-max-client-requests
+Same as @code{max-client-requests} but for the admin interface.
+
+Defaults to @samp{5}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} integer log-level
+Logging level. 4 errors, 3 warnings, 2 information, 1 debug.
+
+Defaults to @samp{3}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string log-filters
+Filtros de log.
+
+A filter allows to select a different logging level for a given category of
+logs The format for a filter is one of:
+
address@hidden @bullet
address@hidden
+x:nombre
+
address@hidden
+x:+nombre
+
address@hidden itemize
+
+where @code{name} is a string which is matched against the category given in
+the @code{VIR_LOG_INIT()} at the top of each libvirt source file, e.g.,
+"remote", "qemu", or "util.json" (the name in the filter can be a substring
+of the full category name, in order to match multiple similar categories),
+the optional "+" prefix tells libvirt to log stack trace for each message
+matching name, and @code{x} is the minimal level where matching messages
+should be logged:
+
address@hidden @bullet
address@hidden
+1: DEBUG
+
address@hidden
+2: INFO
+
address@hidden
+3: WARNING
+
address@hidden
+4: ERROR
+
address@hidden itemize
+
+Multiple filters can be defined in a single filters statement, they just
+need to be separated by spaces.
+
+Defaults to @samp{"3:remote 4:event"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string log-outputs
+Logging outputs.
+
+An output is one of the places to save logging information The format for an
+output can be:
+
address@hidden @code
address@hidden x:stderr
+output goes to stderr
+
address@hidden x:syslog:name
+use syslog for the output and use the given name as the ident
+
address@hidden x:file:file_path
+output to a file, with the given filepath
+
address@hidden x:journald
+output to journald logging system
+
address@hidden table
+
+In all case the x prefix is the minimal level, acting as a filter
+
address@hidden @bullet
address@hidden
+1: DEBUG
+
address@hidden
+2: INFO
+
address@hidden
+3: WARNING
+
address@hidden
+4: ERROR
+
address@hidden itemize
+
+Multiple outputs can be defined, they just need to be separated by spaces.
+
+Defaults to @samp{"3:stderr"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} integer audit-level
+Allows usage of the auditing subsystem to be altered
+
address@hidden @bullet
address@hidden
+0: disable all auditing
+
address@hidden
+1: enable auditing, only if enabled on host
+
address@hidden
+2: enable auditing, and exit if disabled on host.
+
address@hidden itemize
+
+Defaults to @samp{1}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean audit-logging
+Send audit messages via libvirt logging infrastructure.
+
+El valor predeterminado es @samp{#f}
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} optional-string host-uuid
+Host UUID. UUID must not have all digits be the same.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string host-uuid-source
+Source to read host UUID.
+
address@hidden @bullet
address@hidden
address@hidden: fetch the UUID from @code{dmidecode -s system-uuid}
+
address@hidden
address@hidden: fetch the UUID from @code{/etc/machine-id}
+
address@hidden itemize
+
+If @code{dmidecode} does not provide a valid UUID a temporary UUID will be
+generated.
+
+Defaults to @samp{"smbios"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} integer keepalive-interval
+A keepalive message is sent to a client after @code{keepalive_interval}
+seconds of inactivity to check if the client is still responding. If set to
+-1, libvirtd will never send keepalive requests; however clients can still
+send them and the daemon will send responses.
+
+Defaults to @samp{5}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} integer keepalive-count
+Maximum number of keepalive messages that are allowed to be sent to the
+client without getting any response before the connection is considered
+broken.
+
+In other words, the connection is automatically closed approximately after
address@hidden * (keepalive_count + 1)} seconds since the last
+message received from the client. When @code{keepalive-count} is set to 0,
+connections will be automatically closed after @code{keepalive-interval}
+seconds of inactivity without sending any keepalive messages.
+
+Defaults to @samp{5}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} integer admin-keepalive-interval
+Same as above but for admin interface.
+
+Defaults to @samp{5}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} integer admin-keepalive-count
+Same as above but for admin interface.
+
+Defaults to @samp{5}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} integer ovs-timeout
+Timeout for Open vSwitch calls.
+
+The @code{ovs-vsctl} utility is used for the configuration and its timeout
+option is set by default to 5 seconds to avoid potential infinite waits
+blocking libvirt.
+
+Defaults to @samp{5}.
+
address@hidden deftypevr
+
address@hidden %end of autogenerated docs
+
address@hidden Daemon Virtlog
+The virtlogd service is a server side daemon component of libvirt that is
+used to manage logs from virtual machine consoles.
+
+This daemon is not used directly by libvirt client applications, rather it
+is called on their behalf by @code{libvirtd}. By maintaining the logs in a
+standalone daemon, the main @code{libvirtd} daemon can be restarted without
+risk of losing logs. The @code{virtlogd} daemon has the ability to re-exec()
+itself upon receiving @code{SIGUSR1}, to allow live upgrades without
+downtime.
+
address@hidden {Variable Scheme} virtlog-service-type
+This is the type of the virtlog daemon. Its value must be a
address@hidden
+
address@hidden
+(service virtlog-service-type
+ (virtlog-configuration
+ (max-clients 1000)))
address@hidden example
address@hidden deffn
+
address@hidden address@hidden parameter} integer log-level
+Logging level. 4 errors, 3 warnings, 2 information, 1 debug.
+
+Defaults to @samp{3}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string log-filters
+Filtros de log.
+
+A filter allows to select a different logging level for a given category of
+logs The format for a filter is one of:
+
address@hidden @bullet
address@hidden
+x:nombre
+
address@hidden
+x:+nombre
+
address@hidden itemize
+
+where @code{name} is a string which is matched against the category given in
+the @code{VIR_LOG_INIT()} at the top of each libvirt source file, e.g.,
+"remote", "qemu", or "util.json" (the name in the filter can be a substring
+of the full category name, in order to match multiple similar categories),
+the optional "+" prefix tells libvirt to log stack trace for each message
+matching name, and @code{x} is the minimal level where matching messages
+should be logged:
+
address@hidden @bullet
address@hidden
+1: DEBUG
+
address@hidden
+2: INFO
+
address@hidden
+3: WARNING
+
address@hidden
+4: ERROR
+
address@hidden itemize
+
+Multiple filters can be defined in a single filters statement, they just
+need to be separated by spaces.
+
+Defaults to @samp{"3:remote 4:event"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string log-outputs
+Logging outputs.
+
+An output is one of the places to save logging information The format for an
+output can be:
+
address@hidden @code
address@hidden x:stderr
+output goes to stderr
+
address@hidden x:syslog:name
+use syslog for the output and use the given name as the ident
+
address@hidden x:file:file_path
+output to a file, with the given filepath
+
address@hidden x:journald
+output to journald logging system
+
address@hidden table
+
+In all case the x prefix is the minimal level, acting as a filter
+
address@hidden @bullet
address@hidden
+1: DEBUG
+
address@hidden
+2: INFO
+
address@hidden
+3: WARNING
+
address@hidden
+4: ERROR
+
address@hidden itemize
+
+Multiple outputs can be defined, they just need to be separated by spaces.
+
+Defaults to @samp{"3:stderr"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} integer max-clients
+Maximum number of concurrent client connections to allow over all sockets
+combined.
+
+Defaults to @samp{1024}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} integer max-size
+Maximum file size before rolling over.
+
+Defaults to @samp{2MB}
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} integer max-backups
+Maximum number of backup files to keep.
+
+Defaults to @samp{3}
+
address@hidden deftypevr
+
address@hidden Transparent Emulation with QEMU
+
address@hidden emulación
address@hidden @code{binfmt_misc}
address@hidden provides support for transparent emulation
+of program binaries built for different architectures---e.g., it allows you
+to transparently execute an ARMv7 program on an x86_64 machine. It achieves
+this by combining the @uref{https://www.qemu.org, QEMU} emulator and the
address@hidden feature of the kernel Linux.
+
address@hidden {Variable Scheme} qemu-binfmt-service-type
+This is the type of the QEMU/binfmt service for transparent emulation. Its
+value must be a @code{qemu-binfmt-configuration} object, which specifies the
+QEMU package to use as well as the architecture we want to emulated:
+
address@hidden
+(service qemu-binfmt-service-type
+ (qemu-binfmt-configuration
+ (platforms (lookup-qemu-platforms "arm" "aarch64" "mips64el"))))
address@hidden example
+
+In this example, we enable transparent emulation for the ARM and aarch64
+platforms. Running @code{herd stop qemu-binfmt} turns it off, and running
address@hidden start qemu-binfmt} turns it back on (@pxref{Invoking herd, the
address@hidden command,, shepherd, The GNU Shepherd Manual}).
address@hidden defvr
+
address@hidden {Tipo de datos} qemu-binfmt-configuration
+This is the configuration for the @code{qemu-binfmt} service.
+
address@hidden @asis
address@hidden @code{platforms} (predeterminadas: @code{'()})
+The list of emulated QEMU platforms. Each item must be a @dfn{platform
+object} as returned by @code{lookup-qemu-platforms} (see below).
+
address@hidden @code{guix-support?} (predeterminado: @code{#f})
+When it is true, QEMU and all its dependencies are added to the build
+environment of @command{guix-daemon} (@pxref{Invocación de guix-daemon,
address@hidden option}). This allows the @code{binfmt_misc}
+handlers to be used within the build environment, which in turn means that
+you can transparently build programs for another architecture.
+
+For example, let's suppose you're on an x86_64 machine and you have this
+service:
+
address@hidden
+(service qemu-binfmt-service-type
+ (qemu-binfmt-configuration
+ (platforms (lookup-qemu-platforms "arm"))
+ (guix-support? #t)))
address@hidden example
+
+You can run:
+
address@hidden
+guix build -s armhf-linux inkscape
address@hidden example
+
address@hidden
+and it will build Inkscape for ARMv7 @emph{as if it were a native build},
+transparently using QEMU to emulate the ARMv7 CPU. Pretty handy if you'd
+like to test a package build for an architecture you don't have access to!
+
address@hidden @code{qemu} (predeterminado: @code{qemu})
+El paquete QEMU usado.
address@hidden table
address@hidden deftp
+
address@hidden {Procedimiento Scheme} lookup-qemu-platforms @address@hidden
+Return the list of QEMU platform objects corresponding to
address@hidden@dots{}. @var{platforms} must be a list of strings
+corresponding to platform names, such as @code{"arm"}, @code{"sparc"},
address@hidden"mips64el"}, and so on.
address@hidden deffn
+
address@hidden {Procedimiento Scheme} qemu-platform? @var{obj}
+Devuelve verdadero si @var{obj} es un objeto plataforma.
address@hidden deffn
+
address@hidden {Procedimiento Scheme} qemu-platform-name @var{plataforma}
+Devuelve el nombre de @var{plataforma}---una cadena como @code{"arm"}.
address@hidden deffn
+
address@hidden Servicios de control de versiones
address@hidden Servicios de control de versiones
+
+The @code{(gnu services version-control)} module provides a service to allow
+remote access to local Git repositories. There are three options: the
address@hidden, which provides access to repositories via the
address@hidden://} unsecured TCP-based protocol, extending the @code{nginx} web
+server to proxy some requests to @code{git-http-backend}, or providing a web
+interface with @code{cgit-service-type}.
+
address@hidden {Procedimiento Scheme} git-daemon-service [#:config
(git-daemon-configuration)]
+
+Devuelve un servicio que ejecuta @command{git daemon}, un servidor TCP
+simple para exponer repositorios con el protocolo Git para acceso anónimo.
+
+The optional @var{config} argument should be a
address@hidden<git-daemon-configuration>} object, by default it allows read-only
+access to address@hidden creating the magic file
+"git-daemon-export-ok" in the repository directory.} repositories under
address@hidden/srv/git}.
+
address@hidden deffn
+
address@hidden {Tipo de datos} git-daemon-configuration
+Tipo de datos que representa la configuración para
address@hidden
+
address@hidden @asis
address@hidden @code{package} (predeterminado: @var{git})
+Package object of the Git distributed version control system.
+
address@hidden @code{export-all?} (predeterminado: @var{#f})
+Whether to allow access for all Git repositories, even if they do not have
+the @file{git-daemon-export-ok} file.
+
address@hidden @code{base-path} (predeterminado: @file{/srv/git})
+Whether to remap all the path requests as relative to the given path. If
+you run git daemon with @var{(base-path "/srv/git")} on example.com, then if
+you later try to pull @code{git://example.com/hello.git}, git daemon will
+interpret the path as @code{/srv/git/hello.git}.
+
address@hidden @code{user-path} (predeterminado: @var{#f})
+Whether to allow @code{~user} notation to be used in requests. When
+specified with empty string, requests to @code{git://host/~alice/foo} is
+taken as a request to access @code{foo} repository in the home directory of
+user @code{alice}. If @var{(user-path "path")} is specified, the same
+request is taken as a request to access @code{path/foo} repository in the
+home directory of user @code{alice}.
+
address@hidden @code{listen} (predeterminado: @var{'()})
+Whether to listen on specific IP addresses or hostnames, defaults to all.
+
address@hidden @code{port} (predeterminado: @var{#f})
+Whether to listen on an alternative port, which defaults to 9418.
+
address@hidden @code{whitelist} (predeterminado: @var{'()})
+If not empty, only allow access to this list of directories.
+
address@hidden @code{extra-options} (predeterminadas: @var{'()})
+Extra options will be passed to @code{git daemon}, please run @command{man
+git-daemon} for more information.
+
address@hidden table
address@hidden deftp
+
+The @code{git://} protocol lacks authentication. When you pull from a
+repository fetched via @code{git://}, you don't know that the data you
+receive was modified is really coming from the specified host, and you have
+your connection is subject to eavesdropping. It's better to use an
+authenticated and encrypted transport, such as @code{https}. Although Git
+allows you to serve repositories using unsophisticated file-based web
+servers, there is a faster protocol implemented by the
address@hidden program. This program is the back-end of a proper
+Git web service. It is designed to sit behind a FastCGI proxy.
@xref{Servicios Web}, for more on running the necessary @code{fcgiwrap} daemon.
+
+Guix has a separate configuration data type for serving Git repositories
+over HTTP.
+
address@hidden {Tipo de datos} git-http-configuration
+Data type representing the configuration for @code{git-http-service}.
+
address@hidden @asis
address@hidden @code{package} (predeterminado: @var{git})
+Package object of the Git distributed version control system.
+
address@hidden @code{git-root} (predeterminada: @file{/srv/git})
+Directory containing the Git repositories to expose to the world.
+
address@hidden @code{export-all?} (predeterminado: @var{#f})
+Whether to expose access for all Git repositories in @var{git-root}, even if
+they do not have the @file{git-daemon-export-ok} file.
+
address@hidden @code{uri-path} (predeterminada: @file{/git/})
+Path prefix for Git access. With the default @code{/git/} prefix, this will
+map @code{http://@var{server}/git/@var{repo}.git} to
address@hidden/srv/git/@var{repo}.git}. Requests whose URI paths do not begin
with
+this prefix are not passed on to this Git instance.
+
address@hidden @code{fcgiwrap-socket} (predeterminado: @code{127.0.0.1:9000})
+The socket on which the @code{fcgiwrap} daemon is listening. @xref{Servicios
Web}.
address@hidden table
address@hidden deftp
+
+There is no @code{git-http-service-type}, currently; instead you can create
+an @code{nginx-location-configuration} from a @code{git-http-configuration}
+and then add that location to a web server.
+
address@hidden {Procedimiento Scheme} git-http-nginx-location-configuration @
+ [config=(git-http-configuration)] Compute an
address@hidden that corresponds to the given Git http
+configuration. An example nginx service definition to serve the default
address@hidden/srv/git} over HTTPS might be:
+
address@hidden
+(service nginx-service-type
+ (nginx-configuration
+ (server-blocks
+ (list
+ (nginx-server-configuration
+ (listen '("443 ssl"))
+ (server-name "git.my-host.org")
+ (ssl-certificate
+ "/etc/letsencrypt/live/git.my-host.org/fullchain.pem")
+ (ssl-certificate-key
+ "/etc/letsencrypt/live/git.my-host.org/privkey.pem")
+ (locations
+ (list
+ (git-http-nginx-location-configuration
+ (git-http-configuration (uri-path "/"))))))))))
address@hidden example
+
+This example assumes that you are using Let's Encrypt to get your TLS
+certificate. @xref{Servicios de certificados}. The default @code{certbot}
+service will redirect all HTTP traffic on @code{git.my-host.org} to HTTPS.
+You will also need to add an @code{fcgiwrap} proxy to your system services.
address@hidden Web}.
address@hidden deffn
+
address@hidden Servicio Cgit
+
address@hidden servicio Cgit
address@hidden Git, web interface
address@hidden://git.zx2c4.com/cgit/, Cgit} is a web frontend for Git
+repositories written in C.
+
+The following example will configure the service with default values. By
+default, Cgit can be accessed on port 80 (@code{http://localhost:80}).
+
address@hidden
+(service cgit-service-type)
address@hidden example
+
+The @code{file-object} type designates either a file-like object
+(@pxref{Expresiones-G, file-like objects}) or a string.
+
address@hidden %start of fragment
+
+Available @code{cgit-configuration} fields are:
+
address@hidden address@hidden parameter} package package
+El paquete CGIT.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} nginx-server-configuration-list nginx
+Configuración de NGINX.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} file-object about-filter
+Specifies a command which will be invoked to format the content of about
+pages (both top-level and for each repository).
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string agefile
+Specifies a path, relative to each repository path, which can be used to
+specify the date and time of the youngest commit in the repository.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} file-object auth-filter
+Specifies a command that will be invoked for authenticating repository
+access.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string branch-sort
+Flag which, when set to @samp{age}, enables date ordering in the branch ref
+list, and when set @samp{name} enables ordering by branch name.
+
+Defaults to @samp{"name"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string cache-root
+Path used to store the cgit cache entries.
+
+Defaults to @samp{"/var/cache/cgit"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} integer cache-static-ttl
+Number which specifies the time-to-live, in minutes, for the cached version
+of repository pages accessed with a fixed SHA1.
+
+Defaults to @samp{-1}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} integer cache-dynamic-ttl
+Number which specifies the time-to-live, in minutes, for the cached version
+of repository pages accessed without a fixed SHA1.
+
+Defaults to @samp{5}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} integer cache-repo-ttl
+Number which specifies the time-to-live, in minutes, for the cached version
+of the repository summary page.
+
+Defaults to @samp{5}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} integer cache-root-ttl
+Number which specifies the time-to-live, in minutes, for the cached version
+of the repository index page.
+
+Defaults to @samp{5}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} integer cache-scanrc-ttl
+Number which specifies the time-to-live, in minutes, for the result of
+scanning a path for Git repositories.
+
+Defaults to @samp{15}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} integer cache-about-ttl
+Number which specifies the time-to-live, in minutes, for the cached version
+of the repository about page.
+
+Defaults to @samp{15}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} integer cache-snapshot-ttl
+Number which specifies the time-to-live, in minutes, for the cached version
+of snapshots.
+
+Defaults to @samp{5}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} integer cache-size
+The maximum number of entries in the cgit cache. When set to @samp{0},
+caching is disabled.
+
+El valor predeterminado es @samp{0}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean case-sensitive-sort?
+Sort items in the repo list case sensitively.
+
+Defaults to @samp{#t}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} list clone-prefix
+List of common prefixes which, when combined with a repository URL,
+generates valid clone URLs for the repository.
+
+Defaults to @samp{()}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} list clone-url
+List of @code{clone-url} templates.
+
+Defaults to @samp{()}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} file-object commit-filter
+Command which will be invoked to format commit messages.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string commit-sort
+Flag which, when set to @samp{date}, enables strict date ordering in the
+commit log, and when set to @samp{topo} enables strict topological ordering.
+
+Defaults to @samp{"git log"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} file-object css
+URL which specifies the css document to include in all cgit pages.
+
+Defaults to @samp{"/share/cgit/cgit.css"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} file-object email-filter
+Specifies a command which will be invoked to format names and email address
+of committers, authors, and taggers, as represented in various places
+throughout the cgit interface.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean embedded?
+Flag which, when set to @samp{#t}, will make cgit generate a HTML fragment
+suitable for embedding in other HTML pages.
+
+El valor predeterminado es @samp{#f}
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean enable-commit-graph?
+Flag which, when set to @samp{#t}, will make cgit print an ASCII-art commit
+history graph to the left of the commit messages in the repository log page.
+
+El valor predeterminado es @samp{#f}
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean enable-filter-overrides?
+Flag which, when set to @samp{#t}, allows all filter settings to be
+overridden in repository-specific cgitrc files.
+
+El valor predeterminado es @samp{#f}
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean enable-follow-links?
+Flag which, when set to @samp{#t}, allows users to follow a file in the log
+view.
+
+El valor predeterminado es @samp{#f}
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean enable-http-clone?
+If set to @samp{#t}, cgit will act as an dumb HTTP endpoint for Git clones.
+
+Defaults to @samp{#t}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean enable-index-links?
+Flag which, when set to @samp{#t}, will make cgit generate extra links
+"summary", "commit", "tree" for each repo in the repository index.
+
+El valor predeterminado es @samp{#f}
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean enable-index-owner?
+Flag which, when set to @samp{#t}, will make cgit display the owner of each
+repo in the repository index.
+
+Defaults to @samp{#t}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean enable-log-filecount?
+Flag which, when set to @samp{#t}, will make cgit print the number of
+modified files for each commit on the repository log page.
+
+El valor predeterminado es @samp{#f}
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean enable-log-linecount?
+Flag which, when set to @samp{#t}, will make cgit print the number of added
+and removed lines for each commit on the repository log page.
+
+El valor predeterminado es @samp{#f}
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean enable-remote-branches?
+Flag which, when set to @code{#t}, will make cgit display remote branches in
+the summary and refs views.
+
+El valor predeterminado es @samp{#f}
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean enable-subject-links?
+Flag which, when set to @code{1}, will make cgit use the subject of the
+parent commit as link text when generating links to parent commits in commit
+view.
+
+El valor predeterminado es @samp{#f}
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean enable-html-serving?
+Flag which, when set to @samp{#t}, will make cgit use the subject of the
+parent commit as link text when generating links to parent commits in commit
+view.
+
+El valor predeterminado es @samp{#f}
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean enable-tree-linenumbers?
+Flag which, when set to @samp{#t}, will make cgit generate linenumber links
+for plaintext blobs printed in the tree view.
+
+Defaults to @samp{#t}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean enable-git-config?
+Flag which, when set to @samp{#f}, will allow cgit to use Git config to set
+any repo specific settings.
+
+El valor predeterminado es @samp{#f}
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} file-object favicon
+URL used as link to a shortcut icon for cgit.
+
+Defaults to @samp{"/favicon.ico"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string footer
+The content of the file specified with this option will be included verbatim
+at the bottom of all pages (i.e.@: it replaces the standard "generated
+by..."@: message).
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string head-include
+The content of the file specified with this option will be included verbatim
+in the HTML HEAD section on all pages.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string header
+The content of the file specified with this option will be included verbatim
+at the top of all pages.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} file-object include
+Name of a configfile to include before the rest of the current config- file
+is parsed.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string index-header
+The content of the file specified with this option will be included verbatim
+above the repository index.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string index-info
+The content of the file specified with this option will be included verbatim
+below the heading on the repository index page.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean local-time?
+Flag which, if set to @samp{#t}, makes cgit print commit and tag times in
+the servers timezone.
+
+El valor predeterminado es @samp{#f}
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} file-object logo
+URL which specifies the source of an image which will be used as a logo on
+all cgit pages.
+
+Defaults to @samp{"/share/cgit/cgit.png"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string logo-link
+URL loaded when clicking on the cgit logo image.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} file-object owner-filter
+Command which will be invoked to format the Owner column of the main page.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} integer max-atom-items
+Number of items to display in atom feeds view.
+
+Defaults to @samp{10}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} integer max-commit-count
+Number of entries to list per page in "log" view.
+
+Defaults to @samp{50}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} integer max-message-length
+Number of commit message characters to display in "log" view.
+
+Defaults to @samp{80}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} integer max-repo-count
+Specifies the number of entries to list per page on the repository index
+page.
+
+Defaults to @samp{50}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} integer max-repodesc-length
+Specifies the maximum number of repo description characters to display on
+the repository index page.
+
+Defaults to @samp{80}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} integer max-blob-size
+Specifies the maximum size of a blob to display HTML for in KBytes.
+
+El valor predeterminado es @samp{0}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string max-stats
+Maximum statistics period. Valid values are @samp{week},@samp{month},
address@hidden and @samp{year}.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} mimetype-alist mimetype
+Mimetype for the specified filename extension.
+
+Defaults to @samp{((gif "image/gif") (html "text/html") (jpg "image/jpeg")
+(jpeg "image/jpeg") (pdf "application/pdf") (png "image/png") (svg
+"image/svg+xml"))}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} file-object mimetype-file
+Specifies the file to use for automatic mimetype lookup.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string module-link
+Text which will be used as the formatstring for a hyperlink when a submodule
+is printed in a directory listing.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean nocache?
+If set to the value @samp{#t} caching will be disabled.
+
+El valor predeterminado es @samp{#f}
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean noplainemail?
+If set to @samp{#t} showing full author email addresses will be disabled.
+
+El valor predeterminado es @samp{#f}
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean noheader?
+Flag which, when set to @samp{#t}, will make cgit omit the standard header
+on all pages.
+
+El valor predeterminado es @samp{#f}
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} project-list project-list
+A list of subdirectories inside of @code{repository-directory}, relative to
+it, that should loaded as Git repositories. An empty list means that all
+subdirectories will be loaded.
+
+Defaults to @samp{()}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} file-object readme
+Text which will be used as default value for @code{cgit-repo-readme}.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean remove-suffix?
+If set to @code{#t} and @code{repository-directory} is enabled, if any
+repositories are found with a suffix of @code{.git}, this suffix will be
+removed for the URL and name.
+
+El valor predeterminado es @samp{#f}
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} integer renamelimit
+Maximum number of files to consider when detecting renames.
+
+Defaults to @samp{-1}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string repository-sort
+The way in which repositories in each section are sorted.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} robots-list robots
+Text used as content for the @code{robots} meta-tag.
+
+Defaults to @samp{("noindex" "nofollow")}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string root-desc
+Text printed below the heading on the repository index page.
+
+Defaults to @samp{"a fast webinterface for the git dscm"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string root-readme
+The content of the file specified with this option will be included verbatim
+below thef "about" link on the repository index page.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string root-title
+Text printed as heading on the repository index page.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean scan-hidden-path
+If set to @samp{#t} and repository-directory is enabled,
+repository-directory will recurse into directories whose name starts with a
+period. Otherwise, repository-directory will stay away from such
+directories, considered as "hidden". Note that this does not apply to the
+".git" directory in non-bare repos.
+
+El valor predeterminado es @samp{#f}
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} list snapshots
+Text which specifies the default set of snapshot formats that cgit generates
+links for.
+
+Defaults to @samp{()}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} repository-directory
repository-directory
+Name of the directory to scan for repositories (represents
address@hidden).
+
+Defaults to @samp{"/srv/git"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string section
+The name of the current repository section - all repositories defined after
+this option will inherit the current section name.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string section-sort
+Flag which, when set to @samp{1}, will sort the sections on the repository
+listing by name.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} integer section-from-path
+A number which, if defined prior to repository-directory, specifies how many
+path elements from each repo path to use as a default section name.
+
+El valor predeterminado es @samp{0}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} boolean side-by-side-diffs?
+If set to @samp{#t} shows side-by-side diffs instead of unidiffs per
+default.
+
+El valor predeterminado es @samp{#f}
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} file-object source-filter
+Specifies a command which will be invoked to format plaintext blobs in the
+tree view.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} integer summary-branches
+Specifies the number of branches to display in the repository "summary"
+view.
+
+Defaults to @samp{10}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} integer summary-log
+Specifies the number of log entries to display in the repository "summary"
+view.
+
+Defaults to @samp{10}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} integer summary-tags
+Specifies the number of tags to display in the repository "summary" view.
+
+Defaults to @samp{10}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string strict-export
+Filename which, if specified, needs to be present within the repository for
+cgit to allow access to that repository.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} string virtual-root
+URL which, if specified, will be used as root for all cgit links.
+
+Defaults to @samp{"/"}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} repository-cgit-configuration-list
repositories
+A list of @dfn{cgit-repo} records to use with config.
+
+Defaults to @samp{()}.
+
+Available @code{repository-cgit-configuration} fields are:
+
address@hidden address@hidden parameter} repo-list snapshots
+A mask of snapshot formats for this repo that cgit generates links for,
+restricted by the global @code{snapshots} setting.
+
+Defaults to @samp{()}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} repo-file-object source-filter
+Override the default @code{source-filter}.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} repo-string url
+The relative URL used to access the repository.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} repo-file-object about-filter
+Override the default @code{about-filter}.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} repo-string branch-sort
+Flag which, when set to @samp{age}, enables date ordering in the branch ref
+list, and when set to @samp{name} enables ordering by branch name.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} repo-list clone-url
+A list of URLs which can be used to clone repo.
+
+Defaults to @samp{()}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} repo-file-object commit-filter
+Override the default @code{commit-filter}.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} repo-string commit-sort
+Flag which, when set to @samp{date}, enables strict date ordering in the
+commit log, and when set to @samp{topo} enables strict topological ordering.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} repo-string defbranch
+The name of the default branch for this repository. If no such branch
+exists in the repository, the first branch name (when sorted) is used as
+default instead. By default branch pointed to by HEAD, or "master" if there
+is no suitable HEAD.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} repo-string desc
+The value to show as repository description.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} repo-string homepage
+The value to show as repository homepage.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} repo-file-object email-filter
+Override the default @code{email-filter}.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-repo-boolean enable-commit-graph?
+A flag which can be used to disable the global setting
address@hidden
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-repo-boolean
enable-log-filecount?
+A flag which can be used to disable the global setting
address@hidden
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-repo-boolean
enable-log-linecount?
+A flag which can be used to disable the global setting
address@hidden
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-repo-boolean
enable-remote-branches?
+Flag which, when set to @code{#t}, will make cgit display remote branches in
+the summary and refs views.
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-repo-boolean
enable-subject-links?
+A flag which can be used to override the global setting
address@hidden
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} maybe-repo-boolean enable-html-serving?
+A flag which can be used to override the global setting
address@hidden
+
+Defaults to @samp{disabled}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} repo-boolean hide?
+Flag which, when set to @code{#t}, hides the repository from the repository
+index.
+
+El valor predeterminado es @samp{#f}
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} repo-boolean ignore?
+Flag which, when set to @samp{#t}, ignores the repository.
+
+El valor predeterminado es @samp{#f}
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} repo-file-object logo
+URL which specifies the source of an image which will be used as a logo on
+this repo’s pages.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} repo-string logo-link
+URL loaded when clicking on the cgit logo image.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} repo-file-object owner-filter
+Override the default @code{owner-filter}.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} repo-string module-link
+Text which will be used as the formatstring for a hyperlink when a submodule
+is printed in a directory listing. The arguments for the formatstring are
+the path and SHA1 of the submodule commit.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} module-link-path module-link-path
+Text which will be used as the formatstring for a hyperlink when a submodule
+with the specified subdirectory path is printed in a directory listing.
+
+Defaults to @samp{()}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} repo-string max-stats
+Override the default maximum statistics period.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} repo-string name
+El valor a mostrar como nombre del repositorio.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} repo-string owner
+A value used to identify the owner of the repository.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} repo-string path
+La ruta absoluta al directorio del repositorio.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} repo-string readme
+A path (relative to repo) which specifies a file to include verbatim as the
+"About" page for this repo.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} repo-string section
+The name of the current repository section - all repositories defined after
+this option will inherit the current section name.
+
+El valor predeterminado es @samp{""}.
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} repo-list extra-options
+Extra options will be appended to cgitrc file.
+
+Defaults to @samp{()}.
+
address@hidden deftypevr
+
address@hidden deftypevr
+
address@hidden address@hidden parameter} list extra-options
+Extra options will be appended to cgitrc file.
+
+Defaults to @samp{()}.
+
address@hidden deftypevr
+
+
address@hidden %end of fragment
+
+However, it could be that you just want to get a @code{cgitrc} up and
+running. In that case, you can pass an @code{opaque-cgit-configuration} as
+a record to @code{cgit-service-type}. As its name indicates, an opaque
+configuration does not have easy reflective capabilities.
+
+Available @code{opaque-cgit-configuration} fields are:
+
address@hidden address@hidden parameter} package cgit
+El paquete cgit.
address@hidden deftypevr
+
address@hidden address@hidden parameter} string string
+The contents of the @code{cgitrc}, as a string.
address@hidden deftypevr
+
+For example, if your @code{cgitrc} is just the empty string, you could
+instantiate a cgit service like this:
+
address@hidden
+(service cgit-service-type
+ (opaque-cgit-configuration
+ (cgitrc "")))
address@hidden example
+
address@hidden Servicio Gitolite
+
address@hidden servicio Gitolite
address@hidden Git, alojamiento
address@hidden://gitolite.com/gitolite/, Gitolite} is a tool for hosting Git
+repositories on a central server.
+
+Gitolite can handle multiple repositories and users, and supports flexible
+configuration of the permissions for the users on the repositories.
+
+The following example will configure Gitolite using the default @code{git}
+user, and the provided SSH public key.
+
address@hidden
+(service gitolite-service-type
+ (gitolite-configuration
+ (admin-pubkey (plain-file
+ "sunombre.pub"
+ "ssh-rsa AAAA... guix@@example.com"))))
address@hidden example
+
+Gitolite is configured through a special admin repository which you can
+clone, for example, if you setup Gitolite on @code{example.com}, you would
+run the following command to clone the admin repository.
+
address@hidden
+git clone git@@example.com:gitolite-admin
address@hidden example
+
+When the Gitolite service is activated, the provided @code{admin-pubkey}
+will be inserted in to the @file{keydir} directory in the gitolite-admin
+repository. If this results in a change in the repository, it will be
+committed using the message ``gitolite setup by GNU Guix''.
+
address@hidden {Tipo de datos} gitolite-configuration
+Tipo de datos que representa la configuración de
address@hidden
+
address@hidden @asis
address@hidden @code{package} (predeterminado: @var{gitolite})
+Paquete Gitolite usado.
+
address@hidden @code{user} (predeterminado: @var{git})
+User to use for Gitolite. This will be user that you use when accessing
+Gitolite over SSH.
+
address@hidden @code{group} (predeterminado: @var{git})
+Grupo usado por Gitolite.
+
address@hidden @code{home-directory} (predeterminado: @var{"/var/lib/gitolite"})
+Directory in which to store the Gitolite configuration and repositories.
+
address@hidden @code{rc-file} (predeterminado: @var{(gitolite-rc-file)})
+A ``file-like'' object (@pxref{Expresiones-G, file-like objects}),
+representing the configuration for Gitolite.
+
address@hidden @code{admin-pubkey} (predeterminada: @var{#f})
+A ``file-like'' object (@pxref{Expresiones-G, file-like objects}) used to
+setup Gitolite. This will be inserted in to the @file{keydir} directory
+within the gitolite-admin repository.
+
+To specify the SSH key as a string, use the @code{plain-file} function.
+
address@hidden
+(plain-file "yourname.pub" "ssh-rsa AAAA... guix@@example.com")
address@hidden example
+
address@hidden table
address@hidden deftp
+
address@hidden {Tipo de datos} gitolite-rc-file
+Tipo de datos que representa el fichero RC de Gitolite.
+
address@hidden @asis
address@hidden @code{umask} (predeterminada: @code{#o0077})
+This controls the permissions Gitolite sets on the repositories and their
+contents.
+
+A value like @code{#o0027} will give read access to the group used by
+Gitolite (by default: @code{git}). This is necessary when using Gitolite
+with software like cgit or gitweb.
+
address@hidden @code{git-config-keys} (predeterminadas: @code{""})
+Gitolite allows you to set git config values using the "config"
+keyword. This setting allows control over the config keys to accept.
+
address@hidden @code{roles} (predeterminados: @code{'(("READERS" . 1)
("WRITERS" . ))})
+Set the role names allowed to be used by users running the perms command.
+
address@hidden @code{enable} (default: @code{'("help" "desc" "info" "perms"
"writable" "ssh-authkeys" "git-config" "daemon" "gitweb")})
+This setting controls the commands and features to enable within Gitolite.
+
address@hidden table
address@hidden deftp
+
+
address@hidden Servicios de juegos
address@hidden Servicios de juegos
+
address@hidden El servicio de La batalla por Wesnoth
address@hidden wesnothd
address@hidden://wesnoth.org, La batalla por Wesnoth} es un juego de estrategia
+táctica, de fantasía y basado en turnos, con varias campañas de una
+jugadora, y partidas para múltiples jugadoras (tanto en red como
+localmente).
+
address@hidden {Variable Scheme} wesnothd-service-type
+Service type for the wesnothd service. Its value must be a
address@hidden object. To run wesnothd in the default
+configuration, instantiate it as:
+
address@hidden
+(service wesnothd-service-type)
address@hidden example
address@hidden defvar
+
address@hidden {Tipo de datos} wesnothd-configuration
+Tipo de datos que representa la configuración de @command{wesnothd}.
+
address@hidden @asis
address@hidden @code{package} (predeterminado: @code{wesnoth-server})
+El paquete del servidor wesnoth usado.
+
address@hidden @code{port} (predeterminado: @code{15000})
+Número de puerto usado por el servidor.
address@hidden table
address@hidden deftp
+
address@hidden Servicios misceláneos
address@hidden Servicios misceláneos
+
address@hidden huella dactilar
address@hidden Servicios de huella dactilar
+
+The @code{(gnu services authentication)} module provides a DBus service to
+read and identify fingerprints via a fingerprint sensor.
+
address@hidden {Variable Scheme} fprintd-service-type
+The service type for @command{fprintd}, which provides the fingerprint
+reading capability.
+
address@hidden
+(service fprintd-service-type)
address@hidden example
address@hidden defvr
+
address@hidden sysctl
address@hidden Servicios de control del sistema
+
+The @code{(gnu services sysctl)} provides a service to configure kernel
+parameters at boot.
+
address@hidden {Variable Scheme} 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:
+
address@hidden
+(service sysctl-service-type
+ (sysctl-configuration
+ (settings '(("net.ipv4.ip_forward" . "1")))))
address@hidden example
address@hidden defvr
+
address@hidden {Tipo de datos} sysctl-configuration
+Tipo de datos que representa la configuración de @command{sysctl}.
+
address@hidden @asis
address@hidden @code{sysctl} (predeterminado: @code{(file-append procps
"/sbin/sysctl"})
+El ejecutable @command{sysctl} usado.
+
address@hidden @code{settings} (predeterminados: @code{'()})
+An association list specifies kernel parameters and their values.
address@hidden table
address@hidden deftp
+
address@hidden pcscd
address@hidden Servicio del daemon de tarjetas inteligentes PC/SC
+
+The @code{(gnu services security-token)} module provides the following
+service to run @command{pcscd}, the PC/SC Smart Card Daemon.
address@hidden is the daemon program for pcsc-lite and the MuscleCard
+framework. It is a resource manager that coordinates communications with
+smart card readers, smart cards and cryptographic tokens that are connected
+to the system.
+
address@hidden {Variable Scheme} pcscd-service-type
+Service type for the @command{pcscd} service. Its value must be a
address@hidden object. To run pcscd in the default
+configuration, instantiate it as:
+
address@hidden
+(service pcscd-service-type)
address@hidden example
address@hidden defvr
+
address@hidden {Tipo de datos} pcscd-configuration
+The data type representing the configuration of @command{pcscd}.
+
address@hidden @asis
address@hidden @code{pcsc-lite} (predeterminado: @code{pcsc-lite})
+The pcsc-lite package that provides pcscd.
address@hidden @code{usb-drivers} (predeterminado: @code{(list ccid)})
+List of packages that provide USB drivers to pcscd. Drivers are expected to
+be under @file{pcsc/drivers} in the store directory of the package.
address@hidden table
address@hidden deftp
+
address@hidden lirc
address@hidden Servicio Lirc
+
+El módulo @code{(gnu services lirc)} proporciona el siguiente servicio.
+
address@hidden {Procedimiento Scheme} lirc-service [#:lirc lirc] @
+ [#:device #f] [#:driver #f] [#:config-file #f] @ [#:extra-options '()]
+Return a service that runs @url{http://www.lirc.org,LIRC}, a daemon that
+decodes infrared signals from remote controls.
+
+Optionally, @var{device}, @var{driver} and @var{config-file} (configuration
+file name) may be specified. See @command{lircd} manual for details.
+
+Finally, @var{extra-options} is a list of additional command-line options
+passed to @command{lircd}.
address@hidden deffn
+
address@hidden spice
address@hidden Servicio Spice
+
+El módulo @code{(gnu services spice)} proporciona el siguiente servicio.
+
address@hidden {Procedimiento Scheme} spice-vdagent-service [#:spice-vdagent]
+Returns a service that runs @url{http://www.spice-space.org,VDAGENT}, a
+daemon that enables sharing the clipboard with a vm and setting the guest
+display resolution when the graphical console window resizes.
address@hidden deffn
+
address@hidden inputattach
address@hidden inputattach Service
+
address@hidden tablet input, for Xorg
address@hidden touchscreen input, for Xorg
+The @uref{https://linuxwacom.github.io/, inputattach} service allows you to
+use input devices such as Wacom tablets, touchscreens, or joysticks with the
+Xorg display server.
+
address@hidden {Scheme Variable} inputattach-service-type
+Type of a service that runs @command{inputattach} on a device and dispatches
+events from it.
address@hidden deffn
+
address@hidden {Data Type} inputattach-configuration
address@hidden @asis
address@hidden @code{device-type} (default: @code{"wacom"})
+The type of device to connect to. Run @command{inputattach --help}, from
+the @code{inputattach} package, to see the list of supported device types.
+
address@hidden @code{device} (default: @code{"/dev/ttyS0"})
+The device file to connect to the device.
+
address@hidden @code{log-file} (default: @code{#f})
+If true, this must be the name of a file to log messages to.
address@hidden table
address@hidden deftp
+
address@hidden Servicios de diccionario
address@hidden diccionario
+El módulo @code{(gnu services dict)} proporciona el servicio siguiente:
+
address@hidden {Procedimiento Scheme} dicod-service [#:config
(dicod-configuration)]
+Devuelve un servicio que ejecuta el daemon @command{dicod}, una
+implementación del servidor DICT (@pxref{Dicod,,, dico, GNU Dico Manual}).
+
+El parámetro opcional @var{config} especifica la configuración para
address@hidden, que debe ser un objeto @code{<dicod-configuration>}, por
+defecto proporciona el diccionario colaborativo internacional de Inglés de
+GNU.
+
+You can add @command{open localhost} to your @file{~/.dico} file to make
address@hidden the default server for @command{dico} client
+(@pxref{Initialization File,,, dico, GNU Dico Manual}).
address@hidden deffn
+
address@hidden {Tipo de datos} dicod-configuration
+Tipo de datos que representa la configuración de dicod.
+
address@hidden @asis
address@hidden @code{dico} (predeterminado: @var{dico})
+Package object of the GNU Dico dictionary server.
+
address@hidden @code{interfaces} (predeterminada: @var{'("localhost")})
+This is the list of IP addresses and ports and possibly socket file names to
+listen to (@pxref{Server Settings, @code{listen} directive,, dico, GNU Dico
+Manual}).
+
address@hidden @code{handlers} (predeterminados: @var{'()})
+List of @code{<dicod-handler>} objects denoting handlers (module instances).
+
address@hidden @code{databases} (predeterminada: @var{(list
%dicod-database:gcide)})
+List of @code{<dicod-database>} objects denoting dictionaries to be served.
address@hidden table
address@hidden deftp
+
address@hidden {Tipo de datos} dicod-handler
+Data type representing a dictionary handler (module instance).
+
address@hidden @asis
address@hidden @code{name}
+Name of the handler (module instance).
+
address@hidden @code{module} (predeterminado: @var{#f})
+Name of the dicod module of the handler (instance). If it is @code{#f}, the
+module has the same name as the handler. (@pxref{Módulos,,, dico, GNU Dico
+Manual}).
+
address@hidden @code{options}
+List of strings or gexps representing the arguments for the module handler
address@hidden table
address@hidden deftp
+
address@hidden {Tipo de datos} dicod-database
+Tipo de datos que representa una base de datos de diccionario.
+
address@hidden @asis
address@hidden @code{name}
+Nombre de la base de datos, será usada en las órdenes DICT.
+
address@hidden @code{handler}
+Name of the dicod handler (module instance) used by this database
+(@pxref{Handlers,,, dico, GNU Dico Manual}).
+
address@hidden @code{complex?} (predeterminado: @var{#f})
+Whether the database configuration complex. The complex configuration will
+need a corresponding @code{<dicod-handler>} object, otherwise not.
+
address@hidden @code{options}
+List of strings or gexps representing the arguments for the database
+(@pxref{Databases,,, dico, GNU Dico Manual}).
address@hidden table
address@hidden deftp
+
address@hidden {Variable Scheme} %dicod-database:gcide
+A @code{<dicod-database>} object serving the GNU Collaborative International
+Dictionary of English using the @code{gcide} package.
address@hidden defvr
+
+The following is an example @code{dicod-service} configuration.
+
address@hidden
+(dicod-service #:config
+ (dicod-configuration
+ (handlers (list (dicod-handler
+ (name "wordnet")
+ (module "dictorg")
+ (options
+ (list #~(string-append "dbdir=" #$wordnet))))))
+ (databases (list (dicod-database
+ (name "wordnet")
+ (complex? #t)
+ (handler "wordnet")
+ (options '("database=wn")))
+ %dicod-database:gcide))))
address@hidden example
+
address@hidden Docker
address@hidden Docker Service
+
+The @code{(gnu services docker)} module provides the following service.
+
address@hidden {Scheme Variable} docker-service-type
+
+This is the type of the service that runs
address@hidden://www.docker.com,Docker}, a daemon that can execute application
+bundles (sometimes referred to as ``containers'') in isolated environments.
+
address@hidden defvr
+
address@hidden {Data Type} docker-configuration
+This is the data type representing the configuration of Docker and
+Containerd.
+
address@hidden @asis
+
address@hidden @code{package} (default: @code{docker})
+The Docker package to use.
+
address@hidden @code{containerd} (default: @var{containerd})
+The Containerd package to use.
+
address@hidden table
address@hidden deftp
+
address@hidden Programas con setuid
address@hidden Programas con setuid
+
address@hidden programas con setuid
+Algunos programas necesitan ejecutarse con privilegios de ``root'', incluso
+cuando se ejecutan por usuarias sin privilegios. Un ejemplo notable es el
+programa @command{passwd}, que las usuarias ejecutan para cambiar su
+contraseña, y que necesita acceso a los ficheros @file{/etc/passwd} y
address@hidden/etc/shadow}---algo normalmente restringido a root, por razones de
+seguridad obvias. Para solventarlo, estos ejecutables tienen @dfn{setuid de
+root}, lo que significa que siempre se ejecutan con privilegios de root
+(@pxref{How Change Persona,,, libc, The GNU C Library Reference Manual},
+para más información sobre el mecanismo setuid).
+
+El almacén en sí @emph{no puede} contener programas setuid: sería un
+problema de seguridad puesto que cualquier usuaria del sistema puede
+escribir derivaciones que pueblen el almacén (@pxref{El almacén}). Por tanto,
+se usa un mecanismo diferente: en vez de cambiar el bit de setuid
+directamente en los ficheros que se encuentran en el almacén, se permite que
+la administradora del sistema @emph{declare} qué programas deberían tener
+setuid de root.
+
+El campo @code{setuid-programs} de una declaración @code{operating-system}
+contiene una lista de expresiones-G que denotan nombres de programas que
+tendrán setuid de root (@pxref{Uso de la configuración del sistema}). Por
+ejemplo, el programa @command{passwd}, que es parte del paquete Shadow,
+puede designarse con esta expresión-G (@pxref{Expresiones-G}):
+
address@hidden
+#~(string-append #$shadow "/bin/passwd")
address@hidden example
+
+Un conjunto predeterminado de programas con el bit setuid se define en la
+variable @code{%setuid-programs} del módulo @code{(gnu system)}.
+
address@hidden {Variable Scheme} %setuid-programs
+Una lista de expresiones-G que denotan programas comunes que se marcan con
+setuid de root.
+
+La lista incluye órdenes como @command{passwd}, @command{ping}, @command{su}
+y @command{sudo}.
address@hidden defvr
+
+Para su implementación, los programas con setuid reales se crean en el
+directorio @file{/run/setuid-programs} durante la activación del
+sistema. Los ficheros en este directorio hacen referencia a los binarios
+``reales'', que estan en el almacén.
+
address@hidden Certificados X.509
address@hidden Certificados X.509
+
address@hidden HTTPS, certificados
address@hidden certificados X.509
address@hidden TLS
+En las conexiones HTTPS a servidores Web (esto es, HTTP sobre el mecanismo
+de seguridad de la capa de transporte, TLS) se envía a los programas
+clientes un @dfn{certificado X.509} que el cliente puede usar para
address@hidden al servidor. Para hacerlo, los clientes verifican que el
+certificado del servidor está firmado por una de las llamadas
address@hidden de certificación} (AC, CA en inglés). Pero para verificar
+la firma de una AC, los clientes deben haber obtenido previamente el
+certificado de dicha AC.
+
+Los navegadores Web como address@hidden incluyen su propio conjunto de
+certificados de AC, de manera que pueden verificar las firmas
+independientemente.
+
+No obstante, a la mayor parte de otros programas que pueden comunicarse a
+través de address@hidden, @command{git}, @command{w3m}, etc.---se
+les debe informar de dónde pueden encontrar los certificados de CA.
+
address@hidden @code{nss-certs}
+In Guix, this is done by adding a package that provides certificates to the
address@hidden field of the @code{operating-system} declaration
+(@pxref{Referencia de ``operating-system''}). Guix includes one such package,
address@hidden, which is a set of CA certificates provided as part of
+Mozilla's Network Security Services.
+
+Fíjese que @emph{no} es parte de @var{%base-packages}, por lo que debe ser
+añadido explícitamente. El directorio @file{/etc/ssl/certs}, donde la mayor
+parte de las aplicaciones y bibliotecas buscarán los certificados de manera
+predeterminada, enlaza a los certificados instalados de manera global.
+
+Las usuarias sin privilegios, incluyendo a usuarias de Guix en una
+distribución distinta, pueden también instalar su propio paquete de
+certificados en su perfil. Es necesario definir cierto número de variables
+de entorno de manera que las aplicaciones y bibliotecas sepan dónde
+encontrarlos. Por ejemplo, la biblioteca OpenSSL inspecciona las variables
address@hidden y @code{SSL_CERT_FILE}. Algunas aplicaciones añaden sus
+variables de entorno propias; por ejemplo, el sistema de control de
+versiones Git inspecciona el empaquetado de certificados al que apunta la
+variable de entorno @code{GIT_SSL_CAINFO}. Por tanto, en el caso típico se
+debe ejecutar algo parecido a esto:
+
address@hidden
+$ guix package -i nss-certs
+$ export SSL_CERT_DIR="$HOME/.guix-profile/etc/ssl/certs"
+$ export SSL_CERT_FILE="$HOME/.guix-profile/etc/ssl/certs/ca-certificates.crt"
+$ export GIT_SSL_CAINFO="$SSL_CERT_FILE"
address@hidden example
+
+Como otro ejemplo, R necesita que la variable de entorno
address@hidden apunte al empaquetado de certificados, de manera que
+se debe ejecutar algo parecido a esto:
+
address@hidden
+$ guix package -i nss-certs
+$ export CURL_CA_BUNDLE="$HOME/.guix-profile/etc/ssl/certs/ca-certificates.crt"
address@hidden example
+
+Para otras aplicaciones puede tener que buscar la variable de entorno
+necesaria en la documentación relevante.
+
+
address@hidden Selector de servicios de nombres
address@hidden Selector de servicios de nombres
+
address@hidden name service switch
address@hidden NSS
+El módulo @code{(gnu system nss)} proporciona una interfaz con el fichero de
+configuración del @dfn{selector de servicios de nombres} o @dfn{NSS}
+(@pxref{NSS Configuration File,,, libc, The GNU C Library Reference
+Manual}). En resumen, NSS es un mecanismo que permite la extensión de libc
+con nuevos métodos de búsqueda de ``nombres'', lo que incluye nombres de
+máquinas, nombres de servicios, cuentas de usuaria y más (@pxref{Selector de
servicios de nombres, System Databases and Name Service Switch,, libc, The GNU C
+Library Reference Manual}).
+
+La configuración de NSS especifica, para cada base de datos del sistema, que
+método de búsqueda debe ser usado, y cómo los varios métodos se enlazan
+entre sí---por ejemplo, bajo qué circunstancias NSS deberá probar con el
+siguiente método en la lista. La configuración de NSS se proporciona en el
+campo @code{name-service-switch} de las declaraciones
address@hidden (@pxref{Referencia de ``operating-system'',
address@hidden).
+
address@hidden nss-mdns
address@hidden .local, búsqueda de nombres de máquina
+Como ejemplo, la siguiente declaración configura NSS para usar el
address@hidden://0pointer.de/lennart/projects/nss-mdns/, motor @code{nss-mdns}},
+que permite las búsquedas de nombres de máquinas sobre DNS multicast (mDNS)
+para nombres de máquinas terminados en @code{.local}:
+
address@hidden
+(name-service-switch
+ (hosts (list %files ;primero, comprueba /etc/hosts
+
+ ;; Si lo anterior no funcionó, prueba
+ ;; con 'mdns_minimal'.
+ (name-service
+ (name "mdns_minimal")
+
+ ;; 'mdns_minimal' tiene autoridad sobre
+ ;; '.local'. Cuando devuelve 'not-found,
+ ;; no es necesario intentarlo con los
+ ;; métodos siguientes.
+ (reaction (lookup-specification
+ (not-found => return))))
+
+ ;; Si no, usa DNS.
+ (name-service
+ (name "dns"))
+
+ ;; Finalmente, prueba con 'mdns' "al completo".
+ (name-service
+ (name "mdns")))))
address@hidden example
+
+No se preocupe: la variable @code{%mdns-host-lookup-nss} (véase a
+continuación) contiene esta configuración, de manera que no tiene que
+escribirla si todo lo que desea es que funcione la búsqueda de nombres de
+máquina en @code{.local}.
+
+Note that, in this case, in addition to setting the
address@hidden of the @code{operating-system} declaration, you
+also need to use @code{avahi-service-type} (@pxref{Servicios de red,
address@hidden), or @var{%desktop-services}, which includes it
+(@pxref{Servicios de escritorio}). Doing this makes @code{nss-mdns}
accessible to
+the name service cache daemon (@pxref{Servicios base, @code{nscd-service}}).
+
+Por conveniencia, las siguientes variables proporcionan configuraciones NSS
+típicas.
+
address@hidden {Variable Scheme} %default-nss
+Esta es la configuración predeterminada del selector de servicios de
+nombres, un objeto @code{name-service-switch}.
address@hidden defvr
+
address@hidden {Variable Scheme} %mdns-host-lookup-nss
+Esta es la configuración del selector de servicios de nombres que permite la
+búsqueda de nombres de máquinas por DNS multicast (mDNS) para nombres de
+máquinas terminados en @code{.local}.
address@hidden defvr
+
+La referencia de la configuración del selector de servicios de nombres se
+proporciona a continuación. Tiene una asociación directa con el formato del
+fichero de configuración de la biblioteca C, por lo que se recomienda el
+manual de la biblioteca C para obtener más información (@pxref{NSS
+Configuration File,,, libc, The GNU C Library Reference Manual}). En
+comparación con el formato del fichero de configuración del NSS de libc, no
+solo tiene solo la ventaja de la cálida sensación proporcionada por la
+adición de paréntesis que tanto nos gustan, sino que también tiene
+comprobaciones estáticas: conocerá los errores sintácticos y tipográficos
+con la ejecución de @command{guix system}.
+
address@hidden {Tipo de datos} name-service-switch
+
+El tipo de datos que representa la configuración del selector de servicios
+de nombres (NSS). Cada campo a continuación representa una de las bases de
+datos del sistema admitidas.
+
address@hidden @code
address@hidden aliases
address@hidden ethers
address@hidden group
address@hidden gshadow
address@hidden hosts
address@hidden initgroups
address@hidden netgroup
address@hidden networks
address@hidden password
address@hidden public-key
address@hidden rpc
address@hidden services
address@hidden shadow
+Las bases de datos del sistema que maneja el NSS. Cada uno de estos campos
+debe ser una lista de objetos @code{<name-service>} (véase a continuación).
address@hidden table
address@hidden deftp
+
address@hidden {Tipo de datos} name-service
+
+Este es el tipo de datos que representa un servicio de nombres real y la
+acción de búsqueda asociada.
+
address@hidden @code
address@hidden name
+Una cadena que denota el nombre de servicio (@pxref{Services in the NSS
+configuration,,, libc, The GNU C Library Reference Manual}).
+
+Fijese que los servicios de nombres enumerados aquí deben ser visibles para
+nscd. Esto se consigue mediante la adición del parámetro
address@hidden:name-services} a @code{nscd-service} con la lista de paquetes que
+proporcionan los servicios de nombres necesarios (@pxref{Servicios base,
address@hidden).
+
address@hidden reaction
+Una acción especificada mediante el uso del macro
address@hidden (@pxref{Actions in the NSS configuration,,,
+libc, The GNU C Library Reference Manual}). Por ejemplo:
+
address@hidden
+(lookup-specification (unavailable => continue)
+ (success => return))
address@hidden example
address@hidden table
address@hidden deftp
+
address@hidden Disco en RAM inicial
address@hidden Disco en RAM inicial
+
address@hidden initrd
address@hidden disco inicial de RAM
+Para el propósito del arranque inicial, se le proporciona al núcleo
+Linux-libre un @dfn{disco inicial de RAM}, o @dfn{initrd}. Un initrd
+contiene un sistema de ficheros raíz temporal así como un guión de
+inicialización. Este último es responsable del montaje del sistema de
+ficheros raíz real, así como de la carga de cualquier módulo del núcleo que
+pueda ser necesario para esta tarea.
+
+El campo @code{initrd-modules} de una declaración @code{operating-system} le
+permite especificar qué módulos del nucleo Linux-libre deben estar
+disponibles en el initrd. En particular, aquñi es donde se debe enumerar los
+módulos que controlen realmente el disco duro deonde su partición raíz se
+encuentre---aunque el valor predeterminado de @code{initrd-modules} debería
+cubrir la mayor parte de casos de uso. Por ejemplo, en caso de necesitar el
+módulo @code{megaraid_sas} además de los módulos predeterminados para poder
+acceder a sistema de ficheros raíz, se podría escribir:
+
address@hidden
+(operating-system
+ ;; @dots{}
+ (initrd-modules (cons "megaraid_sas" %base-initrd-modules)))
address@hidden example
+
address@hidden {Variable Scheme} %base-initrd-modules
+Esta es la lista de módulos del nucleo que se incluyen en el initrd
+predeterminado.
address@hidden defvr
+
+Más allá, si necesita personalizaciones de un nivel más bajo, el campo
address@hidden de una declaración @code{operating-system} le permite
+especificar qué initrd desea usar. El módulo @code{(gnu system
+linux-initrd)} proporciona tres formas de construir un initrd: el
+procedimiento de alto nivel @code{base-initrd} y los procedimientos de bajo
+nivel @code{raw-initrd} y @code{expression->initrd}.
+
+El procedimiento @code{base-initrd} está pensado para cubrir la mayor parte
+de usos comunes. Por ejemplo, si desea añadir algunos módulos del nucleo que
+deben cargarse durante el arranque, puede definir el campo @code{initrd} de
+la declaración de sistema operativo de esta forma:
+
address@hidden
+(initrd (lambda (sistemas-de-ficheros . resto)
+ ;; Crea un initrd estándar pero configura la red
+ ;; con los parámetros que QEMU espera por omisión.
+ (apply base-initrd sistemas-de-ficheros
+ #:qemu-networking? #t
+ resto)))
address@hidden example
+
+El procedimiento @code{base-initrd} también maneja casos de uso comunes que
+implican el uso del sistema en un anfitrión QEMU, o como un sistema ``live''
+con un sistema de ficheros raíz volátil.
+
+El procedimiento @code{base-initrd} se construye sobre el procedimiento
address@hidden Al contrario que @code{base-initrd}, @code{raw-initrd} no
+funciona a alto nivel, como sería intentar deducir qué módulos del nucleo y
+paquetes deben incluirse en el initrd. Un ejemplo de uso de
address@hidden es cuando una usuaria tiene personalizada una
+configuración del nucleo Linux y los módulos predeterminados del núcleo que
+incluye @code{base-initrd} no están disponibles.
+
+El disco inicial de RAM producido por @code{base-initrd} o @code{raw-initrd}
+inspecciona varias opciones proporcionadas por la línea de órdenes al núcleo
+Linux (esto es, argumentos pasados a través de la orden @code{linux} de
+GRUB, o de la opción @code{-append} de QEMU), notablemente:
+
address@hidden @code
address@hidden address@hidden
+Indica al disco de RAM inicial que cargue @var{arranque}, un fichero que
+contiene un programa Scheme, una vez haya montado el sistema de ficheros
+raíz.
+
+Guix uses this option to yield control to a boot program that runs the
+service activation programs and then spawns the address@hidden, the
+initialization system.
+
address@hidden address@hidden
+Monta @var{raíz} como el sistema de ficheros raíz. @var{raíz} puede ser un
+nombre de dispositivo como @code{/dev/sda1}, una etiqueta del sistema de
+ficheros o un UUID del sistema de ficheros.
+
address@hidden address@hidden
+Hace que @file{/run/booted-system} y @file{/run/current-system} apunten a
address@hidden
+
address@hidden address@hidden@dots{}
address@hidden módulo, lista negra
address@hidden lista negra, de módulos del núcleo
+Indica al disco inicial de RAM así como a la orden @command{modprobe} (del
+paquete kmod) que deben negarse a cargar @var{módulos}. @var{módulos} debe
+ser una lista separada por comas de nombres de módulos---por ejemplo,
address@hidden,9pnet}.
+
address@hidden --repl
+Inicia una sesión interactiva (REPL) desde el disco inicial de RAM antes de
+que intente cargar los módulos del núcleo y del montaje del sistema de
+ficheros raíz. Nuestro departamento comercial lo llama
address@hidden Como amante de Scheme, lo adorará. @xref{Using Guile
+Interactively,,, guile, GNU Guile Reference Manual}, para más información
+sobre sesiones interactivas Guile.
+
address@hidden table
+
+Now that you know all the features that initial RAM disks produced by
address@hidden and @code{raw-initrd} provide, here is how to use it and
+customize it further.
+
address@hidden initrd
address@hidden disco inicial de RAM
address@hidden {Procedimiento Scheme} raw-initrd @var{sistemas-de-ficheros} @
+ [#:linux-modules '()] [#:mapped-devices '()] @ [#:keyboard-layout #f] @
+[#:helper-packages '()] [#:qemu-networking? #f] [#:volatile-root? #f] Return
+a derivation that builds a raw initrd. @var{file-systems} is a list of file
+systems to be mounted by the initrd, possibly in addition to the root file
+system specified on the kernel command line via @code{--root}.
address@hidden is a list of kernel modules to be loaded at boot time.
address@hidden is a list of device mappings to realize before
address@hidden are mounted (@pxref{Dispositivos traducidos}).
address@hidden is a list of packages to be copied in the initrd. It
+may include @code{e2fsck/static} or other packages needed by the initrd to
+check the root file system.
+
+When true, @var{keyboard-layout} is a @code{<keyboard-layout>} record
+denoting the desired console keyboard layout. This is done before
address@hidden are set up and before @var{file-systems} are mounted
+such that, should the user need to enter a passphrase or use the REPL, this
+happens using the intended keyboard layout.
+
+Cuando @var{qemu-networking?} es verdadero, configura la red con los
+parámetros QEMU estándar. Cuando @var{virtio?} es verdadero, carga módulos
+adicionales para que la imagen en RAM pueda ser usada como un sistema
+virtualizado por QEMU con controladores paravirtualizados de E/S.
+
+Cuando @var{volatile-root?} es verdadero, el sistema de ficheros raíz tiene
+permisos de escritura pero cualquier cambio realizado se perderá.
address@hidden deffn
+
address@hidden {Procedimiento Scheme} base-initrd @var{sistemas-de-ficheros} @
+ [#:mapped-devices '()] [#:keyboard-layout #f] @ [#:qemu-networking? #f]
+[#:volatile-root? #f] @ [#:linux-modules '()] Return as a file-like object a
+generic initrd, with kernel modules taken from @var{linux}.
address@hidden is a list of file-systems to be mounted by the initrd,
+possibly in addition to the root file system specified on the kernel command
+line via @code{--root}. @var{mapped-devices} is a list of device mappings
+to realize before @var{file-systems} are mounted.
+
+When true, @var{keyboard-layout} is a @code{<keyboard-layout>} record
+denoting the desired console keyboard layout. This is done before
address@hidden are set up and before @var{file-systems} are mounted
+such that, should the user need to enter a passphrase or use the REPL, this
+happens using the intended keyboard layout.
+
address@hidden y @var{volatile-root?} funcionan como en
address@hidden
+
+El initrd incorpora automáticamente todos los módulos del nucleo necesarios
+para @var{sistemas-de-ficheros} y para las opciones proporcionadas. Módulos
+del nucleo adicionales pueden proporcionarse a través de
address@hidden Se añadirán al initrd y se cargarán en tiempo de
+arranque en el orden que aparezcan.
address@hidden deffn
+
+No es necesario decir que los initrd que producimos y usamos embeben un
+Guile enlazado estáticamente, y que el programa de inicialización es un
+programa Guile. Esto proporciona mucha flexibilidad. El procedimiento
address@hidden>initrd} construye un initrd de ese tipo, una vez
+proporcionado el programa a ejecutar en dicho initrd.
+
address@hidden {Procedimiento Scheme} expression->initrd @var{exp} @
+ [#:guile %guile-static-stripped] [#:name "guile-initrd"]
+Devuelve como un objeto tipo-fichero el initrd de Linux (un archivador cpio
+comprimido con gzip) que contiene @var{guile} y que evalua a @var{exp}, una
+expresión-G, al arranque. Todas las derivaciones a las que @var{exp} hace
+referencia se copian automáticamente en el initrd.
address@hidden deffn
+
address@hidden Configuración del gestor de arranque
address@hidden Configuración del gestor de arranque
+
address@hidden bootloader
address@hidden cargador de arranque
+
+El sistema operativo permite varios cargadores de arranque. El cargador de
+arranque se configura mediante el uso de la declaración
address@hidden Todos los campos de esta estructura son
+independientes del cargador de arranque excepto uno, @code{bootloader}, que
+indica el cargador de arranque a configurar e instalar.
+
+Algunos de los cargadores de arranque no inspeccionan todos los campos de
address@hidden Por ejemplo, el cargador de arranque
+extlinux no permite temas y por lo tanto ignora el campo @code{theme}.
+
address@hidden {Tipo de datos} bootloader-configuration
+El tipo de una declaración de configuración del cargador de arranque.
+
address@hidden @asis
+
address@hidden @code{bootloader}
address@hidden EFI, cargador de arranque
address@hidden UEFI, cargador de arranque
address@hidden BIOS, cargador de arranque
+El cargador de arranque a usar, como un objeto @code{bootloader}. De momento
+se aceptan @code{grub-bootloader}, @code{grub-efi-bootloader},
address@hidden y @code{u-boot-bootloader}.
+
address@hidden grub-efi-bootloader
address@hidden permite el arranque en sistemas modernos que usan
+la @dfn{interfaz extendida de firmware unificada} (UEFI). Es el que debería
+ser usado si la imagen de instalación contiene un directorio
address@hidden/sys/firmware/efi} cuando la arranca en su sistema.
+
address@hidden grub-bootloader
address@hidden permite el arranque en máquinas basadas en Intel en
+modo ``antiguo'' BIOS.
+
address@hidden ARM, cargadores de arranque
address@hidden AArch64, cargadores de arranque
+Los cargadores de arranque se describen en los módulos @code{(gnu bootloader
address@hidden)}. En particular, @code{(gnu bootloader u-boot)} contiene
+definiciones de cargadores de arranque para un amplio rango de sistemas ARM
+y AArch64, mediante el uso del @uref{http://www.denx.de/wiki/U-Boot/,
+cargador de arranque U-Boot}.
+
address@hidden @code{target}
+Una cadena que indica donde se instalará el cargador de arranque.
+
+La interpretación depende del cargador de arranque en cuestión. Para
address@hidden, por ejemplo, debe ser un nombre de dispositivo que
+entienda la orden @command{install} del cargador de arranque, como
address@hidden/dev/sda} o @code{(hd0)} (@pxref{Invoking grub-install,,, grub,
GNU
+GRUB Manual}). Para @code{grub-efi-bootloader}, debe apuntar al punto de
+montaje del sistema de ficheros EFI, habitualmente @file{/boot/efi}.
+
address@hidden @code{menu-entries} (predeterminadas: @code{()})
+Una lista posiblemente vacia de objetos @code{menu-entry} (véase a
+continuación), que indican entradas que deben aparecer en el menú del
+cargador de arranque, además de la entrada del sistema actual y la entrada
+que apunta a generaciones previas del sistema.
+
address@hidden @code{default-entry} (predeterminada: @code{0})
+El índice de la entrada del menú de arranque por omisión. El índice 0 es
+para la entrada del sistema actual.
+
address@hidden @code{timeout} (predeterminado: @code{5})
+El número de segundos que se esperará entrada por el teclado antes de
+arrancar. El valor 0 indica que se debe arrancar de forma inmediata, y -1
+que se debe esperar indefinidamente.
+
address@hidden keyboard layout, for the bootloader
address@hidden @code{keyboard-layout} (predeterminada: @code{#f})
+If this is @code{#f}, the bootloader's menu (if any) uses the default
+keyboard layout, usually address@hidden (``qwerty'').
+
+Otherwise, this must be a @code{keyboard-layout} object (@pxref{Distribución
de teclado}).
+
address@hidden Nota
+This option is currently ignored by bootloaders other than @code{grub} and
address@hidden
address@hidden quotation
+
address@hidden @code{theme} (predeterminado: @var{#f})
+El objeto del tema del cargador de arranque que describa el tema a usar. Si
+no se proporciona ningún tema, algunos cargadores de arranque pueden usar un
+tema por omisión, lo cual es cierto en GRUB.
+
address@hidden @code{terminal-outputs} (predeterminada: @code{'gfxterm})
+Los terminales de salida que se usarán para el menú de arranque, como una
+lista de símbolos. GRUB acepta los valores: @code{console}, @code{serial},
address@hidden@address@hidden, @code{gfxterm}, @code{vga_text}, @code{mda_text},
address@hidden y @code{pkmodem}. Este campo corresponde con la variable
address@hidden (@pxref{Simple configuration,,, grub, GNU GRUB
+manual}).
+
address@hidden @code{terminal-inputs} (predeterminadas: @code{'()})
+Los terminales de entrada que se usarán para el menú de arranque, como una
+lista de símbolos. Para GRUB, el valor predeterminado es el terminal nativo
+de la platafroma determinado en tiempo de ejecución. GRUB acepta los
+valores: @code{console}, @code{serial}, @address@hidden@}},
address@hidden y @code{usb_keyboard}. Este campo corresponde a la
+variable GRUB @code{GRUB_TERMINAL_INPUT} (@pxref{Simple configuration,,,
+grub,GNU GRUB manual}).
+
address@hidden @code{serial-unit} (predeterminada: @code{#f})
+La unidad serie usada por el cargador de arranque, como un entero del 0 al
+3. Para GRUB, se selecciona en tiempo de ejecución; actualmente GRUB
+selecciona 0 lo que corresponde a COM1 (@pxref{Serial terminal,,, grub,GNU
+GRUB manual}).
+
address@hidden @code{serial-speed} (predeterminada: @code{#f})
+La velocidad de la interfaz serie, como un entero. Para GRUB, el valor
+predeterminado se selecciona en tiempo de ejecución, actualmente GRUB
+selecciona address@hidden (@pxref{Serial terminal,,, grub,GNU GRUB manual}).
address@hidden table
+
address@hidden deftp
+
address@hidden arranque dual
address@hidden menú de arranque
+Si desease listar entradas adicionales para el menú de arranque a través del
+campo @code{menu-entries} mostrado previamente, deberá crearlas con la forma
address@hidden Por ejemplo, imagine que desea ser capaz de arrancar otra
+distribución (¡difícil de imaginar!), puede definir una entrada de menú de
+esta forma:
+
address@hidden
+(menu-entry
+ (label "La otra distribución")
+ (linux "/boot/old/vmlinux-2.6.32")
+ (linux-arguments '("root=/dev/sda2"))
+ (initrd "/boot/old/initrd"))
address@hidden example
+
+Los detalles se encuentran a continuación.
+
address@hidden {Tipo de datos} menu-entry
+El tipo de una entrada en el menú del cargador de arranque.
+
address@hidden @asis
+
address@hidden @code{label}
+La etiqueta a mostrar en el menú---por ejemplo, @code{"GNU"}.
+
address@hidden @code{linux}
+La imagen del núcleo Linux a arrancar, por ejemplo:
+
address@hidden
+(file-append linux-libre "/bzImage")
address@hidden example
+
+Con GRUB, también es posible especificar un dispositivo explícitamente
+mediante el uso de la convención de nombres de dispositivo de GRUB
+(@pxref{Naming convention,,, grub, GNU GRUB manual}), por ejemplo:
+
address@hidden
+"(hd0,msdos1)/boot/vmlinuz"
address@hidden example
+
+Si se especifica el dispositivo explícitamente como en el ejemplo anterior,
+el campo @code{device} se ignora completamente.
+
address@hidden @code{linux-arguments} (predeterminados: @code{()})
+La lista de parámetros extra de línea de órdenes para el núcleo Linux---por
+ejemplo, @code{("console=ttyS0")}.
+
address@hidden @code{initrd}
+Una expresión-G o una cadena que contiene el nombre de fichero del disco
+inicial en RAM a usar (@pxref{Expresiones-G}).
address@hidden @code{device} (predeterminado: @code{#f})
+El dispositivo donde se encuentran el núcleo y el initrd---es decir, para
+GRUB, @dfn{raíz} de esta entrada de menú (@pxref{root,,, grub, GNU GRUB
+manual}).
+
+Puede ser una etiqueta de sistema de ficheros (una cadena), un UUID de
+sistema de ficheros (un vector de bytes, @pxref{Sistemas de ficheros}), o
@code{#f},
+en cuyo caso el cargador de arranque buscará el dispositivo que contenga el
+fichero especificado por el campo @code{linux} (@pxref{search,,, grub, GNU
+GRUB manual}). @emph{No} debe ser un nombre de dispositivo del SO como
address@hidden/dev/sda1}.
+
address@hidden table
address@hidden deftp
+
address@hidden FIXME: Write documentation once it's stable.
+For now only GRUB has theme support. GRUB themes are created using the
address@hidden form, which is not documented yet.
+
address@hidden {Variable Scheme} %default-theme
+Este es el tema predeterminado de GRUB que usa el sistema operativo si no se
+especifica el campo @code{theme} en el registro
address@hidden
+
+Viene con una bonita imagen de fondo que muestra los logos de GNU y Guix.
address@hidden defvr
+
+
address@hidden Invocación de guix system
address@hidden Invocación de @code{guix system}
+
+Una vez haya escrito la declaración de sistema operativo como se ha visto en
+la sección previa, puede @dfn{instanciarse} mediante el uso de la orden
address@hidden system}. Su sinopsis es:
+
address@hidden
+guix system @address@hidden @var{acción} @var{fichero}
address@hidden example
+
address@hidden debe ser el nombre de un fichero que contenga una declaración
address@hidden @var{acción} especifica cómo se instancia el
+sistema operativo. Actualmente se permiten los siguientes valores:
+
address@hidden @code
address@hidden search
+Muestra las definiciones de tipos de servicio disponibles que corresponden
+con las expresiones regulares proporcionadas, ordenadas por relevancia:
+
address@hidden
+$ guix system search console font
+name: console-fonts
+location: gnu/services/base.scm:729:2
+extends: shepherd-root
+description: Install the given fonts on the specified ttys (fonts are
++ per virtual console on GNU/Linux). The value of this service is a list
++ of tty/font pairs like:
++
++ '(("tty1" . "LatGrkCyr-8x16"))
+relevance: 20
+
+name: mingetty
+location: gnu/services/base.scm:1048:2
+extends: shepherd-root
+description: Provide console login using the `mingetty' program.
+relevance: 2
+
+name: login
+location: gnu/services/base.scm:775:2
+extends: pam
+description: Provide a console log-in service as specified by its
++ configuration value, a `login-configuration' object.
+relevance: 2
+
address@hidden
address@hidden example
+
+Como con @command{guix package --search}, el resultado se obtiene en formato
address@hidden, lo que facilita el filtrado de la salida (@pxref{Top, GNU
+recutils databases,, recutils, GNU recutils manual}).
+
address@hidden reconfigure
+Build the operating system described in @var{file}, activate it, and switch
+to address@hidden action (and the related actions @code{switch-generation}
+and @code{roll-back}) are usable only on systems already running Guix
+System.}.
+
+This effects all the configuration specified in @var{file}: user accounts,
+system services, global package list, setuid programs, etc. The command
+starts system services specified in @var{file} that are not currently
+running; if a service is currently running this command will arrange for it
+to be upgraded the next time it is stopped (e.g.@: by @code{herd stop X} or
address@hidden restart X}).
+
+Esta orden crea una nueva generación cuyo número es el sucesor de la
+siguiente generación (como lo muestra @command{guix system
+list-generations}). Si esa generación ya existe, será sobreescrita. Este
+comportamiento es el mismo que el de @command{guix package} (@pxref{Invocación
de guix package}).
+
+También añade una entrada al cargador de arranque para la nueva
+configuración del sistema operativo---en caso de que no se proporcione la
+opción @option{--no-bootloader}. Con GRUB, mueve las entradas de
+configuraciones antiguas a un submenú, permitiendo la selección de una
+generación previa del sistema en tiempo de arranque en caso necesario.
+
address@hidden Nota
address@hidden The paragraph below refers to the problem discussed at
address@hidden
<http://lists.gnu.org/archive/html/guix-devel/2014-08/msg00057.html>.
+Es altamente recomendable ejecutar @command{guix pull} antes de la primera
+ejecución de @command{guix system reconfigure} (@pxref{Invocación de guix
pull}). No hacerlo puede ocasionar que se obtenga una versión más antigua de
+Guix una vez que @command{reconfigure} se haya completado.
address@hidden quotation
+
address@hidden switch-generation
address@hidden generaciones
+Cambia a una generación existente del sistema. Esta acción cambia
+atómicamente el perfil del sistema a la generación del sistema
+especificada. También redistribuye las entradas de sistema del menú de
+arranque existentes. Marca como predeterminada la entrada de la generación
+de sistema especificada y mueve las entradas de otras generaciones a un
+submenú, si el cargador de arranque lo permite. La próxima vez que se
+arranque el sistema, se usará la generación de sistema especificada.
+
+El cargador de arranque en sí no se reinstala durante esta orden. Por tanto,
+el cargador de arranque instalado se usa con un fichero de configuración
+actualizado.
+
+La generación deseada puede especificarse explícitamente con su numero de
+generación. Por ejemplo, la siguiente invocación cambiaría a la generación 7
+del sistema:
+
address@hidden
+guix system switch-generation 7
address@hidden example
+
+La generación deseada puede especificarse también de forma relativa a la
+generación actual con la forma @code{+N} o @code{-N}, donde @code{+3}
+significa ``3 generaciones después de la generación actual'', y @code{-1}
+significa ``1 generación antes de la generación actual''. Cuando se
+especifica un valor negativo como @code{-1} debe ir precedido de @code{--}
+para evitar que se analice como una opción. Por ejemplo:
+
address@hidden
+guix system switch-generation -- -1
address@hidden example
+
+Actualmente, el efecto de la invocación de esta acción es @emph{únicamente}
+cambiar el perfil del sistema a una generación existente y redistribuir las
+entradas del menú de arranque. Para realmente empezar a usar la generación
+deseada del sistema, debe reiniciar tras esta acción. En el futuro, se
+actualizará para hacer lo mismo que @command{reconfigure}, como activación y
+desactivación de servicios.
+
+Esta acción fallará si la generación especificada no existe.
+
address@hidden roll-back
address@hidden vuelta atrás
+Cambia a la generación de sistema previa. Tras el siguiente arranque del
+sistema, usará la generación de sistema precedente. Es la operación inversa
+de @command{reconfigure}, y es equivalente a la invocación de
address@hidden con @code{-1} como parámetro.
+
+Actualmente, como con @command{switch-generation}, debe reiniciar tras la
+ejecución de esta acción para realmente empezar a usar la generación de
+sistema precedente.
+
address@hidden delete-generations
address@hidden deleting system generations
address@hidden saving space
+Delete system generations, making them candidates for garbage collection
+(@pxref{Invocación de guix gc}, for information on how to run the ``garbage
+collector'').
+
+This works in the same way as @command{guix package --delete-generations}
+(@pxref{Invocación de guix package, @code{--delete-generations}}). With no
+arguments, all system generations but the current one are deleted:
+
address@hidden
+guix system delete-generations
address@hidden example
+
+You can also select the generations you want to delete. The example below
+deletes all the system generations that are more than two month old:
+
address@hidden
+guix system delete-generations 2m
address@hidden example
+
+Running this command automatically reinstalls the bootloader with an updated
+list of menu entries---e.g., the ``old generations'' sub-menu in GRUB no
+longer lists the generations that have been deleted.
+
address@hidden build
+Construye la derivación del sistema operativo, que incluye todos los
+ficheros de configuración y programas necesarios para el arranque y la
+ejecución del sistema. Esta acción no instala nada en realidad.
+
address@hidden init
+Populate the given directory with all the files necessary to run the
+operating system specified in @var{file}. This is useful for first-time
+installations of Guix System. For instance:
+
address@hidden
+guix system init mi-conf-del-so.scm /mnt
address@hidden example
+
+copia a @file{/mnt} todos los elementos del almacén necesarios para la
+configuración especificada en @file{mi-conf-del-so.scm}. Esto incluye los
+ficheros de configuración, paquetes y demás. También crea otros ficheros
+esenciales necesarios para la correcta operación del sistema---por ejemplo,
+los directorios @file{/etc}, @file{/var} y @file{/run}, y el fichero
address@hidden/bin/sh}.
+
+Esta orden también instala el cargador de arranque en el destino
+especificado en @file{mi-conf-del-so.scm}, siempre que no se proporcione la
+opción @option{--no-bootloader}.
+
address@hidden vm
address@hidden máquina virtual
address@hidden VM
address@hidden system vm}
+Build a virtual machine that contains the operating system declared in
address@hidden, and return a script to run that virtual machine (VM).
+
address@hidden Nota
+The @code{vm} action and others below can use KVM support in the Linux-libre
+kernel. Specifically, if the machine has hardware virtualization support,
+the corresponding KVM kernel module should be loaded, and the
address@hidden/dev/kvm} device node must exist and be readable and writable by
the
+user and by the build users of the daemon (@pxref{Configuración del entorno de
construcción}).
address@hidden quotation
+
+Arguments given to the script are passed to QEMU as in the example below,
+which enables networking and requests address@hidden of RAM for the emulated
+machine:
+
address@hidden
+$ /gnu/store/@dots{}-run-vm.sh -m 1024 -net user
address@hidden example
+
+La VM comparte su almacén con el sistema anfitrión.
+
+Sistemas de ficheros adicionales pueden compartirse entre la máquina
+anfitriona y la virtual mediante el uso de las opciones @code{--share} y
address@hidden: la primera especifica un directorio a compartir con acceso
+de escritura, mientras que la última proporciona solo acceso de lectura al
+directorio compartido.
+
+El siguiente ejemplo crea una máquina virtual en la que el directorio de la
+usuaria es accesible en modo solo-lecture, y donde el directorio
address@hidden/intercambio} esta asociado de forma lectura-escritura con
address@hidden/tmp} en el sistema anfitrión:
+
address@hidden
+guix system vm mi-configuracion.scm \
+ --expose=$HOME --share=$HOME/tmp=/intercambio
address@hidden example
+
+En GNU/Linux, lo predeterminado es arrancar directamente el núcleo; esto
+posee la ventaja de necesitar únicamente una pequeña imagen del disco raíz
+pequeña ya el el almacén de la anfitriona puede montarse.
+
+La opción @code{--full-boot} fuerza una secuencia de arranque completa,
+desde el cargador de arranque. Esto necesita más espacio en disco ya que la
+imagen raíz que contiene el núcleo, initrd y los ficheros de datos del
+cargador de arranque deben crearse. La opción @code{--image-size} puede
+usarse para especificar el tamaño de la imagen.
+
address@hidden Imágenes de sistema, creación en varios formatos
address@hidden Creación de imágenes del sistema en varios formatos
address@hidden vm-image
address@hidden disk-image
address@hidden docker-image
+Devuelve una máquina virtual, imagen de disco o imagen Docker del sistema
+operativo declarado en @var{fichero} que es independiente. Por omisión,
address@hidden system} estima el tamaño de la imagen necesario para almacenar
+el sistema, pero puede usar la opción @option{--image-size} para especificar
+un valor. Las imagenes Docker se construyen para que contengan exactamente
+lo que necesitan, por lo que la opción @option{--image-size} se ignora en el
+caso de @code{docker-image}.
+
+Puede especificar el sistema de ficheros raíz mediante el uso de la opción
address@hidden Su valor predeterminado es @code{ext4}.
+
+When using @code{vm-image}, the returned image is in qcow2 format, which the
+QEMU emulator can efficiently use. @xref{Ejecutar Guix en una máquina
virtual}, for more
+information on how to run the image in a virtual machine.
+
+Con @code{disk-image} se produce una imagen de disco cruda; puede copiarse
+tal cual en una memoria USB, por ejemplo. Asumiendo que @code{/dev/sdc} es
+el dispositivo que corresponde a la memoria USB, se podría copiar la imagen
+con la siguiente orden:
+
address@hidden
+# dd if=$(guix system disk-image mi-so.scm) of=/dev/sdc
address@hidden example
+
+Con @code{docker-image} se produce una imagen Docker. Guix construye la
+imagen de cero, no de una imagen Docker base preexistente. Como resultado,
+contiene @emph{exactamente} lo definido en el fichero de configuración del
+sistema operativo. Puede cargar la imagen y ejecutar un contenedor Docker
+mediante el uso de ordenes como las siguientes:
+
address@hidden
+image_id="$(docker load < guix-system-docker-image.tar.gz)"
+docker run -e GUIX_NEW_SYSTEM=/var/guix/profiles/system \\
+ --entrypoint /var/guix/profiles/system/profile/bin/guile \\
+ $image_id /var/guix/profiles/system/boot
address@hidden example
+
+This command starts a new Docker container from the specified image. It
+will boot the Guix system in the usual manner, which means it will start any
+services you have defined in the operating system configuration. Depending
+on what you run in the Docker container, it may be necessary to give the
+container additional permissions. For example, if you intend to build
+software using Guix inside of the Docker container, you may need to pass the
address@hidden option to @code{docker run}.
+
address@hidden container
+Devuelve un guión de la ejecución del sistema operativo declarado en
address@hidden dentro de un contenedor. Los contenedores son un conjunto de
+mecanismos de aislamiento ligeros que proporciona el núcleo Linux-libre. Los
+contenedores necesitan sustancialmente menos recursos que máquinas virtuales
+completas debido a que el núcleo, los objetos compartidos y otros recursos
+pueden compartirse con el sistema anfitrión; esto también significa que
+proporcionan un menor aislamiento.
+
+En este momento, el guión debe ejecutarse como root para permitir más de una
+única usuaria y grupo. El contenedor comparte su almacén con la máquina
+anfitriona.
+
+Como con la acción @code{vm} (@pxref{guix system vm}), sistemas de ficheros
+adicionales a compartir entre la máquina anfitriona y el contenedor pueden
+especificarse mediante el uso de las opciones @option{--share} y
address@hidden:
+
address@hidden
+guix system container mi-configuracion.scm \
+ --expose=$HOME --share=$HOME/tmp=/intercambio
address@hidden example
+
address@hidden Nota
+Esta opción requiere Linux-libre 3.19 o posterior.
address@hidden quotation
+
address@hidden table
+
address@hidden puede contener cualquiera de las opciones de construcción
+comunes (@pxref{Opciones comunes de construcción}). Además, @var{opciones}
puede
+contener una de las siguientes:
+
address@hidden @option
address@hidden address@hidden
address@hidden -e @var{expr}
+Consider the operating-system @var{expr} evaluates to. This is an
+alternative to specifying a file which evaluates to an operating system.
+This is used to generate the Guix system installer @pxref{Construcción de la
imagen de instalación}).
+
address@hidden address@hidden
address@hidden -s @var{sistema}
+Intenta la construcción para @var{sistema} en vez de para el tipo de la
+máquina anfitriona. Funciona como en @command{guix build} (@pxref{Invocación
de guix build}).
+
address@hidden --derivation
address@hidden -d
+Devuelve el nombre de fichero de la derivación del sistema operativo
+proporcionado sin construir nada.
+
address@hidden address@hidden
address@hidden -t @var{tipo}
+Para la acción @code{disk-image}, crea un sistema de ficheros del @var{tipo}
+proporcionado en la imagen.
+
+Cuando se omite esta opción, @command{guix system} usa @code{ext4}.
+
address@hidden ISO-9660, formato
address@hidden CD, formato de imagen
address@hidden DVD, formato de imagen
address@hidden produce una imagen ISO-9660, que puede ser
+grabada en CD y DVD.
+
address@hidden address@hidden
+Junto a las acciones @code{vm-image} y @code{disk-image}, crea una imagen
+del @var{ŧamaño} proporcionado. @var{tamaño} debe ser un número de bytes o
+puede incluir una unidad como sufijo (@pxref{Block size, size
+specifications,, coreutils, GNU Coreutils}).
+
+Cuando se omite esta opción, @command{guix system} calcula una estimación
+del tamaño de la imagen en función del tamaño del sistema declarado en
address@hidden
+
address@hidden address@hidden
address@hidden -r @var{fichero}
+Hace que @var{fichero} sea un enlace simbólico al resultado, y lo registra
+como una raíz del recolector de basura.
+
address@hidden --skip-checks
+Omite las comprobaciones de seguridad previas a la instalación.
+
+Por omisión, @command{guix system init} y @command{guix system reconfigure}
+realizan comprobaciones de seguridad: se aseguran de que los sistemas de
+ficheros que aparecen en la declaración @code{operating-system} realmente
+existen (@pxref{Sistemas de ficheros}) y que cualquier módulo del núcleo Linux
que
+pudiese necesitarse durante el arranque se encuentre en
address@hidden (@pxref{Disco en RAM inicial}). El uso de esta opción
+omite todas estas comprobaciones.
+
address@hidden on-error
address@hidden on-error strategy
address@hidden error strategy
address@hidden address@hidden
+Aplica @var{estrategia} cuando ocurre un error durante la lectura de
address@hidden @var{estrategia} puede ser uno de los siguientes valores:
+
address@hidden @code
address@hidden nothing-special
+Informa concisamente del error y termina la ejecución. Es la estrategia
+predeterminada.
+
address@hidden backtrace
+Del mismo modo, pero también muestra la secuencia de llamadas.
+
address@hidden debug
+Informa del error y entra en el depurador de Guile. A partir de ahí, puede
+ejecutar órdenes como @code{,bt} para obtener la secuencia de llamads,
address@hidden,locals} para mostrar los valores de las variables locales, e
+inspeccionar el estado del programa de forma más general. @xref{Debug
+Commands,,, guile, GNU Guile Reference Manual}, para una lista de órdenes de
+depuración disponibles.
address@hidden table
address@hidden table
+
+Once you have built, configured, re-configured, and re-re-configured your
+Guix installation, you may find it useful to list the operating system
+generations available on disk---and that you can choose from the bootloader
+boot menu:
+
address@hidden @code
+
address@hidden list-generations
+Muestra un resumen de cada generación del sistema operativo disponible en el
+disco, de manera legible por humanos. Es similar a la opción
address@hidden de @command{guix package} (@pxref{Invocación de guix package}).
+
+De manera opcional, se puede especificar un patrón, con la misma sintaxis
+que la usada en @command{guix package --list-generations}, para restringir
+la lista de generaciones mostradas. Por ejemplo, la siguiente orden muestra
+generaciones que tienen hasta 10 días de antigüedad:
+
address@hidden
+$ guix system list-generations 10d
address@hidden example
+
address@hidden table
+
+¡La orden @command{guix system} tiene aún más que ofrecer! Las siguientes
+ordenes le permiten visualizar cual es la relación entre los servicios del
+sistema:
+
address@hidden
address@hidden @code
+
address@hidden extension-graph
+Emite en formato Dot/Graphviz por la salida estándar el @dfn{grafo de
+extensiones de servicio} del sistema operativo definido en @var{fichero}
+(@pxref{Composición de servicios}, para más información sobre extensiones de
+servicio).
+
+La orden:
+
address@hidden
+$ guix system extension-graph @var{fichero} | dot -Tpdf > servicios.pdf
address@hidden example
+
+produce un fichero PDF que muestra las relaciones de extensiones entre los
+servicios.
+
address@hidden
address@hidden shepherd-graph
+Emite en formato Dot/Graphviz por la salida estándar el @dfn{grafo de
+dependencias} de los servicios shepherd del sistema operativo definido en
address@hidden @xref{Servicios de Shepherd}, para más información y un grafo de
+ejemplo.
+
address@hidden table
+
address@hidden Ejecutar Guix en una máquina virtual
address@hidden Ejecución de Guix en una máquina virtual
+
address@hidden máquina virtual
+To run Guix in a virtual machine (VM), one can either use the pre-built Guix
+VM image distributed at
address@hidden://alpha.gnu.org/gnu/guix/address@hidden@var{system}.xz}
+, or build their own virtual machine image using @command{guix system
+vm-image} (@pxref{Invocación de guix system}). The returned image is in qcow2
+format, which the @uref{http://qemu.org/, QEMU emulator} can efficiently
+use.
+
address@hidden QEMU
+Si ha construido su propia imagen, debe copiarla fuera del almacén y
+proporcionarse a sí misma permisos de escritura sobre dicha copia antes de
+usarla. En la invocación de QEMU debe elegir un emulador de sistema que sea
+adecuado para su plataforma hardware. Esta es una invocación de QEMU mínima
+que arrancará el resultado de @command{guix system vm-image} en hardware
+x86_64:
+
address@hidden
+$ qemu-system-x86_64 \
+ -net user -net nic,model=virtio \
+ -enable-kvm -m 256 /tmp/imagen-qemu
address@hidden example
+
+Aquí está el significado de cada una de esas opciones:
+
address@hidden @code
address@hidden qemu-system-x86_64
+Esto especifica la plataforma hardware a emular. Debe corresponder con el
+anfitrión.
+
address@hidden -net user
+Habilita la pila de red en modo de usuaria sin privilegios. El SO
+virtualizado puede acceder al anfitrión pero no al revés. Esta es la forma
+más simple de poner en línea un SO virtualizado.
+
address@hidden -net nic,model=virtio
+Debe crear una interfaz de red del modelo proporcionado. Si la crea, el
+arranque fallará. Asumiendo que su plataforma hardware sea x86_64, puede
+obtener una lista de modelos de interfaz de red disponibles ejecutando
address@hidden -net nic,model=help}.
+
address@hidden -enable-kvm
+Si su sistema tiene extensiones de virtualización por hardware, la
+activación de la implementación de máquinas virtuales (KVM) del núcleo Linux
+hará que la ejecución sea más rápida.
+
address@hidden -m 256
+RAM disponible para el sistema operativo virtualizado, en mebibytes. El
+valor predeterminado es address@hidden, que puede ser insuficiente para
+algunas operaciones.
+
address@hidden /tmp/imagen-qemu
+El nombre de fichero de la imagen qcow2.
address@hidden table
+
+El guión @command{run-vm.sh} predeterminado que devuelve la invocación de
address@hidden system vm} no añade una opción @command{-net user} por
+defecto. Para obtener acceso a la red desde la máquina virtual añada el
+servicio @code{(dhcp-client-service)} a su definición de sistema y arranque
+la máquina virtual mediante el uso de @command{`guix system vm config.scm`
+-net user}. Un punto importante a tener en cuenta del uso de @command{-net
+user} para la obtención de red es que @command{ping} no funcionará, puesto
+que usa el protocolo ICMP. Deberá usar una orden diferente para comprobar la
+conectividad a la red, por ejemplo @command{guix download}.
+
address@hidden Conexión a través de SSH
+
address@hidden SSH
address@hidden servidor SSH
+Para activar SSH dentro de una máquina virtual debe añadir un servidor SSH
+como @code{(dropbear-service)} o @code{(lsh-service)} en su máquina
+virtual. El servicio @code{(lsh-service)} no arranca actualmente sin
+supervisión, ya que precisa de entrada para inicializar el generador de
+aleatoriedad. Además tiene que redirigir el puerto SSH, 22 el
+predeterminado, a la máquina anfitriona. Puede hacerlo con
+
address@hidden
+`guix system vm config.scm` -net user,hostfwd=tcp::10022-:22
address@hidden example
+
+Para conectarse a la máquina virtual puede ejecutar
+
address@hidden
+ssh -o UserKnownHostsFile=/dev/null -o StrictHostKeyChecking=no -p 10022
address@hidden example
+
+La @command{-p} indica a @command{ssh} el puerto al que se debe
+conectar. @command{-o UserKnownHostsFile=/dev/null} evita que @command{ssh}
+se queje cada vez que modifique su fichero @command{config.scm} y la orden
address@hidden StrictHostKeyChecking=no} evita que tenga que autorizar la
+conexión a una máquina desconocida cada vez que se conecte.
+
address@hidden Uso de @command{virt-viewer} con Spice
+
+Como alternativa al cliente gráfico predeterminado de @command{qemu} puede
+usar @command{remote-viewer} del paquete @command{virt-viewer}. Para
+conectarse proporcione la opción @command{-spice
+port=5930,disable-ticketing} a @command{qemu}. Véase la sección previa para
+más información sobre cómo hacer esto.
+
+Spice también le permite hacer cosas como compartir su portapapeles con su
+máquina virtual. Para activarlo debe proporcionar también las siguientes
+opciones a @command{qemu}:
+
address@hidden
+-device virtio-serial-pci,id=virtio-serial0,max_ports=16,bus=pci.0,addr=0x5
+-chardev spicevmc,name=vdagent,id=vdagent
+-device virtserialport,nr=1,bus=virtio-serial0.0,chardev=vdagent,
+name=com.redhat.spice.0
address@hidden example
+
+También debe añadir el @pxref{Servicios misceláneos, servicio Spice}.
+
address@hidden Definición de servicios
address@hidden Definición de servicios
+
+Las secciones anteriores muestran los servicios disponibles y cómo se pueden
+combinar en una declaración @code{operating-system}. ¿Pero cómo las
+definimos en primer lugar? ¿Y qué es un servicio en cualquier caso?
+
address@hidden
+* Composición de servicios:: El modelo para la composición de servicios.
+* Tipos de servicios y servicios:: Tipos y servicios
+* Referencia de servicios:: Referencia de la API.
+* Servicios de Shepherd:: Un tipo de servicio particular.
address@hidden menu
+
address@hidden Composición de servicios
address@hidden Composición de servicios
+
address@hidden services
address@hidden daemons
+Definimos un @dfn{servicio} como, @i{grosso modo}, algo que extiende la
+funcionalidad del sistema operativo. Habitualmente un servicio es un
+proceso---un @dfn{daemon}---iniciado cuando el sistema arranca: un servidor
+de shell seguro, un servidor Web, el daemon de construcción de Guix, etc. A
+veces un servicio es un daemon cuya ejecución puede ser iniciada por otro
+daemon---por ejemplo, un servidor FTP iniciado por @command{inetd} o un
+servicio D-Bus activado por @command{dbus-daemon}. De manera ocasional, un
+servicio no se puede asociar a un daemon. Por ejemplo, el servicio
+``account'' recopila cuentas de usuaria y se asegura que existen cuando el
+sistema se ejecuta; el servicio ``udev'' recopila reglas de gestión de
+dispositivos y los pone a disposición del daemon eudev; el servicio
address@hidden/etc} genera el contenido del directorio @file{/etc} del sistema.
+
address@hidden extensiones de servicios
+Guix system services are connected by @dfn{extensions}. For instance, the
+secure shell service @emph{extends} the Shepherd---the initialization
+system, running as address@hidden giving it the command lines to start and
+stop the secure shell daemon (@pxref{Servicios de red,
address@hidden); the UPower service extends the D-Bus service
+by passing it its @file{.service} specification, and extends the udev
+service by passing it device management rules (@pxref{Servicios de escritorio,
address@hidden); the Guix daemon service extends the Shepherd by
+passing it the command lines to start and stop the daemon, and extends the
+account service by passing it a list of required build user accounts
+(@pxref{Servicios base}).
+
+Al fin y al cabo, los servicios y sus relaciones de ``extensión'' forman un
+grafo acíclico dirigido (GAD). Si representamos los servicios como cajas y
+las extensiones como flechas, un sistema típico puede proporcionar algo de
+este estilo:
+
address@hidden/service-graph,,5in,Grafo típico de extensiones de servicios.}
+
address@hidden servicio del sistema
+En la base, podemos ver el @dfn{servicio del sistema}, el cual produce el
+directorio que contiene todo lo necesario para ejecutar y arrancar el
+sistema, como es devuelto por la orden @command{guix system
+build}. @xref{Referencia de servicios}, para aprender acerca de otros servicios
+mostrados aquí. @xref{system-extension-graph, la orden @command{guix system
+extension-graph}}, para información sobre cómo generar esta representación
+para una definición particular de sistema operativo.
+
address@hidden tipos de servicio
+Technically, developers can define @dfn{service types} to express these
+relations. There can be any number of services of a given type on the
+system---for instance, a system running two instances of the GNU secure
+shell server (lsh) has two instances of @code{lsh-service-type}, with
+different parameters.
+
+La siguiente sección describe la interfaz programática para tipos de
+servicio y servicios.
+
address@hidden Tipos de servicios y servicios
address@hidden Tipos de servicios y servicios
+
+Un @dfn{tipo de servicio} es un nodo en el GAD descrito
+previamente. Empecemos con un ejemplo simple, el tipo de servicio para el
+daemon de construcción Guix (@pxref{Invocación de guix-daemon}):
+
address@hidden
+(define guix-service-type
+ (service-type
+ (name 'guix)
+ (extensions
+ (list (service-extension shepherd-root-service-type guix-shepherd-service)
+ (service-extension account-service-type guix-accounts)
+ (service-extension activation-service-type guix-activation)))
+ (default-value (guix-configuration))))
address@hidden example
+
address@hidden
+Define tres cosas:
+
address@hidden
address@hidden
+Un nombre, cuyo único propósito es facilitar la inspección y la depuración.
+
address@hidden
+Una lista de @dfn{extensiones de servicio}, donde cada extensión designa el
+tipo de servicio a extender y un procedimiento que, dados los parámetros del
+servicio, devuelve una lista de objetos para extender el servicio de dicho
+tipo.
+
+Cada tipo de servicio tiene al menos una extensión de servicio. La única
+excepción es el @dfn{tipo de servicio de arranque}, que es el último
+servicio.
+
address@hidden
+De manera opcional, un valor predeterminado para instancias de este tipo.
address@hidden enumerate
+
+In this example, @code{guix-service-type} extends three services:
+
address@hidden @code
address@hidden shepherd-root-service-type
+The @code{guix-shepherd-service} procedure defines how the Shepherd service
+is extended. Namely, it returns a @code{<shepherd-service>} object that
+defines how @command{guix-daemon} is started and stopped (@pxref{Servicios de
Shepherd}).
+
address@hidden account-service-type
+This extension for this service is computed by @code{guix-accounts}, which
+returns a list of @code{user-group} and @code{user-account} objects
+representing the build user accounts (@pxref{Invocación de guix-daemon}).
+
address@hidden activation-service-type
+Here @code{guix-activation} is a procedure that returns a gexp, which is a
+code snippet to run at ``activation time''---e.g., when the service is
+booted.
address@hidden table
+
+Un servicio de este tipo se puede instanciar de esta manera:
+
address@hidden
+(service guix-service-type
+ (guix-configuration
+ (build-accounts 5)
+ (use-substitutes? #f)))
address@hidden example
+
+El segundo parámetro a la forma @code{service} es un valor que representa
+los parámetros de esta instancia específica del
+servicio. @xref{guix-configuration-type, @code{guix-configuration}}, para
+información acerca del tipo de datos @code{guix-configuration}. Cuando se
+omite el valor, se usa el valor predeterminado por @code{guix-service-type}:
+
address@hidden
+(service guix-service-type)
address@hidden example
+
address@hidden is quite simple because it extends other services
+but is not extensible itself.
+
address@hidden @subsubsubsection Extensible Service Types
+
+El tipo de servicio para un servicio @emph{extensible} puede tener esta
+forma:
+
address@hidden
+(define udev-service-type
+ (service-type (name 'udev)
+ (extensions
+ (list (service-extension shepherd-root-service-type
+ udev-shepherd-service)))
+
+ (compose concatenate) ;concatena la lista de reglas
+ (extend (lambda (config rules)
+ (match config
+ (($ <udev-configuration> udev initial-rules)
+ (udev-configuration
+ (udev udev) ;el paquete udev a usar
+ (rules (append initial-rules rules)))))))))
address@hidden example
+
+This is the service type for the
address@hidden://wiki.gentoo.org/wiki/Project:Eudev, eudev device management
+daemon}. Compared to the previous example, in addition to an extension of
address@hidden, we see two new fields:
+
address@hidden @code
address@hidden compose
+Este es el procedimiento para @dfn{componer} la lista de extensiones en
+servicios de este tipo.
+
+Los servicios pueden extender el servicio udev proporcionandole una lista de
+reglas; componemos estas extensiones simplemente concatenandolas.
+
address@hidden extend
+Este procedimiento define cómo el valor del servicio se @dfn{extiende} con
+la composición de la extensión.
+
+Las extensiones de udev se componen en una lista de reglas, pero el valor
+del servicio udev es en sí un registro @code{<udev-configuration>}. Por
+tanto aquí extendemos el registro agregando la lista de reglas que contiene
+al final de la lista de reglas que se contribuyeron.
+
address@hidden description
+Es una cadena que proporciona una descripción del tipo de servicio. Dicha
+cadena puede contener lenguaje de marcado Texinfo (@pxref{Overview,,,
+texinfo, GNU Texinfo}). La orden @command{guix system search} busca estas
+cadenas y las muestra (@pxref{Invocación de guix system}).
address@hidden table
+
+There can be only one instance of an extensible service type such as
address@hidden If there were more, the @code{service-extension}
+specifications would be ambiguous.
+
+¿Todavía aquí? La siguiente sección proporciona una referencia de la
+interfaz programática de los servicios.
+
address@hidden Referencia de servicios
address@hidden Referencia de servicios
+
+Ya hemos echado un vistazo a los tipos de servicio (@pxref{Tipos de servicios
y servicios}). Esta sección proporciona referencias sobre cómo manipular
+servicios y tipos de servicio. Esta interfaz se proporciona en el módulo
address@hidden(gnu services)}.
+
address@hidden {Procedimiento Scheme} service @var{tipo} address@hidden
+Devuelve un nuevo servicio de @var{tipo}, un objeto @code{<service-type>}
+(véase a continuación). @var{valor} puede ser cualquier objeto; represental
+los parámetros de esta instancia de servicio particular.
+
+Cuando se omite @var{valor}, se usa el valor predeterminado especificado por
address@hidden; si @var{type} no especifica ningún valor, se produce un error.
+
+Por ejemplo, esto:
+
address@hidden
+(service openssh-service-type)
address@hidden example
+
address@hidden
+es equivalente a esto:
+
address@hidden
+(service openssh-service-type
+ (openssh-configuration))
address@hidden example
+
+En ambos casos el resultado es una instancia de @code{openssh-service-type}
+con la configuración predeterminada.
address@hidden deffn
+
address@hidden {Procedimiento Scheme} service? @var{obj}
+Devuelve verdadero si @var{obj} es un servicio.
address@hidden deffn
+
address@hidden {Procedimiento Scheme} service-kind @var{servicio}
+Devuelve el tipo de @var{servicio}---es decir, un objeto
address@hidden<service-type>}.
address@hidden deffn
+
address@hidden {Procedimiento Scheme} service-value @var{servicio}
+Devuelve el valor asociado con @var{servicio}. Representa sus parámetros.
address@hidden deffn
+
+Este es un ejemplo de creación y manipulación de un servicio:
+
address@hidden
+(define s
+ (service nginx-service-type
+ (nginx-configuration
+ (nginx nginx)
+ (log-directory log-directory)
+ (run-directory run-directory)
+ (file config-file))))
+
+(service? s)
address@hidden #t
+
+(eq? (service-kind s) nginx-service-type)
address@hidden #t
address@hidden example
+
+The @code{modify-services} form provides a handy way to change the
+parameters of some of the services of a list such as @code{%base-services}
+(@pxref{Servicios base, @code{%base-services}}). It evaluates to a list of
+services. Of course, you could always use standard list combinators such as
address@hidden and @code{fold} to do that (@pxref{SRFI-1, List Library,, guile,
+GNU Guile Reference Manual}); @code{modify-services} simply provides a more
+concise form for this common pattern.
+
address@hidden {Sintaxis Scheme} modify-services @var{servicios} @
+ (@var{tipo} @var{variable} => @var{cuerpo}) @dots{}
+
+Modifica los servicios listados en @var{servicios} de acuerdo a las
+cláusulas proporcionadas. Cada cláusula tiene la forma:
+
address@hidden
+(@var{tipo} @var{variable} => @var{cuerpo})
address@hidden example
+
+donde @var{tipo} es un tipo de servicio---por ejemplo,
address@hidden @var{variable} es un identificador que se
+asocia dentro del @var{cuerpo} a los parámetros del servicio---por ejemplo,
+una instancia @code{guix-configuration}---del servicio original de dicho
address@hidden
+
+El @var{cuerpo} deve evaluar a los nuevos parámetros del servicio, que serán
+usados para configurar el nuevo servicio. Este nuevo servicio reemplaza el
+original en la lista resultante. Debido a que los parámetros de servicio de
+un servicio se crean mediante el uso de @code{define-record-type*}, puede
+escribir un breve @var{cuerpo} que evalúe a los nuevos parámetros del
+servicio mediante el uso de la característica @code{inherit} que proporciona
address@hidden para heredar los valores antiguos.
+
address@hidden de la configuración del sistema}, para ejemplos de uso.
+
address@hidden deffn
+
+A continuación se procede con la interfaz programática de los tipos de
+servicios. Es algo que debe conocer para escribir definiciones de nuevos
+servicios, pero no es cuando busque formas de personalizar su declaración
address@hidden
+
address@hidden {Tipo de datos} service-type
address@hidden tipo de servicio
+Esta es la representación de un @dfn{tipo de servicio} (@pxref{Tipos de
servicios y servicios}).
+
address@hidden @asis
address@hidden @code{name}
+Es un símbolo, usado únicamente para simplificar la inspección y la
+depuración.
+
address@hidden @code{extensions}
+Una lista no vacía de objetos @code{<service-extension>} (véase a
+continuación).
+
address@hidden @code{compose} (predeterminado: @code{#f})
+Si es @code{#f}, entonces el tipo de servicio denota servicios que no pueden
+extenderse---es decir, servicios que no pueden recibir ``valores'' de otros
+servicios.
+
+En otro caso, debe ser un procedimiento de un único parámetro. El
+procedimiento es invocado en @code{fold-services} y se le proporciona una
+lista de valores recibidos de las extensiones. Puede devolver un valor
+único.
+
address@hidden @code{extend} (predeterminado: @code{#f})
+Si es @code{#f}, los servicios de este tipo no pueden extenderse.
+
+En otro caso, debe ser un procedimiento que acepte dos parámetros:
address@hidden lo invoca, proporcionandole el valor inicial del
+servicio como el primer parámetro y el resultado de aplicar @code{compose} a
+los valores de las extensiones como segundo parámetro. Debe devolver un
+valor que es un parámetro válido para la instancia del servicio.
address@hidden table
+
address@hidden de servicios y servicios}, para ejemplos.
address@hidden deftp
+
address@hidden {Procedimiento Scheme} service-extension @var{tipo-deseado} @
+ @var{calcula}
+
+Devuelve una nueva extensión para servicios del tipo
address@hidden @var{calcula} debe ser un procedimiento de un único
+parámetro: es llamado en @code{fold-services}, proporcionandole el valor
+asociado con el servicio que proporciona la extensión; debe devolver un
+valor válido para el servicio deseado.
address@hidden deffn
+
address@hidden {Procedimiento Scheme} service-extension? @var{obj}
+Devuelve verdadero si @var{obj} es una expresión-G.
address@hidden deffn
+
+De manera ocasional, puede desear simplemente extender un servicio
+existente. Esto implica la creación de un nuevo tipo de servicio y la
+especificación de la extensión deseada, lo cual puede ser engorroso; el
+procedimiento @code{simple-service} proporciona un atajo para ello.
+
address@hidden {Procedimiento Scheme} simple-service @var{nombre} @var{deseado}
@var{valor}
+Devuelve un servicio que extiende @var{deseado} con @var{valor}. Esto
+funciona creando una instancia única del tipo de servicio @var{nombre}, de
+la cual el servicio devuelto es una instancia.
+
+Por ejemplo, esto extiende mcron (@pxref{Ejecución de tareas programadas}) con
una
+tarea adicional:
+
address@hidden
+(simple-service 'mi-tarea-mcron mcron-service-type
+ #~(job '(next-hour (3)) "guix gc -F 2G"))
address@hidden example
address@hidden deffn
+
+En el núcleo de la abstracción de los servicios se encuentra el
+procedimiento @code{fold-services}, que es responsable de la ``compilación''
+de una lista de servicios en un único directorio que contiene todo lo
+necesario para arrancar y ejecutar el sistema---el directorio mostrado por
+la orden @command{guix system build} (@pxref{Invocación de guix system}). En
+esencia, propaga las extensiones de servicios a través del grafo de
+servicios, actualizando los parámetros de cada nodo en el camino, hasta que
+alcanza el nodo raíz.
+
address@hidden {Procedimiento Scheme} fold-services @var{servicios} @
+ [#:target-type @var{system-service-type}]
+Recorre @var{servicios} propagando sus extensiones hasta la raíz del tipo
address@hidden; devuelve el servicio raíz tratado de la manera apropiada.
address@hidden deffn
+
+Por último, el módulo @code{(gnu services)} también define varios tipos
+esenciales de servicios, algunos de los cuales se enumeran a continuación.
+
address@hidden {Variable Scheme} system-service-type
+Esta es la raíz del grafo de servicios. Produce el directorio del sistema
+como lo devuelve la orden @code{guix system build}.
address@hidden defvr
+
address@hidden {Variable Scheme} boot-service-type
+El tipo del ``servicio de arranque'', que produce un @dfn{guión de
+arranque}. El guión de arranque es lo que ejecuta el disco inicial de RAM
+cuando se arranca.
address@hidden defvr
+
address@hidden {Variable Scheme} etc-service-type
+El tipo del servicio @file{/etc}. Este servicio se usa para crear los
+ficheros en @file{/etc} y puede extenderse proporcionandole pares
+nombre/fichero como estas:
+
address@hidden
+(list `("issue" ,(plain-file "issue" "¡Bienvenida!\n")))
address@hidden example
+
+En este ejemplo, el ejecto sería la adición de un fichero @file{/etc/issue}
+que apunta al fichero proporcionado.
address@hidden defvr
+
address@hidden {Variable Scheme} setuid-program-service-type
+Tipo para el ``servicio de programas setuid''. Este servicio recopila listas
+de nombres de ficheros ejecutables, proporcionados como expresiones-G, y los
+añade al conjunto de programas con setuid de root en el sistema
+(@pxref{Programas con setuid}).
address@hidden defvr
+
address@hidden {Variable Scheme} profile-service-type
+Tipo del servicio que genera el @dfn{perfil del sistema}---es decir, los
+programas en @file{/run/current-system/profile}. Otros servicios pueden
+extenderlo proporcionandole listas de paquetes a añadir al perfil del
+sistema.
address@hidden defvr
+
+
address@hidden Servicios de Shepherd
address@hidden Servicios de Shepherd
+
address@hidden servicios de shepherd
address@hidden PID 1
address@hidden sistema de inicio
+The @code{(gnu services shepherd)} module provides a way to define services
+managed by the address@hidden, which is the initialization system---the
+first process that is started when the system boots, also known as
address@hidden (@pxref{Introducción,,, shepherd, The GNU Shepherd Manual}).
+
+Los servicios en Shepherd pueden depender de otros servicios. Por ejemplo,
+el daemon SSH puede tener que arrancarse tras el arranque del daemon syslog,
+lo cual a su vez puede suceder únicamente tras el montaje de todos los
+sistemas de ficheros. El sistema operativo simple definido previamente
+(@pxref{Uso de la configuración del sistema}) genera un grafo de servicios como
+este:
+
address@hidden/shepherd-graph,,5in,Grafo típico de servicios de shepherd.}
+
+En realidad puede generar dicho grafo para cualquier definición de sistema
+operativo mediante el uso de la orden @command{guix system shepherd-graph}
+(@pxref{system-shepherd-graph, @command{guix system shepherd-graph}}).
+
+The @code{%shepherd-root-service} is a service object representing
address@hidden, of type @code{shepherd-root-service-type}; it can be extended by
+passing it lists of @code{<shepherd-service>} objects.
+
address@hidden {Tipo de datos} shepherd-service
+El tipo de datos que representa un servicio gestionado por Shepherd.
+
address@hidden @asis
address@hidden @code{provision}
+Una lista de símbolos que indican lo que proporciona el servicio.
+
+Esto son nombres que pueden proporcionarse a @command{herd start},
address@hidden status} y órdenes similares (@pxref{Invoking herd,,, shepherd,
+The GNU Shepherd Manual}). @xref{Slots of services, the @code{provides}
+slot,, shepherd, The GNU Shepherd Manual}, para más detalles.
+
address@hidden @code{requirements} (predeterminados: @code{'()})
+Lista de símbolos que indican los servicios Shepherd de los que este
+depende.
+
address@hidden one-shot services, for the Shepherd
address@hidden @code{one-shot?} (predeterminado: @code{#f})
+Whether this service is @dfn{one-shot}. One-shot services stop immediately
+after their @code{start} action has completed. @xref{Slots of services,,,
+shepherd, The GNU Shepherd Manual}, for more info.
+
address@hidden @code{respawn?} (predeterminado: @code{#t})
+Indica si se debe reiniciar el servicio cuando se para, por ejemplo cuando
+el proceso subyacente muere.
+
address@hidden @code{start}
address@hidden @code{stop} (predeterminado: @code{#~(const #f)})
+Los campos @code{start} y @code{stop} hacen referencia a las características
+de Shepherd de arranque y parada de procesos respectivamente (@pxref{Service
+De- and Constructors,,, shepherd, The GNU Shepherd Manual}). Se proporcionan
+como expresiones-G que se expandirán en el fichero de configuración de
+Shepherd (@pxref{Expresiones-G}).
+
address@hidden @code{actions} (predeterminadas: @code{'()})
address@hidden acciones, de servicios de Shepherd
+Esta es la lista de objetos @code{shepherd-action} (véase a continuación)
+que definen las @dfn{acciones} permitidas por el servicio, además de las
+acciones estándar @code{start} y @code{stop}. Las acciones que se listan
+aquí estarán disponibles como ordenes de @command{herd}:
+
address@hidden
+herd @var{acción} @var{servicio} address@hidden@dots{}]
address@hidden example
+
address@hidden @code{documentación}
+Una cadena de documentación, que se mostrará al ejecutar:
+
address@hidden
+herd doc @var{nombre-del-servicio}
address@hidden example
+
+where @var{service-name} is one of the symbols in @code{provision}
+(@pxref{Invoking herd,,, shepherd, The GNU Shepherd Manual}).
+
address@hidden @code{modules} (default: @code{%default-modules})
+Esta es la lista de módulos que deben estar dentro del ámbito cuando
address@hidden y @code{stop} son evaluados.
+
address@hidden table
address@hidden deftp
+
address@hidden {Tipo de datos} shepherd-action
+Este es el tipo de datos que define acciones adicionales implementadas por
+un servicio Shepherd (vea previamente).
+
address@hidden @code
address@hidden name
+Símbolo que nombra la acción.
+
address@hidden documentación
+Esta es una cadena de documentación para la acción. Puede verse ejecutando:
+
address@hidden
+herd doc @var{servicio} action @var{acción}
address@hidden example
+
address@hidden procedure
+Debe ser una expresión-G que evalua a un procedimiento de al menos un
+parámetro, el cual es el ``valor de ejecución'' del servicio (@pxref{Slots
+of services,,, shepherd, The GNU Shepherd Manual}).
address@hidden table
+
+El siguiente ejemplo define una acción llamada @code{di-hola} que saluda
+amablemente a la usuaria:
+
address@hidden
+(shepherd-action
+ (name 'di-hola)
+ (documentation "¡Di hola!")
+ (procedure #~(lambda (running . args)
+ (format #t "¡Hola, compa! parámetros: ~s\n"
+ args)
+ #t)))
address@hidden example
+
+Asumiendo que esta acción se añade al servicio @code{ejemplo}, puede
+ejecutar:
+
address@hidden
+# herd di-hola ejemplo
+¡Hola, compa! parámetros: ()
+# herd di-hola ejemplo a b c
+¡Hola, compa! parámetros: ("a" "b" "c")
address@hidden example
+
+Esta, como puede ver, es una forma un tanto sofisticada de decir
+hola. @xref{Service Convenience,,, shepherd, The GNU Shepherd Manual}, para
+más información sobre acciones.
address@hidden deftp
+
address@hidden {Variable Scheme} shepherd-root-service-type
+El tipo de servicio para el ``servicio raíz'' de Shepherd---es decir,
address@hidden
+
+El tipo de servicio que las extensiones declaran cuando desean crear
+servicios shepherd (@pxref{Tipos de servicios y servicios}, para un
+ejemplo). Cada extensión debe pasar una lista de @code{<shepherd-service>}.
address@hidden defvr
+
address@hidden {Variable Scheme} %shepherd-root-service
+Este servicio representa el address@hidden
address@hidden defvr
+
+
address@hidden Documentación
address@hidden Documentación
+
address@hidden documentación, búsqueda
address@hidden búsqueda de documentación
address@hidden Info, formato de documentación
address@hidden páginas man
address@hidden páginas de manual
+En la mayor parte de casos, los paquetes instalados con Guix contienen
+documentación. Hay dos formatos principales de documentación: ``Info'', un
+formato hipertextual navegable usado para software GNU, y ``páginas de
+manual'' (o ``páginas man''), la documentación lineal encontrada
+tradicionalmente en Unix. Se accede a los manuales Info con la orden
address@hidden o con Emacs, y las páginas man con @command{man}.
+
+Puede buscar documentación de software instalado en su sistema por palabras
+clave. Por ejemplo, la siguiente orden busca información sobre ``TLS'' en
+manuales Info:
+
address@hidden
+$ info -k TLS
+"(emacs)Network Security" -- STARTTLS
+"(emacs)Network Security" -- TLS
+"(gnutls)Core TLS API" -- gnutls_certificate_set_verify_flags
+"(gnutls)Core TLS API" -- gnutls_certificate_set_verify_function
address@hidden
address@hidden example
+
address@hidden
+La orden siguiente busca por la misma palabra clave en páginas man:
+
address@hidden
+$ man -k TLS
+SSL (7) - OpenSSL SSL/TLS library
+certtool (1) - GnuTLS certificate tool
address@hidden {}
address@hidden example
+
+Estas búsquedas son completamente locales en su máquina de modo que tiene la
+garantía de que la documentación que encuentre corresponde con lo que está
+realmente instalado, puede acceder a ella sin conexión a la red, y se
+respeta su privacidad.
+
+Una vez tenga estos resultados, puede ver la documentación relevante
+mediante la ejecución de, digamos:
+
address@hidden
+$ info "(gnutls)Core TLS API"
address@hidden example
+
address@hidden
+o:
+
address@hidden
+$ man certtool
address@hidden example
+
+Los manuales Info contienen secciones e índices, así como enlaces como
+aquellos encontrados en páginas Web. El lector @command{info} (@pxref{Top,
+Info reader,, info-stnd, Stand-alone GNU Info}) y su contraparte en Emacs
+(@pxref{Misc Help,,, emacs, The GNU Emacs Manual}) proporcionan
+combinaciones de teclas intuitivas para la navegación en los
+manuales. @xref{Getting Started,,, info, Info: An Introduction}, para una
+introducción a la navegación en Info.
+
address@hidden Instalación de ficheros de depuración
address@hidden Instalación de ficheros de depuración
+
address@hidden ficheros de depuración
+Los programas binarios, como los producidos por los compiladores GCC por
+ejemplo, se escriben típicamente en el formato ELF, con una sección que
+contiene @dfn{información de depuración}. La información de depuración es lo
+que permite que el depurador, GDB, asocie código binario a código fuente; es
+necesaria para depurar un programa compilado en condiciones adecuadas.
+
+El problema con la información de depuración es que ocupa un espacio
+considerable en el disco. Por ejemplo, la información de depuración de la
+biblioteca C de GNU ocupa más de 60 MiB. Por tanto, como usuaria, mantener
+toda la información de depuración de todos los programas instalados no es
+habitualmente una opción. No obstante, el ahorro de espacio no debe ser
+impedir la depuración---especialmente en el sistema GNU, que debería
+facilitar a sus usuarias ejercitar su libertad de computación
(@pxref{Distribución GNU}).
+
+Afortunadamente, las utilidades binarias GNU (Binutils) y GDB proporcionan
+un mecanismo que permite a las usuarias obtener lo mejor de ambos mundos: la
+información de depuración puede extraerse de los binarios y almacenarse en
+ficheros separados. GDB es capaz entonces de cargar la información de
+depuración desde esos ficheros, cuando estén disponibles (@pxref{Separate
+Debug Files,,, gdb, Debugging with GDB}).
+
+La distribución GNU toma ventaja de este hecho almacenando la información de
+depuración en el subdirectorio @code{lib/debug} de una salida separada del
+paquete llamada @code{debug} (@pxref{Paquetes con múltiples salidas}). Las
+usuarias pueden elegir si instalan la salida @code{debug} de un paquete
+cuando la necesitan. Por ejemplo, la siguiente orden instala la información
+de depuración para la biblioteca C de GNU y para GNU Guile.
+
address@hidden
+guix package -i glibc:debug guile:debug
address@hidden example
+
+Se debe decir entonces a GDB que busque los ficheros de depuración en el
+perfil de la usuaria, proporcionando un valor a la variable
address@hidden (considere hacerlo en el fichero
address@hidden/.gdbinit}, @pxref{Startup,,, gdb, Debugging with GDB}):
+
address@hidden
+(gdb) set debug-file-directory ~/.guix-profile/lib/debug
address@hidden example
+
+A partir de ese momento GDB obtendrá la información de depuración de los
+ficheros @code{.debug} bajo @file{~/.guix-profile/lib/debug}.
+
+Además, probablemente desee que GDB sea capaz de mostrar el código fuente
+que está depurando. Para hacerlo, tiene que desempaquetar el código fuente
+del paquete de su interés (obtenido con @code{guix build --source},
address@hidden de guix build}) e indicar a GDB cual es el directorio de
+fuentes mediante el uso de la orden @code{directory} (@pxref{Source Path,
address@hidden,, gdb, Debugging with GDB}).
+
address@hidden XXX: keep me up-to-date
+El mecanismo de la salida @code{debug} en Guix se implementa por el sistema
+de construcción @code{gnu-build-system} (@pxref{Sistemas de construcción}).
Ahora mismo
+necesita una activación explícita---la información de depuración está
+disponible únicamente para paquetes con definiciones que declaren
+explícitamente una salida @code{debug}. Esto puede cambiarse por una
+activación implícita en el futuro si nuestras granjas de construcción pueden
+soportar la carga. Para comprobar si un paquete tiene una salida
address@hidden, use @command{guix package --list-available} (@pxref{Invocación
de guix package}).
+
+
address@hidden Actualizaciones de seguridad
address@hidden Actualizaciones de seguridad
+
address@hidden actualizaciones de seguridad
address@hidden vulnerabilidades de seguridad
+De manera ocasional, vulnerabilidades importantes de seguridad se descubren
+en los paquetes de software y deben parchearse. Las desarrolladoras de Guix
+tratan de seguir las vulnerabilidades conocidas y aplicar parches tan pronto
+como sea posible en la rama @code{master} de Guix (todavía no proporcionamos
+una rama ``estable'' que contenga únicamente actualizaciones de
+seguridad). La herramienta @command{guix lint} ayuda a las desarrolladoras a
+encontrar versiones vulnerables de paquetes de software en la distribución:
+
address@hidden
+$ guix lint -c cve
+gnu/packages/base.scm:652:2: glibc@@2.21: probably vulnerable to
CVE-2015-1781, CVE-2015-7547
+gnu/packages/gcc.scm:334:2: gcc@@4.9.3: probably vulnerable to CVE-2015-5276
+gnu/packages/image.scm:312:2: openjpeg@@2.1.0: probably vulnerable to
CVE-2016-1923, CVE-2016-1924
address@hidden
address@hidden smallexample
+
address@hidden de guix lint}, para más información.
+
address@hidden Nota
+En la versión @value{VERSION}, esta característica descrita a continuación
+se considera en estado ``beta''.
address@hidden quotation
+
+Guix sigue una disciplina funcional de gestión de paquetes
+(@pxref{Introducción}), lo que implica que, cuando se cambia un paquete,
address@hidden los paquetes que dependen de él} deben ser reconstruidos. Esto
+puede ralentizar de manera significativa el despliegue de correcciones en
+paquetes básicos como libc o Bash, ya que básicamente la distribución al
+completo debe reconstruirse. El uso de binarios preconstruidos ayuda
+(@pxref{Sustituciones}), pero el despliegue aún puede tomar más tiempo del
+deseado.
+
address@hidden injertos (grafts en inglés)
+Para afrontar esto, Guix implementa @dfn{injertos}, un mecanismo que permite
+un rápido despliegue de actualizaciones críticas sin los costes asociados
+con una reconstrucción completa de la distribución. La idea es reconstruir
+únicamente el paquete que hace falta parchear, y entonces ``injertarlo'' en
+los paquetes explícitamente instalados por la usuaria y que previamente
+hacían referencia al paquete original. El coste de realizar un injerto es
+menor que una reconstrucción completa de la cadena de dependencias.
+
address@hidden reemplazos de paquetes, para injertos
+For instance, suppose a security update needs to be applied to Bash. Guix
+developers will provide a package definition for the ``fixed'' Bash, say
address@hidden, in the usual way (@pxref{Definición de paquetes}). Then, the
+original package definition is augmented with a @code{replacement} field
+pointing to the package containing the bug fix:
+
address@hidden
+(define bash
+ (package
+ (name "bash")
+ ;; @dots{}
+ (replacement bash-fixed)))
address@hidden example
+
+From there on, any package depending directly or indirectly on Bash---as
+reported by @command{guix gc --requisites} (@pxref{Invocación de guix
gc})---that
+is installed is automatically ``rewritten'' to refer to @code{bash-fixed}
+instead of @code{bash}. This grafting process takes time proportional to
+the size of the package, usually less than a minute for an ``average''
+package on a recent machine. Grafting is recursive: when an indirect
+dependency requires grafting, then grafting ``propagates'' up to the package
+that the user is installing.
+
+Currently, the length of the name and version of the graft and that of the
+package it replaces (@code{bash-fixed} and @code{bash} in the example above)
+must be equal. This restriction mostly comes from the fact that grafting
+works by patching files, including binary files, directly. Other
+restrictions may apply: for instance, when adding a graft to a package
+providing a shared library, the original shared library and its replacement
+must have the same @code{SONAME} and be binary-compatible.
+
+La opción de línea de órdenes @option{--no-grafts} le permite anular
+voluntariamente el proceso de injerto (@pxref{Opciones comunes de construcción,
address@hidden). Por tanto, la orden:
+
address@hidden
+guix build bash --no-grafts
address@hidden example
+
address@hidden
+devuelve el nombre de fichero del almacén de la versión original de Bash,
+mientras que:
+
address@hidden
+guix build bash
address@hidden example
+
address@hidden
+devuelve el nombre de fichero del almacén de la versión ``corregida'',
+reemplazo de Bash. Esto le permite distinguir entre las dos variantes de
+Bash.
+
+Para verificar a qué Bash hace referencia su perfil al completo, puede
+ejecutar (@pxref{Invocación de guix gc}):
+
address@hidden
+guix gc -R `readlink -f ~/.guix-profile` | grep bash
address@hidden example
+
address@hidden
address@hidden y compare los nombres de fichero del almacén que obtendrá con los
+ejemplos previos. Del mismo modo, para una generación completa del sistema
+Guix:
+
address@hidden
+guix gc -R `guix system build mi-configuracion.scm` | grep bash
address@hidden example
+
+Por último, para comprobar qué versión de Bash están usando los procesos en
+ejecución, puede usar la orden @command{lsof}:
+
address@hidden
+lsof | grep /gnu/store/.*bash
address@hidden example
+
+
address@hidden Lanzamiento inicial
address@hidden Lanzamiento inicial
+
address@hidden Adapted from the ELS 2013 paper.
+
address@hidden lanzamiento inicial
+
+El lanzamiento inicial en nuestro contexto hace referencia a cómo la
+distribución se construye ``de la nada''. Recuerde que el entorno de
+construcción de una derivación no contiene más que sus entradas declaradas
+(@pxref{Introducción}). Por lo que hay un evidente problema ``del huevo y la
+gallina'': ¿cómo se construye el primer paquete? ¿Cómo se compila el primer
+compilador? Fíjese que esta es una cuestión de interés únicamente para la
+hacker curiosa, no para la usuaria normal, así que puede pasar por encima
+está sección sin ninguna vergüenza si se considera una ``usuaria normal''.
+
address@hidden binarios del lanzamiento inicial
+El sistema GNU está compuesto principalmente de código C, con libc en su
+base. El sistema de construcción GNU en sí asume la disponibilidad del shell
+Bourne y las herramientas de línea de órdenes proporcionadas por GNU
+Coreutils, Awk, Findutils, `sed' y `grep'. Además, los programas de
+construcción---programas que ejecutan @code{./configure}, @code{make},
+etc.---están escritos en Scheme Guile
+(@pxref{Derivaciones}). Consecuentemente, para ser capaz de construir
+cualquier cosa, desde cero, Guix depende en binarios preconstruidos de
+Guile, GCC, Binutils, libc y otros paquetes mencionados anteriormente---los
address@hidden del lanzamiento inicial}.
+
+Estos binarios del lanzamiento inicial se ``dan por supuestos'', aunque se
+pueden volver a crear si se necesita (más sobre esto más adelante).
+
address@hidden Preparación para usar los binarios del lanzamiento inicial
+
address@hidden As of Emacs 24.3, Info-mode displays the image, but since it's a
address@hidden large image, it's hard to scroll. Oh well.
address@hidden/bootstrap-graph,6in,,Grafo de dependencias de las derivaciones
+del lanzamiento inicial temprano}
+
+La figura previa muestra el auténtico inicio del grafo de dependencias de la
+distribución, correspondiente a las definiciones de paquete del módulo
address@hidden(gnu packages bootstrap)}. Un gráfico similar puede generarse con
address@hidden graph} (@pxref{Invocación de guix graph}), más o menos así:
+
address@hidden
+guix graph -t derivation \
+ -e '(@@@@ (gnu packages bootstrap) %bootstrap-gcc)' \
+ | dot -Tps > t.ps
address@hidden example
+
+En este nivel de detalle, las cosas son ligeramente complejas. Primero,
+Guile en sí consiste en un ejecutable ELF, junto a muchas fuentes y ficheros
+compilados Scheme que se cargan dinámicamente durante la ejecución. Esto se
+almacena en el archivador tar @file{guile-2.0.7.tar.xz} mostrado en este
+grafo. Este archivador es parte de la distribución de ``fuentes'' de Guix, y
+se inserta en el almacén con @code{add-to-store} (@pxref{El almacén}).
+
+¿Pero cómo escribimos una derivación que extraiga este archivador y lo añada
+al almacén? Para resolver este problema, la derivación
address@hidden primera en construirse---usa @code{bash}
+como su constructor, que ejecuta @code{build-bootstrap-guile.sh}, que a su
+vez llama a @code{tar} para extraer el archivador. Por tanto, @file{bash},
address@hidden, @file{xz} y @file{mkdir} son binarios enlazados estáticamente,
+también parte de la distribución de fuentes de Guix, cuyo único propósito es
+permitir la extracción del archivador de Guile.
+
+Una vez address@hidden se ha construido, tenemos un Guile
+funcional que se puede usar para ejecutar los programas de construcción
+siguientes. Su primera tarea es descargar los archivadores qu contienen los
+otros binarios preconstruidos---esto es lo que las derivaciones
address@hidden hacen. Módulos Guix como @code{ftp-client.scm} se usan
+para este propósito. Las derivaciones @code{module-import.drv} importan esos
+módulos en un directorio del almacén, manteniendo la distribución de
+carpetas. Las derivaciones @code{module-import-compiled.drv} compilan esos
+módulos, y los escriben en un directorio con la distribución de carpetas
+correcta. Esto corresponde al parámetro @code{#:modules} de
address@hidden>derivation} (@pxref{Derivaciones}).
+
+Finalmente, los archivadores tar son extraídos por las derivaciones
address@hidden, @code{glibc-bootstrap-0.drv}, etcétera, hasta el
+punto en el que disponemos de una cadena de herramientas C funcional.
+
+
address@hidden Construcción de las herramientas de construcción
+
+El lanzamiento inicial está completo cuando tenemos una cadena de
+herramientas completa que no depende en las herramientas preconstruidas del
+lanzamiento inicial descritas previamente. Este requisito de no-dependencia
+se verifica comprobando si los ficheros de la cadena de herramientas final
+contienen referencias a directorios de @file{/gnu/store} de las entradas del
+lanzamiento. El proceso que lleva a esta cadena de herramientas ``final'' es
+descrito por las definiciones de paquetes encontradas en el módulo
address@hidden(gnu packages commencement)}.
+
+La orden @command{guix graph} nos permite ``distanciarnos'' en comparación
+con el grafo previo, mirando al nivel de objetos de paquetes en vez de
+derivaciones individuales---recuerde que un paquete puede traducirse en
+varias derivaciones, típicamente una derivación para descargar sus fuentes,
+una para construir los módulos Guile que necesita y uno para realmente
+construir el paquete de las fuentes. La orden:
+
address@hidden
+guix graph -t bag \
+ -e '(@@@@ (gnu packages commencement)
+ glibc-final-with-bootstrap-bash)' | dot -Tps > t.ps
address@hidden example
+
address@hidden
+produce el grafo de dependencias que lleva a la biblioteca C
+``final''@footnote{Puede haberse dado cuenta de la etiqueta
address@hidden, sugiriendo que no es @emph{completamente} final,
+pero como es una buena aproximación, la consideraremos final}, mostrado a
+continuación.
+
address@hidden/bootstrap-packages,6in,,Grafo de dependencias de los primeros
+paquetes}
+
address@hidden See
<http://lists.gnu.org/archive/html/gnu-system-discuss/2012-10/msg00000.html>.
+La primera herramienta que se construye con los binarios del lanzamiento
+inicial es address@hidden como @code{make-boot0} en el grafo---,
+que es un pre-requisito para todos los paquetes siguientes. Una vez hecho se
+construyen Findutils y Diffutils.
+
+Después viene la primera fase de Binutils y GCC, construidas como
+herramientas pseudo-cruzadas---es decir, con @code{--target} igual a
address@hidden Se usan para construir libc. Gracias a este truco de
+compilación cruzada, se garantiza que esta libc no tendrá ninguna referencia
+a la cadena de herramientas inicial.
+
+Posteriormente se construyen las herramientas Binutils y GCC (no mostradas
+previamente) finales, y enlazan los programas contra la libc recién
+construía. Esta cadena de herramientas se usa para construir otros paquetes
+usados por Guix y el sistema de construcción GNU: Guile, Bash, Coreutils,
+etc.
+
+¡Y voilà! En este punto tenemos un conjunto completo de herramientas de
+construcción esperadas por el sistema de construcción GNU. Están en la
+variable @code{%final-inputs} del módulo @code{(gnu packages commencement)},
+y se usan implícitamente por cualquier paquete que use
address@hidden (@pxref{Sistemas de construcción, @code{gnu-build-system}}).
+
+
address@hidden Construir los binarios de lanzamiento
+
address@hidden binarios del lanzamiento inicial
+Debido a que la cadena de herramientas final no depende de los binarios de
+lanzamiento, estos rara vez necesitan ser actualizados. No obstante, es útil
+tener una forma automatizada de producirlos en caso de que se dé una
+actualización, y esto es lo que proporciona el módulo @code{(gnu packages
+make-bootstrap)}.
+
+La siguiente orden construye los archivadores que contienen los binarios de
+lanzamiento (Guile, Binutils, GCC, libc, y un archivador que contiene una
+mezcla de Coreutils y otras herramientas básicas de línea de órdenes):
+
address@hidden
+guix build bootstrap-tarballs
address@hidden example
+
+Los archivadores generados son aquellos que son referenciados en el módulo
address@hidden(gnu packages bootstrap)} mencionado al inicio de esta sección.
+
+¿Todavía aquí? Entonces quizá se habrá empezado a preguntar: ¿cuándo
+llegamos a un punto fijo? ¡Esa es una pregunta interesante! La respuesta es
+desconocida, pero si pudiese investigar más a fondo (y tiene unos recursos
+computacionales y de almacenamiento significativos para hacerlo) háganoslo
+saber.
+
address@hidden Reducción del conjunto de binarios de lanzamiento
+
+Nuestros binarios de lanzamiento actualmente incluyen GCC, Guile, etc. ¡Eso
+es un montón de código binario! ¿Por qué es eso un problema? Es un problema
+porque esos chorros de código binario no son auditables en la práctica, lo
+que hace difícil establecer qué código fuente los produjo. Cada binario
+no-auditable también nos deja vulnerables a puertas traseras en los
+compiladores, como describió Ken Thompson en su publicación de 1984
address@hidden on Trusting Trust}.
+
+Esto se mitiga por el hecho de que nuestros binarios de lanzamiento fueron
+generados por una revisión anterior de Guix. No obstante, esto no posee el
+nivel de transparencia que obtenemos en el resto del grado de dependencias
+de los paquetes, donde Guix siempre nos da una asociación de
+fuente-a-binario. Por lo tanto, nuestro objetivo es reducir el conjunto de
+binarios de lanzamiento al mínimo posible.
+
+El @uref{http://bootstrappable.org, sitio web Bootstrappable.org} enumera
+proyectos en activo realizándolo. Uno de ellos está a punto de sustituir el
+GCC de lanzamiento con una secuencia de ensambladores, interpretes y
+compiladores de complejidad incremental, que pueden ser construidos desde
+las fuentes empezando con un código ensamblador simple y auditable. ¡Su
+ayuda es bienvenida!
+
+
address@hidden Transportar
address@hidden Transportar a una nueva plataforma
+
+Como se explicó previamente, la distribución GNU es autocontenida, lo cual
+se consigue dependiendo de unos ``binarios del lanzamiento inicial''
+preconstruidos (@pxref{Lanzamiento inicial}). Estos binarios son específicos
para
+un núcleo del sistema operativo, arquitectura de la CPU e interfaz binaria
+de aplicaciones (ABI). Por tanto, para transportar la distribución a una
+nueva plataforma que no está soportada todavía, se deben construir estos
+binarios del lanzamiento inicial, y actualizar el módulo @code{(gnu packages
+bootstrap)} para usarlos en dicha plataforma.
+
+Por suerte, Guix puede @emph{compilar de forma cruzada} esos binarios del
+lanzamiento inicial. Cuando todo va bien, y asumiendo que la cadena de
+herramientas GNU soporta para la plataforma deseada, esto puede ser tan
+simple como ejecutar una orden así:
+
address@hidden
+guix build --target=armv5tel-linux-gnueabi bootstrap-tarballs
address@hidden example
+
+Para que esto funcione, el procedimiento @code{glibc-dynamic-linker} en
address@hidden(gnu packages bootstrap)} debe aumentarse para devolver el nombre
de
+fichero correcto para el enlazador dinámico de libc en dicha plataforma; de
+igual manera, @code{system->linux-architecture} en @code{(gnu packages
+linux)} debe modificarse para la nueva plataforma.
+
+Una vez construidos, el módulo @code{(gnu packages bootstrap)} debe ser
+actualizado para hacer referencia a estos binarios en la plataforma
+deseada. Esto es, los hash y las URL de los archivadores del lanzamiento
+inicial de la nueva plataforma deben añadirse junto a aquellos de las
+plataformas disponibles actualmente. El archivador tar del Guile usado para
+el lanzamiento inicial se trata de forma especial: se espera que esté
+disponible localmente, y @file{gnu/local.mk} tiene reglas que lo descargan
+para las arquitecturas disponibles; se debe añadir una regla para la nueva
+plataforma también.
+
+En la práctica puede haber algunas complicaciones. Primero, puede ser que la
+tripleta extendida GNU que especifica un ABI (como el sufijo @code{eabi}
+previamente) no es reconocida por todas las herramientas GNU. Típicamente,
+glibc reconoce algunas de ellas, mientras que GCC usa una opción de
+configuración extra @code{--with-abi} (vea @code{gcc.scm} para ejemplos de
+como manejar este caso). En segundo lugar, algunos de los paquetes
+necesarios pueden fallar en su construcción para dicha plataforma. Por
+último, los binarios generados pueden estar defectuosos por alguna razón.
+
address@hidden
*********************************************************************
address@hidden contributing.es.texi
+
address@hidden
*********************************************************************
address@hidden Reconocimientos
address@hidden Reconocimientos
+
+Guix está basado en el @uref{http://nixops.org/nix, gestor de paquetes Nix},
+que fue diseñado e implementado por Eelco Dolstra, con contribuciones de
+otra gente (véase el fichero @file{nix/AUTHORS} en Guix). Nix fue pionero en
+la gestión de paquetes funcional, y promovió características sin
+precedentes, como las actualizaciones de paquetes transaccionales y vuelta
+atrás, perfiles por usuaria y un proceso de compilación referencialmente
+transparente. Sin este trabajo, Guix no existiría.
+
+Las distribuciones de software basadas en Nix, Nixpkgs y NixOS, también han
+sido una inspiración para Guix.
+
address@hidden en sí es un trabajo colectivo con contribuciones de un número
+de gente. Mire el fichero @file{AUTHORS} en Guix para más información sobre
+esa gente maja. El fichero @file{THANKS} enumera personas que han ayudado
+informando de errores, haciendose cargo de la infraestructura,
+proporcionando arte y temas, haciendo sugerencias, y más---¡gracias!
+
+
address@hidden
*********************************************************************
address@hidden Licencia de documentación libre GNU
address@hidden Licencia de documentación libre GNU
address@hidden licencia, GNU Free Documentation License
address@hidden fdl-1.3.texi
+
address@hidden
*********************************************************************
address@hidden Índice de conceptos
address@hidden Índice de conceptos
address@hidden cp
+
address@hidden Índice programático
address@hidden Índice programático
address@hidden tp fn
address@hidden vr fn
address@hidden fn
+
address@hidden
+
address@hidden Local Variables:
address@hidden ispell-local-dictionary: "american";
address@hidden End:
- branch master updated (e01bd1a -> f6beefa), guix-commits, 2019/04/23
- 08/08: doc: Refer to the es and zh_CN translations., guix-commits, 2019/04/23
- 06/08: nls: Fix guix-manual.zh_CN.po., guix-commits, 2019/04/23
- 01/08: guix system: Compute 'bootcfg' only for 'init' and 'reconfigure'., guix-commits, 2019/04/23
- 02/08: services: connman: Redirect output to a log file., guix-commits, 2019/04/23
- 04/08: doc: Add generated es.texi files.,
guix-commits <=
- 05/08: doc: Add zh_CN PO file., guix-commits, 2019/04/25
- 03/08: doc: Add Spanish translation., guix-commits, 2019/04/25