guix-manual 1.2.0-pre2 - en to ru translation catalogue (3068 entries)

note: #-#-#-#-#  contributing.pot (guix manual checkout)  #-#-#-#-# type: chapter #-#-#-#-#  guix.pot (guix manual checkout)  #-#-#-#-# type: menuentry
en: Contributing
ru: Содействие

note: type: Plain text
en: This project is a cooperative effort, and we need your help to make it grow! Please get in touch with us on @email{guix-devel@@gnu.org} and @code{#guix} on the Libera Chat IRC network.  We welcome ideas, bug reports, patches, and anything that may be helpful to the project.  We particularly welcome help on packaging (@pxref{Packaging Guidelines}).
ru: Этот проект развивается совместными усилиями. Нам нужна ваша помощь! Пожалуйста, свяжитесь с нами через @email{guix-devel@@gnu.org} и @code{#guix} в сети Freenode IRC. Мы приветствуем идеи, принимаем отчёты об ошибках, патчи и любую помощь проекту. Например, вы можете создавать описания пакетов  (@pxref{Packaging Guidelines}).

note: type: cindex
en: code of conduct, of contributors
ru: кодекс поведения, разработчиков

note: type: cindex
en: contributor covenant
ru: соглашение разработчика

note: type: Plain text
en: We want to provide a warm, friendly, and harassment-free environment, so that anyone can contribute to the best of their abilities.  To this end our project uses a ``Contributor Covenant'', which was adapted from @url{https://contributor-covenant.org/}.  You can find a local version in the @file{CODE-OF-CONDUCT} file in the source tree.
ru: Мы хотим создать теплую, дружелюбную среду, свободную от оскорблений, чтобы каждый мог внести свой вклад в меру своих возможностей. Для этого в нашем проекте используется ``Соглашение для авторов'',  основанное на @url {https://contributor-covenant.org/}. Вы можете найти локальную версию в файле @file{CODE-OF-CONDUCT} в исходном репозитории.

note: type: Plain text
en: Contributors are not required to use their legal name in patches and on-line communication; they can use any name or pseudonym of their choice.
ru: Участники не обязаны указывать реальные имена в патчах и в общении онлайн. Они могут пользоваться любым именем или псеводнимом по своему выбору.

note: type: section
en: Building from Git
ru: Сборка из Git

note: type: menuentry
en: The latest and greatest.
ru: Новейший и величайший.

note: type: section
en: Running Guix Before It Is Installed
ru: Запуск Guix перед его установкой

note: type: menuentry
en: Hacker tricks.
ru: Хакерские трюки.

note: type: section
en: The Perfect Setup
ru: Совершенная установка

note: type: menuentry
en: The right tools.
ru: Правильные инструменты.

note: type: section
en: Packaging Guidelines
ru: Принципы опакечивания

note: type: menuentry
en: Growing the distribution.
ru: Разрастание дистрибутива.

note: type: section
en: Coding Style
ru: Стиль кодирования

note: type: menuentry
en: Hygiene of the contributor.
ru: Гигиена участника.

note: type: section
en: Submitting Patches
ru: Отправка исправлений

note: type: menuentry
en: Share your work.
ru: Поделитесь своей работой.

note: type: section
en: Tracking Bugs and Patches
ru: Отслеживание ошибок и патчей

note: type: section
en: Commit Access
ru: Доступ к коммитам

note: type: menuentry
en: Pushing to the official repository.
ru: Внесение изменений в официальный репозиторий.

note: type: section
en: Updating the Guix Package
ru: Обновление пакета Guix

note: type: menuentry
en: Updating the Guix package definition.
ru: Обновление описания пакета guix.

note: type: section
en: Translating Guix
ru: Тестирование Guix.

note: type: menuentry
en: Make Guix speak your native language.
ru: Заставьте Guix говорить на вашем родном языке.

note: type: Plain text
en: If you want to hack Guix itself, it is recommended to use the latest version from the Git repository:
ru: Если вы собираетесь хакать сам Guix, рекомендуется использовать последнюю версию из репозитория Git:

note: type: cindex
en: authentication, of a Guix checkout
ru: аутентификация для проверки Guix

note: type: Plain text
en: How do you ensure that you obtained a genuine copy of the repository? To do that, run @command{guix git authenticate}, passing it the commit and OpenPGP fingerprint of the @dfn{channel introduction} (@pxref{Invoking guix git authenticate}):
ru: Как убедиться, что вы получили подлинную копию репозитория? Для этого запустите @command{guix git authenticate}, передав ему коммит и отпечаток ключа OpenPGP @dfn{channel introduction} (@pxref{Invoking guix git authenticate}):

note: type: Plain text
en: This command completes with exit code zero on success; it prints an error message and exits with a non-zero code otherwise.
ru: Эта команда возвращает нуль в случае успеха; в противном случае будет напечатано сообщение об ошибке и команда завершит работу, вернув ненулевой код.

note: type: Plain text
en: As you can see, there is a chicken-and-egg problem: you first need to have Guix installed.  Typically you would install Guix System (@pxref{System Installation}) or Guix on top of another distro (@pxref{Binary Installation}); in either case, you would verify the OpenPGP signature on the installation medium.  This ``bootstraps'' the trust chain.
ru: Как видите, здесь возникает проблема курицы и яйца: сначала вам нужно установить Guix. Обычно вы устанавливаете Guix System (@pxref{System Installation}) или Guix поверх другого дистрибутива (@pxref{Binary Installation}); в любом случае вы должны проверить подпись OpenPGP на установочном носителе.  Это ``запускает'' (``bootstraps'') цепочку доверия.

note: type: Plain text
en: The easiest way to set up a development environment for Guix is, of course, by using Guix! The following command starts a new shell where all the dependencies and appropriate environment variables are set up to hack on Guix:
ru: Самый простой способ установить развернуть среду разработки для Guix — это, конечно, использовать Guix! Следующая команда запустит новую оболочку во всеми зависимостями и необходимыми переменными окружения:

note: type: Plain text
en: @xref{Invoking guix shell}, for more information on that command.
ru: Подробные сведения об этой команде см. в @xref{Invoking guix shell}.

note: type: Plain text
en: If you are unable to use Guix when building Guix from a checkout, the following are the required packages in addition to those mentioned in the installation instructions (@pxref{Requirements}).
ru: Если вам Guix не удаётся использовать при сборке из чекаута, установите следующие пакеты в дополнение к тем, что были указаны в инструкции по установке (@pxref{Требования}).

note: type: Plain text
en: On Guix, extra dependencies can be added by instead running @command{guix shell}:
ru: В Guix дополнительные зависимости можно добавить, запустив @command{guix shell}:

note: type: Plain text
en: it probably means that Autoconf couldn’t find @file{pkg.m4}, which is provided by pkg-config.  Make sure that @file{pkg.m4} is available.  The same holds for the @file{guile.m4} set of macros provided by Guile.  For instance, if you installed Automake in @file{/usr/local}, it wouldn’t look for @file{.m4} files in @file{/usr/share}.  In that case, you have to invoke the following command:
ru: это означает, скорее всего, что Autoconf не смог найти файл @file{pkg.m4}, который предоставляется pkg-config. Убедитесь, что файл @file{pkg.m4} доступен. То же относится к @file{guile.m4}, набору макросов, предоставляемых Guile. Например, если вы установили Automake в @file{/usr/local}, он не будет искать файлы @file{.m4} в @file{/usr/share}. Тогда нужно выполнить следующую команду:

note: type: Plain text
en: @xref{Macro Search Path,,, automake, The GNU Automake Manual}, for more information.
ru: см. @xref{Macro Search Path,,, automake, The GNU Automake Manual}, чтобы получить больше информации.

note: type: Plain text
en: From there on, you can authenticate all the commits included in your checkout by running:
ru: После этого вы можете аутентифицировать все проверенные коммиты, запустив:

note: type: Plain text
en: The first run takes a couple of minutes, but subsequent runs are faster.
ru: Первый запуск занимает пару минут, но последующие запускаются быстрее.

note: type: Plain text
en: Or, when your configuration for your local Git repository doesn't match the default one, you can provide the reference for the @code{keyring} branch through the variable @code{GUIX_GIT_KEYRING}.  The following example assumes that you have a Git remote called @samp{myremote} pointing to the official repository:
ru: Или, если ваша конфигурация для локального git репозиотория не соответствует конфигурации по умолчанию, вы можете укащать ссылку для ветки @code{keyring} с помощью переменной @code{GUIX_GIT_KEYRING}. В следующем примере предполагается, что у ваш git remote с именем @samp{myremote}, указывающий на официальный репозиторий:

note: type: quotation
en: Note
ru: Примечание

note: type: quotation
en: You are advised to run @command{make authenticate} after every @command{git pull} invocation.  This ensures you keep receiving valid changes to the repository.
ru: Рекомендуется запускать @command{make authenticate} после каждого вызова @command{git pull}. Это гарантирует, что вы продолжаете получать актуальные изменения в репозитории.

note: type: Plain text
en: In order to keep a sane working environment, you will find it useful to test the changes made in your local source tree checkout without actually installing them.  So that you can distinguish between your ``end-user'' hat and your ``motley'' costume.
ru: Чтобы держать в порядке рабочее окружение, удобно тестировать изменения, сделанные в вашем локальном дереве исходников, без их установки. Так вы сможете отличить 'наряд' вашего конечного пользователя от 'пёстрого костюма'.

note: type: Plain text
en: To that end, all the command-line tools can be used even if you have not run @code{make install}.  To do that, you first need to have an environment with all the dependencies available (@pxref{Building from Git}), and then simply prefix each command with @command{./pre-inst-env} (the @file{pre-inst-env} script lives in the top build tree of Guix; it is generated by running @command{./bootstrap} followed by @command{./configure}).  As an example, here is how you would build the @code{hello} package as defined in your working tree (this assumes @command{guix-daemon} is already running on your system; it's OK if it's a different version):
ru: С этой целью можно использовать все инструменты командной строки, даже если вы не запускали @code{make install}.  Для этого вам сначала нужно создать окружение со всеми доступными зависимостями (@pxref{Building from Git}), и затем просто начните каждую команду с @command{./pre-inst-env} (скрипт @file{pre-inst-env} находится на верху дерева сборки Guix; он генерируется запуском @command{./bootstrap}, за которым следует @command{./configure}).  В качестве примера, вот как вы собрали бы пакет @code{hello} (подразумевается, что @command{guix-daemon} уже запущена на вашей системе; ничего страшного, если это другая версия):

note: type: Plain text
en: Similarly, an example for a Guile session using the Guix modules:
ru: Аналогично, пример для Guile сессии с использованием модулей Guix:

note: type: cindex
en: read-eval-print loop
ru: цикл чтение-вычисление-вывод

note: type: Plain text
en: If you are hacking on the daemon and its supporting code or if @command{guix-daemon} is not already running on your system, you can launch it straight from the build tree@footnote{The @option{-E} flag to @command{sudo} guarantees that @code{GUILE_LOAD_PATH} is correctly set such that @command{guix-daemon} and the tools it uses can find the Guile modules they need.}:
ru: Если вы изучаете демона и его исзодники, или если @command{guix-daemon} еще не запущена в вашей системе, вы можете запустить его прямо из дерева сборки@footnote{Флаг @option{-E} команды @command{sudo} гарантирует, что @code{GUILE_LOAD_PATH} настроен правильно, так что @command{guix-daemon} и инструменты, которые он использует, могут найти необходимые им модули Guile.}:

note: type: Plain text
en: The @command{pre-inst-env} script sets up all the environment variables necessary to support this, including @env{PATH} and @env{GUILE_LOAD_PATH}.
ru: Скрипт @command{pre-inst-env} устанавливает все переменные окружения, которые необходимы для этой задачи, включая @env{PATH} и @env{GUILE_LOAD_PATH}.

note: type: Plain text
en: Note that @command{./pre-inst-env guix pull} does @emph{not} upgrade the local source tree; it simply updates the @file{~/.config/guix/current} symlink (@pxref{Invoking guix pull}).  Run @command{git pull} instead if you want to upgrade your local source tree.
ru: Заметим, что @command{./pre-inst-env guix pull} @emph{не} обновляет локальное дерево исходников. Эта команда только обновляет символическую ссылку @file{~/.config/guix/current} (@pxref{Invoking guix pull}). Выполните @command{git pull}, если вы хотите обновить локальное дерево исходников.

note: type: Plain text
en: The Perfect Setup to hack on Guix is basically the perfect setup used for Guile hacking (@pxref{Using Guile in Emacs,,, guile, Guile Reference Manual}).  First, you need more than an editor, you need @url{https://www.gnu.org/software/emacs, Emacs}, empowered by the wonderful @url{https://nongnu.org/geiser/, Geiser}.  To set that up, run:
ru: Совершенная установка для программирования Guix --- это лучший способ разработки Guix (@pxref{Using Guile in Emacs,,, guile, Guile Reference Manual}). Во-первых, здесь нужен мощный текстовый редактор, нужен @url{https://www.gnu.org/software/emacs, Emacs}, дополненный замечательным @url{https://nongnu.org/geiser/, Geiser}. Чтобы установить это, введите:

note: type: Plain text
en: Geiser allows for interactive and incremental development from within Emacs: code compilation and evaluation from within buffers, access to on-line documentation (docstrings), context-sensitive completion, @kbd{M-.} to jump to an object definition, a REPL to try out your code, and more (@pxref{Introduction,,, geiser, Geiser User Manual}).  For convenient Guix development, make sure to augment Guile’s load path so that it finds source files from your checkout:
ru: Geiser добавляет возможности интерактивной пошаговой разработки внутри Emacs: компиляция и запуск кода в буферах, доступ к онлайн-документации (docstrings), контекстные дополнения, @kbd{M-.} для перемещения к определениям объектов, REPL для тестирования кода и многое другое (@pxref{Introduction,,, geiser, Geiser User Manual}). Для удобной разработки Guix обязательно настройте Guile для загрузки файлов из вашей инстанции:

note: type: Plain text
en: To actually edit the code, Emacs already has a neat Scheme mode.  But in addition to that, you must not miss @url{https://www.emacswiki.org/emacs/ParEdit, Paredit}.  It provides facilities to directly operate on the syntax tree, such as raising an s-expression or wrapping it, swallowing or rejecting the following s-expression, etc.
ru: Вообще, для редактирования кода, в Emacs уже есть Scheme mode.  Но также обратите внимание на @url{https://www.emacswiki.org/emacs/ParEdit, Paredit}. Данный пакет предоставляет средства для непосредственной работы с синтаксическим деревом, такие как объявление s-выражений, их упаковка, отклонение следующего s-выражения и т.д.

note: type: cindex
en: code snippets
ru: сниппеты кода

note: type: cindex
en: templates
ru: шаблоны

note: type: cindex
en: reducing boilerplate
ru: сокращение шаблонов

note: type: Plain text
en: The commit message snippets depend on @url{https://magit.vc/, Magit} to display staged files.  When editing a commit message type @code{add} followed by @kbd{TAB} to insert a commit message template for adding a package; type @code{update} followed by @kbd{TAB} to insert a template for updating a package; type @code{https} followed by @kbd{TAB} to insert a template for changing the home page URI of a package to HTTPS.
ru: Тексты сообщений коммитов зависят от отображения затронутых файлов @url{https://magit.vc/, Magit}. Во время редактирования сообщения коммита типа @code{add} нажмите @kbd{TAB} после его ввода, чтобы вставить шаблон сообщения коммита добавления пакета; редактируя тип @code{update}, нажмите @kbd{TAB}, чтобы вставить шаблон обновления пакета; тип @code{https} - кнопка @kbd{TAB} вставит шаблон изменения адреса домашней страницы пакета на HTTPS.

note: type: Plain text
en: The main snippet for @code{scheme-mode} is triggered by typing @code{package...} followed by @kbd{TAB}.  This snippet also inserts the trigger string @code{origin...}, which can be expanded further.  The @code{origin} snippet in turn may insert other trigger strings ending on @code{...}, which also can be expanded further.
ru: Основной код для @code{scheme-mode} вызывается при вводе @code{package...} и кнопки @kbd{TAB}. Этот код также вставляет строку триггера @code{origin...}, который может быть расширен в дальнейшем. Код @code{origin...}, в свою очередь, может вставить строки других триггеров, завершающихся @code{...}, который также может быть расширен в дальнейшем.

note: type: cindex
en: insert or update copyright
ru: внести или обновить авторские права

note: type: Plain text
en: We additionally provide insertion and automatic update of a copyright in @file{etc/copyright.el}.  You may want to set your full name, mail, and load a file.
ru: Мы дополнительно обеспечиваем автоматическое обновление информации об авторских правах в @file{etc/copyright.el}.  Вы можете указать свое полное имя, почту и загрузить файл.

note: type: Plain text
en: To insert a copyright at the current line invoke @code{M-x guix-copyright}.
ru: Чтобы ввести авторское право в текущей строке, вызовите @code{M-x guix-copyright}.

note: type: Plain text
en: To update a copyright you need to specify a @code{copyright-names-regexp}.
ru: Для обновления авторских прав необходимо указать @code{copyright-names-regexp}.

note: type: Plain text
en: You can check if your copyright is up to date by evaluating @code{M-x copyright-update}.  If you want to do it automatically after each buffer save then add @code{(add-hook 'after-save-hook 'copyright-update)} in Emacs.
ru: Вы можете проверить актуальность своих авторских прав, вызвав @code{M-x copyright-update}. Если вы хотите делать это автоматически после каждого сохранения в буфер, то добавьте @code{(add-hook 'after-save-hook 'copyright-update)} в Emacs.

note: type: cindex
en: packages, creating
ru: создание, пакетов

note: type: Plain text
en: The GNU distribution is nascent and may well lack some of your favorite packages.  This section describes how you can help make the distribution grow.
ru: Дистрибутив GNU - в процессе возникновения и может не содержать ваши любимые пакеты. Этот раздел описывает как можно помочь с развитием дистрибутива.

note: type: Plain text
en: Free software packages are usually distributed in the form of @dfn{source code tarballs}---typically @file{tar.gz} files that contain all the source files.  Adding a package to the distribution means essentially two things: adding a @dfn{recipe} that describes how to build the package, including a list of other packages required to build it, and adding @dfn{package metadata} along with that recipe, such as a description and licensing information.
ru: Пакеты свободного программного обеспечения обычно распространяются в виде @dfn{архивов исходного кода} (файлы @file{tar.gz}), которые содержат все исходные файлы. Добавить пакет в дистрибутив означает, по существу, две вещи: добавление @dfn{рецепта}, в котором обозначено, как собирать пакет, включая список других пакетов, необходимых для сборки данного, а также добавление @dfn{метаданных пакета} вместе с рецептом, как например, описание информации о лицензировании.

note: type: Plain text
en: In Guix all this information is embodied in @dfn{package definitions}.  Package definitions provide a high-level view of the package.  They are written using the syntax of the Scheme programming language; in fact, for each package we define a variable bound to the package definition, and export that variable from a module (@pxref{Package Modules}).  However, in-depth Scheme knowledge is @emph{not} a prerequisite for creating packages.  For more information on package definitions, @pxref{Defining Packages}.
ru: В Guix вся эта информация включена в @dfn{определения пакетов}. Определения пакетов представляют собой высокоуровневый обзор пакета. Они написаны с использованием синтаксиса языка программирования Scheme. Для каждого пакета задаётся набор переменных, которые составляют определение пакета, и затем это определение пакета экспортируется из модуля (@pxref{Package Modules}). Однако основательные знания Scheme @emph{not} не обязательны для создания пакетов. Для информации об определении пакетов см. @pxref{Defining Packages}.

note: type: Plain text
en: Once a package definition is in place, stored in a file in the Guix source tree, it can be tested using the @command{guix build} command (@pxref{Invoking guix build}).  For example, assuming the new package is called @code{gnew}, you may run this command from the Guix build tree (@pxref{Running Guix Before It Is Installed}):
ru: Когда определение пакета создано, сохранено в файле в дереве исходников Guix, оно может быть протестировано командой @command{guix build} (@pxref{Invoking guix build}). Например, допустим, новый пакет называется @code{gnew}, тогда можно запустить эту команду из дерева сборки Guix (@pxref{Running Guix Before It Is Installed}):

note: type: Plain text
en: Using @code{--keep-failed} makes it easier to debug build failures since it provides access to the failed build tree.  Another useful command-line option when debugging is @code{--log-file}, to access the build log.
ru: Использование @code{--keep-failed} помогает при отладке ошибок сборки, так как эта опция предоставляет доступ к дереву неудачных сборок. Другая полезная опция командной строки при отладке - @code{--log-file}, которая даёт доступ к логу сборки.

note: type: Plain text
en: If the package is unknown to the @command{guix} command, it may be that the source file contains a syntax error, or lacks a @code{define-public} clause to export the package variable.  To figure it out, you may load the module from Guile to get more information about the actual error:
ru: Если пакет не известен команде @command{guix}, это может означать, что файл исходника содержит синтаксическую ошибку или не имеет предложения @code{define-public}, которое экспортирует переменную пакета. Чтобы разобраться, можно загрузить модуль из Guile и получить больше информации о текущей ошибке:

note: type: Plain text
en: Once your package builds correctly, please send us a patch (@pxref{Submitting Patches}).  Well, if you need help, we will be happy to help you too.  Once the patch is committed in the Guix repository, the new package automatically gets built on the supported platforms by @url{https://@value{SUBSTITUTE-SERVER-1}, our continuous integration system}.
ru: Если ваш пакет собирается без ошибок, пришлите нам свой патч (@pxref{Submitting Patches}). Если вам нужна помощь, мы будем рады помочь вам со своей стороны. После фиксации патча в репозитории Guix новый пакет будет автоматически собран для всех поддерживаемых платформ нашей @url{https://@value{SUBSTITUTE-SERVER-1} CI-системой}.

note: type: cindex
en: substituter
ru: заменяющий

note: type: Plain text
en: Users can obtain the new package definition simply by running @command{guix pull} (@pxref{Invoking guix pull}).  When @code{@value{SUBSTITUTE-SERVER-1}} is done building the package, installing the package automatically downloads binaries from there (@pxref{Substitutes}).  The only place where human intervention is needed is to review and apply the patch.
ru: Пользователи могут получать новые доступные определения пакетов простым запуском @command{guix pull} (@pxref{Invoking guix pull}). Если @code{@value{SUBSTITUTE-SERVER-1}} выполнил сборку пакета, установка пакета выполнит автоматическое скачивание бинарных файлов оттуда (@pxref{Substitutes}). Единственное место, где нужна активность человека, - обзор и применение патча.

note: type: subsection
en: Software Freedom
ru: Свобода программного обеспечения

note: type: menuentry
en: What may go into the distribution.
ru: Что может быть принято в дистрибутив.

note: type: subsection
en: Package Naming
ru: Как называть пакеты

note: type: menuentry
en: What's in a name?
ru: Что может быть в имени?

note: type: subsection
en: Version Numbers
ru: Номера версий

note: type: menuentry
en: When the name is not enough.
ru: Когда имени не достаточно.

note: type: subsection
en: Synopses and Descriptions
ru: Краткие обзоры и описания

note: type: menuentry
en: Helping users find the right package.
ru: Помощь пользователю в поиске нужного пакета.

note: type: subsection
en: Snippets versus Phases
ru: Сниппеты против Фаз

note: type: menuentry
en: Whether to use a snippet, or a build phase.
ru: Где использовать сниппет, а где фазу сборки.

note: type: subsection
en: Emacs Packages
ru: Пакеты Emacs

note: type: menuentry
en: Your Elisp fix.
ru: Ваш Elisp фикс.

note: type: subsection
en: Python Modules
ru: Модули Python

note: type: menuentry
en: A touch of British comedy.
ru: Английский юмор.

note: type: subsection
en: Perl Modules
ru: Модули Perl

note: type: menuentry
en: Little pearls.
ru: Жемчужинки.

note: type: subsection
en: Java Packages
ru: Пакеты Java

note: type: menuentry
en: Coffee break.
ru: Кофе-брейк.

note: type: subsection
en: Rust Crates
ru: Rust Crates пакеты

note: type: menuentry
en: Beware of oxidation.
ru: Остерегайтесь окисления.

note: type: subsection
en: Fonts
ru: Шрифты

note: type: menuentry
en: Fond of fonts.
ru: Любителям шрифтов.

note: type: cindex
en: free software
ru: свободное программное обеспечение

note: type: Plain text
en: The GNU operating system has been developed so that users can have freedom in their computing.  GNU is @dfn{free software}, meaning that users have the @url{https://www.gnu.org/philosophy/free-sw.html,four essential freedoms}: to run the program, to study and change the program in source code form, to redistribute exact copies, and to distribute modified versions.  Packages found in the GNU distribution provide only software that conveys these four freedoms.
ru: Операционная система GNU разработана, чтобы пользователи имели свободу при работе за компьютером. GNU --- это @dfn{свободное программное обеспечение}, то есть пользователи могут иметь @url{http://www.gnu.org/philosophy/free-sw.html,четыре важнейшие свободы}: запускать программу, изучать и изменять исходный код программы, распространять самостоятельно точные копии и распространять изменённые версии. Пакеты, включенные в дистрибутив GNU, поставляют только программное обеспечение, которое даёт эти четыре свободы.

note: type: Plain text
en: In addition, the GNU distribution follow the @url{https://www.gnu.org/distros/free-system-distribution-guidelines.html,free software distribution guidelines}.  Among other things, these guidelines reject non-free firmware, recommendations of non-free software, and discuss ways to deal with trademarks and patents.
ru: Также дистрибутив GNU следует @url{http://www.gnu.org/distros/free-system-distribution-guidelines.html,рекомендациям для свободных дистрибутивов}. Эти рекомендации, среди прочих указаний, также отклоняют несвободные встроенные программы, рекомендации несвободного программного обеспечения и содержат доводы о том, как взаимодействовать с торговыми марками и патентами.

note: type: Plain text
en: Some otherwise free upstream package sources contain a small and optional subset that violates the above guidelines, for instance because this subset is itself non-free code.  When that happens, the offending items are removed with appropriate patches or code snippets in the @code{origin} form of the package (@pxref{Defining Packages}).  This way, @code{guix build --source} returns the ``freed'' source rather than the unmodified upstream source.
ru: Но тем не менее, некоторые источники пакетов в оригинале содержат небольшие необязательные компоненты, которые нарушают указанные рекомендации, например, это может быть несвободный код. Если это происходит, такие компоненты удаляются применением соответствующих патчей или сниппетов в @code{исходный} код пакета @pxref{Defining Packages}). Так @code{guix build --source} возвращает "восстановленный свободный" исходный код вместо изначального исходника.

note: type: cindex
en: package name
ru: имя пакета

note: type: Plain text
en: A package actually has two names associated with it.  First, there is the name of the @emph{Scheme variable}, the one following @code{define-public}.  By this name, the package can be made known in the Scheme code, for instance as input to another package.  Second, there is the string in the @code{name} field of a package definition.  This name is used by package management commands such as @command{guix package} and @command{guix build}.
ru: Пакет, в действительности, имеет два имени, ассоциированных с ним: первое --- это имя @emph{переменной Scheme}, которая указана в @code{define-public}. Это имя делает пакет доступным в коде Scheme, например, может использоваться как входные данные другого пакета. Второе --- это строка в поле @code{name} в определении пакета. Это имя используется командами управления пакетами, например, @command{guix package} и @command{guix build}.

note: type: Plain text
en: Both are usually the same and correspond to the lowercase conversion of the project name chosen upstream, with underscores replaced with hyphens.  For instance, GNUnet is available as @code{gnunet}, and SDL_net as @code{sdl-net}.
ru: Оба обычно представляют собой строки в нижнем регистре, содержащие имя оригинального проекта с дефисами вместо символов нижнего подчёркивания. Например, GNUnet доступен как @code{gnunet}, а SDL_net --- как @code{sdl-net}.

note: type: Plain text
en: A noteworthy exception to this rule is when the project name is only a single character, or if an older maintained project with the same name already exists---regardless of whether it has already been packaged for Guix.  Use common sense to make such names unambiguous and meaningful.  For example, Guix's package for the shell called ``s'' upstream is @code{s-shell} and @emph{not} @code{s}.  Feel free to ask your fellow hackers for inspiration.
ru: Заслуживающим внимания исключением из этого правила является случай, когда имя проекта состоит только из одного символа, или если уже существует более старый поддерживаемый проект с таким же именем---независимо от того, был ли он уже упакован для Guix.  Пользуйтесь здравым смыслом, чтобы сделать такие имена однозначными и значимыми.  Например, пакет Guix для оболочки (shell) под названием ``s ''---это @code{s-shell} и @emph{нет} @code{s}.  Не стесняйтесь обращаться к своим коллегам-хакерам за вдохновением.

note: type: Plain text
en: We do not add @code{lib} prefixes for library packages, unless these are already part of the official project name.  But @pxref{Python Modules} and @ref{Perl Modules} for special rules concerning modules for the Python and Perl languages.
ru: Мы не добавляем приставку @code{lib} для пакетов библиотек, несмотря на то, что это уже часть официального имени пакета. Но для @pxref{Python Modules} и @ref{Perl Modules} есть исключения, касающиеся модулей для языков Python и Perl.

note: type: Plain text
en: Font package names are handled differently, @pxref{Fonts}.
ru: При именовании пакетов шрифтов имена меняются, @pxref{Fonts}.

note: type: cindex
en: package version
ru: версия пакета

note: type: Plain text
en: We usually package only the latest version of a given free software project.  But sometimes, for instance for incompatible library versions, two (or more) versions of the same package are needed.  These require different Scheme variable names.  We use the name as defined in @ref{Package Naming} for the most recent version; previous versions use the same name, suffixed by @code{-} and the smallest prefix of the version number that may distinguish the two versions.
ru: Обычно мы опакечиваем только последнюю версию некоторого программного обеспечения. Но иногда, например, при наличии несовместимых версий библиотек, нужны две (или более) версии одного пакета. Это требует разных имён переменных Scheme. Мы используем имя, определённое в @ref{Package Naming}, для самой последней версии; предыдущие версии используют такое же имя с добавлением @code{-} и номера версии, что позволяет отличить две версии.

note: type: Plain text
en: The name inside the package definition is the same for all versions of a package and does not contain any version number.
ru: Имя внутри описания пакета остаётся одно для всех версий пакета и не содержит номера версии.

note: type: Plain text
en: For instance, the versions 2.24.20 and 3.9.12 of GTK+ may be packaged as follows:
ru: Например, версии GTK+ 2.24.20 и 3.9.12 могут опакечиваться так:

note: type: Plain text
en: If we also wanted GTK+ 3.8.2, this would be packaged as
ru: Если нам также нужен GTK+ 3.8.2, он будет размещён в пакете

note: type: cindex
en: version number, for VCS snapshots
ru: номер версии, для снимков СКВ

note: type: Plain text
en: Occasionally, we package snapshots of upstream's version control system (VCS) instead of formal releases.  This should remain exceptional, because it is up to upstream developers to clarify what the stable release is.  Yet, it is sometimes necessary.  So, what should we put in the @code{version} field?
ru: Порой мы опакечиваем снепшоты исходников из системы контроля версий (СКВ) вместо официальных релизов. Это остаётся исключением, потому что только разработчики оригинальных программ решают, что является стабильным релизом. Иногда это имеет значение. Что же мы должны писать в поле @code{версия}?

note: type: Plain text
en: Clearly, we need to make the commit identifier of the VCS snapshot visible in the version string, but we also need to make sure that the version string is monotonically increasing so that @command{guix package --upgrade} can determine which version is newer.  Since commit identifiers, notably with Git, are not monotonically increasing, we add a revision number that we increase each time we upgrade to a newer snapshot.  The resulting version string looks like this:
ru: Ясно, что нужно сделать отображение идентификатора коммита снепшота СКВ внутри строки версии, но мы также должны убедиться, что строка "версия" монотонно увеличивается, так чтобы @command{guix package --upgrade} могла определить, какая версия новее. Так как идентификаторы коммитов, что точно, Git, не увеличиваются, мы добавляем номер ревизии, которую мы увеличиваем каждый раз, когда мы обновляем до нового снепшота. Результирующая строка версии выглядит так:

note: type: example
en: 2.0.11-3.cabba9e
      ^    ^    ^
      |    |    `-- upstream commit ID
      |    |
      |    `--- Guix package revision
      |
    latest upstream version
ru: 2.0.11-3.cabba9e
      ^    ^    ^
      |    |    `-- ID коммита оригинала
      |    |
      |    `--- версия пакета Guix 
      |
    последняя версия оригинала

note: type: cindex
en: package description
ru: описание пакета

note: type: cindex
en: package synopsis
ru: краткий обзор пакета

note: type: Plain text
en: As we have seen before, each package in GNU@tie{}Guix includes a synopsis and a description (@pxref{Defining Packages}).  Synopses and descriptions are important: They are what @command{guix package --search} searches, and a crucial piece of information to help users determine whether a given package suits their needs.  Consequently, packagers should pay attention to what goes into them.
ru: Как мы видели ранее, каждый пакет в GNU@tie{}Guix включает краткое описание и полное описание (@pxref{Defining Packages}). Краткие описания и полные описания важны: по ним производится поиск @command{guix package --search}, и это важная информация, которая помогает пользователям определить, насколько пакет соответствует их потребностям. Следовательно, пакеты должны отвечать требованиям, предъявляемым к ним.

note: type: Plain text
en: Synopses must start with a capital letter and must not end with a period.  They must not start with ``a'' or ``the'', which usually does not bring anything; for instance, prefer ``File-frobbing tool'' over ``A tool that frobs files''.  The synopsis should say what the package is---e.g., ``Core GNU utilities (file, text, shell)''---or what it is used for---e.g., the synopsis for GNU@tie{}grep is ``Print lines matching a pattern''.
ru: Краткие описания должны начинаться с прописной буквы и не должны заканчиваться точкой. Они не должны начинаться с артикля (англ. "a" или "the"), что обычно ничего не значит; например, лучше начать "File-frobbing tool" вместо "A tool that frobs files".  Краткое описание должно сообщать о том, что представляет собой пакет, то есть: "Основные утилиты GNU (файлы, текст, оболочка)", - или для чего он используется, то есть краткое описание для GNU@tie{}grep таково: "Печать строк, содержащих паттерн".

note: type: Plain text
en: Keep in mind that the synopsis must be meaningful for a very wide audience.  For example, ``Manipulate alignments in the SAM format'' might make sense for a seasoned bioinformatics researcher, but might be fairly unhelpful or even misleading to a non-specialized audience.  It is a good idea to come up with a synopsis that gives an idea of the application domain of the package.  In this example, this might give something like ``Manipulate nucleotide sequence alignments'', which hopefully gives the user a better idea of whether this is what they are looking for.
ru: Помните, что краткое описание должно быть понятным для очень широкой аудитории. Например, "Манипулирование выравниванием в формате SAM" может быть понятно продвинутым исследователям в области биоинформатики, но совершенно бесполезно или может ввести в заблужение не специалистов. Хорошая идея --- включать в краткое описание идею группы приложений, к которой относится пакет. В данном примере можно предложить такой вариант: "Манипулирование выравниванием нуклеотидных последовательностей", что, в целом, даёт пользователю лучшее представление о том, на что они смотрят.

note: type: Plain text
en: Descriptions should take between five and ten lines.  Use full sentences, and avoid using acronyms without first introducing them.  Please avoid marketing phrases such as ``world-leading'', ``industrial-strength'', and ``next-generation'', and avoid superlatives like ``the most advanced''---they are not helpful to users looking for a package and may even sound suspicious.  Instead, try to be factual, mentioning use cases and features.
ru: Описания должны занимать от 5 до 10 строк. Используйте полные предложения, использование аббревиатур возможно при их первичной расшифровке. Пожалуйста, не пишите маркетинговые фразы типа "мировой лидер", "промышленный", "следующего поколения", также избегайте признаки превосходства, как "самый продвинутый" --- это не помогает пользователям отыскать пакет, и возможно, звучит сомнительно. Вместо этого рассказывайте о фактах, упоминая особенности и применение.

note: type: cindex
en: Texinfo markup, in package descriptions
ru: Разметка Texinfo, в описаниях пакетов

note: type: Plain text
en: Synopses and descriptions are translated by volunteers @uref{https://translate.fedoraproject.org/projects/guix/packages, at Weblate} so that as many users as possible can read them in their native language.  User interfaces search them and display them in the language specified by the current locale.
ru: Синопсисы и описания перевелены волонтерами @uref{https://translate.fedoraproject.org/projects/guix/packages, at Weblate} чтобы как можно больше пользователей могли читать их на своем родном языке.  Пользовательские интерфейсы ищут их и отображают на языке, заданном текущей локалью.

note: type: Plain text
en: To allow @command{xgettext} to extract them as translatable strings, synopses and descriptions @emph{must be literal strings}.  This means that you cannot use @code{string-append} or @code{format} to construct these strings:
ru: Чтобы дать возможность @command{xgettext} извлекать их как текст для перевода, краткие и полные описания  @emph{должны быть буквенными строками}.  Это означает, что нельзя пользоваться @code{string-append} или @code{format} при составлении этих строк:

note: type: lisp
en: (package
      ;; @dots{}
      (synopsis "This is translatable")
      (description (string-append "This is " "*not*" " translatable.")))
ru: (package
      ;; @dots{}
      (synopsis "Эту строку можно переводить")
      (description (string-append "Эта строка " "*не поддерживает*" " перевод.")))

note: type: Plain text
en: Translation is a lot of work so, as a packager, please pay even more attention to your synopses and descriptions as every change may entail additional work for translators.  In order to help them, it is possible to make recommendations or instructions visible to them by inserting special comments like this (@pxref{xgettext Invocation,,, gettext, GNU Gettext}):
ru: Перевод --- трудоёмкая работа. Как автор пакета, пожалуйста, уделите внимание краткому и полному описаниям, потому что каждое изменение влечет дополнительную работу для переводчиков. Чтобы помочь им, можно сделать рекомендации или инструкции, вставив специальные комментарии, как этот (@pxref{xgettext Invocation,,, gettext, GNU Gettext}):

note: type: cindex
en: snippets, when to use
ru: сниппеты, где использовать

note: type: Plain text
en: The boundary between using an origin snippet versus a build phase to modify the sources of a package can be elusive.  Origin snippets are typically used to remove unwanted files such as bundled libraries, nonfree sources, or to apply simple substitutions.  The source derived from an origin should produce a source that can be used to build the package on any system that the upstream package supports (i.e., act as the corresponding source).  In particular, origin snippets must not embed store items in the sources; such patching should rather be done using build phases.  Refer to the @code{origin} record documentation for more information (@pxref{origin Reference}).
ru: Граница между использованием сниппета и фазы сборки для изменения исходных кодов пакета может быть неуловимой. Обычно сниппеты используются для удаления нежелательных файлов, таких как связанные библиотеки, несвободные исходники, или для простых замен. Исходник, производный от оригинального исходника, должен создавать исходник, который можно использовать для сборки пакета в любой системе, поддерживаемой апстримом пакета. (т.е. действовать как соответствующий исходник).  В частности, сниппеты не должны встраивать элементы хранилища в источники; такое исправление лучше производить на этапах сборки.  Обратитель к @code{origin} документации за дополнительной информацией (@pxref{origin Reference}).

note: type: cindex
en: emacs, packaging
ru: Пакеты Emacs

note: type: cindex
en: elisp, packaging
ru: лицензии пакетов

note: type: Plain text
en: Emacs packages should preferably use the Emacs build system (@pxref{emacs-build-system}), for uniformity and the benefits provided by its build phases, such as the auto-generation of the autoloads file and the byte compilation of the sources.  Because there is no standardized way to run a test suite for Emacs packages, tests are disabled by default.  When a test suite is available, it should be enabled by setting the @code{#:tests?} argument to @code{#true}.  By default, the command to run the test is @command{make check}, but any command can be specified via the @code{#:test-command} argument.  The @code{#:test-command} argument expects a list containing a command and its arguments, to be invoked during the @code{check} phase.
ru: Emacs пакеты должны предпочтительно использовать систему сборки Emacs (@pxref{emacs-build-system}), для единообразия и преимуществ, предоставляемых этапами сборки, таких как автоматическое создание файла автозагрузки и байтовая компиляция исходников.  Поскольку не существует стандартизированного способа запуска набора тестов для пакетов Emacs, тесты по умолчанию отключены.  Когда доступен набор тестов, его следует включить, дав аргументу @code{#:tests?} значение @code{#true}.  По умолчанию команда для запуска теста---@command{make check}, но может быть использована любая команда , указанная в аргументе @code{#:test-command}.  Аргумент @code{#:test-command} ожидает, что список, содержащий команду и ее аргументы, будет вызван во время @code{check} фазы.

note: type: Plain text
en: The Elisp dependencies of Emacs packages are typically provided as @code{propagated-inputs} when required at run time.  As for other packages, build or test dependencies should be specified as @code{native-inputs}.
ru: Elisp зависимости пакетов Emacs обычно предоставляются как @code{propagated-inputs}, если они необходимы во время работы программы.  Что касается других пакетов, зависимости сборки или тестирования должны быть указаны как @code{native-inputs}.

note: type: Plain text
en: Emacs packages sometimes depend on resources directories that should be installed along the Elisp files.  The @code{#:include} argument can be used for that purpose, by specifying a list of regexps to match.  The best practice when using the @code{#:include} argument is to extend rather than override its default value (accessible via the @code{%default-include} variable).  As an example, a yasnippet extension package typically include a @file{snippets} directory, which could be copied to the installation directory using:
ru: Пакеты Emacs иногда зависят от каталогов с ресурсами, которые должны быть установлены вместе с файлами Elisp. Аргумент @code{#:include} можно использовать для этой цели, указав список совпадающих регулярных выражений.  Лучшая практика при использовании аргумента @code{#:include} заключается в расширении, а не изменении его значения по умолчанию (доступный через переменную @code{%default-include} variable).  Например, пакет расширения yasnippet обычно включает каталог @file{snippets}, который можно скопировать в каталог установки, используя:

note: type: Plain text
en: When encountering problems, it is wise to check for the presence of the @code{Package-Requires} extension header in the package main source file, and whether any dependencies and their versions listed therein are satisfied.
ru: При возникновении проблем целесообразно проверить наличие заголовка расширения @code{Package-Requires} в основном исходном файле пакета, а также соответствие перечисленным в нем зависимостям и их версиям.

note: type: Plain text
en: We currently package Python 2 and Python 3, under the Scheme variable names @code{python-2} and @code{python} as explained in @ref{Version Numbers}.  To avoid confusion and naming clashes with other programming languages, it seems desirable that the name of a package for a Python module contains the word @code{python}.
ru: В настоящее время мы поставляем пакеты Python 2 и Python 3 через переменную Scheme под именами @code{python-2} и @code{python} в соответствии с @ref{Version Numbers}. Чтобы предотвратить путанницу и конфликты имён других языков программирования, модули Python содержат слово @code{python}.

note: type: Plain text
en: Some modules are compatible with only one version of Python, others with both.  If the package Foo is compiled with Python 3, we name it @code{python-foo}.  If it is compiled with Python 2, we name it @code{python2-foo}.  Packages should be added when they are necessary; we don't add Python 2 variants of the package unless we are going to use them.
ru: Некоторые модули совместимы только с одной версией Python, другие - с обоими. Если пакет Foo работает только с Python 3, мы называем его @code{python-foo}. Если он работает только с Python 2, мы называем его @code{python2-foo}. Если он совместим с обеими версиями, мы создаём два пакета с соответствующими именами.

note: type: Plain text
en: If a project already contains the word @code{python}, we drop this; for instance, the module python-dateutil is packaged under the names @code{python-dateutil} and @code{python2-dateutil}.  If the project name starts with @code{py} (e.g.@: @code{pytz}), we keep it and prefix it as described above.
ru: Если проект уже содержит слово @code{python}, мы отбрасываем его; например, модуль python-dateutil опакечен под именем @code{python-dateutil} и @code{python2-dateutil}. Если имя проекта начинается с @code{py} (т.е.@:  @code{pytz}), мы оставляем такое имя и добавляем префикс, как это описано выше.

note: type: subsubsection
en: Specifying Dependencies
ru: Перечисление зависимостей

note: type: cindex
en: inputs, for Python packages
ru: входные данные, для пакетов Python

note: type: Plain text
en: Your mission, when writing a recipe for a Python package, is to map these dependencies to the appropriate type of ``input'' (@pxref{package Reference, inputs}).  Although the @code{pypi} importer normally does a good job (@pxref{Invoking guix import}), you may want to check the following check list to determine which dependency goes where.
ru: Ваша миссия при написании рецепта сборки пакета Python --- отобразить эти зависимости в должном типе "input" (@pxref{package Reference, inputs}). Хотя импортёр @code{pypi} обычно отрабатывает хорошо (@pxref{Invoking guix import}), возможно, вы желаете просмотреть приведённый чек-лист, чтобы узнать о зависимостях.

note: type: itemize
en: Python dependencies required at run time go into @code{propagated-inputs}.  They are typically defined with the @code{install_requires} keyword in @file{setup.py}, or in the @file{requirements.txt} file.
ru: Зависимости Python, необходимые во время работы, идут в @code{propagated-inputs}. Они обычно определены с ключевым словом @code{install_requires} в @file{setup.py} или в файле @file{requirements.txt}.

note: type: itemize
en: Examples are the @code{pytest}, @code{mock}, and @code{nose} test frameworks.  Of course if any of these packages is also required at run-time, it needs to go to @code{propagated-inputs}.
ru: Примерами являются фреймворки тестирования @code{pytest}, @code{mock} и @code{nose}. Конечно, если какой-либо из этих пакетов также необходим во время запуска и работы, его следует указывать в @code{propagated-inputs}.

note: type: itemize
en: Anything that does not fall in the previous categories goes to @code{inputs}, for example programs or C libraries required for building Python packages containing C extensions.
ru: Всё, что не попало в предыдущие категории, указывается в @code{inputs}, например, программы или библиотеки C, необходимые для сборки пакетов Python, которые используют расширения C.

note: type: itemize
en: If a Python package has optional dependencies (@code{extras_require}), it is up to you to decide whether to add them or not, based on their usefulness/overhead ratio (@pxref{Submitting Patches, @command{guix size}}).
ru: Если у пакета Python есть необязательные зависимости (@code{extras_require}), самостоятельно решите, нужно ли их добавлять в зависимости от их полезности или избыточности (@pxref{Submitting Patches, @command{guix size}}).

note: type: Plain text
en: Perl programs standing for themselves are named as any other package, using the lowercase upstream name.  For Perl packages containing a single class, we use the lowercase class name, replace all occurrences of @code{::} by dashes and prepend the prefix @code{perl-}.  So the class @code{XML::Parser} becomes @code{perl-xml-parser}.  Modules containing several classes keep their lowercase upstream name and are also prepended by @code{perl-}.  Such modules tend to have the word @code{perl} somewhere in their name, which gets dropped in favor of the prefix.  For instance, @code{libwww-perl} becomes @code{perl-libwww}.
ru: Программы Perl именуются как и любой другой пакет, используя исходное имя в нижнем регистре. Для пакетов Perl, содержащих отдельный класс мы используем имя класса в нижнем регистре, заменяем все вхождения @code{::} на дефисы и добавляем приставку @code{perl-}. Так класс @code{XML::Parser} становится @code{perl-xml-parser}. Модули, содержащие несколько классов, сохраняют свои изначальные имена в нижнем регистре и также имеют префикс @code{perl-}. Подобные модули имеют тенденцию писать слово @code{perl} где-либо в их имени, так что это слово удаляется, так как префикс содержит это слово. Например, @code{libwww-perl} становится @code{perl-libwww}.

note: type: Plain text
en: Java programs standing for themselves are named as any other package, using the lowercase upstream name.
ru: Программы Java именуются как любой другой пакет, используя исходное им в нижнем регистре.

note: type: Plain text
en: To avoid confusion and naming clashes with other programming languages, it is desirable that the name of a package for a Java package is prefixed with @code{java-}.  If a project already contains the word @code{java}, we drop this; for instance, the package @code{ngsjava} is packaged under the name @code{java-ngs}.
ru: Чтобы избежать путанницы и конфликтов имён с другими языками программирования, желательно именовать пакет, поставляющий программу Java, с префиксом @code{java-}. Если проект уже содержит слово @code{java}, мы обрезаем его. Например, пакет @code{ngsjava} опакечивается под именем @code{java-ngs}.

note: type: Plain text
en: For Java packages containing a single class or a small class hierarchy, we use the lowercase class name, replace all occurrences of @code{.} by dashes and prepend the prefix @code{java-}.  So the class @code{apache.commons.cli} becomes package @code{java-apache-commons-cli}.
ru: Для пакетов Java, содержащих отдельный класс или небольшую ирархию, мы используем имя в нижнем регистре, заменяя все вхождения @code{.} на дефисы, и указываем префикс @code{java-}. Так класс  @code{apache.commons.cli} становится пакетом @code{java-apache-commons-cli}.

note: type: Plain text
en: Rust programs standing for themselves are named as any other package, using the lowercase upstream name.
ru: Программы Java именуются как любой другой пакет, используя исходное им в нижнем регистре.

note: type: Plain text
en: To prevent namespace collisions we prefix all other Rust packages with the @code{rust-} prefix.  The name should be changed to lowercase as appropriate and dashes should remain in place.
ru: Чтобы предотвратить конфликты пространства имен, мы используем префикс @code{rust-} для всех остальных пакетов Rust. Имя должно быть изменено на строчные буквы, если необходимо, и тире должны остаться на месте.

note: type: Plain text
en: In the rust ecosystem it is common for multiple incompatible versions of a package to be used at any given time, so all package definitions should have a versioned suffix.  The versioned suffix is the left-most non-zero digit (and any leading zeros, of course).  This follows the ``caret'' version scheme intended by Cargo.  Examples@: @code{rust-clap-2}, @code{rust-rand-0.6}.
ru: В экосистеме rust использование нескольких несовместимых версий пакета в любой момент времени является нормой, поэтому у всех пакетов должен быть версионный суффикс. Если пакет прошел версию 1.0.0, тогда достаточно только основного номера версии (например, @:@code{rust-clap-2}), в противном случае суффикс версии должен содержать как основную, так и вспомогательную версию (например, @:@code{rust-rand-0,6}).

note: type: Plain text
en: Because of the difficulty in reusing rust packages as pre-compiled inputs for other packages the Cargo build system (@pxref{Build Systems, @code{cargo-build-system}}) presents the @code{#:cargo-inputs} and @code{cargo-development-inputs} keywords as build system arguments.  It would be helpful to think of these as similar to @code{propagated-inputs} and @code{native-inputs}.  Rust @code{dependencies} and @code{build-dependencies} should go in @code{#:cargo-inputs}, and @code{dev-dependencies} should go in @code{#:cargo-development-inputs}.  If a Rust package links to other libraries then the standard placement in @code{inputs} and the like should be used.
ru: Из-за сложности повторного использования rust пакетов в качестве предварительно скомпилированных входных данных для других пакетов система сборки Cargo (@pxref{Build Systems, @code{cargo-build-system}}) представляет @code{#:cargo-input} и ключевые слова @code{cargo-development-input} в качестве аргументов для системы сборки. Было бы полезно думать о них как о @code{propagated-inputs} и @code{native-inputs}. Rust @code{dependencies} и @code{build-dependencies} должны идти в @code{#:cargo-input}, а @code{dev-dependencies} должен идти в @code{#:cargo-development-input}. Если пакет Rust ссылается на другие библиотеки, то следует использовать стандартное размещение в @code{input} и т.п.

note: type: Plain text
en: Care should be taken to ensure the correct version of dependencies are used; to this end we try to refrain from skipping the tests or using @code{#:skip-build?} when possible.  Of course this is not always possible, as the package may be developed for a different Operating System, depend on features from the Nightly Rust compiler, or the test suite may have atrophied since it was released.
ru: Следует позаботиться о том, чтобы была использована корректная версия зависимостей; с этой целью мы стараемся не пропускать тесты или использовать @code{#:skip-build?}, когда это возможно. Конечно, это не всегда возможно, так как пакет может быть разработан для другой операционной системы, зависить от новых функций компилятора Rust для разработчиков (Nightly), или тесты могли устареть с момента выпуска.

note: type: cindex
en: fonts
ru: шрифты

note: type: Plain text
en: For fonts that are in general not installed by a user for typesetting purposes, or that are distributed as part of a larger software package, we rely on the general packaging rules for software; for instance, this applies to the fonts delivered as part of the X.Org system or fonts that are part of TeX Live.
ru: Для шрифтов, которые не установлены пользователем, исходя из настроек печати, или рааспространяемые как часть большого пакета программного обеспечения, мы применяем обычные правила опакечивания программного обеспечения. Например, это относится к шрифтам, поставляемым как часть системы X.Org, или шрифтов TeX Live.

note: type: Plain text
en: To make it easier for a user to search for fonts, names for other packages containing only fonts are constructed as follows, independently of the upstream package name.
ru: Чтобы облегчить пользовательский поиск шрифтов, имена пакетов, содержащих только шрифты, создаются следующим образом, независимо от изначального имени пакета.

note: type: Plain text
en: The name of a package containing only one font family starts with @code{font-}; it is followed by the foundry name and a dash @code{-} if the foundry is known, and the font family name, in which spaces are replaced by dashes (and as usual, all upper case letters are transformed to lower case).  For example, the Gentium font family by SIL is packaged under the name @code{font-sil-gentium}.
ru: Имя пакета, содержащего только одно семейство шрифтов, начинается с @code{font-}; далее идёт литейное имя и дефис @code{-}, если литейное имя известно, а затем - имя семейства шрифтов, в котором пробелы заменяются дефисами (и обычно все буквы в верхнем регистре заменяются на нижний регистр). Например, семейство шрифтов Gentium от SIL опакечивается под именем @code{font-sil-gentium}.

note: type: Plain text
en: For a package containing several font families, the name of the collection is used in the place of the font family name.  For instance, the Liberation fonts consist of three families, Liberation Sans, Liberation Serif and Liberation Mono.  These could be packaged separately under the names @code{font-liberation-sans} and so on; but as they are distributed together under a common name, we prefer to package them together as @code{font-liberation}.
ru: Пакет с несколькими семействами шрифтов имеет в названии имя коллекции вместо имени семейства. Например, шрифты Liberation состоят из трёх семейств: Liberation Sans, Liberation Serfif и Liberation Mono. Они могли бы опакечиваться отдельно под именами @code{font-liberation-sans} и так далее, но так как они распространяются вместе под общим именем, мы предпочитаем опакечивать их вместе как @code{font-liberation}.

note: type: Plain text
en: In the case where several formats of the same font family or font collection are packaged separately, a short form of the format, prepended by a dash, is added to the package name.  We use @code{-ttf} for TrueType fonts, @code{-otf} for OpenType fonts and @code{-type1} for PostScript Type 1 fonts.
ru: В случае, когда несколько форматов одного семейства щрифтов или коллекции шрифтов опакечена отдельно, в имени присутствует небольшая отметка о формате с предваряющим дефисом. Мы используем @code{-ttf} для шрифтов TrueType, @code{-otf} - для шрифтов OpenType - и  @code{-type1} - для шрифтов PostScript Type 1.

note: type: Plain text
en: In general our code follows the GNU Coding Standards (@pxref{Top,,, standards, GNU Coding Standards}).  However, they do not say much about Scheme, so here are some additional rules.
ru: В основном наш код следует стандартам кодирования GNU (@pxref{Top,,, standards, GNU Coding Standards}). Но они не имеют исчерпывающих указаний для Scheme, так что есть дополнительные правила.

note: type: subsection
en: Programming Paradigm
ru: Парадигма программирования

note: type: menuentry
en: How to compose your elements.
ru: Как компоновать элементы.

note: type: subsection
en: Modules
ru: Модули

note: type: menuentry
en: Where to store your code?
ru: Где разместить код?

note: type: subsection
en: Data Types and Pattern Matching
ru: Типы данных и поиск образцов

note: type: menuentry
en: Implementing data structures.
ru: Использование структур данных.

note: type: subsection
en: Formatting Code
ru: Форматирование кода

note: type: menuentry
en: Writing conventions.
ru: Написание соглашений.

note: type: Plain text
en: Scheme code in Guix is written in a purely functional style.  One exception is code that involves input/output, and procedures that implement low-level concepts, such as the @code{memoize} procedure.
ru: Код Scheme в Guix написан в чисто функциональном стиле. Одно исключение - это код, который вызывает ввод/вывод и процедуры, которые реализуют низкоровневые операции, как например, процедура @code{memoize}.

note: type: Plain text
en: Guile modules that are meant to be used on the builder side must live in the @code{(guix build @dots{})} name space.  They must not refer to other Guix or GNU modules.  However, it is OK for a ``host-side'' module to use a build-side module.
ru: Модули Guile, которые вызываются для сборки, должны жить в пространстве имён @code{(guix build @dots{})}. Они не должны ссылаться на другие модули Guix или GNU. Однако это нормально, если модуль типа "host-side" использует модуль типа build-side.

note: type: Plain text
en: Modules that deal with the broader GNU system should be in the @code{(gnu @dots{})} name space rather than @code{(guix @dots{})}.
ru: Модули, которые работают во всей системе GNU, должны быть в пространстве имён @code{(gnu @dots{})}, но не @code{(guix @dots{})}.

note: type: Plain text
en: The tendency in classical Lisp is to use lists to represent everything, and then to browse them ``by hand'' using @code{car}, @code{cdr}, @code{cadr}, and co.  There are several problems with that style, notably the fact that it is hard to read, error-prone, and a hindrance to proper type error reports.
ru: Правило классического Lisp - использование списков для представления всего и просмотр списков "вручную", используя @code{car}, @code{cdr}, @code{cadr} и тому подобное. Возникают некоторые проблемы этого стиля, например, это тяжело читается, провоцирует ошибки, и создаёт отчёты об ошибках без должной детализации.

note: type: cindex
en: formatting code
ru: форматирование кода

note: type: cindex
en: coding style
ru: стиль кодирования

note: type: Plain text
en: When writing Scheme code, we follow common wisdom among Scheme programmers.  In general, we follow the @url{https://mumble.net/~campbell/scheme/style.txt, Riastradh's Lisp Style Rules}.  This document happens to describe the conventions mostly used in Guile’s code too.  It is very thoughtful and well written, so please do read it.
ru: При написании кода Scheme мы пользуемся мудростью программистов Scheme. В основном мы следуем  @url{http://mumble.net/~campbell/scheme/style.txt, Riastradh's Lisp Style Rules}. Этот документ, к счастью, содержит большинство соглашений, которые применимы также для кода Guile. Это очень вдумчиая работа, пожалуйста, прочтите её.

note: type: Plain text
en: Some special forms introduced in Guix, such as the @code{substitute*} macro, have special indentation rules.  These are defined in the @file{.dir-locals.el} file, which Emacs automatically uses.  Also note that Emacs-Guix provides @code{guix-devel-mode} mode that indents and highlights Guix code properly (@pxref{Development,,, emacs-guix, The Emacs-Guix Reference Manual}).
ru: Некоторые специальные формы, вводимые в Guix, как например, макрос @code{substitute*}, имеют специальные правила отступов. Они определены в файле @file{.dir-locals.el}, которые использует Emacs автоматически. Также отметим, что Emacs-Guix предоставляет режим @code{guix-devel-mode}, который вставляет отступы и подсвечивает код Guix должным образом (@pxref{Development,,, emacs-guix, The Emacs-Guix Reference Manual}).

note: type: cindex
en: indentation, of code
ru: отступы, в коде

note: type: cindex
en: formatting, of code
ru: форматировние, кода

note: type: Plain text
en: If you do not use Emacs, please make sure to let your editor knows these rules.  To automatically indent a package definition, you can also run:
ru: Если вы не пользуетесь Emacs, пожалуйста убедитесь, что ваш редактор знает эти правила. Для автоматической расстановки отступов можно запустить:

note: type: cindex
en: Vim, Scheme code editing
ru: Vim, редактирование кода Scheme

note: type: Plain text
en: If you are editing code with Vim, we recommend that you run @code{:set autoindent} so that your code is automatically indented as you type.  Additionally, @uref{https://www.vim.org/scripts/script.php?script_id=3998, @code{paredit.vim}} may help you deal with all these parentheses.
ru: Если вы редактируете код в Vim, мы рекомендуем запустить @code{:set autoindent}, так отступы будут автоматически вставляться в ваш код, пока вы печатаете. В дополнение вам может помочь для работы со всеми этими скобками @uref{https://www.vim.org/scripts/script.php?script_id=3998, @code{paredit.vim}}.

note: type: Plain text
en: We require all top-level procedures to carry a docstring.  This requirement can be relaxed for simple private procedures in the @code{(guix build @dots{})} name space, though.
ru: Мы требуем, чтобы все высокоуровневые процедуры содержали строки документации. Хотя это требование может не учитываться для простых приватных процедур в пространстве имён @code{(guix build @dots{})}.

note: type: Plain text
en: Procedures should not have more than four positional parameters.  Use keyword parameters for procedures that take more than four parameters.
ru: Процедуры должны иметь не более четырёх параметров. Передавайте параметры по ключевым словам в процедурах, которые принимают более четырёх параметров.

note: type: Plain text
en: Please write commit logs in the ChangeLog format (@pxref{Change Logs,,, standards, GNU Coding Standards}); you can check the commit history for examples.
ru: Пожалуйста, пишите логи коммита в формате ChangeLog (@pxref{Change Logs,,, standards, GNU Coding Standards}); можно просмотреть историю коммитов, например.

note: type: Plain text
en: Before submitting a patch that adds or modifies a package definition, please run through this check list:
ru: Перед отправкой патча, который добавляет или изменяет описание пакета, пожалуйста, выполните следующие проверки:

note: type: enumerate
en: If the authors of the packaged software provide a cryptographic signature for the release tarball, make an effort to verify the authenticity of the archive.  For a detached GPG signature file this would be done with the @code{gpg --verify} command.
ru: Если авторы пакета программного обеспечения преоставляют криптографическую подпись для архива релиза, выполните проверку аутентичности архива. Для отдельного файла GPG-подписи это можно сделать командой @code{gpg --verify}.

note: type: enumerate
en: Take some time to provide an adequate synopsis and description for the package.  @xref{Synopses and Descriptions}, for some guidelines.
ru: Потратьте немного времени, чтобы предоставить адекватное краткое описание и полное описание пакета. Смотрите @xref{Synopses and Descriptions} для подробностей.

note: type: enumerate
en: Run @code{guix lint @var{package}}, where @var{package} is the name of the new or modified package, and fix any errors it reports (@pxref{Invoking guix lint}).
ru: Запустите @code{guix lint @var{package}}, где @var{package} - это имя нового изменённого пакета, и устраните любые ошибки из отчёта (@pxref{Invoking guix lint}).

note: type: enumerate
en: Make sure the package builds on your platform, using @code{guix build @var{package}}.
ru: Убедитесь, что пакет собирается на вашей платформе, используя @code{guix build @var{package}}.

note: type: enumerate
en: Then reconfigure your system.
ru: И тогда запустите переконфигурирование системы.

note: type: enumerate
en: You can then build packages for different platforms by specifying the @code{--system} option.  For example, to build the "hello" package for the armhf or aarch64 architectures, you would run the following commands, respectively:
ru: Также можно собирать пакеты под различные платформы, обозначив опцию @code{--system}. Например, чтобы собрать пакет "hello" для архитектур armhf, aarch64, или mips64 вы должны выполнить соответственно следующее:

note: type: example
en: guix build --system=armhf-linux --rounds=2 hello
    guix build --system=aarch64-linux --rounds=2 hello
ru: "guix build --system=armhf-linux --rounds=2 hello
    "guix build --system=aarch64-linux --rounds=2 hello

note: type: cindex
en: bundling
ru: сборка

note: type: enumerate
en: Make sure the package does not use bundled copies of software already available as separate packages.
ru: Убедитесь, что пакет не использует связанные копии программ, которые уже доступны как отдельные пакеты.

note: type: enumerate
en: Sometimes, packages include copies of the source code of their dependencies as a convenience for users.  However, as a distribution, we want to make sure that such packages end up using the copy we already have in the distribution, if there is one.  This improves resource usage (the dependency is built and stored only once), and allows the distribution to make transverse changes such as applying security updates for a given software package in a single place and have them affect the whole system---something that bundled copies prevent.
ru: Иногда пакеты включают копии исходных кодов своих зависимостей, исходя из удобства для пользователей. Однако как дистрибутив, мы должны убедиться, что подобные пакеты ставятся, используя копию, которую мы уже имеем в дистрибутиве, если таковая имеется. Это улучшает использование ресурсов (зависимость собирается и сохраняется один раз) и позволяет дистрибутиву производить поперечные изменения, как например, применение обновлений безопасности для поставляемого пакета программного обеспечения в одном месте, и эти изменения будут иметь силу во всей системе, устраняя проблему лишних копий.

note: type: enumerate
en: Take a look at the profile reported by @command{guix size} (@pxref{Invoking guix size}).  This will allow you to notice references to other packages unwillingly retained.  It may also help determine whether to split the package (@pxref{Packages with Multiple Outputs}), and which optional dependencies should be used.  In particular, avoid adding @code{texlive} as a dependency: because of its extreme size, use the @code{texlive-tiny} package or @code{texlive-union} procedure instead.
ru: Просмотрите отчеты  @command{guix size} (@pxref{Invoking guix size}). Это позволит найти связь с другими пакетами, сохранившуюся без необходимости. Это также позволяет решить, как разделить пакет (@pxref{Packages with Multiple Outputs}) и какие должны использоваться опциональные зависимости. В частности, это способ избежать использование большого @code{texlive} как зависимости и использовать @code{texlive-tiny} или @code{texlive-union} вместо него.

note: type: cindex
en: branching strategy
ru: стратегия бренчей

note: type: cindex
en: rebuild scheduling strategy
ru: стратегия планирования пересборки

note: type: enumerate
en: Depending on the number of dependent packages and thus the amount of rebuilding induced, commits go to different branches, along these lines:
ru: В зависимости от числа пакетов зависимостей и, как следствие, числа вызываемых пересборок, коммиты отправляются в разные бренчи следующим образом:

note: type: item
en: 300 dependent packages or less
ru: 300 пакетов зависимостей или менее

note: type: table
en: @code{master} branch (non-disruptive changes).
ru: бренч @code{master} (не разрушающие изменения).

note: type: item
en: between 300 and 1,800 dependent packages
ru: от 300 до 1200 пакетов зависимостей

note: type: table
en: @code{staging} branch (non-disruptive changes).  This branch is intended to be merged in @code{master} every 6 weeks or so.  Topical changes (e.g., an update of the GNOME stack) can instead go to a specific branch (say, @code{gnome-updates}).  This branch is not expected to be buildable or usable until late in its development process.
ru: бренч @code{staging} (не разрушающие изменения). Этот бренч предназначен для включения в @code{master} каждые 3 недели (примерно). Тематические изменения (т.е. обновление стека GNOME) могут отправляться в специальный бренч, скажем, @code{gnome-updates}.

note: type: item
en: more than 1,800 dependent packages
ru: более 1200 пакетов зависимостей

note: type: table
en: @code{core-updates} branch (may include major and potentially disruptive changes).  This branch is intended to be merged in @code{master} every 6 months or so.  This branch is not expected to be buildable or usable until late in its development process.
ru: бренч @code{core-updates} (может включать главные и потенциально разрушительные изменения). Этот бренч предназначен для включения в  @code{master} каждые 2,5 месяца примерно.

note: type: enumerate
en: When we decide to start building the @code{staging} or @code{core-updates} branches, they will be forked and renamed with the suffix @code{-frozen}, at which time only bug fixes may be pushed to the frozen branches.  The @code{core-updates} and @code{staging} branches will remain open to accept patches for the next cycle.  Please ask on the mailing list or IRC if unsure where to place a patch.
ru: Когда мы решим начать сборку веток @code{staging} или @code{core-updates}, они будут форкнуты (forked) и переименованы с суффиксом @code{-frozen}, после чего замороженные ветки будут получать только исправления ошибок.  Ветки @code{core-updates} и @code{staging} остануться открыты для патчей в следующем цикле.  Если вы не знаете, где разместить патч, спросите в списке рассылки или в IRC.

note: type: cindex
en: determinism, of build processes
ru: детерминизм, процесса сборки

note: type: cindex
en: reproducible builds, checking
ru: воспроизводимые сорки, проверка

note: type: enumerate
en: Check whether the package's build process is deterministic.  This typically means checking whether an independent build of the package yields the exact same result that you obtained, bit for bit.
ru: Проверьте, является ли процесс сборки пакета детеминистическим. Это обычно означает необходимость проверки того, что независимая сборка пакета производит точно такой же результат, которым вы располагаете, бит к биту.

note: type: enumerate
en: A simple way to do that is by building the same package several times in a row on your machine (@pxref{Invoking guix build}):
ru: Простой способ выполнить это - собрать такой же пакет несколько раз подряд на вашей машине (@pxref{Invoking guix build}):

note: type: enumerate
en: This is enough to catch a class of common non-determinism issues, such as timestamps or randomly-generated output in the build result.
ru: Этого достаточно, чтобы отловить привычный набор проблем, нарушающих детерминизм, как например, отпечаток времени или случайно генерируемый выход на результате сборке.

note: type: enumerate
en: Another option is to use @command{guix challenge} (@pxref{Invoking guix challenge}).  You may run it once the package has been committed and built by @code{@value{SUBSTITUTE-SERVER-1}} to check whether it obtains the same result as you did.  Better yet: Find another machine that can build it and run @command{guix publish}.  Since the remote build machine is likely different from yours, this can catch non-determinism issues related to the hardware---e.g., use of different instruction set extensions---or to the operating system kernel---e.g., reliance on @code{uname} or @file{/proc} files.
ru: Другой способ --- использовать @command{guix challenge} (@pxref{Invoking guix challenge}). Можно запустить это один раз, когда коммит пакета был отправлен, и собрать с помощью @code{@value{SUBSTITUTE-SERVER-1}}, чтобы проверить, что это даёт результат такой же, как у вас.  Ещё лучше найти другую машину, на которой можно собрать это и выполнить @command{guix publish}. Так как другая удалённая машина дл сборки отличается от вашей, это может выявить проблемы, нарушающие детерминизм, связанные с аппаратным обеспечением, то есть вызванные использованием различных расширений ассемблера или другого ядра операционной системы, то есть касательно файлов @code{uname} или @file{/proc}.

note: type: enumerate
en: When writing documentation, please use gender-neutral wording when referring to people, such as @uref{https://en.wikipedia.org/wiki/Singular_they, singular ``they''@comma{} ``their''@comma{} ``them''}, and so forth.
ru: При написании документации, пожалуйста, используйте нейтральную по гендеру лексику, когда речь идёт о людях, как например, тут @uref{https://en.wikipedia.org/wiki/Singular_they, singular "they"@comma{} "their"@comma{} "them"} и т.д.

note: type: enumerate
en: Verify that your patch contains only one set of related changes.  Bundling unrelated changes together makes reviewing harder and slower.
ru: Проверьте, что ваш патч содержит изменения, связанные только с одной темой. Связывая вместе изменения, касающиеся различных тем, делает обзор сложным и медленным.

note: type: enumerate
en: Examples of unrelated changes include the addition of several packages, or a package update along with fixes to that package.
ru: Примеры несвязанных изменений включают, в том числе, добавление некоторых пакетов или обновление пакета вместе с исправлениями в этом пакете.

note: type: enumerate
en: When possible, use mirrors in the source URL (@pxref{Invoking guix download}).  Use reliable URLs, not generated ones.  For instance, GitHub archives are not necessarily identical from one generation to the next, so in this case it's often better to clone the repository.  Don't use the @command{name} field in the URL: it is not very useful and if the name changes, the URL will probably be wrong.
ru: Если это возможно, используйте зеркала при указании URL исходников (@pxref{Invoking guix download}). Используйте надёжные URL'ы, а не сгенерированные. Например, архивы GitHub не являются идентичными между поколениями, так что в этом случае часто лучше клонировать репозиторий. Не используйте поле @command{name} в URL, это не очень удобно: если имя изменится, тогда URL будет неправильным.

note: type: enumerate
en: Check if Guix builds (@pxref{Building from Git}) and address the warnings, especially those about use of undefined symbols.
ru: Проверьте, собирается ли Guix (@pxref{Building from Git}), и устраните предупреждения, особенно те, которые касаются использования неопределенных символов.

note: type: enumerate
en: Make sure your changes do not break Guix and simulate a @code{guix pull} with:
ru: Убедитесь, что ваши изменения не ломают Guix и имитируйте @code{guix pull} вместе с:

note: type: Plain text
en: Expect some delay when you submit your very first patch to @email{guix-patches@@gnu.org}. You have to wait until you get an acknowledgement with the assigned tracking number. Future acknowledgements should not be delayed.
ru: Когда отправите свой самый первый патч на @email{guix-patches@@gnu.org}, ожидайте некоторой задержки. Вам нужно подождать, пока вы не получите подтверждение с присвоенным номером отслеживания. Дальнейшие подтверждения не следует откладывать.

note: type: subsection
en: Configuring Git
ru: Конфигурирование Git

note: type: subsection
en: Sending a Patch Series
ru: Отправка пакета исправлений

note: type: cindex
en: patch series
ru: группы патчей

note: type: cindex
en: bug reports, tracking
ru: сообщения об ошибке, отслеживание

note: type: cindex
en: patch submissions, tracking
ru: отправка патча, отслеживание

note: type: cindex
en: issue tracking
ru: отслеживание заявок об ошибках

note: type: cindex
en: Debbugs, issue tracking system
ru: Debbugs, система отслеживания ошибок

note: type: Plain text
en: Bug reports and patch submissions are currently tracked using the Debbugs instance at @uref{https://bugs.gnu.org}.  Bug reports are filed against the @code{guix} ``package'' (in Debbugs parlance), by sending email to @email{bug-guix@@gnu.org}, while patch submissions are filed against the @code{guix-patches} package by sending email to @email{guix-patches@@gnu.org} (@pxref{Submitting Patches}).
ru: Отчёты об ошибках и предложенные исправления сейчас отслеживаются с помощью Debbugs на веб-сайте @uref{https://bugs.gnu.org}. Отчёты об ошибках, относящиеся к пакету @code{guix} (на языке Debbugs), отправляйте по адресу @email{bug-guix@@gnu.org}, а предлагаемые исправления для пакета @code{guix-patches} — по адресу @email{guix-patches@@gnu.org} (@pxref{Submitting Patches}).

note: type: Plain text
en: A web interface (actually @emph{two} web interfaces!) are available to browse issues:
ru: Для просмотра вопросов доступен веб-интерфейс (на самом деле даже @emph{два} веб-интерфейса):

note: type: itemize
en: @url{https://issues.guix.gnu.org} provides a pleasant interface@footnote{The web interface at @url{https://issues.guix.gnu.org} is powered by Mumi, a nice piece of software written in Guile, and you can help! See @url{https://git.elephly.net/gitweb.cgi?p=software/mumi.git}.} to browse bug reports and patches, and to participate in discussions;
ru: @url{https://issues.guix.gnu.org} предоставляет приятный интерфейс@footnote{Веб-интерфейс по адресу @url{https://issues.guix.gnu.org} работает на Mumi, прятном примере програмного обеспечения, написанного на Guile, и вы можете помочь! См.@url{https://git.elephly.net/gitweb.cgi?p=software/mumi.git}.} чтобы просматривать отчеты об ошибках и исправлениях, а также участвовать в обсуждениях;

note: type: itemize
en: @url{https://bugs.gnu.org/guix} lists bug reports;
ru: @url{https://gnupg.org/, GNU libgcrypt} списки отчётов об ошибках;

note: type: itemize
en: @url{https://bugs.gnu.org/guix-patches} lists patch submissions.
ru: @url{https://bugs.gnu.org/guix-patches} списки патчей на рассмотрении.

note: type: Plain text
en: To view discussions related to issue number @var{n}, go to @indicateurl{https://issues.guix.gnu.org/@var{n}} or @indicateurl{https://bugs.gnu.org/@var{n}}.
ru: Чтобы просмотреть обсуждения, связанные с номером проблемы @var{n}, перейдите на @indicateurl{https://issues.guix.gnu.org/@var{n}} или @indicateurl{https://bugs.gnu.org/@var{n}}.

note: type: Plain text
en: If you use Emacs, you may find it more convenient to interact with issues using @file{debbugs.el}, which you can install with:
ru: Если вы используете Emacs, вам может быть удобнее взаимодействовать с проблемами при помощи @file{debbugs.el}, который вы можете установить с помощью:

note: type: Plain text
en: For example, to list all open issues on @code{guix-patches}, hit:
ru: Например, чтбы уввидеть все открытые заявки на @code{guix-patches}, введите:

note: type: Plain text
en: @xref{Top,,, debbugs-ug, Debbugs User Guide}, for more information on this nifty tool!
ru: @xref{Top,,, debbugs-ug, Debbugs User Guide} для подробной информации об этом полезном инструменте!

note: type: item
en: powerpc64le-linux
ru: aarch64-linux

note: #-#-#-#-#  contributing.pot (guix manual checkout)  #-#-#-#-# type: item #-#-#-#-#  guix.pot (guix manual checkout)  #-#-#-#-# type: cindex
en: reproducibility
ru: воспроизводимость

note: type: cindex
en: commit access, for developers
ru: доступ для отправки коммитов, для разработчиков

note: type: enumerate
en: Find three committers who would vouch for you.  You can view the list of committers at @url{https://savannah.gnu.org/project/memberlist.php?group=guix}.  Each of them should email a statement to @email{guix-maintainers@@gnu.org} (a private alias for the collective of maintainers), signed with their OpenPGP key.
ru: Найдите трех коммиттеров, которые поручаются за вас. Вы можете просмотреть список коммиттеров по адресу @url{https://savannah.gnu.org/project/memberlist.php?group=guix}. Каждый из них должен отправить заявление по электронной почте на адрес @email{guix-maintainers@@gnu.org} (личный псевдоним коллектива сопровождающих), подписанный ключом OpenPGP.

note: type: enumerate
en: Committers are expected to have had some interactions with you as a contributor and to be able to judge whether you are sufficiently familiar with the project's practices.  It is @emph{not} a judgment on the value of your work, so a refusal should rather be interpreted as ``let's try again later''.
ru: Ожидается, что коммиттеры взаимодействовали с вами как c участником и могли судить, достаточно ли вы знакомы с проектом. Это @emph{не} суждение о ценности вашей работы, поэтому отказ следует скорее интерпретировать как «давайте попробуем позже».

note: type: enumerate
en: Send @email{guix-maintainers@@gnu.org} a message stating your intent, listing the three committers who support your application, signed with the OpenPGP key you will use to sign commits, and giving its fingerprint (see below).  See @uref{https://emailselfdefense.fsf.org/en/}, for an introduction to public-key cryptography with GnuPG.
ru: Отправьте @email{guix-keepers@@gnu.org} сообщение с указанием ваших намерений, перечисляя трех коммиттеров, поддерживающих вашу заявку, подписанных ключом OpenPGP, который вы будете использовать для подписания коммитов, и указав свой отпечаток (смотри ниже). Ознакомся с @uref{https://emailselfdefense.fsf.org/ru/}, чтобы познакомиться с криптографией с открытым ключом с помощью GnuPG.

note: type: enumerate
en: Set up GnuPG such that it never uses the SHA1 hash algorithm for digital signatures, which is known to be unsafe since 2019, for instance by adding the following line to @file{~/.gnupg/gpg.conf} (@pxref{GPG Esoteric Options,,, gnupg, The GNU Privacy Guard Manual}):
ru: Настройте GnuPG так, чтобы он никогда не использовал хэш-алгоритм SHA1 для цифровых подписей, который, как известно, небезопасен с 2019 года. Например, добавив следующую строку в @file{~/.gnupg/gpg.conf} (@pxref{GPG Esoteric Options,,, gnupg, The GNU Privacy Guard Manual}):

note: type: enumerate
en: Maintainers ultimately decide whether to grant you commit access, usually following your referrals' recommendation.
ru: Маинтайнеры решают, предоставлять ли вам доступ к коммитам, обычно следуя рекомендациям ваших рефералов.

note: type: cindex
en: OpenPGP, signed commits
ru: Коммиты, подписанные OpenPGP

note: type: enumerate
en: If and once you've been given access, please send a message to @email{guix-devel@@gnu.org} to say so, again signed with the OpenPGP key you will use to sign commits (do that before pushing your first commit).  That way, everyone can notice and ensure you control that OpenPGP key.
ru: Получив доступ, пожалуйста, отправьте сообщение на адрес @email{guix-devel@@gnu.org}, чтобы снова подписать его ключом OpenPGP, который вы будете использовать для подписания коммитов (сделайте это перед отправкой первого коммита). Таким образом, каждый может заметить и убедиться, что это ваш ключ OpenPGP.

note: type: quotation
en: Important
ru: Важно

note: type: quotation
en: Before you can push for the first time, maintainers must:
ru: Перед тем, как вы отправите изменения впервые, сопровождающие должны:

note: type: enumerate
en: add your OpenPGP key to the @code{keyring} branch;
ru: добавить ваш OpenPGP ключ в @code{keyring} ветку;

note: type: enumerate
en: add your OpenPGP fingerprint to the @file{.guix-authorizations} file of the branch(es) you will commit to.
ru: добавьте отпечаток вашего OpenPGP ключа в @file{.guix-authorizations} файл ветки (-ок), которые вы подпишите (commit).

note: type: enumerate
en: Make sure to read the rest of this section and... profit!
ru: Обязательно прочтите остальную часть этого раздела!

note: type: quotation
en: Maintainers are happy to give commit access to people who have been contributing for some time and have a track record---don't be shy and don't underestimate your work!
ru: Маинтейнеры с радостью предоставят доступ к коммитам людям, которые внесли свой вклад в течение некоторого времени и имеют послужной список - не стесняйтесь и не недооценивайте свою работу!

note: type: quotation
en: However, note that the project is working towards a more automated patch review and merging system, which, as a consequence, may lead us to have fewer people with commit access to the main repository.  Stay tuned!
ru: Тем не менее, обратите внимание, что проект работает над созданием более автоматизированной системы проверки и объединения исправлений, что, как следствие, может привести к тому, что у нас будет меньше людей, имеющих доступ к главному репозиторию. Будьте на связи!

note: type: Plain text
en: All commits that are pushed to the central repository on Savannah must be signed with an OpenPGP key, and the public key should be uploaded to your user account on Savannah and to public key servers, such as @code{keys.openpgp.org}.  To configure Git to automatically sign commits, run:
ru: Все коммиты, которые передаются в центральный репозиторий в Саванне, должны быть подписаны ключом OpenPGP, а открытый ключ должен быть загружен в вашу учетную запись пользователя на Саванне и на серверы открытых ключей, такие как @code{keys.openpgp.org}. Чтобы настроить Git для автоматической подписи коммитов, запустите:

note: type: Plain text
en: If you get commit access, please make sure to follow the policy below (discussions of the policy can take place on @email{guix-devel@@gnu.org}).
ru: Если вы получили доступ к коммиту, пожалуйста, следуйте приведенной ниже политике (обсуждение политики может проходить по адресу @email{guix-devel@@gnu.org}).

note: type: Plain text
en: Non-trivial patches should always be posted to @email{guix-patches@@gnu.org} (trivial patches include fixing typos, etc.).  This mailing list fills the patch-tracking database (@pxref{Tracking Bugs and Patches}).
ru: Нетривиальные патчи всегда должны публиковаться на @email{guix-patches@@gnu.org} (тривиальные патчи включают исправление опечаток и т.д.). Этот список рассылки заполняет базу данных отслеживания патчей (@pxref{Tracking Bugs and Patches}).

note: type: Plain text
en: For patches that just add a new package, and a simple one, it's OK to commit, if you're confident (which means you successfully built it in a chroot setup, and have done a reasonable copyright and license auditing).  Likewise for package upgrades, except upgrades that trigger a lot of rebuilds (for example, upgrading GnuTLS or GLib).  We have a mailing list for commit notifications (@email{guix-commits@@gnu.org}), so people can notice.  Before pushing your changes, make sure to run @code{git pull --rebase}.
ru: Для патчей, которые просто добавляют новый пакет или внсит небольшие изменения считается нормальным отправить коммит, если вы уверены (что означает, что вы успешно встроили его в настройку chroot и провели разумный аудит авторских прав и лицензий). Аналогично для обновлений пакетов, за исключением обновлений, которые вызывают много перестроений (например, обновление GnuTLS или GLib). У нас есть список рассылки для уведомлений о коммитах (@email{guix-commits@@gnu.org}), так что люди могут это заметить. Перед отправкой изменений обязательно запустите @code{git pull --rebase}.

note: type: Plain text
en: When pushing a commit on behalf of somebody else, please add a @code{Signed-off-by} line at the end of the commit log message---e.g., with @command{git am --signoff}.  This improves tracking of who did what.
ru: Когда вы отправляете коммит от имени кого-то другого, добавьте строку @code{Signed-off-by} в конце сообщения коммит лога---например, с @command{git am --signoff}. Это улучшает отслеживание того, кто что сделал.

note: type: Plain text
en: When adding channel news entries (@pxref{Channels, Writing Channel News}), make sure they are well-formed by running the following command right before pushing:
ru: При добавлении новостей канала (@pxref{Channels, Writing Channel News}), убедитесь, что они правильно сформированы, выполнив следующую команду прямо перед нажатием:

note: type: Plain text
en: For anything else, please post to @email{guix-patches@@gnu.org} and leave time for a review, without committing anything (@pxref{Submitting Patches}).  If you didn’t receive any reply after two weeks, and if you're confident, it's OK to commit.
ru: Для чего-либо еще, пожалуйста, отправьте сообщение на @email{guix-patches@@gnu.org} и оставьте время для обзора, ничего не коммитя (@pxref{Submitting Patches}). Если вы не получили никакого ответа через две недели, и если вы уверены, что все в порядке, будь нормальным совершить коммит.

note: type: Plain text
en: That last part is subject to being adjusted, allowing individuals to commit directly on non-controversial changes on parts they’re familiar with.
ru: Эта последняя часть подлежит корректировке, что позволяет отдельным лицам вносить непосредственные изменения в не противоречивые изменения в тех частях, с которыми они знакомы.

note: type: Plain text
en: In order to reduce the possibility of mistakes, committers will have their Savannah account removed from the Guix Savannah project and their key removed from @file{.guix-authorizations} after 12 months of inactivity; they can ask to regain commit access by emailing the maintainers, without going through the vouching process.
ru: Чтобы уменьшить вероятность ошибок, учетные записи контрибьюторов будут удалены из проекта Guix на Savannah, а их ключи - из @file{.guix-authorizations} после 12 месяцев бездействия; они могут попросить восстановить доступ к отправке коммитов, отправив электронное письмо мэйнтейнеров, не проходя через процесс подтверждения.

note: type: Plain text
en: One last thing: the project keeps moving forward because committers not only push their own awesome changes, but also offer some of their time @emph{reviewing} and pushing other people's changes.  As a committer, you're welcome to use your expertise and commit rights to help other contributors, too!
ru: И последнее: проект продолжает двигаться вперед, потому что коммиттеры не только вносят свои собственные потрясающие изменения, но также уделяют свое время на @emph{reviewing} и продвижение изменений других людей. Как коммиттер, вы можете использовать свой опыт и передавать права, чтобы помочь и другим участникам!

note: type: cindex
en: update-guix-package, updating the guix package
ru: guix package: (guix)Запуск guix package

note: type: Plain text
en: It is sometimes desirable to update the @code{guix} package itself (the package defined in @code{(gnu packages package-management)}), for example to make new daemon features available for use by the @code{guix-service-type} service type.  In order to simplify this task, the following command can be used:
ru: Иногда желательно обновить сам пакет @code{guix} (пакет определен в @code{(gnu packages package-management)}), например, чтобы сделать новые функции демона доступными для использования сервисом @code{guix-service-type}.  Чтобы упростить эту задачу, можно использовать следующую команду:

note: type: example
en: make update-guix-package
ru: make authenticate

note: type: Plain text
en: The @code{update-guix-package} make target will use the last known @emph{commit} corresponding to @code{HEAD} in your Guix checkout, compute the hash of the Guix sources corresponding to that commit and update the @code{commit}, @code{revision} and hash of the @code{guix} package definition.
ru: @code{update-guix-package} make target воспользуется последним известным коммитом, согласно @code{HEAD} вашего Guix checkout, вычислить хэш источников Guix, соответствующих этому коммиту и обновите @code{commit}, @code{revision} и хэш @code{guix}.

note: type: Plain text
en: To validate that the updated @code{guix} package hashes are correct and that it can be built successfully, the following command can be run from the directory of your Guix checkout:
ru: Чтобы убедиться, что обновленные хеш-суммы пакета @code{guix} верны и что он может быть успешно собран, следующая команда может быть запущена из каталога Guix (from the directory of your Guix checkout):

note: type: example
en: ./pre-inst-env guix build guix
ru: ./pre-inst-env guix build gnew --keep-failed

note: type: Plain text
en: To guard against accidentally updating the @code{guix} package to a commit that others can't refer to, a check is made that the commit used has already been pushed to the Savannah-hosted Guix git repository.
ru: Чтобы предотвратить случайное обновление пакета @code{guix} к коммиту, на которую другие не могут ссылаться, выполняется проверка того, что использованный коммит уже был отправлен в репозиторий Guix, размещенный в Savannah.

note: type: Plain text
en: This check can be disabled, @emph{at your own peril}, by setting the @code{GUIX_ALLOW_ME_TO_USE_PRIVATE_COMMIT} environment variable.  When this variable is set, the updated package source is also added to the store.  This is used as part of the release process of Guix.
ru: Эту проверку можно отключить @emph{на свой страх и риск}, установив переменну окружения @code{GUIX_ALLOW_ME_TO_USE_PRIVATE_COMMIT}.  Когда эта переменная установлена, обновленный исходник пакета также добавляется в хранилище.  Это часть процесса выпуска Guix.

note: #-#-#-#-#  contributing.pot (guix manual checkout)  #-#-#-#-# type: cindex #-#-#-#-#  guix.pot (guix manual checkout)  #-#-#-#-# type: item
en: documentation
ru: документация

note: type: cindex
en: translation
ru: транзакции

note: type: cindex
en: native language support
ru: Работа с языками, поддерживаемыми gcc.

note: type: Plain text
en: Writing code and packages is not the only way to provide a meaningful contribution to Guix.  Translating to a language you speak is another example of a valuable contribution you can make.  This section is designed to describe the translation process.  It gives you advice on how you can get involved, what can be translated, what mistakes you should avoid and what we can do to help you!
ru: Написание кода и пакетов - не единственный способ внести значимый вклад в Guix.  Перевод на язык, на котором вы говорите---еще один пример вашего ценного вклада.  Этот раздел предназначен для описания процесса перевода. Здесь представлены советы о том, как вы можете принять участие, что можно перевести, каких ошибок следует избегать и что мы можем сделать, чтобы вам помочь!

note: type: Plain text
en: Guix is a big project that has multiple components that can be translated.  We coordinate the translation effort on a @uref{https://translate.fedoraproject.org/projects/guix/,Weblate instance} hosted by our friends at Fedora.  You will need an account to submit translations.
ru: Guix - это большой проект, состоящий из нескольких компонентов, которые можно перевести.  Мы координируем работу по переводу на @uref{https://translate.fedoraproject.org/projects/guix/,Weblate instance}, размещенном нашими друзьями в Fedora.  Для отправки переводов вам потребуется учетная запись.

note: type: Plain text
en: Some of the software packaged in Guix also contain translations.  We do not host a translation platform for them.  If you want to translate a package provided by Guix, you should contact their developers or find the information on their website.  As an example, you can find the homepage of the @code{hello} package by typing @code{guix show hello}.  On the ``homepage'' line, you will see @url{https://www.gnu.org/software/hello/} as the homepage.
ru: Некоторое программное обеспечение, упакованное в Guix, также содержит переводы.  Мы не хостим для них платформу для перевода.  Если вы хотите перевести пакет, предоставленный Guix, вам следует связаться с их разработчиками или найти информацию на их веб-сайтах.  Например, вы можете найти домашнюю страницу пакета @code{hello}, набрав @code{guix show hello}. В строке ``домашняя страница'' вы увидите @url{https://www.gnu.org/software/hello/} в качестве домашней страницы.

note: type: Plain text
en: Many GNU and non-GNU packages can be translated on the @uref{https://translationproject.org,Translation Project}.  Some projects with multiple components have their own platform.  For instance, GNOME has its own platform, @uref{https://l10n.gnome.org/,Damned Lies}.
ru: Многие пакеты GNU и не-GNU можно перевести на @uref{https: //translationproject.org,Translation Project}.  Некоторые проекты с несколькими компонентами имеют собственную платформу.  Например, GNOME имеет собственную платформу @uref{https://l10n.gnome.org/,Damned Lies}.

note: type: Plain text
en: Guix has five components hosted on Weblate.
ru: Guix состоит из пяти компонентов, размещенных на Weblate.

note: type: item
en: @code{guix} contains all the strings from the Guix software (the
ru: @code{guix} содержит все строки из программного обеспечения Guix (

note: type: itemize
en: guided system installer, the package manager, etc), excluding packages.
ru: установщик системы, менеджер пакетов и т.д.), за исключением пакетов.

note: type: item
en: @code{packages} contains the synopsis (single-sentence description
ru: @code{packages} содержит синопсис (описание пакета из одного предложения

note: type: itemize
en: of a package) and description (longer description) of packages in Guix.
ru: ) и (более подробное) описание пакетов в Guix.

note: type: item
en: @code{website} contains the official Guix website, except for
ru: @code{website} содержит официальный сайт Guix, за исключением

note: type: itemize
en: blog posts and multimedia content.
ru: сообщения в блогах и мультимедийный контент.

note: type: item
en: @code{documentation-manual} corresponds to this manual.
ru: @code{documentation-manual} соответствует этому руководству.

note: type: item
en: @code{documentation-cookbook} is the component for the cookbook.
ru: @code{documentation-cookbook} - компонент для поваренной книги.

note: type: subsubheading
en: General Directions
ru: поколения

note: type: Plain text
en: Once you get an account, you should be able to select a component from @uref{https://translate.fedoraproject.org/projects/guix/,the guix project}, and select a language.  If your language does not appear in the list, go to the bottom and click on the ``Start new translation'' button.  Select the language you want to translate to from the list, to start your new translation.
ru: После создания учетной записи вы сможете выбрать компонент из @uref{https://translate.fedoraproject.org/projects/guix/,the guix project} и выбрать язык.  Если вашего языка нет в списке, пройдите вниз и нажмите кнопку ``Начать новый перевод''.  Выберите из списка язык, на который вы хотите перевести, чтобы начать новый перевод.

note: type: Plain text
en: Like lots of other free software packages, Guix uses @uref{https://www.gnu.org/software/gettext,GNU Gettext} for its translations, with which translatable strings are extracted from the source code to so-called PO files.
ru: Как и многие другие бесплатные программные пакеты, Guix использует @uref{https://www.gnu.org/software/gettext,GNU Gettext} для своих переводов, с помощью которых переводимые строки извлекаются из исходного кода в так называемые PO-файлы.

note: type: Plain text
en: Even though PO files are text files, changes should not be made with a text editor but with PO editing software.  Weblate integrates PO editing functionality.  Alternatively, translators can use any of various free-software tools for filling in translations, of which @uref{https://poedit.net/,Poedit} is one example, and (after logging in)  @uref{https://docs.weblate.org/en/latest/user/files.html,upload} the changed file.  There is also a special @uref{https://www.emacswiki.org/emacs/PoMode,PO editing mode} for users of GNU Emacs.  Over time translators find out what software they are happy with and what features they need.
ru: Несмотря на то, что файлы PO являются текстовыми файлами, изменения следует вносить не с помощью текстового редактора, а с помощью программного обеспечения для редактирования PO.  Weblate интегрирует функции редактирования PO.  В качестве альтернативы переводчики могут использовать любой из различных бесплатных программных инструментов для заполнения переводов, одним из примеров которых является @uref{https://poedit.net/,Poedit} и (после входа в систему) @uref{https://docs.weblate.org/en/latest/user/files.html, загрузить} измененный файл.  Существует также специальный @uref {https://www.emacswiki.org/emacs/PoMode,PO режим редактирования} для пользователей GNU Emacs.  Со временем переводчики узнают, какое программное обеспечение им нравится и какие функции им нужны.

note: type: Plain text
en: On Weblate, you will find various links to the editor, that will show various subsets (or all) of the strings.  Have a look around and at the @uref{https://docs.weblate.org/en/latest/,documentation} to familiarize yourself with the platform.
ru: На Weblate вы найдете различные ссылки на редактор, который покажет различные подмножества (или все) строк (-и).  Посмотрите вокруг и на @uref{https://docs.weblate.org/en/latest/,documentation}, чтобы ознакомиться с платформой.

note: type: subsubheading
en: Translation Components
ru: Компоненты перевода

note: type: Plain text
en: In this section, we provide more detailed guidance on the translation process, as well as details on what you should or should not do.  When in doubt, please contact us, we will be happy to help!
ru: В этом разделе мы даем более подробные инструкции по процессу перевода, а также подробности о том, что вам следует или не следует делать.  В случае сомнений свяжитесь с нами, мы будем рады помочь!

note: #-#-#-#-#  contributing.pot (guix manual checkout)  #-#-#-#-# type: item #-#-#-#-#  guix.pot (guix manual checkout)  #-#-#-#-# type: cindex
en: packages
ru: пакеты

note: type: table
en: Package descriptions occasionally contain Texinfo markup (@pxref{Synopses and Descriptions}).  Texinfo markup looks like @samp{@@code@{rm -rf@}}, @samp{@@emph@{important@}}, etc.  When translating, please leave markup as is.
ru: Описания пакетов иногда содержат разметку Texinfo (@pxref{Synopses and Descriptions}).  Разметка Texinfo выглядит как @samp{@@code@{rm -rf@}}, @samp{@@emph@{important@}} и т.д.  При переводе оставляйте разметку как есть.

note: type: table
en: The first step to ensure a successful translation of the manual is to find and translate the following strings @emph{first}:
ru: Первый шаг к успешному переводу руководства---найти и перевести следующие строки @emph{первыми}:

note: type: item
en: @code{version.texi}: Translate this string as @code{version-xx.texi},
ru: @code{version.texi}: переведите эту строку как @code{version-xx.texi},

note: type: itemize
en: where @code{xx} is your language code (the one shown in the URL on weblate).
ru: где @code{xx}---код вашего языка (тот, который показан в URL-адресе на weblate).

note: type: item
en: @code{contributing.texi}: Translate this string as
ru: @code{contributing.texi}: переведите эту строку как

note: type: itemize
en: @code{contributing.xx.texi}, where @code{xx} is the same language code.
ru: @code{contributing.xx.texi}, где @code {xx} - код того же языка.

note: type: item
en: @code{Top}: Do not translate this string, it is important for Texinfo.
ru: @code{Top}: Не переводите эту строку, это важно для Texinfo.

note: type: itemize
en: If you translate it, the document will be empty (missing a Top node).  Please look for it, and register @code{Top} as its translation.
ru: Если вы переведете его, документ будет пустым (missing a Top node).  Найдите его и зарегистрируйте @code{Top} в качестве его перевода.

note: type: table
en: Translating these strings first ensure we can include your translation in the guix repository without breaking the make process or the @command{guix pull} machinery.
ru: Перевод этих строк гарантирует, что мы сможем включить ваш перевод в репозиторий guix, не нарушая процесс make или механизм @command{guix pull}.

note: type: table
en: When translating references from the cookbook to the manual, you need to replace the name of the manual and the name of the section.  For instance, to translate @code{@@pxref@{Defining Packages,,, guix, GNU Guix Reference Manual@}}, you would replace @code{Defining Packages} with the title of that section in the translated manual @emph{only} if that title is translated.  If the title is not translated in your language yet, do not translate it here, or the link will be broken.  Replace @code{guix} with @code{guix.xx} where @code{xx} is your language code.  @code{GNU Guix Reference Manual} is the text of the link.  You can translate it however you wish.
ru: При переводе ссылок из cookbook в мануал нужно заменить название мануала и название раздела.  Например, чтобы перевести @code{@@pxref@{Defining Packages,,, guix, GNU Guix Reference Manual@}}, вы должны заменить@code{Defining Packages} заголовком этого раздела в переведенном руководстве @emph{только} если это название переведено.  Если название еще не переведено на ваш язык, не переводите его здесь, иначе ссылка будет неработающей.  Замените @code{guix} на @code{guix.xx}, где @code{xx} - код вашего языка.  @code{GNU Guix Reference Manual}---это текст ссылки.  Вы можете перевести его как хотите.

note: type: item
en: website
ru: официальный веб-сайт

note: type: table
en: The website pages are written using SXML, an s-expression version of HTML, the basic language of the web.  We have a process to extract translatable strings from the source, and replace complex s-expressions with a more familiar XML markup, where each markup is numbered.  Translators can arbitrarily change the ordering, as in the following example.
ru: Страницы веб-сайта написаны с использованием SXML, версии HTML (основного языка Интернета) с s-выражениями.  У нас есть процесс извлечения переводимых строк из источника и замены сложных s-выражений на более знакомую разметку XML, где каждая разметка пронумерована.  Переводчики могут произвольно изменять порядок, как в следующем примере.

note: type: table
en: Note that you need to include the same markups.  You cannot skip any.
ru: Обратите внимание, что вам нужно включить такие же разметки.  Вы не можете ничего пропустить.

note: type: Plain text
en: In case you make a mistake, the component might fail to build properly with your language, or even make guix pull fail.  To prevent that, we have a process in place to check the content of the files before pushing to our repository.  We will not be able to update the translation for your language in Guix, so we will notify you (through weblate and/or by email) so you get a chance to fix the issue.
ru: Если вы допустили ошибку, компонент может не работать должным образом с вашим языком или даже привести к сбою guix pull.  Чтобы предотвратить это, у нас есть процесс проверки содержимого файлов перед отправкой в наш репозиторий.  Если, мы не сможем обновить перевод для вашего языка в Guix, мы уведомим вас (через веб-сайт и/или по электронной почте), чтобы решить проблему.

note: type: subsubheading
en: Outside of Weblate
ru: Вне Weblate

note: type: Plain text
en: Currently, some parts of Guix cannot be translated on Weblate, help wanted!
ru: В настоящее время некоторые части Guix не могут быть переведены на Weblate---требуется помощь!

note: type: item
en: @command{guix pull} news can be translated in @file{news.scm}, but is not
ru: @command{guix pull} новости можно перевести в @file{news.scm}, но не

note: type: itemize
en: translated.
ru: транзакции

note: type: title
en: GNU Guix Reference Manual
ru: Руководство по GNU Guix

note: type: include
en: version.texi
ru: version-ru.texi

note: type: copying
en: Permission is granted to copy, distribute and/or modify this document under the terms of the GNU Free Documentation License, Version 1.3 or any later version published by the Free Software Foundation; with no Invariant Sections, no Front-Cover Texts, and no Back-Cover Texts.  A copy of the license is included in the section entitled ``GNU Free Documentation License''.
ru: Разрешено копирование, распространение и/или модификация этого документа на условиях лицензии свободной документации GNU (GNU FDL) версии 1.3 или любой более поздней версии, опубликованной Фондом свободного программного обеспечения (FSF), исключая неизменяемые секции, исключая тексты, размещенные на переплёте и задней стороне обложки. Копия лицензии включена в документ в разделе под названием "GNU Free Documentation Licens".

note: type: dircategory
en: System administration
ru: Системное администрирование

note: type: menuentry
en: Manage installed software and system configuration.
ru: Управление установленным ПО и настройка системы.

note: type: menuentry
en: guix package: (guix)Invoking guix package
ru: guix package: (guix)Запуск guix package

note: type: menuentry
en: Installing, removing, and upgrading packages.
ru: Установка, удаление и обновление пакетов.

note: type: menuentry
en: guix gc: (guix)Invoking guix gc
ru: guix gc: (guix)Запуск guix gc

note: type: menuentry
en: Reclaiming unused disk space.
ru: Освобождение неиспользуемого места на диске.

note: type: menuentry
en: guix pull: (guix)Invoking guix pull
ru: guix pull: (guix)Запуск guix pull

note: type: menuentry
en: Update the list of available packages.
ru: Обновление списка доступных пакетов.

note: type: menuentry
en: guix system: (guix)Invoking guix system
ru: guix system: (guix)Запуск guix system

note: type: menuentry
en: Manage the operating system configuration.
ru: Управление конфигурацией ОС.

note: type: menuentry
en: guix deploy: (guix)Invoking guix deploy
ru: guix deploy: (guix)Запуск guix deploy

note: type: menuentry
en: Manage operating system configurations for remote hosts.
ru: Управление конфигурациями ОС на удалённых машинах.

note: type: dircategory
en: Software development
ru: Разработка программного обеспечения

note: type: menuentry
en: guix shell: (guix)Invoking guix shell
ru: guix shell: (guix)Запуск guix shell

note: type: menuentry
en: guix environment: (guix)Invoking guix environment
ru: guix environment: (guix)Запуск guix environment

note: type: menuentry
en: Building development environments with Guix.
ru: Сборка среды разработки с помощью Guix.

note: type: menuentry
en: guix build: (guix)Invoking guix build
ru: guix build: (guix)Запуск guix build

note: type: menuentry
en: Building packages.
ru: Сборка пакетов.

note: type: menuentry
en: guix pack: (guix)Invoking guix pack
ru: guix pack: (guix)Запуск guix pack

note: type: menuentry
en: Creating binary bundles.
ru: Создание бинарных пакетов.

note: type: subtitle
en: Using the GNU Guix Functional Package Manager
ru: Использование функционального пакетного менеджера GNU Guix

note: type: author
en: The GNU Guix Developers
ru: Разработчики GNU Guix

note: type: titlepage
en: Edition @value{EDITION} @* @value{UPDATED} @*
ru: Ревизия @value{EDITION} @* @value{UPDATED} @*

note: type: Plain text
en: This document describes GNU Guix version @value{VERSION}, a functional package management tool written for the GNU system.
ru: В этом документе описывается GNU Guix версии @value{VERSION} — менеджер пакетов, написанный для системы GNU.

note: type: chapter
en: Introduction
ru: Введение

note: type: menuentry
en: What is Guix about?
ru: Что такое Guix?

note: type: chapter
en: Installation
ru: Установка

note: type: menuentry
en: Installing Guix.
ru: Установка Guix.

note: type: chapter
en: System Installation
ru: Установка системы

note: type: menuentry
en: Installing the whole operating system.
ru: Полная установка операционной системы.

note: type: chapter
en: Getting Started
ru: Начиная

note: type: menuentry
en: Your first steps.
ru: Прервые шаги.

note: type: chapter
en: Package Management
ru: Управление пакетами

note: type: menuentry
en: Package installation, upgrade, etc.
ru: Установка пакетов, обновление и т.д.

note: type: chapter
en: Channels
ru: Каналы

note: type: menuentry
en: Customizing the package collection.
ru: Настройка коллекции пакетов.

note: type: chapter
en: Development
ru: Разработка

note: type: menuentry
en: Guix-aided software development.
ru: Разработка программного обеспечения при поддержке Guix.

note: type: chapter
en: Programming Interface
ru: Программный интерфейс

note: type: menuentry
en: Using Guix in Scheme.
ru: Использование Guix в Scheme.

note: type: chapter
en: Utilities
ru: Утилиты

note: type: menuentry
en: Package management commands.
ru: Команды управления пакетами.

note: type: chapter
en: System Configuration
ru: Конфигурирование системы

note: type: menuentry
en: Configuring the operating system.
ru: Конфигурирование операционной системы.

note: type: chapter
en: Documentation
ru: Документация

note: type: menuentry
en: Browsing software user manuals.
ru: Программы обзора пользовательских мануалов.

note: type: chapter
en: Installing Debugging Files
ru: Установка файлов отладки

note: type: menuentry
en: Feeding the debugger.
ru: Запуск отладчика.

note: type: chapter
en: Security Updates
ru: Обновления безопасности

note: type: menuentry
en: Deploying security fixes quickly.
ru: Быстрое применение исправлений безопасности.

note: type: chapter
en: Bootstrapping
ru: Начальная загрузка

note: type: menuentry
en: GNU/Linux built from scratch.
ru: Сборка GNU/Linux с нуля.

note: type: node
en: Porting
ru: Портирование

note: type: menuentry
en: Targeting another platform or kernel.
ru: Перевод на другую платформу или ядро.

note: type: menuentry
en: Your help needed!
ru: Нужна ваша помощь!

note: type: chapter
en: Acknowledgments
ru: Благодарности

note: type: menuentry
en: Thanks!
ru: Спасибо!

note: type: appendix
en: GNU Free Documentation License
ru: Лицензия свободной документации GNU

note: type: menuentry
en: The license of this manual.
ru: Лицензия этого руководства.

note: type: unnumbered
en: Concept Index
ru: Термины и указатели

note: type: menuentry
en: Concepts.
ru: Понятия.

note: type: unnumbered
en: Programming Index
ru: Программный индекс

note: type: menuentry
en: Data types, functions, and variables.
ru: Структуры данных, функции и переменные.

note: type: menuentry
en: --- The Detailed Node Listing ---
ru: --- Детальный список записей ---

note: type: section
en: Managing Software the Guix Way
ru: Управление программным обеспечением Guix Way

note: type: menuentry
en: What's special.
ru: Что особенного.

note: type: section
en: GNU Distribution
ru: Дистрибутив GNU

note: type: menuentry
en: The packages and tools.
ru: Пакеты и утилиты.

note: type: section
en: Binary Installation
ru: Бинарная установка

note: type: menuentry
en: Getting Guix running in no time!
ru: Запустить Guix в кратчайшие сроки!

note: type: section
en: Requirements
ru: Требования

note: type: menuentry
en: Software needed to build and run Guix.
ru: Программное обеспечение, необходимое для запуска Guix.

note: type: section
en: Running the Test Suite
ru: Запуск набора тестов

note: type: menuentry
en: Testing Guix.
ru: Тестирование Guix.

note: type: section
en: Setting Up the Daemon
ru: Настройка демона

note: type: menuentry
en: Preparing the build daemon's environment.
ru: Подготовка окружения демона сборки.

note: type: node
en: Invoking guix-daemon
ru: Вызов guix-daemon

note: type: menuentry
en: Running the build daemon.
ru: Запуск демона сборки.

note: type: section
en: Application Setup
ru: Установка приложения

note: type: menuentry
en: Application-specific setup.
ru: Установка в качестве приожения.

note: type: section
en: Upgrading Guix
ru: Обновление Guix

note: type: menuentry
en: Upgrading Guix and its build daemon.
ru: Обновление Guix и этого службы сборки.

note: type: subsection
en: Build Environment Setup
ru: Установка окружения сборки

note: type: menuentry
en: Preparing the isolated build environment.
ru: Подготовка отдельного окружения сборки.

note: type: node
en: Daemon Offload Setup
ru: Установка демона разгрузки

note: type: menuentry
en: Offloading builds to remote machines.
ru: Разгрузка сборок по удалённым машинам.

note: type: subsection
en: SELinux Support
ru: Поддержка SELinux

note: type: menuentry
en: Using an SELinux policy for the daemon.
ru: Использование политики SELinux для демона.

note: type: section
en: Limitations
ru: Ограничения

note: type: menuentry
en: What you can expect.
ru: Что нужно учитывать.

note: type: section
en: Hardware Considerations
ru: По поводу железа

note: type: menuentry
en: Supported hardware.
ru: Поддерживаемое аппаратное обеспечение.

note: type: section
en: USB Stick and DVD Installation
ru: Установочная флеш и DVD

note: type: menuentry
en: Preparing the installation medium.
ru: Подготовка установочного носителя.

note: type: section
en: Preparing for Installation
ru: Подготовка к установке

note: type: menuentry
en: Networking, partitioning, etc.
ru: Сеть, разметка диска и т.д.

note: type: section
en: Guided Graphical Installation
ru: Графическая установка в GUI

note: type: menuentry
en: Easy graphical installation.
ru: Простая графическая установка.

note: type: section
en: Manual Installation
ru: Ручная установка

note: type: menuentry
en: Manual installation for wizards.
ru: Ручная установка для магов.

note: type: section
en: After System Installation
ru: После установки системы

note: type: menuentry
en: When installation succeeded.
ru: Когда установка завершилась успешно.

note: type: node
en: Installing Guix in a VM
ru: Установка Guix на виртуальную машину

note: type: menuentry
en: Guix System playground.
ru: Площадка системы Guix.

note: type: section
en: Building the Installation Image
ru: Сборка установочного образа

note: type: menuentry
en: How this comes to be.
ru: Как это происходит.

note: type: node
en: Keyboard Layout and Networking and Partitioning
ru: Раскладка клавиатуры и работа с сетью и разбиение диска

note: type: menuentry
en: Initial setup.
ru: Начальная установка.

note: type: subsection
en: Proceeding with the Installation
ru: В продолжении установки

note: type: menuentry
en: Installing.
ru: Установка.

note: type: section
en: Features
ru: Особенности

note: type: menuentry
en: How Guix will make your life brighter.
ru: Как Guix делает жизнь ярче.

note: type: node
en: Invoking guix package
ru: Вызов guix package

note: type: menuentry
en: Package installation, removal, etc.
ru: Установка пакетов, удаление и т.д.

note: type: section
en: Substitutes
ru: Подстановки

note: type: menuentry
en: Downloading pre-built binaries.
ru: Скачивание собранных бинарников.

note: type: section
en: Packages with Multiple Outputs
ru: Пакеты со множественным выходом

note: type: menuentry
en: Single source package, multiple outputs.
ru: Один исходный пакет, различные выходы.

note: type: node
en: Invoking guix gc
ru: Вызов guix gc

note: type: menuentry
en: Running the garbage collector.
ru: Запуск сборщика мусора.

note: type: node
en: Invoking guix pull
ru: Запуск guix pull

note: type: menuentry
en: Fetching the latest Guix and distribution.
ru: Закачка последнего Guix и дистрибуции.

note: type: node
en: Invoking guix time-machine
ru: Вызов guix time-machine

note: type: menuentry
en: Running an older revision of Guix.
ru: Запуск более старых ревизий Guix.

note: type: section
en: Inferiors
ru: Младшие версии

note: type: menuentry
en: Interacting with another revision of Guix.
ru: Взаимодействие с другими ревизиями Guix.

note: type: node
en: Invoking guix describe
ru: Вызов guix describe

note: type: menuentry
en: Display information about your Guix revision.
ru: Отобразить информацию о ревизии Guix.

note: type: node
en: Invoking guix archive
ru: Вызов guix archive

note: type: menuentry
en: Exporting and importing store files.
ru: Экспорт и импорт файлов склада.

note: type: menuentry
en: One particular source of substitutes.
ru: Отдельный источник подстановок.

note: type: subsection
en: Substitute Server Authorization
ru: Авторизация сервера подстановок

note: type: menuentry
en: How to enable or disable substitutes.
ru: Как включить или отключить подстановки.

note: type: subsection
en: Getting Substitutes from Other Servers
ru: Получение заменителей с других серверов

note: type: menuentry
en: Substitute diversity.
ru: Разнообразие заменителей.

note: type: subsection
en: Substitute Authentication
ru: Аутентификация подстановок

note: type: menuentry
en: How Guix verifies substitutes.
ru: Как Guix проверяет подстановки.

note: type: subsection
en: Proxy Settings
ru: Настройки proxy

note: type: menuentry
en: How to get substitutes via proxy.
ru: Как получить подстановки через proxy.

note: type: subsection
en: Substitution Failure
ru: Ошибки при подстановке

note: type: menuentry
en: What happens when substitution fails.
ru: Что происходит, когда подстановка завершается ошибкой.

note: type: subsection
en: On Trusting Binaries
ru: Касательно проверенных бинарников

note: type: menuentry
en: How can you trust that binary blob?
ru: Как можно доверять определённому бинарному блоку?

note: type: section
en: Specifying Additional Channels
ru: Указание дополнительных каналов

note: type: menuentry
en: Extending the package collection.
ru: Расширение коллекции пакетов.

note: type: section
en: Using a Custom Guix Channel
ru: Использование отдельного канала Guix

note: type: menuentry
en: Using a customized Guix.
ru: Использование кастомизированного Guix.

note: type: section
en: Replicating Guix
ru: Копирование Guix

note: type: menuentry
en: Running the @emph{exact same} Guix.
ru: Запуск @emph{exact same} Guix.

note: type: section
en: Channel Authentication
ru: Аутентификация канала

note: type: menuentry
en: How Guix verifies what it fetches.
ru: Как Guix проверяет то, что получает.

note: type: section
en: Channels with Substitutes
ru: Каналы с заменителями

note: type: menuentry
en: Using channels with available substitutes.
ru: Использование каналов с доступными заменителями.

note: type: section
en: Creating a Channel
ru: Создание канала

note: type: menuentry
en: How to write your custom channel.
ru: Как написать собственный канал.

note: type: section
en: Package Modules in a Sub-directory
ru: Пакетные модули в поддиректории

note: type: menuentry
en: Specifying the channel's package modules location.
ru: Задание расположения пакетных модулей канала.

note: type: section
en: Declaring Channel Dependencies
ru: Объявление зависимостей канала

note: type: menuentry
en: How to depend on other channels.
ru: Как зависеть от других каналов.

note: type: section
en: Specifying Channel Authorizations
ru: Указание авторизаций канала

note: type: menuentry
en: Defining channel authors authorizations.
ru: Авторизация авторов канала.

note: type: section
en: Primary URL
ru: Основной URL

note: type: menuentry
en: Distinguishing mirror to original.
ru: Отличие зеркала от оригинала.

note: type: section
en: Writing Channel News
ru: Написание новостей канала

note: type: menuentry
en: Communicating information to channel's users.
ru: Передача информации пользователям канала.

note: type: node
en: Invoking guix shell
ru: Запуск guix shell

note: type: node
en: Invoking guix environment
ru: Запуск guix environment

note: type: menuentry
en: Setting up development environments.
ru: Настройка окружения сборки.

note: type: node
en: Invoking guix pack
ru: Запуск guix pack

note: type: menuentry
en: Creating software bundles.
ru: Создание наборов программ.

note: type: section
en: The GCC toolchain
ru: Тулчейн GCC

note: type: menuentry
en: Working with languages supported by GCC.
ru: Работа с языками, поддерживаемыми gcc.

note: type: node
en: Invoking guix git authenticate
ru: Запуск guix git authenticate

note: type: menuentry
en: Authenticating Git repositories.
ru: Аутентификация Git репозиториев.

note: type: section
en: Package Modules
ru: Пакетные модули

note: type: menuentry
en: Packages from the programmer's viewpoint.
ru: Пакеты с точки зрения программиста.

note: type: section
en: Defining Packages
ru: Описание пакетов

note: type: menuentry
en: Defining new packages.
ru: Описание новых пакетов.

note: type: menuentry
en: Customizing packages.
ru: Кастомизация пакетов.

note: type: section
en: Build Systems
ru: Системы сборки

note: type: menuentry
en: Specifying how packages are built.
ru: Задание параметров сборки пакетов.

note: type: subsection
en: Build Phases
ru: Фазы сборки

note: type: menuentry
en: Phases of the build process of a package.
ru: Фазы процесса сборки пакета.

note: type: menuentry
en: Helpers for your package definitions and more.
ru: Импорт описаниий пакетов.

note: type: section
en: The Store
ru: Хранилище

note: type: menuentry
en: Manipulating the package store.
ru: Работа с хранилищем пакетов.

note: type: section
en: Derivations
ru: Деривации

note: type: menuentry
en: Low-level interface to package derivations.
ru: Низкоуровневый интерфейс дериваций пакетов.

note: type: section
en: The Store Monad
ru: Устройство склада

note: type: menuentry
en: Purely functional interface to the store.
ru: Чисто функциональный интерфейс доступа к складу.

note: type: menuentry
en: Manipulating build expressions.
ru: Управление механизмом сборки.

note: type: node
en: Invoking guix repl
ru: Запуск guix repl

note: type: menuentry
en: Programming Guix in Guile.
ru: Программирование Guix в Guile.

note: type: node
en: package Reference
ru: ссылка на пакет

note: type: menuentry
en: The package data type.
ru: Тип данных package.

note: type: node
en: origin Reference
ru: Интерфейс origin

note: type: menuentry
en: The origin data type.
ru: Тип данных origin.

note: type: node
en: Invoking guix build
ru: Запуск guix build

note: type: menuentry
en: Building packages from the command line.
ru: Сборка пакетов в командной строке.

note: type: node
en: Invoking guix edit
ru: Запуск guix edit

note: type: menuentry
en: Editing package definitions.
ru: Редактирование описания пакета.

note: type: node
en: Invoking guix download
ru: Запуск guix download

note: type: menuentry
en: Downloading a file and printing its hash.
ru: Загрузка файла и вывод его хэша.

note: type: node
en: Invoking guix hash
ru: Запуск guix hash

note: type: menuentry
en: Computing the cryptographic hash of a file.
ru: Вычисление криптографического хеша файла.

note: type: node
en: Invoking guix import
ru: Запуск guix import

note: type: menuentry
en: Importing package definitions.
ru: Импорт описаниий пакетов.

note: type: node
en: Invoking guix refresh
ru: Запуск guix refresh

note: type: menuentry
en: Updating package definitions.
ru: Обновление описаний пакетов.

note: type: node
en: Invoking guix lint
ru: Запуск guix lint

note: type: menuentry
en: Finding errors in package definitions.
ru: Поиск ошибок в описаниях пакетов.

note: type: node
en: Invoking guix size
ru: Запуск guix size

note: type: menuentry
en: Profiling disk usage.
ru: Обзор использования диска.

note: type: node
en: Invoking guix graph
ru: Запуск guix graph

note: type: menuentry
en: Visualizing the graph of packages.
ru: Визуализация графа пакета.

note: type: node
en: Invoking guix publish
ru: Запуск guix publish

note: type: menuentry
en: Sharing substitutes.
ru: Совместное использование подстановок.

note: type: node
en: Invoking guix challenge
ru: Запуск guix challenge

note: type: menuentry
en: Challenging substitute servers.
ru: Соперничающие серверы подстановок.

note: type: node
en: Invoking guix copy
ru: Запуск guix copy

note: type: menuentry
en: Copying to and from a remote store.
ru: Копирование из и в удалённый склад.

note: type: node
en: Invoking guix container
ru: Запуск guix container

note: type: menuentry
en: Process isolation.
ru: Изоляция процесса.

note: type: node
en: Invoking guix weather
ru: Запуск guix weather

note: type: menuentry
en: Assessing substitute availability.
ru: Оценка доступности подстановок.

note: type: node
en: Invoking guix processes
ru: Запуск guix processes

note: type: menuentry
en: Listing client processes.
ru: Чтение клиентских процессов.

note: type: section
en: Invoking @command{guix build}
ru: Запуск @command{guix build}

note: type: subsection
en: Common Build Options
ru: Стандартные параметры сборки

note: type: menuentry
en: Build options for most commands.
ru: Параметры сборки для большинства команд.

note: type: subsection
en: Package Transformation Options
ru: Параметры преобразования пакета

note: type: menuentry
en: Creating variants of packages.
ru: Создание вариантов пакетов.

note: type: subsection
en: Additional Build Options
ru: Дополнительные параметры сборки

note: type: menuentry
en: Options specific to 'guix build'.
ru: Особые параметры для 'guix build'.

note: type: subsection
en: Debugging Build Failures
ru: Отладка ошибок сборки

note: type: menuentry
en: Real life packaging experience.
ru: Жизненный опыт в сборке пакетов.

note: type: section
en: Using the Configuration System
ru: Использование системы конфигурации

note: type: menuentry
en: Customizing your GNU system.
ru: Настройка вашей системы GNU.

note: type: node
en: operating-system Reference
ru: Интерфейс operating-system

note: type: menuentry
en: Detail of operating-system declarations.
ru: Подробные сведения об объявлениях opertaing-system.

note: type: section
en: File Systems
ru: Файловые системы

note: type: menuentry
en: Configuring file system mounts.
ru: Настройка точек подключения файловой системы.

note: type: section
en: Mapped Devices
ru: Размеченные устройства

note: type: menuentry
en: Block device extra processing.
ru: Дополнительные проверки блочных устройств.

note: type: section
en: User Accounts
ru: Учётные записи пользователей

note: type: menuentry
en: Specifying user accounts.
ru: Задание пользовательских учётных записей.

note: type: section
en: Keyboard Layout
ru: Раскладка клавиатуры

note: type: menuentry
en: How the system interprets key strokes.
ru: Интерпретация нажатия клавиш системой.

note: type: section
en: Locales
ru: Региональные настройки

note: type: menuentry
en: Language and cultural convention settings.
ru: Настройка языка и культурных особенностей.

note: type: node
en: Services
ru: Сервисы

note: type: menuentry
en: Specifying system services.
ru: Настройка системных служб.

note: type: section
en: Setuid Programs
ru: Программы setuid

note: type: section
en: X.509 Certificates
ru: Сертификаты X.509

note: type: menuentry
en: Authenticating HTTPS servers.
ru: Аутентификация серверов HTTPS.

note: type: section
en: Name Service Switch
ru: Служба выбора имён

note: type: menuentry
en: Configuring libc's name service switch.
ru: Настройка службы имён libc.

note: type: section
en: Initial RAM Disk
ru: Начальный RAM-диск

note: type: menuentry
en: Linux-Libre bootstrapping.
ru: Начальная загрузка Linux-Libre.

note: type: section
en: Bootloader Configuration
ru: Настройка загрузчика

note: type: menuentry
en: Configuring the boot loader.
ru: Конфигурирование загрузчика диска.

note: type: node
en: Invoking guix system
ru: Вызов guix system

note: type: menuentry
en: Instantiating a system configuration.
ru: Проверка конфигурации операционной системы.

note: type: node
en: Invoking guix deploy
ru: Запуск guix deploy

note: type: menuentry
en: Deploying a system configuration to a remote host.
ru: Развёртывание конфигурации системы на удалённой машине.

note: type: node
en: Running Guix in a VM
ru: Запуск Guix на виртуальной машине

note: type: menuentry
en: How to run Guix System in a virtual machine.
ru: Как запускать систему Guix на виртуальной машине.

note: type: section
en: Defining Services
ru: Создание служб

note: type: menuentry
en: Adding new service definitions.
ru: Добавление новых определений служб.

note: type: node
en: Invoking guix home
ru: Запуск guix home

note: type: subsection
en: Base Services
ru: Базовые службы

note: type: menuentry
en: Essential system services.
ru: Ключевые службы системы.

note: type: subsection
en: Scheduled Job Execution
ru: Запланированное исполнения задач

note: type: menuentry
en: The mcron service.
ru: Служба mcron.

note: type: subsection
en: Log Rotation
ru: Ротация логов

note: type: menuentry
en: The rottlog service.
ru: Сервис rottlog.

note: type: subsection
en: Networking Services
ru: Сервисы сети

note: type: subsection
en: Unattended Upgrades
ru: Автоматические обновления

note: type: menuentry
en: Automated system upgrades.
ru: Автоматические обновления системы.

note: type: subsection
en: X Window
ru: Оконная система X

note: type: menuentry
en: Graphical display.
ru: Графический дисплей.

note: type: subsection
en: Printing Services
ru: Сервисы печати

note: type: menuentry
en: Local and remote printer support.
ru: Поддержка локальных и удалённых принтеров.

note: type: subsection
en: Desktop Services
ru: Сервисы рабочего стола

note: type: menuentry
en: D-Bus and desktop services.
ru: D-Bus и сервисы рабочего стола.

note: type: subsection
en: Sound Services
ru: Звуковые сервисы

note: type: menuentry
en: ALSA and Pulseaudio services.
ru: Сервисы ALSA и Pulseaudio.

note: type: subsection
en: Database Services
ru: Сервисы баз данных

note: type: menuentry
en: SQL databases, key-value stores, etc.
ru: Базы данных SQL, базы ключ-значение и т. д.

note: type: subsection
en: Mail Services
ru: Почтовые сервисы

note: type: menuentry
en: IMAP, POP3, SMTP, and all that.
ru: IMAP, POP3, SMTP и прочее.

note: type: subsection
en: Messaging Services
ru: Сервисы сообщений

note: type: menuentry
en: Messaging services.
ru: Сервисы сообщений.

note: type: subsection
en: Telephony Services
ru: Сервисы телефонии

note: type: menuentry
en: Telephony services.
ru: Сервисы телефонии.

note: type: subsection
en: Monitoring Services
ru: Сервисы мониторинга

note: type: menuentry
en: Monitoring services.
ru: Сервисы мониторинга.

note: type: subsection
en: Kerberos Services
ru: Сервисы Kerberos

note: type: menuentry
en: Kerberos services.
ru: Сервисы Kerberos.

note: type: subsection
en: LDAP Services
ru: LDAP Сервисы

note: type: menuentry
en: LDAP services.
ru: LDAP сервисы.

note: type: subsection
en: Web Services
ru: Веб-сервисы

note: type: menuentry
en: Web servers.
ru: Веб-серверы.

note: type: subsection
en: Certificate Services
ru: Сервисы сертификатов

note: type: menuentry
en: TLS certificates via Let's Encrypt.
ru: Сертификаты TLS через Let's Encrypt.

note: type: subsection
en: DNS Services
ru: Сервисы DNS

note: type: menuentry
en: DNS daemons.
ru: DNS-демоны.

note: type: subsection
en: VPN Services
ru: VPN-сервисы

note: type: menuentry
en: VPN daemons.
ru: VPN-демоны.

note: type: node
en: Network File System
ru: Сетевые файловые системы

note: type: menuentry
en: NFS related services.
ru: Сервисы, работающие с сетевыми файловыми системами.

note: type: subsection
en: Continuous Integration
ru: Длительная интеграция

note: type: menuentry
en: Cuirass and Laminar services.
ru: Сервис Cuirass.

note: type: subsection
en: Power Management Services
ru: Сервисы управления питанием

note: type: menuentry
en: Extending battery life.
ru: Продление жизни батареи.

note: type: subsection
en: Audio Services
ru: Сервисы аудио

note: type: menuentry
en: The MPD.
ru: MPD.

note: type: subsection
en: Virtualization Services
ru: Сервисы виртуализации

note: type: menuentry
en: Virtualization services.
ru: Сервисы виртуализации.

note: type: subsection
en: Version Control Services
ru: Сервисы упраления версиями

note: type: menuentry
en: Providing remote access to Git repositories.
ru: Доступ к удалённым репозиториям Git.

note: type: subsection
en: Game Services
ru: Игровые службы

note: type: menuentry
en: Game servers.
ru: Игровые службы.

note: type: subsection
en: PAM Mount Service
ru: Службы подключения PAM

note: type: menuentry
en: Service to mount volumes when logging in.
ru: Служба подключения томов при входе в систему.

note: type: subsection
en: Guix Services
ru: Сервисы Guix

note: type: menuentry
en: Services relating specifically to Guix.
ru: Сервисы, касающиеся конкретно Guix.

note: type: subsection
en: Linux Services
ru: Службы Linux

note: type: menuentry
en: Services tied to the Linux kernel.
ru: Службы, привязанные к ядру Linux.

note: type: subsection
en: Hurd Services
ru: Сервисы Hurd

note: type: menuentry
en: Services specific for a Hurd System.
ru: Сервисы, касающиеся Hurd System.

note: type: subsection
en: Miscellaneous Services
ru: Разнообразные службы

note: type: menuentry
en: Other services.
ru: Другие службы.

note: type: subsection
en: Service Composition
ru: Структура сервисов

note: type: menuentry
en: The model for composing services.
ru: Модель построения сервисов.

note: type: subsection
en: Service Types and Services
ru: Типы сервисов и сервисы

note: type: menuentry
en: Types and services.
ru: Типы и сервисы.

note: type: subsection
en: Service Reference
ru: Интерфейс сервиса

note: type: menuentry
en: API reference.
ru: Доступ через API.

note: type: subsection
en: Shepherd Services
ru: Сервисы Shepherd

note: type: menuentry
en: A particular type of service.
ru: Особенный тип сервисов.

note: type: section
en: Separate Debug Info
ru: Отдельная информация об отладке

note: type: menuentry
en: Installing 'debug' outputs.
ru: Установка выводов отладочной информации.

note: type: section
en: Rebuilding Debug Info
ru: Сборка с отладочной информацией

note: type: menuentry
en: Building missing debug info.
ru: Сборка отсутствующей отладочной информации.

note: type: node
en: Reduced Binary Seed Bootstrap
ru: Уменьшение Binary Seed Bootstrap

note: type: menuentry
en: A Bootstrap worthy of GNU.
ru: Первичная загрузка, достойная GNU.

note: type: section
en: Preparing to Use the Bootstrap Binaries
ru: Подготовка к использованию двоичных файлов первоначальной загрузки

note: type: menuentry
en: Building that what matters most.
ru: Сборка самого главного.

note: type: cindex
en: purpose
ru: цель

note: type: Plain text
en: GNU Guix@footnote{``Guix'' is pronounced like ``geeks'', or ``ɡiːks'' using the international phonetic alphabet (IPA).} is a package management tool for and distribution of the GNU system.  Guix makes it easy for unprivileged users to install, upgrade, or remove software packages, to roll back to a previous package set, to build packages from source, and generally assists with the creation and maintenance of software environments.
ru: GNU Guix@footnote{"Guix" произносится "гикс".} --- это утилита для управления пакетами и дистрибутив системы GNU. Guix позволяет непривилегированным пользователям устанавливать, обновлять и удалять программные пакеты, откатываться до предыдущих наборов пакетов, собирать пакеты из исходников и обеспечивает создание и поддержку программного окружения в целом.

note: type: cindex
en: Guix System
ru: Система Guix

note: type: cindex
en: GuixSD, now Guix System
ru: GuixSD, теперь система Guix

note: type: cindex
en: Guix System Distribution, now Guix System
ru: Guix System Distribution, теперь система Guix

note: type: Plain text
en: You can install GNU@tie{}Guix on top of an existing GNU/Linux system where it complements the available tools without interference (@pxref{Installation}), or you can use it as a standalone operating system distribution, @dfn{Guix@tie{}System}@footnote{We used to refer to Guix System as ``Guix System Distribution'' or ``GuixSD''.  We now consider it makes more sense to group everything under the ``Guix'' banner since, after all, Guix System is readily available through the @command{guix system} command, even if you're using a different distro underneath!}.  @xref{GNU Distribution}.
ru: Вы можете установить GNU@tie{}Guix поверх существующей системы GNU/Linux, и она дополнит функции системы новой утилитой, не внося помехи (@pxref{Installation}). Или можно использовать отдельную операционную систему --- @dfn{Guix@tie{}System}@footnote{Мы называли систему Guix ``Guix System Distribution'' или ``GuixSD''.  Теперь мы считаем, удобнее объединить всё под названием ``Guix'', так что теперь командой @command{guix system} устанавливается система Guix, даже если вы используете другой дистирбутив для её запуска}.  @xref{GNU Distribution}.

note: type: cindex
en: user interfaces
ru: пользовательские интерфейсы

note: type: Plain text
en: Guix provides a command-line package management interface (@pxref{Package Management}), tools to help with software development (@pxref{Development}), command-line utilities for more advanced usage (@pxref{Utilities}), as well as Scheme programming interfaces (@pxref{Programming Interface}).
ru: Guix предоставляет интерфейс командной строки для управления пакетами (@pxref{Package Management}), инструменты, которые помогают в разработке программного обеспечения (@pxref{Development}), более сложные утилиты командной строки (@pxref{Utilities}), а также программный интерфейс Scheme (@pxref{Programming Interface}).

note: type: cindex
en: build daemon
ru: демон сборки

note: type: Plain text
en: Its @dfn{build daemon} is responsible for building packages on behalf of users (@pxref{Setting Up the Daemon}) and for downloading pre-built binaries from authorized sources (@pxref{Substitutes}).
ru: Его @dfn{демон сборки} отвечает за сборку пакетов по запросам пользователей (@pxref{Setting Up the Daemon}) и за скачивание компилированных бинарников из авторизованных ресурсов (@pxref{Substitutes}).

note: type: cindex
en: extensibility of the distribution
ru: расширяемость дистрибутива

note: type: cindex
en: customization, of packages
ru: настройка, пакетов

note: type: Plain text
en: Guix includes package definitions for many GNU and non-GNU packages, all of which @uref{https://www.gnu.org/philosophy/free-sw.html, respect the user's computing freedom}.  It is @emph{extensible}: users can write their own package definitions (@pxref{Defining Packages}) and make them available as independent package modules (@pxref{Package Modules}).  It is also @emph{customizable}: users can @emph{derive} specialized package definitions from existing ones, including from the command line (@pxref{Package Transformation Options}).
ru: Guix включает определения пакетов для множества проектов GNU и не-GNU, каждый из которых @uref{https://www.gnu.org/philosophy/free-sw.html, уважает свободу пользователя в работе за компьютером}. Он @emph{расширяемый}: пользователи могут писать свои собственные определения пакетов (@pxref{Defining Packages}) и делать их доступными как независимые пакетные модули (@pxref{Package Modules}). Он также @emph{настраиваемый}: пользователи могут @emph{получать} специальные определения пакетов из существующих, в том числе через командную строку (@pxref{Package Transformation Options}).

note: type: cindex
en: functional package management
ru: функциональное управление пакетами

note: type: cindex
en: isolation
ru: изоляция

note: type: Plain text
en: Under the hood, Guix implements the @dfn{functional package management} discipline pioneered by Nix (@pxref{Acknowledgments}).  In Guix, the package build and installation process is seen as a @emph{function}, in the mathematical sense.  That function takes inputs, such as build scripts, a compiler, and libraries, and returns an installed package.  As a pure function, its result depends solely on its inputs---for instance, it cannot refer to software or scripts that were not explicitly passed as inputs.  A build function always produces the same result when passed a given set of inputs.  It cannot alter the environment of the running system in any way; for instance, it cannot create, modify, or delete files outside of its build and installation directories.  This is achieved by running build processes in isolated environments (or @dfn{containers}), where only their explicit inputs are visible.
ru: Под капотом Guix работает как @dfn{функциональный пакетный менеджер} --- принцип, впервые введённый Nix (@pxref{Acknowledgments}). В Guix процесс сборки и установки пакета рассматривается как @emph{функция} в математическом смысле. Эта функция принимает входные данные, как например, скрипты сборки, компилятор, её результат зависит только от входных данных, и он не может зависеть от программ или скриптов, которые не подаются на вход явным образом. Функция сборки всегда производит один результат, когда получает один и тот же набор входных данных. Она не может как-либо изменять окружение запущенной системы; например, она не может создавать, изменять или удалять файлы за пределами её директорий сборки и установки. Это достигается так: процесс сборки запускается в изолированном окружении (или @dfn{контейнере}), в котором видны только входные данные, заданные явно.

note: type: cindex
en: store
ru: склад

note: type: Plain text
en: The result of package build functions is @dfn{cached} in the file system, in a special directory called @dfn{the store} (@pxref{The Store}).  Each package is installed in a directory of its own in the store---by default under @file{/gnu/store}.  The directory name contains a hash of all the inputs used to build that package; thus, changing an input yields a different directory name.
ru: Результат работы функций сборки пакетов кешируется в файловой системе в специальной директории, называемой @dfn{склад} (@pxref{The Store}).Каждый пакет устанавливается в собственную директорию склада, по умолчанию --- под @file{/gnu/store}. Имя директории содержит хеш всех входных данных, используемых для сборки этого пакета, так что изменение входных данных порождает различные имена директорий.

note: type: Plain text
en: This approach is the foundation for the salient features of Guix: support for transactional package upgrade and rollback, per-user installation, and garbage collection of packages (@pxref{Features}).
ru: Этот подход является принципиальным, на нём основаны ключевые особенностей Guix: поддержка транзакционного обновления пакета и откаты, установка для отдельного пользователя, сборка мусора от пакетов (@pxref{Features}).

note: type: Plain text
en: Guix comes with a distribution of the GNU system consisting entirely of free software@footnote{The term ``free'' here refers to the @url{https://www.gnu.org/philosophy/free-sw.html,freedom provided to users of that software}.}.  The distribution can be installed on its own (@pxref{System Installation}), but it is also possible to install Guix as a package manager on top of an installed GNU/Linux system (@pxref{Installation}).  When we need to distinguish between the two, we refer to the standalone distribution as Guix@tie{}System.
ru: Guix поставляется с дистрибутивом системы GNU, полностью состоящим из свободного программного обеспечения @footnote{Термин ``свободного'' здесь относится к @url{https://www.gnu.org/philosophy/free-sw.ru.html,свобода, предоставляемая пользователям этого программного обеспечения}.}.  Дистрибутив можно установить отдельно (@pxref{System Installation}), но также можно установить Guix в качестве пакетного менеджера поверх установленной системы GNU/Linux (@pxref{Installation}).  Когда нам нужно провести различие между ними, мы называем самодостаточный дистрибутив Guix@tie{}System.

note: type: Plain text
en: The distribution provides core GNU packages such as GNU libc, GCC, and Binutils, as well as many GNU and non-GNU applications.  The complete list of available packages can be browsed @url{https://www.gnu.org/software/guix/packages,on-line} or by running @command{guix package} (@pxref{Invoking guix package}):
ru: Дистрибутив предоставляет основные пакеты GNU, такие как GNU libc, GCC и Binutils, а также многие приложения GNU и не-GNU.  Полный список доступных пакетов можно просмотреть по @url{https://www.gnu.org/software/guix/packages,онлайн} или запустив @command{guix package} (@pxref{Invoking guix package}):

note: type: Plain text
en: Our goal is to provide a practical 100% free software distribution of Linux-based and other variants of GNU, with a focus on the promotion and tight integration of GNU components, and an emphasis on programs and tools that help users exert that freedom.
ru: Наша цель --- предоставить состоящий на 100% из свободного программного обеспечения рабочий дистрибуив Linux или другие варианты GNU. Мы ориентируемся на продвижении и полноценной интеграции компонентов GNU и поддержке программ и утилит, которые помогают пользователям реализовать их свободы.

note: type: Plain text
en: Packages are currently available on the following platforms:
ru: Пакеты в данные момент доступны для следующих платформ:

note: type: table
en: Intel/AMD @code{x86_64} architecture, Linux-Libre kernel.
ru: архитектура Intel/AMD @code{x86_64} с ядром Linux-Libre.

note: type: table
en: Intel 32-bit architecture (IA32), Linux-Libre kernel.
ru: архитектура Intel 32-bit (IA32) с ядром Linux-Libre.

note: type: table
en: ARMv7-A architecture with hard float, Thumb-2 and NEON, using the EABI hard-float application binary interface (ABI), and Linux-Libre kernel.
ru: Архитектура ARMv7-A с hard float, Thumb-2 и NEON, используя двочиный интерфейс приложений EABI hard-float (ABI), с ядром Linux-Libre.

note: type: table
en: little-endian 64-bit ARMv8-A processors, Linux-Libre kernel.
ru: процессоры little-endian 64-bit ARMv8-A с ядром Linux-Libre.

note: type: table
en: @uref{https://hurd.gnu.org, GNU/Hurd} on the Intel 32-bit architecture (IA32).
ru: @uref{https://hurd.gnu.org, GNU/Hurd} на 32 битной архитектуре Intel (IA32).

note: type: table
en: This configuration is experimental and under development.  The easiest way for you to give it a try is by setting up an instance of @code{hurd-vm-service-type} on your GNU/Linux machine (@pxref{transparent-emulation-qemu, @code{hurd-vm-service-type}}).  @xref{Contributing}, on how to help!
ru: Эта конфигурация является экспериментальной и находится в разработке.  Самый простой способ попробовать - настроить экземпляр @code{hurd-vm-service-type} на вашем GNU/Linux компьютере (@pxref{transparent-emulation-qemu, @code{hurd-vm-service-type}}).  @xref{Contributing}, о том, как помочь!

note: type: table
en: little-endian 64-bit MIPS processors, specifically the Loongson series, n32 ABI, and Linux-Libre kernel.  This configuration is no longer fully supported; in particular, there is no ongoing work to ensure that this architecture still works.  Should someone decide they wish to revive this architecture then the code is still available.
ru: 64-разрядные little-endian процессоры MIPS порядком байтов, в частности серии Loongson, n32 ABI и ядро Linux-Libre. Эта конфигурация больше не поддерживается полностью; в частности, фермы сборки проекта больше не предоставляют замены этой архитектуре.

note: type: table
en: little-endian 64-bit Power ISA processors, Linux-Libre kernel.  This includes POWER9 systems such as the @uref{https://www.fsf.org/news/talos-ii-mainboard-and-talos-ii-lite-mainboard-now-fsf-certified-to-respect-your-freedom, RYF Talos II mainboard}. This platform is available as a "technology preview": although it is supported, substitutes are not yet available from the build farm (@pxref{Substitutes}), and some packages may fail to build (@pxref{Tracking Bugs and Patches}).  That said, the Guix community is actively working on improving this support, and now is a great time to try it and get involved!
ru: 64-битные процессоры Power ISA с прямым порядком байтов, ядро Linux-Libre. Сюда входят системы POWER9, такие как@uref{https://www.fsf.org/news/talos-ii-mainboard-and-talos-ii-lite-mainboard-now-fsf-certified-to-respect-your-freedom, RYF Talos II mainboard}. Эта платформа доступна как «предварительная версия»: хотя она и поддерживается, заменители еще не доступны  (@pxref{Substitutes}), а некоторые пакеты могут не собираться (@pxref{Tracking Bugs and Patches}) .  Тем не менее, сообщество Guix активно работает над улучшением этой поддержки, и сейчас отличное время, чтобы попробовать и принять участие!

note: type: Plain text
en: With Guix@tie{}System, you @emph{declare} all aspects of the operating system configuration and Guix takes care of instantiating the configuration in a transactional, reproducible, and stateless fashion (@pxref{System Configuration}).  Guix System uses the Linux-libre kernel, the Shepherd initialization system (@pxref{Introduction,,, shepherd, The GNU Shepherd Manual}), the well-known GNU utilities and tool chain, as well as the graphical environment or system services of your choice.
ru: Пользуясь системой@tie{}Guix, вы @emph{объявляете} все аспекты конфигурации системы, и Guix выполняет установку инстранции ОС транзакционным, повторяемым способом, не имеющей состояния (stateless) (@pxref{System Configuration}). Система Guix использует ядро Linux-libre, систему инициализации Shepherd (@pxref{Introduction,,, shepherd, The GNU Shepherd Manual}), хорошо известные утилиты и тулчейны GNU, а также графическое окружение на выбор.

note: type: Plain text
en: For information on porting to other architectures or kernels, @pxref{Porting}.
ru: Информация о портировании на другие архитектуры и ядра доступна в @pxref{Porting}.

note: type: Plain text
en: Building this distribution is a cooperative effort, and you are invited to join! @xref{Contributing}, for information about how you can help.
ru: Дистрибутив созаётся совместными усилиями, приглашаем вас! См. @xref{Contributing}, чтобы узнать о том, как вы можете помочь.

note: type: cindex
en: installing Guix
ru: Установка Guix

note: type: quotation
en: We recommend the use of this @uref{https://git.savannah.gnu.org/cgit/guix.git/plain/etc/guix-install.sh, shell installer script} to install Guix on top of a running GNU/Linux system, thereafter called a @dfn{foreign distro}.@footnote{This section is concerned with the installation of the package manager, which can be done on top of a running GNU/Linux system.  If, instead, you want to install the complete GNU operating system, @pxref{System Installation}.} The script automates the download, installation, and initial configuration of Guix.  It should be run as the root user.
ru: Мы рекомендуем использовать этот @uref{https://git.savannah.gnu.org/cgit/guix.git/plain/etc/guix-install.sh, скрипт установки} для установки Guix на существующую систему GNU/Linux, называемый далее @dfn{чужой дистрибутив}.@footnote{Этот раздел описывает установку пакетного менеджера поверх существующей системы GNU/Linux. Если вместо этого вы хотите установить отдельную операционную систему GNU, смотрите @pxref{System Installation}.} Скрипт автоматизирует скачивание, установку и начальную конфигурацию Guix. Он должен запускаться от пользователя root.

note: type: cindex
en: foreign distro
ru: чужой дистрибутив

note: type: cindex
en: directories related to foreign distro
ru: директории относящиеся к чужому дистрибутиву

note: type: Plain text
en: When installed on a foreign distro, GNU@tie{}Guix complements the available tools without interference.  Its data lives exclusively in two directories, usually @file{/gnu/store} and @file{/var/guix}; other files on your system, such as @file{/etc}, are left untouched.
ru: При установке на чужой дистрибутив GNU@tie{}Guix дополняет доступные утилиты без внесения помех. Его данные живут только в двух директориях --- обычно @file{/gnu/store} и @file{/var/guix}; другие файлы вашей системы, как @file{/etc}, остаются нетронутыми.

note: type: Plain text
en: Once installed, Guix can be updated by running @command{guix pull} (@pxref{Invoking guix pull}).
ru: Установленный Guix можно обновлять командой @command{guix pull} (@pxref{Invoking guix pull}).

note: type: Plain text
en: If you prefer to perform the installation steps manually or want to tweak them, you may find the following subsections useful.  They describe the software requirements of Guix, as well as how to install it manually and get ready to use it.
ru: Если вы предпочитаете выполнять шаги установки вручную или хотита подправить их, следующие параграфы будут полезны. В них описаны требования Guix к программному обеспечению, а также процесс ручной установки до запуска в работу.

note: type: cindex
en: installing Guix from binaries
ru: установка Guix из бинарных файлов

note: type: cindex
en: installer script
ru: скрипт установки

note: type: Plain text
en: This section describes how to install Guix on an arbitrary system from a self-contained tarball providing binaries for Guix and for all its dependencies.  This is often quicker than installing from source, which is described in the next sections.  The only requirement is to have GNU@tie{}tar and Xz.
ru: Этот раздел описывает, как установить Guix на обычную систему из отдельного архива, который содержит бинарники Guix и все его зависимости. Это обычно быстрее установки из исходных кодов, которая описана в следующем разделе. Единственное требование - иметь GNU@tie{}tar и Xz.

note: type: quotation
en: We recommend the use of this @uref{https://git.savannah.gnu.org/cgit/guix.git/plain/etc/guix-install.sh, shell installer script}.  The script automates the download, installation, and initial configuration steps described below.  It should be run as the root user.  As root, you can thus run this:
ru: Мы рекомендуем использовать этот @uref{https://git.savannah.gnu.org/cgit/guix.git/plain/etc/guix-install.sh, установочный скрипт}.  Скрипт автоматизирует скачивание, установку и начальные шаги конфигурации, описанные ниже.  Он должен запускаться от пользователя root. Как root вы можете запустить это:

note: type: quotation
en: When you're done, @pxref{Application Setup} for extra configuration you might need, and @ref{Getting Started} for your first steps!
ru: Когда закончите, вам может понадобиться @pxref{Application Setup} для дополнительной настройки и @ref{Getting Started}!

note: type: Plain text
en: Installing goes along these lines:
ru: Установка производится следующими образом:

note: type: cindex
en: downloading Guix binary
ru: скачивание бинарника Guix

note: type: enumerate
en: Download the binary tarball from @indicateurl{@value{BASE-URL}/guix-binary-@value{VERSION}.x86_64-linux.tar.xz}, where @code{x86_64-linux} can be replaced with @code{i686-linux} for an @code{i686} (32-bits) machine already running the kernel Linux, and so on (@pxref{GNU Distribution}).
ru: Скачайте архив с бинарником из @indicateurl{@value{BASE-URL}/guix-binary-@value{VERSION}.@var{system}.tar.xz}, где @var{system} --- это @code{x86_64-linux} для машины @code{x86_64}, на которой уже запущено ядро Linux, и так далее.

note: type: enumerate
en: Make sure to download the associated @file{.sig} file and to verify the authenticity of the tarball against it, along these lines:
ru: Убедитесь в аутентичности архива, скачав файл @file{.sig} и запустив:

note: type: Plain text
en: If that command fails because you do not have the required public key, then run this command to import it:
ru: Если это завершается ошибкой, значит у вас нет необходимого публичного ключа, тогда запустите команду для импорта ключа:

note: type: Plain text
en: and rerun the @code{gpg --verify} command.
ru: и запустите команду @code{gpg --verify}.

note: type: Plain text
en: Take note that a warning like ``This key is not certified with a trusted signature!'' is normal.
ru: Обратите внимание, что предупреждение по типу «Этот ключ не сертифицирован с доверенной подписью!» является нормальным.

note: type: enumerate
en: Now, you need to become the @code{root} user.  Depending on your distribution, you may have to run @code{su -} or @code{sudo -i}.  As @code{root}, run:
ru: Теперь вам необходимы привилегии пользователя @code{root}. В зависимости от вашего дистрибутива, можно запустить @code{su -} или @code{sudo -i}.  Под @code{root} запустите:

note: type: enumerate
en: This creates @file{/gnu/store} (@pxref{The Store}) and @file{/var/guix}.  The latter contains a ready-to-use profile for @code{root} (see next step).
ru: Это создаёт @file{/gnu/store} (@pxref{The Store}) и @file{/var/guix}. Последнее содержит готовый к использованию профиль для @code{root} (подробнее в следующем шаге).

note: type: enumerate
en: Do @emph{not} unpack the tarball on a working Guix system since that would overwrite its own essential files.
ru: @emph{Не} распаковывайте архив в работающую систему Guix, так как это перезапишет её основные файлы.

note: type: enumerate
en: The @option{--warning=no-timestamp} option makes sure GNU@tie{}tar does not emit warnings about ``implausibly old time stamps'' (such warnings were triggered by GNU@tie{}tar 1.26 and older; recent versions are fine).  They stem from the fact that all the files in the archive have their modification time set to 1 (which means January 1st, 1970).  This is done on purpose to make sure the archive content is independent of its creation time, thus making it reproducible.
ru: Опция  @code{--warning=no-timestamp} необходима, чтобы удостовериться, что GNU@tie{}tar не вызывает ошибок об "устаревшей дате", подобные ошибки появлялись в GNU@tie{}tar 1.26 и старше, в последних версиях всё в порядке). Они возникают из-за того, что архив имеет нулевую дату модификации (что соответствует 1 января 1970). Это сделано с той целью, чтобы удостовериться, что содержимое архива не засисит от даты его создания, что делает его воспроизводимым (повторяемым).

note: type: enumerate
en: Make the profile available under @file{~root/.config/guix/current}, which is where @command{guix pull} will install updates (@pxref{Invoking guix pull}):
ru: Сделайте профиль доступным по пути @file{~root/.config/guix/current}, куда @command{guix pull} будет устанавливать обновления (@pxref{Invoking guix pull}):

note: type: enumerate
en: Source @file{etc/profile} to augment @env{PATH} and other relevant environment variables:
ru: Добавьте @file{etc/profile} в @code{PATH} и другие уместные переменные окружения:

note: type: enumerate
en: Create the group and user accounts for build users as explained below (@pxref{Build Environment Setup}).
ru: Создайте группу и пользовательские учётные записи, как это обозначено в (@pxref{Build Environment Setup}).

note: type: enumerate
en: Run the daemon, and set it to automatically start on boot.
ru: Запустите демон и сделайте добавьте его в автоззагрузку после старта.

note: type: enumerate
en: If your host distro uses the systemd init system, this can be achieved with these commands:
ru: Если ваш дистрибутив использует систему инициализации systemd, этого можно добиться следующими командами:

note: type: example
en: # cp ~root/.config/guix/current/lib/systemd/system/gnu-store.mount \
         ~root/.config/guix/current/lib/systemd/system/guix-daemon.service \
         /etc/systemd/system/
    # systemctl enable --now gnu-store.mount guix-daemon
ru: # cp ~root/.config/guix/current/lib/systemd/system/gnu-store.mount \
         ~root/.config/guix/current/lib/systemd/system/guix-daemon.service \
        /etc/systemd/system/
    # systemctl enable --now gnu-store.mount guix-daemon

note: type: itemize
en: If your host distro uses the Upstart init system:
ru: Если ваш дистрибутив использует систему инициализации Upstart:

note: type: enumerate
en: Otherwise, you can still start the daemon manually with:
ru: Или можно запускать демон вручную так:

note: type: enumerate
en: Make the @command{guix} command available to other users on the machine, for instance with:
ru: Сделайте команду @command{guix} доступной для других пользователей машины, например, так:

note: type: enumerate
en: It is also a good idea to make the Info version of this manual available there:
ru: Хорошо также предоставить доступ к Info-версии руководства так:

note: type: enumerate
en: That way, assuming @file{/usr/local/share/info} is in the search path, running @command{info guix} will open this manual (@pxref{Other Info Directories,,, texinfo, GNU Texinfo}, for more details on changing the Info search path).
ru: Таким образом, если предположить, что @file{/usr/local/share/info} находится в пути поиска, запуск @command{info guix} откроет это руководство (см., @pxref{Other Info Directories,,, texinfo, GNU Texinfo}).

note: type: cindex
en: substitutes, authorization thereof
ru: авторизация, подстановок

note: type: enumerate
en: Each user may need to perform a few additional steps to make their Guix environment ready for use, @pxref{Application Setup}.
ru: Каждый пользователь, возможно, должен выполнить дополнительные шаги, чтобы сделать их окружение Guix готовым к использованию @pxref{Application Setup}.

note: type: Plain text
en: Voilà, the installation is complete!
ru: Вуаля! Установка завершена!

note: type: Plain text
en: You can confirm that Guix is working by installing a sample package into the root profile:
ru: Вы можете проверить, что Guix работает, установив тестовый пакет для профиля root:

note: type: Plain text
en: The binary installation tarball can be (re)produced and verified simply by running the following command in the Guix source tree:
ru: Архив для бинарной установки может быть воспроизведён (повторён) и проверен простым запуском следующей команды в дереве исходников Guix:

note: type: Plain text
en: ...@: which, in turn, runs:
ru: ..., что в свою очередь, выполнит:

note: type: Plain text
en: @xref{Invoking guix pack}, for more info on this handy tool.
ru: @xref{Invoking guix pack} для подробной информации об этом полезном инструменте.

note: type: Plain text
en: This section lists requirements when building Guix from source.  The build procedure for Guix is the same as for other GNU software, and is not covered here.  Please see the files @file{README} and @file{INSTALL} in the Guix source tree for additional details.
ru: Этот раздел содержит требования для сборки Guix из исходников. Пожалуйста, смотрите файлы @file{README} и @file{INSTALL} в дереве исходников Guix для подробной информации.

note: type: cindex
en: official website
ru: официальный веб-сайт

note: type: Plain text
en: GNU Guix is available for download from its website at @url{https://www.gnu.org/software/guix/}.
ru: GNU Guix доступен для скачивания на сайте @url{https://www.gnu.org/software/guix/}.

note: type: Plain text
en: GNU Guix depends on the following packages:
ru: GNU Guix зависит от следующих пакетов:

note: type: item
en: @url{https://notabug.org/cwebber/guile-gcrypt, Guile-Gcrypt}, version
ru: @url{https://notabug.org/cwebber/guile-gcrypt, Guile-Gcrypt} версии

note: type: itemize
en: 0.1.0 or later;
ru: 0.1.0 или более поздней;

note: type: itemize
en: @uref{https://notabug.org/guile-sqlite3/guile-sqlite3, Guile-SQLite3}, version 0.1.0 or later;
ru: @uref{https://notabug.org/guile-sqlite3/guile-sqlite3, Guile-SQLite3} версии 0.1.0 или новее;

note: type: itemize
en: version 0.1.0 or later;
ru: 0.1.0 или более поздней;

note: type: itemize
en: 4.3.0 or later;
ru: 4.3.0 или более поздней;

note: type: Plain text
en: The following dependencies are optional:
ru: Следующие зависимости необязательны:

note: type: itemize
en: Support for build offloading (@pxref{Daemon Offload Setup}) and @command{guix copy} (@pxref{Invoking guix copy}) depends on @uref{https://github.com/artyom-poptsov/guile-ssh, Guile-SSH}, version 0.13.0 or later.
ru: Поддержка разгрузки сборки (@pxref{Daemon Offload Setup}) и @command{guix copy} (@pxref{Invoking guix copy}) зависят от @uref{https://github.com/artyom-poptsov/guile-ssh, Guile-SSH} версии 0.10.2 или новее.

note: type: itemize
en: @uref{https://notabug.org/guile-zstd/guile-zstd, Guile-zstd}, for zstd compression and decompression in @command{guix publish} and for substitutes (@pxref{Invoking guix publish}).
ru: @uref{https://notabug.org/guile-zstd/guile-zstd, Guile-zstd}, для zstd сжатия и распаковки в @command{guix publish} и для заменителей (@pxref{Invoking guix publish}).

note: type: itemize
en: @uref{https://ngyro.com/software/guile-semver.html, Guile-Semver} for the @code{crate} importer (@pxref{Invoking guix import}).
ru: @uref{https://ngyro.com/software/guile-semver.html, Guile-Semver} для @code{crate} импортера (@pxref{Invoking guix import}).

note: type: itemize
en: @uref{https://www.nongnu.org/guile-lib/doc/ref/htmlprag/, Guile-Lib} for the @code{go} importer (@pxref{Invoking guix import}) and for some of the ``updaters'' (@pxref{Invoking guix refresh}).
ru: @uref{https://ngyro.com/software/guile-semver.html, Guile-Semver} для @code{crate} импортера (@pxref{Invoking guix import}).

note: type: itemize
en: When @url{http://www.bzip.org, libbz2} is available, @command{guix-daemon} can use it to compress build logs.
ru: Если доступна @url{http://www.bzip.org, libbz2}, @command{guix-daemon} может использовать её для сжатия логов сборки.

note: type: Plain text
en: Unless @option{--disable-daemon} was passed to @command{configure}, the following packages are also needed:
ru: Если строка @code{--disable-daemon} не использовалась в @command{configure}, тогда необходимы также следующие пакеты:

note: type: item
en: @url{https://gcc.gnu.org, GCC's g++}, with support for the
ru: @url{https://gcc.gnu.org, GCC's g++} с поддержкой

note: type: itemize
en: C++11 standard.
ru: стандарта C++11.

note: type: cindex
en: state directory
ru: главный каталог

note: type: Plain text
en: When configuring Guix on a system that already has a Guix installation, be sure to specify the same state directory as the existing installation using the @option{--localstatedir} option of the @command{configure} script (@pxref{Directory Variables, @code{localstatedir},, standards, GNU Coding Standards}).  Usually, this @var{localstatedir} option is set to the value @file{/var}.  The @command{configure} script protects against unintended misconfiguration of @var{localstatedir} so you do not inadvertently corrupt your store (@pxref{The Store}).
ru: Если Guix развёртывается в системе, где уже был установлен Guix, необходимо указать главный каталог предыдущей инсталляции, используя параметр @code{--localstatedir} в скрипте @command{configure} (@pxref{Directory Variables, @code{localstatedir},, standards, GNU Coding Standards}). Скрипт @command{configure} защищает от ошибок в конфигурации @var{localstatedir}, предотвращая непреднамеренное повреждение хранилища (@pxref{The Store}).

note: type: cindex
en: test suite
ru: набор тестов

note: type: Plain text
en: After a successful @command{configure} and @code{make} run, it is a good idea to run the test suite.  It can help catch issues with the setup or environment, or bugs in Guix itself---and really, reporting test failures is a good way to help improve the software.  To run the test suite, type:
ru: После успешного завершения @command{configure} и @code{make} хорошо бы выполнить набор тестов. Это поможет выявить проблемы установки или в окружении, как и баги самого Guix (на самом деле, отчёты об ошибках тестов помогают улучшить ПО). Чтобы запустить тесты, напечатайте:

note: type: Plain text
en: Test cases can run in parallel: you can use the @code{-j} option of GNU@tie{}make to speed things up.  The first run may take a few minutes on a recent machine; subsequent runs will be faster because the store that is created for test purposes will already have various things in cache.
ru: Тесты можно выполнять параллельно при включении опции @code{-j} в GNU@tie{}make, так быстрее. Первый запуск может длиться несколько минут на топовой машине, последующие запуски будут быстрее, так как склад, который создаётся для тестов, уже закеширует различные вещи.

note: type: Plain text
en: It is also possible to run a subset of the tests by defining the @code{TESTS} makefile variable as in this example:
ru: Также можно запустить отдельные наборы тестов, используя переменную @code{TESTS}, как в примере:

note: type: Plain text
en: By default, tests results are displayed at a file level.  In order to see the details of every individual test cases, it is possible to define the @code{SCM_LOG_DRIVER_FLAGS} makefile variable as in this example:
ru: По умолчанию результаты тестов выводятся в файл. Чтобы просмотреть результаты каждого отдельного теста, нужно задать переменную makifile @code{SCM_LOG_DRIVER_FLAGS}, как в примере:

note: type: Plain text
en: The underlying SRFI 64 custom Automake test driver used for the 'check' test suite (located at @file{build-aux/test-driver.scm}) also allows selecting which test cases to run at a finer level, via its @option{--select} and @option{--exclude} options.  Here's an example, to run all the test cases from the @file{tests/packages.scm} test file whose names start with ``transaction-upgrade-entry'':
ru: Лежащий в основе кастомный SRFI 64 Automake тестовый драйвер, используемый для 'проверки' набора тестов (расположенный в @file{build-aux/test-driver.scm}) также позволяет выбрать, какие тестовые случаи запускать на более высоком уровне, при помощи опций @option{--select} и @option{--exclude}.  Вот пример для запуска всех тестовых случаев из файла @file{tests/packages.scm}, чьи имена начинаются с ``transaction-upgrade-entry'':

note: type: Plain text
en: Those wishing to inspect the results of failed tests directly from the command line can add the @option{--errors-only=yes} option to the @code{SCM_LOG_DRIVER_FLAGS} makefile variable and set the @code{VERBOSE} Automake makefile variable, as in:
ru: Желающие проверить результаты неудачных тестов прямо из командной строки могут добавить @option{--errors-only=yes} к makefile переменной@code{SCM_LOG_DRIVER_FLAGS} и задать Automake makefile переменную @code{VERBOSE}, как в:

note: type: example
en: make check SCM_LOG_DRIVER_FLAGS="--brief=no --errors-only=yes" VERBOSE=1
ru: make check TESTS="tests/base64.scm" SCM_LOG_DRIVER_FLAGS="--brief=no"

note: type: Plain text
en: The @option{--show-duration=yes} option can be used to print the duration of the individual test cases, when used in combination with @option{--brief=no}:
ru: Опция @option{--show-duration=yes} может быть использована чтобы отобразить продолжительность отдельных тестовых случаев, когда использована вместе с @option{--brief=no}:

note: type: example
en: make check SCM_LOG_DRIVER_FLAGS="--brief=no --show-duration=yes"
ru: make check TESTS="tests/base64.scm" SCM_LOG_DRIVER_FLAGS="--brief=no"

note: type: Plain text
en: @xref{Parallel Test Harness,,,automake,GNU Automake} for more information about the Automake Parallel Test Harness.
ru: @xref{Parallel Test Harness,,,automake,GNU Automake} для получения дополнительной информации о Automake Parallel Test Harness.

note: type: Plain text
en: Upon failure, please email @email{bug-guix@@gnu.org} and attach the @file{test-suite.log} file.  Please specify the Guix version being used as well as version numbers of the dependencies (@pxref{Requirements}) in your message.
ru: В случае ошибки, пожалуйста, отправьте сообщение на  @email{bug-guix@@gnu.org} и присоедините файл @file{test-suite.log}.  Пожалуйста, обозначьте в сообщении используемую версию Guix, а также номера версий зависимостей (@pxref{Requirements}).

note: type: Plain text
en: Guix also comes with a whole-system test suite that tests complete Guix System instances.  It can only run on systems where Guix is already installed, using:
ru: Guix также идёт с набором тестов для всей системы, который проверяет нстранцию системы Guix. Их можно запустить только в системах, где Guix уже установлен, так:

note: type: Plain text
en: or, again, by defining @code{TESTS} to select a subset of tests to run:
ru: или, опять же, задав @code{TESTS}, чтобы выбрать список тестов для запуска:

note: type: Plain text
en: These system tests are defined in the @code{(gnu tests @dots{})} modules.  They work by running the operating systems under test with lightweight instrumentation in a virtual machine (VM).  They can be computationally intensive or rather cheap, depending on whether substitutes are available for their dependencies (@pxref{Substitutes}).  Some of them require a lot of storage space to hold VM images.
ru: Тесты системы определены в модулях @code{(gnu tests @dots{})}. При работе они запускают операционную систему под легковесным инструментарием в виртуальной машине. Они могут выполнять тяжёлые вычисления или довольно простые в зависимости от наличия подстановок их зависимостей (@pxref{Substitutes}). Некоторые из них требуют много места для работы с образами виртуальной машины.

note: type: Plain text
en: Again in case of test failures, please send @email{bug-guix@@gnu.org} all the details.
ru: Конечно, в случае неудачных тестов, пожалуйста, направьте детали на @email{bug-guix@@gnu.org}.

note: type: cindex
en: daemon
ru: демон

note: type: Plain text
en: Operations such as building a package or running the garbage collector are all performed by a specialized process, the @dfn{build daemon}, on behalf of clients.  Only the daemon may access the store and its associated database.  Thus, any operation that manipulates the store goes through the daemon.  For instance, command-line tools such as @command{guix package} and @command{guix build} communicate with the daemon (@i{via} remote procedure calls) to instruct it what to do.
ru: Такие операции, как сборка пакета или запуск сборщика мусора, выполняются запуском специальных процесса --- @dfn{демона сборки} --- по запросам клиентов. Только демон имеет доступ к складу и его базе данных. Так что операции управления складом выполняются с помощью демона. Например, инструменты командной строки, как @command{guix package} и @command{guix build}, обычно взаимодействуют с демоном @i{через} удалённый вызов процедур (RPC) и сообщают, что необходимо сделать.

note: type: Plain text
en: The following sections explain how to prepare the build daemon's environment.  See also @ref{Substitutes}, for information on how to allow the daemon to download pre-built binaries.
ru: Следующие разделы поясняют как настроить окружение демона сборки. Смотрите также @ref{Substitutes} для подробной инсорации о том, как разрешить демону скачивать собранные бинарники.

note: type: cindex
en: build environment
ru: окружение сборки

note: type: Plain text
en: In a standard multi-user setup, Guix and its daemon---the @command{guix-daemon} program---are installed by the system administrator; @file{/gnu/store} is owned by @code{root} and @command{guix-daemon} runs as @code{root}.  Unprivileged users may use Guix tools to build packages or otherwise access the store, and the daemon will do it on their behalf, ensuring that the store is kept in a consistent state, and allowing built packages to be shared among users.
ru: В случае стандартной многопользовательской установки Guix и его демон (программа @command{guix-daemon}) установливаются системным администратором; @file{/gnu/store} принадлежит @code{root}, и @command{guix-daemon} запущен от @code{root}. Непривилегированные пользователи могут пользоваться инструментами Guix, чтобы собирать пакеты или получить доступ к складу с какой-либо целью, и демон выполнит это по их запросу, убедившись, что склад находится в должном состоянии, и разрешив сборку пакетов и разделение их между пользователями.

note: type: cindex
en: build users
ru: пользователи сборки

note: type: Plain text
en: When @command{guix-daemon} runs as @code{root}, you may not want package build processes themselves to run as @code{root} too, for obvious security reasons.  To avoid that, a special pool of @dfn{build users} should be created for use by build processes started by the daemon.  These build users need not have a shell and a home directory: they will just be used when the daemon drops @code{root} privileges in build processes.  Having several such users allows the daemon to launch distinct build processes under separate UIDs, which guarantees that they do not interfere with each other---an essential feature since builds are regarded as pure functions (@pxref{Introduction}).
ru: Когда @command{guix-daemon} запущен от @code{root}, возможно, из соображений безопасности вы не примете того, что процессы сборки пакетов тоже выполняются от @code{root}. Чтобы избежать этого, необходимо создать специальных @dfn{пользователей для сборки}. Ими будет пользоваться процесс сборки, запускаемый демоном. Эти пользователи сборки не должны иметь оболочки и домашней директории --- они просто будут использоваться, когда демон сбрасывает привилегии @code{root} в процессе сборки. Наличие нескольких таких пользователей позволит демону запускать отдельные процессы сборки  под отдельными UID, что гарантирует, что они не будут помехой друг другу --- важная особенность, учитывая, что сборка рассматривается как чистая функция (@pxref{Introduction}).

note: type: Plain text
en: On a GNU/Linux system, a build user pool may be created like this (using Bash syntax and the @code{shadow} commands):
ru: В системе GNU/Linux набор пользователей для сборки может быть создан так (используя синтаксис команды Bash @code{shadow}):

note: type: example
en: # groupadd --system guixbuild
    # for i in $(seq -w 1 10);
      do
        useradd -g guixbuild -G guixbuild           \
                -d /var/empty -s $(which nologin)   \
                -c "Guix build user $i" --system    \
                guixbuilder$i;
      done
ru: # groupadd --system guixbuild
    # for i in `seq -w 1 10`;
      do
        useradd -g guixbuild -G guixbuild           \
                -d /var/empty -s `which nologin`    \
                -c "Guix build user $i" --system    \
                guixbuilder$i;
      done

note: type: Plain text
en: The number of build users determines how many build jobs may run in parallel, as specified by the @option{--max-jobs} option (@pxref{Invoking guix-daemon, @option{--max-jobs}}).  To use @command{guix system vm} and related commands, you may need to add the build users to the @code{kvm} group so they can access @file{/dev/kvm}, using @code{-G guixbuild,kvm} instead of @code{-G guixbuild} (@pxref{Invoking guix system}).
ru: Число пользователей для сборки определяет, сколько задач сборки может быть запущено параллельно. Это задаётся опцией @option{--max-jobs} (@pxref{Invoking guix-daemon, @option{--max-jobs}}). Чтобы использовать @command{guix system vm} и подобные, вам потребуется добавить пользователей для сборки в группу @code{kvm}, так чтобы они имели доступ к @file{/dev/kvm}, используя @code{-G guixbuild,kvm} вместо @code{-G guixbuild} (@pxref{Invoking guix system}).

note: type: Plain text
en: This way, the daemon starts build processes in a chroot, under one of the @code{guixbuilder} users.  On GNU/Linux, by default, the chroot environment contains nothing but:
ru: Так демон стартует процессы сборки в chroot под одним из пользователей группы @code{guixbuilder}. В GNU/Linux по умолчанию окружение chroot содержит только следующее:

note: type: itemize
en: a minimal @code{/dev} directory, created mostly independently from the host @code{/dev}@footnote{``Mostly'', because while the set of files that appear in the chroot's @code{/dev} is fixed, most of these files can only be created if the host has them.};
ru: минимальный состав директории @code{/dev}, созданной максимально независимо от исходной @code{/dev}@footnote{"Максимально", потому что файлы, доступные в chroot под @code{/dev}, могут быть созданы только, если машина их имеет};

note: type: itemize
en: the @code{/proc} directory; it only shows the processes of the container since a separate PID name space is used;
ru: директория @code{/proc}; она показывает только процессы контейнера, так как используется отдельное пространство имён процессов PID;

note: type: itemize
en: @file{/etc/passwd} with an entry for the current user and an entry for user @file{nobody};
ru: @file{/etc/passwd} с записью о текущем пользователе и пользователе @file{nobody};

note: type: itemize
en: @file{/etc/group} with an entry for the user's group;
ru: @file{/etc/group} с записью о группе пользователя;

note: type: itemize
en: @file{/etc/hosts} with an entry that maps @code{localhost} to @code{127.0.0.1};
ru: @file{/etc/hosts} с записью, которая адресует @code{localhost} на @code{127.0.0.1};

note: type: itemize
en: a writable @file{/tmp} directory.
ru: директория @file{/tmp}, доступная для записи.

note: type: Plain text
en: You can influence the directory where the daemon stores build trees @i{via} the @env{TMPDIR} environment variable.  However, the build tree within the chroot is always called @file{/tmp/guix-build-@var{name}.drv-0}, where @var{name} is the derivation name---e.g., @code{coreutils-8.24}.  This way, the value of @env{TMPDIR} does not leak inside build environments, which avoids discrepancies in cases where build processes capture the name of their build tree.
ru: Можно указать директорию, в которую демон сохраняет деревья сборки @i{через} переменную окружения @code{TMPDIR}. Однако дерево сборки внутри chroot всегда называется @file{/tmp/guix-build-@var{name}.drv-0}, где @var{name} - это имя деривации, то есть, например, @code{coreutils-8.24}. Так значение @code{TMPDIR} не проникает внутрь окружения сборки, что предотвращает расхождения и случаях, когда процессы сборки имеют иные имена их деревьев сборки.

note: type: Plain text
en: The daemon also honors the @env{http_proxy} and @env{https_proxy} environment variables for HTTP and HTTPS downloads it performs, be it for fixed-output derivations (@pxref{Derivations}) or for substitutes (@pxref{Substitutes}).
ru: Демон также уважаем переменную окружения @code{http_proxy}, когда выполняет скачивание по HTTP как для дериваций с фиксированным результатом (@pxref{Derivations}), так и для подстановок (@pxref{Substitutes}).

note: type: Plain text
en: If you are installing Guix as an unprivileged user, it is still possible to run @command{guix-daemon} provided you pass @option{--disable-chroot}.  However, build processes will not be isolated from one another, and not from the rest of the system.  Thus, build processes may interfere with each other, and may access programs, libraries, and other files available on the system---making it much harder to view them as @emph{pure} functions.
ru: Если вы устанавливаете Guix как непривилегированный пользователь, всё ещё возможно запустить @command{guix-daemon} с указанием @code{--disable-chroot}. Однако процессы сборки не будут изолированы один от другого, а также от остальной системы. Так процессы сборки смогут внести помехи в работу друг друга, смогут получить доступ к программам, библиотекам и другим файлам, доступным в системе, что конечно, делает затруднительным рассмотрение сборки как @emph{чистой} функции.

note: type: subsection
en: Using the Offload Facility
ru: Использование функционала разгрузки

note: type: cindex
en: offloading
ru: разгрузка

note: type: cindex
en: build hook
ru: хук сборки

note: type: Plain text
en: When desired, the build daemon can @dfn{offload} derivation builds to other machines running Guix, using the @code{offload} @dfn{build hook}@footnote{This feature is available only when @uref{https://github.com/artyom-poptsov/guile-ssh, Guile-SSH} is present.}.  When that feature is enabled, a list of user-specified build machines is read from @file{/etc/guix/machines.scm}; every time a build is requested, for instance via @code{guix build}, the daemon attempts to offload it to one of the machines that satisfy the constraints of the derivation, in particular its system types---e.g., @code{x86_64-linux}.  A single machine can have multiple system types, either because its architecture natively supports it, via emulation (@pxref{transparent-emulation-qemu, Transparent Emulation with QEMU}), or both.  Missing prerequisites for the build are copied over SSH to the target machine, which then proceeds with the build; upon success the output(s) of the build are copied back to the initial machine.  The offload facility comes with a basic scheduler that attempts to select the best machine.  The best machine is chosen among the available machines based on criteria such as:
ru: При желании демон сборки может @dfn{offload} производные сборки на других машинах, на которых запущен Guix, используя @code{offload} @dfn{build hook}@footnote{Эта функция доступна только когда установлен @uref{https://github.com/artyom-poptsov/guile-ssh, Guile-SSH.}}.  Когда данная функция включена, список указанных пользователем машин для сборки считывается из @file{/etc/guix/machines.scm}; каждый раз, когда запрашивается сборка, например через @code{guix build}, демон пытается выгрузить ее на одну из машин, удовлетворяющих ограничениям производной сборки, в частности, ее системным типам---например, @code{x86_64-linux}.  На одной машине можеь быть несколько типов систем, либо потому, что архитектура изначально поддерживает ее, либо через эмуляцию (@pxref{transparent-emulation-qemu, Transparent Emulation with QEMU}).  Отсутствующие необходимые условия для сборки копируются по SSH на целевой компьютер, который затем продолжает сборку; в случает успеха выходные данные копируются на исходную машину.  Средство разгрузки поставляется с базовым планировщиком, который пытается выбрать лучшую машину. Лучшая машина выбирается среди доступных машин на основании такиз критериев как:

note: type: enumerate
en: The availability of a build slot.  A build machine can have as many build slots (connections) as the value of the @code{parallel-builds} field of its @code{build-machine} object.
ru: Наличие слота для сборки.  Машина для сборки может иметь столько слотов для сборки (соединений), сколько указано в значении @code{parallel-builds} определения объекта @code{build-machine}.

note: type: enumerate
en: Its relative speed, as defined via the @code{speed} field of its @code{build-machine} object.
ru: Ее относительная скорость, указанная через значение @code{speed} определения объекта @code{build-machine}.

note: type: enumerate
en: Its load.  The normalized machine load must be lower than a threshold value, configurable via the @code{overload-threshold} field of its @code{build-machine} object.
ru: Ее нагрузка.  Нормализованная нагрузка на машину должна быть ниже порогового значения, которое можно настроить с помощью поля @code{overload-threshold} объекта @code{build-machine}.

note: type: enumerate
en: Disk space availability.  More than a 100 MiB must be available.
ru: Доступность дискового пространства.  Должно быть доступно более 100 МБ.

note: type: Plain text
en: The @file{/etc/guix/machines.scm} file typically looks like this:
ru: Файл @file{/etc/guix/machines.scm} обычно выглядит так:

note: type: lisp
en: (list (build-machine
            (name "eightysix.example.org")
            (systems (list "x86_64-linux" "i686-linux"))
            (host-key "ssh-ed25519 AAAAC3Nza@dots{}")
            (user "bob")
            (speed 2.))     ;incredibly fast!
ru: (list (build-machine
               (name "eightysix.example.org")
               (systems (list "x86_64-linux" "i686-linux"))
               (host-key "ssh-ed25519 AAAAC3Nza@dots{}")
               (user "bob")
               (speed 2.))     ;incredibly fast!

note: type: Plain text
en: In the example above we specify a list of two build machines, one for the @code{x86_64} and @code{i686} architectures and one for the @code{aarch64} architecture.
ru: В примере выше мы обозначили список, состоящий из двух машин: одна --- для архитектуры @code{x86_64}, а другая --- для архитектуры @code{mips64el}.

note: type: Plain text
en: In fact, this file is---not surprisingly!---a Scheme file that is evaluated when the @code{offload} hook is started.  Its return value must be a list of @code{build-machine} objects.  While this example shows a fixed list of build machines, one could imagine, say, using DNS-SD to return a list of potential build machines discovered in the local network (@pxref{Introduction, Guile-Avahi,, guile-avahi, Using Avahi in Guile Scheme Programs}).  The @code{build-machine} data type is detailed below.
ru: По факту, этот файл, что не удивительно, является файлом Scheme, и он имеет значение, когда запускается @code{хук разгрузки}. Он возвращает объекты класса @code{build-machine}. Приведённый пример показывает фиксированный список машин для сборки, но можно представить, скажем, используя DNS-SD, он может возвращать список потенциальных машин, обнаруженных в локальной сети (@pxref{Introduction, Guile-Avahi,, guile-avahi, Using Avahi in Guile Scheme Programs}). Тип данных @code{build-machine} описан ниже.

note: type: deftp
en: {Data Type} build-machine
ru: {Тип данных} build-machine

note: type: deftp
en: This data type represents build machines to which the daemon may offload builds.  The important fields are:
ru: Этот тип данных представляет машины для сборки, на которые демон может разгружать сборки. Важные поля:

note: type: table
en: The host name of the remote machine.
ru: Имя хоста удалённой машины.

note: type: table
en: The system types the remote machine supports---e.g., @code{(list "x86_64-linux" "i686-linux")}.
ru: Тип системы удалённой машины, то есть @code{x86_64-linux}.

note: type: table
en: The user account to use when connecting to the remote machine over SSH.  Note that the SSH key pair must @emph{not} be passphrase-protected, to allow non-interactive logins.
ru: Аккаунт пользователя, используемый для соединения с удалённой машиной через SSH. Отметим, что ключ-пара SSH @emph{не} должна быть защищена парольной фразой, чтобы разрешить не интерактивные авторизации.

note: type: table
en: This must be the machine's SSH @dfn{public host key} in OpenSSH format.  This is used to authenticate the machine when we connect to it.  It is a long string that looks like this:
ru: Это @dfn{публичный ключ хоста} в формает OpenSSH. Он используется при аутентификации машины, когда мы подсоединяемс к ней. Это длинная строка, которая выглядит примерно так:

note: type: table
en: If the machine is running the OpenSSH daemon, @command{sshd}, the host key can be found in a file such as @file{/etc/ssh/ssh_host_ed25519_key.pub}.
ru: Если на машине запущен демон OpenSSH @command{sshd}, ключ хоста может быть найден в файле под директорией /etc/ssh, например, @file{/etc/ssh/ssh_host_ed25519_key.pub}.

note: type: table
en: If the machine is running the SSH daemon of GNU@tie{}lsh, @command{lshd}, the host key is in @file{/etc/lsh/host-key.pub} or a similar file.  It can be converted to the OpenSSH format using @command{lsh-export-key} (@pxref{Converting keys,,, lsh, LSH Manual}):
ru: Если на машине запущен демон SSH GNU@tie{}lsh, @command{lshd}, тогда ключ хоста расположен в @file{/etc/lsh/host-key.pub} или подобном файле. Его можно конвертировать в формат OpenSSH, используя @command{lsh-export-key} (@pxref{Converting keys,,, lsh, LSH Manual}):

note: type: deftp
en: A number of optional fields may be specified:
ru: Список необязательных полей:

note: type: table
en: Port number of SSH server on the machine.
ru: Номер порта сервера SSH на машине.

note: type: table
en: The SSH private key file to use when connecting to the machine, in OpenSSH format.  This key must not be protected with a passphrase.
ru: Файл приватного ключа в формате OpenSSH, используемого в соединении с машиной. Этот ключ не должен быть защищён парольной фразой.

note: type: table
en: Note that the default value is the private key @emph{of the root account}.  Make sure it exists if you use the default.
ru: Отметим, что значение по умолчанию --- приватный ключ @emph{аккаунта root}. Убедитесь, что он существует, если вы используете настройки по умолчанию.

note: type: table
en: The SSH-level compression methods and compression level requested.
ru: Методы компрессии уровня SSH и уровень компрессии.

note: type: table
en: Note that offloading relies on SSH compression to reduce bandwidth usage when transferring files to and from build machines.
ru: Отметим, что разгрузка зависит от компрессии SSH, что уменьшает использование траффика при передаче файлов на и с машин для сборки.

note: type: table
en: File name of the Unix-domain socket @command{guix-daemon} is listening to on that machine.
ru: Имя файла сокета Unix-домена, который слушает @command{guix-daemon} на удалённой машине.

note: type: table
en: The load threshold above which a potential offload machine is disregarded by the offload scheduler.  The value roughly translates to the total processor usage of the build machine, ranging from 0.0 (0%) to 1.0 (100%).  It can also be disabled by setting @code{overload-threshold} to @code{#f}.
ru: Порог нагрузки, выше которого потенциальная offload машина не учитывается offload планировщиком.  Это значение примерно соответствует общему использованию процессора машиной сборки в диапазоне от 0,0 (0%) до 1,0 (100%).  Это также можно отключить, установив @code{overload-threshold} в @code{#f}.

note: type: table
en: The number of builds that may run in parallel on the machine.
ru: Число сборок, которые могут быть запущены на машине.

note: type: table
en: A ``relative speed factor''.  The offload scheduler will tend to prefer machines with a higher speed factor.
ru: Показатель скорости. Планировщик разгрузки предпримет попытку выбрать машину с наибольшим показателем скорости.

note: type: table
en: A list of strings denoting specific features supported by the machine.  An example is @code{"kvm"} for machines that have the KVM Linux modules and corresponding hardware support.  Derivations can request features by name, and they will be scheduled on matching build machines.
ru: Набор строк, описывающий специфические функции, которые поддерживаются на машине. Например, @code{"kvm"} для машин, которые имеют модули Linux KVM и соответствующую поддерку аппаратного обеспечения. Деривации могут запрашивать функции по имени, и тогда они будут запранированы на соответствующих машинах для сборки.

note: type: Plain text
en: The @command{guix} command must be in the search path on the build machines.  You can check whether this is the case by running:
ru: Команда @command{guix} должна быть в путях для поиска на машинах лоя сборки. Можно проверить это, выполнив:

note: type: Plain text
en: There is one last thing to do once @file{machines.scm} is in place.  As explained above, when offloading, files are transferred back and forth between the machine stores.  For this to work, you first need to generate a key pair on each machine to allow the daemon to export signed archives of files from the store (@pxref{Invoking guix archive}):
ru: Есть ещё одна вещь, которую нужно выполнить после размещения @file{machines.scm}. Выше описано, что при разгрузке файлы передаются вперёд и назад между складами на машинах. Для этого необходимо сгенерировать ключ-пару на кадой машине, чтобы позволить демону экспортировать подписанные архивы файлов из склада (@pxref{Invoking guix archive}):

note: type: Plain text
en: Each build machine must authorize the key of the master machine so that it accepts store items it receives from the master:
ru: Каждая машина для сорки должна авторизовать ключ машины-инициатора, чтобы принимать элементы из склада, которые присылает инициатор:

note: type: Plain text
en: Likewise, the master machine must authorize the key of each build machine.
ru: Точно так же машина-инициатор должна авторизовать ключ каждой машины для сборки.

note: type: Plain text
en: All the fuss with keys is here to express pairwise mutual trust relations between the master and the build machines.  Concretely, when the master receives files from a build machine (and @i{vice versa}), its build daemon can make sure they are genuine, have not been tampered with, and that they are signed by an authorized key.
ru: Всё движение с ключами, описанное здесь, создаёт надёжную двустороннюю свзь между инициатором и машинами для сборки. А именно, когда машина-инициатор принимает файлы из машины для сборки (или @i{наборот}), её демон может удостоверить их подлинность и невмешательство других, а также то, что они подписаны авторизованным ключом.

note: type: cindex
en: offload test
ru: тест разгрузки

note: type: Plain text
en: To test whether your setup is operational, run this command on the master node:
ru: Чтобы проверить работоспособность настроек, запустите следующую команду на инициирующем узле:

note: type: Plain text
en: This will attempt to connect to each of the build machines specified in @file{/etc/guix/machines.scm}, make sure Guix is available on each machine, attempt to export to the machine and import from it, and report any error in the process.
ru: Это выполнит попытку соединиться с каждой из машин для сборки, обозначенных в @file{/etc/guix/machines.scm}, проверит наличие модулей Guile и Guix на каждой машине, а также сделает попытку экспортировать и импортировать, а затем выведет отчёт об этом процессе.

note: type: Plain text
en: If you want to test a different machine file, just specify it on the command line:
ru: Если нужно тестировать другой файл с описанием машин, просто приведите его в командной строке:

note: type: Plain text
en: Last, you can test the subset of the machines whose name matches a regular expression like this:
ru: И последнее, можно тестировать набор машин, чьи имена соответствуют регулярному выражению, например:

note: type: cindex
en: offload status
ru: статус разгрузки

note: type: Plain text
en: To display the current load of all build hosts, run this command on the main node:
ru: Чтобы отобразить текущую загрузку всех машин для сборки, запустите команду на инициирущем узле:

note: type: cindex
en: SELinux, daemon policy
ru: SELinux, политика демона

note: type: cindex
en: mandatory access control, SELinux
ru: мандатный контроль доступа, SELinux

note: type: cindex
en: security, guix-daemon
ru: безопасность, guix-daemon

note: type: Plain text
en: Guix includes an SELinux policy file at @file{etc/guix-daemon.cil} that can be installed on a system where SELinux is enabled, in order to label Guix files and to specify the expected behavior of the daemon.  Since Guix System does not provide an SELinux base policy, the daemon policy cannot be used on Guix System.
ru: Guix включает файл политик SELinnux @file{etc/guix-daemon.cil}, который может устанавливаться в систему, в которой включен SELinux, тогда файлы Guix будут помечены и настроены для соответствующего поведения демона. Так как система Guix не предоставляет политику SELinux, политика демона не может использоваться в системе Guix.

note: type: subsubsection
en: Installing the SELinux policy
ru: Установка политики SELinux

note: type: cindex
en: SELinux, policy installation
ru: SELinux, установка политики

note: type: Plain text
en: To install the policy run this command as root:
ru: Чтобы установить политику, запустите следующую команду от root:

note: type: Plain text
en: Then relabel the file system with @code{restorecon} or by a different mechanism provided by your system.
ru: Затем измените метку файловой системы с @code{restorecon} или другим механизмом, поставляемым вашей системой.

note: type: Plain text
en: Once the policy is installed, the file system has been relabeled, and the daemon has been restarted, it should be running in the @code{guix_daemon_t} context.  You can confirm this with the following command:
ru: Когда политика установлена, изменена метка файловой системы и демон перезапущен, она должна работать в контексте @code{guix_daemon_t}. Можно проверить это следующей командой:

note: type: Plain text
en: Monitor the SELinux log files as you run a command like @code{guix build hello} to convince yourself that SELinux permits all necessary operations.
ru: Наблюдайте файлы логов SELinux во время работы команды @code{guix build hello}, чтобы удостовериться, что SELinux позволяет выполнение необходимых операций.

note: type: cindex
en: SELinux, limitations
ru: SELinux, ограничения

note: type: Plain text
en: This policy is not perfect.  Here is a list of limitations or quirks that should be considered when deploying the provided SELinux policy for the Guix daemon.
ru: Эта политика не совершенна. Тут есть ряд ограничений или причуд, который нужно учитывать при разворачивании политики SELinux для демона Guix.

note: type: enumerate
en: @code{guix_daemon_socket_t} isn’t actually used.  None of the socket operations involve contexts that have anything to do with @code{guix_daemon_socket_t}.  It doesn’t hurt to have this unused label, but it would be preferable to define socket rules for only this label.
ru: @code{guix_daemon_socket_t} на самом деле не используется. Никакие операции с сокетом не выполняются. Ничего плохого в том, чтобы иметь эту неиспользуемую метку, но желательно определить правила сокета для этой метки.

note: type: enumerate
en: @code{guix gc} cannot access arbitrary links to profiles.  By design, the file label of the destination of a symlink is independent of the file label of the link itself.  Although all profiles under $localstatedir are labelled, the links to these profiles inherit the label of the directory they are in.  For links in the user’s home directory this will be @code{user_home_t}.  But for links from the root user’s home directory, or @file{/tmp}, or the HTTP server’s working directory, etc, this won’t work.  @code{guix gc} would be prevented from reading and following these links.
ru: @code{guix gc} не может получить доступ к обычным ссылкам профилей. По задумке метка файла назначения символической ссылки не зависит от метки файла самой ссылки. Хотя все профили под $localstatedir помечены, ссылки на эти профили не наследуют метку директории, в которой они находятся. Для ссылок на домашние директории пользователей это будет @code{user_home_t}. Но для ссылок из домашней директории root, а также @file{/tmp} или рабочей директории HTTP-сервера и т.п., это не работает.  @code{guix gc} не будет допускаться к чтению и следованию по этим ссылкам.

note: type: enumerate
en: The daemon’s feature to listen for TCP connections might no longer work.  This might require extra rules, because SELinux treats network sockets differently from files.
ru: Функция демона прослушивать соединения TCP может более не работать. Это может потребовать дополнительных правил, потому что SELinux относится к сетевым сокетам иначе, чем к файлам.

note: type: enumerate
en: Currently all files with a name matching the regular expression @code{/gnu/store/.+-(guix-.+|profile)/bin/guix-daemon} are assigned the label @code{guix_daemon_exec_t}; this means that @emph{any} file with that name in any profile would be permitted to run in the @code{guix_daemon_t} domain.  This is not ideal.  An attacker could build a package that provides this executable and convince a user to install and run it, which lifts it into the @code{guix_daemon_t} domain.  At that point SELinux could not prevent it from accessing files that are allowed for processes in that domain.
ru: В настоящее время всем файлам с именами, соответствующими регулярному выражению @code{/gnu/store/.+-(guix-.+|profile)/bin/guix-daemon}, присвоена метка @code{guix_daemon_exec_t}; это означает, что @emph{любому} файлу с таким именем в любом профиле разрешён запуск в домене @code{guix_daemon_t}. Это не идеально. Атакующий может собрать пакет, который содержит исполняемый файл и убеить пользователя установить и запустить его, и таким образом он получит доступ к домену @code{guix_daemon_t}. В этой связи SELinux мог бы не давать ему доступ к файлам, которые разрешены для процессов в этом домене.

note: type: enumerate
en: You will need to relabel the store directory after all upgrades to @file{guix-daemon}, such as after running @code{guix pull}.  Assuming the store is in @file{/gnu}, you can do this with @code{restorecon -vR /gnu}, or by other means provided by your operating system.
ru: Вам нужно будет изменить метку (label) каталога хранилища после всех обновлений до @file{guix-daemon}, например, после запуска @code{guix pull}.  Предполагая, что хранилище в @file{/gnu}, вы можете это сделать с @code{restorecon -vR /gnu}, или другими способами, предусмотренными вашей операционной системой.

note: type: enumerate
en: We could generate a much more restrictive policy at installation time, so that only the @emph{exact} file name of the currently installed @code{guix-daemon} executable would be labelled with @code{guix_daemon_exec_t}, instead of using a broad regular expression.  The downside is that root would have to install or upgrade the policy at installation time whenever the Guix package that provides the effectively running @code{guix-daemon} executable is upgraded.
ru: Мы можем создать политику с большими ограничениями во время установки, так чтобы только @emph{точное} имя исполняемого файла установленного в данный момент @code{guix-daemon} было помечено меткой @code{guix_daemon_exec_t} вместо того, чтобы использовать регулярное выражение, выбирающее большой ряд файлов. Проблемой в данном случае будет то, что root потребуется устанавливать или обновлять политику во время любой установки в случае, если обновлён исполняемый файл @code{guix-daemon}.

note: type: section
en: Invoking @command{guix-daemon}
ru: Вызов @command{guix-daemon}

note: type: Plain text
en: The @command{guix-daemon} program implements all the functionality to access the store.  This includes launching build processes, running the garbage collector, querying the availability of a build result, etc.  It is normally run as @code{root} like this:
ru: Программа @command{guix-daemon} реализует весь функционал доступа к складу. Это включает запуск процессов сборки, запуск сборщика мусора, проверка доступности результата сборки и т.д. Он должен быть запущен от @code{root} так:

note: type: Plain text
en: For details on how to set it up, @pxref{Setting Up the Daemon}.
ru: Для подробностей о том, как настроить его, смотрите @pxref{Setting Up the Daemon}.

note: type: cindex
en: container, build environment
ru: контейнер, окружение сборки

note: type: cindex
en: reproducible builds
ru: воспроизводимые сборки

note: type: Plain text
en: By default, @command{guix-daemon} launches build processes under different UIDs, taken from the build group specified with @option{--build-users-group}.  In addition, each build process is run in a chroot environment that only contains the subset of the store that the build process depends on, as specified by its derivation (@pxref{Programming Interface, derivation}), plus a set of specific system directories.  By default, the latter contains @file{/dev} and @file{/dev/pts}.  Furthermore, on GNU/Linux, the build environment is a @dfn{container}: in addition to having its own file system tree, it has a separate mount name space, its own PID name space, network name space, etc.  This helps achieve reproducible builds (@pxref{Features}).
ru: По умолчанию @command{guix-daemon} запускает процессы сборки под различными UID, от пользователей из группы, обозначенной в @code{--build-users-group}. В дополнение каждый процесс сборки запускается в окружении chroot, которое содержит только набор элементов склада, от которых зависит процесс сборки, как это обозначено в деривации (@pxref{Programming Interface, derivation}), а также набор специфичных системных директорий. По умолчанию последнее включает @file{/dev} и @file{/dev/pts}. Более того, под GNU/Linux окружение сборки --- это @dfn{контейнер}: в дополнение к тому, что он имеет собственное дерево файловой системы, он также имеет отдельное пространство имён монтирования, своё собственное пространство имён процессов PID, пространство сетевых имён и т.д. Это позволяет получить воспроизводимые сборки (@pxref{Features}).

note: type: Plain text
en: When the daemon performs a build on behalf of the user, it creates a build directory under @file{/tmp} or under the directory specified by its @env{TMPDIR} environment variable.  This directory is shared with the container for the duration of the build, though within the container, the build tree is always called @file{/tmp/guix-build-@var{name}.drv-0}.
ru: Когда демон выполняет сборку по запросу пользователя, он создаёт директорию под @file{/tmp} или под директорией, заданной его переменной окружения @code{TMPDIR}. Эта директория разделяется с контейнером на время сборки, хотя внутри контейнера дерево сборки всегда называется @file{/tmp/guix-build-@var{name}.drv-0}.

note: type: Plain text
en: The build directory is automatically deleted upon completion, unless the build failed and the client specified @option{--keep-failed} (@pxref{Common Build Options, @option{--keep-failed}}).
ru: Директория сборки автоматически удаляется по завершении, если конечно, сборка не завершилась с ошибкой, и клиент не обозначил @option{--keep-failed} (@pxref{Invoking guix build, @option{--keep-failed}}).

note: type: Plain text
en: The daemon listens for connections and spawns one sub-process for each session started by a client (one of the @command{guix} sub-commands).  The @command{guix processes} command allows you to get an overview of the activity on your system by viewing each of the active sessions and clients.  @xref{Invoking guix processes}, for more information.
ru: Демон слушает соединения и порождает один под-процесс для каждой сессии, запускаемой клиентом (одну из подкоманд @command{guix}). Команда @command{guix processes} позволяет мониторить активность вашей системы, предоставляя обзор каждой активной сессии и клиентов. Смотрите @xref{Invoking guix processes} для подробной информации.

note: type: Plain text
en: The following command-line options are supported:
ru: Поддерживаются следующие опции командной строки:

note: type: table
en: Take users from @var{group} to run build processes (@pxref{Setting Up the Daemon, build users}).
ru: Использовать пользователей из группы @var{group} для запуска процессов сборки (@pxref{Setting Up the Daemon, build users}).

note: type: cindex
en: substitutes
ru: подстановки

note: type: table
en: Do not use substitutes for build products.  That is, always build things locally instead of allowing downloads of pre-built binaries (@pxref{Substitutes}).
ru: Не использовать подстановки для сборок. Это означает --- собирать элементы локально вместо того, чтобы скачивать собранные бинарники (@pxref{Substitutes}).

note: type: table
en: When the daemon runs with @option{--no-substitutes}, clients can still explicitly enable substitution @i{via} the @code{set-build-options} remote procedure call (@pxref{The Store}).
ru: Когда демон работает с @code{--no-substitutes}, клиенты всё ещё могут явно включить подстановку @i{с помощью} удалённого вызова процедур @code{set-build-options} (@pxref{The Store}).

note: type: table
en: Consider @var{urls} the default whitespace-separated list of substitute source URLs.  When this option is omitted, @indicateurl{@value{SUBSTITUTE-URLS}} is used.
ru: Использовать адреса @var{urls}, разделённые пробелом по умолчанию, как список источников подстановок.  Когда эта опция пропущена, используется @indicateurl{@value{SUBSTITUTE-URLS}}.

note: type: table
en: This means that substitutes may be downloaded from @var{urls}, as long as they are signed by a trusted signature (@pxref{Substitutes}).
ru: Это означает, что подстановки могут скачиваться из адресов @var{urls}, если конечно они подписаны доверенной подписью (@pxref{Substitutes}).

note: type: table
en: @xref{Getting Substitutes from Other Servers}, for more information on how to configure the daemon to get substitutes from other servers.
ru: @xref{Getting Substitutes from Other Servers}, для получения дополнительной информации о том, как настроить демон для получения заменителей с других серверов.

note: type: table
en: Do not use offload builds to other machines (@pxref{Daemon Offload Setup}).  That is, always build things locally instead of offloading builds to remote machines.
ru: Не использовать подстановки для сборок. Это означает --- собирать элементы локально вместо того, чтобы скачивать собранные бинарники (@pxref{Substitutes}).

note: type: table
en: Cache build failures.  By default, only successful builds are cached.
ru: Кешировать ошибки сборки. По умолчанию кешируются только успешные сборки.

note: type: table
en: When this option is used, @command{guix gc --list-failures} can be used to query the set of store items marked as failed; @command{guix gc --clear-failures} removes store items from the set of cached failures.  @xref{Invoking guix gc}.
ru: При установке этой опции можно использовать @command{guix gc --list-failures}, чтобы просматривать элементы склада, помеченные как ошибочные; @command{guix gc --clear-failures} удаляет элементы склада из кеша ошибок.  @xref{Invoking guix gc}.

note: type: table
en: Use @var{n} CPU cores to build each derivation; @code{0} means as many as available.
ru: Использовать @var{n} ядер процессора для сборки каждой деривации; @code{0} означает использовать все доступные.

note: type: table
en: The default value is @code{0}, but it may be overridden by clients, such as the @option{--cores} option of @command{guix build} (@pxref{Invoking guix build}).
ru: Значение по умолчанию - @code{0}, но оно может быть изменено клиентами, в частности, опцией @code{--cores} команды @command{guix build} (@pxref{Invoking guix build}).

note: type: table
en: The effect is to define the @env{NIX_BUILD_CORES} environment variable in the build process, which can then use it to exploit internal parallelism---for instance, by running @code{make -j$NIX_BUILD_CORES}.
ru: В результате устанавливается переменная окружения @code{NIX_BUILD_CORES} для процесса сборки, который затем может использовать её для применения внутреннего параллелизма, например, для запуска @code{make -j$NIX_BUILD_CORES}.

note: type: table
en: Allow at most @var{n} build jobs in parallel.  The default value is @code{1}.  Setting it to @code{0} means that no builds will be performed locally; instead, the daemon will offload builds (@pxref{Daemon Offload Setup}), or simply fail.
ru: Разрешить максимум @var{n} параллельных задач сборки. Значение по умолчанию - @code{1}. Установка в @code{0} означает, чтоб сборки не будут выполняться локально, вместо этого, демон будет разгружать сборки (@pxref{Daemon Offload Setup}) или просто отчитается об ошибке.

note: type: table
en: When the build or substitution process remains silent for more than @var{seconds}, terminate it and report a build failure.
ru: Когда процесс сборки или подстановки молчит более @var{seconds} секунд, завершить его и отчитаться об ошибке сборки.

note: type: table
en: The default value is @code{0}, which disables the timeout.
ru: Значение по умолчанию - @code{0}, что значит отключить таймаут.

note: type: table
en: The value specified here can be overridden by clients (@pxref{Common Build Options, @option{--max-silent-time}}).
ru: Значение, заданное здесь, может быть переопределено клиентами (@pxref{Common Build Options, @code{--max-silent-time}}).

note: type: table
en: Likewise, when the build or substitution process lasts for more than @var{seconds}, terminate it and report a build failure.
ru: Точно так же, когда процесс сборки или подстановки длится более @var{seconds}, завершить его и отчитаться об ошибке сборки.

note: type: table
en: The value specified here can be overridden by clients (@pxref{Common Build Options, @option{--timeout}}).
ru: Значение, заданное здесь, может быть переопределено клиентами (@pxref{Common Build Options, @code{--timeout}}).

note: type: table
en: Build each derivation @var{n} times in a row, and raise an error if consecutive build results are not bit-for-bit identical.  Note that this setting can be overridden by clients such as @command{guix build} (@pxref{Invoking guix build}).
ru: Собирать каждую деривацию @var{n} раз подряд и вызывать ошибку, если результаты последовательных сборок не идентичны бит-к-биту. Отметим, что эта настройка может быть переопределена клиентами в команде, например, @command{guix build} (@pxref{Invoking guix build}).

note: type: table
en: When used in conjunction with @option{--keep-failed}, the differing output is kept in the store, under @file{/gnu/store/@dots{}-check}.  This makes it easy to look for differences between the two results.
ru: При использовании вместе с @option{--keep-failed} различные результаты сохраняются на складе под @file{/gnu/store/@dots{}-check}. Это делает возможным просмотр различий между двумя результатами.

note: type: table
en: Produce debugging output.
ru: Выводить отладочную информацию.

note: type: table
en: This is useful to debug daemon start-up issues, but then it may be overridden by clients, for example the @option{--verbosity} option of @command{guix build} (@pxref{Invoking guix build}).
ru: Это полезно для отладки проблем запуска демона, но затем это может быть переопределено клиентами, например, опцией @option{--verbosity} команды @command{guix build} (@pxref{Invoking guix build}).

note: type: table
en: Add @var{dir} to the build chroot.
ru: Добавить директорию @var{dir} в chroot сборки.

note: type: table
en: Doing this may change the result of build processes---for instance if they use optional dependencies found in @var{dir} when it is available, and not otherwise.  For that reason, it is not recommended to do so.  Instead, make sure that each derivation declares all the inputs that it needs.
ru: Это может изменить результаты процессов сборки, например, если они используют необязательные (опциональные) зависимости, найденные в  @var{dir}, если они доступны, но только так, а не иначе. Поэтому не рекомендуется делать так. Вместо этого, убедитесь, что каждая деривация объявляет все необходимые входные данные.

note: type: table
en: Disable chroot builds.
ru: Отключить chroot для сборки.

note: type: table
en: Using this option is not recommended since, again, it would allow build processes to gain access to undeclared dependencies.  It is necessary, though, when @command{guix-daemon} is running under an unprivileged user account.
ru: Использование этой опции не рекомендуется, так как опять же это позволит процессам сборки получить доступ к не объявленным зависимостям. Это важно, даже если @command{guix-daemon} запущен под аккаунтом непривилегированного пользователя.

note: type: table
en: Compress build logs according to @var{type}, one of @code{gzip}, @code{bzip2}, or @code{none}.
ru: Архивировать логи сборки методом @var{type}. Это один из: @code{gzip}, @code{bzip2} или @code{none}.

note: type: table
en: Whether to discover substitute servers on the local network using mDNS and DNS-SD.
ru: Следует ли обнаруживать сервера с заменителями в локальной сети с помощью mDNS and DNS-SD.

note: type: table
en: This feature is still experimental.  However, here are a few considerations.
ru: Эта функция все еще экспериментальная.  Однако есть несколько соображений.

note: type: enumerate
en: It might be faster/less expensive than fetching from remote servers;
ru: Это может быть быстрее/дешевле, чем загрузка (fetching) с удаленных серверов;

note: type: enumerate
en: There are no security risks, only genuine substitutes will be used (@pxref{Substitute Authentication});
ru: Никаких угроз безопасности, будут использоваться только подлинные заменители (@pxref{Substitute Authentication});

note: type: enumerate
en: An attacker advertising @command{guix publish} on your LAN cannot serve you malicious binaries, but they can learn what software you’re installing;
ru: Объявление злоумышленника @command{guix publish} в вашей локальной сети не могут предоставить вам вредоносные двоичные файлы, но они могут узнать, какое программное обеспечение вы устанавливаете;

note: type: enumerate
en: Servers may serve substitute over HTTP, unencrypted, so anyone on the LAN can see what software you’re installing.
ru: Серверы могут предоставить заменители через HTTP в незашифрованном виде, поэтому любой в локальной сети может видеть, какое программное обеспечение вы устанавливаете.

note: type: table
en: It is also possible to enable or disable substitute server discovery at run-time by running:
ru: Также можно включить или отключить обнаружение сервера с заменителями во время выполнения, запустив:

note: type: cindex
en: deduplication
ru: дедупликация

note: type: table
en: Disable automatic file ``deduplication'' in the store.
ru: Отключить автоматическую "дедупликацию" файлов на складе.

note: type: table
en: By default, files added to the store are automatically ``deduplicated'': if a newly added file is identical to another one found in the store, the daemon makes the new file a hard link to the other file.  This can noticeably reduce disk usage, at the expense of slightly increased input/output load at the end of a build process.  This option disables this optimization.
ru: По умолчанию файлы, добавленные на склад, автоматически "дедуплицируются": если вновь добавленный файл идентичен другому, найденному на складе, демон делает новый файл жесткой ссылкой на другой файл. Это существенно сокращает использование места на диске за счёт небольшого увеличения запросов ввода/вывода в конце процесса сборки. Эта опция отключает такую оптимизацию.

note: type: table
en: Tell whether the garbage collector (GC) must keep outputs of live derivations.
ru: Сообщить, должен ли сборщик мусора (GC) сохранять выходные данные живой деривации.

note: type: cindex
en: GC roots
ru: Корни сборщика мусора

note: type: cindex
en: garbage collector roots
ru: корни сборщика мусора

note: type: table
en: When set to @code{yes}, the GC will keep the outputs of any live derivation available in the store---the @file{.drv} files.  The default is @code{no}, meaning that derivation outputs are kept only if they are reachable from a GC root.  @xref{Invoking guix gc}, for more on GC roots.
ru: При установке в "yes" (да), сборщик мусора (GC) будет сохранять результаты любой живой деривации, доступной на складе, --- файлы @code{.drv}. Значение по умолчанию - "no" (нет) - означает, что результаты дериваций хранятся только, если они доступны из корней сборщика мусора (GC roots). Смотрите @xref{Invoking guix gc} для информации о корнях сборщика мусора.

note: type: table
en: Tell whether the garbage collector (GC) must keep derivations corresponding to live outputs.
ru: Сообщить, должен ли сборщик мусора (GC) сохранять деривации, соответствующие живым результатам.

note: type: table
en: When set to @code{yes}, as is the case by default, the GC keeps derivations---i.e., @file{.drv} files---as long as at least one of their outputs is live.  This allows users to keep track of the origins of items in their store.  Setting it to @code{no} saves a bit of disk space.
ru: При указании "yes" (да), что является значением по умолчанию, сборщик мусора сохраняет деривации, то есть файлы @code{.drv}, до тех пор, пока любой из их выходов остаётся живым. Это позволяет пользователям отслеживать исходники элементов на складе. Установка в "no" (нет) немного экономит место на диске.

note: type: table
en: In this way, setting @option{--gc-keep-derivations} to @code{yes} causes liveness to flow from outputs to derivations, and setting @option{--gc-keep-outputs} to @code{yes} causes liveness to flow from derivations to outputs.  When both are set to @code{yes}, the effect is to keep all the build prerequisites (the sources, compiler, libraries, and other build-time tools) of live objects in the store, regardless of whether these prerequisites are reachable from a GC root.  This is convenient for developers since it saves rebuilds or downloads.
ru: Таким образом, установка @code{--gc-keep-derivations} в "yes" (да) даётт возможность пройти от результатов до дериваций, а установка  @code{--gc-keep-outputs} в "yes" (да), делает возможным пройти от дериваций до результатов. Если оба установлены в "yes", тогда это сохранит всё используемое для сборки (исходники, компилятор, библиотеки и другие инструменты сборки) живых объектов на складе, без учёта, доступны эти инструменты сборки из корней сборщика мусора или нет. Это удобно для разработчиков, так как это сокращает пересборки или скачивания.

note: type: table
en: On Linux-based systems, impersonate Linux 2.6.  This means that the kernel's @command{uname} system call will report 2.6 as the release number.
ru: На системах, основанных на Linux, выдавать себя за Linux 2.6. Это означает, что системный вызов ядра @code{uname} будет выдавать 2.6 номером релиза.

note: type: table
en: This might be helpful to build programs that (usually wrongfully) depend on the kernel version number.
ru: Это полезно для сборки программ, которые (обычно по ошибке) зависят от версии ядра.

note: type: table
en: Do not keep build logs.  By default they are kept under @file{@var{localstatedir}/guix/log}.
ru: Не сохранять логи сборки. По умолчанию они сохраняются под @code{@var{localstatedir}/guix/log}.

note: type: table
en: Assume @var{system} as the current system type.  By default it is the architecture/kernel pair found at configure time, such as @code{x86_64-linux}.
ru: Считать @var{system} текущим типом системы. По умолчанию это пара архитектура/ядро, обнаруженная во время конфигурации, например, @code{x86_64-linux}.

note: type: table
en: Listen for connections on @var{endpoint}.  @var{endpoint} is interpreted as the file name of a Unix-domain socket if it starts with @code{/} (slash sign).  Otherwise, @var{endpoint} is interpreted as a host name or host name and port to listen to.  Here are a few examples:
ru: Слушать соединения с @var{endpoint}. @var{endpoint} интерпретируется как имя файла сокета Unix-домена, если начинается с @code{/} (знак слеша). В противном случае @var{endpoint} интерпретируется как имя хоста или им хоста и порт для прослушивания. Вот несколько примеров:

note: type: table
en: Listen for connections on the @file{/gnu/var/daemon} Unix-domain socket, creating it if needed.
ru: Слушать соединения с сокетом Unix-домена @file{/gnu/var/daemon}, который создаётся при необходимости.

note: type: cindex
en: daemon, remote access
ru: демон, удалённый доступ

note: type: cindex
en: remote access to the daemon
ru: удалённый доступ к демону

note: type: cindex
en: daemon, cluster setup
ru: демон, установка кластера

note: type: cindex
en: clusters, daemon setup
ru: кластеры, установка демона

note: type: table
en: Listen for TCP connections on the network interface corresponding to @code{localhost}, on port 44146.
ru: Слушать соединения TCP сетевого интерфейса, относящиеся к @code{localhost}, на порту 44146.

note: type: table
en: Listen for TCP connections on the network interface corresponding to @code{128.0.0.42}, on port 1234.
ru: Слушать соединения TCP сетевого интерфейса, относящиеся к @code{128.0.0.42}, на порту 1234.

note: type: table
en: This option can be repeated multiple times, in which case @command{guix-daemon} accepts connections on all the specified endpoints.  Users can tell client commands what endpoint to connect to by setting the @env{GUIX_DAEMON_SOCKET} environment variable (@pxref{The Store, @env{GUIX_DAEMON_SOCKET}}).
ru: Эта опция может повторяться много раз, в таком случае @command{guix-daemon} принимает соединения на всех обозначенных точках. Пользователи могут через клиентские команды сообщать, через какие точки соединяться, для этого нужно устанавливать переменную окружения @code{GUIX_DAEMON_SOCKET} (@pxref{The Store, @code{GUIX_DAEMON_SOCKET}}).

note: type: quotation
en: The daemon protocol is @emph{unauthenticated and unencrypted}.  Using @option{--listen=@var{host}} is suitable on local networks, such as clusters, where only trusted nodes may connect to the build daemon.  In other cases where remote access to the daemon is needed, we recommend using Unix-domain sockets along with SSH.
ru: Протокол демона @emph{неаутентичный и нешифрованный}. Использование @code{--listen=@var{host}} подходит локальным сетям, как например, кластерам, где только доверенные узлы могут соединяться с демоном сборки. В других случаях, когда необходим удалённый доступ к демону рекомендуется использовать сокеты Unix-домена вместе с SSH.

note: type: table
en: When @option{--listen} is omitted, @command{guix-daemon} listens for connections on the Unix-domain socket located at @file{@var{localstatedir}/guix/daemon-socket/socket}.
ru: Когда @code{--listen} пропущена, @command{guix-daemon} слушает соединения с сокетом Unix-домена, расположенным в @file{@var{localstatedir}/guix/daemon-socket/socket}.

note: type: Plain text
en: When using Guix on top of GNU/Linux distribution other than Guix System---a so-called @dfn{foreign distro}---a few additional steps are needed to get everything in place.  Here are some of them.
ru: При использовании дистрибутива GNU/Linux, отличного от системы, называемого также @dfn{чужой дистрибутив}, необходимо несколько дополнительных шагов, чтобы всё работало. Вот некоторые из них.

note: type: cindex
en: locales, when not on Guix System
ru: локали, если не на системе Guix

note: type: Plain text
en: Packages installed @i{via} Guix will not use the locale data of the host system.  Instead, you must first install one of the locale packages available with Guix and then define the @env{GUIX_LOCPATH} environment variable:
ru: Пакеты, установленные @i{с помощью} Guix, не будут использовать данные локали хост-системы. Вместо этого вы должны вначале установить один из пакетов локали, доступных в Guix, а затем определить переменную окружения @code{GUIX_LOCPATH}:

note: type: Plain text
en: The @env{GUIX_LOCPATH} variable plays a role similar to @env{LOCPATH} (@pxref{Locale Names, @env{LOCPATH},, libc, The GNU C Library Reference Manual}).  There are two important differences though:
ru: Переменная @env{GUIX_LOCPATH} играет ту же роль, что и @env{LOCPATH} (@pxref{Locale Names, @env{LOCPATH},, libc, The GNU C Library Reference Manual}). Но есть два существенных различия:

note: type: enumerate
en: @env{GUIX_LOCPATH} is honored only by the libc in Guix, and not by the libc provided by foreign distros.  Thus, using @env{GUIX_LOCPATH} allows you to make sure the programs of the foreign distro will not end up loading incompatible locale data.
ru: @code{GUIX_LOCPATH} учитывается только libc в Guix, но не учитывается libc, предоставляемым чужим дистрибутивом. Так что использование @code{GUIX_LOCPATH} позволяет вам убедиться, что программы чужого дистрибутива не будут производить загрузку несовместимых данных локали.

note: type: enumerate
en: libc suffixes each entry of @env{GUIX_LOCPATH} with @code{/X.Y}, where @code{X.Y} is the libc version---e.g., @code{2.22}.  This means that, should your Guix profile contain a mixture of programs linked against different libc version, each libc version will only try to load locale data in the right format.
ru: libc добавляет суффиксы @code{/X.Y} к каждому компоненту @code{GUIX_LOCPATH}, где @code{X.Y} - это версия libc, например, @code{2.22}. Это значит, что если ваш профиль Guix будет содержать смесь программ, связанных с дугой версией libc, каждая версия libc будет пытаться загружать только данные локали в правильном формате.

note: type: Plain text
en: This is important because the locale data format used by different libc versions may be incompatible.
ru: Это важно, потому что использование данных локали другой версией libc может быть неприемлемо.

note: type: cindex
en: name service switch, glibc
ru: выбор имён сервисов, glibc

note: type: cindex
en: NSS (name service switch), glibc
ru: NSS (выбор имён сервисов), glibc

note: type: cindex
en: nscd (name service caching daemon)
ru: nscd (демон кеша имён сервисов)

note: type: cindex
en: name service caching daemon (nscd)
ru: демон кеша имён сервисов (nscd)

note: type: Plain text
en: When using Guix on a foreign distro, we @emph{strongly recommend} that the system run the GNU C library's @dfn{name service cache daemon}, @command{nscd}, which should be listening on the @file{/var/run/nscd/socket} socket.  Failing to do that, applications installed with Guix may fail to look up host names or user accounts, or may even crash.  The next paragraphs explain why.
ru: При использовании Guix на чужом дистрибутиве мы @emph{настойчиво рекомендуем}, чтобы система запускала @dfn{демон кеша имён сервисов} библиотеки GNU C, @command{nscd}, который должен слушать сокет @file{/var/run/nscd/socket}. Если это не сделано, приложения, установленные Guix, могут некорректно адресовать имена хостов или аккаунты пользователей и даже падать. Ниже объясняется почему.

note: type: Plain text
en: The GNU C library implements a @dfn{name service switch} (NSS), which is an extensible mechanism for ``name lookups'' in general: host name resolution, user accounts, and more (@pxref{Name Service Switch,,, libc, The GNU C Library Reference Manual}).
ru: Библиотека GNU C реализует @dfn{выбор имён сервисов} (NSS), который представляет собой расширяемый механизм для резолвинга имён в целом: резолвинг имён хостов, аккаунтов пользователей и другое (@pxref{Name Service Switch,,, libc, The GNU C Library Reference Manual}).

note: type: cindex
en: Network information service (NIS)
ru: Сервис сетевой информации (NIS)

note: type: cindex
en: NIS (Network information service)
ru: NIS (сервис сетевой информации)

note: type: Plain text
en: Being extensible, the NSS supports @dfn{plugins}, which provide new name lookup implementations: for example, the @code{nss-mdns} plugin allow resolution of @code{.local} host names, the @code{nis} plugin allows user account lookup using the Network information service (NIS), and so on.  These extra ``lookup services'' are configured system-wide in @file{/etc/nsswitch.conf}, and all the programs running on the system honor those settings (@pxref{NSS Configuration File,,, libc, The GNU C Reference Manual}).
ru: Будучи расширяемым, NSS поддерживает @dfn{плагины}, которые предоставляют реализации разрешения новых имён: плагин @code{nss-mdns} резолвит имена хостов @code{.local}, плагин @code{nis} адресует пользовательские аккаунты, используя сервис сетевой информации (NIS) и т.д. Эти дополнительные сервисы адресации настраиваются для всей системы в @file{/etc/nsswitch.conf}, и все запущенные в системе программы учитывают эти настройки (@pxref{NSS Configuration File,,, libc, The GNU C Reference Manual}).

note: type: Plain text
en: When they perform a name lookup---for instance by calling the @code{getaddrinfo} function in C---applications first try to connect to the nscd; on success, nscd performs name lookups on their behalf.  If the nscd is not running, then they perform the name lookup by themselves, by loading the name lookup services into their own address space and running it.  These name lookup services---the @file{libnss_*.so} files---are @code{dlopen}'d, but they may come from the host system's C library, rather than from the C library the application is linked against (the C library coming from Guix).
ru: Когда выполняется разрешение имён, например, вызовом функции C @code{getaddrinfo}, приложения вначале делают попытку соединиться с nscd; в случае успеха nscd выполняет разрешение имён по их запросу. Если nscd не запущен, тогда они выполняют разрешение имён самостоятельно, загружая сервисы разрешения имён в их собственные адресные пространства и запуская их. Эти сервисы разрешения имён --- файлы @file{libnss_*.so} --- запускаются @code{dlopen}, но они могут поставляться системной библиотекой C, а не библиотекой C, с которой залинковано приложение (библиотека C из Guix).

note: type: Plain text
en: And this is where the problem is: if your application is linked against Guix's C library (say, glibc 2.24) and tries to load NSS plugins from another C library (say, @code{libnss_mdns.so} for glibc 2.22), it will likely crash or have its name lookups fail unexpectedly.
ru: Вот где кроется проблема --- если ваше приложение залинковано с библиотекой C Guix (скажем, glibc 2.24) и пытается загрузить плагины NSS из другой библиотеки C (скажем, @code{libnss_mdns.so} для glibc 2.22), это вероятно вызовет падение или резолвинг имени завершится с ошибкой.

note: type: Plain text
en: Running @command{nscd} on the system, among other advantages, eliminates this binary incompatibility problem because those @code{libnss_*.so} files are loaded in the @command{nscd} process, not in applications themselves.
ru: Запуск @command{nscd} в системе, помимо преимуществ, также исключает эту проблему несовместимости программ, потому что файлы @code{libnss_*.so} загружены в процессе @command{nscd}, а не в самом приложении.

note: type: subsection
en: X11 Fonts
ru: Шрифты X11

note: type: cindex
en: font cache
ru: кеш шрифтов

note: type: Plain text
en: Once you have installed or removed fonts, or when you notice an application that does not find fonts, you may need to install Fontconfig and to force an update of its font cache by running:
ru: После того, как вы установили или удалили шрифты, или когда вы заметили приложение, которое не находит шрифты, вам может потребоваться установить Fontconfig и принудительно обновить кэш шрифтов, выполнив:

note: type: Plain text
en: To display text written in Chinese languages, Japanese, or Korean in graphical applications, consider installing @code{font-adobe-source-han-sans} or @code{font-wqy-zenhei}.  The former has multiple outputs, one per language family (@pxref{Packages with Multiple Outputs}).  For instance, the following command installs fonts for Chinese languages:
ru: Для отображения в графических приложениях текста на китайском, японском, корейском нужно установить @code{font-adobe-source-han-sans} или @code{font-wqy-zenhei}. Первый имеет множественный выход, один для языковой семьи (@pxref{Packages with Multiple Outputs}). Например, следующая команда устанавливает шрифты для китайских языков:

note: type: Plain text
en: Older programs such as @command{xterm} do not use Fontconfig and instead rely on server-side font rendering.  Such programs require to specify a full name of a font using XLFD (X Logical Font Description), like this:
ru: Старые программы, например, @command{xterm}, не используют Fontconfig, а вместо этого вызывают рендеринг шрифтов на стороне сервера. Таким программам необходимо указывать полное имя шрифта, используя XLFD (X Logical Font Description), примерно так:

note: type: Plain text
en: To be able to use such full names for the TrueType fonts installed in your Guix profile, you need to extend the font path of the X server:
ru: Чтобы иметь возможность использовать такие полные имена для шрифтов TrueType, установленных в вашем профиле Guix, вам нужно расширить пути шрифтов X-сервера:

note: type: Plain text
en: After that, you can run @code{xlsfonts} (from @code{xlsfonts} package)  to make sure your TrueType fonts are listed there.
ru: После этого можно запустить @code{xlsfonts} (из пакета @code{xlsfonts}), чтобы убедиться, что ваши шрифты TrueType находятся там.

note: type: Plain text
en: The @code{nss-certs} package provides X.509 certificates, which allow programs to authenticate Web servers accessed over HTTPS.
ru: Пакет @code{nss-certs} предоставялет сертификаты X.509, которые позволяют программам аутентифицировать веб-серверы и работать через HTTPS.

note: type: Plain text
en: When using Guix on a foreign distro, you can install this package and define the relevant environment variables so that packages know where to look for certificates.  @xref{X.509 Certificates}, for detailed information.
ru: При использовании Guix на чужом дистрибутиве можно установить этот пакет и определить соответствующие переменные окружения, чтобы пакеты знали, где искать сертификаты. Смотрите @xref{X.509 Certificates} для подробной информации.

note: type: Plain text
en: When you install Emacs packages with Guix, the Elisp files are placed under the @file{share/emacs/site-lisp/} directory of the profile in which they are installed.  The Elisp libraries are made available to Emacs through the @env{EMACSLOADPATH} environment variable, which is set when installing Emacs itself.
ru: Когда вы устанавливаете пакеты Emacs с Guix, файлы пакетов помещаются в каталог @file{share/emacs/site-lisp/} того профиля, в котором они установлены. Библиотеки Elisp доступны для Emacs через переменную среды @code{EMACSLOADPATH}, которая устанавливается при установке самого Emacs.

note: type: Plain text
en: Additionally, autoload definitions are automatically evaluated at the initialization of Emacs, by the Guix-specific @code{guix-emacs-autoload-packages} procedure.  If, for some reason, you want to avoid auto-loading the Emacs packages installed with Guix, you can do so by running Emacs with the @option{--no-site-file} option (@pxref{Init File,,, emacs, The GNU Emacs Manual}).
ru: По умолчанию Emacs (установленный Guix) "знает", куда размещаются эти пакеты, так что вам не нужно выполнять конфигурацию. Если по каким-либо причинам вы хотите отменить автозагрузку пакетов Emacs, установленных с помощью Guix, вы можете это сделать, запустив Emacs с опцией @code{--no-site-file} (@pxref{Init File,,, emacs, The GNU Emacs Manual}).

note: type: cindex
en: Upgrading Guix, on a foreign distro
ru: Обновление Guix на ином дистрибутиве

note: type: Plain text
en: To upgrade Guix, run:
ru: Чтобы обновить Guix, запустите:

note: type: Plain text
en: @xref{Invoking guix pull}, for more information.
ru: @xref{Invoking guix pull} для дополнительной информации.

note: type: cindex
en: upgrading Guix for the root user, on a foreign distro
ru: обновление Guix для пользователя root на ином дистрибутиве

note: type: cindex
en: upgrading the Guix daemon, on a foreign distro
ru: обновление Guix демона на ином дистрибутиве

note: type: cindex
en: @command{guix pull} for the root user, on a foreign distro
ru: @command{guix pull} для пользователя root, на ином дистрибутиве

note: type: Plain text
en: On a foreign distro, you can upgrade the build daemon by running:
ru: В ином дистрибутиве вы можете обновить демон сборки, запустив:

note: type: Plain text
en: followed by (assuming your distro uses the systemd service management tool):
ru: затем (при условии, что ваш дистрибутив использует инструмент управления сервисами systemd):

note: type: Plain text
en: On Guix System, upgrading the daemon is achieved by reconfiguring the system (@pxref{Invoking guix system, @code{guix system reconfigure}}).
ru: В системе Guix обновление демона достигается путем перенастройки системы (@pxref{Invoking guix system, @code{guix system reconfigure}}).

note: type: cindex
en: installing Guix System
ru: установка системы Guix

note: type: cindex
en: Guix System, installation
ru: Система Guix, установка

note: type: Plain text
en: This section explains how to install Guix System on a machine.  Guix, as a package manager, can also be installed on top of a running GNU/Linux system, @pxref{Installation}.
ru: Этот раздел объясняет, как установить систему Guix на компьютер. Guix, как пакетный менеджер, можно также установить на уже установленную систему GNU/Linux (@pxref{Installation}).

note: type: quotation
en: You are reading this documentation with an Info reader.  For details on how to use it, hit the @key{RET} key (``return'' or ``enter'') on the link that follows: @pxref{Top, Info reader,, info-stnd, Stand-alone GNU Info}.  Hit @kbd{l} afterwards to come back here.
ru: Вы читаете этот документ с помощью info-просмотрщика. Чтобы узнать, как им пользоваться, нажмите кнопку @key{Ввод} (enter) по ссылке: @pxref{Top, Info reader,, info-stnd, Stand-alone GNU Info}. Нажмите @kbd{1} после этого, чтобы вернуться.

note: type: quotation
en: Alternatively, run @command{info info} in another tty to keep the manual available.
ru: Или запустите @command{info info} в другом tty, чтобы оставить руководство доступным.

note: type: Plain text
en: 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.
ru: Мы полагаем, система Guix будет широко применяться для офисных и серверных решений. Гарантия надёжности основана на транзакционных обновлениях, откатах и воспроизводимости. Это наше прочное основание.

note: type: Plain text
en: Nevertheless, before you proceed with the installation, be aware of the following noteworthy limitations applicable to version @value{VERSION}:
ru: Тем не менее, перед началом установки, ознакомьтесь с важной информацией об ограничениях версии @value{VERSION}:

note: type: itemize
en: More and more system services are provided (@pxref{Services}), but some may be missing.
ru: Мы постоянно добавляем новые сервисы (@pxref{Services}), но некоторые могут отсутствовать.

note: type: itemize
en: GNOME, Xfce, LXDE, and Enlightenment are available (@pxref{Desktop Services}), as well as a number of X11 window managers.  However, KDE is currently missing.
ru: Доступные GNOME, Xfce, LXDE и Enlightenment (@pxref{Desktop Services}), а также ряд оконных менеджеров X11. Однако, KDE в настоящее время отсутствует.

note: type: Plain text
en: More than a disclaimer, this is an invitation to report issues (and success stories!), and to join us in improving it.  @xref{Contributing}, for more info.
ru: Мы настойчиво призываем вас присылать отчёты о проблемах (или историиуспеха!). Присоединяйтесь к нам, если вы хотите улучшить Guix. Смотрите @xref{Contributing}, чтобы узнать больше.

note: type: cindex
en: hardware support on Guix System
ru: поддержка аппаратного обеспечения в системе Guix

note: type: Plain text
en: GNU@tie{}Guix focuses on respecting the user's computing freedom.  It builds around the kernel Linux-libre, which means that only hardware for which free software drivers and firmware exist is supported.  Nowadays, a wide range of off-the-shelf hardware is supported on GNU/Linux-libre---from keyboards to graphics cards to scanners and Ethernet controllers.  Unfortunately, there are still areas where hardware vendors deny users control over their own computing, and such hardware is not supported on Guix System.
ru: GNU@tie{}Guix особенно заботится об уважении свободы пользователя при работе за компьютером. Она построена на ядре Linux-libre, что означает, что поддерживается только аппаратное обеспечение, которое имеет свободные драйверы и прошивки. Сегодня широкий список наличествующей аппаратуры поддерживается GNU/Linux-libre --- от клавиатур и графических карт до сканеров и контроллеров Ethernet. К сожалению, всё ещё остаётся ряд производителей железа, которые запрещают пользователям управлять их устройствами, и такое аппаратное обеспечение не поддерживается системой Guix.

note: type: cindex
en: WiFi, hardware support
ru: WiFi, поддержка аппаратного обеспечения

note: type: Plain text
en: 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{operating-system Reference, @code{firmware}}).
ru: Основной областью, в которой отсутствуют свободные драйверы и прошивки, являются устройства Wi-Fi. Работают устройства Wi-Fi, которые используют платы Atheros (AR9271 и AR7010) и взаимодействуют с драйвером Linux-libre @code{ath9k}, также использующие платы Broadcom/AirForce (BCM43xx with Wireless-Core Revision 5), которые работают с драйвером Linux-libre @code{b43-open}. Свободная прошивка существует для обоих и доступна в системе Guix из коробки как часть @var{%base-firmware} (@pxref{operating-system Reference, @code{firmware}}).

note: type: cindex
en: RYF, Respects Your Freedom
ru: уважение вашей свободы (RYF)

note: type: Plain text
en: The @uref{https://www.fsf.org/, Free Software Foundation} runs @uref{https://www.fsf.org/ryf, @dfn{Respects Your Freedom}} (RYF), a certification program for hardware products that respect your freedom and your privacy and ensure that you have control over your device.  We encourage you to check the list of RYF-certified devices.
ru: @uref{https://www.fsf.org/, Фонд свободного программного обспечения FSF} ведёт @uref{https://www.fsf.org/ryf, @dfn{Уважение вашей свободы}} (RYF) --- программу сертификации аппаратного обеспечения, которое уважает вашу свободу и вашу безопасность и утверждает, что вы имеете контроль над вашими устройствами. Мы побуждаем вас проверить список устройств, сертифицированных RYF.

note: type: Plain text
en: Another useful resource is the @uref{https://www.h-node.org/, H-Node} web site.  It contains a catalog of hardware devices with information about their support in GNU/Linux.
ru: Другой полезный ресурс --- сайт @uref{https://www.h-node.org/, H-Node}. Он содержит каталог устройств с информацией об их поддержке в GNU/Linux.

note: type: Plain text
en: An ISO-9660 installation image that can be written to a USB stick or burnt to a DVD can be downloaded from @indicateurl{@value{BASE-URL}/guix-system-install-@value{VERSION}.x86_64-linux.iso}, where you can replace @code{x86_64-linux} with one of:
ru: Установочный образ ISO-9660 может быть записан на USB-флеш или DVD, скачать его можно по адресу: @indicateurl{https://alpha.gnu.org/gnu/guix/guix-system-install-@value{VERSION}.@var{system}.iso}, где @var{system} одна из следующих:

note: type: table
en: for a GNU/Linux system on Intel/AMD-compatible 64-bit CPUs;
ru: для системы GNU/Linux на 64-битных Intel/AMD-совместимых процессорах;

note: type: table
en: for a 32-bit GNU/Linux system on Intel-compatible CPUs.
ru: для системы GNU/Linux на 32-битных Intel-совместимых процессорах.

note: type: Plain text
en: Make sure to download the associated @file{.sig} file and to verify the authenticity of the image against it, along these lines:
ru: Обязательно скачайте связанный файл подписи @file{.sig} и проверьте аутентичность образа так:

note: type: Plain text
en: This image contains the tools necessary for an installation.  It is meant to be copied @emph{as is} to a large-enough USB stick or DVD.
ru: Этот образ содержит инструменты, необходимые для установки. Он должен копироваться @emph{как есть} на большую USB-флеш или DVD.

note: type: unnumberedsubsec
en: Copying to a USB Stick
ru: Запись на USB-флеш

note: type: Plain text
en: Insert a USB stick of 1@tie{}GiB or more into your machine, and determine its device name.  Assuming that the USB stick is known as @file{/dev/sdX}, copy the image with:
ru: Вставьте в компьютер USB-флеш объёмом 1@tie{}Гб или более и определите его имя. Учитывая имя (обычно соответствующее @file{/dev/sdX}) скопируйте образ на него:

note: type: Plain text
en: Access to @file{/dev/sdX} usually requires root privileges.
ru: Доступ к @file{/dev/sdX} обычно требует привилегий root.

note: type: unnumberedsubsec
en: Burning on a DVD
ru: Запись на DVD

note: type: Plain text
en: Insert a blank DVD into your machine, and determine its device name.  Assuming that the DVD drive is known as @file{/dev/srX}, copy the image with:
ru: Вставьте чистый DVD в компьютер и определите имя устройства. Обычно DVD определяется как @file{/dev/srX}, скопируйте образ так:

note: type: Plain text
en: Access to @file{/dev/srX} usually requires root privileges.
ru: Доступ к @file{/dev/srX} обычно требует привилегий root.

note: type: unnumberedsubsec
en: Booting
ru: Загрузка

note: type: Plain text
en: Once this is done, you should be able to reboot the system and boot from the USB stick or DVD@.  The latter usually requires you to get in the BIOS or UEFI boot menu, where you can choose to boot from the USB stick.  In order to boot from Libreboot, switch to the command mode by pressing the @kbd{c} key and type @command{search_grub usb}.
ru: Когда это сделано, вы должны перезагрузить систему и загрузиться с USB-флеш или DVD. Последнее обычно требует доступа к меню BIOS или UEFI, где можно выбрать загрузку с USB-флеш.

note: type: Plain text
en: @xref{Installing Guix in a VM}, if, instead, you would like to install Guix System in a virtual machine (VM).
ru: Смотрите @xref{Installing Guix in a VM}, если вы хотите установить систему Guix на виртуальную машину (VM).

note: type: Plain text
en: Once you have booted, you can use the guided graphical installer, which makes it easy to get started (@pxref{Guided Graphical Installation}).  Alternatively, if you are already familiar with GNU/Linux and if you want more control than what the graphical installer provides, you can choose the ``manual'' installation process (@pxref{Manual Installation}).
ru: Когда вы загрузитесь, вы можете использовать графическую установку, которая намного проще для начала (@pxref{Guided Graphical Installation}). Или если вы уже знакомы с GNU/Linux или вы хотите больший контроль, чем это предоставляет графическая установка, вы можете выбрать ручной процесс установки (@pxref{Manual Installation}).

note: type: Plain text
en: The graphical installer is available on TTY1.  You can obtain root shells on TTYs 3 to 6 by hitting @kbd{ctrl-alt-f3}, @kbd{ctrl-alt-f4}, etc.  TTY2 shows this documentation and you can reach it with @kbd{ctrl-alt-f2}.  Documentation is browsable using the Info reader commands (@pxref{Top,,, info-stnd, Stand-alone GNU Info}).  The installation system runs the GPM mouse daemon, which allows you to select text with the left mouse button and to paste it with the middle button.
ru: Графическа установка доступна в TTY1. Вы можете запустить оболочку root в TTY 3-6, нажимая @kbd{ctrl-alt-f3}, @kbd{ctrl-alt-f4} и т.д.  TTY2 отображает эту документацию, открыть его можно клавишами @kbd{ctrl-alt-f2}. Листать документацию можно командами просмотрщика Info (@pxref{Top,,, info-stnd, Stand-alone GNU Info}). Установка системы запускает демона мыши GPM, который позволяет вам выделять текст лековй кнопкой мыши и вставлять средней кнопкой.

note: type: quotation
en: Installation requires access to the Internet so that any missing dependencies of your system configuration can be downloaded.  See the ``Networking'' section below.
ru: Установка требует доступа к Интернету, чтобы скачивать любые отсутствующие зависимости в вашей конфигурации системы. Смотрите раздел "Сеть" ниже.

note: type: Plain text
en: The graphical installer is a text-based user interface.  It will guide you, with dialog boxes, through the steps needed to install GNU@tie{}Guix System.
ru: Графический установщик представляет собой текстовый интерфейс. Он взаимодействует через диалоговые блоки, проходя шаги установки системы GNU@tie{}Guix.

note: type: Plain text
en: The first dialog boxes allow you to set up the system as you use it during the installation: you can choose the language, keyboard layout, and set up networking, which will be used during the installation.  The image below shows the networking dialog.
ru: Первый диалоговый блок позволяет вам установить систему в таком виде, как во время установки. Вы можете выбрать язык, раскладку клавиатуры, задать настройки сети для установки. На картинке ниже --- диалог настройки сети.

note: type: Plain text
en: Later steps allow you to partition your hard disk, as shown in the image below, to choose whether or not to use encrypted file systems, to enter the host name and root password, and to create an additional account, among other things.
ru: Следующие шаги позволят вам разметить диск, как это показано на картинке ниже. Также можно выбрать шифрование вайловой системы (или без шифрования), ввести имя хоста и пароль root, создать дополнительную учётную запись и другие действия.

note: type: Plain text
en: Note that, at any time, the installer allows you to exit the current installation step and resume at a previous step, as show in the image below.
ru: Отметим, что в любое время установщик позволяет вам отменить текущий шаг и вернуться к предыдущему шагу установки, как это показано на картинке ниже.

note: type: Plain text
en: Once you're done, the installer produces an operating system configuration and displays it (@pxref{Using the Configuration System}).  At that point you can hit ``OK'' and installation will proceed.  On success, you can reboot into the new system and enjoy.  @xref{After System Installation}, for what's next!
ru: Когда настройки выполнены, установщик сгенерирует конфигурацию операционной системы и отобразит её (@pxref{Using the Configuration System}).  На этом этапе нажатие ``OK'' запустит установку.  После успешнго завершения нужно перезагрузиться и использовать новую систему.  Смотрите @xref{After System Installation}, чтобы узнать ещё больше!

note: type: Plain text
en: This section describes how you would ``manually'' install GNU@tie{}Guix System on your machine.  This option requires familiarity with GNU/Linux, with the shell, and with common administration tools.  If you think this is not for you, consider using the guided graphical installer (@pxref{Guided Graphical Installation}).
ru: Этот раздел описывает, как можно вручную установить систему GNU@tie{}Guix на вашу машину. Это потребует знаний GNU/Linux, оболочки и инструментов администрирования. Если вы считаете, это не для вас, используйте вариант графической установки (@pxref{Guided Graphical Installation}).

note: type: subsection
en: Keyboard Layout, Networking, and Partitioning
ru: Раскладка клавиатуры, Сеть, Разметка диска

note: type: Plain text
en: Before you can install the system, you may want to adjust the keyboard layout, set up networking, and partition your target hard disk.  This section will guide you through this.
ru: Перед установкой системы вам может понадобиться смена раскладки клавиатуры, а также настройка сети и разметка целевого жёсткого диска. В этом разделе приведены соответствующие инструкции.

note: type: cindex
en: keyboard layout
ru: раскладка клавиатуры

note: type: Plain text
en: The installation image uses the US qwerty keyboard layout.  If you want to change it, you can use the @command{loadkeys} command.  For example, the following command selects the Dvorak keyboard layout:
ru: Установочный образ использует раскладку клавиатуры US qwerty. Если нужно поменять её, можно пользоваться командой @command{loadkeys}. Например, следующая команда выбирает раскладку клавиатуры Dvorak:

note: type: Plain text
en: See the files under @file{/run/current-system/profile/share/keymaps} for a list of available keyboard layouts.  Run @command{man loadkeys} for more information.
ru: Смотрите файлы в @file{/run/current-system/profile/share/keymaps}, чтобы найти список доступных раскладок. Запустите @command{man loadkeys}, чтобы узнать больше.

note: type: subsubsection
en: Networking
ru: Сеть

note: type: Plain text
en: Run the following command to see what your network interfaces are called:
ru: Запустите следующую команду, чтобы узнать имена сетевых интерфейсов:

note: type: table
en: @dots{} or, using the GNU/Linux-specific @command{ip} command:
ru: @dots{} или используйте специальную команду GNU/Linux @command{ip}:

note: type: Plain text
en: Wired interfaces have a name starting with @samp{e}; for example, the interface corresponding to the first on-board Ethernet controller is called @samp{eno1}.  Wireless interfaces have a name starting with @samp{w}, like @samp{w1p2s0}.
ru: Проводные интерфейсы называются на букву @samp{e}; например, интерфейс, соответствующий первому контроллеру Ethernet на материнской плате, называется @samp{eno1}. Беспроводные интерфейсы имеют имена, начинающиеся с @samp{w}, как @samp{w1p2s0}.

note: type: item
en: Wired connection
ru: Проводное соединение

note: type: table
en: To configure a wired network run the following command, substituting @var{interface} with the name of the wired interface you want to use.
ru: Чтобы настроить проводную сеть, запустите следующую команду, заменив @var{interface} именем проводного интерфейса, который вы хотите использовать.

note: type: example
en: ip link set @var{interface} up
ru: ifconfig @var{interface} up

note: type: item
en: Wireless connection
ru: Беспроводное соединение

note: type: cindex
en: wireless
ru: беспроводной

note: type: table
en: To configure wireless networking, you can create a configuration file for the @command{wpa_supplicant} configuration tool (its location is not important) using one of the available text editors such as @command{nano}:
ru: Чтобы настроить беспроводную сеть, можно создать конфигурционный файл для @command{wpa_supplicant} (расположение файла неважно). Можно пользоваться любым доступным текстовым редактором, например, @command{nano}:

note: type: table
en: As an example, the following stanza can go to this file and will work for many wireless networks, provided you give the actual SSID and passphrase for the network you are connecting to:
ru: Следующий пример настроек подойдёт для большинства беспроводных сетей. Нужно предоставить фактический SSID и парольную фразу для сети, к которой вы подключаетесь:

note: type: table
en: Start the wireless service and run it in the background with the following command (substitute @var{interface} with the name of the network interface you want to use):
ru: Запустите сервис беспроводной сети в фоновом режиме следующей командой (замените @var{interface} именем сетевого интерфейса, который вы используете):

note: type: table
en: Run @command{man wpa_supplicant} for more information.
ru: Запустите @command{man wpa_supplicant}, чтобы узнать больше.

note: type: Plain text
en: At this point, you need to acquire an IP address.  On a network where IP addresses are automatically assigned @i{via} DHCP, you can run:
ru: Теперь нужно получить IP-адрес. В случае сети, где IP-адреса автоматически распределяются @i{с помощью} DHCP, можно запустить:

note: type: Plain text
en: Try to ping a server to see if networking is up and running:
ru: Попробуйте пинговать сервер, чтобы узнать, работает ли сеть:

note: type: Plain text
en: Setting up network access is almost always a requirement because the image does not contain all the software and tools that may be needed.
ru: Настройка доступа к сети необходима почти всегда, потому что ораз может не иметь программное обеспечение и инструменты, которые могут понадобиться.

note: type: cindex
en: proxy, during system installation
ru: Система Guix, установка

note: type: Plain text
en: If you need HTTP and HTTPS access to go through a proxy, run the following command:
ru: Если вам нужено настроить доступ HTTP и HTTPS прокси, выполните следующую команду:

note: type: Plain text
en: where @var{URL} is the proxy URL, for example @code{http://example.org:8118}.
ru: где @var{URL} адрес прокси, например @code{http://example.org:8118}.

note: type: cindex
en: installing over SSH
ru: установка через SSH

note: type: Plain text
en: If you want to, you can continue the installation remotely by starting an SSH server:
ru: Если желаете, вы можете продолжить установку удалённо, запустив SSH-сервер:

note: type: Plain text
en: Make sure to either set a password with @command{passwd}, or configure OpenSSH public key authentication before logging in.
ru: Не забудьте задать пароль командой @command{passwd} или настроить публичный ключ OpenSSH для аутентификации, чтобы иметь возможность подключиться.

note: type: subsubsection
en: Disk Partitioning
ru: Разметка диска

note: type: Plain text
en: Unless this has already been done, the next step is to partition, and then format the target partition(s).
ru: Если это ещё не сделано, тогда нужно разделить диск, а затем отформатировать целевой(-ые) раздел(ы).

note: type: Plain text
en: The installation image includes several partitioning tools, including Parted (@pxref{Overview,,, parted, GNU Parted User Manual}), @command{fdisk}, and @command{cfdisk}.  Run it and set up your disk with the partition layout you want:
ru: Установочный образ содержит несколько инструментов для разметки, включая Parted (@pxref{Overview,,, parted, GNU Parted User Manual}), @command{fdisk} и @command{cfdisk}. Запустите и настройте ваш диск, используя план разметки, который нужен:

note: type: Plain text
en: If your disk uses the GUID Partition Table (GPT) format and you plan to install BIOS-based GRUB (which is the default), make sure a BIOS Boot Partition is available (@pxref{BIOS installation,,, grub, GNU GRUB manual}).
ru: Если ваш диск использует формат GUID Partition Table (GPT), и вы планируете использовать GRUB, работающий с BIOS (что по умолчанию), убедитесь, что раздел BIOS Boot Partition доступен (@pxref{BIOS installation,,, grub, GNU GRUB manual}).

note: type: cindex
en: EFI, installation
ru: EFI, установка

note: type: cindex
en: UEFI, installation
ru: UEFI, установка

note: type: cindex
en: ESP, EFI system partition
ru: ESP, EFI разметка системы

note: type: Plain text
en: If you instead wish to use EFI-based GRUB, a FAT32 @dfn{EFI System Partition} (ESP) is required.  This partition can be mounted at @file{/boot/efi} for instance and must have the @code{esp} flag set.  E.g., for @command{parted}:
ru: Если вместо этого вы хотите использовать GRUB, работающий с EFI, тогда необходима @dfn{разметка система EFI} FAT32 (ESP). Такая разметка может, например, монтироваться в @file{/boot/efi} и должна иметь флаг @code{esp}. То есть в случае @command{parted}:

note: type: quotation
en: Unsure whether to use EFI- or BIOS-based GRUB? If the directory @file{/sys/firmware/efi} exists in the installation image, then you should probably perform an EFI installation, using @code{grub-efi-bootloader}.  Otherwise you should use the BIOS-based GRUB, known as @code{grub-bootloader}.  @xref{Bootloader Configuration}, for more info on bootloaders.
ru: Не уверенны, что выбрать: GRUB, взаимодействующий с EFI или BIOS? Если существует директория @file{/sys/firmware/efi} в установочом образе, тогда вам следует использовать установку EFI и @code{grub-efi-bootloader}. В противном случае нужно использовать GRUB, работающий с BIOS, называемый @code{grub-bootloader}. Смотрите @xref{Bootloader Configuration} для большей информации о загрузчиках.

note: type: Plain text
en: Once you are done partitioning the target hard disk drive, you have to create a file system on the relevant partition(s)@footnote{Currently Guix System only supports ext4, btrfs, JFS, F2FS, and XFS file systems.  In particular, code that reads file system UUIDs and labels only works for these file system types.}.  For the ESP, if you have one and assuming it is @file{/dev/sda1}, run:
ru: Когда разметка целевого диска выполнена, нужно создать файловую систему на соответствующем(-их) разделе(-ах)@footnote{В данный момент система Guix поддерживает только файловые системы ext4, btrfs, JFS, F2FS и XFS. По факту, код, читающий UUID и метки файлвых систем, работает только для этих типов файловых систем.}. В случае ESP, если у вас раздел @file{/dev/sda1}, выполните:

note: type: Plain text
en: For the root file system, ext4 is the most widely used format.  Other file systems, such as Btrfs, support compression, which is reported to nicely complement file deduplication that the daemon performs independently of the file system (@pxref{Invoking guix-daemon, deduplication}).
ru: Для корневой файловой системы наиболее широко используется формат ext4.  Другие файловые системы, такие как Btrfs, поддерживают сжатие, которое, как известно, прекрасно дополняет дедупликацию файлов, которую демон выполняет независимо от файловой системы (@pxref{Invoking guix-daemon, deduplication}).

note: type: Plain text
en: Preferably, assign file systems a label so that you can easily and reliably refer to them in @code{file-system} declarations (@pxref{File Systems}).  This is typically done using the @code{-L} option of @command{mkfs.ext4} and related commands.  So, assuming the target root partition lives at @file{/dev/sda2}, a file system with the label @code{my-root} can be created with:
ru: Желательно добавить метки файловых систем, чтобы вы могли ссылаться на них по именам в объявлениях @code{file-system} (@pxref{File Systems}). Обычно это можно сделать опцией @code{-L} в @command{mkfs.ext4}, например. Допустим, раздел root располагается в @file{/dev/sda2}, можно добавить метку @code{my-root} следующим образом:

note: type: cindex
en: encrypted disk
ru: шифрованный диск

note: type: quotation
en: Warning
ru: Внимание

note: type: Plain text
en: Once that is done, mount the target file system under @file{/mnt} with a command like (again, assuming @code{my-root} is the label of the root file system):
ru: Когда это сделано, монтируйте целевую файловую систему под @file{/mnt} следующей командой (опять же полагая, что метка раздела root --- @code{my-root}):

note: type: Plain text
en: Also mount any other file systems you would like to use on the target system relative to this path.  If you have opted for @file{/boot/efi} as an EFI mount point for example, mount it at @file{/mnt/boot/efi} now so it is found by @code{guix system init} afterwards.
ru: Также монтируйте любые другие файловые системы внутрь целевой файловой системы. Если например, выбрана точка монтирования EFI @file{/boot/efi}, монтируйте её в @file{/mnt/boot/efi}, так, чтобы она обнаруживалась после запуска @code{guix system init}.

note: type: Plain text
en: Alternatively, you may use a swap file.  For example, assuming that in the new system you want to use the file @file{/swapfile} as a swap file, you would run@footnote{This example will work for many types of file systems (e.g., ext4).  However, for copy-on-write file systems (e.g., btrfs), the required steps may be different.  For details, see the manual pages for @command{mkswap} and @command{swapon}.}:
ru: Возможно, вместо этого вы используете swap-файл. Например, предположим, вы хотите использовать в новой системе swap-файл в @file{/swapfile}, тогда нужно выполнить@footnote{Этот пример работает для многих типов файловых систем, например, ext4. Однако для файловых систем, использующих механизм копирование при записи (copy-on-write), например, btrfs, необходимы другие шаги. Подробнее смотрите в мануалах для @command{mkswap} и @command{swapon}.}:

note: type: Plain text
en: Note that if you have encrypted the root partition and created a swap file in its file system as described above, then the encryption also protects the swap file, just like any other file in that file system.
ru: Заметим, что если вы шифруете раздел root и создаёте swap-файл в его файловой системе, как это описано выше, шифрование также будет защищать swap-файл, как и любой другой файл в этой файловой системе.

note: type: Plain text
en: With the target partitions ready and the target root mounted on @file{/mnt}, we're ready to go.  First, run:
ru: Когда целевые разделы готовы и раздел root монтирован под @file{/mnt}, всё готово для старта. Сначала запустите:

note: type: Plain text
en: This makes @file{/gnu/store} copy-on-write, such that packages added to it during the installation phase are written to the target disk on @file{/mnt} rather than kept in memory.  This is necessary because the first phase of the @command{guix system init} command (see below) entails downloads or builds to @file{/gnu/store} which, initially, is an in-memory file system.
ru: Это сделает @file{/gnu/store} копируемым при записи (copy-on-write), что заставит систему записывать пакеты, добавляемые в систему на этапе установки, на целевой диск под @file{/mnt}, а не держать их в памяти. Это важно, потому что по команде @command{guix system init} (смотрите ниже) будут скачиваться или собираться пакеты в @file{/gnu/store}, которая изначально находится в файловой системе, загрузженной в память.

note: type: Plain text
en: @xref{Using the Configuration System}, for an overview of the configuration file.  The example configurations discussed in that section are available under @file{/etc/configuration} in the installation image.  Thus, to get started with a system configuration providing a graphical display server (a ``desktop'' system), you can run something along these lines:
ru: Смотрите @xref{Using the Configuration System} для подробностей о конфигурационном файле. Конфигурационный файл для примера доступен под @file{/etc/configuration} установочного образа. Например, чтобы получить систему с графическим сервером (т.е. десктопную систему), можно это сделать примерно так:

note: type: Plain text
en: You should pay attention to what your configuration file contains, and in particular:
ru: Нужно уделить внимание содержимому конфигурационного файла, в частности:

note: type: itemize
en: Be sure that your file system labels match the value of their respective @code{device} fields in your @code{file-system} configuration, assuming your @code{file-system} configuration uses the @code{file-system-label} procedure in its @code{device} field.
ru: Убедитесь, чтобы в полях @code{device} были указаны метки ваших файловых систем внутри конфигурации @code{file-system}, если конечно, конфигурация @code{file-system} использует процедуру @code{file-system-label} в поле @code{device}.

note: type: itemize
en: If there are encrypted or RAID partitions, make sure to add a @code{mapped-devices} field to describe them (@pxref{Mapped Devices}).
ru: При наличии шифрованных разделов RAID, обязательно добавьте поле @code{mapped-devices}, чтобы описать их (@pxref{Mapped Devices}).

note: type: Plain text
en: Once you are done preparing the configuration file, the new system must be initialized (remember that the target root file system is mounted under @file{/mnt}):
ru: Когда вы подготовили конфигурационный файл, нужно инициализировать новую систему (помните, что целевой раздел root монтирован под @file{/mnt}):

note: type: Plain text
en: This copies all the necessary files and installs GRUB on @file{/dev/sdX}, unless you pass the @option{--no-bootloader} option.  For more information, @pxref{Invoking guix system}.  This command may trigger downloads or builds of missing packages, which can take some time.
ru: Это копирует все нужные файлы и устанавливает GRUB в @file{/dev/sdX}, если конечно, вы не задали опцию @option{--no-bootloader}. Подробнее - @pxref{Invoking guix system}. Эта команда может вызывать скачивание или сборку отсутствующих пакетов, что может занять время.

note: type: Plain text
en: Once that command has completed---and hopefully succeeded!---you can run @command{reboot} and boot into the new system.  The @code{root} password in the new system is initially empty; other users' passwords need to be initialized by running the @command{passwd} command as @code{root}, unless your configuration specifies otherwise (@pxref{user-account-password, user account passwords}).  @xref{After System Installation}, for what's next!
ru: Когда эта команда завершена, надеемся, успешно, можно запустить @command{reboot} и загрузиться в новую систему.  Пароль @code{root} в новой системе изначально пустой; пароли других пользователей должны быть заданы командой @command{passwd} от @code{root}, если конечно, ваша конфиурация не содержит указания (@pxref{user-account-password, user account passwords}). Смотрите @xref{After System Installation}, чтобы узнать, что дальше!

note: type: Plain text
en: Success, you've now booted into Guix System! From then on, you can update the system whenever you want by running, say:
ru: Замечательно! Теперь вы загрузились в систему Guix! Теперь можно обновить систему, когда у вас будет на это время, запустив, например:

note: type: Plain text
en: This builds a new system generation with the latest packages and services (@pxref{Invoking guix system}).  We recommend doing that regularly so that your system includes the latest security updates (@pxref{Security Updates}).
ru: Это соберёт поколение (generation) системы с последними пакетами и сервисами (@pxref{Invoking guix system}). Мы рекомендуем делать это регулярно, чтобы ваша система содержала обновления безопасности (@pxref{Security Updates}).

note: type: quotation
en: Note that @command{sudo guix} runs your user's @command{guix} command and @emph{not} root's, because @command{sudo} leaves @env{PATH} unchanged.  To explicitly run root's @command{guix}, type @command{sudo -i guix @dots{}}.
ru: Отметим, что @command{sudo guix} запускает команду @command{guix} от вашего пользователя, но @emph{не} от root, потому что @command{sudo} не меняет @code{PATH}. Чтобы вместо этого запустить @command{guix} от root, напечатайте @command{sudo -i guix @dots{}}.

note: type: quotation
en: The difference matters here, because @command{guix pull} updates the @command{guix} command and package definitions only for the user it is run as.  This means that if you choose to use @command{guix system reconfigure} in root's login shell, you'll need to @command{guix pull} separately.
ru: Разница важна, потому что @command{guix pull} обновляет команду @command{guix} и определения пакетов только для пользователя, от имени которого она запускается. Это означает, что если вы решите использовать @command{guix system reconfigure} от имени root, вам нужно будет запустить @command{guix pull} отдельно.

note: type: Plain text
en: Now, @pxref{Getting Started}, and join us on @code{#guix} on the Libera Chat IRC network or on @email{guix-devel@@gnu.org} to share your experience!
ru: Присоединяйтесь к нашему IRC-каналу @code{#guix} в сети Freenode или пишите на @email{guix-devel@@gnu.org}, чтобы поделиться опытом!

note: type: section
en: Installing Guix in a Virtual Machine
ru: Установка Guix на виртуальную машину (VM)

note: type: cindex
en: virtual machine, Guix System installation
ru: виртуальная машина, установка системы Guix

note: type: cindex
en: virtual private server (VPS)
ru: виртуальный приватный сервер (VPS)

note: type: Plain text
en: If you'd like to install Guix System in a virtual machine (VM) or on a virtual private server (VPS) rather than on your beloved machine, this section is for you.
ru: Если вы хотите установить систему Guix на виртуальную машину (VM) или на виртуальный приватный сервер (VPS) вместо вашей любимой машины, этот раздел для вас.

note: type: Plain text
en: To boot a @uref{https://qemu.org/,QEMU} VM for installing Guix System in a disk image, follow these steps:
ru: Чтобы загрузить Guix в @uref{http://qemu.org/,QEMU} VM и установить образ, выполните шаги:

note: type: enumerate
en: First, retrieve and decompress the Guix system installation image as described previously (@pxref{USB Stick and DVD Installation}).
ru: Во-первых, найдите и распакуйте установочный образ системы Guix, как описано ранее (@pxref{USB Stick and DVD Installation}).

note: type: enumerate
en: Create a disk image that will hold the installed system.  To make a qcow2-formatted disk image, use the @command{qemu-img} command:
ru: Создайте образ диска, который будет содержать установленную систему. Чтобы создать образ диска qcow2, используйте команду @command{qemu-img}:

note: type: example
en: qemu-img create -f qcow2 guix-system.img 50G
ru: qemu-img create -f qcow2 guixsd.img 50G

note: type: enumerate
en: The resulting file will be much smaller than 50 GB (typically less than 1 MB), but it will grow as the virtualized storage device is filled up.
ru: Результирующий файл будет намного меньше 50Гб (обычно менее 1Мб), но он будет увеличиваться с заполнение виртуального устройства.

note: type: enumerate
en: Boot the USB installation image in an VM:
ru: Загрузите установочный образ USB в VM:

note: type: enumerate
en: @code{-enable-kvm} is optional, but significantly improves performance, @pxref{Running Guix in a VM}.
ru: @code{-enable-kvm} опционален, но значительно улучшает производительность, @pxref{Running Guix in a VM}.

note: type: enumerate
en: You're now root in the VM, proceed with the installation process.  @xref{Preparing for Installation}, and follow the instructions.
ru: Теперь вы в корне VM, проделайте процесс установки @xref{Preparing for Installation} и последующие инструкции.

note: type: Plain text
en: Once installation is complete, you can boot the system that's on your @file{guix-system.img} image.  @xref{Running Guix in a VM}, for how to do that.
ru: Когда установка завершена, можно загрузиться в систему, которая расположена в образе @file{guixsd.img}. Смотрите @xref{Running Guix in a VM}, чтобы узнать, как это сделать.

note: type: cindex
en: installation image
ru: установочный образ

note: type: Plain text
en: The installation image described above was built using the @command{guix system} command, specifically:
ru: Установочный образ, описанный выше, собран командой @command{guix system}, а именно:

note: type: example
en: guix system image -t iso9660 gnu/system/install.scm
ru: guix system disk-image -t iso9660 gnu/system/install.scm

note: type: Plain text
en: Have a look at @file{gnu/system/install.scm} in the source tree, and see also @ref{Invoking guix system} for more information about the installation image.
ru: Нужно просмотреть @file{gnu/system/install.scm} в дереве исходников, а также @ref{Invoking guix system}, чтобы получить больше информации об установочном образе.

note: type: section
en: Building the Installation Image for ARM Boards
ru: Сбрка и установка образа для плат ARM

note: type: Plain text
en: Many ARM boards require a specific variant of the @uref{https://www.denx.de/wiki/U-Boot/, U-Boot} bootloader.
ru: Многие платы ARM требуют специфический вариант загрузчика @uref{https://www.denx.de/wiki/U-Boot/, U-Boot}.

note: type: Plain text
en: If you build a disk image and the bootloader is not available otherwise (on another boot drive etc), it's advisable to build an image that includes the bootloader, specifically:
ru: Если вы собираете образ диска, а загрузчик не доступен (на другом устройстве загрузке и т.п.), советуем собрать образ, который включает загрузчик, то есть так:

note: type: example
en: guix system image --system=armhf-linux -e '((@@ (gnu system install) os-with-u-boot) (@@ (gnu system install) installation-os) "A20-OLinuXino-Lime2")'
ru: guix system disk-image --system=armhf-linux -e '((@@ (gnu system install) os-with-u-boot) (@@ (gnu system install) installation-os) "A20-OLinuXino-Lime2")'

note: type: Plain text
en: @code{A20-OLinuXino-Lime2} is the name of the board.  If you specify an invalid board, a list of possible boards will be printed.
ru: @code{A20-OLinuXino-Lime2} --- это имя материнской платы. Если вы обозначите недействительную плату, будет выведен список возможных плат.

note: type: Plain text
en: Presumably, you've reached this section because either you have installed Guix on top of another distribution (@pxref{Installation}), or you've installed the standalone Guix System (@pxref{System Installation}).  It's time for you to get started using Guix and this section aims to help you do that and give you a feel of what it's like.
ru: Предположительно, вы попали в этот раздел, потому что либо вы установили Guix поверх другого дистрибутива (@pxref{Installation}), либо вы установили отдельную операционную систему Guix (@pxref{System Installation}).  Пора вам начать использовать Guix, и этот раздел призван помочь вам в этом.

note: type: Plain text
en: Guix is about installing software, so probably the first thing you'll want to do is to actually look for software.  Let's say you're looking for a text editor, you can run:
ru: Guix занимается установкой программного обеспечения, поэтому, вероятно, первое, что вам нужно сделать, это поискать программное обеспечение.  Допустим, вы ищете текстовый редактор, вы можете запустить:

note: type: Plain text
en: This command shows you a number of matching @dfn{packages}, each time showing the package's name, version, a description, and additional info.  Once you've found out the one you want to use, let's say Emacs (ah ha!), you can go ahead and install it (run this command as a regular user, @emph{no need for root privileges}!):
ru: Эта команда показывает количество подходящих @dfn{пакетов}, каждый раз показывая имя пакета, версию, описание и дополнительную информацию.  Как только вы определились с тем, какой пакет хотите использовать, скажем, Emacs (ха!), вы можете установить его следующей командой (запустите эту команду как обычный пользователь, root привилегии не нужны!):

note: type: cindex
en: profile
ru: профиль

note: type: Plain text
en: You've installed your first package, congrats! The package is now visible in your default @dfn{profile}, @file{$HOME/.guix-profile}---a profile is a directory containing installed packages.  In the process, you've probably noticed that Guix downloaded pre-built binaries; or, if you explicitly chose to @emph{not} use pre-built binaries, then probably Guix is still building software (@pxref{Substitutes}, for more info).
ru: Вы установили свой первый пакет, поздравляю! В процессе вы, вероятно, заметили, что Guix загружает заранее собранные двоичные файлы; или, если вы явно решили не использовать предварительно созданные двоичные файлы, то, вероятно, Guix все еще собирает программное обеспечение (@pxref{Substitutes}, для дополнительной информации).

note: type: Plain text
en: Unless you're using Guix System, the @command{guix install} command must have printed this hint:
ru: Пока вы используете Guix System, @command{guix install} команда должна выводить данную подсказку:

note: type: example
en:      GUIX_PROFILE="$HOME/.guix-profile"
         . "$GUIX_PROFILE/etc/profile"
ru:      GUIX_PROFILE=\"$HOME/.guix-profile\"
         . \"$GUIX_PROFILE/etc/profile\"

note: type: example
en: Alternately, see `guix package --search-paths -p "$HOME/.guix-profile"'.
ru: Или смотрите `guix package --search-paths -p "$HOME/.guix-profile"'.

note: type: Plain text
en: You can go on installing packages at your will.  To list installed packages, run:
ru: Вы можете продолжать установку пакетов по своему желанию. Чтобы вывести список установленных пакетов, запустите:

note: type: Plain text
en: To remove a package, you would unsurprisingly run @command{guix remove}.  A distinguishing feature is the ability to @dfn{roll back} any operation you made---installation, removal, upgrade---by simply typing:
ru: Для удаления пакета вы можете выполнить команду @command{guix remove}.  Отличительная черта - возможность @dfn{откатить} любую операцию, которую вы сделали (установка, удаление, обновление):

note: type: Plain text
en: This is because each operation is in fact a @dfn{transaction} that creates a new @dfn{generation}.  These generations and the difference between them can be displayed by running:
ru: Каждая операция фактически является транзакцией, которая создает новое поколение.  Эти поколения и разницу между ними можно отобразить, запустив:

note: type: Plain text
en: Now you know the basics of package management!
ru: Теперь вы знаете основы управления пакетами!

note: type: quotation
en: Going further
ru: Больше информации

note: type: quotation
en: @xref{Package Management}, for more about package management.  You may like @dfn{declarative} package management with @command{guix package --manifest}, managing separate @dfn{profiles} with @option{--profile}, deleting old generations, collecting garbage, and other nifty features that will come in handy as you become more familiar with Guix.  If you are a developer, @pxref{Development} for additional tools.  And if you're curious, @pxref{Features}, to peek under the hood.
ru: @xref{Package Management}, для получения дополнительной информации об управлении пакетами.  Вам может понравиться @dfn{декларативное} управление пакетами с помощью @command{guix package --manifest}, управление отдельными @dfn{профилями} с помощью @option{--profile}, удаление старых поколений, сбор мусора и другие полезные функции, которые помогут пригодится по мере того, как вы ближе познакомитесь с Guix.  Если вы разработчик, @pxref{Development} для получения дополнительных инструментов.  И если вам интересно, @pxref{Features}, чтобы заглянуть под капот.

note: type: Plain text
en: Once you've installed a set of packages, you will want to periodically @emph{upgrade} them to the latest and greatest version.  To do that, you will first pull the latest revision of Guix and its package collection:
ru: После того, как вы установили набор пакетов, вам нужно будет периодически @emph{обновлять} их до последней и самой лучшей версии.  Для этого вы сначала загрузите последнюю версию Guix и его коллекцию пакетов:

note: type: Plain text
en: The end result is a new @command{guix} command, under @file{~/.config/guix/current/bin}.  Unless you're on Guix System, the first time you run @command{guix pull}, be sure to follow the hint that the command prints and, similar to what we saw above, paste these two lines in your terminal and @file{.bash_profile}:
ru: Конечным результатом является новая команда @command{guix} в @file{~/.config/guix/current/bin}.  Если вы не используете Guix System, при первом запуске @command{guix pull} обязательно следуйте подсказке, которую выводит команда, и, подобно тому, что мы видели выше, вставьте эти две строки в свой терминал и @file{.bash_profile}:

note: type: example
en: GUIX_PROFILE="$HOME/.config/guix/current"
    . "$GUIX_PROFILE/etc/profile"
ru: GUIX_PROFILE="$HOME/.config/guix/current/etc/profile"
    . "$GUIX_PROFILE/etc/profile"

note: type: Plain text
en: You must also instruct your shell to point to this new @command{guix}:
ru: Вы также должны указать своей оболочке, чтобы она указывала на новую команду @command{guix}:

note: type: Plain text
en: At this point, you're running a brand new Guix.  You can thus go ahead and actually upgrade all the packages you previously installed:
ru: На данный момент вы используете новый Guix.  Вы можете обновить все ранее установленные пакеты:

note: type: Plain text
en: As you run this command, you will see that binaries are downloaded (or perhaps some packages are built), and eventually you end up with the upgraded packages.  Should one of these upgraded packages not be to your liking, remember you can always roll back!
ru: Когда вы запустите эту команду, вы увидите, что загружены двоичные файлы (или, возможно, собраны некоторые пакеты), и в конечном итоге вы получите обновленные пакеты.  Если один из этих обновленных пакетов вам не понравится, помните, что вы всегда можете выполнить откат!

note: type: Plain text
en: You can display the exact revision of Guix you're currently using by running:
ru: Вы можете отобразить точную версию Guix, которую сейчас используете, запустив:

note: type: Plain text
en: The information it displays is @emph{all it takes to reproduce the exact same Guix}, be it at a different point in time or on a different machine.
ru: Отображаемая информация - это @emph{все, что нужно для воспроизведения того же самого Guix}, будь то в другой момент времени или на другой машине.

note: type: quotation
en: @xref{Invoking guix pull}, for more information.  @xref{Channels}, on how to specify additional @dfn{channels} to pull packages from, how to replicate Guix, and more.  You may also find @command{time-machine} handy (@pxref{Invoking guix time-machine}).
ru: @xref{Invoking guix pull}, для дополнительной информации.  @xref{Channels}, как указать дополнительные @dfn{каналы} для получения пакетов, как реплицировать Guix и т. д.  Также команда @command{time-machine} может оказаться полезной (@pxref{Invoking guix time-machine}).

note: type: Plain text
en: If you installed Guix System, one of the first things you'll want to do is to upgrade your system.  Once you've run @command{guix pull} to get the latest Guix, you can upgrade the system like this:
ru: Если вы установили Guix System, первое, что вам нужно сделать, это обновить вашу систему.  После того, как вы запустите команду @command{guix pull}, чтобы получить последнюю версию Guix, вы можете обновить систему следующим образом:

note: type: Plain text
en: Upon completion, the system runs the latest versions of its software packages.  When you eventually reboot, you'll notice a sub-menu in the bootloader that reads ``Old system generations'': it's what allows you to boot @emph{an older generation of your system}, should the latest generation be ``broken'' or otherwise unsatisfying.  Just like for packages, you can always @emph{roll back} to a previous generation @emph{of the whole system}:
ru: По завершении в системе будут запущены последние версии пакетов.  Когда вы перезагрузите машину, вы заметите подменю в загрузчике ``Old system generations'': это то, что позволяет вам загружать @emph{старшее поколение вашей системы}, если последнее поколение ``сломано'' или не соответствует вашим ожиданиям.  Как и в случае с пакетами, вы всегда можете @emph{откатиться} на предыдущее поколение @emph{всей системы}:

note: type: Plain text
en: There are many things you'll probably want to tweak on your system: adding new user accounts, adding new system services, fiddling with the configuration of those services, etc.  The system configuration is @emph{entirely} described in the @file{/etc/config.scm} file.  @xref{Using the Configuration System}, to learn how to change it.
ru: Есть много вещей, которые вы, вероятно, захотите настроить в своей системе: добавление новых учетных записей пользователей, добавление новых системных служб, изменение конфигурации этих служб и т.д.  Конфигурация системы @emph{полностью} определена в файле @file{/etc/config.scm}.  @xref{Using the Configuration System}, узнать о настройке системы.

note: type: Plain text
en: Now you know enough to get started!
ru: Теперь вы знаете достаточно, чтобы начать!

note: type: quotation
en: Resources
ru: Ресурсы

note: type: quotation
en: The rest of this manual provides a reference for all things Guix.  Here are some additional resources you may find useful:
ru: Остальная часть этого руководства представляет собой справочник по всему, что связано с Guix.  Вот несколько дополнительных ресурсов, которые могут вам пригодиться:

note: type: itemize
en: @xref{Top,,, guix-cookbook, The GNU Guix Cookbook}, for a list of ``how-to'' style of recipes for a variety of applications.
ru: @xref{Top,,, guix-cookbook, The GNU Guix Cookbook}, статьи с готовыми решениями для различных ситуаций в стиле ``how-to''.

note: type: itemize
en: The @uref{https://guix.gnu.org/guix-refcard.pdf, GNU Guix Reference Card} lists in two pages most of the commands and options you'll ever need.
ru: @uref{https://guix.gnu.org/guix-refcard.pdf, GNU Guix Reference Card} шпаргалка с большинством команд и опций, которые вам когда-либо понадобятся.

note: type: itemize
en: The web site contains @uref{https://guix.gnu.org/en/videos/, instructional videos} covering topics such as everyday use of Guix, how to get help, and how to become a contributor.
ru: Веб-сайт содержит @uref{https://guix.gnu.org/en/videos/, обучающие видеоролики} по таким темам, как повседневное использование Guix, как получить помощь и как стать участником сообщества.

note: type: itemize
en: @xref{Documentation}, to learn how to access documentation on your computer.
ru: @xref{Documentation}, чтобы узнать, как получить доступ к документации на вашем компьютере.

note: type: quotation
en: We hope you will enjoy Guix as much as the community enjoys building it!
ru: Мы надеемся, что вам понравится Guix так же, как и сообществу нравится его создавать!

note: type: Plain text
en: The purpose of GNU Guix is to allow users to easily install, upgrade, and remove software packages, without having to know about their build procedures or dependencies.  Guix also goes beyond this obvious set of features.
ru: Целью GNU Guix является предоставление пользователям возможности легко устанавливать, обновлять и удалять пакеты программного обеспечения, без необходимости изучения процедур их сборки и без необходимости разрешения зависимостей. Также Guix имеет следующие обязательные особенности.

note: type: Plain text
en: This chapter describes the main features of Guix, as well as the package management tools it provides.  Along with the command-line interface described below (@pxref{Invoking guix package, @code{guix package}}), you may also use the Emacs-Guix interface (@pxref{Top,,, emacs-guix, The Emacs-Guix Reference Manual}), after installing @code{emacs-guix} package (run @kbd{M-x guix-help} command to start with it):
ru: Этот раздел описывает основные особенности Guix и предоставляемые им инструменты управления пакетами.  Кроме интерфейса командной строки, который описан ниже (@pxref{Invoking guix package, @code{guix package}}), можно также использовать интерфейс Emacs-Guix (@pxref{Top,,, emacs-guix, The Emacs-Guix Reference Manual}), если установить пакет @code{emacs-guix} (выполните команду @kbd{M-x guix-help}, чтобы начать работу с ним):

note: type: Plain text
en: Here we assume you've already made your first steps with Guix (@pxref{Getting Started}) and would like to get an overview about what's going on under the hood.
ru: Здесь мы предполагаем, что вы уже сделали свои первые шаги с Guix (@pxref{Getting Started}) и хотели бы получить обзор того, что происходит под капотом.

note: type: Plain text
en: When using Guix, each package ends up in the @dfn{package store}, in its own directory---something that resembles @file{/gnu/store/xxx-package-1.2}, where @code{xxx} is a base32 string.
ru: При использовании Guix каждый пакет после установки размещается в @dfn{package store}, в собственной директории, например, @file{/gnu/store/xxx-package-1.2}, где @code{xxx} - это строка base32.

note: type: Plain text
en: Instead of referring to these directories, users have their own @dfn{profile}, which points to the packages that they actually want to use.  These profiles are stored within each user's home directory, at @code{$HOME/.guix-profile}.
ru: Вместо того, чтобы ссылаться на эти директории, пользователям нужно обращаться к их @dfn{профилям}, профиль указывает на пакеты, которые они хотят использовать. Эти профили хранятся в домашней директории каждого пользователя в @code{$HOME/.guix-profile}.

note: type: Plain text
en: For example, @code{alice} installs GCC 4.7.2.  As a result, @file{/home/alice/.guix-profile/bin/gcc} points to @file{/gnu/store/@dots{}-gcc-4.7.2/bin/gcc}.  Now, on the same machine, @code{bob} had already installed GCC 4.8.0.  The profile of @code{bob} simply continues to point to @file{/gnu/store/@dots{}-gcc-4.8.0/bin/gcc}---i.e., both versions of GCC coexist on the same system without any interference.
ru: Например,  @code{alice} устанавливает GCC 4.7.2. В результате @file{/home/alice/.guix-profile/bin/gcc} указывает на @file{/gnu/store/@dots{}-gcc-4.7.2/bin/gcc}. Допустим, на той же машине @code{bob} установил GCC 4.8.0. Профиль пользователя @code{bob} просто указывает на @file{/gnu/store/@dots{}-gcc-4.8.0/bin/gcc}. То есть обе версии GCC присутствуют в одной системе без помех.

note: type: Plain text
en: The @command{guix package} command is the central tool to manage packages (@pxref{Invoking guix package}).  It operates on the per-user profiles, and can be used @emph{with normal user privileges}.
ru: Команда @command{guix package} --- главный инструмент для управления пакетами (@pxref{Invoking guix package}). Она работает с профилями пользователей, которые имеют @emph{права обычных пользователей}.

note: type: cindex
en: transactions
ru: транзакции

note: type: Plain text
en: The command provides the obvious install, remove, and upgrade operations.  Each invocation is actually a @emph{transaction}: either the specified operation succeeds, or nothing happens.  Thus, if the @command{guix package} process is terminated during the transaction, or if a power outage occurs during the transaction, then the user's profile remains in its previous state, and remains usable.
ru: Команда предоставляет обязательные операции установки, удаления и обновления. Каждый вызов представляет собой @emph{транзакцию}, независимо от того, выполнены успешно заданные операции, или ничего не произошло. Так, если процесс @command{guix package} завершился во время транзакции, или произошёл сбой питания во время транзакции, тогда профиль пользователя остаётся в исходном состоянии, готовом к использованию.

note: type: Plain text
en: In addition, any package transaction may be @emph{rolled back}.  So, if, for example, an upgrade installs a new version of a package that turns out to have a serious bug, users may roll back to the previous instance of their profile, which was known to work well.  Similarly, the global system configuration on Guix is subject to transactional upgrades and roll-back (@pxref{Using the Configuration System}).
ru: В дополнение, каждую транзакцию, которая работает с пакетами, можно @emph{откатить}. Так если, например, обновление устанавливает новую версию пакета, которая имеет серьёзный баг, пользователи могут откатиться до предыдущей инстанции своего профиля, который работал нормально. Точно так же, глобальные настройки системы Guix являются объектом транзакционных обновлений и откатов (@pxref{Using the Configuration System}).

note: type: Plain text
en: All packages in the package store may be @emph{garbage-collected}.  Guix can determine which packages are still referenced by user profiles, and remove those that are provably no longer referenced (@pxref{Invoking guix gc}).  Users may also explicitly remove old generations of their profile so that the packages they refer to can be collected.
ru: Все пакеты на складе могут быть @emph{собраны как мусор}. Guix может определить, какие пакеты всё ещё используются профилями пользователей, и удалить те, которые однозначно больше не используются  (@pxref{Invoking guix gc}). Также пользователи могут явно удалить старые поколения (generations) их профилей, поэтому пакеты, на которые ссылались старые профили, могут быть удалены.

note: type: Plain text
en: Guix takes a @dfn{purely functional} approach to package management, as described in the introduction (@pxref{Introduction}).  Each @file{/gnu/store} package directory name contains a hash of all the inputs that were used to build that package---compiler, libraries, build scripts, etc.  This direct correspondence allows users to make sure a given package installation matches the current state of their distribution.  It also helps maximize @dfn{build reproducibility}: thanks to the isolated build environments that are used, a given build is likely to yield bit-identical files when performed on different machines (@pxref{Invoking guix-daemon, container}).
ru: Guix реализует @dfn{чисто функциональный} подход к управлению пакетами, как описано во введении (@pxref{Introduction}). В @file{/gnu/store} имя директории каждого пакета содержит хеш всех входных данных, которые использовались при сборке пакета: компилятор, библиотеки, скрипты сборки и т.д. Это прямое соответствие позволяет пользователям убедиться, что данная установка пакета соответствует текущему состоянию дистрибутива. Также это помогает улучшить @dfn{воспроизводимость сборки}: благодаря изолированному окружению сборки, которая используется при установке пакета, результат сборки содержит точно такие же файлы на разных машинах (@pxref{Invoking guix-daemon, container}).

note: type: Plain text
en: This foundation allows Guix to support @dfn{transparent binary/source deployment}.  When a pre-built binary for a @file{/gnu/store} item is available from an external source---a @dfn{substitute}, Guix just downloads it and unpacks it; otherwise, it builds the package from source, locally (@pxref{Substitutes}).  Because build results are usually bit-for-bit reproducible, users do not have to trust servers that provide substitutes: they can force a local build and @emph{challenge} providers (@pxref{Invoking guix challenge}).
ru: Эта концепция позволяет Guix поддерживать @dfn{прозрачное внедрение бинарников/исходников}. Когда доступен элемент @file{/gnu/store}, собранный заранее на внешнем источнике, то есть готова @dfn{подстановка}, Guix просто скачивает и распаковывает его. В противном случае он собирает пакет из исходников на локальной машине (@pxref{Substitutes}). Так как результаты сборки обычно воспроизводимы бит-к-биту, пользователи не должны доверять серверам, которые поставляют подстановки --- они могут целенаправленно запросить локальную сборку и @emph{не пользоваться} серверами подстановки (@pxref{Invoking guix challenge}).

note: type: cindex
en: replication, of software environments
ru: повторение, окружения программного обеспечения

note: type: cindex
en: provenance tracking, of software artifacts
ru: трекинг источника, артефакты программного обеспечения

note: type: Plain text
en: All of Guix and its package definitions is version-controlled, and @command{guix pull} allows you to ``travel in time'' on the history of Guix itself (@pxref{Invoking guix pull}).  This makes it possible to replicate a Guix instance on a different machine or at a later point in time, which in turn allows you to @emph{replicate complete software environments}, while retaining precise @dfn{provenance tracking} of the software.
ru: Guix и его определения пакетов подчняются контролю версиями, и @command{guix pull} позволяет "путешествовать во времени" по истории Guix (@pxref{Invoking guix pull}). Это позволяет повторять инстанцию Guix на разных машинах или по прошествию времени, что в свою очередь позволяет вам @emph{повторять полностью программное окружение} из достпуных @dfn{трекеров источников} программного обеспечения.

note: type: section
en: Invoking @command{guix package}
ru: Вызов @command{guix package}

note: type: cindex
en: installing packages
ru: установка пакетов

note: type: cindex
en: removing packages
ru: удаление пакетов

note: type: cindex
en: package installation
ru: установка пакета

note: type: cindex
en: package removal
ru: удаление пакета

note: type: Plain text
en: The @command{guix package} command is the tool that allows users to install, upgrade, and remove packages, as well as rolling back to previous configurations.  These operations work on a user @dfn{profile}---a directory of installed packages.  Each user has a default profile in @file{$HOME/.guix-profile}.  The command operates only on the user's own profile, and works with normal user privileges (@pxref{Features}).  Its syntax is:
ru: Команда @command{guix package} --- инструмент, который позволяет пользователям устанавливать, обновлять и удалять пакеты, а также откатываться до предыдущих конфигураций (@pxref{Features}). Его синтаксис:

note: type: Plain text
en: Primarily, @var{options} specifies the operations to be performed during the transaction.  Upon completion, a new profile is created, but previous @dfn{generations} of the profile remain available, should the user want to roll back.
ru: В первую очередь, @var{options} (опции) задают операции, которые нужно выполнить в транзакции. По завершении создаётся новый профиль, а предыдущие @dfn{поколения} (generations) профиля остаются доступными, если пользователь решит откатиться.

note: type: Plain text
en: For example, to remove @code{lua} and install @code{guile} and @code{guile-cairo} in a single transaction:
ru: Например, чтобы удалить @code{lua} и устанвоить @code{guile} и @code{guile-cairo} в одной транзакции, напечатайте:

note: type: cindex
en: aliases, for @command{guix package}
ru: синонимы, для @command{guix package}

note: type: Plain text
en: For your convenience, we also provide the following aliases:
ru: Для вашего удобства мы также предоставляем следующие синонимы:

note: type: itemize
en: @command{guix search} is an alias for @command{guix package -s},
ru: @command{guix search} - синоним @command{guix package -s},

note: type: itemize
en: @command{guix install} is an alias for @command{guix package -i},
ru: @command{guix install} - синоним @command{guix package -i},

note: type: itemize
en: @command{guix remove} is an alias for @command{guix package -r},
ru: @command{guix remove} - синоним @command{guix package -r},

note: type: itemize
en: @command{guix upgrade} is an alias for @command{guix package -u},
ru: @command{guix upgrade} — это синоним @command{guix package -u},

note: type: itemize
en: and @command{guix show} is an alias for @command{guix package --show=}.
ru: и @command{guix show} псевдоним (alias) для @command{guix package --show=}.

note: type: Plain text
en: These aliases are less expressive than @command{guix package} and provide fewer options, so in some cases you'll probably want to use @command{guix package} directly.
ru: Эти синонимы не такие мощные, как @command{guix package}, и предоставляют меньше опций, так что в некоторых случаях вам скорее нужно пользоваться непосредственно @command{guix package}.

note: type: Plain text
en: @command{guix package} also supports a @dfn{declarative approach} whereby the user specifies the exact set of packages to be available and passes it @i{via} the @option{--manifest} option (@pxref{profile-manifest, @option{--manifest}}).
ru: @command{guix package} также поддерживает @dfn{декларативный подход}, с помощью которого пользователь зааёт точный набор пакетов, которые должны быть доступны, и передаёт его @i{в опции} @option{--manifest} (@pxref{profile-manifest, @option{--manifest}}).

note: type: Plain text
en: For each user, a symlink to the user's default profile is automatically created in @file{$HOME/.guix-profile}.  This symlink always points to the current generation of the user's default profile.  Thus, users can add @file{$HOME/.guix-profile/bin} to their @env{PATH} environment variable, and so on.
ru: Для каждого пользователя автоматически создаётся символическая ссылка на профиль по умолчанию, она располагается в файле @file{$HOME/.guix-profile}. Эта ссылка всегда указывает на текущее поколение пользовательского профиля по умолчанию. Так пользователи могут добавить @file{$HOME/.guix-profile/bin} в свою переменную окружения @code{PATH} и прочее.

note: type: cindex
en: search paths
ru: пути поиска

note: type: Plain text
en: If you are not using Guix System, consider adding the following lines to your @file{~/.bash_profile} (@pxref{Bash Startup Files,,, bash, The GNU Bash Reference Manual}) so that newly-spawned shells get all the right environment variable definitions:
ru: Если вы не используете систему Guix, предполагается добавление следующих строк в ваш @file{~/.bash_profile} (@pxref{Bash Startup Files,,, bash, The GNU Bash Reference Manual}), чтобы порождаемые оболочки получили все необходимые определения переменных окружения:

note: type: Plain text
en: In a multi-user setup, user profiles are stored in a place registered as a @dfn{garbage-collector root}, which @file{$HOME/.guix-profile} points to (@pxref{Invoking guix gc}).  That directory is normally @code{@var{localstatedir}/guix/profiles/per-user/@var{user}}, where @var{localstatedir} is the value passed to @code{configure} as @option{--localstatedir}, and @var{user} is the user name.  The @file{per-user} directory is created when @command{guix-daemon} is started, and the @var{user} sub-directory is created by @command{guix package}.
ru: В случае многопользовательской установки, профили пользователей сохраняются в месте, которое зарегстрировано как @dfn{garbage-collector root}, которое указывет на @file{$HOME/.guix-profile} (@pxref{Invoking guix gc}). Эта директория обычно ссылается на @code{@var{localstatedir}/guix/profiles/per-user/@var{user}}, где @var{localstatedir} --- значение, переданное скрипту @code{configure} опцией @code{--localstatedir}, а @var{user} --- имя пользователя. Директория @file{per-user} создаёся, когда запускается @command{guix-daemon}, а поддиректория @var{user} создаётся @command{guix package}.

note: type: Plain text
en: The @var{options} can be among the following:
ru: Опции @var{options} могут быть следующими:

note: type: table
en: Install the specified @var{package}s.
ru: Установить заданный пакет.

note: type: cindex
en: propagated inputs
ru: распространяемые входные данные

note: type: table
en: Sometimes packages have @dfn{propagated inputs}: these are dependencies that automatically get installed along with the required package (@pxref{package-propagated-inputs, @code{propagated-inputs} in @code{package} objects}, for information about propagated inputs in package definitions).
ru: Иногда пакеты имеют @dfn{распространённые входные данные} (propagated inputs) --- это зависимости, которые устанавливаются автоматически вместе с требуемыми пакетами (см. @pxref{package-propagated-inputs, @code{propagated-inputs} in @code{package} objects} для подробной информации о распространяемых входных днных в определениях пакетов).

note: type: table
en: An example is the GNU MPC library: its C header files refer to those of the GNU MPFR library, which in turn refer to those of the GMP library.  Thus, when installing MPC, the MPFR and GMP libraries also get installed in the profile; removing MPC also removes MPFR and GMP---unless they had also been explicitly installed by the user.
ru: Примером является библиотека GNU MPC: его файлы заголовков C ссылаются на файлы библиотеки GNU MPFR, которые в свою очередь, ссылаются на библиотеку GMP. Так при установке MPC, также в профиль будут устанволены библиотеки MPFR и GMP; удаление MPC также удалит MPFR и GMP, если конечно, они не были явно установлены пользователем.

note: type: table
en: Besides, packages sometimes rely on the definition of environment variables for their search paths (see explanation of @option{--search-paths} below).  Any missing or possibly incorrect environment variable definitions are reported here.
ru: Кроме того, пакеты иногда зависят от переменных окружения --- от их путей поиска (смотрите разъяснение @code{--search-paths} ниже). Любая отсутствующая или, возможно, некорректная переменная окружения вызывает сообщение отчета.

note: type: table
en: Install the package @var{exp} evaluates to.
ru: Устанавить пакет, соответствующий @var{exp}.

note: type: table
en: @var{exp} must be a Scheme expression that evaluates to a @code{<package>} object.  This option is notably useful to disambiguate between same-named variants of a package, with expressions such as @code{(@@ (gnu packages base) guile-final)}.
ru: @var{exp} должно быть выражением Scheme, которое определяет объект @code{<package>}. Эта опция полезна, чтобы указать однозначно пакет, который имеет схожие варианты имён, например, выражением @code{(@@ (gnu packages base) guile-final)}.

note: type: table
en: Note that this option installs the first output of the specified package, which may be insufficient when needing a specific output of a multiple-output package.
ru: Отметим, что эта опция устанавливает первое содержимое пакета, чего может быть недостаточно, если нужен специфичный выход пакета со множественным выходом.

note: type: table
en: Install the package that the code within @var{file} evaluates to.
ru: Устанавить пакет, который определён в файле.

note: type: table
en: As an example, @var{file} might contain a definition like this (@pxref{Defining Packages}):
ru: Например, @var{file} может содержать определение (@pxref{Defining Packages}):

note: type: table
en: The @var{file} may also contain a JSON representation of one or more package definitions.  Running @code{guix package -f} on @file{hello.json} with the following contents would result in installing the package @code{greeter} after building @code{myhello}:
ru: @var{file} может также содержать JSON-представление одного или нескольких определений пакетов.  Запуск @code{guix package -f} на файле @file{hello.json} со следующим содержимым, установит пакет @code{greeter} после сборки @code{myhello}:

note: type: example
en: @verbatiminclude package-hello.json
ru: @verbatiminclude environment-gdb.scm

note: type: table
en: Remove the specified @var{package}s.
ru: Удалить обозначенный пакет.

note: type: table
en: As for @option{--install}, each @var{package} may specify a version number and/or output name in addition to the package name.  For instance, @samp{-r glibc:debug} would remove the @code{debug} output of @code{glibc}.
ru: Касаемо @code{--install}, каждый пакет @var{package} может задавать номер версии и имя содержимого в добавлении к имени пакета. Например,  @code{-r glibc:debug} удалит содержимое @code{debug} из  @code{glibc}.

note: type: cindex
en: upgrading packages
ru: обновление пакетов

note: type: table
en: Upgrade all the installed packages.  If one or more @var{regexp}s are specified, upgrade only installed packages whose name matches a @var{regexp}.  Also see the @option{--do-not-upgrade} option below.
ru: Обновить все устанволенные пакеты. Если задано одно или более значений @var{regexp}, обновление затронет только пакеты, которые соответствуют @var{regexp}. Также смотрите опцию @code{--do-not-upgrade} ниже.

note: type: table
en: Note that this upgrades package to the latest version of packages found in the distribution currently installed.  To update your distribution, you should regularly run @command{guix pull} (@pxref{Invoking guix pull}).
ru: Отметим, что это обновляет пакеты, которые установлены в системе, до последних версий, имеющихся в дистрибутиве. Чтобы обновить дистрибутив, нужно регулярно запускать @command{guix pull} (@pxref{Invoking guix pull}).

note: type: cindex
en: package transformations, upgrades
ru: Параметры преобразования пакета

note: type: table
en: When upgrading, package transformations that were originally applied when creating the profile are automatically re-applied (@pxref{Package Transformation Options}).  For example, assume you first installed Emacs from the tip of its development branch with:
ru: При обновлении автоматически применяются преобразования пакета, которые были первоначально применены при создании профиля (@pxref{Package Transformation Options}).  Например, предположим, что вы сначала установили Emacs из ветки разработки с помощью:

note: type: table
en: Next time you run @command{guix upgrade}, Guix will again pull the tip of the Emacs development branch and build @code{emacs-next} from that checkout.
ru: В следующий раз, когда вы запустите @command{guix upgrade}, Guix снова посмотрит на ветку разработки Emacs и соберет новый @code{emacs-next}.

note: type: table
en: Note that transformation options such as @option{--with-branch} and @option{--with-source} depend on external state; it is up to you to ensure that they work as expected.  You can also discard a transformations that apply to a package by running:
ru: Обратите внимание, что параметры преобразования, такие как @option{--with-branch} и @option{--with-source}, зависят от внешнего состояния;  вам решать, чтобы они работали должным образом.  Вы также можете отменить преобразования, которые применяются к пакету, запустив:

note: type: table
en: When used together with the @option{--upgrade} option, do @emph{not} upgrade any packages whose name matches a @var{regexp}.  For example, to upgrade all packages in the current profile except those containing the substring ``emacs'':
ru: При совместном использовании с опцией @code{--upgrade} @emph{не} обновляет ни один пакет, чьё имя соответствует @var{regexp}. Например, обновить все пакеты в текущем профиле , кроме тех, которые содержат подстроку "emacs":

note: type: cindex
en: profile declaration
ru: описание профиля

note: type: cindex
en: profile manifest
ru: манифест профиля

note: type: table
en: Create a new generation of the profile from the manifest object returned by the Scheme code in @var{file}.  This option can be repeated several times, in which case the manifests are concatenated.
ru: Создаёт новую версию профиля из объекта манифеста, возвращаемого кодом Scheme в @var{file}. Этот параметр можно указывать несколько раз. В результате манифесты будут объединены в один.

note: type: table
en: This allows you to @emph{declare} the profile's contents rather than constructing it through a sequence of @option{--install} and similar commands.  The advantage is that @var{file} can be put under version control, copied to different machines to reproduce the same profile, and so on.
ru: Это позволяет вам @emph{описать} содержимое профиля вместо того, чтобы собирать его последовательностью команд @code{--install} и других. Преимущество в том, что @var{file} может подчиняться контролю версиями, копироваться на другие машины, чтобы повторить такой же профиль и т.д.

note: type: table
en: @var{file} must return a @dfn{manifest} object, which is roughly a list of packages:
ru: @var{file} должен возвращать объект @dfn{manifest}, который, грубо говоря, является списком пакетов:

note: type: cindex
en: rolling back
ru: откат

note: type: cindex
en: undoing transactions
ru: отменение транзакций

note: type: cindex
en: transactions, undoing
ru: транзакции, отмена

note: type: table
en: Roll back to the previous @dfn{generation} of the profile---i.e., undo the last transaction.
ru: Откатиться до предыдущего @dfn{поколения} профиля, то есть отменить последнюю транзакцию.

note: type: table
en: When combined with options such as @option{--install}, roll back occurs before any other actions.
ru: При сочетании с опциеями как @code{--install}, откат выполняется до всех прочих действий.

note: type: table
en: When rolling back from the first generation that actually contains installed packages, the profile is made to point to the @dfn{zeroth generation}, which contains no files apart from its own metadata.
ru: При откате от первого поколения, которое по факту содержит установленные пакеты, профиль будет указывать на @dfn{нулевое поколение}, которое не содержит файлы, кроме собственных метаданных.

note: type: table
en: After having rolled back, installing, removing, or upgrading packages overwrites previous future generations.  Thus, the history of the generations in a profile is always linear.
ru: После выполнения отката, установка, удаление или обновление пакетов по факту заменяет прежние будущие поколения. То есть история поколений в профиле всегда линейная.

note: type: cindex
en: generations
ru: поколения

note: type: table
en: Switch to a particular generation defined by @var{pattern}.
ru: Переключиться на определённое поколение, опрделённое @var{pattern}.

note: type: table
en: @var{pattern} may be either a generation number or a number prefixed with ``+'' or ``-''.  The latter means: move forward/backward by a specified number of generations.  For example, if you want to return to the latest generation after @option{--roll-back}, use @option{--switch-generation=+1}.
ru: @var{pattern} может быть либо номером поколения или числом с префиксом "+" или "-". Последнее означает сменить вперёд/назад на обозначенное число поколений. Например, если вы хотите вернуться к последнему поколению после @code{--roll-back}, используйте @code{--switch-generation=+1}.

note: type: table
en: The difference between @option{--roll-back} and @option{--switch-generation=-1} is that @option{--switch-generation} will not make a zeroth generation, so if a specified generation does not exist, the current generation will not be changed.
ru: Разница между @code{--roll-back} и @code{--switch-generation=-1} заключается в том, что @code{--switch-generation} не создаёт нулевое поколение, так что если заданное поколение не существует, текущее поколение не будет изменено.

note: type: table
en: Report environment variable definitions, in Bash syntax, that may be needed in order to use the set of installed packages.  These environment variables are used to specify @dfn{search paths} for files used by some of the installed packages.
ru: Вывести отчёт об определениях переменных окружения в синтаксисе Bash. Это может понадобиться для использования набора установленных пакетов. Эти переменные окружения используются некоторыми установленными пакетами для поиска файлов.

note: type: table
en: The typical use case is to define these environment variables in the shell:
ru: Обычный способ определить эти переменные окружения в оболочке:

note: type: table
en: @var{kind} may be one of @code{exact}, @code{prefix}, or @code{suffix}, meaning that the returned environment variable definitions will either be exact settings, or prefixes or suffixes of the current value of these variables.  When omitted, @var{kind} defaults to @code{exact}.
ru: Вид @var{kind} может быть либо точный адрес @code{exact}, либо префикс @code{prefix}, либо суффикс @code{suffix}, то есть возвращаемые переменные окружения могут быть либо точными, либо префиксами и суффиксами текущего значения этих переменных. При пропуске вид @var{kind} по умолчанию выбирается точный @code{exact}.

note: type: table
en: This option can also be used to compute the @emph{combined} search paths of several profiles.  Consider this example:
ru: Эта опция также может использоваться для вычисления @emph{комбинированных} путей поиска нескольких профилей. Рассмотрим пример:

note: type: table
en: The last command above reports about the @env{GUILE_LOAD_PATH} variable, even though, taken individually, neither @file{foo} nor @file{bar} would lead to that recommendation.
ru: Последняя команда выше составляет отчёт о переменной @code{GUILE_LOAD_PATH}, даже если по отдельности ни @file{foo}, ни @file{bar} не предшествуют рекомендациям.

note: type: cindex
en: profile, choosing
ru: противоречеия профиля

note: type: table
en: Use @var{profile} instead of the user's default profile.
ru: Использовать @var{profile} вместо пользовательского профиля по умолчанию.

note: type: table
en: @var{profile} must be the name of a file that will be created upon completion.  Concretely, @var{profile} will be a mere symbolic link (``symlink'') pointing to the actual profile where packages are installed:
ru: @var{profile} должен быть именем файла, который будет создан по завершении.  Конкретно @var{profile} будет простой символической ссылкой (``символическая ссылка''), указывающей на текущий профиль, в котором установлены пакеты:

note: type: table
en: All it takes to get rid of the profile is to remove this symlink and its siblings that point to specific generations:
ru: Чтобы избавиться от профиля, нужно удалить символическую ссылку и привязанные к ней элементы, которые указывают на конкретные поколения:

note: type: table
en: List all the user's profiles:
ru: Перечислить все профили пользователя:

note: type: table
en: When running as root, list all the profiles of all the users.
ru: При запуске от имени root будут перечислены все профили всех пользователей.

note: type: cindex
en: collisions, in a profile
ru: противоречия, в профиле

note: type: cindex
en: colliding packages in profiles
ru: соперничающие пакеты в профиле

note: type: cindex
en: profile collisions
ru: противоречеия профиля

note: type: table
en: Allow colliding packages in the new profile.  Use at your own risk!
ru: Разрешить соперничающие пакеты в новом профиле. Используйте на свой собственный страх и риск!

note: type: table
en: By default, @command{guix package} reports as an error @dfn{collisions} in the profile.  Collisions happen when two or more different versions or variants of a given package end up in the profile.
ru: По умолчанию @command{guix package} делает отчёт о противоречиях @dfn{collisions} в профиле. Противоречия происходят, когда дви или более разных версии или варианта данного пакета присутсвуют в профиле.

note: type: table
en: Use the bootstrap Guile to build the profile.  This option is only useful to distribution developers.
ru: Использовать бутстрап Guile для сборки профиля. Эта опция полезна только разработчикам дистрибутива.

note: type: Plain text
en: In addition to these actions, @command{guix package} supports the following options to query the current state of a profile, or the availability of packages:
ru: В дополнение к этим действиям @command{guix package} поддерживает следующие опции при обращении к текущему состоянию профиля или для проверки доступности пакетов:

note: type: cindex
en: searching for packages
ru: поиск пакетов

note: type: table
en: List the available packages whose name, synopsis, or description matches @var{regexp} (in a case-insensitive fashion), sorted by relevance.  Print all the metadata of matching packages in @code{recutils} format (@pxref{Top, GNU recutils databases,, recutils, GNU recutils manual}).
ru: Вывести список пакетов, чьи имена или описания содержат выражение @var{regexp} с учётом регистра, упорядоченные по соответствию. Печать всех метаданных соответствующих пакетов в формате @code{recutils} (@pxref{Top, GNU recutils databases,, recutils, GNU recutils manual}).

note: type: table
en: This allows specific fields to be extracted using the @command{recsel} command, for instance:
ru: Это позволяет извлекать заданые поля, используя команду @command{recsel}, например:

note: type: table
en: Similarly, to show the name of all the packages available under the terms of the GNU@tie{}LGPL version 3:
ru: Также для отображения имён всех доступных пакетов под лицензией GNU@tie{}LGPL версии 3:

note: type: table
en: It is also possible to refine search results using several @code{-s} flags to @command{guix package}, or several arguments to @command{guix search}.  For example, the following command returns a list of board games (this time using the @command{guix search} alias):
ru: Также можно уточнить поиск, используя несколько флагов @code{-s} в команде @command{guix package} или несколько аргументов в @command{guix search}.  Например, следующая команда возвращает список настольных игр (используя синоним @command{guix search} на этот раз):

note: type: table
en: If we were to omit @code{-s game}, we would also get software packages that deal with printed circuit boards; removing the angle brackets around @code{board} would further add packages that have to do with keyboards.
ru: При пропуске @code{-s game} мы получим пакеты программного обеспечения, которые работают с печатными платами (boards); удалив угловые скобки рядом с @code{board}, получим пакеты, которые также работают с клавиатурами (keyboards).

note: type: table
en: And now for a more elaborate example.  The following command searches for cryptographic libraries, filters out Haskell, Perl, Python, and Ruby libraries, and prints the name and synopsis of the matching packages:
ru: А теперь более запутанный пример. Следующая команда ищет библиотеки криптографии, фильтрует библиотеки Haskel, Perl, Python и Ruby и печатает имена и краткие описания найденных пакетов:

note: type: table
en: @xref{Selection Expressions,,, recutils, GNU recutils manual}, for more information on @dfn{selection expressions} for @code{recsel -e}.
ru: См. @xref{Selection Expressions,,, recutils, GNU recutils manual} для подробной информации о регуларяных выражениях @dfn{selection expressions} для @code{recsel -e}.

note: type: table
en: Show details about @var{package}, taken from the list of available packages, in @code{recutils} format (@pxref{Top, GNU recutils databases,, recutils, GNU recutils manual}).
ru: Показать детали пакета @var{package} из списка доступных пакетов в формате @code{recutils} (@pxref{Top, GNU recutils databases,, recutils, GNU recutils manual}).

note: type: table
en: You may also specify the full name of a package to only get details about a specific version of it (this time using the @command{guix show} alias):
ru: Можно также указать полное имя пакета, чтобы только получить детали его определённой версии (в этот раз, используя @command{guix show} псевдоним):

note: type: table
en: List the currently installed packages in the specified profile, with the most recently installed packages shown last.  When @var{regexp} is specified, list only installed packages whose name matches @var{regexp}.
ru: Вывести текущий список установленных пакетов в заданном профиле, отобразив самый последний установленный пакет последним. Если задано @var{regexp}, будут выведены только пакеты, чьи имена содержат @var{regexp}.

note: type: table
en: For each installed package, print the following items, separated by tabs: the package name, its version string, the part of the package that is installed (for instance, @code{out} for the default output, @code{include} for its headers, etc.), and the path of this package in the store.
ru: Для каждого установленного пакета выводит следующие элементы, разделенные табуляцией (tab): имя пакета, строка версии, частью какого пакета является установленный пакет (например, @code{out} вывода по умолчанию включает @code{include} его заголовки т.д.), а также путь этого пакета на складе.

note: type: table
en: List packages currently available in the distribution for this system (@pxref{GNU Distribution}).  When @var{regexp} is specified, list only available packages whose name matches @var{regexp}.
ru: Вывести список пакетов, доступных на текущий момент в дистрибутиве данной системы (@pxref{GNU Distribution}). Если задано @var{regexp}, выводит только установленные пакеты, чьё имя содержит @var{regexp}.

note: type: table
en: For each package, print the following items separated by tabs: its name, its version string, the parts of the package (@pxref{Packages with Multiple Outputs}), and the source location of its definition.
ru: Для каждого пакета выводит следующие элементы, разделённые табуляцией: его имя, строка версии, часть пакета (@pxref{Packages with Multiple Outputs}), а также расположение его определения в исходниках.

note: type: table
en: Return a list of generations along with their creation dates; for each generation, show the installed packages, with the most recently installed packages shown last.  Note that the zeroth generation is never shown.
ru: Вывести список поколений (generations) с датами их создания; для каждого поколения отобразить установленные пакеты, самый последний установленный пакет отобразать последним. Отметим, что нулевое поколение никогда не показывается.

note: type: table
en: For each installed package, print the following items, separated by tabs: the name of a package, its version string, the part of the package that is installed (@pxref{Packages with Multiple Outputs}), and the location of this package in the store.
ru: Для каждого установленного пакета отображает следующие элементы, разделённые табуляцией: имя пакета, строка версии, частью какого пакета является установленный пакет (@pxref{Packages with Multiple Outputs}), а также расположение пакета на складе.

note: type: table
en: When @var{pattern} is used, the command returns only matching generations.  Valid patterns include:
ru: Если используется @var{pattern}, команда выводит только соответствующие поколения. Правильные паттерны содержат:

note: type: item
en: @emph{Integers and comma-separated integers}.  Both patterns denote
ru: @emph{Числа и числа, разделённые запятыми}. Оба паттерна обозначают

note: type: itemize
en: generation numbers.  For instance, @option{--list-generations=1} returns the first one.
ru: номера поколений. Например, @option{--list-generations=1} возвращает первое.

note: type: itemize
en: And @option{--list-generations=1,8,2} outputs three generations in the specified order.  Neither spaces nor trailing commas are allowed.
ru: Опция @code{--list-generations=1,8,2} выводит три поколения в заданном пордке. Пробелы и запятые на конце запрещены.

note: type: item
en: @emph{Ranges}.  @option{--list-generations=2..9} prints the
ru: @emph{Ranges}.  @option{--list-generations=2..9} выводит

note: type: itemize
en: specified generations and everything in between.  Note that the start of a range must be smaller than its end.
ru: заданные поколения и все между ними. Отметим, что начало диапазона должно быть меньше его конца.

note: type: itemize
en: It is also possible to omit the endpoint.  For example, @option{--list-generations=2..}, returns all generations starting from the second one.
ru: Также можно пропустить конечную точку. Например, @code{--list-generations=2..} возвращает все поколения, начиная со второго.

note: type: item
en: @emph{Durations}.  You can also get the last @emph{N}@tie{}days, weeks,
ru: @emph{Сроки}. Также можно задать последние @emph{N}@tie{}дней, недель

note: type: itemize
en: or months by passing an integer along with the first letter of the duration.  For example, @option{--list-generations=20d} lists generations that are up to 20 days old.
ru: или месяцев, указав число и первую букву срока (d,w,m). Например,  @code{--list-generations=20d} отобразит список поколений старше 20 дней.

note: type: table
en: When @var{pattern} is omitted, delete all generations except the current one.
ru: Если @var{pattern} пропущен, удалит все поголения, кроме текущего.

note: type: table
en: This command accepts the same patterns as @option{--list-generations}.  When @var{pattern} is specified, delete the matching generations.  When @var{pattern} specifies a duration, generations @emph{older} than the specified duration match.  For instance, @option{--delete-generations=1m} deletes generations that are more than one month old.
ru: Эта команда принимает такие же паттерны, как @option{--list-generations}. Если @var{pattern} задан, удалит соответствующие поколения. Если паттерн @var{pattern} задаёт срок, выбираются поколения @emph{старше} срока. Например, @code{--delete-generations=1m} удалит поколения, которые старше одного месяца.

note: type: table
en: If the current generation matches, it is @emph{not} deleted.  Also, the zeroth generation is never deleted.
ru: Если текущее поколение попадает под условия паттерна, оно не будет удалено. А также нулевое поокление никогда не удаляется.

note: type: table
en: Note that deleting generations prevents rolling back to them.  Consequently, this command must be used with care.
ru: Отметим, что удаление поколений делает невозможным откат к ним. Следовательно эта команда должна использоваться внимательно.

note: type: cindex
en: manifest, exporting
ru: манифест, экспорт

note: type: table
en: Write to standard output a manifest suitable for @option{--manifest} corresponding to the chosen profile(s).
ru: Напишите в стандартный вывод манифест, подходящий для @option{--manifest}, соответствующий выбранному профилю (-ам).

note: type: table
en: This option is meant to help you migrate from the ``imperative'' operating mode---running @command{guix install}, @command{guix upgrade}, etc.---to the declarative mode that @option{--manifest} offers.
ru: Эта опция предназначена для того, чтобы помочь вам перейти из ``императивного'' режима работы---запустив @command{guix install}, @command{guix upgrade} и т.д.---в декларативный режим, который предлагает @option{--manifest}.

note: type: table
en: Be aware that the resulting manifest @emph{approximates} what your profile actually contains; for instance, depending on how your profile was created, it can refer to packages or package versions that are not exactly what you specified.
ru: Имейте в виду, что полученный манифест @emph{приблизительно} соответствует тому, что на самом деле содержится в вашем профиле; например, в зависимости от того, как был создан ваш профиль, он может относиться к пакетам или версиям пакетов, которые не совсем то, что вы указали.

note: type: table
en: Keep in mind that a manifest is purely symbolic: it only contains package names and possibly versions, and their meaning varies over time.  If you wish to ``pin'' channels to the revisions that were used to build the profile(s), see @option{--export-channels} below.
ru: Имейте в виду, что манифест является чисто символическим: он содержит только имена пакетов и, возможно, версии, и их значение со временем меняется.  Если вы хотите ``привязать'' каналы к ревизиям, которые использовались для создания профиля (ов), см. @option{--export-channels} ниже.

note: type: cindex
en: pinning, channel revisions of a profile
ru: закрепление, канальные ревизии профиля

note: type: item
en: --export-channels
ru: %default-channels

note: type: table
en: Write to standard output the list of channels used by the chosen profile(s), in a format suitable for @command{guix pull --channels} or @command{guix time-machine --channels} (@pxref{Channels}).
ru: Вывести на стандартный вывод список каналов, используемых выбранным профилем (-ями), в формате, подходящем для @command{guix pull --channels} или @command{guix time-machine --channels} (@pxref{Channels}).

note: type: table
en: Together with @option{--export-manifest}, this option provides information allowing you to replicate the current profile (@pxref{Replicating Guix}).
ru: Вместе с @option{--export-manifest} этот параметр предоставляет информацию, позволяющую копировать текущий профиль (@pxref{Replicating Guix}).

note: type: table
en: However, note that the output of this command @emph{approximates} what was actually used to build this profile.  In particular, a single profile might have been built from several different revisions of the same channel.  In that case, @option{--export-manifest} chooses the last one and writes the list of other revisions in a comment.  If you really need to pick packages from different channel revisions, you can use inferiors in your manifest to do so (@pxref{Inferiors}).
ru: Однако обратите внимание, что выходные данные этой команды @emph{приблизительно} используются для создания этого профиля.  В частности, один профиль мог быть построен из нескольких различных версий одного и того же канала.  В этом случае @option{--export-manifest} выбирает последнюю версию и записывает список других ревизий в комментарий.  Если вам действительно нужно выбрать пакеты из разных ревизий канала, вы можете использовать подчиненные элементы в своем манифесте для этого (@pxref{Inferiors}).

note: type: table
en: Together with @option{--export-manifest}, this is a good starting point if you are willing to migrate from the ``imperative'' model to the fully declarative model consisting of a manifest file along with a channels file pinning the exact channel revision(s) you want.
ru: Если вы хотите перейти от ``императивной'' модели к полностью декларативной модели, состоящей из файла манифеста и файла каналов, закрепляющего точную желаемые версии каналов, то @option{--export-manifest} хорошая отправная точка.

note: type: Plain text
en: Finally, since @command{guix package} may actually start build processes, it supports all the common build options (@pxref{Common Build Options}).  It also supports package transformation options, such as @option{--with-source}, and preserves them across upgrades (@pxref{Package Transformation Options}).
ru: Наконец, так как @command{guix package} может запускать процессы сборки, она поддерживает все привычные опции сборки (@pxref{Common Build Options}). Она также поддерживает опции трансформации пакетов, как @option{--with-source} (@pxref{Package Transformation Options}). Однако, отметим, что трансформации пакетов теряются после обновлений; чтобы сохранить трансформации при обновлениях, нужно определить собственный вариант пакета в модуле Guile и добавить его в @code{GUIX_PACKAGE_PATH} (@pxref{Defining Packages}).

note: type: cindex
en: pre-built binaries
ru: собранные бинарники

note: type: Plain text
en: Guix supports transparent source/binary deployment, which means that it can either build things locally, or download pre-built items from a server, or both.  We call these pre-built items @dfn{substitutes}---they are substitutes for local build results.  In many cases, downloading a substitute is much faster than building things locally.
ru: Guix поддерживает прозрачную развёртку исходников/бинарников, это означает возможность сборки пакетов локально или скачивания собранных элементов с сервера, или и то и другое. Мы называем собранные элементы @dfn{подстановками} (substitutes) --- это подстановки результатов локальных сборок. Часто скасивание подстановки намного быстрее, чем сборка пакетов локально.

note: type: Plain text
en: Substitutes can be anything resulting from a derivation build (@pxref{Derivations}).  Of course, in the common case, they are pre-built package binaries, but source tarballs, for instance, which also result from derivation builds, can be available as substitutes.
ru: В качестве подстановок может выступать какой угодно результат сборки деривации (@pxref{Derivations}). Конечно, обычно это собранные пакеты, но также архивы исходников, например, представляя собой результаты сборок дериваций, могут быть доступны в качестве подстановок.

note: type: cindex
en: build farm
ru: ферма сборки

note: type: Plain text
en: Substitute URLs can be either HTTP or HTTPS.  HTTPS is recommended because communications are encrypted; conversely, using HTTP makes all communications visible to an eavesdropper, who could use the information gathered to determine, for instance, whether your system has unpatched security vulnerabilities.
ru: URL подстановок могут быть либо HTTP, либо HTTPS. Рекомендуется HTTPS, так как такая связь шифруется; и наоборот, использование HTTP делает связь видимой для подслушивающих, и они могут использовать собранную информацию, чтобы определить, например, что ваша система не имеет патчей, покрывающих уязвимости безопасности.

note: type: cindex
en: security
ru: безопасность

note: type: cindex
en: access control list (ACL), for substitutes
ru: список контроля доступом (ACL), для подстановок

note: type: cindex
en: ACL (access control list), for substitutes
ru: ACL (список контроля доступом), для подстановок

note: type: Plain text
en: Once this is in place, the output of a command like @code{guix build} should change from something like:
ru: Когда это сделано, вывод команды @code{guix build} должен измениться с примерно такого:

note: type: Plain text
en: to something like:
ru: на примерно следующий:

note: type: cindex
en: substitutes, how to disable
ru: подстановки, как отключить

note: type: Plain text
en: The substitute mechanism can be disabled globally by running @code{guix-daemon} with @option{--no-substitutes} (@pxref{Invoking guix-daemon}).  It can also be disabled temporarily by passing the @option{--no-substitutes} option to @command{guix package}, @command{guix build}, and other command-line tools.
ru: Механизм подстановок может быть отключен глобально путём запуска @code{guix-daemon} с @code{--no-substitutes} (@pxref{Invoking guix-daemon}). Также он может отключиться временно путём указания опции @code{--no-substitutes} в @command{guix package}, @command{guix build} и других инструментах командной строки.

note: type: cindex
en: substitute servers, adding more
ru: Авторизация сервера подстановок

note: type: Plain text
en: Guix can look up and fetch substitutes from several servers.  This is useful when you are using packages from additional channels for which the official server does not have substitutes but another server provides them.  Another situation where this is useful is when you would prefer to download from your organization's substitute server, resorting to the official server only as a fallback or dismissing it altogether.
ru: Guix может искать и получать заменители с нескольких серверов. Это полезно, когда вы используете пакеты из дополнительных каналов, для которых официальный сервер не имеет заменителей, но их предоставляет другой сервер. Еще одна ситуация, когда это полезно, если вы предпочитаете выполнять загрузку с замещающего сервера вашей организации, прибегая к официальному серверу только в качестве запасного варианта или полностью отклоняя его.

note: type: Plain text
en: You can give Guix a list of substitute server URLs and it will check them in the specified order.  You also need to explicitly authorize the public keys of substitute servers to instruct Guix to accept the substitutes they sign.
ru: Вы можете дать Guix список URL-адресов серверов с заменителями, и он проверит их в указанном порядке. Вам также необходимо явно авторизовать открытые ключи серверов с заменителями, чтобы Guix принял заменители, которые они подписывают.

note: type: Plain text
en: On Guix System, this is achieved by modifying the configuration of the @code{guix} service.  Since the @code{guix} service is part of the default lists of services, @code{%base-services} and @code{%desktop-services}, you can use @code{modify-services} to change its configuration and add the URLs and substitute keys that you want (@pxref{Service Reference, @code{modify-services}}).
ru: В системе Guix это достигается путем изменения конфигурации службы @code{guix}.  Поскольку служба @code{guix} является частью списков служб по умолчанию, @code{%base-services} и @code{%desktop-services}, вы можете использовать @code{modify-services} для изменения ее конфигурации и добавьте нужные URL-адреса и заменить ключи (@pxref{Service Reference, @code{modify-services}}).

note: type: Plain text
en: As an example, suppose you want to fetch substitutes from @code{guix.example.org} and to authorize the signing key of that server, in addition to the default @code{@value{SUBSTITUTE-SERVER-1}} and @code{@value{SUBSTITUTE-SERVER-2}}.  The resulting operating system configuration will look something like:
ru: В качестве примера предположим, что вы хотите получить заменители из @code{guix.example.org} и авторизовать ключ этого сервера в дополнение к @code{@value{SUBSTITUTE-SERVER-1}} и @code{@value{SUBSTITUTE-SERVER-2}}.  Полученная конфигурация операционной системы будет выглядеть примерно так:

note: type: Plain text
en: This assumes that the file @file{key.pub} contains the signing key of @code{guix.example.org}.  With this change in place in your operating system configuration file (say @file{/etc/config.scm}), you can reconfigure and restart the @code{guix-daemon} service or reboot so the changes take effect:
ru: Предполагается, что файл @file{key.pub} содержит ключ подписи @code{guix.example.org}.  После внесения этого изменения в файл конфигурации вашей операционной системы (например, @file{/etc/config.scm}) вы можете перенастроить и перезапустить службу @code{guix-daemon} или перезагрузиться, чтобы изменения вступили в силу:

note: type: Plain text
en: If you're running Guix on a ``foreign distro'', you would instead take the following steps to get substitutes from additional servers:
ru: Если вы используете Guix в качестве пакетного менеджера на другом дистрибутиве, вместо вышеописанного вы должны предпринять следующие шаги, чтобы получить заменители с дополнительных серверов:

note: type: enumerate
en: Edit the service configuration file for @code{guix-daemon}; when using systemd, this is normally @file{/etc/systemd/system/guix-daemon.service}.  Add the @option{--substitute-urls} option on the @command{guix-daemon} command line and list the URLs of interest (@pxref{daemon-substitute-urls, @code{guix-daemon --substitute-urls}}):
ru: Отредактируйте файл конфигурации службы для @code{guix-daemon}; когда исользуете systemd, это обычно @file{/etc/systemd/system/guix-daemon.service}.  Добавьте параметр @option{--substitute-urls} команды @command {guix-daemon} при вызове в командной строке и перечислите интересующие URL-адреса (@pxref{daemon-substitute-urls, @code{guix-daemon --substitute-urls}}):

note: type: enumerate
en: Restart the daemon.  For systemd, it goes like this:
ru: Перезапустите демон.  Пример для systemd:

note: type: enumerate
en: Authorize the key of the new server (@pxref{Invoking guix archive}):
ru: Авторизуйте ключ нового сервера (@pxref{Invoking guix archive}):

note: type: example
en: guix archive --authorize < key.pub
ru: # guix archive --authorize < master-public-key.txt

note: type: enumerate
en: Again this assumes @file{key.pub} contains the public key that @code{guix.example.org} uses to sign substitutes.
ru: Опять же, это предполагает @file{key.pub}, содержащий открытый ключ, который @code{guix.example.org} использует для подписи замененителей.

note: type: Plain text
en: Note that there are also situations where one may want to add the URL of a substitute server @emph{without} authorizing its key.  @xref{Substitute Authentication}, to understand this fine point.
ru: Обратите внимание, что бывают также ситуации, когда можно добавить URL-адрес замещающего сервера @emph{без} авторизации его ключа.  @xref{Substitute Authentication}, чтобы понять этот тонкий момент.

note: type: cindex
en: digital signatures
ru: цифровые подписи

note: type: Plain text
en: Guix detects and raises an error when attempting to use a substitute that has been tampered with.  Likewise, it ignores substitutes that are not signed, or that are not signed by one of the keys listed in the ACL.
ru: Guix определяет и вызывает ошибку, если происходит попытка использовать поддельную подстановку. А также он игнорирует подстановки, которые не подписаны, или те, которые не подписаны ни одним ключом из списка ACL.

note: type: Plain text
en: There is one exception though: if an unauthorized server provides substitutes that are @emph{bit-for-bit identical} to those provided by an authorized server, then the unauthorized server becomes eligible for downloads.  For example, assume we have chosen two substitute servers with this option:
ru: Но всё же есть одно исключение: если не авторизованный сервер предоставляет подстановки, которые являются @emph{идентичными бит-к-биту} с теми, которые предоставляет авторизованный сервер, тогда неавторизованный сервер становится приемлемым для скачивания. Например, положим, мы выбрали два сервера подстановок такой опцией:

note: type: Plain text
en: If the ACL contains only the key for @samp{b.example.org}, and if @samp{a.example.org} happens to serve the @emph{exact same} substitutes, then Guix will download substitutes from @samp{a.example.org} because it comes first in the list and can be considered a mirror of @samp{b.example.org}.  In practice, independent build machines usually produce the same binaries, thanks to bit-reproducible builds (see below).
ru: Если ACL содержит только ключ для @code{b.example.org}, и если вдруг @code{a.example.org} предоставляет @emph{идентичные} подстановки, тогда Guix будет скачивать подстановки из @code{a.example.org}, потому что он идёт первым в списке и может рассматриваться как зеркало @code{b.example.org}. На практике независимые машины сборки обычно производят одинаковые бинарники благодаря воспроизводимым сборкам (смотрите ниже).

note: type: Plain text
en: When using HTTPS, the server's X.509 certificate is @emph{not} validated (in other words, the server is not authenticated), contrary to what HTTPS clients such as Web browsers usually do.  This is because Guix authenticates substitute information itself, as explained above, which is what we care about (whereas X.509 certificates are about authenticating bindings between domain names and public keys).
ru: При использовании HTTPS, сертификат X.509 сервера @emph{не} проверяется (другими словами, сервер не проходит аутентификацию), супротив тому, что HTTPS-клиенты, как веб-браузеры, обычно делают это. Это потому, что Guix аутентифицирует саму информацию подстановки, как это описано выше, что собственно и представляет для нас интерес (в то время, как сертификаты X.509 относятся к аутентификации связок между доменными именами и публичными ключами).

note: type: Plain text
en: Substitutes are downloaded over HTTP or HTTPS@.  The @env{http_proxy} and @env{https_proxy} environment variables can be set in the environment of @command{guix-daemon} and are honored for downloads of substitutes.  Note that the value of those environment variables in the environment where @command{guix build}, @command{guix package}, and other client commands are run has @emph{absolutely no effect}.
ru: Подстановки скачиваются через HTTP или HTTPS. Можно установить переменную окружения @code{http_proxy} в окружении  @command{guix-daemon}, чтобы она учитывалась при скачивании. Отметим, что значение @code{http_proxy} в окружении, в котором запускаются  @command{guix build}, @command{guix package} и другие клиентские команды @emph{совершенно не даёт эффекта}.

note: type: Plain text
en: Even when a substitute for a derivation is available, sometimes the substitution attempt will fail.  This can happen for a variety of reasons: the substitute server might be offline, the substitute may recently have been deleted, the connection might have been interrupted, etc.
ru: Даже когда подстановка для деривации доступна, иногда попытка подстановки завершается неудачно. Это может происходить по разным причинам: сервер подстановок может быть отключен, подстановка могла быть недавно удалена, связь может прерываться и т.д.

note: type: Plain text
en: When substitutes are enabled and a substitute for a derivation is available, but the substitution attempt fails, Guix will attempt to build the derivation locally depending on whether or not @option{--fallback} was given (@pxref{fallback-option,, common build option @option{--fallback}}).  Specifically, if @option{--fallback} was omitted, then no local build will be performed, and the derivation is considered to have failed.  However, if @option{--fallback} was given, then Guix will attempt to build the derivation locally, and the success or failure of the derivation depends on the success or failure of the local build.  Note that when substitutes are disabled or no substitute is available for the derivation in question, a local build will @emph{always} be performed, regardless of whether or not @option{--fallback} was given.
ru: Когда подстановки включены, и подстановка для деривации доступна, но попытка подстановки завершается с ошибкой, Guix будет пытаться собрать деривацию локально в зависимости от того, задана или нет опция @code{--fallback} (@pxref{fallback-option,, common build option @code{--fallback}}). То есть, если @code{--fallback} пропущена, тогда локальная сборка не будет выполняться, а деривация будет рассматриваться как неудачная. Однако, если @code{--fallback} задана, тогда Guix попытается собрать деривацию локально, и успех или неудача деривации будет зависеть от успешной или неудачной процедуры локальной сборки. Отметим, что когда подстановки отключены или нет доступных подстановок для деривации, локальная сборка @emph{всегда} будет исполняться, вне зависимости от установки опции @code{--fallback}.

note: type: Plain text
en: To get an idea of how many substitutes are available right now, you can try running the @command{guix weather} command (@pxref{Invoking guix weather}).  This command provides statistics on the substitutes provided by a server.
ru: Чтобы узнать,. сколько подстановок доступны в данный момент, можно попробовать запустить команду @command{guix weather} (@pxref{Invoking guix weather}). Эта команда предоставляет статистику подстановок, предоставляемых сервером.

note: type: cindex
en: trust, of pre-built binaries
ru: доверие, собранным бинарникам

note: type: Plain text
en: Guix has the foundations to maximize build reproducibility (@pxref{Features}).  In most cases, independent builds of a given package or derivation should yield bit-identical results.  Thus, through a diverse set of independent package builds, we can strengthen the integrity of our systems.  The @command{guix challenge} command aims to help users assess substitute servers, and to assist developers in finding out about non-deterministic package builds (@pxref{Invoking guix challenge}).  Similarly, the @option{--check} option of @command{guix build} allows users to check whether previously-installed substitutes are genuine by rebuilding them locally (@pxref{build-check, @command{guix build --check}}).
ru: Guix определяет цель максимизировать воспроизводимость сборок (@pxref{Features}). В большинстве случаев независимые сборки заданного пакета или деривации должны давать результаты, идентичные до бита. То есть, благодаря ряду независимых сборок пакета мы можем улучшить чистоту наших систем. Команда @command{guix challenge} должна помочь пользователям оценить серверы подстановок, а разработчикам - помочь выявить недетерминистические сборки пакетов (@pxref{Invoking guix challenge}). Подобным образом опция @option{--check} команды @command{guix build} даёт возможность пользователям проверить, яляются ли установленные ранее подстановки подлинными, выполнив их локальную сборку (@pxref{build-check, @command{guix build --check}}).

note: type: Plain text
en: In the future, we want Guix to have support to publish and retrieve binaries to/from other users, in a peer-to-peer fashion.  If you would like to discuss this project, join us on @email{guix-devel@@gnu.org}.
ru: Мы хотим, чтобы Guix в будущем поддерживал публикации и запросы бинарников от/для пользователей в формате равноправного обмена (peer-to-peer). Если вы желаете обсудить этот проект, присоединяйтесь к нам @email{guix-devel@@gnu.org}.

note: type: cindex
en: multiple-output packages
ru: пакеты со множественным результатом

note: type: cindex
en: package outputs
ru: результаты пакета

note: type: cindex
en: outputs
ru: результаты

note: type: Plain text
en: Often, packages defined in Guix have a single @dfn{output}---i.e., the source package leads to exactly one directory in the store.  When running @command{guix install glibc}, one installs the default output of the GNU libc package; the default output is called @code{out}, but its name can be omitted as shown in this command.  In this particular case, the default output of @code{glibc} contains all the C header files, shared libraries, static libraries, Info documentation, and other supporting files.
ru: Часто пакеты, определённые в Guix, имеют один @dfn{выход}, это значит, что исходный пакет даёт только одну директорию на складе. При запуске @command{guix package -i glibc} это устанавливает результат по умолчанию; результат по умолчанию называется @code{выходом}, но его имя может пропускаться, как показано в этой команде. В этом частном случае результат по умолчанию для @code{glibc} содержит все файлы заголовков C, разделяемые библиотеки, статические библиотеки, документацию Info и другие поставляемые файлы.

note: type: Plain text
en: Sometimes it is more appropriate to separate the various types of files produced from a single source package into separate outputs.  For instance, the GLib C library (used by GTK+ and related packages)  installs more than 20 MiB of reference documentation as HTML pages.  To save space for users who do not need it, the documentation goes to a separate output, called @code{doc}.  To install the main GLib output, which contains everything but the documentation, one would run:
ru: Часто более приемлемым будет разделить различные типы файлов, поставляемых одним исходным пакетом, на отдельные выходы (результаты). Например, библиотека GLib C, используемая GTK+ и связанными с ним пакетами, устанавливает более 20Мб связанной документации в виде страниц HTML. Чтобы экономить место, пользователи, которым это не нужно, документацию можно выделить в отдельный выход, называемый @code{doc}. Чтобы установить основной выход GLib, который содерит всё, кроме документации, можно запустить:

note: type: Plain text
en: The command to install its documentation is:
ru: Команда для установки её документации:

note: type: Plain text
en: Some packages install programs with different ``dependency footprints''.  For instance, the WordNet package installs both command-line tools and graphical user interfaces (GUIs).  The former depend solely on the C library, whereas the latter depend on Tcl/Tk and the underlying X libraries.  In this case, we leave the command-line tools in the default output, whereas the GUIs are in a separate output.  This allows users who do not need the GUIs to save space.  The @command{guix size} command can help find out about such situations (@pxref{Invoking guix size}).  @command{guix graph} can also be helpful (@pxref{Invoking guix graph}).
ru: Некоторые пакеты устанавливают программы с различными ``отпечатками зависимостей''.  Например, пакет WordNet устанавливает и инструменты командной строки, и графический интерфейс (GUI).  Первое зависит только от библиотеки C, а последнее зависит от Tcl/Tk и библиотек X.  В таком случае мы оставляем инструменты командной строки в качестве результата по умолчанию, в то время как GUI поставляется как отдельный выход.  Это экономит место для пользователей, которым не нужен GUI.  Команда @command{guix size} может помочь выявить такие ситуации (@pxref{Invoking guix size}).  @command{guix graph} также полезна (@pxref{Invoking guix graph}).

note: type: Plain text
en: There are several such multiple-output packages in the GNU distribution.  Other conventional output names include @code{lib} for libraries and possibly header files, @code{bin} for stand-alone programs, and @code{debug} for debugging information (@pxref{Installing Debugging Files}).  The outputs of a packages are listed in the third column of the output of @command{guix package --list-available} (@pxref{Invoking guix package}).
ru: Есть несколько таких пакетов со множественным выходом в дистрибутиве GNU. Другие традиционные имена выходов включают @code{lib} - для библиотек и иногда файлов заголовков, @code{bin} - для самих программ, @code{debug} - для отладочной информации (@pxref{Installing Debugging Files}). Выходы пакетов представлены в третьей колонке вывода @command{guix package --list-available} (@pxref{Invoking guix package}).

note: type: section
en: Invoking @command{guix gc}
ru: Вызов @command{guix gc}

note: type: cindex
en: garbage collector
ru: сборщик мусора

note: type: cindex
en: disk space
ru: место на диске

note: type: Plain text
en: Packages that are installed, but not used, may be @dfn{garbage-collected}.  The @command{guix gc} command allows users to explicitly run the garbage collector to reclaim space from the @file{/gnu/store} directory.  It is the @emph{only} way to remove files from @file{/gnu/store}---removing files or directories manually may break it beyond repair!
ru: Пакеты, которые установлены, но не используются, могут быть очищены как мусор (@dfn{garbage-collected}).  Команда @command{guix gc} позволяет пользователям непосредственно запустить сборщик мусора и восстановить место в директории @file{/gnu/store}. Это @emph{единственный} способ удалить файлы из @file{/gnu/store} --- удаление файлов вручную может поломать её безвозвратно!

note: type: Plain text
en: The garbage collector has a set of known @dfn{roots}: any file under @file{/gnu/store} reachable from a root is considered @dfn{live} and cannot be deleted; any other file is considered @dfn{dead} and may be deleted.  The set of garbage collector roots (``GC roots'' for short)  includes default user profiles; by default, the symlinks under @file{/var/guix/gcroots} represent these GC roots.  New GC roots can be added with @command{guix build --root}, for example (@pxref{Invoking guix build}).  The @command{guix gc --list-roots} command lists them.
ru: Сборщик мусора имеет набор известных корней (@dfn{roots}): любой файл в @file{/gnu/store}, доступный из корня, рассматривается как живой (@dfn{live}) и не может быть удалён; любой другой файл рассматривается как мёртвый (@dfn{dead}) и может быть удалён. Набор корней сборщика мусора (сокращённо "GC roots") содержит профили пользователей по умолчанию; по умолчанию символические ссылки в @file{/var/guix/gcroots} представляют эти корни сборщика мусора. Новые корни могут добавляться, например, командой @command{guix build --root} (@pxref{Invoking guix build}). Команда @command{guix gc --list-roots} отображает их.

note: type: Plain text
en: Prior to running @code{guix gc --collect-garbage} to make space, it is often useful to remove old generations from user profiles; that way, old package builds referenced by those generations can be reclaimed.  This is achieved by running @code{guix package --delete-generations} (@pxref{Invoking guix package}).
ru: Перед запуском @code{guix gc --collect-garbage} для освобождения места часто бывает полезно удалить старые поколения из пользовательских профилей; так старые пакеты, относящиеся к этим поколениям, будут удалены. Это можно сделать, запустив @code{guix package --delete-generations} (@pxref{Invoking guix package}).

note: type: Plain text
en: Our recommendation is to run a garbage collection periodically, or when you are short on disk space.  For instance, to guarantee that at least 5@tie{}GB are available on your disk, simply run:
ru: Мы рекомендуем запускать сборщик мусора периодически, или когда вы хотите освободить место на диске. Например, чтобы гарантировать, что по меньшей мере 5@tie{}Гб будет доступно на вашем диске, просто запустите:

note: type: Plain text
en: It is perfectly safe to run as a non-interactive periodic job (@pxref{Scheduled Job Execution}, for how to set up such a job).  Running @command{guix gc} with no arguments will collect as much garbage as it can, but that is often inconvenient: you may find yourself having to rebuild or re-download software that is ``dead'' from the GC viewpoint but that is necessary to build other pieces of software---e.g., the compiler tool chain.
ru: Хорошо бы запускать это как неинтерактивную периодическую задачу (@pxref{Scheduled Job Execution}, чтобы узнать, как добавить такую задачу). Запуск @command{guix gc} без аргументов соберёт столько мусора, сколько возможно, но это часто не удобно: можно обнаружить, что придётся заново собирать или скачивать программы, "убитые" сборщиком мусора, хотя они необходимы для сборки другого софта, например, это касается инструментов компилятора.

note: type: Plain text
en: The @command{guix gc} command has three modes of operation: it can be used to garbage-collect any dead files (the default), to delete specific files (the @option{--delete} option), to print garbage-collector information, or for more advanced queries.  The garbage collection options are as follows:
ru: Команда @command{guix gc} предоставляет три способа взаимодействия: может использоваться для сборки мусора (garbage-collect) любых мёртвых файлов (по умолчанию), для удаления конкретных файлов (опция @code{--delete}), для вывода информации сборщика мусора, а также для более изощрённых запросов. Опции сборщика мусора:

note: type: table
en: Collect garbage---i.e., unreachable @file{/gnu/store} files and sub-directories.  This is the default operation when no option is specified.
ru: Собрать мусор, то есть недоступные файлы в @file{/gnu/store} и поддиректориях. Это операция по умолчанию, если не заданы опции.

note: type: table
en: When @var{min} is given, stop once @var{min} bytes have been collected.  @var{min} may be a number of bytes, or it may include a unit as a suffix, such as @code{MiB} for mebibytes and @code{GB} for gigabytes (@pxref{Block size, size specifications,, coreutils, GNU Coreutils}).
ru: Если задана @var{min}, остановиться, когда @var{min} байт собрано.  @var{min} может быть числом байт или может содержать единицу измерения в суффиксе, как например, @code{MiB} для мебибайт и @code{GB} гигабайт (@pxref{Block size, size specifications,, coreutils, GNU Coreutils}).

note: type: table
en: When @var{min} is omitted, collect all the garbage.
ru: Если @var{min} пропущено, собрать весь мусор.

note: type: table
en: Collect garbage until @var{free} space is available under @file{/gnu/store}, if possible; @var{free} denotes storage space, such as @code{500MiB}, as described above.
ru: Собирать мусор, пока не станет доступно @var{free} места в @file{/gnu/store}, если возможно; @var{free} описывает дисковое пространство, как @code{500MiB}, как это описанов выше.

note: type: table
en: When @var{free} or more is already available in @file{/gnu/store}, do nothing and exit immediately.
ru: Когда @var{free} или более места стало свободно в @file{/gnu/store}, ничего не делать и немедленно выйти.

note: type: table
en: For example, this command deletes all the generations of all your profiles that are older than 2 months (except generations that are current), and then proceeds to free space until at least 10 GiB are available:
ru: Например, следующая команда удаляет все поколения всех ваших профилей, которые старше 2 месцев (кроме текущего поколения), а затем запускается процесс освобождения мместа, пока по меньшей мере 10 GiB не станет доступно:

note: type: table
en: Attempt to delete all the store files and directories specified as arguments.  This fails if some of the files are not in the store, or if they are still live.
ru: Попытаться удалить все файлы и директории склада, приведённые в аргументах. Это завершается с ошибкой, если какие-либо файлы не присутствуют на складе, или если они ещё живы (live).

note: type: table
en: List store items corresponding to cached build failures.
ru: Вывести список элементов склада, которые относятся к кешированным неудачным сборкам.

note: type: table
en: This prints nothing unless the daemon was started with @option{--cache-failures} (@pxref{Invoking guix-daemon, @option{--cache-failures}}).
ru: Это ничего не выводит, если демон не был запущен с опцией @option{--cache-failures} (@pxref{Invoking guix-daemon, @option{--cache-failures}}).

note: type: table
en: List the GC roots owned by the user; when run as root, list @emph{all} the GC roots.
ru: Вывести список корней сборщика мусора (GC roots), которыми владеет пользователь; при запуске от root, выводит список @emph{всех} корней сборщика мусора.

note: type: table
en: List store items in use by currently running processes.  These store items are effectively considered GC roots: they cannot be deleted.
ru: Составляет список элементов хранилица, исользуемых запущенными в данное время процессами. Эти элементы считаются корнями GC: они не могут быть удалены.

note: type: table
en: Remove the specified store items from the failed-build cache.
ru: Удалить заданные элементы склада из кеша неудачных сборок.

note: type: table
en: Again, this option only makes sense when the daemon is started with @option{--cache-failures}.  Otherwise, it does nothing.
ru: Опять же эта опция имеет смысл, если демон запущен с @option{--cache-failures}. В противном случае это не имеет эффекта.

note: type: table
en: Show the list of dead files and directories still present in the store---i.e., files and directories no longer reachable from any root.
ru: Вывести список мёртвых файлов и директорий, которые по-прежнему присутствуют на складе, то есть файлы и директории, не доступные более из любого корня.

note: type: table
en: Show the list of live store files and directories.
ru: Вывести список живых файлов и директорий склада.

note: type: Plain text
en: In addition, the references among existing store files can be queried:
ru: В дополнение можно запросить связи между существующими файлами на складе:

note: type: cindex
en: package dependencies
ru: зависимости пакетов

note: type: table
en: List the references (respectively, the referrers) of store files given as arguments.
ru: Вывести список связанных (обязательно, ссылающихся) файлов на складе с указанными аргументами.

note: type: item
en: closure
ru: конвейер

note: type: table
en: List the requisites of the store files passed as arguments.  Requisites include the store files themselves, their references, and the references of these, recursively.  In other words, the returned list is the @dfn{transitive closure} of the store files.
ru: Вывести всё необходимое для файлов на складе, указанных в аргументах. Всё необходимое включает сами файлы на складе, их связи и связи их связей рекурсивно. Другими словами, выводимый список --- это @dfn{непосредственный конвейер} файлов на складе.

note: type: table
en: @xref{Invoking guix size}, for a tool to profile the size of the closure of an element.  @xref{Invoking guix graph}, for a tool to visualize the graph of references.
ru: См. @xref{Invoking guix size} для информации об инструменте профилирования конвейера для элемента. См. @xref{Invoking guix graph} для информации об инструменте визуализации графа связей.

note: type: item
en: derivation
ru: деривация

note: type: table
en: Return the derivation(s) leading to the given store items (@pxref{Derivations}).
ru: Вернуть деривацию(-ии), производящие данные элементы склада (@pxref{Derivations}).

note: type: table
en: For example, this command:
ru: Например, эта команда:

note: type: example
en: guix gc --derivers $(guix package -I ^emacs$ | cut -f4)
ru: guix gc --derivers `guix package -I ^emacs$ | cut -f4`

note: type: table
en: returns the @file{.drv} file(s) leading to the @code{emacs} package installed in your profile.
ru: возвращает файл(ы) @file{.drv}, которые произвели пакет @code{emacs}, установленный в вашем профиле.

note: type: table
en: Note that there may be zero matching @file{.drv} files, for instance because these files have been garbage-collected.  There can also be more than one matching @file{.drv} due to fixed-output derivations.
ru: Отметим, что может быть не найдено ни одного файла @file{.drv}, например, потому что эти файлы были удалены сборщиком мусора. Также может быть более одного файла @file{.drv} из-за дериваций с фиксированным выходом.

note: type: Plain text
en: Lastly, the following options allow you to check the integrity of the store and to control disk usage.
ru: Наконец, следующие опции позволяют проверить целостность склада и контролировать использование диска.

note: type: cindex
en: integrity, of the store
ru: целостность, склада

note: type: cindex
en: integrity checking
ru: проверка целостности

note: type: table
en: Verify the integrity of the store.
ru: Проверить целостность склада.

note: type: table
en: By default, make sure that all the store items marked as valid in the database of the daemon actually exist in @file{/gnu/store}.
ru: По умолчанию убедиться, что все элементы склада, которые в базе данных демона помечены как действующие, на самом деле присутствуют в @file{/gnu/store}.

note: type: table
en: When provided, @var{options} must be a comma-separated list containing one or more of @code{contents} and @code{repair}.
ru: Опции @var{options}, если они указаны, должны представлять собой список, разделённый запятыми, содержащий одно или более значений @code{contents} и @code{repair}.

note: type: table
en: When passing @option{--verify=contents}, the daemon computes the content hash of each store item and compares it against its hash in the database.  Hash mismatches are reported as data corruptions.  Because it traverses @emph{all the files in the store}, this command can take a long time, especially on systems with a slow disk drive.
ru: Если задано @option{--verify=contents}, демон вычисляет хеш содержимого каждого элемента склада и сравнивает с его хешем в базе данных. Несовпадения хеша отображаются в отчёте как повреждение данных. Так как она проходит @emph{все файлы склада}, эта команда может занять много времени, особенно в системах с медленным диском.

note: type: cindex
en: repairing the store
ru: восстановление склада

note: type: cindex
en: corruption, recovering from
ru: разрушение, его восстановление

note: type: table
en: Using @option{--verify=repair} or @option{--verify=contents,repair} causes the daemon to try to repair corrupt store items by fetching substitutes for them (@pxref{Substitutes}).  Because repairing is not atomic, and thus potentially dangerous, it is available only to the system administrator.  A lightweight alternative, when you know exactly which items in the store are corrupt, is @command{guix build --repair} (@pxref{Invoking guix build}).
ru: Использование @option{--verify=repair} или @option{--verify=contents,repair} указывает демону предпринять попытку восстановить разрушенные элементы склада, выбирая подстановки для них (@pxref{Substitutes}). Так как восстановление не атомарное, и поэтому потенциально опасно, оно доступно только системному администратору. Малозатратная альтернатива в случае, если вы знаете точно, какие элементы склада испорчены, --- это @command{guix build --repair} (@pxref{Invoking guix build}).

note: type: table
en: Optimize the store by hard-linking identical files---this is @dfn{deduplication}.
ru: Оптимизировать склад с помощью жёстких ссылок на идентичные файлы --- это @dfn{дедупликация}.

note: type: table
en: The daemon performs deduplication after each successful build or archive import, unless it was started with @option{--disable-deduplication} (@pxref{Invoking guix-daemon, @option{--disable-deduplication}}).  Thus, this option is primarily useful when the daemon was running with @option{--disable-deduplication}.
ru: Демон выполняет дедупликацию после каждой успешной сборки или импорта архива, если конечно оно не было запущено с @code{--disable-deduplication} (@pxref{Invoking guix-daemon, @code{--disable-deduplication}}). Так что эта опция особенно важна, если демон запущено с @code{--disable-deduplication}.

note: type: section
en: Invoking @command{guix pull}
ru: Вызов @command{guix pull}

note: type: cindex
en: upgrading Guix
ru: обновление версии Guix

note: type: cindex
en: updating Guix
ru: обновление Guix

note: type: cindex
en: pull
ru: получение

note: type: cindex
en: security, @command{guix pull}
ru: sudo vs. @command{guix pull}

note: type: cindex
en: authenticity, of code obtained with @command{guix pull}
ru: перемещаемые бинарники, с @command{guix pack}

note: type: Plain text
en: Specifically, @command{guix pull} downloads code from the @dfn{channels} (@pxref{Channels}) specified by one of the followings, in this order:
ru: В частности, @command{guix pull} загружает код из @dfn{channel} (@pxref{Channels}), указанного одним из следующих способов, в следующем порядке:

note: type: enumerate
en: the @option{--channels} option;
ru: опция @option{--channels};

note: type: enumerate
en: the user's @file{~/.config/guix/channels.scm} file;
ru: пользовательский файл @file{~/.config/guix/channels.scm};

note: type: enumerate
en: the system-wide @file{/etc/guix/channels.scm} file;
ru: общесистемный файл @file{/etc/guix/channels.scm} file;

note: type: enumerate
en: the built-in default channels specified in the @code{%default-channels} variable.
ru: встроенные по умолчанию каналы определены в переменной @code{%default-channels}.

note: type: Plain text
en: On completion, @command{guix package} will use packages and package versions from this just-retrieved copy of Guix.  Not only that, but all the Guix commands and Scheme modules will also be taken from that latest version.  New @command{guix} sub-commands added by the update also become available.
ru: После выполнения этой команды @command{guix package} будет использовать пакеты и те их версии, которые имеются в только что полученной копии Guix. Эта последняя версия будет источником также всех команд Guix, модулей Scheme. Из этого обновления станет доступен набор команд @command{guix}.

note: type: Plain text
en: Any user can update their Guix copy using @command{guix pull}, and the effect is limited to the user who ran @command{guix pull}.  For instance, when user @code{root} runs @command{guix pull}, this has no effect on the version of Guix that user @code{alice} sees, and vice versa.
ru: Любой пользователь может обновить свою копию Guix, используя @command{guix pull}, эффект коснётся только пользователя, который запустил @command{guix pull}. Например, если пользователь @code{root} запускает @command{guix pull}, это не имеет эффекта на версию Guix, которую видит @code{alice} sees, и наоборот.

note: type: Plain text
en: The result of running @command{guix pull} is a @dfn{profile} available under @file{~/.config/guix/current} containing the latest Guix.  Thus, make sure to add it to the beginning of your search path so that you use the latest version, and similarly for the Info manual (@pxref{Documentation}):
ru: Результат запуска @command{guix pull} --- это профиль @dfn{profile}, доступный в @file{~/.config/guix/current}, содержащий последний Guix. Так что обязательно добавьте этот адрес первым в пути поиска, чтобы использовать последнюю версию, а также для руководства Info (@pxref{Documentation}):

note: type: Plain text
en: The @option{--list-generations} or @option{-l} option lists past generations produced by @command{guix pull}, along with details about their provenance:
ru: Опция @code{--list-generations} или @code{-l} выводит список последних поколений, поставленных @command{guix pull}, вместе с деталями об их происхождении:

note: type: Plain text
en: @xref{Invoking guix describe, @command{guix describe}}, for other ways to describe the current status of Guix.
ru: Смотрите @xref{Invoking guix describe, @command{guix describe}}, для информации о других способах получить информацию о текущем статусе Guix.

note: type: Plain text
en: This @code{~/.config/guix/current} profile works exactly like the profiles created by @command{guix package} (@pxref{Invoking guix package}).  That is, you can list generations, roll back to the previous generation---i.e., the previous Guix---and so on:
ru: Этот профиль @code{~/.config/guix/current} работает, как любой другой профиль, созданный @command{guix package} (@pxref{Invoking guix package}). Так что можно вывести список поколений, откатиться до предыдущего поколения, то есть до предыдущего Guix, и так далее:

note: type: example
en: $ guix pull --roll-back
    switched from generation 3 to 2
    $ guix pull --delete-generations=1
    deleting /var/guix/profiles/per-user/charlie/current-guix-1-link
ru: $ 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/charlie/current-guix-1-link

note: type: Plain text
en: You can also use @command{guix package} (@pxref{Invoking guix package})  to manage the profile by naming it explicitly:
ru: Вы также можете использовать @command{guix package} (@pxref{Invoking guix package}),  чтобы управлять профилем, называя его явно:

note: type: Plain text
en: The @command{guix pull} command is usually invoked with no arguments, but it supports the following options:
ru: Команда @command{guix pull} обычно вызывается без аргументов, но поддерживает следующие опции:

note: type: cindex
en: configuration file for channels
ru: конфигурационный файл для каналов

note: type: table
en: These options are provided for convenience, but you can also specify your configuration in the @file{~/.config/guix/channels.scm} file or using the @option{--channels} option (see below).
ru: Эти опции внедрены для удобства, но также можно задать конфигурационный файл @file{~/.config/guix/channels.scm} или использовать опцию @option{--channels} (смотрите ниже).

note: type: table
en: Read the list of channels from @var{file} instead of @file{~/.config/guix/channels.scm} or @file{/etc/guix/channels.scm}.  @var{file} must contain Scheme code that evaluates to a list of channel objects.  @xref{Channels}, for more information.
ru: Считать список каналов из файла @var{file} вместо @file{~/.config/guix/channels.scm}. @var{file} должен содержать код Scheme, который определяет список объектов "канал". См.  @xref{Channels} для подробной информации.

note: type: cindex
en: channel news
ru: каналы

note: type: table
en: List all the generations of @file{~/.config/guix/current} or, if @var{pattern} is provided, the subset of generations that match @var{pattern}.  The syntax of @var{pattern} is the same as with @code{guix package --list-generations} (@pxref{Invoking guix package}).
ru: Вывести список всех поколений @file{~/.config/guix/current} или, если предоставлен паттерн @var{pattern}, подмножество поколений, которые соответствуют @var{pattern}. Синтаксис @var{pattern} --- такой же, как у @code{guix package --list-generations} (@pxref{Invoking guix package}).

note: type: table
en: Roll back to the previous @dfn{generation} of @file{~/.config/guix/current}---i.e., undo the last transaction.
ru: Откатиться до предыдущего @dfn{поколения} профиля, то есть отменить последнюю транзакцию.

note: type: table
en: If the current generation matches, it is @emph{not} deleted.
ru: Если текущее поколение попадает под условия паттерна, оно не будет удалено. А также нулевое поокление никогда не удаляется.

note: type: table
en: @xref{Invoking guix describe}, for a way to display information about the current generation only.
ru: См. @xref{Invoking guix describe}, чтобы узнать, как вывести информацию только о текущем поколении.

note: type: table
en: Use @var{profile} instead of @file{~/.config/guix/current}.
ru: Использовать профиль @var{profile} вместо @file{~/.config/guix/current}.

note: type: table
en: Show which channel commit(s) would be used and what would be built or substituted but do not actually do it.
ru: Показать, какие коммиты будут использоваться, и что будет собрано или скачано в виде подстановок, но не выполнять эту работу.

note: type: table
en: Allow pulling older or unrelated revisions of channels than those currently in use.
ru: Разрешить загружать более старые или несвязанные версии каналов, чем те, которые используются в настоящее время.

note: type: cindex
en: downgrade attacks, protection against
ru: атаки на понижение версии, защита от

note: type: table
en: By default, @command{guix pull} protects against so-called ``downgrade attacks'' whereby the Git repository of a channel would be reset to an earlier or unrelated revision of itself, potentially leading you to install older, known-vulnerable versions of software packages.
ru: По умолчанию @command{guix pull} защищает от так называемых ``атак на более раннюю версию'', когда репозиторий Git данного канала будет сброшен до более ранней или несвязанной версии, что может привести к установке более старых, известных уязвимых версий пакетов.

note: type: quotation
en: Make sure you understand its security implications before using @option{--allow-downgrades}.
ru: Прежде чем использовать @option{--allow-downgrades}, убедитесь, что вы понимаете его последствия для безопасности.

note: type: table
en: Allow pulling channel code without authenticating it.
ru: Разрешить загрузку канала без его аутентификации.

note: type: cindex
en: authentication, of channel code
ru: аутентификация для проверки Guix

note: type: table
en: By default, @command{guix pull} authenticates code downloaded from channels by verifying that its commits are signed by authorized developers, and raises an error if this is not the case.  This option instructs it to not perform any such verification.
ru: По умолчанию @command{guix pull} аутентифицирует код, загруженный из каналов, проверяя, что его коммиты подписаны авторизованными разработчиками, и выдает ошибку, если это не так.  Эта опция дает указание не выполнять такую проверку.

note: type: quotation
en: Make sure you understand its security implications before using @option{--disable-authentication}.
ru: Прежде чем использовать @option{--disable-authentication}, убедитесь, что вы понимаете его последствия для безопасности.

note: type: table
en: Attempt to build for @var{system}---e.g., @code{i686-linux}---instead of the system type of the build host.
ru: Предпринять попытку собрать систему @var{system}, т.е. @code{i686-linux}, вместо типа системы хоста сборки.

note: type: table
en: Use the bootstrap Guile to build the latest Guix.  This option is only useful to Guix developers.
ru: Использовать бутстрап Guile для сорки последнего Guix. Эта опция полезна только для разработчиков.

note: type: Plain text
en: The @dfn{channel} mechanism allows you to instruct @command{guix pull} which repository and branch to pull from, as well as @emph{additional} repositories containing package modules that should be deployed.  @xref{Channels}, for more information.
ru: Механизм каналов @dfn{channel} позволяет указать @command{guix pull}, из какого репозитория или ветки скачивать, а также какие @emph{дополнительные} репозитории должны использоваться для развёртки. См. @xref{Channels} для подробной информации.

note: type: Plain text
en: In addition, @command{guix pull} supports all the common build options (@pxref{Common Build Options}).
ru: В добавок @command{guix pull} поддерживает все стандартные опции сборки (@pxref{Common Build Options}).

note: type: section
en: Invoking @command{guix time-machine}
ru: Запуск @command{guix time-machine}

note: type: cindex
en: pinning, channels
ru: связывание, каналы

note: type: cindex
en: replicating Guix
ru: копирование Guix

note: type: cindex
en: reproducibility, of Guix
ru: воспроизводимость, Guix

note: type: Plain text
en: The @command{guix time-machine} command provides access to other revisions of Guix, for example to install older versions of packages, or to reproduce a computation in an identical environment.  The revision of Guix to be used is defined by a commit or by a channel description file created by @command{guix describe} (@pxref{Invoking guix describe}).
ru: Команда @command{guix time-machine} предоставляет доступ к другим версиям Guix, например, для установки более старых версий пакетов или для воспроизведения вычислений в идентичной среде. Версия используемого Guix определяется коммитом или файлом описания канала, созданным @command{guix describe} (@pxref{Invoking guix describe}).

note: type: Plain text
en: The general syntax is:
ru: Основной синтаксис:

note: type: example
en: guix time-machine @var{options}@dots{} -- @var{command} @var {arg}@dots{}
ru: guix time-machine @var{options}@dots{} -- @var{command} @var{arg}@dots{}

note: type: Plain text
en: where @var{command} and @var{arg}@dots{} are passed unmodified to the @command{guix} command of the specified revision.  The @var{options} that define this revision are the same as for @command{guix pull} (@pxref{Invoking guix pull}):
ru: где @var{command} и @var{arg}@dots{} передаются без изменений в команду @command{guix} указанной ревизии. @var{options}, которые определяют эту ревизию, такие же, как и для @command{guix pull} (@pxref{Invoking guix pull}):

note: type: table
en: Read the list of channels from @var{file}.  @var{file} must contain Scheme code that evaluates to a list of channel objects.  @xref{Channels} for more information.
ru: Считать список каналов из файла @var{file} вместо @file{~/.config/guix/channels.scm}. @var{file} должен содержать код Scheme, который определяет список объектов "канал". См.  @xref{Channels} для подробной информации.

note: type: Plain text
en: As for @command{guix pull}, the absence of any options means that the latest commit on the master branch will be used.  The command
ru: Что касается @command{guix pull}, то отсутствие каких-либо опций означает, что будет использоваться последний коммит в основной ветке. Команда

note: type: Plain text
en: will thus build the package @code{hello} as defined in the master branch, which is in general a newer revision of Guix than you have installed.  Time travel works in both directions!
ru: таким образом, мы соберем пакет @code{hello}, как определено в основной ветке, которая, как правило, является более новой версией Guix, чем вы установили. Путешествие во времени работает в обоих направлениях!

note: type: Plain text
en: Note that @command{guix time-machine} can trigger builds of channels and their dependencies, and these are controlled by the standard build options (@pxref{Common Build Options}).
ru: Если указанные пакеты ещё не собраны, @command{guix archive} автоматически соберёт их. Процесс сборки может контролироваться обычными опциями сборки (@pxref{Common Build Options}).

note: type: quotation
en: The functionality described here is a ``technology preview'' as of version @value{VERSION}.  As such, the interface is subject to change.
ru: Функциональность, описанная здесь, --- это обзор технологии версии @value{VERSION}. Интерфейс может меняться.

note: type: cindex
en: inferiors
ru: ранние версии

note: type: cindex
en: composition of Guix revisions
ru: составление ревизий Guix

note: type: Plain text
en: Sometimes you might need to mix packages from the revision of Guix you're currently running with packages available in a different revision of Guix.  Guix @dfn{inferiors} allow you to achieve that by composing different Guix revisions in arbitrary ways.
ru: Иногда вам может понадобиться перемешивать пакеты из ревизии Guix, которая работает в настоящий момент, с пакетами, доступными в другой ревизии Guix. Основания Guix @dfn{inferiors} позволяют вам получить это, составляя различные ревизии Guix произвольным образом.

note: type: cindex
en: inferior packages
ru: пакеты ранних версий

note: type: Plain text
en: Technically, an ``inferior'' is essentially a separate Guix process connected to your main Guix process through a REPL (@pxref{Invoking guix repl}).  The @code{(guix inferior)} module allows you to create inferiors and to communicate with them.  It also provides a high-level interface to browse and manipulate the packages that an inferior provides---@dfn{inferior packages}.
ru: Технически работа с ранними версиями --- это в целом отдельный процесс Guix, связанный с главным процессом Guix через REPL (@pxref{Invoking guix repl}). Модуль @code{(guix inferior)} позволяет запускать ранние версии и взаимодействовать с ними. Он также предоставляет высокоуровневый интерфейс для обзора и управления пакетами, которые поставляет ранняя версия --- @dfn{ранние версии пакетов}.

note: type: Plain text
en: On its first run, @command{guix package --manifest} might have to build the channel you specified before it can create the inferior; subsequent runs will be much faster because the Guix revision will be cached.
ru: Далее запуск @command{guix package --manifest} может вызвать сборку канала, который вы обозначили ранее, и в результате это задействует раннюю версию. Последовательные запуски будут быстрее, потому что ревизия Guix будет кеширована.

note: type: Plain text
en: The @code{(guix inferior)} module provides the following procedures to open an inferior:
ru: Модуль @code{(guix inferior)} предоставляет следующие процедуры для работы с ранними версиями:

note: type: deffn
en: {Scheme Procedure} inferior-for-channels @var{channels} @
ru: {Процедура Scheme} inferior-for-channels @var{channels} @

note: type: deffn
en: [#:cache-directory] [#:ttl] Return an inferior for @var{channels}, a list of channels.  Use the cache at @var{cache-directory}, where entries can be reclaimed after @var{ttl} seconds.  This procedure opens a new connection to the build daemon.
ru: [#:cache-directory] [#:ttl] Возвращает раннюю версию для списка каналов @var{channels}.  Использует кеш в @var{cache-directory}, где компоненты могут восстанавливаться через @var{ttl} секунд. Эта процедура открывает новое соединение с демоном сборки.

note: type: deffn
en: As a side effect, this procedure may build or substitute binaries for @var{channels}, which can take time.
ru: Как побочный эффект, эта процедура может собирать или скачивать подстановки бинарников для @var{channels}, что может занять время.

note: type: deffn
en: {Scheme Procedure} open-inferior @var{directory} @
ru: {Процедура Scheme} open-inferior @var{directory} @

note: type: deffn
en: [#:command "bin/guix"] Open the inferior Guix in @var{directory}, running @code{@var{directory}/@var{command} repl} or equivalent.  Return @code{#f} if the inferior could not be launched.
ru: [#:command "bin/guix"] Открывает раннюю версию Guix в @var{directory}, запустив repl @code{@var{directory}/@var{command}} или эквивалент. Возвращает @code{#f}, если ранняя версия не может быть запущена.

note: type: Plain text
en: The procedures listed below allow you to obtain and manipulate inferior packages.
ru: Процедуры, приведённые ниже, обеспечивают работу и управление ранними версиями пакетов.

note: type: deffn
en: {Scheme Procedure} inferior-packages @var{inferior}
ru: {Процедура Scheme} inferior-packages @var{inferior}

note: type: deffn
en: Return the list of packages known to @var{inferior}.
ru: Возвращает список пакетов, относящихся к ранней версии @var{inferior}.

note: type: deffn
en: {Scheme Procedure} lookup-inferior-packages @var{inferior} @var{name} @
ru: {Процедура Scheme} lookup-inferior-packages @var{inferior} @var{name} @

note: type: deffn
en: [@var{version}] Return the sorted list of inferior packages matching @var{name} in @var{inferior}, with highest version numbers first.  If @var{version} is true, return only packages with a version number prefixed by @var{version}.
ru: [@var{version}] Возвращает сортированный список пакетов ранней версии  @var{inferior}, содержащих имя @var{name}, поздняя версия - вначале. Если версия @var{version} задана, возвращает только пакеты с номером версии, начинающейся с @var{version}.

note: type: deffn
en: {Scheme Procedure} inferior-package? @var{obj}
ru: {Процедура Scheme} inferior-package? @var{obj}

note: type: deffn
en: Return true if @var{obj} is an inferior package.
ru: Возвращает true, если объект @var{obj} --- это пакет ранней версии.

note: type: deffn
en: {Scheme Procedure} inferior-package-name @var{package}
ru: {Процедура Scheme} inferior-package-name @var{package}

note: type: deffnx
en: {Scheme Procedure} inferior-package-version @var{package}
ru: {Процедура Scheme} inferior-package-version @var{package}

note: type: deffnx
en: {Scheme Procedure} inferior-package-synopsis @var{package}
ru: {Процедура Scheme} inferior-package-synopsis @var{package}

note: type: deffnx
en: {Scheme Procedure} inferior-package-description @var{package}
ru: {Процедура Scheme} inferior-package-description @var{package}

note: type: deffnx
en: {Scheme Procedure} inferior-package-home-page @var{package}
ru: {Процедура Scheme} inferior-package-home-page @var{package}

note: type: deffnx
en: {Scheme Procedure} inferior-package-location @var{package}
ru: {Процедура Scheme} inferior-package-location @var{package}

note: type: deffnx
en: {Scheme Procedure} inferior-package-inputs @var{package}
ru: {Процедура Scheme} inferior-package-inputs @var{package}

note: type: deffnx
en: {Scheme Procedure} inferior-package-native-inputs @var{package}
ru: {Процедура Scheme} inferior-package-native-inputs @var{package}

note: type: deffnx
en: {Scheme Procedure} inferior-package-propagated-inputs @var{package}
ru: {Процедура Scheme} inferior-package-propagated-inputs @var{package}

note: type: deffnx
en: {Scheme Procedure} inferior-package-transitive-propagated-inputs @var{package}
ru: {Процедура Scheme} inferior-package-transitive-propagated-inputs @var{package}

note: type: deffnx
en: {Scheme Procedure} inferior-package-native-search-paths @var{package}
ru: {Процедура Scheme} inferior-package-native-search-paths @var{package}

note: type: deffnx
en: {Scheme Procedure} inferior-package-transitive-native-search-paths @var{package}
ru: {Процедура Scheme} inferior-package-transitive-native-search-paths @var{package}

note: type: deffnx
en: {Scheme Procedure} inferior-package-search-paths @var{package}
ru: {Процедура Scheme} inferior-package-search-paths @var{package}

note: type: deffn
en: These procedures are the counterpart of package record accessors (@pxref{package Reference}).  Most of them work by querying the inferior @var{package} comes from, so the inferior must still be live when you call these procedures.
ru: Эти процедуры являются двойниками метода доступа к записям пакетов (@pxref{package Reference}). Большинство из них работают с запросами для ранней версии, из которой происходит @var{package}, так что ранняя версия должна оставаться живой, когда вы вызываете эти процедуры.

note: type: Plain text
en: Inferior packages can be used transparently like any other package or file-like object in G-expressions (@pxref{G-Expressions}).  They are also transparently handled by the @code{packages->manifest} procedure, which is commonly used in manifests (@pxref{Invoking guix package, the @option{--manifest} option of @command{guix package}}).  Thus you can insert an inferior package pretty much anywhere you would insert a regular package: in manifests, in the @code{packages} field of your @code{operating-system} declaration, and so on.
ru: Пакеты ранних версий могут использоваться прозрачно, как любой другой пакет или объект типа файл в выражении G-expressions (@pxref{G-Expressions}). Они также прозрачно используются в процедуре @code{packages->manifest}, которая обычно используется в манифестах (@pxref{Invoking guix package, the @option{--manifest} option of @command{guix package}}). Так можно вставлять пакет ранней версии в принципе куда угодно, как если вставлять обычный пакет: в манифесты, в поле @code{packages} вашего объявления @code{operating-system} и т.д.

note: type: section
en: Invoking @command{guix describe}
ru: Вызов @command{guix describe}

note: type: Plain text
en: Often you may want to answer questions like: ``Which revision of Guix am I using?'' or ``Which channels am I using?'' This is useful information in many situations: if you want to @emph{replicate} an environment on a different machine or user account, if you want to report a bug or to determine what change in the channels you are using caused it, or if you want to record your system state for reproducibility purposes.  The @command{guix describe} command answers these questions.
ru: Часто может возникать вопрос: "Какую ревизию Guix я использую?" - Или: "Какие каналы я использую?" Это полезна информация во многих ситуациях: если вы хотите @emph{повторить} окружение на другой машине или в другом пользовательском аккаунте, если вы хотите составить отчёт об ошибке, чтобы определить, какие изменения в канале, который вы используете, вызвали ошибку, или если вы хотите записать состояние вашей системы в целях воспроизводимости. Команда @command{guix describe} отвечает на эти вопросы.

note: type: Plain text
en: When run from a @command{guix pull}ed @command{guix}, @command{guix describe} displays the channel(s) that it was built from, including their repository URL and commit IDs (@pxref{Channels}):
ru: В случае запуска после @command{guix pull} команда @command{guix describe} отображает канал(ы), из которых производилась сборка, включая URL и репозиториев и ID коммитов (@pxref{Channels}):

note: type: Plain text
en: If you're familiar with the Git version control system, this is similar in spirit to @command{git describe}; the output is also similar to that of @command{guix pull --list-generations}, but limited to the current generation (@pxref{Invoking guix pull, the @option{--list-generations} option}).  Because the Git commit ID shown above unambiguously refers to a snapshot of Guix, this information is all it takes to describe the revision of Guix you're using, and also to replicate it.
ru: Если вы знакомы с системой контроля версиями Git, эта команда по сути похожа на @command{git describe}; выход тот же, что в @command{guix pull --list-generations}, но ограничен текущим поколением (@pxref{Invoking guix pull, the @option{--list-generations} option}).  Так как ID коммита Git выше ссылается однозначно на снимок Guix, эта информация --- всё, что нужно для описания используемой ревизии Guix и повторения её.

note: type: Plain text
en: To make it easier to replicate Guix, @command{guix describe} can also be asked to return a list of channels instead of the human-readable description above:
ru: Чтобы проще повторить Guix, @command{guix describe} также может вызываться для вывода списка каналов вместо читаемого описания выше:

note: type: example
en: $ guix describe -f channels
    (list (channel
            (name 'guix)
            (url "https://git.savannah.gnu.org/git/guix.git")
            (commit
              "e0fa68c7718fffd33d81af415279d6ddb518f727")
            (introduction
              (make-channel-introduction
                "9edb3f66fd807b096b48283debdcddccfea34bad"
                (openpgp-fingerprint
                  "BBB0 2DDF 2CEA F6A8 0D1D  E643 A2A0 6DF2 A33A 54FA")))))
ru: $ guix describe -f channels
    (list (channel
            (name 'guix)
            (url "https://git.savannah.gnu.org/git/guix.git")
            (commit
              "e0fa68c7718fffd33d81af415279d6ddb518f727")))
            (introduction
               (make-channel-introduction
                 "9edb3f66fd807b096b48283debdcddccfea34bad"
                 (openpgp-fingerprint
                   "BBB0 2DDF 2CEA F6A8 0D1D  E643 A2A0 6DF2 A33A 54FA")))))

note: type: Plain text
en: You can save this to a file and feed it to @command{guix pull -C} on some other machine or at a later point in time, which will instantiate @emph{this exact Guix revision} (@pxref{Invoking guix pull, the @option{-C} option}).  From there on, since you're able to deploy the same revision of Guix, you can just as well @emph{replicate a complete software environment}.  We humbly think that this is @emph{awesome}, and we hope you'll like it too!
ru: Можно сохранить это в файл и подать на вход @command{guix pull -C} на любой другой машине или через время, чтобы инициализировать @emph{эту конкретную ревизию Guix} (@pxref{Invoking guix pull, the @option{-C} option}). Теперь, когда можно развернуть подобную ревизию Guix, вы можете также @emph{полностью повторить программное окружение}. Мы скромно полагаем, это @emph{чудесно}. Надеемся, вам это тоже понравится!

note: type: Plain text
en: The details of the options supported by @command{guix describe} are as follows:
ru: Подробнее об опциях, поддерживаемых @command{guix describe}:

note: type: table
en: Produce output in the specified @var{format}, one of:
ru: Произвести вывод в указанном формате @var{format}, одном из:

note: type: table
en: produce human-readable output;
ru: произвести вывод для чтения человеком;

note: type: cindex
en: channels
ru: каналы

note: type: table
en: produce a list of channel specifications that can be passed to @command{guix pull -C} or installed as @file{~/.config/guix/channels.scm} (@pxref{Invoking guix pull});
ru: произвести список спецификаций каналов, который может использоваться в @command{guix pull -C} или вставлен в файл @file{~/.config/guix/channels.scm} (@pxref{Invoking guix pull});

note: type: table
en: like @code{channels}, but omit the @code{introduction} field; use it to produce a channel specification suitable for Guix version 1.1.0 or earlier---the @code{introduction} field has to do with channel authentication (@pxref{Channels, Channel Authentication}) and is not supported by these older versions;
ru: как @code{channels}, но без поля @code{Introduction}; используйте его для создания спецификации канала, подходящей для Guix версии 1.1.0 или более ранней. Поле @code{Introduction} связано с аутентификацией канала (@pxref{Channels, Channel Authentication}) и не поддерживается этими более ранними версиями;

note: type: table
en: produce a list of channel specifications in JSON format;
ru: произвести список спецификаций каналов в формате JSON;

note: type: table
en: produce a list of channel specifications in Recutils format.
ru: произвести список спецификаций каналов в формате Recutils.

note: type: item
en: --list-formats
ru: --list-roots

note: type: table
en: Display available formats for @option{--format} option.
ru: Вывести доступные форматы для @option{--format} опции.

note: type: table
en: Display information about @var{profile}.
ru: Вывести информацию о профиле @var{profile}.

note: type: section
en: Invoking @command{guix archive}
ru: Вызов @command{guix archive}

note: type: cindex
en: archive
ru: архив

note: type: Plain text
en: The @command{guix archive} command allows users to @dfn{export} files from the store into a single archive, and to later @dfn{import} them on a machine that runs Guix.  In particular, it allows store files to be transferred from one machine to the store on another machine.
ru: Команда @command{guix archive} даёт возможность пользователям @dfn{экспортировать} файлы со склада в простой архив и затем @dfn{импортировать} их на машину с работающим Guix. В частности, это позволяет передавать файлы склада одной машины на склад другой машины.

note: type: quotation
en: If you're looking for a way to produce archives in a format suitable for tools other than Guix, @pxref{Invoking guix pack}.
ru: Если вы ищете способ производить архивы в формате, который подходит для инструментов, отличных от Guix, смотрите @pxref{Invoking guix pack}.

note: type: cindex
en: exporting store items
ru: экспорт элементов склада

note: type: Plain text
en: To export store files as an archive to standard output, run:
ru: Чтобы экспортировать файлы склада в архив в стандартный вывод, выполните:

note: type: Plain text
en: @var{specifications} may be either store file names or package specifications, as for @command{guix package} (@pxref{Invoking guix package}).  For instance, the following command creates an archive containing the @code{gui} output of the @code{git} package and the main output of @code{emacs}:
ru: Спецификации @var{specifications} могут быть либо именами файлов или пакетами, как для команде @command{guix package} (@pxref{Invoking guix package}). Например, следующая команда создаёт архив, содержащий выход @code{gui} пакета @code{git} и главный выход @code{emacs}:

note: type: Plain text
en: If the specified packages are not built yet, @command{guix archive} automatically builds them.  The build process may be controlled with the common build options (@pxref{Common Build Options}).
ru: Если указанные пакеты ещё не собраны, @command{guix archive} автоматически соберёт их. Процесс сборки может контролироваться обычными опциями сборки (@pxref{Common Build Options}).

note: type: Plain text
en: To transfer the @code{emacs} package to a machine connected over SSH, one would run:
ru: Чтобы передать пакет @code{emacs} на машину, соединённую по SSH, нужно следующее:

note: type: Plain text
en: Similarly, a complete user profile may be transferred from one machine to another like this:
ru: Точно также для передачи всего профиля пользователя из одной машины на другую, выполните:

note: type: Plain text
en: However, note that, in both examples, all of @code{emacs} and the profile as well as all of their dependencies are transferred (due to @option{-r}), regardless of what is already available in the store on the target machine.  The @option{--missing} option can help figure out which items are missing from the target store.  The @command{guix copy} command simplifies and optimizes this whole process, so this is probably what you should use in this case (@pxref{Invoking guix copy}).
ru: Однако заметим, что в обоих примерах, передаются весь @code{emacs} и профиль вместе с их зависимости (ввиду @code{-r}), не учитывая, что доступно на складе целевой машины. Опция @code{--missing} помогает определить отсутствующие элементы на целевом складе. Команда @command{guix copy} упрощает и оптимизирует весь этот процесс, так что в данном случае она решает проблему (@pxref{Invoking guix copy}).

note: type: cindex
en: nar, archive format
ru: nar, формат архива

note: type: cindex
en: normalized archive (nar)
ru: нормализованный архив (nar)

note: type: cindex
en: nar bundle, archive format
ru: nar, формат архива

note: type: Plain text
en: Each store item is written in the @dfn{normalized archive} or @dfn{nar} format (described below), and the output of @command{guix archive --export} (and input of @command{guix archive --import}) is a @dfn{nar bundle}.
ru: Каждый элемент храниища написан в @dfn{normalized archive} или @dfn{nar} формате (описано ниже), и вывод @command{guix archive --export} (и ввод @command{guix archive --import}) есть @dfn{nar bundle}.

note: type: Plain text
en: The nar format is comparable in spirit to `tar', but with differences that make it more appropriate for our purposes.  First, rather than recording all Unix metadata for each file, the nar format only mentions the file type (regular, directory, or symbolic link); Unix permissions and owner/group are dismissed.  Second, the order in which directory entries are stored always follows the order of file names according to the C locale collation order.  This makes archive production fully deterministic.
ru: Формат nar по духу сравним с tar, но с отличиями, которые делают его более подходящим для наших целей.  Во-первых, вместо записи всех метаданных Unix для каждого файла, в формате nar упоминается только тип файла (обычный, каталог или символическая ссылка); Разрешения Unix и владелец/группа отклонены.  Во-вторых, порядок, в котором хранятся записи каталога, всегда следует порядку имен файлов в соответствии с порядком сопоставления @code{C} локали.  Это делает создание архивов полностью детерминированным.

note: type: Plain text
en: That nar bundle format is essentially the concatenation of zero or more nars along with metadata for each store item it contains: its file name, references, corresponding derivation, and a digital signature.
ru: Формат пакета nar - это, по сути, конкатенация нуля или более nars вместе с метаданными для каждого элемента store, который содержит: имя файла, ссылки, соответствующую derivation и цифровую подпись.

note: type: Plain text
en: When exporting, the daemon digitally signs the contents of the archive, and that digital signature is appended.  When importing, the daemon verifies the signature and rejects the import in case of an invalid signature or if the signing key is not authorized.
ru: При экспортировании демон подписывает цифровой подписью содержимое архива, и эта цифровая подпись прикрепляется. При импорте демон проверяет подпись и отменяет импорт в случае недействительной подписи, или если ключ подписи не авторизован.

note: type: Plain text
en: The main options are:
ru: Основные опции:

note: type: table
en: Export the specified store files or packages (see below).  Write the resulting archive to the standard output.
ru: Экспортировать указанные файлы хранилища или пакеты (смотрите ниже). Писать результирующий архив в стандартный вывод.

note: type: table
en: Dependencies are @emph{not} included in the output, unless @option{--recursive} is passed.
ru: Зависимости @emph{не} включаются в выход, если не задана опция @option{--recursive}.

note: type: table
en: When combined with @option{--export}, this instructs @command{guix archive} to include dependencies of the given items in the archive.  Thus, the resulting archive is self-contained: it contains the closure of the exported store items.
ru: При сочетании с @code{--export} это указывает @command{guix archive} включать в архив зависимости обозначенных элементов. Так результирующий архив будет "сам в себе": содержит полный конвейер экспортированных элементов склада.

note: type: table
en: Read an archive from the standard input, and import the files listed therein into the store.  Abort if the archive has an invalid digital signature, or if it is signed by a public key not among the authorized keys (see @option{--authorize} below).
ru: Читать архив из стандартного ввода и импортировать файлы, поставляемые им, на склад. Отклонить, если архив имеет недействительную цифровую подпись, или если он подписан публичным ключом, который не находится в списке авторизованных ключей (смотрите @code{--authorize} ниже).

note: type: table
en: Read a list of store file names from the standard input, one per line, and write on the standard output the subset of these files missing from the store.
ru: Читать список имён файлов склада из стандартного ввода, одна линия - один файл, и писать в стандартный вывод подмножество этих файлов, отсутствующих на складе.

note: type: cindex
en: signing, archives
ru: подпись, архивов

note: type: table
en: Generate a new key pair for the daemon.  This is a prerequisite before archives can be exported with @option{--export}.  This operation is usually instantaneous but it can take time if the system's entropy pool needs to be refilled.  On Guix System, @code{guix-service-type} takes care of generating this key pair the first boot.
ru: Генерировать новую ключ-пару для демона. Это необходимо получить перед тем, как экспортировать архивы опцией @code{--export}. Отметим, что эта операция обычно занимает время, так как необходимо собрать много энтропии для ключ-пары.

note: type: table
en: The generated key pair is typically stored under @file{/etc/guix}, in @file{signing-key.pub} (public key) and @file{signing-key.sec} (private key, which must be kept secret).  When @var{parameters} is omitted, an ECDSA key using the Ed25519 curve is generated, or, for Libgcrypt versions before 1.6.0, it is a 4096-bit RSA key.  Alternatively, @var{parameters} can specify @code{genkey} parameters suitable for Libgcrypt (@pxref{General public-key related Functions, @code{gcry_pk_genkey},, gcrypt, The Libgcrypt Reference Manual}).
ru: Сгенерированная ключ-пара обычно сохраняется под @file{/etc/guix}, в файлы @file{signing-key.pub} (публичный ключ) и @file{signing-key.sec} (прватный ключ, который должен оставаться в секрете). Если параметры @var{parameters} пропущены, генерируется ключ ECDSA, используя кривую Ed25519, или для Libgcrypt версии ранее 1.6.0 --- это 4096-битный ключ RSA. Альтернативно в параметрах @var{parameters} можно указать @code{genkey}, соответствующие Libgcrypt (@pxref{General public-key related Functions, @code{gcry_pk_genkey},, gcrypt, The Libgcrypt Reference Manual}).

note: type: cindex
en: authorizing, archives
ru: авторизация, архивов

note: type: table
en: Authorize imports signed by the public key passed on standard input.  The public key must be in ``s-expression advanced format''---i.e., the same format as the @file{signing-key.pub} file.
ru: Авторизовать импорт, подписанный публичным ключом, поступивший на стандартный ввод. Публичный ключ должен быть в формате s-expression, то есть в таком же формате, как файл @file{signing-key.pub}.

note: type: table
en: The list of authorized keys is kept in the human-editable file @file{/etc/guix/acl}.  The file contains @url{https://people.csail.mit.edu/rivest/Sexp.txt, ``advanced-format s-expressions''} and is structured as an access-control list in the @url{https://theworld.com/~cme/spki.txt, Simple Public-Key Infrastructure (SPKI)}.
ru: Список авторизованных ключей хранится в файле @file{/etc/guix/acl}, доступном для редактирования человеком. Файл содержит @url{http://people.csail.mit.edu/rivest/Sexp.txt, s-expression расширенного формата}, и он структурирован в виде списка контроля доступа в @url{http://theworld.com/~cme/spki.txt, Simple Public-Key Infrastructure (SPKI)}.

note: type: table
en: Read a single-item archive as served by substitute servers (@pxref{Substitutes}) and extract it to @var{directory}.  This is a low-level operation needed in only very narrow use cases; see below.
ru: Читать архив, представляющий один элемент, в качестве поставленного серверами подстановки (@pxref{Substitutes}) и извлечь его в директорию @var{directory}. Это низкоуровневая операция, необходимая только в очень редких случаях, смотрите ниже.

note: type: table
en: For example, the following command extracts the substitute for Emacs served by @code{@value{SUBSTITUTE-SERVER-1}} to @file{/tmp/emacs}:
ru: Например, следующая команда распаковывает подстановку Emacs, поставленную @code{@value{SUBSTITUTE-SERVER-1}} в @file{/tmp/emacs}:

note: type: table
en: Single-item archives are different from multiple-item archives produced by @command{guix archive --export}; they contain a single store item, and they do @emph{not} embed a signature.  Thus this operation does @emph{no} signature verification and its output should be considered unsafe.
ru: Архивы, представляющие один элемент, отличаются от архивов, содержащих множество элементов, производимых @command{guix archive --export}. Они содержат один элемент склада, но они @emph{не} включают подпись. Так что эта операция @emph{не} использует верификацию, и его выход должен рассматриваться как небезопасный.

note: type: table
en: The primary purpose of this operation is to facilitate inspection of archive contents coming from possibly untrusted substitute servers (@pxref{Invoking guix challenge}).
ru: Основная цель этой операции --- упростить просмотр содержимого архива, происходящего, возможно, из недоверенных серверов подстановок.

note: type: table
en: Read a single-item archive as served by substitute servers (@pxref{Substitutes}) and print the list of files it contains, as in this example:
ru: Читать архив, представляющий один элемент, в качестве поставленного серверами подстановки (@pxref{Substitutes}) и распечатайте список файлов, которые он содержит, как в этом примере:

note: type: cindex
en: @command{guix pull}, configuration file
ru: @command{guix pull}, конфигурационный файл

note: type: cindex
en: configuration of @command{guix pull}
ru: конфигурация @command{guix pull}

note: type: Plain text
en: Guix and its package collection are updated by running @command{guix pull} (@pxref{Invoking guix pull}).  By default @command{guix pull} downloads and deploys Guix itself from the official GNU@tie{}Guix repository.  This can be customized by defining @dfn{channels} in the @file{~/.config/guix/channels.scm} file.  A channel specifies a URL and branch of a Git repository to be deployed, and @command{guix pull} can be instructed to pull from one or more channels.  In other words, channels can be used to @emph{customize} and to @emph{extend} Guix, as we will see below.  Guix is able to take into account security concerns and deal with authenticated updates.
ru: Guix и его коллекция пакетов можно обновить запуском @command{guix pull} (@pxref{Invoking guix pull}). По умолчанию @command{guix pull} скачивает и разворачивает Guix из официального репозитория GNU@tie{}Guix. Это может быть изменено определением каналов @dfn{channels} в файле @file{~/.config/guix/channels.scm}. Канал обозначает URL или ветку репозитория Git для разворачивания. Также @command{guix pull} может быть настроена для скачивания из одного или более каналов. Другими словами, каналы могут использоваться для @emph{настройки} и для @emph{расширения} Guix, как это будет показано ниже.

note: type: cindex
en: extending the package collection (channels)
ru: расширение коллекции пакетов (каналов)

note: type: cindex
en: variant packages (channels)
ru: собственные пакеты (каналы)

note: type: Plain text
en: You can specify @emph{additional channels} to pull from.  To use a channel, write @code{~/.config/guix/channels.scm} to instruct @command{guix pull} to pull from it @emph{in addition} to the default Guix channel(s):
ru: Чтобы использовать канал, напишите @code{~/.config/guix/channels.scm}, чтобы обозначить @command{guix pull} скачивать оттуда @emph{в дополнение} к каналу(-ам) Guix по умолчанию:

note: type: lisp
en: ;; Add variant packages to those Guix provides.
    (cons (channel
            (name 'variant-packages)
            (url "https://example.org/variant-packages.git"))
          %default-channels)
ru: ;; Add my personal packages to those Guix provides.
    (cons (channel
            (name 'my-personal-packages)
            (url "https://example.org/personal-packages.git"))
          %default-channels)

note: type: Plain text
en: Note that the snippet above is (as always!)@: Scheme code; we use @code{cons} to add a channel the list of channels that the variable @code{%default-channels} is bound to (@pxref{Pairs, @code{cons} and lists,, guile, GNU Guile Reference Manual}).  With this file in place, @command{guix pull} builds not only Guix but also the package modules from your own repository.  The result in @file{~/.config/guix/current} is the union of Guix with your own package modules:
ru: Заметим, что сниппет выше (всегда!)@: код Scheme; мы используем @code{cons} для добавления канала в список каналов, то есть в переменную @code{%default-channels} (@pxref{Pairs, @code{cons} and lists,, guile, GNU Guile Reference Manual}). Если этот файл написан, @command{guix pull} производит сборку не только Guix, но и пакетных модулей из вашего репозитория. В результате в @file{~/.config/guix/current} содержится объединение Guix и ваших собственных пакетных модулей:

note: type: Plain text
en: The channel called @code{guix} specifies where Guix itself---its command-line tools as well as its package collection---should be downloaded.  For instance, suppose you want to update from another copy of the Guix repository at @code{example.org}, and specifically the @code{super-hacks} branch, you can write in @code{~/.config/guix/channels.scm} this specification:
ru: Канал, названный @code{guix}, обозначает, откуда должен скачиваться сам Guix (его инструменты командной строки и коллекция пакетов). Например, предположим вы хотите обновиться из вашей собственной копии репозитория Guix на @code{example.org}, а именно из ветки @code{super-hacks}, тогда можно написать в @code{~/.config/guix/channels.scm} следующую спецификацию:

note: type: lisp
en: ;; Tell 'guix pull' to use another repo.
    (list (channel
            (name 'guix)
            (url "https://example.org/another-guix.git")
            (branch "super-hacks")))
ru: ;; Tell 'guix pull' to use my own repo.
    (list (channel
            (name 'guix)
            (url "https://example.org/my-guix.git")
            (branch "super-hacks")))

note: type: lisp
en: ;; Deploy specific commits of my channels of interest.
    (list (channel
           (name 'guix)
           (url "https://git.savannah.gnu.org/git/guix.git")
           (commit "6298c3ffd9654d3231a6f25390b056483e8f407c"))
          (channel
           (name 'variant-packages)
           (url "https://example.org/variant-packages.git")
           (commit "dd3df5e2c8818760a8fc0bd699e55d3b69fef2bb")))
ru: ;; Deploy specific commits of my channels of interest.
    (list (channel
           (name 'guix)
           (url "https://git.savannah.gnu.org/git/guix.git")
           (commit "d894ab8e9bfabcefa6c49d9ba2e834dd5a73a300"))
          (channel
           (name 'my-personal-packages)
           (url "https://example.org/personal-packages.git")
           (branch "dd3df5e2c8818760a8fc0bd699e55d3b69fef2bb")))

note: type: Plain text
en: This gives you super powers, allowing you to track the provenance of binary artifacts with very fine grain, and to reproduce software environments at will---some sort of ``meta reproducibility'' capabilities, if you will.  @xref{Inferiors}, for another way to take advantage of these super powers.
ru: Это даёт вам супервозможности, позволяя вам отслеживать и управлять происхождением артефактов бинарников с точной детализацией, также повторять программные окружения --- это воспроизводимость высокого уровня. Смотрите @xref{Inferiors}, чтобы узнать другие преимущества таких супервозможностей.

note: type: Plain text
en: The @command{guix pull} and @command{guix time-machine} commands @dfn{authenticate} the code retrieved from channels: they make sure each commit that is fetched is signed by an authorized developer.  The goal is to protect from unauthorized modifications to the channel that would lead users to run malicious code.
ru: @command{guix pull} и @command{guix time-machine} @dfn{аутентифицируют} код, полученный из каналов: они гарантируют, что каждый полученный коммит подписан авторизованным разработчиком.  Цель состоит в том, чтобы защитить канал от несанкционированных изменений, которые могут привести к запуску вредоносного кода пользователями.

note: type: Plain text
en: As a user, you must provide a @dfn{channel introduction} in your channels file so that Guix knows how to authenticate its first commit.  A channel specification, including its introduction, looks something along these lines:
ru: Как пользователь, вы должны предоставить @dfn{channel introduction} в вашем файле канала, чтобы Guix знал как авторизовать свой первый коммит. Спецификация канала, включая введения, выглядит как-то так:

note: type: Plain text
en: The specification above shows the name and URL of the channel.  The call to @code{make-channel-introduction} above specifies that authentication of this channel starts at commit @code{6f0d8cc@dots{}}, which is signed by the OpenPGP key with fingerprint @code{CABB A931@dots{}}.
ru: В приведенной выше спецификации указано имя и URL-адрес канала.  Вызов @code{make-channel-introduction} выше указывает, что аутентификация этого канала начинается с коммита @code{6f0d8cc@dots{}}, который подписывается ключом OpenPGP с отпечатком @code{CABB A931@dots{}}.

note: type: Plain text
en: For the main channel, called @code{guix}, you automatically get that information from your Guix installation.  For other channels, include the channel introduction provided by the channel authors in your @file{channels.scm} file.  Make sure you retrieve the channel introduction from a trusted source since that is the root of your trust.
ru: Для основного канала, называемого @code{guix}, вы автоматически получаете эту информацию из вашей установки Guix.  Для других каналов, укажите introduction для канала, предоставленное авторами канала, в ваш файл @file{channels.scm}.  Убедитесь, что вы получили introduction канала из надежного источника, так как это основа вашего доверия.

note: type: Plain text
en: If you're curious about the authentication mechanics, read on!
ru: Если вам любопытены механизмы авторизации, читайте дальше!

note: type: Plain text
en: When running @command{guix pull}, Guix will first compile the definitions of every available package.  This is an expensive operation for which substitutes (@pxref{Substitutes}) may be available.  The following snippet in @file{channels.scm} will ensure that @command{guix pull} uses the latest commit with available substitutes for the package definitions: this is done by querying the continuous integration server at @url{https://ci.guix.gnu.org}.
ru: При запуске @command{guix pull} Guix сначала скомпилирует определения каждого доступного пакета.  Это тяжелая операция, для которой могут быть доступны заменители (@pxref{Substitutes}).  Следующий фрагмент в @file{channels.scm} гарантирует, что @command{guix pull} использует последний коммит с доступными заменами для определений пакетов: это делается путем запроса к серверу непрерывной интеграции по адресу @url {https://ci.guix.gnu.org}.

note: type: lisp
en: (use-modules (guix ci))
ru: (use-package-modules guile emacs)

note: type: Plain text
en: Note that this does not mean that all the packages that you will install after running @command{guix pull} will have available substitutes.  It only ensures that @command{guix pull} will not try to compile package definitions.  This is particularly useful when using machines with limited resources.
ru: Учтите, что это не означает, что все пакеты, которые вы установите после запуска @command{guix pull}, будут иметь доступные заменители.  Это только гарантирует, что @command{guix pull} не будет пытаться скомпилировать определения пакетов.  Это особенно полезно при использовании машин с ограниченными ресурсами.

note: type: cindex
en: personal packages (channels)
ru: собственные пакеты (каналы)

note: type: cindex
en: channels, for personal packages
ru: каналы, для собственных пакетов

note: type: Plain text
en: Let's say you have a bunch of custom package variants or personal packages that you think would make little sense to contribute to the Guix project, but would like to have these packages transparently available to you at the command line.  You would first write modules containing those package definitions (@pxref{Package Modules}), maintain them in a Git repository, and then you and anyone else can use it as an additional channel to get packages from.  Neat, no?
ru: Можно также задать @emph{дополнительные каналы} для выборки оттуда. Ну, например, у вас ряд собственных вариантов пакетов или собственные пакеты, которые вы считаете не особо важным для отправки в проект Guix, но хотите, чтобы эти пакеты были доступны вам в командной строке прозрачно, без дополнительных действий. Вначале можно написать модули, содержащие определения этих пакетов (@pxref{Package Modules}), затем разместить их в репозитории Git, и тогда вы или кто-либо ещё сможете использовать их в качестве дополнтельного канала для получения пакетов. Красиво, да?

note: type: quotation
en: Before you, dear user, shout---``woow this is @emph{soooo coool}!''---and publish your personal channel to the world, we would like to share a few words of caution:
ru: Прежде чем вы крикнете @emph{Ух-ты, это круто!} и опубликуете собственный канал, необходимо учесть некоторые предостережения:

note: type: itemize
en: Before publishing a channel, please consider contributing your package definitions to Guix proper (@pxref{Contributing}).  Guix as a project is open to free software of all sorts, and packages in Guix proper are readily available to all Guix users and benefit from the project's quality assurance process.
ru: Перед публикацией канала, пожалуйста, рассмотрите возможность поделиться вашими определениями пакетов со сборником Guix (@pxref{Contributing}). Guix, как проект, открыт свободному программному обеспечению любого назначения, и пакеты в сборнике Guix готовы и доступны для использования всеми пользователями Guix и прошли проверку качества.

note: type: itemize
en: When you maintain package definitions outside Guix, we, Guix developers, consider that @emph{the compatibility burden is on you}.  Remember that package modules and package definitions are just Scheme code that uses various programming interfaces (APIs).  We want to remain free to change these APIs to keep improving Guix, possibly in ways that break your channel.  We never change APIs gratuitously, but we will @emph{not} commit to freezing APIs either.
ru: Когда вы выгружаете определение пакета вне Guix, мы, разработчики Guix, полагаем, что вопрос @emph{совместимости ложится на вас}. Учтите, что пакетные модули и определения пакетов --- это код Scheme, который используют различные программные интерфейсы (API). Мы хотим оставить возможность для себя изменять эти API, чтобы продолжить улучшать Guix. И это может привести к поломке вашего канала. Мы никогда не меняем API необоснованно, но всё же мы @emph{не} будем обновлять устаревшие, замороженные API.

note: type: itemize
en: Corollary: if you're using an external channel and that channel breaks, please @emph{report the issue to the channel authors}, not to the Guix project.
ru: Вывод: если вы используете внешний канал, и этот канал ломается, пожалуйста, @emph{заявите об этой проблеме авторам каналв}, но не в проект Guix.

note: type: quotation
en: You've been warned! Having said this, we believe external channels are a practical way to exert your freedom to augment Guix' package collection and to share your improvements, which are basic tenets of @uref{https://www.gnu.org/philosophy/free-sw.html, free software}.  Please email us at @email{guix-devel@@gnu.org} if you'd like to discuss this.
ru: Вы предупреждены! Обозначив это, мы верим, что внешние каналы --- это способ для вас проявлять свою свободу и вместе с тем расширять коллекцию пакетов Guix и делиться улучшениями, что является основными догматами @uref{https://www.gnu.org/philosophy/free-sw.ru.html, свободного программного обеспечения}. Пожалуйста, свяжитесь с нами по e-mail @email{guix-devel@@gnu.org}, если вы хотите обсудить это.

note: type: Plain text
en: To create a channel, create a Git repository containing your own package modules and make it available.  The repository can contain anything, but a useful channel will contain Guile modules that export packages.  Once you start using a channel, Guix will behave as if the root directory of that channel's Git repository has been added to the Guile load path (@pxref{Load Paths,,, guile, GNU Guile Reference Manual}).  For example, if your channel contains a file at @file{my-packages/my-tools.scm} that defines a Guile module, then the module will be available under the name @code{(my-packages my-tools)}, and you will be able to use it like any other module (@pxref{Modules,,, guile, GNU Guile Reference Manual}).
ru: Чтобы создать канал, создайте репозиторий Git, содержащий ваши собственные пакетные модули, и сделайте его доступным. Репозиторий может содержать что-либо, но полезный канал будет содержать модули Guile, экспортирующие пакеты. Когда вы начали использовать канал, Guix будет работать, как будто корневая директория репозитория Git этого канала добавлена в путь загрузки Guile (@pxref{Load Paths,,, guile, GNU Guile Reference Manual}). Например, если ваш канал содержит файл @file{my-packages/my-tools.scm}, который определяет модуль Guile, тогда модуль будет доступен под именем @code{(my-packages my-tools)}, и вы сможете использовать его, как любой другой модуль (@pxref{Modules,,, guile, GNU Guile Reference Manual}).

note: type: Plain text
en: As a channel author, consider bundling authentication material with your channel so that users can authenticate it.  @xref{Channel Authentication}, and @ref{Specifying Channel Authorizations}, for info on how to do it.
ru: Как автор канала, рассмотрите возможность объединения материалов для аутентификации с вашим каналом, чтобы пользователи могли его аутентифицировать.  @xref{Channel Authentication} и @ref{Specifying Channel Authorizations} для получения информации о том, как это сделать.

note: type: cindex
en: subdirectory, channels
ru: подкаталог, каналы

note: type: Plain text
en: As a channel author, you may want to keep your channel modules in a sub-directory.  If your modules are in the sub-directory @file{guix}, you must add a meta-data file @file{.guix-channel} that contains:
ru: Как автор канала, вы можете хранить модули канала в подкаталоге. Если ваши модули находятся в подкаталоге @file{guix}, вы должны добавить файл метаданных @file{.guix-channel}, который содержит:

note: type: cindex
en: dependencies, channels
ru: зависимости, каналы

note: type: cindex
en: meta-data, channels
ru: метаданные, каналы

note: type: Plain text
en: Channel authors may decide to augment a package collection provided by other channels.  They can declare their channel to be dependent on other channels in a meta-data file @file{.guix-channel}, which is to be placed in the root of the channel repository.
ru: Авторы канала могут решить расширить коллекцию пакетов пакетами, которые поставляются другими каналами. Они могут объявить, что их канал зависит от других каналов, в файле метаданных @file{.guix-channel}, который нужно разместить в корне репозитория канала.

note: type: Plain text
en: The meta-data file should contain a simple S-expression like this:
ru: Файл метаданных должен содержать простое выражение S-expression как это:

note: type: lisp
en: (channel
     (version 0)
     (dependencies
      (channel
       (name some-collection)
       (url "https://example.org/first-collection.git")
ru: (channel
     (version 0)
     (dependencies
      (channel
       (name 'some-collection)
       (url "https://example.org/first-collection.git")

note: type: lisp
en:    ;; The 'introduction' bit below is optional: you would
       ;; provide it for dependencies that can be authenticated.
       (introduction
        (channel-introduction
          (version 0)
          (commit "a8883b58dc82e167c96506cf05095f37c2c2c6cd")
          (signer "CABB A931 C0FF EEC6 900D  0CFB 090B 1199 3D9A EBB5"))))
      (channel
       (name some-other-collection)
       (url "https://example.org/second-collection.git")
       (branch "testing"))))
ru:    ;; The 'introduction' bit below is optional: you would
       ;; provide it for dependencies that can be authenticated.
       (introduction
        (channel-introduction
          (version 0)
          (commit "a8883b58dc82e167c96506cf05095f37c2c2c6cd")
          (signer "CABB A931 C0FF EEC6 900D  0CFB 090B 1199 3D9A EBB5"))))
      (channel
       (name 'some-other-collection)
       (url "https://example.org/second-collection.git")
       (branch "testing"))))

note: type: Plain text
en: In the above example this channel is declared to depend on two other channels, which will both be fetched automatically.  The modules provided by the channel will be compiled in an environment where the modules of all these declared channels are available.
ru: В примере выше объявлен канал, который зависит от двух других каналов, из которых оба будут скачаны автоматически. Модули, предоставляемые каналом, будут скомпилированы в окружении, в котором доступны модули всех этих каналов.

note: type: Plain text
en: For the sake of reliability and maintainability, you should avoid dependencies on channels that you don't control, and you should aim to keep the number of dependencies to a minimum.
ru: В целях воспроизводимости и сопровождения вы должны избегать зависимостей от каналов, которые вы не контролируете, и вы должны стремиться минимизировать число зависимостей.

note: type: cindex
en: channel authorizations
ru: авторизации канала

note: type: Plain text
en: As we saw above, Guix ensures the source code it pulls from channels comes from authorized developers.  As a channel author, you need to specify the list of authorized developers in the @file{.guix-authorizations} file in the channel's Git repository.  The authentication rule is simple: each commit must be signed by a key listed in the @file{.guix-authorizations} file of its parent commit(s)@footnote{Git commits form a @dfn{directed acyclic graph} (DAG).  Each commit can have zero or more parents; ``regular'' commits have one parent and merge commits have two parent commits.  Read @uref{https://eagain.net/articles/git-for-computer-scientists/, @i{Git for Computer Scientists}} for a great overview.} The @file{.guix-authorizations} file looks like this:
ru: Как мы видели выше, Guix гарантирует, что исходный код, который он получает из каналов, поступает от авторизованных разработчиков.  Как автор канала, вам необходимо указать список авторизованных разработчиков в файле @file{.guix-authorizations} в репозитории Git канала.  Правило аутентификации простое: каждый коммит должен быть подписан ключом, указанным в файле @file{.guix-authorizations} его родительского коммита(ов) @footnote{Git коммитит из @dfn{directed acyclic graph}(DAG).  У каждого коммита может быть ноль или более родителей; ``обычные'' коммиты имеют одного родителя, а ``merge'' коммиты имеют два родительских коммита.  Прочтите @uref{https://eagain.net/articles/git-for-computer-scientists/, @i{Git for Computer Scientists}}, чтобы получить больше информации.} файл @file{.guix-authorizations} выглядит так:

note: type: lisp
en: ;; Example '.guix-authorizations' file.
ru: ;; Пример '.guix-authorizations' файла.

note: type: Plain text
en: Each fingerprint is followed by optional key/value pairs, as in the example above.  Currently these key/value pairs are ignored.
ru: За каждым отпечатком следуют необязательные пары ключ/значение, как в примере выше.  В настоящее время эти пары ключ/значение игнорируются.

note: type: Plain text
en: This authentication rule creates a chicken-and-egg issue: how do we authenticate the first commit? Related to that: how do we deal with channels whose repository history contains unsigned commits and lack @file{.guix-authorizations}? And how do we fork existing channels?
ru: Это правило аутентификации создает проблему с курицей и яйцом: как мы аутентифицируем первый коммит? В связи с этим: как нам поступать с каналами, история репозитория которых содержит неподписанные коммиты и не имеет @file{.guix-authorizations}? И как нам разветвлять существующие каналы?

note: type: cindex
en: channel introduction
ru: введение канала

note: type: Plain text
en: Additionally, your channel must provide all the OpenPGP keys that were ever mentioned in @file{.guix-authorizations}, stored as @file{.key} files, which can be either binary or ``ASCII-armored''.  By default, those @file{.key} files are searched for in the branch named @code{keyring} but you can specify a different branch name in @code{.guix-channel} like so:
ru: Кроме того, ваш канал должен предоставлять все ключи OpenPGP, которые когда-либо упоминались в @file{.guix-authorizations}, хранящиеся как файлы @file{.key}, которые могут быть либо двоичными, либо ``ASCII-armored''.  По умолчанию эти файлы @file{.key} ищутся в ветке с именем @code{keyring}, но вы можете указать другое имя ветки в @code{.guix-channel} следующим образом:

note: type: Plain text
en: To summarize, as the author of a channel, there are three things you have to do to allow users to authenticate your code:
ru: Подытоживая, как автор канала, вы должны сделать три вещи, чтобы позволить другим пользователям авторизовать ваш код:

note: type: enumerate
en: Export the OpenPGP keys of past and present committers with @command{gpg --export} and store them in @file{.key} files, by default in a branch named @code{keyring} (we recommend making it an @dfn{orphan branch}).
ru: Экспортируйте ключи OpenPGP прошлых и нынешних коммиттеров с помощью @command{gpg --export} и сохраните их в файлах @file{.key}, по умолчанию в ветке с именем @code{keyring} (мы рекомендуем сделать это в @dfn{orphan branch}).

note: type: enumerate
en: Introduce an initial @file{.guix-authorizations} in the channel's repository.  Do that in a signed commit (@pxref{Commit Access}, for information on how to sign Git commits.)
ru: Добавьте @file{.guix-authorizations} в репозиторий канала.  Сделайте это в подписанном коммите (@pxref{Commit Access}, чтобы узнать, как подписывать коммиты Git)

note: type: enumerate
en: Advertise the channel introduction, for instance on your channel's web page.  The channel introduction, as we saw above, is the commit/key pair---i.e., the commit that introduced @file{.guix-authorizations}, and the fingerprint of the OpenPGP used to sign it.
ru: Рекламируйте channel introduction, например, на веб-странице вашего канала.  Channel introduction, как мы видели выше, - это пара коммит/ключ, то есть коммит, который представляет @file{.guix-authorizations}, и отпечаток OpenPGP, использованный для его подписи.

note: type: Plain text
en: Before pushing to your public Git repository, you can run @command{guix git-authenticate} to verify that you did sign all the commits you are about to push with an authorized key:
ru: Перед отправкой в ваш общедоступный репозиторий Git вы можете запустить @command{guix git-authenticate}, чтобы убедиться, что вы подписали все коммиты, которые собираетесь отправить, авторизованным ключом:

note: type: Plain text
en: where @var{commit} and @var{signer} are your channel introduction.  @xref{Invoking guix git authenticate}, for details.
ru: где @var{commit} и @var{signer} являются вашим channel introduction.  @xref{Invoking guix git authenticate}, подробнее.

note: type: Plain text
en: Publishing a signed channel requires discipline: any mistake, such as an unsigned commit or a commit signed by an unauthorized key, will prevent users from pulling from your channel---well, that's the whole point of authentication! Pay attention to merges in particular: merge commits are considered authentic if and only if they are signed by a key present in the @file{.guix-authorizations} file of @emph{both} branches.
ru: Публикация подписанного канала требует дисциплины: любая ошибка, такая как неподписанная фиксация или фиксация, подписанная неавторизованным ключом, не позволит пользователям pull'ить с вашего канала - в этом весь смысл аутентификации! Обратите внимание на merge, в частности: merge коммиты считаются аутентичными, если и только если они подписаны ключом, присутствующим в файле @file{.guix-authorizations} @emph{обоих} веток.

note: type: cindex
en: primary URL, channels
ru: основной URL, каналы

note: type: Plain text
en: Channel authors can indicate the primary URL of their channel's Git repository in the @file{.guix-channel} file, like so:
ru: Авторы каналов могут указать основной URL-адрес репозитория Git своего канала в файле @file{.guix-channel}, например:

note: type: Plain text
en: This allows @command{guix pull} to determine whether it is pulling code from a mirror of the channel; when that is the case, it warns the user that the mirror might be stale and displays the primary URL@.  That way, users cannot be tricked into fetching code from a stale mirror that does not receive security updates.
ru: Это позволяет @command{guix pull} определять, pull'ит ли он код из зеркала канала; в этом случае он предупреждает пользователя о том, что зеркало может быть устаревшим, и отображает основной URL-адрес.  Таким образом, пользователей нельзя обмануть, заставив их получить код с устаревшего зеркала, которое не получает обновлений безопасности.

note: type: Plain text
en: This feature only makes sense for authenticated repositories, such as the official @code{guix} channel, for which @command{guix pull} ensures the code it fetches is authentic.
ru: Эта функция имеет смысл только для аутентифицированных репозиториев, таких как официальный канал @code{guix}, для которого @command{guix pull} гарантирует, что полученный код аутентичен.

note: type: cindex
en: news, for channels
ru: новости, для каналов

note: type: Plain text
en: Channel authors may occasionally want to communicate to their users information about important changes in the channel.  You'd send them all an email, but that's not convenient.
ru: Авторы канала могут захотеть сообщить своим пользователям информацию о важных изменениях в канале. Вы можете отправить им письмо по электронной почте, но это не удобно.

note: type: Plain text
en: Instead, channels can provide a @dfn{news file}; when the channel users run @command{guix pull}, that news file is automatically read and @command{guix pull --news} can display the announcements that correspond to the new commits that have been pulled, if any.
ru: Вместо этого каналы могут предоставлять @dfn{файл новостей}; когда пользователи канала запускают @command{guix pull}, этот файл новостей автоматически читается, и @command{guix pull --news} может отображать объявления, которые соответствуют новым зафиксированным коммитам, если таковые имеются.

note: type: Plain text
en: To do that, channel authors must first declare the name of the news file in their @file{.guix-channel} file:
ru: Для этого авторы каналов должны сначала объявить имя файла новостей в своем файле @file{.guix-channel}:

note: type: Plain text
en: The news file itself, @file{etc/news.txt} in this example, must look something like this:
ru: Сам файл новостей, @file{etc/news.txt} в этом примере, должен выглядеть примерно так:

note: type: Plain text
en: While the news file is using the Scheme syntax, avoid naming it with a @file{.scm} extension or else it will get picked up when building the channel and yield an error since it is not a valid module.  Alternatively, you can move the channel module to a subdirectory and store the news file in another directory.
ru: В то время как файл новостей использует синтаксис Scheme, избегайте называть его расширением @file{.scm}, иначе он будет выбран при построении канала и выдаст ошибку, поскольку это недопустимый модуль.  Кроме того, вы можете переместить модуль канала в подкаталог и сохранить файл новостей в другом каталоге.

note: type: Plain text
en: The file consists of a list of @dfn{news entries}.  Each entry is associated with a commit or tag: it describes changes made in this commit, possibly in preceding commits as well.  Users see entries only the first time they obtain the commit the entry refers to.
ru: Файл состоит из списка @dfn{news entries}. Каждая запись связана с коммитом или тегом: она описывает изменения, сделанные в этом коммите, возможно, также и в предыдущих коммитах. Пользователи видят записи только при первом получении коммита, на который ссылается запись.

note: type: Plain text
en: The @code{title} field should be a one-line summary while @code{body} can be arbitrarily long, and both can contain Texinfo markup (@pxref{Overview,,, texinfo, GNU Texinfo}).  Both the title and body are a list of language tag/message tuples, which allows @command{guix pull} to display news in the language that corresponds to the user's locale.
ru: Поле @code{title} должно быть однострочным, а @code{body} может быть произвольно длинным, и оба могут содержать Texinfo разметку (@pxref{Overview,,, texinfo, GNU Texinfo}). И заголовок, и тело являются списком языковых тегов/кортежей сообщений, что позволяет комманде @command{guix pull} отображать новости на языке, соответствующем языку пользователя.

note: type: Plain text
en: If you want to translate news using a gettext-based workflow, you can extract translatable strings with @command{xgettext} (@pxref{xgettext Invocation,,, gettext, GNU Gettext Utilities}).  For example, assuming you write news entries in English first, the command below creates a PO file containing the strings to translate:
ru: Если вы хотите перевести новости, используя рабочий процесс на основе gettext, вы можете извлечь переводимые строки с помощью @command{xgettext} (@pxref{xgettext Invocation,,, gettext, GNU Gettext Utilities}). Например, если вы сначала пишете новости на английском языке, команда ниже создает PO-файл, содержащий строки для перевода:

note: type: Plain text
en: To sum up, yes, you could use your channel as a blog.  But beware, this is @emph{not quite} what your users might expect.
ru: Подводя итог, да, вы можете использовать свой канал в качестве блога. Но будьте осторожны, это @emph{не совсем} то, что могут ожидать ваши пользователи.

note: type: cindex
en: software development
ru: разработка программного обеспечения

note: type: Plain text
en: If you are a software developer, Guix provides tools that you should find helpful---independently of the language you're developing in.  This is what this chapter is about.
ru: Если вы являетесь разработчиком программного обеспечения, Guix предоставляет инструменты, которые вы можете найти полезными, независимо от языка разработки. Об этом данный раздел.

note: type: section
en: Invoking @command{guix shell}
ru: Вызов @command{guix shell}

note: type: cindex
en: reproducible build environments
ru: воспроизводимые окружения сборки

note: type: cindex
en: development environments
ru: окружения разработки

note: type: cindex
en: environment, package build environment
ru: окружение сборки пакета

note: type: Plain text
en: @command{guix shell} defines the @env{GUIX_ENVIRONMENT} variable in the shell it spawns; its value is the file name of the profile of this environment.  This allows users to, say, define a specific prompt for development environments in their @file{.bashrc} (@pxref{Bash Startup Files,,, bash, The GNU Bash Reference Manual}):
ru: @command{guix shell} определяет переменную @code{GUIX_ENVIRONMENT} в оболочке, которую создаёт; её значением является имя файла профиля этого окружения. Это позволяет пользователям, скажем, определить специфичные значения окружений разработки в @file{.bashrc} (@pxref{Bash Startup Files,,, bash, The GNU Bash Reference Manual}):

note: type: Plain text
en: ...@: or to browse the profile:
ru: ...@: или просмотеть профиль:

note: type: Plain text
en: The available options are summarized below.
ru: Доступные опции резюмированы ниже.

note: type: table
en: Create an environment for the package or list of packages that @var{expr} evaluates to.
ru: Создать окружение для пакета или списка пакетов, которые соответствуют выражению @var{expr}.

note: type: table
en: For example, running:
ru: Например, запуск:

note: type: table
en: starts a shell with the environment for this specific variant of the PETSc package.
ru: запускает оболочку с окружением для этого специфического варианта пакета PETSc.

note: type: table
en: Running:
ru: Запуск:

note: type: table
en: starts a shell with all the base system packages available.
ru: стартует оболочку со всеми доступными базовыми пакетами.

note: type: table
en: The above commands only use the default output of the given packages.  To select other outputs, two element tuples can be specified:
ru: Команды выше используют только выход по умолчанию обозначенных пакетов. Чтобы выбрать другие выходы, можно указать два элемента кортежей:

note: type: table
en: Create an environment for the packages contained in the manifest object returned by the Scheme code in @var{file}.  This option can be repeated several times, in which case the manifests are concatenated.
ru: Создать окружение для пакетов, содержащихся в объекте манифеста, возвращаемого кодом Scheme в файле @var{file}.

note: type: table
en: This is similar to the same-named option in @command{guix package} (@pxref{profile-manifest, @option{--manifest}}) and uses the same manifest files.
ru: Это то же, что опция с таким же именем в @command{guix package} (@pxref{profile-manifest, @option{--manifest}}) и использует такие же файлы манифестов.

note: type: table
en: Unset existing environment variables when building the new environment, except those specified with @option{--preserve} (see below).  This has the effect of creating an environment in which search paths only contain package inputs.
ru: Сброс существующих переменных окружения при сборке нового окружения, кроме обозначенных в опции @option{--preserve} (смотрите ниже). Эффект этой опции --- создание окружения, в котором пути поиска содержат только входные данные пакета.

note: type: table
en: When used alongside @option{--pure}, preserve the environment variables matching @var{regexp}---in other words, put them on a ``white list'' of environment variables that must be preserved.  This option can be repeated several times.
ru: При использовании вместе с @option{--pure}, оставить содержимое переменных окружения, соответствующих выражению @var{regexp} --- другими словами, включить их в "белый список" переменных окружения, которые не должны обнуляться. Эту опцию можно повторять несколько раз.

note: type: table
en: This example runs @command{mpirun} in a context where the only environment variables defined are @env{PATH}, environment variables whose name starts with @samp{SLURM}, as well as the usual ``precious'' variables (@env{HOME}, @env{USER}, etc.).
ru: Этот пример запускает @command{mpirun} в контексте, в котором определены только следующие переменные окружения: @env{PATH}, переменные окружения, чьи имена начинаются с @samp{SLURM}, а также обычные "дорогие" переменные (@env{HOME}, @env{USER}, и т.д.).

note: type: table
en: Display the environment variable definitions that make up the environment.
ru: Отобразить определения переменных окружения, которые составляют окружение.

note: type: table
en: Attempt to build for @var{system}---e.g., @code{i686-linux}.
ru: Попытаться собрать систему @var{system}, то есть @code{i686-linux}.

note: type: item
en: container
ru: контейнер

note: type: table
en: Run @var{command} within an isolated container.  The current working directory outside the container is mapped inside the container.  Additionally, unless overridden with @option{--user}, a dummy home directory is created that matches the current user's home directory, and @file{/etc/passwd} is configured accordingly.
ru: Запустить @var{command} в изолированном контейнере. Текущая рабочая директория за пределами контейнера отображается внутри контейнера. В дополнение, если это не переопределено опцией @code{--user}, тогда настраивается фиктивная домашняя директория, которая совпадает с домашней директорией текущего пользователя, а также соответствующий файл @file{/etc/passwd}.

note: type: table
en: The spawned process runs as the current user outside the container.  Inside the container, it has the same UID and GID as the current user, unless @option{--user} is passed (see below).
ru: Порождаемый процесс снаружи предстаёт как запущенный от текущего пользователя. Внутри контейнера он имеет такие же UID и GID, что и текущий пользователь, если не обозначена @option{--user} (смотрите ниже).

note: type: table
en: For containers, share the network namespace with the host system.  Containers created without this flag only have access to the loopback device.
ru: Разделять пространство сетевых имён контейнера с хостящей системой. Контейнеры, созданные без этого флага, могут только иметь доступ к петлевому устройству.

note: type: table
en: For containers, link the environment profile to @file{~/.guix-profile} within the container and set @code{GUIX_ENVIRONMENT} to that.  This is equivalent to making @file{~/.guix-profile} a symlink to the actual profile within the container.  Linking will fail and abort the environment if the directory already exists, which will certainly be the case if @command{guix shell} was invoked in the user's home directory.
ru: Связать профиль окружения контейнера с @file{~/.guix-profile} внутри контейнера. Это эквивалент запуска команды @command{ln -s $GUIX_ENVIRONMENT ~/.guix-profile} внутри контейнера. Связывание завершится ошибкой и отменит создание окружения, если директория уже существует, что, конечно, будет происходить, если @command{guix shell} вызвана в домашней директории пользователя.

note: type: table
en: Certain packages are configured to look in @file{~/.guix-profile} for configuration files and data;@footnote{For example, the @code{fontconfig} package inspects @file{~/.guix-profile/share/fonts} for additional fonts.} @option{--link-profile} allows these programs to behave as expected within the environment.
ru: Определённые пакеты сконфигурированы, чтобы смотреть конфигурационные файлы и данные в @code{~/.guix-profile};@footnote{Например, пакет @code{fontconfig} просматривает @file{~/.guix-profile/share/fonts} для дополнительных шрифтов.} @code{--link-profile} позволяет этим программам вести себя ожидаемо внутри окружения.

note: type: table
en: For containers, use the username @var{user} in place of the current user.  The generated @file{/etc/passwd} entry within the container will contain the name @var{user}, the home directory will be @file{/home/@var{user}}, and no user GECOS data will be copied.  Furthermore, the UID and GID inside the container are 1000.  @var{user} need not exist on the system.
ru: Использовать в контейнере имя пользователя @var{user} вместо текущего пользователя. Созданная внутри контейнера запись @file{/etc/passwd} будет содержать имя @var{user}, домашняя директория будет @file{/home/@var{user}}, но не будут копированы пользовательские данные GECOS. Более того, внутри контейнера UID и GID будут 1000.  @var{user} не обязательно должен существовать в системе.

note: type: table
en: Additionally, any shared or exposed path (see @option{--share} and @option{--expose} respectively) whose target is within the current user's home directory will be remapped relative to @file{/home/USER}; this includes the automatic mapping of the current working directory.
ru: В дополнение, любой разделяемый или расширяемый путь (смотрите @code{--share} и @code{--expose} соответственно), чьи цели находятся в домашней директории пользователя, будут отображены соответственно в @file{/home/USER}; это включает автоматическое отображение текущей рабочей директории.

note: type: table
en: While this will limit the leaking of user identity through home paths and each of the user fields, this is only one useful component of a broader privacy/anonymity solution---not one in and of itself.
ru: Это ограничит утечку данных идентификации пользователя через домашние пути и каждое из полей пользователя. Это один единственный компонент расширенного решения приватности/анонимности --- ничто не войдёт, ничто не выйдет.

note: type: table
en: For containers, the default behavior is to share the current working directory with the isolated container and immediately change to that directory within the container.  If this is undesirable, @option{--no-cwd} will cause the current working directory to @emph{not} be automatically shared and will change to the user's home directory within the container instead.  See also @option{--user}.
ru: Для контейнеров стандартным поведением является разделение текущего рабочего каталога с изолированным контейнером и немедленное переключение на этот каталог в контейнере. Если это нежелательно, @code{--no-cwd} приведет к автоматическому доступу к текущему рабочему каталогу @emph{not}, который изменится на домашний каталог пользователя в контейнере. Смотрите также @code{--user}.

note: type: table
en: For containers, @option{--expose} (resp. @option{--share}) exposes the file system @var{source} from the host system as the read-only (resp. writable) file system @var{target} within the container.  If @var{target} is not specified, @var{source} is used as the target mount point in the container.
ru: Расширить файловую систему контейнера источником @var{source} из хостящей системы в качестве файловой системы только для чтения с целью @var{target} внутри контейнера.  Если цель @var{target} не задана, источник @var{source} используется как целевая точка монтирования в контейнере.

note: type: table
en: The example below spawns a Guile REPL in a container in which the user's home directory is accessible read-only via the @file{/exchange} directory:
ru: Пример ниже порождает Guile REPL в контейнере, в котором домашняя директория пользователя доступна только для чтения через директорию @file{/exchange}:

note: type: cindex
en: persistent environment
ru: постоянное окружение

note: type: cindex
en: garbage collector root, for environments
ru: корень сборщика мусора, для окружений

note: type: table
en: Make @var{file} a symlink to the profile for this environment, and register it as a garbage collector root.
ru: Создать символическую ссылку @var{file} на профиль этого окружения и зарегистрировать её как корень сборщика мусора.

note: type: table
en: This is useful if you want to protect your environment from garbage collection, to make it ``persistent''.
ru: Это полезно, если вы хотите защитить своё окружение от сборщика мусора, сделать его "постоянным".

note: type: Plain text
en: @command{guix shell} also supports all of the common build options that @command{guix build} supports (@pxref{Common Build Options}) as well as package transformation options (@pxref{Package Transformation Options}).
ru: @command{guix shell} также поддерживает все обычные опции сборки, которые поддерживает команда @command{guix build} (@pxref{Common Build Options}), а также опции трансформации пакета (@pxref{Package Transformation Options}).

note: type: section
en: Invoking @command{guix environment}
ru: Вызов @command{guix environment}

note: type: Plain text
en: The following example spawns a new shell set up for the development of GNU@tie{}Guile:
ru: Следующий пример порождает новую оболочку, установленную для разработки GNU@tie{}Guile:

note: type: Plain text
en: If the needed dependencies are not built yet, @command{guix environment} automatically builds them.  The environment of the new shell is an augmented version of the environment that @command{guix environment} was run in.  It contains the necessary search paths for building the given package added to the existing environment variables.  To create a ``pure'' environment, in which the original environment variables have been unset, use the @option{--pure} option@footnote{Users sometimes wrongfully augment environment variables such as @env{PATH} in their @file{~/.bashrc} file.  As a consequence, when @command{guix environment} launches it, Bash may read @file{~/.bashrc}, thereby introducing ``impurities'' in these environment variables.  It is an error to define such environment variables in @file{.bashrc}; instead, they should be defined in @file{.bash_profile}, which is sourced only by log-in shells.  @xref{Bash Startup Files,,, bash, The GNU Bash Reference Manual}, for details on Bash start-up files.}.
ru: Если необходимые зависимости еще не собраны, @command{guix environment} автоматически построит их.  Среда новой оболочки - это расширенная версия среды, в которой была запущена @command{guix environment}.  Она содержит необходимые пути поиска для сборки данного пакета, добавленные к существующим переменным среды.  Чтобы создать ``чистую'' среду, в которой исходные переменные среды не были установлены, используйте параметр @option{--pure} @footnote{Пользователи иногда ошибочно изменяют переменные среды, такие как @env{PATH}, в своем @file{~/.bashrc} файле.  Как следствие, когда @command{guix environment} запускает его, Bash может читать @file{~/.bashrc}, тем самым вводя ``примеси'' в эти переменные среды.  Ошибочно определять такие переменные среды в @file{.bashrc}; вместо этого они должны быть определены в @file{.bash_profile}, источником которого являются только оболочки входа в систему.  @xref{Bash Startup Files,,, bash, The GNU Bash Reference Manual}, для получения подробной информации о файлах запуска Bash.}.

note: type: Plain text
en: Exiting from a Guix environment is the same as exiting from the shell, and will place the user back in the old environment before @command{guix environment} was invoked.  The next garbage collection (@pxref{Invoking guix gc}) will clean up packages that were installed from within the environment and are no longer used outside of it.
ru: Выход из окружения Guix аналогичен выходу из оболочки и возвращает пользователя в старое окружение до вызова @command{guix environment}.  Следующая сборка мусора (@pxref{Invoking guix gc}) очистит пакеты, которые были установлены в окружении и больше не используются за ее пределами.

note: type: Plain text
en: @command{guix environment} defines the @env{GUIX_ENVIRONMENT} variable in the shell it spawns; its value is the file name of the profile of this environment.  This allows users to, say, define a specific prompt for development environments in their @file{.bashrc} (@pxref{Bash Startup Files,,, bash, The GNU Bash Reference Manual}):
ru: @command{guix environment} определяет переменную @code{GUIX_ENVIRONMENT} в оболочке, которую создаёт; её значением является имя файла профиля этого окружения. Это позволяет пользователям, скажем, определить специфичные значения окружений разработки в @file{.bashrc} (@pxref{Bash Startup Files,,, bash, The GNU Bash Reference Manual}):

note: type: Plain text
en: Additionally, more than one package may be specified, in which case the union of the inputs for the given packages are used.  For example, the command below spawns a shell where all of the dependencies of both Guile and Emacs are available:
ru: Дополним, что может быть указано более одного пакета, в таком случае используется объединённые входные данные для указанных пакетов. Например, команда ниже порождает оболочку, в котором доступны все зависимости, как Guile, так и Emacs:

note: type: Plain text
en: Sometimes an interactive shell session is not desired.  An arbitrary command may be invoked by placing the @code{--} token to separate the command from the rest of the arguments:
ru: Иногда интерактивная сессия оболочки не нужна. Можно вызвать произвольную команду при указании токена @code{--}, который отделяет команду от остальных аргументов:

note: type: Plain text
en: Furthermore, one might want the dependencies of a package and also some additional packages that are not build-time or runtime dependencies, but are useful when developing nonetheless.  Because of this, the @option{--ad-hoc} flag is positional.  Packages appearing before @option{--ad-hoc} are interpreted as packages whose dependencies will be added to the environment.  Packages appearing after are interpreted as packages that will be added to the environment directly.  For example, the following command creates a Guix development environment that additionally includes Git and strace:
ru: Более того, возможно, вам потребуются зависимости пакета, а также некоторые дополнительные пакеты, которые не являются зависимостями процесса сборки или процесса исполнения (работы), но важны при разработке. Для этого и указан флаш @code{--ad-hoc}. Пакеты, обозначенные до @code{--ad-hoc} интерпретируются как пакеты, чьи зависимости будут добавлены в окружение. Пакеты, которые обозначены после @code{--ad-hoc}, интерпретируются как пакеты, которые будут добавлены в окружение непосредственно. Например, следующая команда создаёт окружение разработки Guix, которая в дополнение включает Git и strace:

note: type: example
en: guix environment --pure guix --ad-hoc git strace
ru: guix environment guix --ad-hoc git strace

note: type: Plain text
en: Sometimes it is desirable to isolate the environment as much as possible, for maximal purity and reproducibility.  In particular, when using Guix on a host distro that is not Guix System, it is desirable to prevent access to @file{/usr/bin} and other system-wide resources from the development environment.  For example, the following command spawns a Guile REPL in a ``container'' where only the store and the current working directory are mounted:
ru: Иногда возникает необходимость изолировать окружение настолько, насколькоо возможно, для максимальной чистоты и воспроизводимости. В частности, при использовании Guix на дистрибутиве, отличном от системы Guix, желательно предотвращать доступ из окружения разработки к @file{/usr/bin} и другим ресурсам системы. Например, следующая команда порождает Guile REPL в "контейнере", в котором монтированы только склад и текущая рабочая директория:

note: type: quotation
en: The @option{--container} option requires Linux-libre 3.19 or newer.
ru: Опция @code{--container} требует Linux-libre 3.19 или новее.

note: type: cindex
en: certificates
ru: Сертификаты X.509

note: type: Plain text
en: Another typical use case for containers is to run security-sensitive applications such as a web browser.  To run Eolie, we must expose and share some files and directories; we include @code{nss-certs} and expose @file{/etc/ssl/certs/} for HTTPS authentication; finally we preserve the @env{DISPLAY} environment variable since containerized graphical applications won't display without it.
ru: Другой типичный вариант использования контейнеров - запуск приложений, чувствительных к безопасности, таких как веб-браузер.  Чтобы запустить Eolie, мы должны предоставить доступ к некоторым файлам и каталогам; мы используем @code{nss-certs} и предоставляем @file{/etc /ssl /certs/} для аутентификации HTTPS; наконец, мы сохраняем переменную среды @env{DISPLAY}, поскольку контейнерные графические приложения не будут отображаться без нее.

note: type: table
en: When this option is omitted, the environment is protected from garbage collection only for the duration of the @command{guix environment} session.  This means that next time you recreate the same environment, you could have to rebuild or re-download packages.  @xref{Invoking guix gc}, for more on GC roots.
ru: Если эта опция пропущена, окружеие защищено от сборщика мусора только на время сессии @command{guix environment}. Это означает, что в следующий раз, когда вы создадите такое же окружение, вам потребуется пересобирать и скачивать пакеты заново. @xref{Invoking guix gc}, for more on GC roots.

note: type: table
en: Create an environment for the package or list of packages that the code within @var{file} evaluates to.
ru: Создать окружение для пакета или списка пакетов, код которых задан в файле @var{file}.

note: type: table
en: Include all specified packages in the resulting environment, as if an @i{ad hoc} package were defined with them as inputs.  This option is useful for quickly creating an environment without having to write a package expression to contain the desired inputs.
ru: Включить все указанные пакеты в результирующее окружение, если бы целевой (лат. @i{ad hoc}) пакет имел бы их как входные данные. Эта опция полезна для быстрого создания окружения без необходимости писать выражение типа пакет, содержащее желаемые входные данные.

note: type: table
en: For instance, the command:
ru: Например, команда:

note: type: table
en: runs @command{guile} in an environment where Guile and Guile-SDL are available.
ru: запускает @command{guile} в окружении, в котором доступны Guile и Guile-SDL.

note: type: table
en: Note that this example implicitly asks for the default output of @code{guile} and @code{guile-sdl}, but it is possible to ask for a specific output---e.g., @code{glib:bin} asks for the @code{bin} output of @code{glib} (@pxref{Packages with Multiple Outputs}).
ru: Отметим, что этот пример явно запрашивает выходы @code{guile} и @code{guile-sdl} по умолчанию, но возможно запросить специфичный выход, то есть @code{glib:bin} запрашивает выход @code{bin} из @code{glib} (@pxref{Packages with Multiple Outputs}).

note: type: table
en: This option may be composed with the default behavior of @command{guix environment}.  Packages appearing before @option{--ad-hoc} are interpreted as packages whose dependencies will be added to the environment, the default behavior.  Packages appearing after are interpreted as packages that will be added to the environment directly.
ru: Эта опция может сочетаться с поведением по умолчанию @command{guix environment}. Пакеты, которые появляются до @code{--ad-hoc} интерпретируются как пакеты, чьи зависимости будут добавлены в окружение (поведение по умолчанию). Пакеты, которые появляются после этой опции, интерпретируются как пакеты, которые будут добавлены в окружение непосредственно.

note: type: table
en: For containers, link the environment profile to @file{~/.guix-profile} within the container and set @code{GUIX_ENVIRONMENT} to that.  This is equivalent to making @file{~/.guix-profile} a symlink to the actual profile within the container.  Linking will fail and abort the environment if the directory already exists, which will certainly be the case if @command{guix environment} was invoked in the user's home directory.
ru: Связать профиль окружения контейнера с @file{~/.guix-profile} внутри контейнера. Это эквивалент запуска команды @command{ln -s $GUIX_ENVIRONMENT ~/.guix-profile} внутри контейнера. Связывание завершится ошибкой и отменит создание окружения, если директория уже существует, что, конечно, будет происходить, если @command{guix environment} вызвана в домашней директории пользователя.

note: type: Plain text
en: @command{guix environment} also supports all of the common build options that @command{guix build} supports (@pxref{Common Build Options}) as well as package transformation options (@pxref{Package Transformation Options}).
ru: @command{guix environment} также поддерживает все обычные опции сборки, которые поддерживает команда @command{guix build} (@pxref{Common Build Options}), а также опции трансформации пакета (@pxref{Package Transformation Options}).

note: type: section
en: Invoking @command{guix pack}
ru: Вызов @command{guix pack}

note: type: Plain text
en: Occasionally you want to pass software to people who are not (yet!)  lucky enough to be using Guix.  You'd tell them to run @command{guix package -i @var{something}}, but that's not possible in this case.  This is where @command{guix pack} comes in.
ru: Иногда бывает необходимо передать программу людям, которые (ещё!) не являются счастливыми обладателями Guix. Вы могли бы им рекомендовать заустить @command{guix package -i @var{something}}, но в данном случае это не подхлдит. Тогда @command{guix pack} решает вопрос.

note: type: quotation
en: If you are looking for ways to exchange binaries among machines that already run Guix, @pxref{Invoking guix copy}, @ref{Invoking guix publish}, and @ref{Invoking guix archive}.
ru: Если вы ищете способ обмена бинарниками между машинами, работающими с Guix, @pxref{Invoking guix copy}, @ref{Invoking guix publish} и @ref{Invoking guix archive}.

note: type: cindex
en: pack
ru: упаковка

note: type: cindex
en: bundle
ru: набор

note: type: cindex
en: application bundle
ru: набор приложений

note: type: cindex
en: software bundle
ru: набор приложений

note: type: Plain text
en: The @command{guix pack} command creates a shrink-wrapped @dfn{pack} or @dfn{software bundle}: it creates a tarball or some other archive containing the binaries of the software you're interested in, and all its dependencies.  The resulting archive can be used on any machine that does not have Guix, and people can run the exact same binaries as those you have with Guix.  The pack itself is created in a bit-reproducible fashion, so anyone can verify that it really contains the build results that you pretend to be shipping.
ru: Команда @command{guix pack} создаёт обёрнутый @dfn{набор} или @dfn{программный набор}: она создаёт архив tarball или другой архив, содержащий исполняемые файлы программного обеспечения, которое вас интересует, а также все его зависимости. Результирующий архив может использоваться на любой машине, которая не имеет Guix, а люди могут запустить совершенно такие же бинарники, как у вас в Guix. Набор создаётся со свойством воспроизводимости до бита, так что любой может проверить, что он действительно содержит результаты сборок, которые вы поставляете.

note: type: Plain text
en: For example, to create a bundle containing Guile, Emacs, Geiser, and all their dependencies, you can run:
ru: Например, чтобы создать набор, содержащий Guile, Emacs, Geiser и все их зависимости, можно запустить:

note: type: example
en: $ guix pack guile emacs emacs-geiser
    @dots{}
    /gnu/store/@dots{}-pack.tar.gz
ru: $ guix pack guile emacs geiser
    @dots{}
    /gnu/store/@dots{}-pack.tar.gz

note: type: Plain text
en: The result here is a tarball containing a @file{/gnu/store} directory with all the relevant packages.  The resulting tarball contains a @dfn{profile} with the three packages of interest; the profile is the same as would be created by @command{guix package -i}.  It is this mechanism that is used to create Guix's own standalone binary tarball (@pxref{Binary Installation}).
ru: Результатом будет архив tarball, содержащий директорию @file{/gnu/store} со всеми соответствующими пакетами. Результирующий архив содержат @dfn{профиль} с тремя запрошенными пакетами; профиль представляет то же самое, что можно создать командой @command{guix package -i}. Это механизм, который используется, собственно, для создания автономного (standalone) бинарного архива Guix (@pxref{Binary Installation}).

note: type: Plain text
en: Users of this pack would have to run @file{/gnu/store/@dots{}-profile/bin/guile} to run Guile, which you may find inconvenient.  To work around it, you can create, say, a @file{/opt/gnu/bin} symlink to the profile:
ru: Пользователи этого пакета должны запускать @file{/gnu/store/@dots{}-profile/bin/guile} для запуска Guile, что может быть не удобно. Чтобы исправить это, можно создать, например, символическую ссылку @file{/opt/gnu/bin} на профиль:

note: type: example
en: guix pack -S /opt/gnu/bin=bin guile emacs emacs-geiser
ru: guix pack -S /opt/gnu/bin=bin guile emacs geiser

note: type: Plain text
en: That way, users can happily type @file{/opt/gnu/bin/guile} and enjoy.
ru: Так пользователи смогут благополучно напечатать @file{/opt/gnu/bin/guile}, и всё хорошо.

note: type: cindex
en: relocatable binaries, with @command{guix pack}
ru: перемещаемые бинарники, с @command{guix pack}

note: type: Plain text
en: What if the recipient of your pack does not have root privileges on their machine, and thus cannot unpack it in the root file system? In that case, you will want to use the @option{--relocatable} option (see below).  This option produces @dfn{relocatable binaries}, meaning they they can be placed anywhere in the file system hierarchy: in the example above, users can unpack your tarball in their home directory and directly run @file{./opt/gnu/bin/guile}.
ru: Что если получатель вашего пакета не имеет привилегий root на своей машине, и поэтому не может распаковать его в корне файловой системы? В таком случае вам стоит использовать опцию @code{--relocatable} (смотрите ниже). Эта опция производит @dfn{перемещаемые бинарники}, в том плане, что они могут размещаться где угодно в иерархии файловой системы: в примере выше пользователи могут распаковать ваш архив в свои домашние директории и напрямую запустить @file{./opt/gnu/bin/guile}.

note: type: cindex
en: Docker, build an image with guix pack
ru: Docker, сборка образа с помощью guix pack

note: type: Plain text
en: Alternatively, you can produce a pack in the Docker image format using the following command:
ru: В качестве альтернативы можно производить пакет в формате образа Docker, используя следующую команду:

note: type: example
en: guix pack -f docker -S /bin=bin guile guile-readline
ru: guix pack -f docker guile emacs geiser

note: type: Plain text
en: The result is a tarball that can be passed to the @command{docker load} command, followed by @code{docker run}:
ru: Результатом будет архив, который можно передать команде @command{docker load}, followed by @code{docker run}:

note: type: Plain text
en: where @var{file} is the image returned by @var{guix pack}, and @code{guile-guile-readline} is its ``image tag''.  See the @uref{https://docs.docker.com/engine/reference/commandline/load/, Docker documentation} for more information.
ru: Результатом будет архив, который можно передать команде @command{docker load}. Смотрите @uref{https://docs.docker.com/engine/reference/commandline/load/, документацию Docker} для подробной информации.

note: type: cindex
en: Singularity, build an image with guix pack
ru: Singularity, сборка образа с помощью guix pack

note: type: cindex
en: SquashFS, build an image with guix pack
ru: SquashFS, сборка образа с помощью guix pack

note: type: Plain text
en: Yet another option is to produce a SquashFS image with the following command:
ru: Ещё одна опция производит образ SquashFS следующей командой:

note: type: example
en: guix pack -f squashfs bash guile emacs emacs-geiser
ru: guix pack -f squashfs guile emacs geiser

note: type: Plain text
en: The result is a SquashFS file system image that can either be mounted or directly be used as a file system container image with the @uref{https://www.sylabs.io/docs/, Singularity container execution environment}, using commands like @command{singularity shell} or @command{singularity exec}.
ru: Результатом будет образ файловой системы SquashFS, который может непосредственно монтироваться как образ, содержащий контейнер файловой системы, с помощью @uref{https://www.sylabs.io/docs/, контейнерного окружения Singularity}, используя команды типа @command{singularity shell} или @command{singularity exec}.

note: type: Plain text
en: Several command-line options allow you to customize your pack:
ru: Несколько опций командной строки позволяют вам переделывать ваш пакет:

note: type: table
en: Produce a pack in the given @var{format}.
ru: Произвести пакет в указанном формате @var{format}.

note: type: table
en: The available formats are:
ru: Возможные форматы:

note: type: table
en: This is the default format.  It produces a tarball containing all the specified binaries and symlinks.
ru: Это формат по умолчанию. Он производит архив tarball, содержащий все заданные бинарники и символические ссылки.

note: type: table
en: This produces a tarball that follows the @uref{https://github.com/docker/docker/blob/master/image/spec/v1.2.md, Docker Image Specification}.  The ``repository name'' as it appears in the output of the @command{docker images} command is computed from package names passed on the command line or in the manifest file.
ru: Это производит архив, соответствующий @uref{https://github.com/docker/docker/blob/master/image/spec/v1.2.md, спецификации образа Docker}.

note: type: table
en: This produces a SquashFS image containing all the specified binaries and symlinks, as well as empty mount points for virtual file systems like procfs.
ru: Это создает образ SquashFS, содержащий все указанные двоичные файлы и символические ссылки, а также пустые точки монтирования для виртуальных файловых систем, таких как procfs.

note: type: quotation
en: Singularity @emph{requires} you to provide @file{/bin/sh} in the image.  For that reason, @command{guix pack -f squashfs} always implies @code{-S /bin=bin}.  Thus, your @command{guix pack} invocation must always start with something like:
ru: Singularity @emph{требует}, чтобы вы указали @file{/bin /sh} в образе.  По этой причине @command{guix pack -f squashfs} всегда подразумевает @code{-S /bin=bin}.  Таким образом, вызов @command{guix pack} всегда должен начинаться с чего-то вроде:

note: type: example
en: guix pack -f squashfs bash @dots{}
ru: guix pack -f squashfs guile emacs geiser

note: type: quotation
en: If you forget the @code{bash} (or similar) package, @command{singularity run} and @command{singularity exec} will fail with an unhelpful ``no such file or directory'' message.
ru: Если вы забудете пакет @code{bash} (или аналогичный), @command{singularity run} и @command{singularity exec} выдаст бесполезное сообщение ``нет такого файла или каталога''.

note: type: cindex
en: relocatable binaries
ru: перемещаемые двоичные файлы

note: type: table
en: Produce @dfn{relocatable binaries}---i.e., binaries that can be placed anywhere in the file system hierarchy and run from there.
ru: Создавать @dfn{relocatable binaries} --- то есть двоичные файлы, которые можно разместить в любом месте иерархии файловой системы и запускать оттуда.

note: type: table
en: When this option is passed once, the resulting binaries require support for @dfn{user namespaces} in the kernel Linux; when passed @emph{twice}@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 other techniques if user namespaces are unavailable, and essentially work anywhere---see below for the implications.
ru: Когда эта опция передается один раз, конечные двоичные файлы требуют поддержки @dfn{user namespaces} в ядре Linux; при передаче @emph{дважды}@footnote{Вот трюк, чтобы запомнить его: @code{-RR}, который добавляет поддержку PRoot, можно рассматривать как сокращение от ``Really Relocatable''.  Удобно, не правда ли?}, Relocatable двоичные файлы возвращаются к другим методам, если пользовательские пространства имен недоступны, и по существу работают где угодно - см. ниже что под этим подразумевается.

note: type: table
en: For example, if you create a pack containing Bash with:
ru: Например, если вы создаете пакет, содержащий Bash, с помощью:

note: type: table
en: ...@: you can copy that pack to a machine that lacks Guix, and from your home directory as a normal user, run:
ru: ...@: вы можете скопировать этот пакет на машину, на которой отсутствует Guix, и из своего домашнего каталога как обычный пользователь запустите:

note: type: table
en: In that shell, if you type @code{ls /gnu/store}, you'll notice that @file{/gnu/store} shows up and contains all the dependencies of @code{bash}, even though the machine actually lacks @file{/gnu/store} altogether! That is probably the simplest way to deploy Guix-built software on a non-Guix machine.
ru: В этой оболочке, если вы наберете @code{ls /gnu/store}, вы заметите, что отобразятся @file{/gnu/store} и содержатся все зависимости @code{bash}, даже если на машине нет @file{/gnu/store}! Это, вероятно, самый простой способ установить программное обеспечение, созданное с помощью Guix, на машине, отличной от Guix.

note: type: quotation
en: By default, relocatable binaries rely on the @dfn{user namespace} feature of the kernel Linux, which allows unprivileged users to mount or change root.  Old versions of Linux did not support it, and some GNU/Linux distributions turn it off.
ru: По умолчанию relocatable двоичные файлы полагаются на функцию @dfn{user namespace} ядра Linux, которая позволяет непривилегированным пользователям монтировать или изменять root.  Старые версии Linux не поддерживали его, а некоторые дистрибутивы GNU/Linux его отключили.

note: type: quotation
en: To produce relocatable binaries that work even in the absence of user namespaces, pass @option{--relocatable} or @option{-R} @emph{twice}.  In that case, binaries will try user namespace support and fall back to another @dfn{execution engine} if user namespaces are not supported.  The following execution engines are supported:
ru: Чтобы создать relocatable двоичные файлы, которые работают даже при отсутствии пользовательских пространств имен, передайте @option{--relocatable} или @option{-R} @emph{дважды}.  В этом случае двоичные файлы будут пытаться использовать пространство имен пользователей и возвращаться к другому @dfn{механизму выполнения}, если пространства имен пользователей не поддерживаются.  Поддерживаются следующие механизмы выполнения:

note: type: item
en: default
ru: по умолчанию

note: type: table
en: Try user namespaces and fall back to PRoot if user namespaces are not supported (see below).
ru: Попробовать использовать пространства имен пользователей и вернуться к PRoot, если пространства имен пользователей не поддерживаются (см. ниже).

note: type: item
en: performance
ru: форматирование кода

note: type: table
en: Try user namespaces and fall back to Fakechroot if user namespaces are not supported (see below).
ru: Попробовать использовать пространства имен пользователей и вернуться к Fakechroot, если пространства имен пользователей не поддерживаются (см. ниже).

note: type: item
en: userns
ru: user

note: type: table
en: Run the program through user namespaces and abort if they are not supported.
ru: Запустить программу через пользовательские пространства имен и прервать, если они не поддерживаются.

note: type: item
en: proot
ru: chroot

note: type: table
en: Run through PRoot.  The @uref{https://proot-me.github.io/, PRoot} program provides the necessary support for file system virtualization.  It achieves that by using the @code{ptrace} system call on the running program.  This approach has the advantage to work without requiring special kernel support, but it incurs run-time overhead every time a system call is made.
ru: Запустить PRoot.  Программа @uref{https://proot-me.github.io/, PRoot} обеспечивает необходимую поддержку виртуализации файловой системы.  Это достигается с помощью системного вызова @code{ptrace} в запущенной программе.  Преимущество этого подхода заключается в том, что это не требует специальной поддержки ядра, но это требует дополнительных затрат времени выполнения каждый раз, когда выполняется системный вызов.

note: type: item
en: fakechroot
ru: chroot

note: type: table
en: Run through Fakechroot.  @uref{https://github.com/dex4er/fakechroot/, Fakechroot} virtualizes file system accesses by intercepting calls to C library functions such as @code{open}, @code{stat}, @code{exec}, and so on.  Unlike PRoot, it incurs very little overhead.  However, it does not always work: for example, some file system accesses made from within the C library are not intercepted, and file system accesses made @i{via} direct syscalls are not intercepted either, leading to erratic behavior.
ru: Запустить Fakechroot. @uref{https://github.com/dex4er/fakechroot/, Fakechroot} виртуализирует доступ к файловой системе путем перехвата вызовов функций библиотеки C, таких как @code{open}, @code{stat}, @code{exec} и т.п.  В отличие от PRoot, накладных расходов очень мало.  Однако это не всегда работает: например, некоторые обращения к файловой системе, сделанные из библиотеки C, не перехватываются, а обращения к файловой системе, сделанные @i{через} прямые системные вызовы, также не перехватываются, что приводит к нестабильному поведению.

note: type: quotation
en: When running a wrapped program, you can explicitly request one of the execution engines listed above by setting the @env{GUIX_EXECUTION_ENGINE} environment variable accordingly.
ru: При запуске обернутой программы вы можете явно запросить один из механизмов выполнения, перечисленных выше, установив соответствующую переменную среды @env{GUIX_EXECUTION_ENGINE}.

note: type: cindex
en: entry point, for Docker images
ru: точка входа, для Docker образов

note: type: item
en: --entry-point=@var{command}
ru: --commit=@var{commit}

note: type: table
en: Use @var{command} as the @dfn{entry point} of the resulting pack, if the pack format supports it---currently @code{docker} and @code{squashfs} (Singularity)  support it.  @var{command} must be relative to the profile contained in the pack.
ru: Используйте @var{command} в качестве @dfn{точки входа} конечного пакета, если формат пакета поддерживает это --- в настоящее время @code{docker} и @code{squashfs} (Singularity) поддерживают это.  @var{command} должна относиться к профилю, содержащемуся в пакете.

note: type: table
en: The entry point specifies the command that tools like @code{docker run} or @code{singularity run} automatically start by default.  For example, you can do:
ru: Точка входа указывает команду, которую по умолчанию автоматически запускают такие инструменты, как @code{docker run} или @code{singularity run}.  Например, вы можете сделать:

note: type: example
en: guix pack -f docker --entry-point=bin/guile guile
ru: guix pack -f docker guile emacs geiser

note: type: table
en: The resulting pack can easily be loaded and @code{docker run} with no extra arguments will spawn @code{bin/guile}:
ru: Полученный пакет может быть легко импортирован, и запущен через @code{docker run} без дополнительных аргументов, пораждая @code{bin/guile}:

note: type: table
en: Consider the package @var{expr} evaluates to.
ru: Процедура, при выполнении которой возвращается пакет.

note: type: table
en: This has the same purpose as the same-named option in @command{guix build} (@pxref{Additional Build Options, @option{--expression} in @command{guix build}}).
ru: Это то же, что опция с таким же именем в @command{guix package} (@pxref{profile-manifest, @option{--manifest}}) и использует такие же файлы манифестов.

note: type: table
en: Use the packages contained in the manifest object returned by the Scheme code in @var{file}.  This option can be repeated several times, in which case the manifests are concatenated.
ru: Использовать пакеты, содержащиеся в объекте манифеста, возвращенном кодом Scheme в @var{file}.  Эта опция может быть указана несколько раз, и в этом случае манифесты объединяются.

note: type: table
en: This has a similar purpose as the same-named option in @command{guix package} (@pxref{profile-manifest, @option{--manifest}}) and uses the same manifest files.  It allows you to define a collection of packages once and use it both for creating profiles and for creating archives for use on machines that do not have Guix installed.  Note that you can specify @emph{either} a manifest file @emph{or} a list of packages, but not both.
ru: Она служит для того же, что и одноименная опция в @command{guix package} (@pxref{profile-manifest, @option{--manifest}}) и использует те же файлы манифеста.  Она позволяет вам один раз определить набор пакетов и использовать его как для создания профилей, так и для создания архивов для использования на машинах, на которых не установлен Guix.  Обратите внимание, что вы можете указать @emph{либо} файл манифеста @emph{либо} список пакетов, но не то и другое вместе.

note: type: cindex
en: cross-compilation
ru: кросс-компиляция

note: type: table
en: Cross-build for @var{triplet}, which must be a valid GNU triplet, such as @code{"aarch64-linux-gnu"} (@pxref{Specifying target triplets, GNU configuration triplets,, autoconf, Autoconf}).
ru: Cross-сборка для @var{triplet}, который должен быть допустимым GNU triplet, например @code{\ "aarch64-linux-gnu\"} (@pxref{Specifying target triplets, GNU configuration triplets,, autoconf, Autoconf}).

note: type: table
en: Compress the resulting tarball using @var{tool}---one of @code{gzip}, @code{zstd}, @code{bzip2}, @code{xz}, @code{lzip}, or @code{none} for no compression.
ru: Архивировать логи сборки методом @var{type}. Это один из: @code{gzip}, @code{bzip2} или @code{none}.

note: type: table
en: Add the symlinks specified by @var{spec} to the pack.  This option can appear several times.
ru: Добавить в пакет символические ссылки, указанные в @var{spec}.  Эта опция может быть указана несколько раз.

note: type: table
en: @var{spec} has the form @code{@var{source}=@var{target}}, where @var{source} is the symlink that will be created and @var{target} is the symlink target.
ru: @var{spec} имеет вид @code{@var{source}=@var{target}}, где @var{source} - это символическая ссылка, которая будет создана, а @var{target} - это цель символьной ссылки.

note: type: table
en: For instance, @code{-S /opt/gnu/bin=bin} creates a @file{/opt/gnu/bin} symlink pointing to the @file{bin} sub-directory of the profile.
ru: Например, @code{-S /opt/gnu/bin=bin} создает символическую ссылку @file{/opt/gnu/bin}, указывающую на подкаталог @file{bin} профиля.

note: type: table
en: Save provenance information for the packages passed on the command line.  Provenance information includes the URL and commit of the channels in use (@pxref{Channels}).
ru: Сохранить информацию о происхождении пакетов, переданных в командной строке.  Информация о происхождении включает в себя URL и фиксацию используемых каналов (@pxref{Channels}).

note: type: table
en: Provenance information is saved in the @file{/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.
ru: Информация о происхождении сохраняется в файле @file{/gnu/store/@dots{}-profile/manifest} в пакете вместе с обычными метаданными пакета - названием и версией каждого пакета, их propagated inputs и т.п.  Это полезная информация для получателя pack, который исходя из нее знает, как (предположительно) был собран pack.

note: type: table
en: 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.
ru: Этот параметр не включен по умолчанию, поскольку, как и временные метки, информация о происхождении не влияет на процесс сборки.  Другими словами, существует бесконечное количество URL-адресов каналов и ID коммитов, которые могут привести к одному и тому же pack.  Таким образом, запись таких ``тихих'' метаданных в output потенциально нарушает свойство побитовой воспроизводимости.

note: type: cindex
en: garbage collector root, for packs
ru: корни сборщика мусора

note: type: table
en: Make @var{file} a symlink to the resulting pack, and register it as a garbage collector root.
ru: Создать символическую ссылку @var{file} на профиль этого окружения и зарегистрировать её как корень сборщика мусора.

note: type: table
en: Include the ``local state directory'', @file{/var/guix}, in the resulting pack, and notably the @file{/var/guix/profiles/per-user/root/@var{name}} profile---by default @var{name} is @code{guix-profile}, which corresponds to @file{~root/.guix-profile}.
ru: Включите в конечный пакет ``локальный каталог состояния'', @file{/var/guix} и, в частности, профиль @file{/var/guix/profiles/per-user/root/@var{name}} --- по умолчанию @var{name} - это @code{guix-profile}, что соответствует @file{~root/.guix-profile}.

note: type: table
en: @file{/var/guix} contains the store database (@pxref{The Store}) as well as garbage-collector roots (@pxref{Invoking guix gc}).  Providing it in the pack means that the store is ``complete'' and manageable by Guix; not providing it pack means that the store is ``dead'': items cannot be added to it or removed from it after extraction of the pack.
ru: @file{/var/guix} содержит базу данных store (@pxref{The Store}), а также корни сборщика мусора (@pxref{Invoking guix gc}).  Предоставление ее в pack означает, что store является ``полным'' и управляемым Guix; отсутствие в pack означает, что store ``мертв'': пакеты нельзя добавить в него или удалить из него после извлечения pack.

note: type: table
en: One use case for this is the Guix self-contained binary tarball (@pxref{Binary Installation}).
ru: Одним из вариантов использования является включающий себя двоичный архив Guix (@pxref{Binary Installation}).

note: type: table
en: Print the name of the derivation that builds the pack.
ru: Выведите имя derivation, которая создает pack.

note: type: table
en: Use the bootstrap binaries to build the pack.  This option is only useful to Guix developers.
ru: Использовать bootstrap бинарники для сборки пакета.  Эта опция полезна только разработчикам Guix.

note: type: Plain text
en: In addition, @command{guix pack} supports all the common build options (@pxref{Common Build Options}) and all the package transformation options (@pxref{Package Transformation Options}).
ru: Кроме того, @command{guix pack} поддерживает все стандартные параметры сборки (@pxref{Common Build Options}) и все параметры преобразования пакетов (@pxref{Package Transformation Options}).

note: type: cindex
en: linker wrapper
ru: ld-wrapper

note: type: cindex
en: toolchain, for C development
ru: Разработка программного обеспечения

note: type: cindex
en: toolchain, for Fortran development
ru: инструменты, для разработки на Fortran

note: type: Plain text
en: If you need a complete toolchain for compiling and linking C or C++ source code, use the @code{gcc-toolchain} package.  This package provides a complete GCC toolchain for C/C++ development, including GCC itself, the GNU C Library (headers and binaries, plus debugging symbols in the @code{debug} output), Binutils, and a linker wrapper.
ru: Guix предлагает индивидуальные пакеты компиляторов, как например, @code{gcc}. Но если вам необходим полный набор инструментов (тулчейн) для компиляции и линковки исходного кода, тогда то, что вам действительно нужно, --- это пакет @code{gcc-toolchain}. Этот пакет предоставляет полный тулчейн GCC для разработки C/C++, включая сам GCC, библиотеку GNU C (заголовки и бинарники, а также отладочные символы в выходе @code{debug}), Binutils и набор линковщика.

note: type: Plain text
en: The wrapper's purpose is to inspect the @code{-L} and @code{-l} switches passed to the linker, add corresponding @code{-rpath} arguments, and invoke the actual linker with this new set of arguments.  You can instruct the wrapper to refuse to link against libraries not in the store by setting the @env{GUIX_LD_WRAPPER_ALLOW_IMPURITIES} environment variable to @code{no}.
ru: Цель оболочки --- проверять опции @code{-L} и @code{-l}, направленные линковщику, и соответствующие аргументы @code{-rpath}, и вызывать соответствующий линковщик с этим новым набором аргументов. Вы можете указать оболочке отклонять линковку с библиотеками, находящимися не на складе, установив переменную окружения @code{GUIX_LD_WRAPPER_ALLOW_IMPURITIES} в значение @code{no}.

note: type: Plain text
en: The package @code{gfortran-toolchain} provides a complete GCC toolchain for Fortran development.  For other languages, please use @samp{guix search gcc toolchain} (@pxref{guix-search,, Invoking guix package}).
ru: Пакет @code{gfortran-toolchain} предоставляет полный набор инструментов GCC для разработки Fortran.  Для других языков используйте @samp{guix search gcc toolchain} (@pxref{guix-search,, Invoking guix package}).

note: type: section
en: Invoking @command{guix git authenticate}
ru: Вызов @command{guix package}

note: type: Plain text
en: The @command{guix git authenticate} command authenticates a Git checkout following the same rule as for channels (@pxref{channel-authentication, channel authentication}).  That is, starting from a given commit, it ensures that all subsequent commits are signed by an OpenPGP key whose fingerprint appears in the @file{.guix-authorizations} file of its parent commit(s).
ru: Команда @command{guix git Authenticate} аутентифицирует проверку Git по тому же правилу, что и для каналов (@pxref{channel-authentication, channel authentication}).  То есть, начиная с данного коммита, он гарантирует, что все последующие коммиты подписаны ключом OpenPGP, отпечаток которого указан в файле @file{.guix-authorizations} его родительского коммита(ов).

note: type: Plain text
en: You will find this command useful if you maintain a channel.  But in fact, this authentication mechanism is useful in a broader context, so you might want to use it for Git repositories that have nothing to do with Guix.
ru: Вы найдете эту команду полезной, если будете поддерживать канал.  Но на самом деле этот механизм аутентификации полезен в более широком контексте, поэтому вы можете использовать его для репозиториев Git, которые не имеют ничего общего с Guix.

note: type: example
en: guix git authenticate @var{commit} @var{signer} [@var{options}@dots{}]
ru: guix environment @var{options} @var{package}@dots{}

note: type: Plain text
en: By default, this command authenticates the Git checkout in the current directory; it outputs nothing and exits with exit code zero on success and non-zero on failure.  @var{commit} above denotes the first commit where authentication takes place, and @var{signer} is the OpenPGP fingerprint of public key used to sign @var{commit}.  Together, they form a ``channel introduction'' (@pxref{channel-authentication, channel introduction}).  The options below allow you to fine-tune the process.
ru: По умолчанию эта команда аутентифицирует проверку Git в текущем каталоге; она ничего не выводит и завершает работу с нулевым кодом в случае успеха и ненулевым в случае неудачи.  @var{commit} выше обозначает первый коммит, в котором происходит аутентификация, а @var{signer} - это отпечаток открытого ключа OpenPGP, используемый для подписи @var{commit}.  Вместе они образуют ``channel introduction'' (@pxref{channel-authentication, channel introduction}).  Указанные ниже параметры позволяют вам точно настроить процесс.

note: type: item
en: --repository=@var{directory}
ru: --extract=@var{directory}

note: type: itemx
en: -r @var{directory}
ru: -x @var{directory}

note: type: table
en: Open the Git repository in @var{directory} instead of the current directory.
ru: Открыть репозиторий Git в @var{directory} вместо текущего каталога.

note: type: item
en: --keyring=@var{reference}
ru: --expression=@var{expr}

note: type: itemx
en: -k @var{reference}
ru: -F @var{free}

note: type: table
en: Load OpenPGP keyring from @var{reference}, the reference of a branch such as @code{origin/keyring} or @code{my-keyring}.  The branch must contain OpenPGP public keys in @file{.key} files, either in binary form or ``ASCII-armored''.  By default the keyring is loaded from the branch named @code{keyring}.
ru: Загрузить связку ключей OpenPGP из @var{reference}, ссылки на branch, например @code{origin/keyring} или @code{my-keyring}.  branch должна содержать открытые ключи OpenPGP в файлах @file{.key} либо в двоичной форме, либо в ``ASCII-armored'' виде.  По умолчанию связка ключей загружается из branch с именем @code{keyring}.

note: type: table
en: Display commit signing statistics upon completion.
ru: Отобразить статистику подписания commit'ов по завершению.

note: type: item
en: --cache-key=@var{key}
ru: --search=@var{regexp}

note: type: table
en: Previously-authenticated commits are cached in a file under @file{~/.cache/guix/authentication}.  This option forces the cache to be stored in file @var{key} in that directory.
ru: Ранее аутентифицированные коммиты кэшируются в файле под @file{~/.cache/guix/authentication}.  Эта опция заставляет хранить кеш в файле @var{key} в этом каталоге.

note: type: item
en: --historical-authorizations=@var{file}
ru: --install-from-file=@var{file}

note: type: table
en: By default, any commit whose parent commit(s) lack the @file{.guix-authorizations} file is considered inauthentic.  In contrast, this option considers the authorizations in @var{file} for any commit that lacks @file{.guix-authorizations}.  The format of @var{file} is the same as that of @file{.guix-authorizations} (@pxref{channel-authorizations, @file{.guix-authorizations} format}).
ru: По умолчанию любой коммит, родительский коммит которого не содержит файла @file{.guix-authorizations}, считается недостоверным.  Напротив, эта опция учитывает авторизацию в @var{file} для любого коммита, в котором отсутствует @file{.guix-authorizations}.  Формат @var{file} такой же, как у @file{.guix-authorizations} (@pxref{channel-authorizations, @file{.guix-authorizations} format}).

note: type: Plain text
en: GNU Guix provides several Scheme programming interfaces (APIs) to define, build, and query packages.  The first interface allows users to write high-level package definitions.  These definitions refer to familiar packaging concepts, such as the name and version of a package, its build system, and its dependencies.  These definitions can then be turned into concrete build actions.
ru: GNU Guix предоставляет несколько Scheme программных интерфейсов (API) для определения, сборки и запроса пакетов.  Первый интерфейс позволяет пользователям писать высокоуровневые определения пакетов.  Эти определения относятся к знакомым концепциям упаковки, таким как имя и версия пакета, его система сборки и зависимости.  Затем эти определения можно превратить в конкретные действия по сборке.

note: type: Plain text
en: Build actions are performed by the Guix daemon, on behalf of users.  In a standard setup, the daemon has write access to the store---the @file{/gnu/store} directory---whereas users do not.  The recommended setup also has the daemon perform builds in chroots, under specific build users, to minimize interference with the rest of the system.
ru: Действия по сборке выполняются демоном Guix от имени пользователей.  В стандартной настройке демон имеет доступ на запись в хранилище---каталог @file{/gnu/store}---, в то время как пользователи не имеют.  Рекомендуемая установка также предусматривает, что демон выполняет сборки в chroot, под определенными пользователями сборки, чтобы минимизировать влияние на остальную систему.

note: type: Plain text
en: Lower-level APIs are available to interact with the daemon and the store.  To instruct the daemon to perform a build action, users actually provide it with a @dfn{derivation}.  A derivation is a low-level representation of the build actions to be taken, and the environment in which they should occur---derivations are to package definitions what assembly is to C programs.  The term ``derivation'' comes from the fact that build results @emph{derive} from them.
ru: Доступны API нижнего уровня для взаимодействия с демоном и хранилищем.  Чтобы дать демону команду выполнить действие сборки, пользователи фактически предоставляют ему @dfn{derivation}. Derivation - это низкоуровневое представление действий сборки, которые должны быть предприняты, и среды, в которой они должны происходить - derivation'ы относятся к определениям пакетов, как сборка для программ на C.  Термин ``derivation'' происходит от того факта, что результаты сборки @emph{производные} от них.

note: type: Plain text
en: This chapter describes all these APIs in turn, starting from high-level package definitions.
ru: В этой главе описываются все эти API по очереди, начиная с определений пакетов высокого уровня.

note: type: menuentry
en: Programming Guix in Guile
ru: Программирование Guix в Guile

note: type: Plain text
en: From a programming viewpoint, the package definitions of the GNU distribution are provided by Guile modules in the @code{(gnu packages @dots{})} name space@footnote{Note that packages under the @code{(gnu packages @dots{})} module name space are not necessarily ``GNU packages''.  This module naming scheme follows the usual Guile module naming convention: @code{gnu} means that these modules are distributed as part of the GNU system, and @code{packages} identifies modules that define packages.} (@pxref{Modules, Guile modules,, guile, GNU Guile Reference Manual}).  For instance, the @code{(gnu packages emacs)} module exports a variable named @code{emacs}, which is bound to a @code{<package>} object (@pxref{Defining Packages}).
ru: С точки зрения программирования, определения пакетов дистрибутива GNU предоставляются модулями Guile в пространстве имен @code{(gnu packages @dots{})} @footnote{Обратите внимание, что пакеты в @code{(gnu packages @dots{})} пространстве имен модуля не обязательно являются ``пакетами GNU''.  Эта схема именования модулей соответствует обычному соглашению об именах модулей Guile: @code{gnu} означает, что эти модули распространяются как часть системы GNU, а @code{packages} идентифицирует модули, которые определяют пакеты.} (@pxref{Modules, Guile modules,, guile, GNU Guile Reference Manual})).  Например, модуль @code{(gnu packages emacs)} экспортирует переменную с именем @code{emacs}, которая привязана к @code{<package>} объекту (@pxref{Defining Packages}).

note: type: Plain text
en: The @code{(gnu packages @dots{})} module name space is automatically scanned for packages by the command-line tools.  For instance, when running @code{guix install emacs}, all the @code{(gnu packages @dots{})} modules are scanned until one that exports a package object whose name is @code{emacs} is found.  This package search facility is implemented in the @code{(gnu packages)} module.
ru: Пространство имен модуля @code{(gnu packages @dots{})} автоматически сканируется на наличие пакетов с помощью инструментов командной строки.  Например, при запуске @code{guix install emacs} все модули @code{(gnu packages @dots{})} сканируются до тех пор, пока не будет найден тот, который экспортирует объект пакета с именем @code{emacs}.  Это средство поиска пакетов реализовано в модуле @code{(gnu packages)}.

note: type: cindex
en: package module search path
ru: путь для поиска пакетных модулей

note: type: Plain text
en: Users can store package definitions in modules with different names---e.g., @code{(my-packages emacs)}@footnote{Note that the file name and module name must match.  For instance, the @code{(my-packages emacs)} module must be stored in a @file{my-packages/emacs.scm} file relative to the load path specified with @option{--load-path} or @env{GUIX_PACKAGE_PATH}.  @xref{Modules and the File System,,, guile, GNU Guile Reference Manual}, for details.}.  There are two ways to make these package definitions visible to the user interfaces:
ru: Пользователи могут хранить определения пакетов в модулях с разными именами - например, @code{(my-packages emacs)} @footnote{Обратите внимание, что имя файла и имя модуля должны совпадать.  Например, модуль @code{(my-packages emacs)} должен храниться в файле @file{my-packages/emacs.scm} относительно пути загрузки, указанного с помощью @option{--load-path} или @env{GUIX_PACKAGE_PATH}.  @xref{Modules and the File System,,, guile, GNU Guile Reference Manual}, для подробностей.}.  Есть два способа сделать эти определения пакетов видимыми для пользовательских интерфейсов:

note: type: enumerate
en: By adding the directory containing your package modules to the search path with the @code{-L} flag of @command{guix package} and other commands (@pxref{Common Build Options}), or by setting the @env{GUIX_PACKAGE_PATH} environment variable described below.
ru: Добавить каталог, содержащий модули вашего пакета, в пути поиска с помощью флага @code{-L} команды @command{guix package} и другие команды (@pxref{Common Build Options}) или указать переменную окружения @env{GUIX_PACKAGE_PATH}, описанную ниже.

note: type: enumerate
en: By defining a @dfn{channel} and configuring @command{guix pull} so that it pulls from it.  A channel is essentially a Git repository containing package modules.  @xref{Channels}, for more information on how to define and use channels.
ru: Определить @dfn{канал} и настроить @command{guix pull} так, чтобы он учитывал его.  Канал - это, по сути, репозиторий Git, содержащий модули пакетов.  @xref{Channels}, чтобы узнать больше о том, как определять и использовать каналы.

note: type: Plain text
en: @env{GUIX_PACKAGE_PATH} works similarly to other search path variables:
ru: @env{GUIX_PACKAGE_PATH} работает аналогично другим переменным пути поиска:

note: type: defvr
en: This is a colon-separated list of directories to search for additional package modules.  Directories listed in this variable take precedence over the own modules of the distribution.
ru: Это список каталогов, разделенных двоеточиями, для поиска дополнительных модулей пакета.  Каталоги, перечисленные в этой переменной, имеют приоритет над собственными модулями дистрибутива.

note: type: Plain text
en: The distribution is fully @dfn{bootstrapped} and @dfn{self-contained}: each package is built based solely on other packages in the distribution.  The root of this dependency graph is a small set of @dfn{bootstrap binaries}, provided by the @code{(gnu packages bootstrap)} module.  For more information on bootstrapping, @pxref{Bootstrapping}.
ru: Дистрибутив полностью @dfn{bootstrapped} и @dfn{самодостаточный}: каждый пакет построен исключительно на основе других пакетов в дистрибутиве.  Корнем этого графа зависимостей является небольшой набор @dfn{bootstrap бинарный файлы}, предоставляемых модулем @code{(gnu packages bootstrap)}.  Для получения дополнительной информации о начальной загрузке @pxref{Bootstrapping}.

note: type: Plain text
en: The high-level interface to package definitions is implemented in the @code{(guix packages)} and @code{(guix build-system)} modules.  As an example, the package definition, or @dfn{recipe}, for the GNU Hello package looks like this:
ru: Интерфейс высокого уровня к определениям пакетов реализован в модулях @code{(guix packages)} и @code{(guix build-system)}.  Например, определение пакета или @dfn{рецепта} для пакета GNU Hello выглядит так:

note: type: Plain text
en: Without being a Scheme expert, the reader may have guessed the meaning of the various fields here.  This expression binds the variable @code{hello} to a @code{<package>} object, which is essentially a record (@pxref{SRFI-9, Scheme records,, guile, GNU Guile Reference Manual}).  This package object can be inspected using procedures found in the @code{(guix packages)} module; for instance, @code{(package-name hello)} returns---surprise!---@code{"hello"}.
ru: Не будучи Scheme экспертом, вы можете догадаться о значении различных полей.  Это выражение связывает переменную @code{hello} с объектом @code{<package>}, который по сути является record (@pxref{SRFI-9, Scheme records,, guile, GNU Guile Reference Manual}).  Этот объект пакета можно проверить с помощью процедур из модуля @code{(guix packages)}; например, @code{(package-name hello)} возвращает---сюрприз!---@code{"hello"}.

note: type: Plain text
en: With luck, you may be able to import part or all of the definition of the package you are interested in from another repository, using the @code{guix import} command (@pxref{Invoking guix import}).
ru: Если повезет, вы сможете импортировать часть или все определение интересующего вас пакета из другого репозитория с помощью команды @code{guix import} (@pxref{Invoking guix import}).

note: type: Plain text
en: In the example above, @code{hello} is defined in a module of its own, @code{(gnu packages hello)}.  Technically, this is not strictly necessary, but it is convenient to do so: all the packages defined in modules under @code{(gnu packages @dots{})} are automatically known to the command-line tools (@pxref{Package Modules}).
ru: В приведенном выше примере @code{hello} определен в собственном модуле @code{(gnu packages hello)}.  Технически в этом нет строгой необходимости, но это удобно: все пакеты, определенные в модулях под @code{(gnu packages @dots{})}, автоматически становятся известны инструментам командной строки (@pxref{Package Modules}).

note: type: Plain text
en: There are a few points worth noting in the above package definition:
ru: В приведенном выше определении пакета стоит отметить несколько моментов:

note: type: itemize
en: The @code{source} field of the package is an @code{<origin>} object (@pxref{origin Reference}, for the complete reference).  Here, the @code{url-fetch} method from @code{(guix download)} is used, meaning that the source is a file to be downloaded over FTP or HTTP.
ru: Поле @code{source} пакета представляет собой объект @code{<origin>} (@pxref{origin Reference}, for the complete reference).  Здесь используется метод @code{url-fetch} из @code{(guix download)}, что означает, что источником является файл, который нужно загрузить через FTP или HTTP.

note: type: itemize
en: The @code{mirror://gnu} prefix instructs @code{url-fetch} to use one of the GNU mirrors defined in @code{(guix download)}.
ru: Префикс @code{mirror://gnu} указывает @code{url-fetch} использовать одно из зеркал GNU, определенных в @code{(guix download)}.

note: type: itemize
en: The @code{sha256} field specifies the expected SHA256 hash of the file being downloaded.  It is mandatory, and allows Guix to check the integrity of the file.  The @code{(base32 @dots{})} form introduces the base32 representation of the hash.  You can obtain this information with @code{guix download} (@pxref{Invoking guix download}) and @code{guix hash} (@pxref{Invoking guix hash}).
ru: Поле @code{sha256} указывает ожидаемый хэш SHA256 загружаемого файла.  Это обязательно и позволяет Guix проверять целостность файла.  Форма @code{(base32 @dots{})} указывает представление хеша в формате base32.  Вы можете получить эту информацию с помощью @code{guix download} (@pxref{Invoking guix download}) @code{guix hash} (@pxref{Invoking guix hash}).

note: type: cindex
en: patches
ru: патчи

note: type: itemize
en: When needed, the @code{origin} form can also have a @code{patches} field listing patches to be applied, and a @code{snippet} field giving a Scheme expression to modify the source code.
ru: При необходимости форма @code{origin} может также иметь поле @code{patches} со списком исправлений, которые необходимо применить, и поле @code{snippet}, содержащее Scheme выражение для изменения исходного кода.

note: type: cindex
en: GNU Build System
ru: Система сборки GNU

note: type: itemize
en: The @code{build-system} field specifies the procedure to build the package (@pxref{Build Systems}).  Here, @code{gnu-build-system} represents the familiar GNU Build System, where packages may be configured, built, and installed with the usual @code{./configure && make && make check && make install} command sequence.
ru: Поле @code{build-system} указывает процедуру сборки пакета (@pxref{Build Systems}).  Здесь @code{gnu-build-system} представляет знакомую систему сборки GNU, в которой пакеты могут быть настроены, собраны и установлены с помощью обычной последовательности команд @code{./configure && make && make check && make install}.

note: type: itemize
en: When you start packaging non-trivial software, you may need tools to manipulate those build phases, manipulate files, and so on.  @xref{Build Utilities}, for more on this.
ru: Когда вы начинаете упаковывать нетривиальное программное обеспечение, вам могут потребоваться инструменты для управления этими этапами сборки, управления файлами и т.д. @xref{Build Utilities}, чтобы узнать об этом подробнее.

note: type: itemize
en: The @code{arguments} field specifies options for the build system (@pxref{Build Systems}).  Here it is interpreted by @code{gnu-build-system} as a request run @file{configure} with the @option{--enable-silent-rules} flag.
ru: Поле @code{arguments} определяет параметры для системы сборки (@pxref{Build Systems}).  В примере это интерпретируется @code{gnu-build-system} как запуск запроса @file{configure} с флагом @option{--enable-silent-rules}.

note: type: findex
en: quote
ru: цитата

note: type: cindex
en: quoting
ru: цитирование

note: type: cindex
en: backquote (quasiquote)
ru: обратная цитата (квазицитата)

note: type: cindex
en: comma (unquote)
ru: запятая (не цитирование)

note: type: itemize
en: The hash-colon (@code{#:}) sequence defines a Scheme @dfn{keyword} (@pxref{Keywords,,, guile, GNU Guile Reference Manual}), and @code{#:configure-flags} is a keyword used to pass a keyword argument to the build system (@pxref{Coding With Keywords,,, guile, GNU Guile Reference Manual}).
ru: Последовательность хэш-двоеточие (@code{#:}) определяет Scheme @dfn{ключевое слово} (@pxref{Keywords,,, guile, GNU Guile Reference Manual}), а @code{#:configure-flags} - это ключевое слово, используемое для передачи аргумента ключевого слова системе сборки (@pxref{Coding With Keywords,,, guile, GNU Guile Reference Manual}).

note: type: itemize
en: Note that GCC, Coreutils, Bash, and other essential tools do not need to be specified as inputs here.  Instead, @code{gnu-build-system} takes care of ensuring that they are present (@pxref{Build Systems}).
ru: Обратите внимание, что GCC, Coreutils, Bash и другие важные инструменты не нужно указывать здесь в качестве inputs.  Вместо этого @code{gnu-build-system} позаботится об их наличии (@pxref{Build Systems}).

note: type: itemize
en: However, any other dependencies need to be specified in the @code{inputs} field.  Any dependency not specified here will simply be unavailable to the build process, possibly leading to a build failure.
ru: Однако любые другие зависимости необходимо указать в поле @code{inputs}.  Любая не указанная здесь зависимость будет просто недоступна для процесса сборки, что может привести к сбою сборки.

note: type: Plain text
en: @xref{package Reference}, for a full description of possible fields.
ru: @xref{package Reference}, для полного описания возможных полей.

note: type: Plain text
en: Once a package definition is in place, the package may actually be built using the @code{guix build} command-line tool (@pxref{Invoking guix build}), troubleshooting any build failures you encounter (@pxref{Debugging Build Failures}).  You can easily jump back to the package definition using the @command{guix edit} command (@pxref{Invoking guix edit}).  @xref{Packaging Guidelines}, for more information on how to test package definitions, and @ref{Invoking guix lint}, for information on how to check a definition for style conformance.
ru: После того, как определение пакета введено, пакет может быть фактически собран с помощью инструмента командной строки @code{guix build} (@pxref{Invoking guix build}), устраняя любые возникающие ошибки сборки (@pxref{Debugging Build Failures}).  Вы можете легко вернуться к определению пакета с помощью команды @command{guix edit} (@pxref{Invoking guix edit}).  @xref{Packaging Guidelines} для получения дополнительной информации о том, как тестировать определения пакетов, и @ref{Invoking guix lint} для получения информации о том, как проверить определение на соответствие стилю.

note: type: Plain text
en: Lastly, @pxref{Channels}, for information on how to extend the distribution by adding your own package definitions in a ``channel''.
ru: Наконец, @pxref{Channels}, чтобы узнать, как расширить дистрибутив, добавив собственные определения пакетов в ``канал''.

note: type: Plain text
en: Finally, updating the package definition to a new upstream version can be partly automated by the @command{guix refresh} command (@pxref{Invoking guix refresh}).
ru: Наконец, обновление определения пакета до новой исходной версии можно частично автоматизировать с помощью команды @command{guix refresh} (@pxref{Invoking guix refresh}).

note: type: Plain text
en: Behind the scenes, a derivation corresponding to the @code{<package>} object is first computed by the @code{package-derivation} procedure.  That derivation is stored in a @file{.drv} file under @file{/gnu/store}.  The build actions it prescribes may then be realized by using the @code{build-derivations} procedure (@pxref{The Store}).
ru: За кулисами derivation, соответствующая объекту @code{<package>}, сначала вычисляется с помощью процедуры @code{package-diveration}.  Этот вывод хранится в файле @file{.drv} в каталоге @file{/gnu/store}.  Действия сборки, которые он предписывает, затем могут быть реализованы с помощью процедуры @code{build-derivations} (@pxref{The Store}).

note: type: deffn
en: {Scheme Procedure} package-derivation @var{store} @var{package} [@var{system}]
ru: {Процедура Scheme} package-derivation @var{store} @var{package} [@var{system}]

note: type: deffn
en: Return the @code{<derivation>} object of @var{package} for @var{system} (@pxref{Derivations}).
ru: Возвращает the @code{<derivation>} объект @var{package} для @var{system} (@pxref{Derivations}).

note: type: deffn
en: @var{package} must be a valid @code{<package>} object, and @var{system} must be a string denoting the target system type---e.g., @code{"x86_64-linux"} for an x86_64 Linux-based GNU system.  @var{store} must be a connection to the daemon, which operates on the store (@pxref{The Store}).
ru: @var{package} должен быть допустимым объектом @code{<package>}, а @var{system} должен быть строкой, обозначающей тип системы---например, @code{"x86_64-linux"} для системы GNU на базе x86_64 Linux.  @var{store} должен быть подключен к демону, который работает с хранилищем (@pxref{The Store}).

note: type: Plain text
en: Similarly, it is possible to compute a derivation that cross-builds a package for some other system:
ru: Точно так же можно вычислить derivation, которая cross собирает пакет для некоторой другой системы:

note: type: deffn
en: {Scheme Procedure} package-cross-derivation @var{store} @
ru: {Процедура Scheme} package-cross-derivation @var{store} @

note: type: deffn
en: @var{package} @var{target} [@var{system}] Return the @code{<derivation>} object of @var{package} cross-built from @var{system} to @var{target}.
ru: @var{package} @var{target} [@var{system}] Возвращает @code{<derivation>} объект @var{package} cross-собранный из @var{system} в @var{target}.

note: type: deffn
en: @var{target} must be a valid GNU triplet denoting the target hardware and operating system, such as @code{"aarch64-linux-gnu"} (@pxref{Specifying Target Triplets,,, autoconf, Autoconf}).
ru: @var{target} должен быть допустимым GNU triplet'ом, обозначающим желамое оборудование и операционную систему, например @code{"aarch64-linux-gnu"} (@pxref{Specifying Target Triplets,,, autoconf, Autoconf}).

note: type: Plain text
en: Once you have package definitions, you can easily define @emph{variants} of those packages.  @xref{Defining Package Variants}, for more on that.
ru: Когда у вас есть определения пакетов, вы можете легко определить @emph{варианты} этих пакетов.  См. @xref{Defining Package Variants}, чтобы узнать об этом подробнее.

note: type: subsection
en: @code{package} Reference
ru: @code{package} Ссылка

note: type: Plain text
en: This section summarizes all the options available in @code{package} declarations (@pxref{Defining Packages}).
ru: В этом разделе перечислены все параметры, доступные в объявлениях @code{package} (@pxref{Defining Packages}).

note: type: deftp
en: {Data Type} package
ru: {Тип данных} package

note: type: deftp
en: This is the data type representing a package recipe.
ru: Это тип данных, представляющий рецепт пакета.

note: type: table
en: The name of the package, as a string.
ru: Название пакета в виде строки.

note: type: code{#1}
en: version
ru: версия

note: type: code{#1}
en: source
ru: источник

note: type: table
en: An object telling how the source code for the package should be acquired.  Most of the time, this is an @code{origin} object, which denotes a file fetched from the Internet (@pxref{origin Reference}).  It can also be any other ``file-like'' object such as a @code{local-file}, which denotes a file from the local file system (@pxref{G-Expressions, @code{local-file}}).
ru: Объект, указывающий, как должен быть получен исходный код пакета.  В большинстве случаев это объект @code{origin}, который обозначает файл, полученный из Интернета (@pxref{origin Reference}).  Это также может быть любой другой объект, подобный файлу, например @code{local-file}, который представляет собой файл из локальной файловой системы (@pxref{G-Expressions, @code{local-file}}).

note: type: code{#1}
en: build-system
ru: система сборки

note: type: table
en: The build system that should be used to build the package (@pxref{Build Systems}).
ru: Система сборки, которую следует использовать для сборки пакета (@pxref{Build Systems}).

note: type: cindex
en: inputs, of packages
ru: входные данные пакетов

note: type: cindex
en: cross compilation, package dependencies
ru: кросс-компиляция, зависимости пакетов

note: type: table
en: The distinction between @code{native-inputs} and @code{inputs} is necessary when considering cross-compilation.  When cross-compiling, dependencies listed in @code{inputs} are built for the @emph{target} architecture; conversely, dependencies listed in @code{native-inputs} are built for the architecture of the @emph{build} machine.
ru: Различие между @code{native-inputs} и @code{inputs} необходимо при рассмотрении кросс-компиляции.  При кросс-компиляции зависимости, перечисленные в @code{input}, создаются для архитектуры @emph{target}; и наоборот, зависимости, перечисленные в @code{native-inputs}, созданы для архитектуры машины, выполняющей @emph{сборку}.

note: type: table
en: @code{native-inputs} is typically used to list tools needed at build time, but not at run time, such as Autoconf, Automake, pkg-config, Gettext, or Bison.  @command{guix lint} can report likely mistakes in this area (@pxref{Invoking guix lint}).
ru: @code{native-inputs} обычно используется для перечисления инструментов, необходимых во время сборки, но не во время выполнения, таких как Autoconf, Automake, pkg-config, Gettext или Bison.  @command{guix lint} может сообщить о вероятных ошибках в этой области (@pxref{Invoking guix lint}).

note: type: table
en: Lastly, @code{propagated-inputs} is similar to @code{inputs}, but the specified packages will be automatically installed to profiles (@pxref{Features, the role of profiles in Guix}) alongside the package they belong to (@pxref{package-cmd-propagated-inputs, @command{guix package}}, for information on how @command{guix package} deals with propagated inputs).
ru: Наконец, @code{propagated-inputs} похоже на @code{inputs}, но указанные пакеты будут автоматически установлены в профили (@pxref{Features, the role of profiles in Guix}) вместе с пакетом, которому они принадлежат (@pxref{package-cmd-propagated-inputs, @command{guix package}}, for information on how @command{guix package} deals with propagated inputs).

note: type: table
en: For example this is necessary when packaging a C/C++ library that needs headers of another library to compile, or when a pkg-config file refers to another one @i{via} its @code{Requires} field.
ru: Например, это необходимо при упаковке библиотеки C/C++, которой для компиляции требуются заголовки другой библиотеки, или когда файл pkg-config ссылается на другое поле @i{через} его @code{Requires}.

note: type: table
en: Another example where @code{propagated-inputs} is useful is for languages that lack a facility to record the run-time search path akin to the @code{RUNPATH} of ELF files; this includes Guile, Python, Perl, and more.  When packaging libraries written in those languages, ensure they can find library code they depend on at run time by listing run-time dependencies in @code{propagated-inputs} rather than @code{inputs}.
ru: Другой пример использования @code{propagated-inputs} - это языки, в которых отсутствует возможность записывать путь поиска во время выполнения, аналогичный @code{RUNPATH} файлов ELF; сюда входят Guile, Python, Perl и другие.  При упаковке библиотек, написанных на этих языках, убедитесь, что они могут найти код библиотеки, от которого они зависят, во время выполнения, указав зависимости времени выполнения в @code{propagated-inputs}, а не в @code{inputs}.

note: type: table
en: The list of output names of the package.  @xref{Packages with Multiple Outputs}, for typical uses of additional outputs.
ru: Список выходных имен пакета.  @xref{Packages with Multiple Outputs}, для типичного использования дополнительных выходов.

note: type: item
en: @code{search-paths} (default: @code{'()})
ru: @code{search-paths} (по умолчанию: @code{'()})

note: type: item
en: @code{replacement} (default: @code{#f})
ru: @code{replacement} (по умолчанию: @code{#f})

note: type: table
en: This must be either @code{#f} or a package object that will be used as a @dfn{replacement} for this package.  @xref{Security Updates, grafts}, for details.
ru: Это должен быть либо @code{#f}, либо объект пакета, который будет использоваться как @dfn{замена} для этого пакета.  @xref{Security Updates, grafts}, чтобы узнать подробности.

note: type: item
en: synopsis
ru: синопсис

note: type: table
en: A one-line description of the package.
ru: Описание пакета в одну строку.

note: type: code{#1}
en: description
ru: описание

note: type: code{#1}
en: license
ru: лицензия

note: type: cindex
en: license, of packages
ru: лицензии пакетов

note: type: table
en: The license of the package; a value from @code{(guix licenses)}, or a list of such values.
ru: Лицензия пакета; значение из @code{(guix licenses)} или список таких значений.

note: type: itemx
en: home-page
ru: главная страница

note: type: table
en: The URL to the home-page of the package, as a string.
ru: URL-адрес домашней страницы пакета в виде строки.

note: type: item
en: @code{supported-systems} (default: @code{%supported-systems})
ru: @code{port} (default: @code{22})

note: type: table
en: The list of systems supported by the package, as strings of the form @code{architecture-kernel}, for example @code{"x86_64-linux"}.
ru: Список систем, поддерживаемых пакетом, в виде строк вида @code{architecture-kernel}, например @code{"x86_64-linux"}.

note: type: item
en: @code{location} (default: source location of the @code{package} form)
ru: @code{location} (по умолчанию: исходное местоположение формы @code{package})

note: type: table
en: The source location of the package.  It is useful to override this when inheriting from another package, in which case this field is not automatically corrected.
ru: Исходное расположение пакета.  Это полезно переопределить при наследовании от другого пакета, и в этом случае это поле не корректируется автоматически.

note: type: deffn
en: When used in the @emph{lexical scope} of a package field definition, this identifier resolves to the package being defined.
ru: При использовании в @emph{lexical scope} определения поля пакета этот идентификатор преобразуется в определяемый пакет.

note: type: deffn
en: The example below shows how to add a package as a native input of itself when cross-compiling:
ru: В приведенном ниже примере показано, как добавить пакет в качестве собственного ввода при кросс-компиляции:

note: type: deffn
en: It is an error to refer to @code{this-package} outside a package definition.
ru: Ссылка на @code{this-package} вне определения пакета является ошибкой.

note: type: Plain text
en: Because packages are regular Scheme objects that capture a complete dependency graph and associated build procedures, it is often useful to write procedures that take a package and return a modified version thereof according to some parameters.  Below are a few examples.
ru: Поскольку пакеты являются обычными Scheme объектами, которые захватывают полный граф зависимостей и связанные процедуры сборки, часто бывает полезно написать процедуры, которые принимают пакет и возвращают его измененную версию в соответствии с некоторыми параметрами.  Ниже приведены несколько примеров.

note: type: cindex
en: tool chain, choosing a package's tool chain
ru: tool chain, выбор инструментов пакета

note: type: deffn
en: {Scheme Procedure} package-with-c-toolchain @var{package} @var{toolchain}
ru: {Процедура Scheme} inferior-package-location @var{package}

note: type: deffn
en: Return a variant of @var{package} that uses @var{toolchain} instead of the default GNU C/C++ toolchain.  @var{toolchain} must be a list of inputs (label/package tuples) providing equivalent functionality, such as the @code{gcc-toolchain} package.
ru: Вернуть вариант @var{package}, в котором используется @var{toolchain} вместо стандартного набора инструментов GNU C/C++.  @var{toolchain} должен быть списком входов (кортежи меток/пакетов), обеспечивающих эквивалентную функциональность, например, пакет @code{gcc-toolchain}.

note: type: deffn
en: The example below returns a variant of the @code{hello} package built with GCC@tie{}10.x and the rest of the GNU tool chain (Binutils and the GNU C Library) instead of the default tool chain:
ru: Пример ниже возвращает вариант пакета @code{hello}, созданный с помощью GCC@tie{}10.x и остальной части GNU утилит (Binutils и библиотеки GNU C) вместо цепочки инструментов по умолчанию:

note: type: deffn
en: The build tool chain is part of the @dfn{implicit inputs} of packages---it's usually not listed as part of the various ``inputs'' fields and is instead pulled in by the build system.  Consequently, this procedure works by changing the build system of @var{package} so that it pulls in @var{toolchain} instead of the defaults.  @ref{Build Systems}, for more on build systems.
ru: Инструменты сборки являются частью @dfn{неявных входных данных} пакетов - обычно они не указываются как часть различных полей ``входных данных'', а вместо этого извлекается системой сборки.  Следовательно, эта процедура работает путем изменения системы сборки @var{package}, так что она использует @var{toolchain} вместо значений по умолчанию.  @ref{Build Systems}, чтобы узнать больше о системах сборки.

note: type: subsection
en: @code{origin} Reference
ru: @code{origin} Справка

note: type: Plain text
en: This section documents @dfn{origins}.  An @code{origin} declaration specifies data that must be ``produced''---downloaded, usually---and whose content hash is known in advance.  Origins are primarily used to represent the source code of packages (@pxref{Defining Packages}).  For that reason, the @code{origin} form allows you to declare patches to apply to the original source code as well as code snippets to modify it.
ru: Этот раздел документирует @dfn{origins}.  Объявление @code{origin} определяет данные, которые должны быть ``произведены''---обычно загружены---и чей хэш содержимого известен заранее.  Origins в основном используются для представления исходного кода пакетов (@pxref{Defining Packages}).  По этой причине форма @code{origin} позволяет вам объявлять исправления для применения к исходному коду, а также фрагменты кода для его изменения.

note: type: deftp
en: {Data Type} origin
ru: {Тип данных} origin

note: type: deftp
en: This is the data type representing a source code origin.
ru: Это тип данных, представляющий источник исходного кода.

note: type: table
en: An object containing the URI of the source.  The object type depends on the @code{method} (see below).  For example, when using the @var{url-fetch} method of @code{(guix download)}, the valid @code{uri} values are: a URL represented as a string, or a list thereof.
ru: Объект, содержащий URI источника.  Тип объекта зависит от @code{method} (см. ниже).  Например, при использовании метода @var{url-fetch} для @code{(guix download)} допустимые значения @code{uri}: URL, представленный в виде строки, или их список.

note: type: cindex
en: fixed-output derivations, for download
ru: derivation'ы с фиксированным выводом, для загрузки

note: type: code{#1}
en: method
ru: метод

note: type: table
en: A monadic procedure that handles the given URI@.  The procedure must accept at least three arguments: the value of the @code{uri} field and the hash algorithm and hash value specified by the @code{hash} field.  It must return a store item or a derivation in the store monad (@pxref{The Store Monad}); most methods return a fixed-output derivation (@pxref{Derivations}).
ru: Монадическая процедура, обрабатывающая данный URI.  Процедура должна принимать по крайней мере три аргумента: значение поля @code{uri}, а также алгоритм хеширования и значение хеш-функции, указанные в поле @code{hash}.  Она должна возвращать элемент store или derivation в store монаде (@pxref{The Store Monad}); большинство методов возвращают derivation с фиксированным выводом (@pxref{Derivations}).

note: type: table
en: Commonly used methods include @code{url-fetch}, which fetches data from a URL, and @code{git-fetch}, which fetches data from a Git repository (see below).
ru: Обычно используемые методы включают @code{url-fetch}, который извлекает данные из URL-адреса, и @code{git-fetch}, который извлекает данные из репозитория Git (см. ниже).

note: type: table
en: A bytevector containing the SHA-256 hash of the source.  This is equivalent to providing a @code{content-hash} SHA256 object in the @code{hash} field described below.
ru: Байт-вектор, содержащий хэш SHA-256 источника.  Это эквивалент предоставлению объекта SHA256 @code{content-hash} в поле @code{hash}, описанном ниже.

note: type: table
en: The @code{content-hash} object of the source---see below for how to use @code{content-hash}.
ru: Объект @code{content-hash} источника---см. ниже, как использовать @code{content-hash}.

note: type: table
en: You can obtain this information using @code{guix download} (@pxref{Invoking guix download}) or @code{guix hash} (@pxref{Invoking guix hash}).
ru: Вы можете получить эту информацию, используя @code{guix download} (@pxref{Invoking guix download}) или @code{guix hash} (@pxref{Invoking guix hash}).

note: type: item
en: @code{file-name} (default: @code{#f})
ru: @code{file-name} (по умолчанию: @code{#f})

note: type: table
en: The file name under which the source code should be saved.  When this is @code{#f}, a sensible default value will be used in most cases.  In case the source is fetched from a URL, the file name from the URL will be used.  For version control checkouts, it is recommended to provide the file name explicitly because the default is not very descriptive.
ru: Имя файла, под которым должен быть сохранен исходный код.  Когда это @code{#f}, в большинстве случаев будет использоваться разумное значение по умолчанию.  В случае, если источник извлекается из URL-адреса, будет использоваться имя файла из URL-адреса.  Для проверок контроля версий рекомендуется явно указывать имя файла, поскольку значение по умолчанию не очень информативно.

note: type: item
en: @code{patches} (default: @code{'()})
ru: @code{patches} (по умолчанию: @code{'()})

note: type: table
en: A list of file names, origins, or file-like objects (@pxref{G-Expressions, file-like objects}) pointing to patches to be applied to the source.
ru: Список имен файлов, источников или объектов подобных файлами (@pxref{G-Expressions, file-like objects}), указывающих на исправления, которые будут применены к источнику.

note: type: table
en: This list of patches must be unconditional.  In particular, it cannot depend on the value of @code{%current-system} or @code{%current-target-system}.
ru: Данный список исправлений должен быть безвариативным.  В частности, он не может зависеть от значения @code{%current-system} или @code{%current-target-system}.

note: type: item
en: @code{snippet} (default: @code{#f})
ru: @code{snippet} (по умолчанию: @code{#f})

note: type: table
en: A G-expression (@pxref{G-Expressions}) or S-expression that will be run in the source directory.  This is a convenient way to modify the source, sometimes more convenient than a patch.
ru: G-выражение (@pxref{G-Expressions}) или S-выражение, которое будет выполнено в исходном каталоге.  Это удобный способ изменить исходный код, иногда более удобный, чем патч.

note: type: item
en: @code{patch-flags} (default: @code{'("-p1")})
ru: @code{patch-flags} (по умолчанию: @code{'("-p1")})

note: type: table
en: A list of command-line flags that should be passed to the @code{patch} command.
ru: Список флагов командной строки, которые следует передать команде @code{patch}.

note: type: item
en: @code{patch-inputs} (default: @code{#f})
ru: @code{patch-inputs} (по умолчанию: @code{#f})"

note: type: table
en: Input packages or derivations to the patching process.  When this is @code{#f}, the usual set of inputs necessary for patching are provided, such as GNU@tie{}Patch.
ru: Входные пакеты или derivation'ы для процесса исправления.  Когда это @code{#f}, предоставляется обычный набор входных данных, необходимых для исправления, например GNU@tie{}Patch.

note: type: item
en: @code{modules} (default: @code{'()})
ru: @code{modules} (по умолчанию: @code{'()})

note: type: table
en: A list of Guile modules that should be loaded during the patching process and while running the code in the @code{snippet} field.
ru: Список модулей Guile, которые должны быть загружены в процессе установки исправлений и при выполнении кода, в поле @code{snippet}.

note: type: item
en: @code{patch-guile} (default: @code{#f})
ru: @code{patch-guile} (по умолчанию: @code{#f})

note: type: table
en: The Guile package that should be used in the patching process.  When this is @code{#f}, a sensible default is used.
ru: Пакет Guile, который следует использовать в процессе установки исправлений.  Когда это @code{#f}, используется разумное значение по умолчанию.

note: type: deftp
en: {Data Type} content-hash @var{value} [@var{algorithm}]
ru: {Тип данных} content-hash @var{value} [@var{algorithm}]

note: type: deftp
en: Construct a content hash object for the given @var{algorithm}, and with @var{value} as its hash value.  When @var{algorithm} is omitted, assume it is @code{sha256}.
ru: Создать объект хэша содержимого для заданного @var{algorithm} и с @var{value} в качестве его хеш-значения.  Если @var{algorithm} опущен, предполагается, что это @code{sha256}.

note: type: deftp
en: @var{value} can be a literal string, in which case it is base32-decoded, or it can be a bytevector.
ru: @var{value} может быть буквальной строкой, и в этом случае она декодируется с помощью base32, или может быть байтовым вектором.

note: type: deftp
en: The following forms are all equivalent:
ru: Следующие зависимости необязательны:

note: type: deftp
en: Technically, @code{content-hash} is currently implemented as a macro.  It performs sanity checks at macro-expansion time, when possible, such as ensuring that @var{value} has the right size for @var{algorithm}.
ru: Технически @code{content-hash} в настоящее время реализован как макрос.  Он выполняет проверки работоспособности во время раскрытия макроса, когда это возможно, например, гарантирует, что @var{value} имеет правильный размер для @var{algorithm}.

note: type: Plain text
en: As we have seen above, how exactly the data an origin refers to is retrieved is determined by its @code{method} field.  The @code{(guix download)} module provides the most common method, @code{url-fetch}, described below.
ru: Как мы видели выше, то, как именно извлекаются данные, на которые ссылается источник, определяется его полем @code{method}.  Модуль @code{(guix download)} предоставляет наиболее распространенный метод @code{url-fetch}, описанный ниже.

note: type: deffn
en: {Scheme Procedure} url-fetch @var{url} @var{hash-algo} @var{hash} @
ru: {Scheme Procedure} lookup-inferior-packages @var{inferior} @var{name} @

note: type: deffn
en: [name] [#:executable? #f] Return a fixed-output derivation that fetches data from @var{url} (a string, or a list of strings denoting alternate URLs), which is expected to have hash @var{hash} of type @var{hash-algo} (a symbol).  By default, the file name is the base name of URL; optionally, @var{name} can specify a different file name.  When @var{executable?} is true, make the downloaded file executable.
ru: [name] [#:executable? #f] Возвращает derivation с фиксированным выводом, которая извлекает данные из @var{url} (строка или список строк, обозначающих альтернативные URL-адреса), который, как ожидается, будет иметь хэш @var{hash} типа @var{hash-algo} (символ).  По умолчанию имя файла - это базовое имя URL-адреса; при желании @var{name} может указывать другое имя файла.  Если @var{executable?} истинно, загруженный файл будет исполняемым.

note: type: deffn
en: When one of the URL starts with @code{mirror://}, then its host part is interpreted as the name of a mirror scheme, taken from @file{%mirror-file}.
ru: Когда один из URL-адресов начинается с @code{mirror://}, тогда его хост-часть интерпретируется как имя схемы зеркала, взятой из @file{%mirror-file}.

note: type: deffn
en: Alternatively, when URL starts with @code{file://}, return the corresponding file name in the store.
ru: В качестве альтернативного варианта, если URL-адрес начинается с @code{file://}, вернуть соответствующее имя файла в store.

note: type: Plain text
en: Likewise, the @code{(guix git-download)} module defines the @code{git-fetch} origin method, which fetches data from a Git version control repository, and the @code{git-reference} data type to describe the repository and revision to fetch.
ru: Аналогичным образом, модуль @code{(guix git-download)} определяет метод источника @code{git-download}, который извлекает данные из репозитория управления версиями Git, и тип данных @code{git-reference} для описания репозиторий и ревизия для загрузки.

note: type: deffn
en: {Scheme Procedure} git-fetch @var{ref} @var{hash-algo} @var{hash}
ru: {Scheme Procedure} mixed-text-file @var{name} @var{text} @dots{}

note: type: deffn
en: Return a fixed-output derivation that fetches @var{ref}, a @code{<git-reference>} object.  The output is expected to have recursive hash @var{hash} of type @var{hash-algo} (a symbol).  Use @var{name} as the file name, or a generic name if @code{#f}.
ru: Вернуть derivation с фиксированным выводом, которая выбирает объект @var{ref}, @code{<git-reference>}.  Ожидается, что на выходе будет рекурсивный хеш @var{hash} типа @var{hash-algo} (символ).  Использовать @var{name} в качестве имени файла или общее имя, если @code{#f}.

note: type: deftp
en: {Data Type} git-reference
ru: {Тип данных} build-machine

note: type: deftp
en: This data type represents a Git reference for @code{git-fetch} to retrieve.
ru: Управление конфигурацией операционной системы.

note: type: table
en: The URL of the Git repository to clone.
ru: URL-адрес репозитория Git для клонирования.

note: type: item
en: @code{recursive?} (default: @code{#f})
ru: @code{features} (default: @code{'()})

note: type: table
en: This Boolean indicates whether to recursively fetch Git sub-modules.
ru: Это логическое значение (boolean) указывает, нужно ли рекурсивно получать подмодули Git.

note: type: deftp
en: The example below denotes the @code{v2.10} tag of the GNU@tie{}Hello repository:
ru: Пример ниже обозначает тег @code{v2.10} репозитория GNU@tie{}Hello:

note: type: deftp
en: This is equivalent to the reference below, which explicitly names the commit:
ru: Это эквивалентно приведенной ниже ссылке, которая явно называет коммит:

note: type: Plain text
en: For Mercurial repositories, the module @code{(guix hg-download)} defines the @code{hg-fetch} origin method and @code{hg-reference} data type for support of the Mercurial version control system.
ru: Для репозиториев Mercurial, модуль @code{(guix hg-download)} определяет метод @code{hg-fetch} и тип данных @code{hg-reference} для поддержки системы контроля версий Mercurial.

note: type: deffn
en: {Scheme Procedure} hg-fetch @var{ref} @var{hash-algo} @var{hash} @
ru: {Scheme Procedure} mixed-text-file @var{name} @var{text} @dots{}

note: type: deffn
en: [name] Return a fixed-output derivation that fetches @var{ref}, a @code{<hg-reference>} object.  The output is expected to have recursive hash @var{hash} of type @var{hash-algo} (a symbol).  Use @var{name} as the file name, or a generic name if @code{#false}.
ru: Вернуть derivation с фиксированным выводом, которая выбирает объект @var{ref}, @code{<git-reference>}.  Ожидается, что на выходе будет рекурсивный хеш @var{hash} типа @var{hash-algo} (символ).  Использовать @var{name} в качестве имени файла или общее имя, если @code{#f}.

note: type: cindex
en: customizing packages
ru: настройка, пакетов

note: type: cindex
en: variants, of packages
ru: вариантов пакетов

note: type: cindex
en: inherit, for package definitions
ru: наследование для описаниях пакетов

note: type: Plain text
en: As discussed earlier, packages are first-class objects in the Scheme language.  The @code{(guix packages)} module provides the @code{package} construct to define new package objects (@pxref{package Reference}).  The easiest way to define a package variant is using the @code{inherit} keyword together with @code{package}.  This allows you to inherit from a package definition while overriding the fields you want.
ru: Как обсуждалось ранее, пакеты---это объекты первого класса на языке Scheme.  Модуль @code{(guix packages)} предоставляет конструкцию @code{package} для определения новых объектов пакета (@pxref{package Reference}).  Самый простой способ определить вариант пакета---использовать ключевое слово @code{inherit} вместе с @code{package}.  Это позволяет вам наследовать от определения пакета, переопределяя нужные поля.

note: type: Plain text
en: For example, given the @code{hello} variable, which contains a definition for the current version of GNU@tie{}Hello, here's how you would define a variant for version 2.2 (released in 2006, it's vintage!):
ru: Например, учитывая переменную @code{hello}, которая содержит определение для текущей версии GNU@tie{}Hello, вот как вы могли бы определить вариант для версии 2.2 (выпущенной в 2006 году, это винтаж!):

note: type: lisp
en: (use-modules (gnu packages base))    ;for 'hello'
ru: (use-modules (gnu packages guile))  ;for 'guile-json'

note: type: Plain text
en: The example above corresponds to what the @option{--with-source} package transformation option does.  Essentially @code{hello-2.2} preserves all the fields of @code{hello}, except @code{version} and @code{source}, which it overrides.  Note that the original @code{hello} variable is still there, in the @code{(gnu packages base)} module, unchanged.  When you define a custom package like this, you are really @emph{adding} a new package definition; the original one remains available.
ru: Приведенный выше пример соответствует тому, что делает опция преобразования пакета @option{--with-source}.  По сути, @code{hello-2.2} сохраняет все поля @code{hello}, кроме @code{version} и @code{source}, которые переопределяется.  Обратите внимание, что исходная переменная @code{hello} все еще присутствует в модуле @code{(gnu packages base)} без изменений.  Когда вы определяете собственный пакет таким образом, вы на самом деле @emph{добавляете} новое определение пакета; оригинал остается доступным.

note: type: Plain text
en: You can just as well define variants with a different set of dependencies than the original package.  For example, the default @code{gdb} package depends on @code{guile}, but since that is an optional dependency, you can define a variant that removes that dependency like so:
ru: Вы также можете определить варианты с другим набором зависимостей, чем исходный пакет.  Например, пакет @code{gdb} по умолчанию зависит от @code{guile}, но поскольку это необязательная зависимость, вы можете определить вариант, который удаляет эту зависимость следующим образом:

note: type: Plain text
en: In some cases, you may find it useful to write functions (``procedures'', in Scheme parlance) that return a package based on some parameters.  For example, consider the @code{luasocket} library for the Lua programming language.  We want to create @code{luasocket} packages for major versions of Lua.  One way to do that is to define a procedure that takes a Lua package and returns a @code{luasocket} package that depends on it:
ru: В некоторых случаях вам может быть полезно написать функции (``процедуры'' Scheme), которые возвращают пакет на основе некоторых параметров.  Например, рассмотрим библиотеку @code{luasocket} для языка программирования Lua.  Мы хотим создать пакеты @code{luasocket} для основных версий Lua.  Один из способов сделать это---определить процедуру, которая принимает пакет Lua и возвращает зависящий от него пакет @code{luasocket}:

note: type: Plain text
en: Here we have defined packages @code{lua5.1-socket} and @code{lua5.2-socket} by calling @code{make-lua-socket} with different arguments.  @xref{Procedures,,, guile, GNU Guile Reference Manual}, for more info on procedures.  Having top-level public definitions for these two packages means that they can be referred to from the command line (@pxref{Package Modules}).
ru: Здесь мы определили пакеты @code{lua5.1-socket} и @code{lua5.2-socket}, вызвав @code{make-lua-socket} с разными аргументами.  См. @xref{Procedures,,, guile, GNU Guile Reference Manual}, для получения дополнительной информации о процедурах.  Наличие общедоступных определений верхнего уровня для этих двух пакетов означает, что на них можно ссылаться из командной строки (@pxref{Package Modules}).

note: type: cindex
en: package transformations
ru: пакетные преобразования

note: type: Plain text
en: These are pretty simple package variants.  As a convenience, the @code{(guix transformations)} module provides a high-level interface that directly maps to the more sophisticated package transformation options (@pxref{Package Transformation Options}):
ru: Это довольно простые варианты пакета.  Для удобства модуль @code{(guix transformations)} предоставляет высокоуровневый интерфейс, который напрямую сопоставляется с более сложными параметрами преобразования пакетов (@pxref{Package Transformation Options}):

note: type: deffn
en: {Scheme Procedure} options->transformation @var{opts}
ru: {Процедура Scheme} open-inferior @var{directory} @

note: type: deffn
en: Return a procedure that, when passed an object to build (package, derivation, etc.), applies the transformations specified by @var{opts} and returns the resulting objects.  @var{opts} must be a list of symbol/string pairs such as:
ru: Возвращает процедуру, которая при передаче объекта для сборки (пакета, производной и т. д.), применяет преобразования, указанные в @var{opts}, и возвращает результирующие объекты.  @var{opts} должен быть списком пар символ/строка, например:

note: type: lisp
en: ((with-branch . "guile-gcrypt=master")
     (without-tests . "libgcrypt"))
ru: ((with-branch . "guile-gcrypt=master")
    (without-tests . "libgcrypt"))

note: type: deffn
en: Each symbol names a transformation and the corresponding string is an argument to that transformation.
ru: Каждый символ именует преобразование, а соответствующая строка (string) является аргументом этого преобразования.

note: type: Plain text
en: For instance, a manifest equivalent to this command:
ru: Например, команда:

note: type: Plain text
en: ... would look like this:
ru: Вывод должен быть таким:

note: type: lisp
en: (use-modules (guix transformations))
ru: (use-package-modules guile emacs)

note: type: lisp
en: (packages->manifest
     (list (transform (specification->package "guix"))))
ru: (packages->manifest
    (list (transform (specification->package "guix"))))

note: type: cindex
en: input rewriting
ru: перезапись input

note: type: cindex
en: dependency graph rewriting
ru: перезапись дерева зависимостей

note: type: Plain text
en: The @code{options->transformation} procedure is convenient, but it's perhaps also not as flexible as you may like.  How is it implemented? The astute reader probably noticed that most package transformation options go beyond the superficial changes shown in the first examples of this section: they involve @dfn{input rewriting}, whereby the dependency graph of a package is rewritten by replacing specific inputs by others.
ru: Процедура @code{options-> transformation} удобна, но, возможно, не так гибка, как вам хотелось бы.  Как это реализовано? Проницательный читатель, вероятно, заметил, что большинство вариантов преобразования пакетов выходят за рамки поверхностных изменений, показанных в первых примерах этого раздела: они включают @dfn{перезапись входных данных}, в результате чего граф зависимостей пакета переписывается путем замены определенных входных данных другими.

note: type: Plain text
en: Dependency graph rewriting, for the purposes of swapping packages in the graph, is what the @code{package-input-rewriting} procedure in @code{(guix packages)} implements.
ru: Перезапись графа зависимостей для замены пакетов в графе реализуется процедурой @code{package-input-rewriting} в @code{(guix packages)}.

note: type: deffn
en: {Scheme Procedure} package-input-rewriting @var{replacements} @
ru: {Процедура Scheme} package-input-rewriting @var{replacements} @

note: type: deffn
en: [@var{rewrite-name}] [#:deep? #t] Return a procedure that, when passed a package, replaces its direct and indirect dependencies, including implicit inputs when @var{deep?} is true, according to @var{replacements}.  @var{replacements} is a list of package pairs; the first element of each pair is the package to replace, and the second one is the replacement.
ru: [@var{rewrite-name}] [#:deep? #t] Возвращает процедуру, которая при передаче пакета заменяет его прямые и косвенные зависимости, включая неявные входы, когда @var{deep?} истинна, согласно @var{replacements}.  @var{replacements} - это список пар пакетов; первый элемент каждой пары - это заменяемый пакет, а второй - заменяющий.

note: type: deffn
en: Optionally, @var{rewrite-name} is a one-argument procedure that takes the name of a package and returns its new name after rewrite.
ru: При необходимости, @var{rewrite-name} - это процедура с одним аргументом, которая принимает имя пакета и возвращает его новое имя после перезаписи.

note: type: table
en: Consider this example:
ru: Рассмотрим пример:

note: type: Plain text
en: Here we first define a rewriting procedure that replaces @var{openssl} with @var{libressl}.  Then we use it to define a @dfn{variant} of the @var{git} package that uses @var{libressl} instead of @var{openssl}.  This is exactly what the @option{--with-input} command-line option does (@pxref{Package Transformation Options, @option{--with-input}}).
ru: Здесь мы сначала определяем процедуру перезаписи, которая заменяет @var{openssl} на @var{libressl}.  Затем мы используем это, чтобы определить @dfn{вариант} пакета @var{git}, который использует @var{libressl} вместо @var{openssl}.  Это именно то, что делает параметр командной строки @option{--with-input} (@pxref{Package Transformation Options, @option{--with-input}}).

note: type: Plain text
en: The following variant of @code{package-input-rewriting} can match packages to be replaced by name rather than by identity.
ru: Следующий вариант @code{package-input-rewriting} может сопоставлять пакеты, подлежащие замене, по имени, а не по идентификатору.

note: type: deffn
en: {Scheme Procedure} package-input-rewriting/spec @var{replacements} [#:deep? #t]
ru: {Процедура Scheme} inferior-package-inputs @var{package}

note: type: deffn
en: Return a procedure that, given a package, applies the given @var{replacements} to all the package graph, including implicit inputs unless @var{deep?} is false.  @var{replacements} 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.
ru: Возвращает процедуру, которая для данного пакета применяет заданные @var{replacements} ко всему графу пакета, включая неявные входные данные, если @var{deep?} не ложно.  @var{replacements} - это список пары спецификация/процедуры; каждая спецификация - это спецификация пакета, такая как @code{"gcc"} или @code{"guile@@2"}, и каждая процедура берет соответствующий пакет и возвращает замену для этого пакета.

note: type: Plain text
en: The example above could be rewritten this way:
ru: Приведенный выше пример можно переписать так:

note: type: Plain text
en: 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 @code{openssl} will be replaced.
ru: Ключевое отличие здесь в том, что на этот раз пакеты сопоставляются по спецификации, а не по идентичности.  Другими словами, любой пакет в графе, который называется @code{openssl}, будет заменен.

note: type: Plain text
en: A more generic procedure to rewrite a package dependency graph is @code{package-mapping}: it supports arbitrary changes to nodes in the graph.
ru: Более общая процедура для перезаписи графа зависимостей пакетов - это @code{package-mapping}: она поддерживает произвольные изменения узлов в графе.

note: type: deffn
en: {Scheme Procedure} package-mapping @var{proc} [@var{cut?}] [#:deep? #f]
ru: {Процедура Scheme} inferior-package-location @var{package}

note: type: deffn
en: Return a procedure that, given a package, applies @var{proc} to all the packages depended on and returns the resulting package.  The procedure stops recursion when @var{cut?} returns true for a given package.  When @var{deep?} is true, @var{proc} is applied to implicit inputs as well.
ru: Вернуть процедуру, которая для данного пакета применяет @var{proc} ко всем зависимым пакетам и возвращает полученный пакет.  Процедура останавливает рекурсию, когда @var{cut?} возвращает истину для данного пакета.  Когда @var{deep?} истинно, @var{proc} также применяется к неявным входным данным.

note: type: cindex
en: build system
ru: система сборки

note: type: Plain text
en: Each package definition specifies a @dfn{build system} and arguments for that build system (@pxref{Defining Packages}).  This @code{build-system} field represents the build procedure of the package, as well as implicit dependencies of that build procedure.
ru: В каждом определении пакета указывается @dfn{система сборки} и аргументы для этой системы сборки (@pxref{Defining Packages}).  Это поле @code{build-system} представляет процедуру сборки пакета, а также неявные зависимости этой процедуры сборки.

note: type: Plain text
en: Build systems are @code{<build-system>} objects.  The interface to create and manipulate them is provided by the @code{(guix build-system)} module, and actual build systems are exported by specific modules.
ru: Системы сборки - это объекты @code{<build-system>}.  Интерфейс для их создания и управления ими предоставляется модулем @code{(guix build-system)}, а фактические системы сборки экспортируются определенными модулями.

note: type: cindex
en: bag (low-level package representation)
ru: мешок (низкоуровневое представление пакета)

note: type: Plain text
en: Under the hood, build systems first compile package objects to @dfn{bags}.  A @dfn{bag} is like a package, but with less ornamentation---in other words, a bag is a lower-level representation of a package, which includes all the inputs of that package, including some that were implicitly added by the build system.  This intermediate representation is then compiled to a derivation (@pxref{Derivations}).  The @code{package-with-c-toolchain} is an example of a way to change the implicit inputs that a package's build system pulls in (@pxref{package Reference, @code{package-with-c-toolchain}}).
ru: Под капотом системы сборки сначала компилируют объекты пакета в @dfn{bag}.  @dfn{bag} похож на пакет, но с меньшим количеством украшений---другими словами, bag - это представление пакета нижнего уровня, которое включает в себя все входные данные этого пакета, включая те, которые были неявно добавлены система сборки.  Это промежуточное представление затем компилируется в derivation (@pxref{Derivations}).  @code{package-with-c-toolchain} - это пример способа изменить неявные входные данные, которые использует система сборки пакета (@pxref{package Reference, @code{package-with-c-toolchain}}).

note: type: Plain text
en: Build systems accept an optional list of @dfn{arguments}.  In package definitions, these are passed @i{via} the @code{arguments} field (@pxref{Defining Packages}).  They are typically keyword arguments (@pxref{Optional Arguments, keyword arguments in Guile,, guile, GNU Guile Reference Manual}).  The value of these arguments is usually evaluated in the @dfn{build stratum}---i.e., by a Guile process launched by the daemon (@pxref{Derivations}).
ru: Системы сборки принимают необязательный список из @dfn{arguments}.  В определениях пакетов они передаются @i{через} поле @code{arguments} (@pxref{Defining Packages}).  Обычно это аргументы ключевого слова (@pxref{Optional Arguments, keyword arguments in Guile,, guile, GNU Guile Reference Manual}).  Значение этих аргументов обычно оценивается в @dfn{build stratum}---то есть процессом Guile, запущенным демоном (@pxref{Derivations}).

note: type: Plain text
en: The main build system is @code{gnu-build-system}, which implements the standard build procedure for GNU and many other packages.  It is provided by the @code{(guix build-system gnu)} module.
ru: Основная система сборки - это @code{gnu-build-system}, которая реализует стандартную процедуру сборки для GNU и многих других пакетов.  Она предоставляется модулем @code{(guix build-system gnu)}.

note: type: defvr
en: @code{gnu-build-system} represents the GNU Build System, and variants thereof (@pxref{Configuration, configuration and makefile conventions,, standards, GNU Coding Standards}).
ru: @code{gnu-build-system} представляет систему сборки GNU и ее варианты (@pxref{Configuration, configuration and makefile conventions,, standards, GNU Coding Standards}).

note: type: defvr
en: In a nutshell, packages using it are configured, built, and installed with the usual @code{./configure && make && make check && make install} command sequence.  In practice, a few additional steps are often needed.  All these steps are split up in separate @dfn{phases}.  @xref{Build Phases}, for more info on build phases and ways to customize them.
ru: Вкратце, пакеты, использующие его, настраиваются, собираются и устанавливаются с помощью обычной последовательности команд @code{./ configure && make && make check && make install}. На практике часто требуется несколько дополнительных шагов.  Все эти шаги разбиты на отдельные @dfn{фазы}.  @xref{Build Phases}, чтобы узнать больше о фазах сборки и способах их настройки.

note: type: defvr
en: In addition, this build system ensures that the ``standard'' environment for GNU packages is available.  This includes tools such as GCC, libc, Coreutils, Bash, Make, Diffutils, grep, and sed (see the @code{(guix build-system gnu)} module for a complete list).  We call these the @dfn{implicit inputs} of a package, because package definitions do not have to mention them.
ru: Кроме того, эта система сборки гарантирует, что доступна ``стандартная'' среда для пакетов GNU.  Сюда входят такие инструменты, как GCC, libc, Coreutils, Bash, Make, Diffutils, grep и sed (полный список см. в модуле @code{(guix build-system gnu)}).  Мы называем их @dfn{неявными входами} пакета, потому что в определениях пакетов они не упоминаются.

note: type: defvr
en: This build system supports a number of keyword arguments, which can be passed @i{via} the @code{arguments} field of a package.  Here are some of the main parameters:
ru: Эта система сборки поддерживает ряд ключевых аргументов, которые можно передать @i{через} поле @code{arguments} пакета.  Вот некоторые из основных параметров:

note: type: item
en: #:phases
ru: build phases

note: type: table
en: This argument specifies build-side code that evaluates to an alist of build phases.  @xref{Build Phases}, for more information.
ru: Считать список каналов из файла @var{file} вместо @file{~/.config/guix/channels.scm}. @var{file} должен содержать код Scheme, который определяет список объектов "канал". См.  @xref{Channels} для подробной информации.

note: type: item
en: #:configure-flags
ru: Конфигурирование системы

note: type: table
en: This is a list of flags (strings) passed to the @command{configure} script.  @xref{Defining Packages}, for an example.
ru: Это список флагов (строк), переданных в сценарий (script) @command{configure}. См. @xref{Defining Packages}.

note: type: table
en: This list of strings contains flags passed as arguments to @command{make} invocations in the @code{build}, @code{check}, and @code{install} phases.
ru: Этот список строк содержит флаги, передаваемые в качестве аргументов для вызовов @command{make} на этапах @code{build}, @code{check} и @code{install}.

note: type: table
en: This Boolean, @code{#f} by default, indicates whether to run builds in a build directory separate from the source tree.
ru: Это логическое значение, @code{#f} по умолчанию, указывает, следует ли запускать сборки в каталоге сборки отдельно от исходников.

note: type: table
en: When it is true, the @code{configure} phase creates a separate build directory, changes to that directory, and runs the @code{configure} script from there.  This is useful for packages that require it, such as @code{glibc}.
ru: Когда это значение истинно, на этапе @code{configure} создается отдельный каталог сборки, происходит переход в этот каталог и оттуда запускается сценарий @code{configure}.  Это полезно для пакетов, которым это необходимо, таких как @code{glibc}.

note: type: item
en: #:allowed-references
ru: --references

note: type: itemx
en: #:disallowed-references
ru: --references

note: type: Plain text
en: Other @code{<build-system>} objects are defined to support other conventions and tools used by free software packages.  They inherit most of @code{gnu-build-system}, and differ mainly in the set of inputs implicitly added to the build process, and in the list of phases executed.  Some of these build systems are listed below.
ru: Другие объекты @code{<build-system>} определены для поддержки других соглашений и инструментов, используемых пакетами свободного программного обеспечения.  Они наследуют большую часть @code{gnu-build-system} и различаются в основном набором входных данных, неявно добавляемых в процесс сборки, и списком выполняемых фаз.  Некоторые из этих систем сборки перечислены ниже.

note: type: defvr
en: This variable is exported by @code{(guix build-system ant)}.  It implements the build procedure for Java packages that can be built with @url{https://ant.apache.org/, Ant build tool}.
ru: Эта переменная экспортируется @code{(guix build-system ant)}.  Она реализует процедуру сборки пакетов Java, которые можно собрать с помощью @url{https://ant.apache.org/, Ant build tool}.

note: type: defvr
en: It adds both @code{ant} and the @dfn{Java Development Kit} (JDK) as provided by the @code{icedtea} package to the set of inputs.  Different packages can be specified with the @code{#:ant} and @code{#:jdk} parameters, respectively.
ru: Она добавляет к набору входных данных как @code{ant}, так и @dfn{Java Development Kit} (JDK), предоставленные пакетом @code{icedtea}.  Различные пакеты можно указать с помощью параметров @code{#:ant} и @code{#:jdk} соответственно.

note: type: defvr
en: When the original package does not provide a suitable Ant build file, the parameter @code{#:jar-name} can be used to generate a minimal Ant build file @file{build.xml} with tasks to build the specified jar archive.  In this case the parameter @code{#:source-dir} can be used to specify the source sub-directory, defaulting to ``src''.
ru: Когда исходный пакет не предоставляет подходящий файл сборки Ant, параметр @code{#:jar-name} можно использовать для создания минимального файла сборки Ant @file{build.xml} с задачами для создания указанного архива jar.  В этом случае параметр @code{#:source-dir} можно использовать для указания подкаталога источника, по умолчанию - src.

note: type: defvr
en: The @code{#:main-class} parameter can be used with the minimal ant buildfile to specify the main class of the resulting jar.  This makes the jar file executable.  The @code{#:test-include} parameter can be used to specify the list of junit tests to run.  It defaults to @code{(list "**/*Test.java")}.  The @code{#:test-exclude} can be used to disable some tests.  It defaults to @code{(list "**/Abstract*.java")}, because abstract classes cannot be run as tests.
ru: Параметр @code{#:main-class} можно использовать с минимальным файлом сборки ant для указания основного класса результирующего jar-файла.  Это делает файл jar исполняемым.  Параметр @code{#:test-include} можно использовать для указания списка запускаемых тестов junit.  По умолчанию это @code{(list "**/*Test.java")}.  @code{#:test-exclude} можно использовать для отключения некоторых тестов.  По умолчанию это @code{(list "**/Abstract*.java")}, потому что абстрактные классы не могут быть запущены как тесты.

note: type: defvr
en: The parameter @code{#:build-target} can be used to specify the Ant task that should be run during the @code{build} phase.  By default the ``jar'' task will be run.
ru: Параметр @code{#:build-target} можно использовать для указания задачи Ant, которая должна выполняться на этапе @code{build}.  По умолчанию будет запущена задача jar.

note: type: cindex
en: Android NDK build system
ru: система сборки Android NDK

note: type: defvr
en: This variable is exported by @code{(guix build-system android-ndk)}.  It implements a build procedure for Android NDK (native development kit)  packages using a Guix-specific build process.
ru: Эта переменная экспортируется @code{(guix build-system android-ndk)}.  Она реализует процедуру сборки пакетов Android NDK (собственный комплект разработки) с использованием процесса сборки, специфичного для Guix.

note: type: defvr
en: The build system assumes that packages install their public interface (header) files to the subdirectory @file{include} of the @code{out} output and their libraries to the subdirectory @file{lib} the @code{out} output.
ru: Система сборки предполагает, что пакеты устанавливают свои файлы общедоступного интерфейса (заголовки) в подкаталог @file{include} вывода @code{out}, а их библиотеки - в подкаталог @file{lib} вывода @code{out}.

note: type: defvr
en: It's also assumed that the union of all the dependencies of a package has no conflicting files.
ru: Также предполагается, что объединение всех зависимостей пакета не имеет конфликтующих файлов.

note: type: defvr
en: For the time being, cross-compilation is not supported - so right now the libraries and header files are assumed to be host tools.
ru: В настоящее время кросс-компиляция не поддерживается, поэтому сейчас предполагается, что библиотеки и файлы заголовков являются хост-инструментами.

note: type: defvr
en: These variables, exported by @code{(guix build-system asdf)}, implement build procedures for Common Lisp packages using @url{https://common-lisp.net/project/asdf/, ``ASDF''}.  ASDF is a system definition facility for Common Lisp programs and libraries.
ru: Эти переменные, экспортированные @code{(guix build-system asdf)}, реализуют процедуры сборки для пакетов Common Lisp с использованием @url{https://common-lisp.net/project/asdf/, ``ASDF''}.  ASDF - это средство определения системы для программ и библиотек Common Lisp.

note: type: defvr
en: The @code{asdf-build-system/source} system installs the packages in source form, and can be loaded using any common lisp implementation, via ASDF@.  The others, such as @code{asdf-build-system/sbcl}, install binary systems in the format which a particular implementation understands.  These build systems can also be used to produce executable programs, or lisp images which contain a set of packages pre-loaded.
ru: Система @code{asdf-build-system/source} устанавливает пакеты в исходной форме и может быть загружена с использованием любой распространенной реализации Lisp через ASDF.  Другие, такие как @code{asdf-build-system/sbcl}, устанавливают двоичные системы в формате, понятном конкретной реализации.  Эти системы сборки также могут использоваться для создания исполняемых программ или образов lisp, которые содержат набор предварительно загруженных пакетов.

note: type: defvr
en: The build system uses naming conventions.  For binary packages, the package name should be prefixed with the lisp implementation, such as @code{sbcl-} for @code{asdf-build-system/sbcl}.
ru: В системе сборки используются соглашения об именах.  Для бинарных пакетов перед именем пакета должен стоять префикс реализации lisp, например @code{sbcl-} для @code{asdf-build-system/sbcl}.

note: type: defvr
en: Additionally, the corresponding source package should be labeled using the same convention as python packages (see @ref{Python Modules}), using the @code{cl-} prefix.
ru: Кроме того, соответствующий исходный пакет должен быть помечен с использованием того же соглашения, что и пакеты python (см. @ref{Python Modules}), с использованием префикса @code{cl-}.

note: type: defvr
en: In order to create executable programs and images, the build-side procedures @code{build-program} and @code{build-image} can be used.  They should be called in a build phase after the @code{create-asdf-configuration} phase, so that the system which was just built can be used within the resulting image.  @code{build-program} requires a list of Common Lisp expressions to be passed as the @code{#:entry-program} argument.
ru: Для создания исполняемых программ и образов можно использовать процедуры сборки @code{build-program} и @code{build-image}.  Их следует вызывать в фазе сборки после фазы @code{create-symlinks}, чтобы только что созданную систему можно было использовать в полученном образе.  @code{build-program} требует, чтобы список выражений Common Lisp был передан в качестве аргумента @code{#:entry-program}.

note: type: defvr
en: By default, all the @file{.asd} files present in the sources are read to find system definitions.  The @code{#:asd-files} parameter can be used to specify the list of @file{.asd} files to read.  Furthermore, if the package defines a system for its tests in a separate file, it will be loaded before the tests are run if it is specified by the @code{#:test-asd-file} parameter.  If it is not set, the files @code{<system>-tests.asd}, @code{<system>-test.asd}, @code{tests.asd}, and @code{test.asd} will be tried if they exist.
ru: Если система не определена в собственном файле @file{.asd} с тем же именем, тогда следует использовать параметр @code{#:asd-file}, чтобы указать, в каком файле определена система.  Кроме того, если пакет определяет систему для своих тестов в отдельном файле, он будет загружен перед запуском тестов, если он указан параметром @code{#:test-asd-file}.  Если он не установлен, будут попробованы файлы @code{<system>-tests.asd}, @code{<system>-test.asd}, @code{tests.asd} и @code{test.asd}, если они есть.

note: type: defvr
en: If for some reason the package must be named in a different way than the naming conventions suggest, or if several systems must be compiled, the @code{#:asd-systems} parameter can be used to specify the list of system names.
ru: Если по какой-то причине пакет должен быть назван иначе, чем это предлагается в соглашениях об именах, можно использовать параметр @code{#:asd-system-name} для указания имени системы.

note: type: cindex
en: Rust programming language
ru: Язык программирования Rust

note: type: cindex
en: Cargo (Rust build system)
ru: Cargo (система сборки Rust)

note: type: defvr
en: This variable is exported by @code{(guix build-system cargo)}.  It supports builds of packages using Cargo, the build tool of the @uref{https://www.rust-lang.org, Rust programming language}.
ru: Эта переменная экспортируется @code{(guix build-system cargo)}.  Она поддерживает сборку пакетов с использованием Cargo, инструмента сборки @uref{https://www.rust-lang.org, языка программирования Rust}.

note: type: defvr
en: It adds @code{rustc} and @code{cargo} to the set of inputs.  A different Rust package can be specified with the @code{#:rust} parameter.
ru: Она добавляет @code{rustc} и @code{cargo} к набору входных данных.  Другой пакет Rust можно указать с помощью параметра @code{#:rust}.

note: type: defvr
en: Regular cargo dependencies should be added to the package definition similarly to other packages; those needed only at build time to native-inputs, others to inputs.  If you need to add source-only crates then you should add them to via the @code{#:cargo-inputs} parameter as a list of name and spec pairs, where the spec can be a package or a source definition.  Note that the spec must evaluate to a path to a gzipped tarball which includes a @code{Cargo.toml} file at its root, or it will be ignored.  Similarly, cargo dev-dependencies should be added to the package definition via the @code{#:cargo-development-inputs} parameter.
ru: Обычные cargo зависимости должны быть добавлены к определению пакета через параметр @code{#:cargo-inputs} в виде списка пар имени и спецификации, где спецификацией может быть определение пакета или источника.  Обратите внимание, что в спецификации должен быть указан путь к сжатому архиву, который содержит файл @code{Cargo.toml} в своем корне, иначе он будет проигнорирован.  Точно так же dev-зависимости cargo должны быть добавлены в определение пакета с помощью параметра @code{#:cargo-development-inputs}.

note: type: defvr
en: In its @code{configure} phase, this build system will make any source inputs specified in the @code{#:cargo-inputs} and @code{#:cargo-development-inputs} parameters available to cargo.  It will also remove an included @code{Cargo.lock} file to be recreated by @code{cargo} during the @code{build} phase.  The @code{package} phase will run @code{cargo package} to create a source crate for future use.  The @code{install} phase installs the binaries defined by the crate.  Unless @code{install-source? #f} is defined it will also install a source crate repository of itself and unpacked sources, to ease in future hacking on rust packages.
ru: На этапе @code{configure} эта система сборки собирет любые исходные данные, указанные в параметрах @code{#:cargo-inputs} и @code{#:cargo-development-inputs}, доступными для cargo.  Она также удалит файл @code{Cargo.lock}, который будет воссоздан @code{cargo} на этапе @code{build}.  На этапе @code{install} устанавливаются двоичные файлы, определенные crate.

note: type: defvr
en: {Scheme Variable} chicken-build-system
ru: {Scheme переменная} cmake-build-system

note: type: defvr
en: This build system adds @code{chicken} to the package inputs, as well as the packages of @code{gnu-build-system}.
ru: Эта система сборки добавляет @code{chicken} к входным данным (inputs) пакета, а также к пакетам @code{gnu-build-system}.

note: type: defvr
en: For example, if you are packaging the @code{srfi-1} egg:
ru: Например, если вы создаете пакет, содержащий Bash, с помощью:

note: type: defvr
en: This variable is exported by @code{(guix build-system copy)}.  It supports builds of simple packages that don't require much compiling, mostly just moving files around.
ru: Эта переменная экспортируется в @code{(guix build-system copy)}.  Она поддерживает сборку простых пакетов, которые не требуют большой компиляции, в основном просто перемещения файлов.

note: type: defvr
en: It adds much of the @code{gnu-build-system} packages to the set of inputs.  Because of this, the @code{copy-build-system} does not require all the boilerplate code often needed for the @code{trivial-build-system}.
ru: Она добавляет большую часть пакетов @code{gnu-build-system} в набор входных данных.  По этой причине @code{copy-build-system} не требуется весь шаблонный код, часто необходимый для @code{trivial-build-system}.

note: type: defvr
en: To further simplify the file installation process, an @code{#:install-plan} argument is exposed to let the packager specify which files go where.  The install plan is a list of @code{(@var{source} @var{target} [@var{filters}])}.  @var{filters} are optional.
ru: Чтобы еще больше упростить процесс установки файла, предоставляется аргумент @code{#:install-plan}, позволяющий упаковщику указывать, какие файлы куда установить.  План установки представляет собой список @code{(@var{source} @var{target} [@var{filters}])}.  @var{filters} необязательны.

note: type: item
en: When @var{source} matches a file or directory without trailing slash, install it to @var{target}.
ru: Когда @var{source} соответствует файл или каталог без косой черты, установить его в @var{target}.

note: type: item
en: If @var{target} has a trailing slash, install @var{source} basename beneath @var{target}.
ru: Если @var{target} имеет косую черту в конце, установить @var{source} basename ниже @var{target}.

note: type: item
en: Otherwise install @var{source} as @var{target}.
ru: В противном случае установите @var{source} как @var{target}.

note: type: item
en: When @var{source} is a directory with a trailing slash, or when @var{filters} are used,
ru: Когда @var{source} - это каталог с косой чертой в конце или когда используются @var{filters},

note: type: itemize
en: the trailing slash of @var{target} is implied with the same meaning as above.
ru: завершающая косая черта @var{target} подразумевается с тем же значением, что и выше.

note: type: item
en: Without @var{filters}, install the full @var{source} @emph{content} to @var{target}.
ru: Без @var{filter} установить @emph{содержимое} @var{source} в @var{target}.

note: type: item
en: With @var{filters} among @code{#:include}, @code{#:include-regexp}, @code{#:exclude},
ru: С @var{filters} среди @code{#:include}, @code{#:include-regexp}, @code{#:exclude},

note: type: itemize
en: @code{#:exclude-regexp}, only select files are installed depending on the filters.  Each filters is specified by a list of strings.
ru: @code{#:exclude-regexp}, установить только избранные файлы в зависимости от фильтров.  Каждый фильтр определяется списком строк.

note: type: item
en: With @code{#:include}, install all the files which the path suffix matches
ru: С помощью @code{#:include} установите все файлы, суффикс пути которых соответствует

note: type: itemize
en: at least one of the elements in the given list.
ru: хотя бы одному из элементов в данном списке.

note: type: item
en: With @code{#:include-regexp}, install all the files which the
ru: С помощью @code{#:include-regex} установить все файлы,

note: type: itemize
en: subpaths match at least one of the regular expressions in the given list.
ru: подкаталоги которых соответствуют хотя бы одному из регулярных выражений в данном списке.

note: type: item
en: The @code{#:exclude} and @code{#:exclude-regexp} filters
ru: Фильтры @code{#:exclude} и @code{#:exclude-regexp}

note: type: itemize
en: are the complement of their inclusion counterpart.  Without @code{#:include} flags, install all files but those matching the exclusion filters.  If both inclusions and exclusions are specified, the exclusions are done on top of the inclusions.
ru: являются дополнением к своим аналогам включения.  Без флагов @code{#:include} установить все файлы, кроме тех, которые соответствуют фильтрам исключения.  Если указаны и включения, и исключения, то исключения выполняются поверх включений.

note: type: itemize
en: In all cases, the paths relative to @var{source} are preserved within @var{target}.
ru: В любом случае пути, относительные к @var{source}, сохраняются в @var{target}.

note: type: defvr
en: Examples:
ru: Примеры:

note: type: item
en: @code{("foo/bar" "share/my-app/")}: Install @file{bar} to @file{share/my-app/bar}.
ru: @code{("foo/bar" "share/my-app/")}: Установить @file{bar} в @file{share/my-app/bar}.

note: type: item
en: @code{("foo/bar" "share/my-app/baz")}: Install @file{bar} to @file{share/my-app/baz}.
ru: @code{("foo/bar" "share/my-app/baz")}: Установить @file{bar} в @file{share/my-app/baz}.

note: type: item
en: @code{("foo/" "share/my-app")}: Install the content of @file{foo} inside @file{share/my-app},
ru: @code{("foo/" "share/my-app")}: Установить содержимое @file{foo} в @file{share/my-app},

note: type: itemize
en: e.g., install @file{foo/sub/file} to @file{share/my-app/sub/file}.
ru: например, установить @file{foo/sub/file} в @file{share/my-app/sub/file}.

note: type: item
en: @code{("foo/" "share/my-app" #:include ("sub/file"))}: Install only @file{foo/sub/file} to
ru: @code{("foo/" "share/my-app" #:include ("sub/file"))}: Установить только @file{foo/sub/file} в

note: type: item
en: @code{("foo/sub" "share/my-app" #:include ("file"))}: Install @file{foo/sub/file} to
ru: @code{("foo/sub" "share/my-app" #:include ("file"))}: Установить @file{foo/sub/file} в

note: type: cindex
en: Clojure (programming language)
ru: Clojure (язык программирования)

note: type: cindex
en: simple Clojure build system
ru: простая система сборки Clojure

note: type: defvr
en: This variable is exported by @code{(guix build-system clojure)}.  It implements a simple build procedure for @uref{https://clojure.org/, Clojure} packages using plain old @code{compile} in Clojure.  Cross-compilation is not supported yet.
ru: Эта переменная экспортируется @code{(guix build-system clojure)}.  Она реализует простую процедуру сборки пакетов @uref{https://clojure.org/, Clojure} с использованием простого старого @code{compile} в Clojure.  Кросс-компиляция пока не поддерживается.

note: type: defvr
en: It adds @code{clojure}, @code{icedtea} and @code{zip} to the set of inputs.  Different packages can be specified with the @code{#:clojure}, @code{#:jdk} and @code{#:zip} parameters, respectively.
ru: Она добавляет @code{clojure}, @code{icedtea} и @code{zip} к набору входных данных.  Различные пакеты можно указать с помощью параметров @code{#:clojure}, @code{#:jdk} и @code{#:zip} соответственно.

note: type: defvr
en: A list of source directories, test directories and jar names can be specified with the @code{#:source-dirs}, @code{#:test-dirs} and @code{#:jar-names} parameters, respectively.  Compile directory and main class can be specified with the @code{#:compile-dir} and @code{#:main-class} parameters, respectively.  Other parameters are documented below.
ru: Список исходных каталогов, тестовых каталогов и имен jar-файлов можно указать с помощью параметров @code{#:source-dirs}, @code{#:test-dirs} и @code{#:jar-names} соответственно.  Каталог компиляции и основной класс можно указать с помощью параметров @code{#:compile-dir} и @code{#:main-class} соответственно.  Остальные параметры описаны ниже.

note: type: defvr
en: This build system is an extension of @code{ant-build-system}, but with the following phases changed:
ru: Эта система сборки является расширением @code{ant-build-system}, но со следующими изменениями:

note: type: table
en: This phase calls @code{compile} in Clojure to compile source files and runs @command{jar} to create jars from both source files and compiled files according to the include list and exclude list specified in @code{#:aot-include} and @code{#:aot-exclude}, respectively.  The exclude list has priority over the include list.  These lists consist of symbols representing Clojure libraries or the special keyword @code{#:all} representing all Clojure libraries found under the source directories.  The parameter @code{#:omit-source?} decides if source should be included into the jars.
ru: На этом этапе вызывается @code{compile} в Clojure для компиляции исходных файлов и запускается @command{jar} для создания jar-файлов как из исходных файлов, так и из скомпилированных файлов в соответствии со списком включения и списком исключений, указанным в @code{#:aot-include} и @code{#:aot-exclude} соответственно.  Список исключений имеет приоритет над списком включения.  Эти списки состоят из символов, представляющих библиотеки Clojure, или специального ключевого слова @code{#:all}, представляющего все библиотеки Clojure, находящиеся в исходных каталогах.  Параметр @code{#:omit-source?} определяет, следует ли включать исходники в jar-файлы.

note: type: table
en: This phase runs tests according to the include list and exclude list specified in @code{#:test-include} and @code{#:test-exclude}, respectively.  Their meanings are analogous to that of @code{#:aot-include} and @code{#:aot-exclude}, except that the special keyword @code{#:all} now stands for all Clojure libraries found under the test directories.  The parameter @code{#:tests?} decides if tests should be run.
ru: На этом этапе выполняются тесты в соответствии со списком включения и списком исключений, указанными в @code{#:test-include} и @code{#:test-exclude} соответственно.  Их значения аналогичны значениям @code{#:aot-include} и @code{#:aot-exclude}, за исключением того, что специальное ключевое слово @code{#:all} теперь обозначает все библиотеки Clojure, находящиеся в каталогах test.  Параметр @code{#:tests?} определяет, нужно ли запускать тесты.

note: type: item
en: install
ru: установка

note: type: table
en: This phase installs all jars built previously.
ru: На этом этапе устанавливаются все созданные ранее jars.

note: type: defvr
en: Apart from the above, this build system also contains an additional phase:
ru: Помимо вышесказанного, эта система сборки также содержит дополнительную фазу:

note: type: table
en: This phase installs all top-level files with base name matching @code{%doc-regex}.  A different regex can be specified with the @code{#:doc-regex} parameter.  All files (recursively) inside the documentation directories specified in @code{#:doc-dirs} are installed as well.
ru: На этом этапе устанавливаются все файлы верхнего уровня с базовым именем, совпадающим с @code{%doc-regex}.  Другое регулярное выражение можно указать с помощью параметра @code{#:doc-regex}.  Все файлы (рекурсивно) в каталогах документации, указанные в @code{#:doc-dirs}, также устанавливаются.

note: type: defvr
en: {Scheme Variable} cmake-build-system
ru: {Scheme переменная} cmake-build-system

note: type: defvr
en: This variable is exported by @code{(guix build-system cmake)}.  It implements the build procedure for packages using the @url{https://www.cmake.org, CMake build tool}.
ru: Эта переменная экспортируется @code{(guix build-system cmake)}.  Она реализует процедуру сборки пакетов с использованием @url{https://www.cmake.org, инструмента сборки CMake}.

note: type: defvr
en: It automatically adds the @code{cmake} package to the set of inputs.  Which package is used can be specified with the @code{#:cmake} parameter.
ru: Она автоматически добавляет пакет @code{cmake} в набор входных данных.  Какой пакет используется, можно указать с помощью параметра @code{#:cmake}.

note: type: defvr
en: The @code{#:configure-flags} parameter is taken as a list of flags passed to the @command{cmake} command.  The @code{#:build-type} parameter specifies in abstract terms the flags passed to the compiler; it defaults to @code{"RelWithDebInfo"} (short for ``release mode with debugging information''), which roughly means that code is compiled with @code{-O2 -g}, as is the case for Autoconf-based packages by default.
ru: Параметр @code{#:configure-flags} используется как список флагов, переданных команде @command{cmake}.  Параметр @code{#:build-type} абстрактно определяет флаги, передаваемые компилятору; по умолчанию используется @code{"RelWithDebInfo"} (сокращение от ``release mode с отладочной информацией''), что примерно означает, что код компилируется с помощью @code{-O2 -g}, как в случае пакетов на основе Autoconf по умолчанию.

note: type: defvr
en: {Scheme Variable} dune-build-system
ru: {Scheme переменная} dune-build-system

note: type: defvr
en: 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 @code{ocaml-build-system} which is described below.  As such, the @code{#:ocaml} and @code{#:findlib} parameters can be passed to this build system.
ru: Эта переменная экспортируется в @code{(guix build-system dune)}.  Она поддерживает сборку пакетов с использованием @uref{https://dune.build/, Dune}, инструмента сборки для языка программирования OCaml.  Она реализована как расширение @code{ocaml-build-system}, описанную ниже.  Таким образом, в эту систему сборки можно передать параметры @code{#:ocaml} и @code{#:findlib}.

note: type: defvr
en: It automatically adds the @code{dune} package to the set of inputs.  Which package is used can be specified with the @code{#:dune} parameter.
ru: Она автоматически добавляет пакет @code{dune} в набор входных данных.  Какой пакет используется, можно указать с помощью параметра @code{#:dune}.

note: type: defvr
en: 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.
ru: Фаза @code{configure} отсутствует, потому что dune пакеты обычно не нужно настраивать.  Параметр @code{#:build-flags} используется как список флагов, переданных команде @code{dune} во время сборки.

note: type: defvr
en: 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}.
ru: Параметр @code{#:jbuild?} можно передать для использования команды @code{jbuild} вместо более новой команды @code{dune} при сборке пакета.  Его значение по умолчанию - @code{#f}.

note: type: defvr
en: 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}.
ru: Параметр @code{#:package} может быть передан для указания имени пакета, что полезно, когда пакет содержит несколько пакетов, и вы хотите создать только один из них.  Это эквивалентно передаче аргумента @code{-p} в @code{dune}.

note: type: defvr
en: {Scheme Variable} go-build-system
ru: {Scheme переменная} go-build-system

note: type: defvr
en: This variable is exported by @code{(guix build-system go)}.  It implements a build procedure for Go packages using the standard @url{https://golang.org/cmd/go/#hdr-Compile_packages_and_dependencies, Go build mechanisms}.
ru: Эта переменная экспортируется @code{(guix build-system go)}.  Онf реализует процедуру сборки пакетов Go с использованием стандартного @url{https://golang.org/cmd/go/#hdr-Compile_packages_and_dependencies, механизмов сборки Go}.

note: type: defvr
en: The user is expected to provide a value for the key @code{#:import-path} and, in some cases, @code{#:unpack-path}.  The @url{https://golang.org/doc/code.html#ImportPaths, import path} corresponds to the file system path expected by the package's build scripts and any referring packages, and provides a unique way to refer to a Go package.  It is typically based on a combination of the package source code's remote URI and file system hierarchy structure.  In some cases, you will need to unpack the package's source code to a different directory structure than the one indicated by the import path, and @code{#:unpack-path} should be used in such cases.
ru: Ожидается, что пользователь предоставит значение для ключа @code{#:import-path} и, в некоторых случаях, @code{#:unpack-path}.  @url{https://golang.org/doc/code.html#ImportPaths, import path} соответствует пути к файловой системе, ожидаемому сценариями сборки пакета и любыми ссылочными пакетами, и обеспечивает уникальный способ ссылки на Go пакет.  Обычно он основан на комбинации удаленного URI исходного кода пакета и иерархической структуры файловой системы.  В некоторых случаях вам нужно будет распаковать исходный код пакета в другую структуру каталогов, отличную от той, которая указана в пути импорта, и в таких случаях следует использовать @code{#:unpack-path}.

note: type: defvr
en: Packages that provide Go libraries should install their source code into the built output.  The key @code{#:install-source?}, which defaults to @code{#t}, controls whether or not the source code is installed.  It can be set to @code{#f} for packages that only provide executable files.
ru: Пакеты, которые предоставляют библиотеки Go, должны устанавливать свой исходный код во встроенные выходные данные.  Ключ @code{#:install-source?}, который по умолчанию равен @code{#t}, определяет, установливается ли исходный код.  Для пакетов, которые предоставляют только исполняемые файлы, может быть установлено значение @code{#f}.

note: type: defvr
en: {Scheme Variable} glib-or-gtk-build-system
ru: {Scheme переменная} glib-or-gtk-build-system

note: type: defvr
en: This variable is exported by @code{(guix build-system glib-or-gtk)}.  It is intended for use with packages making use of GLib or GTK+.
ru: Эта переменная экспортируется в @code{(guix build-system glib-or-gtk)}.  Она предназначена для использования с пакетами, использующими GLib или GTK+.

note: type: defvr
en: This build system adds the following two phases to the ones defined by @code{gnu-build-system}:
ru: Эта система сборки добавляет следующие две фазы к тем, которые определены в @code{gnu-build-system}:

note: type: table
en: The phase @code{glib-or-gtk-wrap} ensures that programs in @file{bin/} are able to find GLib ``schemas'' and @uref{https://developer.gnome.org/gtk3/stable/gtk-running.html, GTK+ modules}.  This is achieved by wrapping the programs in launch scripts that appropriately set the @env{XDG_DATA_DIRS} and @env{GTK_PATH} environment variables.
ru: Фаза @code{glib-or-gtk-wrap} гарантирует, что программы в @file{bin/} смогут найти GLib ``schemas'' и @uref{https://developer.gnome.org/gtk3/stable /gtk-running.html, модули GTK+}.  Это достигается путем включения программ в сценарии запуска, которые соответствующим образом устанавливают переменные среды @env{XDG_DATA_DIRS} и @env{GTK_PATH}.

note: type: table
en: It is possible to exclude specific package outputs from that wrapping process by listing their names in the @code{#:glib-or-gtk-wrap-excluded-outputs} parameter.  This is useful when an output is known not to contain any GLib or GTK+ binaries, and where wrapping would gratuitously add a dependency of that output on GLib and GTK+.
ru: Можно исключить определенные выходные данные пакета из этого процесса упаковки, указав их имена в параметре @code{#:glib-or-gtk-wrap-excluded-output}.  Это полезно, когда известно, что выходной файл не содержит двоичных файлов GLib или GTK+, и где wrapping может произвольно добавить зависимость этого вывода от GLib и GTK+.

note: type: table
en: The phase @code{glib-or-gtk-compile-schemas} makes sure that all @uref{https://developer.gnome.org/gio/stable/glib-compile-schemas.html, GSettings schemas} of GLib are compiled.  Compilation is performed by the @command{glib-compile-schemas} program.  It is provided by the package @code{glib:bin} which is automatically imported by the build system.  The @code{glib} package providing @command{glib-compile-schemas} can be specified with the @code{#:glib} parameter.
ru: Фаза @code{glib-or-gtk-compile-schemas} гарантирует, что все @uref{https://developer.gnome.org/gio/stable/glib-compile-schemas.html, GSettings schemas} в GLib скомпилированы.  Компиляция выполняется программой @command{glib-compile-schemas}.  Она предоставляется пакетом @code{glib:bin}, который автоматически импортируется системой сборки.  Пакет @code{glib}, предоставляющий @command{glib-compile-schemas}, можно указать с помощью параметра @code{#:glib}.

note: type: defvr
en: Both phases are executed after the @code{install} phase.
ru: Обе фазы выполняются после фазы @code{install}.

note: type: defvr
en: {Scheme Variable} guile-build-system
ru: {Scheme переменная} guile-build-system

note: type: defvr
en: This build system is for Guile packages that consist exclusively of Scheme code and that are so lean that they don't even have a makefile, let alone a @file{configure} script.  It compiles Scheme code using @command{guild compile} (@pxref{Compilation,,, guile, GNU Guile Reference Manual}) and installs the @file{.scm} and @file{.go} files in the right place.  It also installs documentation.
ru: Эта система сборки предназначена для пакетов Guile, которые состоят исключительно из кода Scheme и настолько скудны, что у них даже нет make-файла, не говоря уже о сценарии @file{configure}.  Она компилирует Scheme код с помощью @command{guild compile} (@pxref{Compilation,,, guile, GNU Guile Reference Manual}) и устанавливает файлы @file{.scm} и @file{.go} в нужное место.  Она также устанавливает документацию.

note: type: defvr
en: This build system supports cross-compilation by using the @option{--target} option of @samp{guild compile}.
ru: Эта система сборки поддерживает кросс-компиляцию с использованием параметра @option{--target} в @samp{guild compile}.

note: type: defvr
en: Packages built with @code{guile-build-system} must provide a Guile package in their @code{native-inputs} field.
ru: Пакеты, созданные с помощью @code{guile-build-system}, должны содержать пакет Guile в поле @code{native-inputs}.

note: type: defvr
en: {Scheme Variable} julia-build-system
ru: {Scheme переменная} julia-build-system

note: type: defvr
en: This variable is exported by @code{(guix build-system julia)}.  It implements the build procedure used by @uref{https://julialang.org/, julia} packages, which essentially is similar to running @samp{julia -e 'using Pkg; Pkg.add(package)'} in an environment where @env{JULIA_LOAD_PATH} contains the paths to all Julia package inputs.  Tests are run by calling @code{/test/runtests.jl}.
ru: Эта переменная экспортируется в @code{(guix build-system julia)}.  Она реализует процедуру сборки, используемую пакетами @uref{https://julialang.org/, julia}, которая по сути аналогична запуску @samp{julia -e 'используя Pkg; Pkg.add(package)'} в среде, где @env{JULIA_LOAD_PATH} содержит пути ко всем входным данным пакета Julia.  Тесты запускаются с @code{Pkg.test}.

note: type: defvr
en: {Scheme Variable} maven-build-system
ru: {Scheme Variable} ant-build-system

note: type: defvr
en: This variable is exported by @code{(guix build-system maven)}.  It implements a build procedure for @uref{https://maven.apache.org, Maven} packages.  Maven is a dependency and lifecycle management tool for Java.  A user of Maven specifies dependencies and plugins in a @file{pom.xml} file that Maven reads.  When Maven does not have one of the dependencies or plugins in its repository, it will download them and use them to build the package.
ru: Эта переменная экспортируется в @code{(guix build-system maven)}.  Она реализует процедуру сборки пакетов @uref{https://maven.apache.org, Maven}.  Maven - это инструмент для управления зависимостями и жизненным циклом Java.  Пользователь Maven указывает зависимости и плагины в файле @file{pom.xml}, который читает Maven.  Когда Maven не имеет одной из зависимостей или плагинов в своем репозитории, он загружает их и использует для сборки пакета.

note: type: defvr
en: The maven build system ensures that maven will not try to download any dependency by running in offline mode.  Maven will fail if a dependency is missing.  Before running Maven, the @file{pom.xml} (and subprojects) are modified to specify the version of dependencies and plugins that match the versions available in the guix build environment.  Dependencies and plugins must be installed in the fake maven repository at @file{lib/m2}, and are symlinked into a proper repository before maven is run.  Maven is instructed to use that repository for the build and installs built artifacts there.  Changed files are copied to the @file{lib/m2} directory of the package output.
ru: Система сборки maven гарантирует, что maven не будет пытаться загрузить какие-либо зависимости, работая в offline режиме.  Maven завершится ошибкой, если зависимость отсутствует.  Перед запуском Maven @file{pom.xml} (и подпроекты) модифицируются, чтобы указать версию зависимостей и плагинов, которые соответствуют версиям, доступным в среде сборки guix.  Зависимости и плагины должны быть установлены в поддельном репозитории maven по адресу @file{lib/m2} и перед запуском maven привязаны к соответствующему репозиторию.  Maven получает указание использовать этот репозиторий для сборки и устанавливает туда созданные артефакты.  Измененные файлы копируются в каталог @file{lib/m2} выходных данных пакета.

note: type: defvr
en: You can specify a @file{pom.xml} file with the @code{#:pom-file} argument, or let the build system use the default @file{pom.xml} file in the sources.
ru: Вы можете указать файл @file{pom.xml} с аргументом @code{#:pom-file} или позволить системе сборки использовать файл @file{pom.xml} по умолчанию в источниках.

note: type: defvr
en: In case you need to specify a dependency's version manually, you can use the @code{#:local-packages} argument.  It takes an association list where the key is the groupId of the package and its value is an association list where the key is the artifactId of the package and its value is the version you want to override in the @file{pom.xml}.
ru: Если вам нужно указать версию зависимости вручную, вы можете использовать аргумент @code{#:local-packages}.  Он принимает список ассоциаций, где ключ - это groupId пакета, а его значение - это список ассоциаций, где ключ - это artifactId пакета, а его значение - это версия, которую вы хотите переопределить в @file{pom.xml}.

note: type: defvr
en: Some packages use dependencies or plugins that are not useful at runtime nor at build time in Guix.  You can alter the @file{pom.xml} file to remove them using the @code{#:exclude} argument.  Its value is an association list where the key is the groupId of the plugin or dependency you want to remove, and the value is a list of artifactId you want to remove.
ru: Некоторые пакеты используют зависимости или плагины, которые не используются ни во время выполнения, ни во время сборки в Guix.  Вы можете изменить файл @file{pom.xml}, чтобы удалить их, используя аргумент @code{#:exclude}.  Его значение - это список ассоциаций, где ключ - это groupId плагина или зависимости, которые вы хотите удалить, а значение - это список artifactId, которые вы хотите удалить.

note: type: defvr
en: You can override the default @code{jdk} and @code{maven} packages with the corresponding argument, @code{#:jdk} and @code{#:maven}.
ru: Вы можете переопределить пакеты по умолчанию @code{jdk} и @code{maven} с помощью соответствующего аргумента, @code{#:jdk} и @code{#:maven}.

note: type: defvr
en: The @code{#:maven-plugins} argument is a list of maven plugins used during the build, with the same format as the @code{inputs} fields of the package declaration.  Its default value is @code{(default-maven-plugins)} which is also exported.
ru: Аргумент @code{#:maven-plugins} - это список подключаемых модулей maven, используемых во время сборки, в том же формате, что и поля @code{inputs} в объявлении пакета.  Его значение по умолчанию - @code{(default-maven-plugins)}, которое также экспортируется.

note: type: defvr
en: {Scheme Variable} minetest-mod-build-system
ru: {Scheme переменная} minetest-mod-build-system

note: type: defvr
en: {Scheme Variable} minify-build-system
ru: {Scheme переменная} minify-build-system

note: type: defvr
en: This variable is exported by @code{(guix build-system minify)}.  It implements a minification procedure for simple JavaScript packages.
ru: Эта переменная экспортируется в @code{(guix build-system minify)}.  Она реализует процедуру минификации для простых пакетов JavaScript.

note: type: defvr
en: It adds @code{uglify-js} to the set of inputs and uses it to compress all JavaScript files in the @file{src} directory.  A different minifier package can be specified with the @code{#:uglify-js} parameter, but it is expected that the package writes the minified code to the standard output.
ru: Он добавляет @code{uglify-js} к набору входных данных и использует его для сжатия всех файлов JavaScript в каталоге @file{src}.  Другой minifier пакет можно указать с помощью параметра @code{#:uglify-js}, но ожидается, что этот пакет запишет минимизированный код в стандартный вывод.

note: type: defvr
en: When the input JavaScript files are not all located in the @file{src} directory, the parameter @code{#:javascript-files} can be used to specify a list of file names to feed to the minifier.
ru: Когда не все входные файлы JavaScript находятся в каталоге @file{src}, можно использовать параметр @code{#:javascript-files}, чтобы указать список имен файлов для передачи в minifier.

note: type: defvr
en: {Scheme Variable} ocaml-build-system
ru: {Scheme переменная} ocaml-build-system

note: type: defvr
en: This variable is exported by @code{(guix build-system ocaml)}.  It implements a build procedure for @uref{https://ocaml.org, OCaml} packages, which consists of choosing the correct set of commands to run for each package.  OCaml packages can expect many different commands to be run.  This build system will try some of them.
ru: Эта переменная экспортируется в @code{(guix build-system ocaml)}.  Она реализует процедуру сборки пакетов @uref{https://ocaml.org, OCaml}, которая заключается в выборе правильного набора команд для запуска для каждого пакета.  Пакеты OCaml могут ожидать выполнения множества различных команд.  Эта система сборки попробует некоторые из них.

note: type: defvr
en: When the package has a @file{setup.ml} file present at the top-level, it will run @code{ocaml setup.ml -configure}, @code{ocaml setup.ml -build} and @code{ocaml setup.ml -install}.  The build system will assume that this file was generated by @uref{http://oasis.forge.ocamlcore.org/, OASIS} and will take care of setting the prefix and enabling tests if they are not disabled.  You can pass configure and build flags with the @code{#:configure-flags} and @code{#:build-flags}.  The @code{#:test-flags} key can be passed to change the set of flags used to enable tests.  The @code{#:use-make?} key can be used to bypass this system in the build and install phases.
ru: Если в пакете есть файл @file{setup.ml} на верхнем уровне, он будет запускать @code{ocaml setup.ml -configure}, @code{ocaml setup.ml -build} и @code{ocaml setup.ml -install}. Система сборки предполагает, что этот файл был сгенерирован @uref{http://oasis.forge.ocamlcore.org/, OASIS}, и позаботится об установке префикса и включении тестов, если они не отключены.  Вы можете передать флаги конфигурации и сборки с помощью @code{#:configure-flags} и @code{#:build-flags}.  Ключ @code{#:test-flags} может быть передан для изменения набора флагов, используемых для включения тестов.  Ключ @code{#:use-make?} можно использовать для обхода этой системы на этапах сборки и установки.

note: type: defvr
en: When the package has a @file{configure} file, it is assumed that it is a hand-made configure script that requires a different argument format than in the @code{gnu-build-system}.  You can add more flags with the @code{#:configure-flags} key.
ru: Когда в пакете есть файл @file{configure}, предполагается, что это созданный вручную скрипт настройки, для которого требуется другой формат аргументов, чем в @code{gnu-build-system}.  Вы можете добавить дополнительные флаги с помощью клавиши @code{#:configure-flags}.

note: type: defvr
en: When the package has a @file{Makefile} file (or @code{#:use-make?} is @code{#t}), it will be used and more flags can be passed to the build and install phases with the @code{#:make-flags} key.
ru: Когда в пакете есть файл @file{Makefile} (или @code{#:use-make?} - это @code{#t}), он будет использоваться, и дополнительные флаги могут быть переданы на этапы сборки и установки с @code{#:make-flags} ключом.

note: type: defvr
en: Finally, some packages do not have these files and use a somewhat standard location for its build system.  In that case, the build system will run @code{ocaml pkg/pkg.ml} or @code{ocaml pkg/build.ml} and take care of providing the path to the required findlib module.  Additional flags can be passed via the @code{#:build-flags} key.  Install is taken care of by @command{opam-installer}.  In this case, the @code{opam} package must be added to the @code{native-inputs} field of the package definition.
ru: Наконец, некоторые пакеты не имеют этих файлов и используют стандартное расположение для своей системы сборки.  В этом случае система сборки запустит @code{ocaml pkg/pkg.ml} или @code{ocaml pkg/build.ml} и позаботится о предоставлении пути к необходимому модулю findlib.  Дополнительные флаги можно передать с помощью ключа @code{#:build-flags}.  Об установке позаботится @command{opam-installer}.  В этом случае пакет @code{opam} необходимо добавить в поле @code{native-inputs} в определении пакета.

note: type: defvr
en: Note that most OCaml packages assume they will be installed in the same directory as OCaml, which is not what we want in guix.  In particular, they will install @file{.so} files in their module's directory, which is usually fine because it is in the OCaml compiler directory.  In guix though, these libraries cannot be found and we use @env{CAML_LD_LIBRARY_PATH}.  This variable points to @file{lib/ocaml/site-lib/stubslibs} and this is where @file{.so} libraries should be installed.
ru: Обратите внимание, что большинство пакетов OCaml предполагают, что они будут установлены в том же каталоге, что и OCaml, что не является тем, что мы хотим в guix.  В частности, они устанавливают файлы @file{.so} в каталог своего модуля, что обычно нормально, потому что он находится в каталоге компилятора OCaml.  Однако в guix эти библиотеки нельзя найти, и мы используем @env{CAML_LD_LIBRARY_PATH}.  Эта переменная указывает на @file{lib/ocaml/site-lib/stubslibs}, и именно здесь должны быть установлены библиотеки @file{.so}.

note: type: defvr
en: {Scheme Variable} python-build-system
ru: {Scheme переменная} python-build-system

note: type: defvr
en: This variable is exported by @code{(guix build-system python)}.  It implements the more or less standard build procedure used by Python packages, which consists in running @code{python setup.py build} and then @code{python setup.py install --prefix=/gnu/store/@dots{}}.
ru: Эта переменная экспортируется в @code{(guix build-system python)}.  Она реализует более или менее стандартную процедуру сборки, используемую пакетами Python, которая заключается в запуске @code{python setup.py build}, а затем @code{python setup.py install --prefix=/gnu/store/@dots{}}.

note: type: defvr
en: Which Python package is used to perform the build can be specified with the @code{#:python} parameter.  This is a useful way to force a package to be built for a specific version of the Python interpreter, which might be necessary if the package is only compatible with a single interpreter version.
ru: Какой пакет Python используется для сборки, можно указать с помощью параметра @code{#:python}.  Это полезный способ принудительно создать пакет для определенной версии интерпретатора Python, что может потребоваться, если пакет совместим только с одной версией интерпретатора.

note: type: defvr
en: By default guix calls @code{setup.py} under control of @code{setuptools}, much like @command{pip} does.  Some packages are not compatible with setuptools (and pip), thus you can disable this by setting the @code{#:use-setuptools?} parameter to @code{#f}.
ru: По умолчанию guix вызывает @code{setup.py} под управлением @code{setuptools}, как и @command{pip}.  Некоторые пакеты несовместимы с setuptools (и pip), поэтому вы можете отключить это, установив для параметра @code{#:use-setuptools?} значение @code{#f}.

note: type: defvr
en: This variable is exported by @code{(guix build-system perl)}.  It implements the standard build procedure for Perl packages, which either consists in running @code{perl Build.PL --prefix=/gnu/store/@dots{}}, followed by @code{Build} and @code{Build install}; or in running @code{perl Makefile.PL PREFIX=/gnu/store/@dots{}}, followed by @code{make} and @code{make install}, depending on which of @code{Build.PL} or @code{Makefile.PL} is present in the package distribution.  Preference is given to the former if both @code{Build.PL} and @code{Makefile.PL} exist in the package distribution.  This preference can be reversed by specifying @code{#t} for the @code{#:make-maker?} parameter.
ru: Эта переменная экспортируется в @code{(guix build-system perl)}.  Она реализует стандартную процедуру сборки для пакетов Perl, которая заключается либо в запуске @code{perl Build.PL --prefix=/gnu/store/@dots{}}, за которым следуют @code{Build} и @code{Build install}; или при запуске @code{perl Makefile.PL PREFIX=/gnu/store/@dots{}}, за которым следуют @code{make} и @code{make install}, в зависимости от того, какой из @code{Build.PL} или @code{Makefile.PL} присутствует в дистрибутиве пакета.  Предпочтение отдается первому, если в дистрибутиве пакета есть и @code{Build.PL}, и @code{Makefile.PL}.  Это предпочтение можно отменить, указав @code{#t} для параметра @code{#:make-maker?}.

note: type: defvr
en: The initial @code{perl Makefile.PL} or @code{perl Build.PL} invocation passes flags specified by the @code{#:make-maker-flags} or @code{#:module-build-flags} parameter, respectively.
ru: Первоначальный вызов @code{perl Makefile.PL} или @code{perl Build.PL} передает флаги, указанные в параметре @code{#:make-maker-flags} или @code{#:module-build-flags}, соответственно.

note: type: defvr
en: Which Perl package is used can be specified with @code{#:perl}.
ru: Какой пакет Perl используется, можно указать с помощью @code{#:perl}.

note: type: defvr
en: {Scheme Variable} renpy-build-system
ru: {Scheme Variable} r-build-system

note: type: defvr
en: This variable is exported by @code{(guix build-system renpy)}.  It implements the more or less standard build procedure used by Ren'py games, which consists of loading @code{#:game} once, thereby creating bytecode for it.
ru: Эта переменная экспортируется в @code{(guix build-system python)}.  Она реализует более или менее стандартную процедуру сборки, используемую пакетами Python, которая заключается в запуске @code{python setup.py build}, а затем @code{python setup.py install --prefix=/gnu/store/@dots{}}.

note: type: defvr
en: {Scheme Variable} qt-build-system
ru: {Scheme переменная} qt-build-system

note: type: defvr
en: This variable is exported by @code{(guix build-system qt)}.  It is intended for use with applications using Qt or KDE.
ru: Эта переменная экспортируется в @code{(guix build-system qt)}.  Она предназначена для использования с приложениями, использующими Qt или KDE.

note: type: defvr
en: This build system adds the following two phases to the ones defined by @code{cmake-build-system}:
ru: Эта система сборки добавляет следующие две фазы к тем, которые определены в @code{cmake-build-system}:

note: type: table
en: The phase @code{check-setup} prepares the environment for running the checks as commonly used by Qt test programs.  For now this only sets some environment variables: @code{QT_QPA_PLATFORM=offscreen}, @code{DBUS_FATAL_WARNINGS=0} and @code{CTEST_OUTPUT_ON_FAILURE=1}.
ru: Фаза @code{check-setup} подготавливает среду к запуску проверок, которые обычно используются тестовыми программами Qt.  Пока это устанавливает только некоторые переменные среды: @code{QT_QPA_PLATFORM=offscreen}, @code{DBUS_FATAL_WARNINGS=0} и @code{CTEST_OUTPUT_ON_FAILURE=1}.

note: type: table
en: This phase is added before the @code{check} phase.  It's a separate phase to ease adjusting if necessary.
ru: Этот этап добавляется перед этапом @code{check}.  Это отдельный этап для облегчения настройки.

note: type: table
en: The phase @code{qt-wrap} searches for Qt5 plugin paths, QML paths and some XDG in the inputs and output.  In case some path is found, all programs in the output's @file{bin/}, @file{sbin/}, @file{libexec/} and @file{lib/libexec/} directories are wrapped in scripts defining the necessary environment variables.
ru: Фаза @code{qt-wrap} ищет пути к плагинам Qt5, пути QML и некоторый XDG во входных и выходных данных.  Если путь найден, все программы в выходных каталогах @file{bin/}, @file{sbin/}, @file{libexec/} и @file{lib/libexec/} заключены в сценарии, определяющие необходимые environment переменные.

note: type: table
en: It is possible to exclude specific package outputs from that wrapping process by listing their names in the @code{#:qt-wrap-excluded-outputs} parameter.  This is useful when an output is known not to contain any Qt binaries, and where wrapping would gratuitously add a dependency of that output on Qt, KDE, or such.
ru: Можно исключить определенные выходные данные пакета из этого процесса упаковки, указав их имена в параметре @code{#:qt-wrap-excluded-output}.  Это полезно, когда известно, что вывод не содержит никаких двоичных файлов Qt, и когда обертка может произвольно добавить зависимость этого вывода от Qt, KDE и т.п.

note: type: table
en: This phase is added after the @code{install} phase.
ru: Эта фаза добавляется после фазы @code{install}.

note: type: defvr
en: This variable is exported by @code{(guix build-system r)}.  It implements the build procedure used by @uref{https://r-project.org, R} packages, which essentially is little more than running @samp{R CMD INSTALL --library=/gnu/store/@dots{}} in an environment where @env{R_LIBS_SITE} contains the paths to all R package inputs.  Tests are run after installation using the R function @code{tools::testInstalledPackage}.
ru: Эта переменная экспортируется в @code{(guix build-system r)}.  Она реализует процедуру сборки, используемую пакетами @uref{https://r-project.org, R}, которая, по сути, немного больше, чем запуск @samp{R CMD INSTALL --library=/gnu/store/@dots{}} в среде, где @env{R_LIBS_SITE} содержит пути ко всем входам пакета R.  Тесты запускаются после установки с использованием R-функции @code{tools::testInstalledPackage}.

note: type: defvr
en: {Scheme Variable} rakudo-build-system
ru: {Scheme переменная} rakudo-build-system

note: type: defvr
en: This variable is exported by @code{(guix build-system rakudo)}.  It implements the build procedure used by @uref{https://rakudo.org/, Rakudo} for @uref{https://perl6.org/, Perl6} packages.  It installs the package to @code{/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 @code{tests?} parameter.
ru: Эта переменная экспортируется @code{(guix build-system rakudo)}. Которая реализует систем сборки, используемую @uref{https://rakudo.org/, Rakudo} для @uref{https://perl6.org/, Perl6} пакетов. Она устанавливает: пакет в @code{/gnu/store/@dots{}/NAME-VERSION/share/perl6}; двоичные файлы, библиотеки и ресурсы; помещает файлы в @code{bin/}. Тесты можно пропустить, передав @code{#f} параметру @code{tests?}.

note: type: defvr
en: Which rakudo package is used can be specified with @code{rakudo}.  Which perl6-tap-harness package used for the tests can be specified with @code{#: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 @code{with-zef?} parameter.
ru: Какой пакет rakudo используется, можно указать с помощью @code{rakudo}.  Какой пакет perl6-tap-harness, используемый для тестов, можно указать с помощью @code{#:verify6} или удалить, передав @code{#f} в параметр @code{with-verify6?}.  Какой пакет perl6-zef, используемый для тестирования и установки, можно указать с помощью @code{#:zef} или удалить, передав @code{#f} в параметр @code{with-zef?}.

note: type: defvr
en: {Scheme Variable} texlive-build-system
ru: {Scheme переменная} texlive-build-system

note: type: defvr
en: This variable is exported by @code{(guix build-system texlive)}.  It is used to build TeX packages in batch mode with a specified engine.  The build system sets the @env{TEXINPUTS} variable to find all TeX source files in the inputs.
ru: Эта переменная экспортируется в @code{(guix build-system texlive)}.  Она используется для сборки пакетов TeX в batch режиме с указанным движком.  Система сборки устанавливает переменную @env{TEXINPUTS} для поиска всех исходных файлов TeX во входных данных.

note: type: defvr
en: By default it runs @code{luatex} on all files ending on @code{ins}.  A different engine and format can be specified with the @code{#:tex-format} argument.  Different build targets can be specified with the @code{#:build-targets} argument, which expects a list of file names.  The build system adds only @code{texlive-bin} and @code{texlive-latex-base} (both from @code{(gnu packages tex}) to the inputs.  Both can be overridden with the arguments @code{#:texlive-bin} and @code{#:texlive-latex-base}, respectively.
ru: По умолчанию она запускает @code{luatex} для всех файлов, заканчивающихся на @code{ins}.  Другой механизм и формат можно указать с помощью аргумента @code{#:tex-format}.  Различные цели сборки могут быть указаны с помощью аргумента @code{#:build-target}, который ожидает список имен файлов.  Система сборки добавляет к входам только @code{texlive-bin} и @code{texlive-latex-base} (оба из @code{(gnu packages tex}).  Оба могут быть переопределены с помощью аргументов @code{#:texlive-bin} и @code{#:texlive-latex-base} соответственно.

note: type: defvr
en: The @code{#:tex-directory} parameter tells the build system where to install the built files under the texmf tree.
ru: Параметр @code{#:tex-directory} сообщает системе сборки, где установить созданные файлы в дереве texmf.

note: type: defvr
en: {Scheme Variable} ruby-build-system
ru: {Scheme переменная} ruby-build-system

note: type: defvr
en: This variable is exported by @code{(guix build-system ruby)}.  It implements the RubyGems build procedure used by Ruby packages, which involves running @code{gem build} followed by @code{gem install}.
ru: Эта переменная экспортируется в @code{(guix build-system ruby)}.  Она реализует процедуру сборки RubyGems, используемую пакетами Ruby, которая включает запуск @code{gem build}, за которым следует @code{gem install}.

note: type: defvr
en: The @code{source} field of a package that uses this build system typically references a gem archive, since this is the format that Ruby developers use when releasing their software.  The build system unpacks the gem archive, potentially patches the source, runs the test suite, repackages the gem, and installs it.  Additionally, directories and tarballs may be referenced to allow building unreleased gems from Git or a traditional source release tarball.
ru: Поле @code{source} пакета, использующего эту систему сборки, обычно ссылается на gem архив, поскольку это формат, который разработчики Ruby используют при выпуске своего программного обеспечения.  Система сборки распаковывает gem архив, потенциально исправляет исходный код, запускает набор тестов, переупаковывает gem и устанавливает его.  Кроме того, на каталоги и архивы можно ссылаться, чтобы можно было создавать unreleased gem'ы из Git или традиционного архива с исходным кодом.

note: type: defvr
en: Which Ruby package is used can be specified with the @code{#:ruby} parameter.  A list of additional flags to be passed to the @command{gem} command can be specified with the @code{#:gem-flags} parameter.
ru: Какой пакет Ruby используется, можно указать с помощью параметра @code{#:ruby}.  Список дополнительных флагов, передаваемых команде @command{gem}, можно указать с помощью параметра @code{#:gem-flags}.

note: type: defvr
en: {Scheme Variable} waf-build-system
ru: {Scheme переменная} waf-build-system

note: type: defvr
en: This variable is exported by @code{(guix build-system waf)}.  It implements a build procedure around the @code{waf} script.  The common phases---@code{configure}, @code{build}, and @code{install}---are implemented by passing their names as arguments to the @code{waf} script.
ru: Эта переменная экспортируется в @code{(guix build-system waf)}.  Она реализует процедуру сборки вокруг сценария @code{waf}.  Общие этапы---@code{configure}, @code{build} и @code{install}---реализуются путем передачи их имен в качестве аргументов сценарию @code{waf}.

note: type: defvr
en: The @code{waf} script is executed by the Python interpreter.  Which Python package is used to run the script can be specified with the @code{#:python} parameter.
ru: Скрипт @code{waf} выполняется интерпретатором Python. Какой пакет Python используется для запуска сценария, можно указать с помощью параметра @code{#:python}.

note: type: defvr
en: {Scheme Variable} scons-build-system
ru: {Scheme переменная} scons-build-system

note: type: defvr
en: This variable is exported by @code{(guix build-system scons)}.  It implements the build procedure used by the SCons software construction tool.  This build system runs @code{scons} to build the package, @code{scons test} to run tests, and then @code{scons install} to install the package.
ru: Эта переменная экспортируется в @code{(guix build-system scons)}.  Она реализует процедуру сборки, используемую инструментом сборки программного обеспечения SCons.  Эта система сборки запускает @code{scons} для сборки пакета, @code{scons test} для запуска тестов и затем @code{scons install} для установки пакета.

note: type: defvr
en: Additional flags to be passed to @code{scons} can be specified with the @code{#:scons-flags} parameter.  The default build and install targets can be overridden with @code{#:build-targets} and @code{#:install-targets} respectively.  The version of Python used to run SCons can be specified by selecting the appropriate SCons package with the @code{#:scons} parameter.
ru: Дополнительные флаги, передаваемые в @code{scons}, можно указать с помощью параметра @code{#:scons-flags}.  Цели сборки и установки по умолчанию могут быть переопределены с помощью @code{#:build-target} и @code{#:install-target} соответственно.  Версия Python, используемая для запуска SCons, может быть указана путем выбора соответствующего пакета SCons с параметром @code{#:scons}.

note: type: defvr
en: {Scheme Variable} haskell-build-system
ru: {Scheme переменная} haskell-build-system

note: type: defvr
en: This variable is exported by @code{(guix build-system haskell)}.  It implements the Cabal build procedure used by Haskell packages, which involves running @code{runhaskell Setup.hs configure --prefix=/gnu/store/@dots{}} and @code{runhaskell Setup.hs build}.  Instead of installing the package by running @code{runhaskell Setup.hs install}, to avoid trying to register libraries in the read-only compiler store directory, the build system uses @code{runhaskell Setup.hs copy}, followed by @code{runhaskell Setup.hs register}.  In addition, the build system generates the package documentation by running @code{runhaskell Setup.hs haddock}, unless @code{#:haddock? #f} is passed.  Optional Haddock parameters can be passed with the help of the @code{#:haddock-flags} parameter.  If the file @code{Setup.hs} is not found, the build system looks for @code{Setup.lhs} instead.
ru: Эта переменная экспортируется в @code{(guix build-system haskell)}.  Она реализует процедуру сборки Cabal, используемую пакетами Haskell, которая включает запуск @code{runhaskell Setup.hs configure --prefix=/gnu/store/@dots{}} и @code{runhaskell Setup.hs build}.  Вместо установки пакета путем запуска @code{runhaskell Setup.hs install}, чтобы избежать попыток регистрации библиотек в каталоге хранилища компилятора только для чтения, система сборки использует @code{runhaskell Setup.hs copy}, за которым следует @code{runhaskell Setup.hs register}.  Кроме того, система сборки генерирует документацию по пакету, запуская @code{runhaskell Setup.hs haddock}, если только @code{#:haddock? #f} пройден.  Дополнительные параметры можно передать с помощью параметра @code{#:haddock-flags}.  Если файл @code{Setup.hs} не найден, система сборки вместо этого ищет @code{Setup.lhs}.

note: type: defvr
en: Which Haskell compiler is used can be specified with the @code{#:haskell} parameter which defaults to @code{ghc}.
ru: Какой компилятор Haskell используется, можно указать с помощью параметра @code{#:haskell}, который по умолчанию равен @code{ghc}.

note: type: defvr
en: {Scheme Variable} dub-build-system
ru: {Scheme переменная} dub-build-system

note: type: defvr
en: This variable is exported by @code{(guix build-system dub)}.  It implements the Dub build procedure used by D packages, which involves running @code{dub build} and @code{dub run}.  Installation is done by copying the files manually.
ru: Эта переменная экспортируется в @code{(guix build-system dub)}.  Она реализует процедуру сборки Dub, используемую пакетами D, которая включает запуск @code{dub build} и @code{dub run}.  Установка осуществляется путем копирования файлов вручную.

note: type: defvr
en: Which D compiler is used can be specified with the @code{#:ldc} parameter which defaults to @code{ldc}.
ru: Какой компилятор D используется, можно указать с помощью параметра @code{#:ldc}, который по умолчанию равен @code{ldc}.

note: type: defvr
en: {Scheme Variable} emacs-build-system
ru: {Scheme переменная} emacs-build-system

note: type: defvr
en: This variable is exported by @code{(guix build-system emacs)}.  It implements an installation procedure similar to the packaging system of Emacs itself (@pxref{Packages,,, emacs, The GNU Emacs Manual}).
ru: Эта переменная экспортируется в @code{(guix build-system emacs)}.  Она реализует процедуру установки, аналогичную системе упаковки самого Emacs (@pxref{Packages,,, emacs, The GNU Emacs Manual}).

note: type: defvr
en: It first creates the @code{@code{package}-autoloads.el} file, then it byte compiles all Emacs Lisp files.  Differently from the Emacs packaging system, the Info documentation files are moved to the standard documentation directory and the @file{dir} file is deleted.  The Elisp package files are installed directly under @file{share/emacs/site-lisp}.
ru: Сначала она создает файл @code{@code{package}-autoloads.el}, а затем байт-компилирует все файлы Emacs Lisp.  В отличие от системы упаковки Emacs, файлы документации Info перемещаются в стандартный каталог документации, а файл @file{dir} удаляется.  Файлы пакета Elisp устанавливаются непосредственно в @file{share/emacs/site-lisp}.

note: type: defvr
en: {Scheme Variable} font-build-system
ru: {Scheme переменная} font-build-system

note: type: defvr
en: This variable is exported by @code{(guix build-system font)}.  It implements an installation procedure for font packages where upstream provides pre-compiled TrueType, OpenType, etc.@: font files that merely need to be copied into place.  It copies font files to standard locations in the output directory.
ru: Эта переменная экспортируется в @code{(guix build-system font)}.  Она реализует процедуру установки для пакетов шрифтов, в которой upstream предоставляет предварительно скомпилированные файлы TrueType, OpenType и т.д.@: файлы шрифтов, которые необходимо просто скопировать на место.  Она копирует файлы шрифтов в стандартные места выходного каталога.

note: type: defvr
en: {Scheme Variable} meson-build-system
ru: {Scheme переменная} meson-build-system

note: type: defvr
en: This variable is exported by @code{(guix build-system meson)}.  It implements the build procedure for packages that use @url{https://mesonbuild.com, Meson} as their build system.
ru: Эта переменная экспортируется в @code{(guix build-system meson)}.  Она реализует процедуру сборки для пакетов, которые используют @url{https://mesonbuild.com, Meson} в качестве своей системы сборки.

note: type: defvr
en: This build system is an extension of @code{gnu-build-system}, but with the following phases changed to some specific for Meson:
ru: Эта система сборки является расширением @code{gnu-build-system}, но со следующими фазами, измененными на некоторые специфичные для Meson:

note: type: table
en: The phase runs @code{meson} with the flags specified in @code{#:configure-flags}.  The flag @option{--buildtype} is always set to @code{debugoptimized} unless something else is specified in @code{#:build-type}.
ru: На этапе выполняется @code{meson} с флагами, указанными в @code{#:configure-flags}.  Флаг @option{--buildtype} всегда установлен на @code{debugoptimized}, если что-то еще не указано в @code{#:build-type}.

note: type: table
en: The phase runs @code{ninja} to build the package in parallel by default, but this can be changed with @code{#:parallel-build?}.
ru: На этапе выполняется @code{ninja} для параллельной сборки пакета по умолчанию, но это можно изменить с помощью @code{#:parallel-build?}.

note: type: table
en: The phase runs @code{ninja install} and can not be changed.
ru: Фаза выполняется @code{ninja install} и не может быть изменен.

note: type: defvr
en: Apart from that, the build system also adds the following phases:
ru: Помимо этого, система сборки также добавляет следующие фазы:

note: type: table
en: This phase is the phase provided by @code{glib-or-gtk-build-system}, and it is not enabled by default.  It can be enabled with @code{#:glib-or-gtk?}.
ru: Эта фаза предоставляется @code{glib-or-gtk-build-system} и по умолчанию не включена.  Ее можно включить с помощью @code{#:glib-or-gtk?}.

note: type: defvr
en: {Scheme Variable} linux-module-build-system
ru: {Scheme переменная} linux-module-build-system

note: type: defvr
en: @code{linux-module-build-system} allows building Linux kernel modules.
ru: @code{linux-module-build-system} позволяет создавать модули ядра Linux.

note: type: defvr
en: This build system is an extension of @code{gnu-build-system}, but with the following phases changed:
ru: Эта система сборки является расширением @code{gnu-build-system}, но со следующими изменениями:

note: type: table
en: This phase configures the environment so that the Linux kernel's Makefile can be used to build the external kernel module.
ru: На этой фазе среда настраивается таким образом, чтобы Makefile ядра Linux можно было использовать для сборки внешнего модуля ядра.

note: type: table
en: This phase uses the Linux kernel's Makefile in order to build the external kernel module.
ru: На этой фазе используется Makefile ядра Linux для сборки внешнего модуля ядра.

note: type: table
en: This phase uses the Linux kernel's Makefile in order to install the external kernel module.
ru: На этой фазе используется Makefile ядра Linux для установки внешнего модуля ядра.

note: type: defvr
en: It is possible and useful to specify the Linux kernel to use for building the module (in the @code{arguments} form of a package using the @code{linux-module-build-system}, use the key @code{#:linux} to specify it).
ru: Возможно и полезно указать ядро Linux, которое будет использоваться для сборки модуля (в форме @code{arguments} пакета с использованием @code{linux-module-build-system} используйте ключ @code{#:linux}, чтобы указать это).

note: type: defvr
en: {Scheme Variable} node-build-system
ru: {Scheme переменная} node-build-system

note: type: defvr
en: This variable is exported by @code{(guix build-system node)}.  It implements the build procedure used by @uref{https://nodejs.org, Node.js}, which implements an approximation of the @code{npm install} command, followed by an @code{npm test} command.
ru: Эта переменная экспортируется в @code{(guix build-system node)}.  Она реализует процедуру сборки, используемую @uref{https://nodejs.org, Node.js}, которая реализует аппроксимацию команды @code{npm install}, за которой следует команда @code{npm test}.

note: type: defvr
en: Which Node.js package is used to interpret the @code{npm} commands can be specified with the @code{#:node} parameter which defaults to @code{node}.
ru: Какой пакет Node.js используется для интерпретации команд @code{npm}, можно указать с помощью параметра @code{#:node}, который по умолчанию равен @code{node}.

note: type: Plain text
en: Lastly, for packages that do not need anything as sophisticated, a ``trivial'' build system is provided.  It is trivial in the sense that it provides basically no support: it does not pull any implicit inputs, and does not have a notion of build phases.
ru: Наконец, для пакетов, которым не нужно ничего столь же сложного, предоставляется ``trivial'' система сборки.  Она тривиальна в том смысле, что она практически не оказывает поддержки при сборке: она не извлекает никаких неявных входных данных и не имеет понятия о этапах сборки.

note: type: defvr
en: {Scheme Variable} trivial-build-system
ru: {Scheme переменная} trivial-build-system

note: type: defvr
en: This variable is exported by @code{(guix build-system trivial)}.
ru: Эта переменная экспортируется @code{(guix build-system trivial)}.

note: type: defvr
en: This build system requires a @code{#:builder} argument.  This argument must be a Scheme expression that builds the package output(s)---as with @code{build-expression->derivation} (@pxref{Derivations, @code{build-expression->derivation}}).
ru: Эта система сборки требует аргумента @code{#:builder}.  Этот аргумент должен быть Scheme выражением, которое строит выходные данные пакета---как с @code{build-expression->derivation} (@pxref{Derivations, @code{build-expression->derivation}}).

note: type: cindex
en: build phases, for packages
ru: входные данные, для пакетов Python

note: type: Plain text
en: Almost all package build systems implement a notion @dfn{build phases}: a sequence of actions that the build system executes, when you build the package, leading to the installed byproducts in the store.  A notable exception is the ``bare-bones'' @code{trivial-build-system} (@pxref{Build Systems}).
ru: Почти все системы сборки пакетов реализуют понятие @dfn{фазы сборки}: последовательность действий, которые система сборки выполняет при сборке пакета, что приводит к установке побочных продуктов в store.  Заметным исключением является ``bare-bones'' @code{trivial-build-system} (@pxref{Build Systems}).

note: type: table
en: Unpack the source tarball, and change the current directory to the extracted source tree.  If the source is actually a directory, copy it to the build tree, and enter that directory.
ru: Распаковать архив исходных текстов и измените текущий каталог на извлеченное дерево исходных текстов.  Если источник на самом деле является каталогом, скопировать его в дерево сборки и войдите в этот каталог.

note: type: table
en: Patch shebangs encountered in source files so they refer to the right store file names.  For instance, this changes @code{#!/bin/sh} to @code{#!/gnu/store/@dots{}-bash-4.3/bin/sh}.
ru: Изменить shebang, встречающиеся в исходных файлах, чтобы они ссылались на правильные имена файлов хранилища.  Например, это изменяет @code{#!/bin/sh} на @code{#!/gnu/store/@dots{}-bash-4.3/bin/sh}.

note: type: table
en: Run the @file{configure} script with a number of default options, such as @option{--prefix=/gnu/store/@dots{}}, as well as the options specified by the @code{#:configure-flags} argument.
ru: Запустить сценарий @file{configure} с несколькими параметрами по умолчанию, такими как @option{--prefix=/gnu/store/@dots{}}, а также параметрами, указанными в @code{#:configure-flags} аргументе.

note: type: table
en: Run @code{make} with the list of flags specified with @code{#:make-flags}.  If the @code{#:parallel-build?} argument is true (the default), build with @code{make -j}.
ru: Запустить @code{make} со списком флагов, указанным с помощью @code{#:make-flags}.  Если аргумент @code{#:parallel-build?} истинен (по умолчанию), выполнить сборку с @code{make -j}.

note: type: table
en: Run @code{make check}, or some other target specified with @code{#:test-target}, unless @code{#:tests? #f} is passed.  If the @code{#:parallel-tests?} argument is true (the default), run @code{make check -j}.
ru: Запустить @code{make check} или другой target, указанный с помощью @code{#:test-target}, если только @code{#:tests? #f} пройден.  Если аргумент @code{#:parallel-tests?} истинен (по умолчанию), запустить @code{make check -j}.

note: type: table
en: Run @code{make install} with the flags listed in @code{#:make-flags}.
ru: Запустить @code{make install} с флагами, перечисленными в @code{#:make-flags}.

note: type: table
en: Patch shebangs on the installed executable files.
ru: Изменить shebangs на установленные исполняемые файлы.

note: type: table
en: Strip debugging symbols from ELF files (unless @code{#:strip-binaries?} is false), copying them to the @code{debug} output when available (@pxref{Installing Debugging Files}).
ru: Удалить символы отладки из файлов ELF (если @code{#:strip-binaries?} не является ложным), скопировав их в выходные данные @code{debug}, если они доступны (@pxref{Installing Debugging Files}).

note: type: Plain text
en: Other build systems have similar phases, with some variations.  For example, @code{cmake-build-system} has same-named phases but its @code{configure} phases runs @code{cmake} instead of @code{./configure}.  Others, such as @code{python-build-system}, have a wholly different list of standard phases.  All this code runs on the @dfn{build side}: it is evaluated when you actually build the package, in a dedicated build process spawned by the build daemon (@pxref{Invoking guix-daemon}).
ru: Как обсуждалось в предыдущем разделе, эти системы сборки предоставляют стандартный список фаз.  Для @code{gnu-build-system} стандартные фазы включают фазу @code{unpack} для распаковки архива исходного кода, фазу @command{configure} для запуска @code{./configure}, @code{build} фаза для запуска @command{make} и (среди прочего) фазу @code{install} для запуска @command{make install}; @pxref{Build Systems}, чтобы получить более подробное представление об этих фазах.  Точно так же @code{cmake-build-system} наследует эти фазы, но его фаза @code{configure} запускает @command{cmake} вместо @command{./configure}.  Другие системы сборки, такие как @code{python-build-system}, имеют совершенно другой список стандартных фаз.  Весь этот код выполняется на @dfn{build side}: он выполняется, когда вы фактически собираете пакет, в отдельном процессе сборки, порожденном демоном сборки (@pxref{Invoking guix-daemon}).

note: type: Plain text
en: Build phases are represented as association lists or ``alists'' (@pxref{Association Lists,,, guile, GNU Guile Reference Manual}) where each key is a symbol for the name of the phase and the associated value is a procedure that accepts an arbitrary number of arguments.  By convention, those procedures receive information about the build in the form of @dfn{keyword parameters}, which they can use or ignore.
ru: Этапы сборки представлены в виде ассоциативных списков или ``alists'' (@pxref{Association Lists,,, guile, GNU Guile Reference Manual}), где каждый ключ является символом имени фазы, а соответствующее значение - процедурой, которая принимает произвольное количество аргументов.  По соглашению эти процедуры получают информацию о сборке в виде @dfn{ключевых параметров}, которые они могут использовать или игнорировать.

note: type: Plain text
en: For example, here is how @code{(guix build gnu-build-system)} defines @code{%standard-phases}, the variable holding its alist of build phases@footnote{We present a simplified view of those build phases, but do take a look at @code{(guix build gnu-build-system)} to see all the details!}:
ru: Например, вот как @code{(guix build gnu-build-system)} определяет @code{%standard-phase}, переменную, содержащую список фаз сборки @footnote{Мы представляем упрощенное представление этих фаз сборки, но обязательно взгляните на @code{(guix build gnu-build-system)}, чтобы увидеть все подробности!}:

note: type: Plain text
en: This shows how @code{%standard-phases} is defined as a list of symbol/procedure pairs (@pxref{Pairs,,, guile, GNU Guile Reference Manual}).  The first pair associates the @code{unpack} procedure with the @code{unpack} symbol---a name; the second pair defines the @code{configure} phase similarly, and so on.  When building a package that uses @code{gnu-build-system} with its default list of phases, those phases are executed sequentially.  You can see the name of each phase started and completed in the build log of packages that you build.
ru: Это показывает, как @code{%standard-phase} определяется как список пар символ/процедура (@pxref{Pairs,,, guile, GNU Guile Reference Manual}).  Первая пара связывает процедуру @code{unpack} с символом @code{unpack}---именем; вторая пара аналогичным образом определяет фазу @code{configure} и так далее.  При сборке пакета, который использует @code{gnu-build-system} со списком фаз по умолчанию, эти фазы выполняются последовательно.  Вы можете увидеть название каждой фазы, запущенной и завершенной, в журнале сборки пакетов, которые вы собираете.

note: type: Plain text
en: Let's now look at the procedures themselves.  Each one is defined with @code{define*}: @code{#:key} lists keyword parameters the procedure accepts, possibly with a default value, and @code{#:allow-other-keys} specifies that other keyword parameters are ignored (@pxref{Optional Arguments,,, guile, GNU Guile Reference Manual}).
ru: Теперь посмотрим на сами процедуры.  Каждая из них определяется с помощью @code{define*}: @code{#:key} перечисляет параметры ключевого слова, которые принимает процедура, возможно, со значением по умолчанию, а @code{#:allow-other-keys} указывает, что другие параметры ключевого слова являются игнорируется (@pxref{Optional Arguments,,, guile, GNU Guile Reference Manual}).

note: type: Plain text
en: The @code{unpack} procedure honors the @code{source} parameter, which the build system uses to pass the file name of the source tarball (or version control checkout), and it ignores other parameters.  The @code{configure} phase only cares about the @code{outputs} parameter, an alist mapping package output names to their store file name (@pxref{Packages with Multiple Outputs}).  It extracts the file name of for @code{out}, the default output, and passes it to @command{./configure} as the installation prefix, meaning that @command{make install} will eventually copy all the files in that directory (@pxref{Configuration, configuration and makefile conventions,, standards, GNU Coding Standards}).  @code{build} and @code{install} ignore all their arguments.  @code{check} honors the @code{test-target} argument, which specifies the name of the Makefile target to run tests; it prints a message and skips tests when @code{tests?} is false.
ru: Процедура @code{unpack} учитывает параметр @code{source}, который система сборки использует для передачи имени файла исходного архива (или checkout контроля версий), и игнорирует другие параметры.  Фаза @code{configure} касается только параметра @code{output}, списка имен выходных пакетов, отображающих имена файлов хранилища (@pxref{Packages with Multiple Outputs}).  Она извлекает имя файла для @code{out}, вывода по умолчанию, и передает его @command{./configure} в качестве префикса установки, что означает, что @command{make install} в конечном итоге скопирует все файлы в этом каталоге (@pxref{Configuration, configuration and makefile conventions,, standards, GNU Coding Standards}).  @code{build} и @code{install} игнорируют все свои аргументы.  @code{check} учитывает аргумент @code{test-target}, который указывает имя цели Makefile для запуска тестов; она печатает сообщение и пропускает тесты, если @code{tests?} ложно.

note: type: Plain text
en: The list of phases used for a particular package can be changed with the @code{#:phases} parameter of the build system.  Changing the set of build phases boils down to building a new alist of phases based on the @code{%standard-phases} alist described above.  This can be done with standard alist procedures such as @code{alist-delete} (@pxref{SRFI-1 Association Lists,,, guile, GNU Guile Reference Manual}); however, it is more convenient to do so with @code{modify-phases} (@pxref{Build Utilities, @code{modify-phases}}).
ru: Список фаз, используемых для конкретного пакета, можно изменить с помощью параметра @code{#:phase} системы сборки.  Изменение набора фаз сборки сводится к созданию нового списка фаз на основе списка @code{%standard-phase}, описанного выше.  Это можно сделать с помощью стандартных процедур списков, таких как @code{alist-delete} (@pxref{SRFI-1 Association Lists,,, guile, GNU Guile Reference Manual}); однако это удобнее делать с помощью @code{modify-phase} (@pxref{Build Utilities, @code{modify-phases}}).

note: type: Plain text
en: Here is an example of a package definition that removes the @code{configure} phase of @code{%standard-phases} and inserts a new phase before the @code{build} phase, called @code{set-prefix-in-makefile}:
ru: Вот пример определения пакета, который удаляет фазу @code{configure} из @code{%standard-phase} и вставляет новую фазу перед фазой @code{build}, которая называется @code{set-prefix-in- makefile}:

note: type: Plain text
en: The new phase that is inserted is written as an anonymous procedure, introduced with @code{lambda*}; it honors the @code{outputs} parameter we have seen before.  @xref{Build Utilities}, for more about the helpers used by this phase, and for more examples of @code{modify-phases}.
ru: Новая вставляемая фаза записывается как анонимная процедура, представленная с помощью @code{lambda*}; она учитывает параметр @code{output}, который мы видели ранее.  @xref{Build Utilities}, чтобы узнать больше о помощниках, используемых в этой фазе, и получить больше примеров @code{modify-phase}.

note: type: cindex
en: code staging
ru: staging кода

note: type: cindex
en: staging, of code
ru: форматировние, кода

note: type: Plain text
en: Keep in mind that build phases are code evaluated at the time the package is actually built.  This explains why the whole @code{modify-phases} expression above is quoted (it comes after the @code{'} or apostrophe): it is @dfn{staged} for later execution.  @xref{G-Expressions}, for an explanation of code staging and the @dfn{code strata} involved.
ru: Имейте в виду, что фазы сборки - это код, выполняемый во время фактической сборки пакета.  Это объясняет, почему приведенное выше выражение @code{modify-phase} целиком (оно идет после @code{'} или апострофа): это @dfn{staged} для последующего выполнения.  @xref{G-Expressions} для объяснения staging кода и задействованных @dfn{code strata}.

note: type: Plain text
en: As soon as you start writing non-trivial package definitions (@pxref{Defining Packages}) or other build actions (@pxref{G-Expressions}), you will likely start looking for helpers for ``shell-like'' actions---creating directories, copying and deleting files recursively, manipulating build phases, and so on.  The @code{(guix build utils)} module provides such utility procedures.
ru: Как только вы начнете писать нетривиальные определения пакетов (@pxref{Defining Packages}) или другие действия сборки (@pxref{G-Expressions}), вы, скорее всего, начнете искать помощников для действий, подобных оболочке---создание каталогов, рекурсивное копирование и удаление файлов, управление этапами сборки и т.д.  Модуль @code{(guix build utils)} предоставляет такие служебные процедуры.

note: type: Plain text
en: Most build systems load @code{(guix build utils)} (@pxref{Build Systems}).  Thus, when writing custom build phases for your package definitions, you can usually assume those procedures are in scope.
ru: Большинство систем сборки загружают @code{(guix build utils)} (@pxref{Build Systems}).  Таким образом, при написании настраиваемых фаз сборки для определений пакетов вы обычно можете предположить, что эти процедуры входят в область действия.

note: type: Plain text
en: When writing G-expressions, you can import @code{(guix build utils)} on the ``build side'' using @code{with-imported-modules} and then put it in scope with the @code{use-modules} form (@pxref{Using Guile Modules,,, guile, GNU Guile Reference Manual}):
ru: При написании G-выражений вы можете импортировать @code{(guix build utils)} на ``стороне сборки'', используя @code{with-import-modules}, а затем поместить его в область видимости с помощью формы @code{use-modules} (@pxref{Using Guile Modules,,, guile, GNU Guile Reference Manual}):

note: type: Plain text
en: The remainder of this section is the reference for most of the utility procedures provided by @code{(guix build utils)}.
ru: Оставшаяся часть этого раздела является справочником по большинству служебных процедур, предоставляемых @code{(guix build utils)}.

note: type: subsection
en: Dealing with Store File Names
ru: Работа с именами файлов в store

note: type: Plain text
en: This section documents procedures that deal with store file names.
ru: В этом разделе описаны процедуры, относящиеся к именам файлов в store.

note: type: deffn
en: {Scheme Procedure} %store-directory
ru: {Процедура Scheme} sane-service-type

note: type: deffn
en: Return the directory name of the store.
ru: Проверить целостность склада.

note: type: deffn
en: {Scheme Procedure} store-file-name? @var{file}
ru: {Scheme Procedure} file-union @var{name} @var{files}

note: type: deffn
en: Return true if @var{file} is in the store.
ru: Возвращает true, если объект @var{obj} --- это пакет ранней версии.

note: type: deffn
en: {Scheme Procedure} strip-store-file-name @var{file}
ru: {Scheme Procedure} file-union @var{name} @var{files}

note: type: deffn
en: Strip the @file{/gnu/store} and hash from @var{file}, a store file name.  The result is typically a @code{"@var{package}-@var{version}"} string.
ru: Удалиnm @file{/gnu/store} и хэш из @var{file}, имени файла в store.  Результатом обычно является строка @code{"@var{package}-@var{version}"}.

note: type: deffn
en: {Scheme Procedure} package-name->name+version @var{name}
ru: {Процедура Scheme} inferior-package-version @var{package}

note: type: deffn
en: Given @var{name}, a package name like @code{"foo-0.9.1b"}, return two values: @code{"foo"} and @code{"0.9.1b"}.  When the version part is unavailable, @var{name} and @code{#f} are returned.  The first hyphen followed by a digit is considered to introduce the version part.
ru: Учитывая @var{name}, имя пакета, такое как @code{"foo-0.9.1b"}, возвращает два значения: @code{"foo"} и @code{"0.9.1b"}.  Если часть версии недоступна, возвращаются @var{name} и @code{#f}.  Считается, что первый дефис, за которым следует цифра, обозначает часть версии.

note: type: subsection
en: File Types
ru: Файловые системы

note: type: Plain text
en: The procedures below deal with files and file types.
ru: Процедуры, приведённые ниже, обеспечивают работу и управление ранними версиями пакетов.

note: type: deffn
en: {Scheme Procedure} directory-exists? @var{dir}
ru: {Scheme Procedure} directory-union @var{name} @var{things}

note: type: deffn
en: Return @code{#t} if @var{dir} exists and is a directory.
ru: Вернуть @code{#t}, если @var{dir} существует и является каталогом.

note: type: deffn
en: {Scheme Procedure} executable-file? @var{file}
ru: {Scheme Procedure} file-union @var{name} @var{files}

note: type: deffn
en: Return @code{#t} if @var{file} exists and is executable.
ru: Вернуть @code{#t}, если @var{file} существует и исполняемый файл.

note: type: deffn
en: {Scheme Procedure} symbolic-link? @var{file}
ru: {Scheme Procedure} file-union @var{name} @var{files}

note: type: deffn
en: Return @code{#t} if @var{file} is a symbolic link (aka. a ``symlink'').
ru: Вернуть @code{#t}, если @var{file} является символической ссылкой (также известной как ``символическая ссылка'').

note: type: deffn
en: {Scheme Procedure} elf-file? @var{file}
ru: {Scheme Procedure} file-union @var{name} @var{files}

note: type: deffnx
en: {Scheme Procedure} ar-file? @var{file}
ru: {Scheme Procedure} file-union @var{name} @var{files}

note: type: deffnx
en: {Scheme Procedure} gzip-file? @var{file}
ru: {Scheme Procedure} file-union @var{name} @var{files}

note: type: deffn
en: Return @code{#t} if @var{file} is, respectively, an ELF file, an @code{ar} archive (such as a @file{.a} static library), or a gzip file.
ru: Вернуть @code{#t}, если @var{file} является, соответственно, файлом ELF, архивом @code{ar} (например, статической библиотекой @file{.a}) или файлом gzip.

note: type: deffn
en: {Scheme Procedure} reset-gzip-timestamp @var{file} [#:keep-mtime? #t]
ru: {Процедура Scheme} inferior-package-inputs @var{package}

note: type: deffn
en: If @var{file} is a gzip file, reset its embedded timestamp (as with @command{gzip --no-name}) and return true.  Otherwise return @code{#f}.  When @var{keep-mtime?} is true, preserve @var{file}'s modification time.
ru: Если @var{file} является файлом gzip, сбросить его timestamp (как в случае @command{gzip --no-name}) и вернуть истину.  В противном случае вернуть @code{#f}.  Когда @var{keep-mtime?} истинна, сохранить время модификации @var{file}.

note: type: subsection
en: File Manipulation
ru: Управление файлами

note: type: Plain text
en: The following procedures and macros help create, modify, and delete files.  They provide functionality comparable to common shell utilities such as @command{mkdir -p}, @command{cp -r}, @command{rm -r}, and @command{sed}.  They complement Guile's extensive, but low-level, file system interface (@pxref{POSIX,,, guile, GNU Guile Reference Manual}).
ru: Следующие процедуры и макросы помогают создавать, изменять и удалять файлы.  Они обеспечивают функциональность, сопоставимую с такими обычными утилитами оболочки, как @command{mkdir -p}, @command{cp -r}, @command{rm -r} и @command{sed}.  Они дополняют обширный, но низкоуровневый интерфейс файловой системы Guile (@pxref{POSIX,,, guile, GNU Guile Reference Manual}).

note: type: deffn
en: {Scheme Syntax} with-directory-excursion @var{directory} @var{body}@dots{}
ru: {Scheme Syntax} let-system @var{system} @var{body}@dots{}

note: type: deffn
en: Run @var{body} with @var{directory} as the process's current directory.
ru: Запустить @var{body} с @var{directory} в качестве текущего каталога процесса.

note: type: deffn
en: Essentially, this macro changes the current directory to @var{directory} before evaluating @var{body}, using @code{chdir} (@pxref{Processes,,, guile, GNU Guile Reference Manual}).  It changes back to the initial directory when the dynamic extent of @var{body} is left, be it @i{via} normal procedure return or @i{via} a non-local exit such as an exception.
ru: По сути, этот макрос изменяет текущий каталог на @var{directory} перед вычислением @var{body}, используя @code{chdir} (@pxref{Processes,,, guile, GNU Guile Reference Manual}).  Она возвращается в исходный каталог, когда остается динамический extent @var{body}, будь то @i{через} возврат нормальной процедуры или @i{через} нелокальный выход, такой как исключение.

note: type: deffn
en: {Scheme Procedure} mkdir-p @var{dir}
ru: {Процедура Scheme} inferior-packages @var{inferior}

note: type: deffn
en: Create directory @var{dir} and all its ancestors.
ru: Создать каталог @var{dir} и всех его предков.

note: type: deffn
en: {Scheme Procedure} install-file @var{file} @var{directory}
ru: {Процедура Scheme} open-inferior @var{directory} @

note: type: deffn
en: Create @var{directory} if it does not exist and copy @var{file} in there under the same name.
ru: Создать @var{каталог}, если он не существует, и скопировать туда @var{file} под тем же именем.

note: type: deffn
en: {Scheme Procedure} make-file-writable @var{file}
ru: {Scheme Procedure} file-union @var{name} @var{files}

note: type: deffn
en: Make @var{file} writable for its owner.
ru: Сделать @var{file} доступным для записи его владельцу.

note: type: deffn
en: {Scheme Procedure} copy-recursively @var{source} @var{destination} @
ru: {Scheme Procedure} lookup-inferior-packages @var{inferior} @var{name} @

note: type: deffn
en: {Scheme Procedure} delete-file-recursively @var{dir} @
ru: {Процедура Scheme} open-inferior @var{directory} @

note: type: deffn
en: [#:follow-mounts? #f] Delete @var{dir} recursively, like @command{rm -rf}, without following symlinks.  Don't follow mount points either, unless @var{follow-mounts?} is true.  Report but ignore errors.
ru: [#:follow-mounts? #f] @var{dir} рекурсивно, как @command{rm -rf}, без использования символических ссылок.  Также не следовать точкам монтирования, если @var{follow-mounts?} не истинна.  Сообщать об ошибках, но игнорировать их.

note: type: deffn
en: {Scheme Syntax} substitute* @var{file} @
ru: {Scheme Syntax} let-system @var{system} @var{body}@dots{}

note: type: deffn
en: ((@var{regexp} @var{match-var}@dots{}) @var{body}@dots{}) @dots{} Substitute @var{regexp} in @var{file} by the string returned by @var{body}.  @var{body} is evaluated with each @var{match-var} bound to the corresponding positional regexp sub-expression.  For example:
ru: ((@var{regexp} @var{match-var}@dots{}) @var{body}@dots{}) @dots{} Заменить @var{regexp} в @var{file} строкой, возвращаемой @var{body}.  @var{body} вычисляется с каждой привязкой @var{match-var} к соответствующему подвыражению позиционного регулярного выражения.  Например:

note: type: deffn
en: Here, anytime a line of @var{file} contains @code{hello}, it is replaced by @code{good morning}.  Anytime a line of @var{file} matches the second regexp, @code{all} is bound to the complete match, @code{letters} is bound to the first sub-expression, and @code{end} is bound to the last one.
ru: Здесь, когда строка @var{file} содержит @code{hello}, она заменяется на @code{good morning}.  Каждый раз, когда строка @var{file} соответствует второму регулярному выражению, @code{all} привязывается к полному совпадению, @code{letters} привязано к первому подвыражению, а @code{end} привязано к последнему.

note: type: deffn
en: When one of the @var{match-var} is @code{_}, no variable is bound to the corresponding match substring.
ru: Когда одно из @var{match-var} - @code{_}, никакая переменная не связана с соответствующей подстрокой соответствия.

note: type: deffn
en: Alternatively, @var{file} may be a list of file names, in which case they are all subject to the substitutions.
ru: В качестве альтернативы @var{file} может быть списком имен файлов, и в этом случае все они могут быть заменены.

note: type: deffn
en: Be careful about using @code{$} to match the end of a line; by itself it won't match the terminating newline of a line.
ru: В качестве альтернативы @var{file} может быть списком имен файлов, и в этом случае все они могут быть заменены.

note: type: subsection
en: File Search
ru: Файловые системы

note: type: cindex
en: file, searching
ru: файл, поиск

note: type: Plain text
en: This section documents procedures to search and filter files.
ru: В этом разделе описаны процедуры поиска и фильтрации файлов.

note: type: deffn
en: {Scheme Procedure} file-name-predicate @var{regexp}
ru: {Процедура Scheme} inferior-package? @var{obj}

note: type: deffn
en: Return a predicate that returns true when passed a file name whose base name matches @var{regexp}.
ru: Вернуть предикат, который возвращает истину при передаче имени файла, базовое имя которого совпадает с @var{regexp}.

note: type: deffn
en: {Scheme Procedure} find-files @var{dir} [@var{pred}] @
ru: {Процедура Scheme} lookup-inferior-packages @var{inferior} @var{name} @

note: type: deffn
en: [#:stat lstat] [#:directories? #f] [#:fail-on-error? #f] Return the lexicographically sorted list of files under @var{dir} for which @var{pred} returns true.  @var{pred} is passed two arguments: the absolute file name, and its stat buffer; the default predicate always returns true.  @var{pred} can also be a regular expression, in which case it is equivalent to @code{(file-name-predicate @var{pred})}.  @var{stat} is used to obtain file information; using @code{lstat} means that symlinks are not followed.  If @var{directories?} is true, then directories will also be included.  If @var{fail-on-error?} is true, raise an exception upon error.
ru: [#:stat lstat] [#:directories? #f] [#:fail-on-error? #f] Возвращает лексикографически отсортированный список файлов в @var{dir}, для которых @var{pred} возвращает истину.  @var{pred} передается два аргумента: абсолютное имя файла и его буфер статистики; предикат по умолчанию всегда возвращает истину.  @var{pred} также может быть регулярным выражением, в этом случае оно эквивалентно @code{(file-name-predicate @var{pred})}.  @var{stat} используется для получения информации о файле; использование @code{lstat} означает, что символические ссылки не соблюдаются.  Если @var{directories?} истина, то каталоги также будут включены.  Если @var{fail-on-error?} истина, генерировать исключение при ошибке.

note: type: Plain text
en: Here are a few examples where we assume that the current directory is the root of the Guix source tree:
ru: Вот несколько примеров, в которых мы предполагаем, что текущий каталог является корнем дерева исходников Guix:

note: type: deffn
en: {Scheme Procedure} which @var{program}
ru: {Процедура Scheme} inferior-packages @var{inferior}

note: type: deffn
en: Return the complete file name for @var{program} as found in @code{$PATH}, or @code{#f} if @var{program} could not be found.
ru: Вернуть полное имя файла для @var{program}, как в @code{$PATH}, или @code{#f}, если @var{program} не найдена.

note: type: Plain text
en: The @code{(guix build utils)} also contains tools to manipulate build phases as used by build systems (@pxref{Build Systems}).  Build phases are represented as association lists or ``alists'' (@pxref{Association Lists,,, guile, GNU Guile Reference Manual}) where each key is a symbol naming the phase and the associated value is a procedure (@pxref{Build Phases}).
ru: @code{(guix build utils)} также содержит инструменты для управления фазами сборки, которые используются системами сборки (@pxref{Build Systems}).  Фазы сборки представлены в виде ассоциативных списков или ``alists'' (@pxref{Association Lists,,, guile, GNU Guile Reference Manual}), где каждый ключ представляет собой символ, обозначающий фазу, а связанное значение представляет собой процедуру (@pxref{Build Phases}).

note: type: Plain text
en: Guile core and the @code{(srfi srfi-1)} module both provide tools to manipulate alists.  The @code{(guix build utils)} module complements those with tools written with build phases in mind.
ru: Ядро Guile и модуль @code{(srfi srfi-1)} предоставляют инструменты для управления списками.  Модуль @code{(guix build utils)} дополняет их инструментами, написанными с учетом фаз сборки.

note: type: deffn
en: {Scheme Syntax} modify-phases @var{phases} @var{clause}@dots{}
ru: {Scheme Syntax} let-system @var{system} @var{body}@dots{}

note: type: deffn
en: Modify @var{phases} sequentially as per each @var{clause}, which may have one of the following forms:
ru: Изменить @var{phases} последовательно в соответствии с каждым @var{clause}, которое может иметь одну из следующих форм:

note: type: deffn
en: Where every @var{phase-name} above is an expression evaluating to a symbol, and @var{new-phase} an expression evaluating to a procedure.
ru: Где каждая @var{phase-name} выше - это выражение, преобразующееся в символ, а @var{new-phase} - выражение, преобразующееся в процедуру.

note: type: Plain text
en: The example below is taken from the definition of the @code{grep} package.  It adds a phase to run after the @code{install} phase, called @code{fix-egrep-and-fgrep}.  That phase is a procedure (@code{lambda*} is for anonymous procedures) that takes a @code{#:outputs} keyword argument and ignores extra keyword arguments (@pxref{Optional Arguments,,, guile, GNU Guile Reference Manual}, for more on @code{lambda*} and optional and keyword arguments.)  The phase uses @code{substitute*} to modify the installed @file{egrep} and @file{fgrep} scripts so that they refer to @code{grep} by its absolute file name:
ru: Пример ниже взят из определения пакета @code{grep}.  Он добавляет фазу для запуска после фазы @code{install}, которая называется @code{fix-egrep-and-fgrep}.  Эта фаза представляет собой процедуру (@code{lambda*} обозначает анонимную процедуру), которая принимает аргумент ключевого слова @code{#:output} и игнорирует дополнительные аргументы ключевого слова (@pxref{Optional Arguments,,, guile, GNU Guile Reference Manual}, for more on @code{lambda*} and optional and keyword arguments.)  В фазе используется @code{substitute*} для изменения установленных сценариев @file{egrep} и @file{fgrep}, чтобы они ссылались на @code{grep} по абсолютному имени файла:

note: type: Plain text
en: In the example below, phases are modified in two ways: the standard @code{configure} phase is deleted, presumably because the package does not have a @file{configure} script or anything similar, and the default @code{install} phase is replaced by one that manually copies the executable files to be installed:
ru: В приведенном ниже примере фазы изменяются двумя способами: стандартная фаза @code{configure} удаляется, предположительно потому, что в пакете нет сценария @file{configure} или чего-то подобного, и фаза @code{install} по умолчанию заменяется файлом, который вручную копирует устанавливаемые исполняемые файлы:

note: type: Plain text
en: Conceptually, the @dfn{store} is the place where derivations that have been built successfully are stored---by default, @file{/gnu/store}.  Sub-directories in the store are referred to as @dfn{store items} or sometimes @dfn{store paths}.  The store has an associated database that contains information such as the store paths referred to by each store path, and the list of @emph{valid} store items---results of successful builds.  This database resides in @file{@var{localstatedir}/guix/db}, where @var{localstatedir} is the state directory specified @i{via} @option{--localstatedir} at configure time, usually @file{/var}.
ru: Концептуально @dfn{store} - это место, где хранятся успешно построенные derivation'ы - по умолчанию @file{/gnu/store}.  Подкаталоги в store называются @dfn{store items} или иногда @dfn{store paths}.  У store есть связанная база данных, которая содержит такую информацию, как store paths, на которые ссылается каждый store path, и список @emph{валидных} store item'ов---результаты успешных сборок.  Эта база данных находится в @file{@var{localstatedir}/guix/db}, где @var{localstatedir} - это каталог состояний, указанный @i{через} @option{--localstatedir} во время configure, обычно @file{/var}.

note: type: Plain text
en: The store is @emph{always} accessed by the daemon on behalf of its clients (@pxref{Invoking guix-daemon}).  To manipulate the store, clients connect to the daemon over a Unix-domain socket, send requests to it, and read the result---these are remote procedure calls, or RPCs.
ru: Демон @emph{всегда} обращается к store от имени своих клиентов (@pxref{Invoking guix-daemon}).  Чтобы управлять store, клиенты подключаются к демону через сокет домена Unix, отправляют ему запросы и читают результат - это вызовы удаленных процедур или RPC.

note: type: quotation
en: Users must @emph{never} modify files under @file{/gnu/store} directly.  This would lead to inconsistencies and break the immutability assumptions of Guix's functional model (@pxref{Introduction}).
ru: Пользователи должны @emph{никогда} напрямую изменять файлы в @file{/gnu/store}.  Это приведет к несоответствиям и нарушит предположения о неизменности функциональной модели Guix (@pxref{Introduction}).

note: type: quotation
en: @xref{Invoking guix gc, @command{guix gc --verify}}, for information on how to check the integrity of the store and attempt recovery from accidental modifications.
ru: @xref{Invoking guix gc, @command{guix gc --verify}}, для получения информации о том, как проверить целостность store и попытаться восстановить его после случайных изменений.

note: type: Plain text
en: The @code{(guix store)} module provides procedures to connect to the daemon, and to perform RPCs.  These are described below.  By default, @code{open-connection}, and thus all the @command{guix} commands, connect to the local daemon or to the URI specified by the @env{GUIX_DAEMON_SOCKET} environment variable.
ru: Модуль @code{(guix store)} предоставляет процедуры для подключения к демону и выполнения RPC.  Они описаны ниже.  По умолчанию @code{open-connection} и, следовательно, все команды @command{guix} подключаются к локальному демону или к URI, указанному в переменной среды @env{GUIX_DAEMON_SOCKET}.

note: type: defvr
en: When set, the value of this variable should be a file name or a URI designating the daemon endpoint.  When it is a file name, it denotes a Unix-domain socket to connect to.  In addition to file names, the supported URI schemes are:
ru: Если установлено, значение этой переменной должно быть именем файла или URI, обозначающим конечную точку демона.  Когда это имя файла, оно обозначает сокет домена Unix, к которому нужно подключиться.  Помимо имен файлов, поддерживаются следующие схемы URI:

note: type: table
en: These are for Unix-domain sockets.  @code{file:///var/guix/daemon-socket/socket} is equivalent to @file{/var/guix/daemon-socket/socket}.
ru: Это для сокетов домена Unix.  @code{file:///var/guix/daemon-socket/socket} эквивалентен @file{/var/guix/daemon-socket/socket}.

note: type: table
en: These URIs denote connections over TCP/IP, without encryption nor authentication of the remote host.  The URI must specify the host name and optionally a port number (by default port 44146 is used):
ru: Эти URI обозначают соединения через TCP/IP без шифрования и аутентификации удаленного хоста.  В URI необходимо указать имя хоста и, возможно, номер порта (по умолчанию используется порт 44146):

note: type: table
en: This setup is suitable on local networks, such as clusters, where only trusted nodes may connect to the build daemon at @code{master.guix.example.org}.
ru: Эта настройка подходит для локальных сетей, таких как кластеры, где только доверенные узлы могут подключаться к демону сборки по адресу @code{master.guix.example.org}.

note: type: table
en: The @option{--listen} option of @command{guix-daemon} can be used to instruct it to listen for TCP connections (@pxref{Invoking guix-daemon, @option{--listen}}).
ru: Параметр @option{--listen} команды @command{guix-daemon} можно использовать для указания ему прослушивать TCP-соединения (@pxref{Invoking guix-daemon, @option{--listen}}).

note: type: cindex
en: SSH access to build daemons
ru: доступ к демонам сборки по ssh

note: type: table
en: These URIs allow you to connect to a remote daemon over SSH@.  This feature requires Guile-SSH (@pxref{Requirements}) and a working @command{guile} binary in @env{PATH} on the destination machine.  It supports public key and GSSAPI authentication.  A typical URL might look like this:
ru: Эти URI позволяют подключаться к удаленному демону через SSH.  Для этой функции требуется Guile-SSH (@pxref{Requirements}) и рабочий @command{guile} binary файл в @env{PATH} на конечном компьютере.  Он поддерживает открытый ключ и аутентификацию GSSAPI.  Типичный URL-адрес может выглядеть так:

note: type: table
en: As for @command{guix copy}, the usual OpenSSH client configuration files are honored (@pxref{Invoking guix copy}).
ru: Что касается @command{guix copy}, учитываются обычные файлы конфигурации клиента OpenSSH (@pxref{Invoking guix copy}).

note: type: defvr
en: Additional URI schemes may be supported in the future.
ru: В будущем могут поддерживаться дополнительные схемы URI.

note: type: quotation
en: The ability to connect to remote build daemons is considered experimental as of @value{VERSION}.  Please get in touch with us to share any problems or suggestions you may have (@pxref{Contributing}).
ru: Возможность подключения к демонам удаленной сборки считается экспериментальной с @value{VERSION}.  Пожалуйста, свяжитесь с нами, чтобы поделиться любыми проблемами или предложениями, которые могут у вас возникнуть (@pxref{Contributing}).

note: type: deffn
en: Connect to the daemon over the Unix-domain socket at @var{uri} (a string).  When @var{reserve-space?} is true, instruct it to reserve a little bit of extra space on the file system so that the garbage collector can still operate should the disk become full.  Return a server object.
ru: Подключится к демону через сокет домена Unix по адресу @var{uri} (строка).  Когда @var{reserve-space?} истинна, указать ему, чтобы он зарезервировал немного дополнительного места в файловой системе, чтобы сборщик мусора мог работать, если диск заполнится.  Вернуть объект сервера.

note: type: deffn
en: @var{file} defaults to @code{%default-socket-path}, which is the normal location given the options that were passed to @command{configure}.
ru: @var{file} по умолчанию - @code{%default-socket-path}, что является обычным расположением с учетом параметров, переданных в @command{configure}.

note: type: deffn
en: Close the connection to @var{server}.
ru: Закрыть соединение с @var{server}.

note: type: defvr
en: This variable is bound to a SRFI-39 parameter, which refers to the port where build and error logs sent by the daemon should be written.
ru: Эта переменная привязана к параметру SRFI-39, который относится к порту, на который должны быть записаны журналы сборки и ошибок, отправляемые демоном.

note: type: Plain text
en: Procedures that make RPCs all take a server object as their first argument.
ru: Процедуры, которые заставляют все RPC принимать объект сервера в качестве своего первого аргумента.

note: type: deffn
en: Return @code{#t} when @var{path} designates a valid store item and @code{#f} otherwise (an invalid item may exist on disk but still be invalid, for instance because it is the result of an aborted or failed build).
ru: Возвращать @code{#t}, когда @var{path} обозначает допустимый элемент хранилища, и @code{#f} в противном случае (недопустимый элемент может существовать на диске, но по-прежнему быть недопустимым, например, потому что он является результатом прерывания или неудачной сборки).

note: type: deffn
en: A @code{&store-protocol-error} condition is raised if @var{path} is not prefixed by the store directory (@file{/gnu/store}).
ru: Условие @code{&store-protocol-error} возникает, если @var{path} не имеет префикса в каталоге store (@file{/gnu/store}).

note: type: deffn
en: Add @var{text} under file @var{name} in the store, and return its store path.  @var{references} is the list of store paths referred to by the resulting store path.
ru: Добавить @var{text} в файл @var{name} в store и вернуть его store path.  @var{references} - это список store path'ы, на которые ссылается конечный store path.

note: type: deffn
en: {Scheme Procedure} build-derivations @var{store} @var{derivations} @
ru: {Scheme Procedure} lookup-inferior-packages @var{inferior} @var{name} @

note: type: deffn
en: [@var{mode}] Build @var{derivations}, a list of @code{<derivation>} objects, @file{.drv} file names, or derivation/output pairs, using the specified @var{mode}---@code{(build-mode normal)} by default.
ru: [@var{mode}] Собрать @var{derivations}, список объектов @code{<derivation>}, имен файлов @file{.drv} или пар derivation/output, используя указанный @var{mode}---@code{(build-mode normal)} по умолчанию.

note: type: Plain text
en: Note that the @code{(guix monads)} module provides a monad as well as monadic versions of the above procedures, with the goal of making it more convenient to work with code that accesses the store (@pxref{The Store Monad}).
ru: Обратите внимание, что модуль @code{(guix monads)} предоставляет как монаду, так и монадические версии вышеупомянутых процедур с целью сделать более удобной работу с кодом, который обращается к store (@pxref{The Store Monad}).

note: type: i{#1}
en: This section is currently incomplete.
ru: Этот раздел в настоящее время не завершен.

note: type: Plain text
en: Low-level build actions and the environment in which they are performed are represented by @dfn{derivations}.  A derivation contains the following pieces of information:
ru: Действия низкоуровневой сборки и среда, в которой они выполняются, представлены через @dfn{derivations}.  Derivation содержит следующую информацию:

note: type: itemize
en: The outputs of the derivation---derivations produce at least one file or directory in the store, but may produce more.
ru: The outputs of the derivation---derivations создают по крайней мере один файл или каталог в store, но могут создавать и больше.

note: type: itemize
en: The inputs of the derivations---i.e., its build-time dependencies---which may be other derivations or plain files in the store (patches, build scripts, etc.).
ru: Входные данные производных---то есть его build-time зависимости - которые могут быть другими derivation'ами или простыми файлами в store (патчи, скрипты сборки и т.д.).

note: type: itemize
en: The system type targeted by the derivation---e.g., @code{x86_64-linux}.
ru: Тип системы, на который нацелена derivation - например, @code{x86_64-linux}.

note: type: itemize
en: The file name of a build script in the store, along with the arguments to be passed.
ru: Имя файла скрипта сборки в store вместе с передаваемыми аргументами.

note: type: itemize
en: A list of environment variables to be defined.
ru: Список переменных среды, которые необходимо определить.

note: type: Plain text
en: Derivations allow clients of the daemon to communicate build actions to the store.  They exist in two forms: as an in-memory representation, both on the client- and daemon-side, and as files in the store whose name end in @file{.drv}---these files are referred to as @dfn{derivation paths}.  Derivations paths can be passed to the @code{build-derivations} procedure to perform the build actions they prescribe (@pxref{The Store}).
ru: Derivation'ы позволяют клиентам демона передавать действия сборки в store.  Они существуют в двух формах: как представление в памяти, как на стороне клиента, так и на стороне демона, и в виде файлов в хранилище, имена которых заканчиваются на @file{.drv} - эти файлы называются @dfn{derivation paths}.  Derivation paths могут быть переданы в процедуру @code{build-derivations} для выполнения действий сборки, которые они предписывают (@pxref{The Store}).

note: type: Plain text
en: Operations such as file downloads and version-control checkouts for which the expected content hash is known in advance are modeled as @dfn{fixed-output derivations}.  Unlike regular derivations, the outputs of a fixed-output derivation are independent of its inputs---e.g., a source code download produces the same result regardless of the download method and tools being used.
ru: Такие операции, как загрузка файлов и проверка версий, для которых заранее известен ожидаемый хэш содержимого, моделируются как @dfn{fixed-output derivations}.  В отличие от обычных дериваций, выходные данные деривации с фиксированным выходом не зависят от его входных данных - например, загрузка исходного кода дает тот же результат независимо от метода загрузки и используемых инструментов.

note: type: Plain text
en: The outputs of derivations---i.e., the build results---have a set of @dfn{references}, as reported by the @code{references} RPC or the @command{guix gc --references} command (@pxref{Invoking 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.
ru: Outputs of derivations---то есть результаты сборки---имеют множество @dfn{references}, в соответствии с указаниями RPC @code{references} или команды @command{guix gc --references} (@pxref{Invoking guix gc}).  References - это набор run-time зависимостей результатов сборки.  References - это подмножество входных данных derivation; это подмножество автоматически вычисляется демоном сборки путем сканирования всех файлов в выходных данных.

note: type: Plain text
en: The @code{(guix derivations)} module provides a representation of derivations as Scheme objects, along with procedures to create and otherwise manipulate derivations.  The lowest-level primitive to create a derivation is the @code{derivation} procedure:
ru: Модуль @code{(guix diverations)} предоставляет представление derivation'ов в виде Scheme объектов, а также процедуры для создания derivation'ов и других манипуляций с ними.  Самым низкоуровневым примитивом для создания derivation'а является процедура @code{derivation}:

note: type: deffn
en: @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 '()] Build a derivation with the given arguments, and return the resulting @code{<derivation>} object.
ru: @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 '()] Собрать производную с заданными аргументами и вернуть полученный объект @code{<derivation>}.

note: type: deffn
en: When @var{hash} and @var{hash-algo} are given, a @dfn{fixed-output derivation} is created---i.e., one whose result is known in advance, such as a file download.  If, in addition, @var{recursive?} is true, then that fixed output may be an executable file or a directory and @var{hash} must be the hash of an archive containing this output.
ru: Когда заданы @var{hash} и @var{hash-algo}, создается @dfn{fixed-output derivation} - то есть результат, который известен заранее, например, загрузка файла.  Кроме того, если @var{recursive?} истинна, то этот фиксированный вывод может быть исполняемым файлом или каталогом, а @var{hash} должен быть хешем архива, содержащего этот вывод.

note: type: deffn
en: When @var{references-graphs} is true, it must be a list of file name/store path pairs.  In that case, the reference graph of each store path is exported in the build environment in the corresponding file, in a simple text format.
ru: Когда @var{links-graphs} истинна, данная переменная должна быть списком из пар имя файла и путь к store.  В этом случае граф ссылок каждого store path экспортируется в среду сборки в соответствующий файл в простом текстовом формате.

note: type: deffn
en: When @var{allowed-references} is true, it must be a list of store items or outputs that the derivation's output may refer to.  Likewise, @var{disallowed-references}, if true, must be a list of things the outputs may @emph{not} refer to.
ru: Когда @var{allowed-links} истинна, данная переменная должна быть списком store item'ов или выходных данных, на которые может ссылаться выход derivation'а.  Аналогично, @var{disallowed-links}, если она истинна, данная переменная должна быть списком сущностей, на которые @emph{не} могут ссылаться выходные данные.

note: type: deffn
en: When @var{leaked-env-vars} is true, it must be a list of strings denoting environment variables that are allowed to ``leak'' from the daemon's environment to the build environment.  This is only applicable to fixed-output derivations---i.e., when @var{hash} is true.  The main use is to allow variables such as @code{http_proxy} to be passed to derivations that download files.
ru: Когда @var{leaked-env-vars} истинна, данная переменная должна быть списком строк, обозначающих переменные среды, которым разрешено ``просачиваться'' из среды демона в среду сборки.  Это применимо только к fixed-output derivation'ам, т.е. когда @var{hash} истинна.  Основное использование - разрешить передачу таких переменных, как @code{http_proxy}, derivation'ам, которые загружают файлы.

note: type: deffn
en: When @var{local-build?} is true, declare that the derivation is not a good candidate for offloading and should rather be built locally (@pxref{Daemon Offload Setup}).  This is the case for small derivations where the costs of data transfers would outweigh the benefits.
ru: Когда @var{local-build?} истинна, объявить, что производная не является хорошим кандидатом для offload и должна быть собрана локально (@pxref{Daemon Offload Setup}).  Это справедливо для небольших derivation'ов, когда затраты на передачу данных перевешивают выгоды.

note: type: deffn
en: When @var{substitutable?} is false, declare that substitutes of the derivation's output should not be used (@pxref{Substitutes}).  This is useful, for instance, when building packages that capture details of the host CPU instruction set.
ru: Когда @var{substitutable?} ложно, объявить, что substitutes derivation'ов не должны использоваться (@pxref{Substitutes}).  Это полезно, например, при создании пакетов, которые фиксируют подробности набора команд центрального процессора.

note: type: deffn
en: @var{properties} must be an association list describing ``properties'' of the derivation.  It is kept as-is, uninterpreted, in the derivation.
ru: @var{properties} должна быть списком ассоциаций, описывающих ``свойства'' derivation'а.  При выводе они сохраняются как есть, без интерпретации.

note: type: Plain text
en: Here's an example with a shell script as its builder, assuming @var{store} is an open connection to the daemon, and @var{bash} points to a Bash executable in the store:
ru: Вот пример со shell скриптом в качестве его builder'а, предполагая, что @var{store} является открытым соединением с демоном, а @var{bash} указывает на исполняемый файл Bash в store:

note: type: Plain text
en: As can be guessed, this primitive is cumbersome to use directly.  A better approach is to write build scripts in Scheme, of course! The best course of action for that is to write the build code as a ``G-expression'', and to pass it to @code{gexp->derivation}.  For more information, @pxref{G-Expressions}.
ru: Как можно догадаться, этот примитив неудобно использовать напрямую.  Конечно, лучший подход - писать скрипты сборки на Scheme!  Лучше всего для этого написать код сборки как ``G-выражение'' и передать его в @code{gexp->derivation}.  Для получения дополнительной информации, @pxref{G-Expressions}.

note: type: Plain text
en: Once upon a time, @code{gexp->derivation} did not exist and constructing derivations with build code written in Scheme was achieved with @code{build-expression->derivation}, documented below.  This procedure is now deprecated in favor of the much nicer @code{gexp->derivation}.
ru: Когда-то давно @code{gexp->derivation} не существовала, и построение derivation'ов с помощью кода сборки, написанного на Scheme, достигалось с помощью @code{build-expression->derivation}, описанной ниже.  Эта процедура теперь устарела и заменена более приятным @code{gexp->derivation}.

note: type: deffn
en: @var{name} @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] Return a derivation that executes Scheme expression @var{exp} as a builder for derivation @var{name}.  @var{inputs} must be a list of @code{(name drv-path sub-drv)} tuples; when @var{sub-drv} is omitted, @code{"out"} is assumed.  @var{modules} is a list of names of Guile modules from the current search path to be copied in the store, compiled, and made available in the load path during the execution of @var{exp}---e.g., @code{((guix build utils) (guix build gnu-build-system))}.
ru: @var{name} @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] Возвращает derivation, которая исполняет Scheme выражение @var{exp} как builder для derivation'а @var{name}.  @var{inputs} должна быть списком кортежей @code{(name drv-path sub-drv)}; когда @var{sub-drv} опущена, предполагается @code{"out"}.  @var{modules} - это список имен модулей Guile из текущего пути поиска, которые будут скопированы в store, скомпилированы и станут доступными в пути загрузки во время выполнения @var{exp}---например, @code{((guix build utils) (guix build gnu-build-system))}.

note: type: deffn
en: @var{exp} is evaluated in an environment where @code{%outputs} is bound to a list of output/path pairs, and where @code{%build-inputs} is bound to a list of string/output-path pairs made from @var{inputs}.  Optionally, @var{env-vars} is a list of string pairs specifying the name and value of environment variables visible to the builder.  The builder terminates by passing the result of @var{exp} to @code{exit}; thus, when @var{exp} returns @code{#f}, the build is considered to have failed.
ru: @var{exp} выполняется в среде, где @code{%output} привязан к списку пар output/path, а где @code{%build-inputs} привязан к списку пар строка/output-path сделаными из @var{input}.  Необязательно, @var{env-vars} - это список пар строк, определяющих имя и значение переменных среды, видимых builder'у.  Builder завершает работу, передавая результат @var{exp} в @code{exit}; таким образом, когда @var{exp} возвращает @code{#f}, сборка считается неудачной.

note: type: deffn
en: @var{exp} is built using @var{guile-for-build} (a derivation).  When @var{guile-for-build} is omitted or is @code{#f}, the value of the @code{%guile-for-build} fluid is used instead.
ru: @var{exp} собирается с использованием @var{guile-for-build} (derivation). Когда @var{guile-for-build} опущена или равна @code{#f}, вместо этого используется значение fluid'а @code{%guile-for-build}.

note: type: deffn
en: See the @code{derivation} procedure for the meaning of @var{references-graphs}, @var{allowed-references}, @var{disallowed-references}, @var{local-build?}, and @var{substitutable?}.
ru: См. в процедуре @code{derivation} значение @var{references-graphs}, @var{allowed-references}, @var{disallowed-references}, @var{local-build?} и @var{substitutable?}.

note: type: Plain text
en: Here's an example of a single-output derivation that creates a directory containing one file:
ru: Вот пример single-output derivation'а, которая создает каталог, содержащий один файл:

note: type: Plain text
en: The procedures that operate on the store described in the previous sections all take an open connection to the build daemon as their first argument.  Although the underlying model is functional, they either have side effects or depend on the current state of the store.
ru: Все процедуры, которые работают с store, описанные в предыдущих разделах, принимают открытое соединение с демоном сборки в качестве первого аргумента.  Хотя основная модель является функциональной, они либо имеют побочные эффекты, либо зависят от текущего состояния store.

note: type: Plain text
en: The former is inconvenient: the connection to the build daemon has to be carried around in all those functions, making it impossible to compose functions that do not take that parameter with functions that do.  The latter can be problematic: since store operations have side effects and/or depend on external state, they have to be properly sequenced.
ru: Первое неудобно: соединение с демоном сборки должно поддерживаться во всех этих функциях, что делает невозможным составление функций, которые не принимают этот параметр, с функциями, которые его принимают.  Последнее может быть проблематичным: поскольку операции store имеют побочные эффекты и/или зависят от внешнего состояния, они должны быть правильно упорядочены.

note: type: cindex
en: monadic values
ru: монадические значения

note: type: cindex
en: monadic functions
ru: монадические функции

note: type: Plain text
en: This is where the @code{(guix monads)} module comes in.  This module provides a framework for working with @dfn{monads}, and a particularly useful monad for our uses, the @dfn{store monad}.  Monads are a construct that allows two things: associating ``context'' with values (in our case, the context is the store), and building sequences of computations (here computations include accesses to the store).  Values in a monad---values that carry this additional context---are called @dfn{monadic values}; procedures that return such values are called @dfn{monadic procedures}.
ru: Здесь на помощь приходит модуль @code{(guix monads)}.  Этот модуль предоставляет основу для работы с @dfn{monads} и особенно полезную монаду для наших целей - @dfn{store monad}.  Монады - это конструкции, которая позволяют две вещи: связывать ``контекст'' со значениями (в нашем случае контекст - это store) и строить последовательности вычислений (здесь вычисления включают доступ к store).  Значения в монаде---значения, которые несут этот дополнительный контекст---называются @dfn{монадическими значениями}; процедуры, возвращающие такие значения, называются @dfn{монадическими процедурами}.

note: type: Plain text
en: Consider this ``normal'' procedure:
ru: Рассмотрим эту ``нормальную'' процедуру:

note: type: Plain text
en: Using @code{(guix monads)} and @code{(guix gexp)}, it may be rewritten as a monadic function:
ru: Используя @code{(guix monads)} и @code{(guix gexp)}, ее можно переписать как монадическую функцию:

note: type: Plain text
en: There are several things to note in the second version: the @code{store} parameter is now implicit and is ``threaded'' in the calls to the @code{package->derivation} and @code{gexp->derivation} monadic procedures, and the monadic value returned by @code{package->derivation} is @dfn{bound} using @code{mlet} instead of plain @code{let}.
ru: Во второй версии следует отметить несколько моментов: параметр @code{store} теперь является неявным и является ``threaded'' в вызовах @code{package->derivation} и @code{gexp->derivation} монадические процедуры, а монадическим значением, возвращаемым @code{package->derivation}, является @dfn{bound} с использованием @code{mlet} вместо простого @code{let}.

note: type: Plain text
en: As it turns out, the call to @code{package->derivation} can even be omitted since it will take place implicitly, as we will see later (@pxref{G-Expressions}):
ru: Оказывается, вызов @code{package->derivation} можно даже опустить, поскольку она будет выполняться неявно, как мы увидим позже (@pxref{G-Expressions}):

note: type: Plain text
en: Calling the monadic @code{sh-symlink} has no effect.  As someone once said, ``you exit a monad like you exit a building on fire: by running''.  So, to exit the monad and get the desired effect, one must use @code{run-with-store}:
ru: Вызов монадического @code{sh-symlink} ни на что не влияет.  Как кто-то однажды сказал: ``Вы выходите из монады, как вы выходите из горящего здания: by running''.  Итак, чтобы выйти из монады и получить желаемый эффект, нужно использовать @code{run-with-store}:

note: type: Plain text
en: The latter enters a recursive REPL, where all the return values are automatically run through the store:
ru: Последний входит в рекурсивный REPL, где все возвращаемые значения автоматически проходят через хранилище:

note: type: Plain text
en: Note that non-monadic values cannot be returned in the @code{store-monad} REPL.
ru: Обратите внимание, что немонадические значения не могут быть возвращены в REPL @code{store-monad}.

note: type: Plain text
en: The main syntactic forms to deal with monads in general are provided by the @code{(guix monads)} module and are described below.
ru: Основные синтаксические формы для работы с монадами в целом предоставляются модулем @code{(guix monads)} и описаны ниже.

note: type: deffn
en: Return a monadic value that encapsulates @var{val}.
ru: Возвращает монадическое значение, инкапсулирующее @var{val}.

note: type: deffn
en: Return the current state as a monadic value.
ru: Вернуть текущее состояние в виде монадического значения.

note: type: cindex
en: cross compilation
ru: кросс-компиляция

note: type: cindex
en: imported modules, for gexps
ru: импортированные модули, для gexps

note: type: deffn
en: [#:splice? #f] [#:set-load-path? #t] Return an object representing the Scheme file @var{name} that contains @var{exp}.
ru: [#:splice? #f] [#:set-load-path? #t] Возвращает объект, представляющий Scheme файл file @var{name} содержащий @var{exp}.

note: type: deffn
en: This is the declarative counterpart of @code{text-file*}.
ru: Это декларативный аналог @code{text-file*}.

note: type: lisp
en: (file-union "etc"
                `(("hosts" ,(plain-file "hosts"
                                        "127.0.0.1 localhost"))
                  ("bashrc" ,(plain-file "bashrc"
                                         "alias ls='ls --color=auto'"))))
ru: (file-union "etc"
                `(("hosts" ,(plain-file "hosts"
                                        "127.0.0.1 localhost"))
                  (\"bashrc\" ,(plain-file "bashrc"
                                         "alias ls='ls --color=auto'"))))

note: type: deffn
en: As an example, consider this gexp:
ru: В качестве примера рассмотрим этот gexp:

note: type: deffn
en: The same effect could be achieved with:
ru: Такого же эффекта можно добиться с помощью:

note: type: deffn
en: Bind @var{system} to the currently targeted system---e.g., @code{"x86_64-linux"}---within @var{body}.
ru: Привязать @var{system} к текущей целевой системе---например, @code{\"x86_64-linux\"}---в @var{body}.

note: type: section
en: Invoking @command{guix repl}
ru: Вызов @command{guix repl}

note: type: cindex
en: REPL, read-eval-print loop, script
ru: цикл чтение-вычисление-вывод

note: type: item
en: machine
ru: компьютер

note: type: Plain text
en: This section describes Guix command-line utilities.  Some of them are primarily targeted at developers and users who write new package definitions, while others are more generally useful.  They complement the Scheme programming interface of Guix in a convenient way.
ru: В этом разделе описаны утилиты командной строки Guix. Некоторые из них в первую очередь нацелены на разработчиков и пользователей, которые пишут новые определения пакетов, в то время как другие полезны в целом. Они удобно дополняют программный интерфейс Scheme в Guix.

note: type: cindex
en: package building
ru: сборка пакета

note: type: Plain text
en: The @command{guix build} command builds packages or derivations and their dependencies, and prints the resulting store paths.  Note that it does not modify the user's profile---this is the job of the @command{guix package} command (@pxref{Invoking guix package}).  Thus, it is mainly useful for distribution developers.
ru: Команда @command{guix build} собирает пакеты или производные и их зависимости и выводит полученные пути в хранилище (store paths). Обратите внимание, что она не изменяет профиль пользователя---это задача команды @command{guix package} (@pxref{Invoking guix package}). Таким образом, это в основном полезно для разработчиков дистрибутива.

note: type: Plain text
en: As an example, the following command builds the latest versions of Emacs and of Guile, displays their build logs, and finally displays the resulting directories:
ru: В качестве примера следующая команда собирает последние версии Emacs и Guile, отображает их логи и, наконец, отображает полученные директории:

note: type: Plain text
en: Similarly, the following command builds all the available packages:
ru: Аналогичным образом следующая команда собирает все доступные пакеты:

note: type: Plain text
en: @var{package-or-derivation} may be either the name of a package found in the software distribution such as @code{coreutils} or @code{coreutils@@8.20}, or a derivation such as @file{/gnu/store/@dots{}-coreutils-8.19.drv}.  In the former case, a package with the corresponding name (and optionally version) is searched for among the GNU distribution modules (@pxref{Package Modules}).
ru: @var{package-or-derivation} может быть именем пакета, найденного в дистрибутиве программного обеспечения, например @code{coreutils} или @code{coreutils@@8.20}, или производным, например @file{/gnu/store/@dots{}-coreutils-8.19.drv}. В первом случае пакет с соответствующим именем (и, возможно, версией) ищется среди модулей дистрибутива GNU (@pxref{Package Modules}).

note: type: Plain text
en: Alternatively, the @option{--expression} option may be used to specify a Scheme expression that evaluates to a package; this is useful when disambiguating among several same-named packages or package variants is needed.
ru: В качестве альтернативы можно использовать параметр @option{--expression}, чтобы указать выражение на языке Scheme, оценивающее пакет; это полезно, когда требуется устранение неоднозначности между несколькими пакетами с одинаковыми именами или вариантами пакетов.

note: type: Plain text
en: There may be zero or more @var{options}.  The available options are described in the subsections below.
ru: Может быть ноль или больше @var{options}. Доступные параметры описаны в подразделах ниже.

note: type: Plain text
en: A number of options that control the build process are common to @command{guix build} and other commands that can spawn builds, such as @command{guix package} or @command{guix archive}.  These are the following:
ru: Ряд параметров, управляющих процессом сборки, является общим для @command{guix build} и других команд, которые могут порождать сборки, например @command{guix package} или @command{guix archive}. Это следующие:

note: type: table
en: This allows users to define their own packages and make them visible to the command-line tools.
ru: Это позволяет пользователям определять свои собственные пакеты и делать их видимыми для инструментов командной строки.

note: type: table
en: Keep the build tree of failed builds.  Thus, if a build fails, its build tree is kept under @file{/tmp}, in a directory whose name is shown at the end of the build log.  This is useful when debugging build issues.  @xref{Debugging Build Failures}, for tips and tricks on how to debug build issues.
ru: Сохраните дерево сборки неудачных попыток сборки. Таким образом, в случае сбоя сборки ее дерево сборки сохраняется в @file{/tmp}, в каталоге, имя которого отображается в конце журнала сборки. Это полезно при отладке проблем сборки. @xref{Debugging Build Failures}, советы и рекомендации по отладке проблем сборки.

note: type: table
en: This option implies @option{--no-offload}, and it has no effect when connecting to a remote daemon with a @code{guix://} URI (@pxref{The Store, the @env{GUIX_DAEMON_SOCKET} variable}).
ru: Этот параметр предполагает @option{--no-offload} и не действует при подключении к удалённому демону с URI @code{guix://} (@pxref{The Store, the @env{GUIX_DAEMON_SOCKET}}.

note: type: table
en: Keep going when some of the derivations fail to build; return only once all the builds have either completed or failed.
ru: Продолжайте, когда некоторые из производных не удается построить; возвращайтесь только после того, как все сборки будут завершены или не пройдены.

note: type: table
en: The default behavior is to stop as soon as one of the specified derivations has failed.
ru: Поведение по умолчанию---остановка, как только одна из указанных производных не удалась.

note: type: table
en: Do not build the derivations.
ru: Не собирайте производные.

note: type: table
en: When substituting a pre-built binary fails, fall back to building packages locally (@pxref{Substitution Failure}).
ru: Если замена предварительно созданного двоичного файла не удалась, процесс возвращается к сборке пакетов локально (@pxref{Substitution Failure}).

note: type: table
en: Consider @var{urls} the whitespace-separated list of substitute source URLs, overriding the default list of URLs of @command{guix-daemon} (@pxref{daemon-substitute-urls,, @command{guix-daemon} URLs}).
ru: Рассмотрим @var{urls} разделенный пробелами список URL-адресов источников замещений, заменяющий список URL-адресов по умолчанию @command{guix-daemon} (@pxref{daemon-substitute-urls,, @command{guix-daemon} URLs}).

note: type: table
en: This means that substitutes may be downloaded from @var{urls}, provided they are signed by a key authorized by the system administrator (@pxref{Substitutes}).
ru: Это означает, что заменители могут быть загружены с @var{urls}, при условии, что они подписаны ключом, авторизованным системным администратором (@pxref{Substitutes}).

note: type: table
en: When @var{urls} is the empty string, substitutes are effectively disabled.
ru: Когда @var{urls} является пустой строкой---замены фактически отключены.

note: type: table
en: Do not ``graft'' packages.  In practice, this means that package updates available as grafts are not applied.  @xref{Security Updates}, for more information on grafts.
ru: Не ``прививайте'' (graft) пакеты. На практике это означает, что обновления пакетов, доступные в виде прививок, не применяются. Ознакомьтесь с @xref{Security Updates}, чтобы узнать больше о прививках (grafts).

note: type: table
en: Build each derivation @var{n} times in a row, and raise an error if consecutive build results are not bit-for-bit identical.
ru: Соберите каждое производное @var{n} раз подряд и вызовите появление ошибки, если последовательные результаты построения не будут побитно идентичны.

note: type: table
en: This is a useful way to detect non-deterministic builds processes.  Non-deterministic build processes are a problem because they make it practically impossible for users to @emph{verify} whether third-party binaries are genuine.  @xref{Invoking guix challenge}, for more.
ru: Это полезный способ обнаружения недетерминированных процессов сборки. Недетерминированные процессы сборки представляют собой проблему, потому что они делают практически невозможным для пользователей @emph{verify} подлинность сторонних двоичных файлов. Обратитесь к @xref{Invoking guix challenge}, чтобы узнать больше.

note: type: table
en: By default, the daemon's setting is honored (@pxref{Invoking guix-daemon, @option{--max-silent-time}}).
ru: По умолчанию настройки демона соблюдаются (@pxref{Invoking guix-daemon, @option{--max-silent-time}}).

note: type: table
en: By default, the daemon's setting is honored (@pxref{Invoking guix-daemon, @option{--timeout}}).
ru: Это ничего не выводит, если демон не был запущен с опцией @option{--cache-failures} (@pxref{Invoking guix-daemon, @option{--cache-failures}}).

note: type: cindex
en: verbosity, of the command-line tools
ru: многословие инструментов командной строки

note: type: cindex
en: build logs, verbosity
ru: журналы сборки, многословие

note: type: table
en: Use the given verbosity @var{level}, an integer.  Choosing 0 means that no output is produced, 1 is for quiet output; 2 is similar to 1 but it additionally displays download URLs; 3 shows all the build log output on standard error.
ru: Используйте заданную степень многословия @var{level} (целое число). Выбор 0 означает, что вывод не производится, 1 - для тихого вывода, а 2 показывает весь вывод журнала сборки при стандартной ошибке.

note: type: table
en: Allow the use of up to @var{n} CPU cores for the build.  The special value @code{0} means to use as many CPU cores as available.
ru: Разрешить использование до @var{n} ядер ЦП для сборки. Специальное значение @code{0} означает использование максимально доступного количества ядер ЦП.

note: type: table
en: Allow at most @var{n} build jobs in parallel.  @xref{Invoking guix-daemon, @option{--max-jobs}}, for details about this option and the equivalent @command{guix-daemon} option.
ru: Разрешить не более @var{n} сборок параллельно. Обратитесь к @xref{Invoking guix-daemon, @option{--max-jobs}} для получения подробной информации об этой опции и аналогичной опции @command{guix-daemon}.

note: type: table
en: 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.
ru: Создавать отладочные данные, поступающие от демона сборки. @var{level} должен быть целым числом от 0 до 5; чем выше, тем подробнее вывод. Уровнь 4 или выше может быть полезен при отладке проблемы с установкой демона сборки.

note: type: Plain text
en: Behind the scenes, @command{guix build} is essentially an interface to the @code{package-derivation} procedure of the @code{(guix packages)} module, and to the @code{build-derivations} procedure of the @code{(guix derivations)} module.
ru: За кулисами @command{guix build}, по сути, является интерфейсом к процедуре @code{package-diveration} модуля @code{(guix packages)} и к процедуре @code{build-diverations} модуля @code{(guix derivations)} модуль.

note: type: Plain text
en: In addition to options explicitly passed on the command line, @command{guix build} and other @command{guix} commands that support building honor the @env{GUIX_BUILD_OPTIONS} environment variable.
ru: Помимо параметров, явно переданных в командной строке, @command{guix build} и другие команды @command{guix}, поддерживающие сборку, учитывают переменную среды @env{GUIX_BUILD_OPTIONS}.

note: type: defvr
en: Users can define this variable to a list of command line options that will automatically be used by @command{guix build} and other @command{guix} commands that can perform builds, as in the example below:
ru: Пользователи могут определить эту переменную для списка параметров командной строки, которые будут автоматически использоваться @command{guix build} и другими командами @command{guix}, которые могут выполнять сборки, как в примере ниже:

note: type: defvr
en: These options are parsed independently, and the result is appended to the parsed command-line options.
ru: Эти параметры анализируются независимо, а результат добавляется к проанализированным параметрам командной строки.

note: type: cindex
en: package variants
ru: варианты пакета

note: type: Plain text
en: Another set of command-line options supported by @command{guix build} and also @command{guix package} are @dfn{package transformation options}.  These are options that make it possible to define @dfn{package variants}---for instance, packages built from different source code.  This is a convenient way to create customized packages on the fly without having to type in the definitions of package variants (@pxref{Defining Packages}).
ru: Другой набор параметров командной строки, поддерживаемых @command{guix build} и @command{guix package} это @dfn{package transformation options}. Это параметры, которые позволяют определять @dfn{package variants}---например, пакеты, созданные из другого исходного кода. Это удобный способ создавать индивидуальные пакеты на лету без необходимости вводить определения вариантов пакета (@pxref{Defining Packages}).

note: type: Plain text
en: Package transformation options are preserved across upgrades: @command{guix upgrade} attempts to apply transformation options initially used when creating the profile to the upgraded packages.
ru: Параметры преобразования пакета сохраняются при обновлении: @command{guix upgrade} пытается применить параметры преобразования, которые изначально использовались при создании профиля, к обновленным пакетам.

note: type: Plain text
en: The available options are listed below.  Most commands support them and also support a @option{--help-transform} option that lists all the available options and a synopsis (these options are not shown in the @option{--help} output for brevity).
ru: Доступные варианты перечислены ниже. Большинство команд поддерживают их, а также поддерживают параметр @option{--help-transform}, в котором перечислены все доступные параметры и их крткое описание (эти параметры не показаны в выводе @option{--help} для краткости).

note: type: table
en: Use @var{source} as the source of @var{package}, and @var{version} as its version number.  @var{source} must be a file name or a URL, as for @command{guix download} (@pxref{Invoking guix download}).
ru: Используйте @var{source} в качестве источника @var{package} и @var{version} в качестве номера версии. @var{source} должен быть именем файла или URL-адресом, как для @command{guix download} (@pxref{Invoking guix download}).

note: type: cindex
en: debugging info, rebuilding
ru: отладка файлов

note: type: item
en: --with-debug-info=@var{package}
ru: --without-tests=@var{package}

note: type: item
en: --with-c-toolchain=@var{package}=@var{toolchain}
ru: --with-commit=@var{package}=@var{commit}

note: type: cindex
en: latest commit, building
ru: последний коммит, сборка

note: type: cindex
en: continuous integration
ru: непрерывная интеграция

note: type: item
en: --with-patch=@var{package}=@var{file}
ru: --with-branch=@var{package}=@var{branch}

note: type: cindex
en: upstream, latest version
ru: версия пакета

note: type: item
en: --with-latest=@var{package}
ru: --without-tests=@var{package}

note: type: example
en: guix build guix --with-latest=guile-json
ru: guix build --with-input=guile=guile@@2.0 guix

note: type: cindex
en: test suite, skipping
ru: набор тестов

note: type: Plain text
en: The command-line options presented below are specific to @command{guix build}.
ru: Параметры командной строки, представленные ниже, относятся к @command{guix build}.

note: type: item
en: --manifest=@var{manifest}
ru: --manifest=@var{file}

note: type: itemx
en: -m @var{manifest}
ru: -m @var{file}

note: type: section
en: Invoking @command{guix edit}
ru: Вызов @command{guix edit}

note: type: section
en: Invoking @command{guix download}
ru: Вызов @command{guix download}

note: type: item
en: --hash=@var{algorithm}
ru: --show=@var{package}

note: type: itemx
en: -H @var{algorithm}
ru: -f @var{format}

note: type: section
en: Invoking @command{guix hash}
ru: Вызов @command{guix hash}

note: type: cindex
en: Invoking @command{guix import}
ru: Вызов @command{guix import}

note: type: Plain text
en: Currently, the available ``importers'' are:
ru: Возможные форматы:

note: type: Plain text
en: Additional options include:
ru: Дополительные опции включаю:

note: type: item
en: --pin-versions
ru: версия

note: type: section
en: Invoking @command{guix refresh}
ru: Вызов @command{guix refresh}

note: type: example
en: $ guix refresh --recursive coreutils
    gnu/packages/acl.scm:40:13: acl would be upgraded from 2.2.53 to 2.3.1
    gnu/packages/m4.scm:30:12: 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: 6.1.2 is already the latest version of gmp
    @dots{}
ru: $ 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
    @dots{}

note: type: Plain text
en: The following options are supported:
ru: Поддерживаются следующие варианты:

note: type: table
en: the updater for GNU packages;
ru: средство обновления пакетов GNU;

note: type: item
en: sourceforge
ru: источник

note: type: table
en: the updater for packages hosted at @uref{https://sourceforge.net, SourceForge};
ru: средство обновления пакетов, размещенных на kernel.org;

note: type: table
en: the updater for GNOME packages;
ru: средство обновления пакетов GNOME;

note: type: table
en: the updater for KDE packages;
ru: средство обновления пакетов KDE;

note: type: table
en: the updater for X.org packages;
ru: средство обновления пакетов X.org;

note: type: table
en: the updater for packages hosted on kernel.org;
ru: средство обновления пакетов, размещенных на kernel.org;

note: type: table
en: the updater for @uref{https://github.com, GitHub} packages.
ru: средство обновления пакетов @uref{https://github.com, GitHub}.

note: type: item
en: always
ru: всегда

note: type: item
en: never
ru: никогда

note: type: Plain text
en: The available options are listed below.
ru: Доступные опции резюмированы ниже.

note: type: section
en: Invoking @command{guix lint}
ru: Вызов @command{guix lint}

note: type: table
en: Check that the derivation of the given packages can be successfully computed for all the supported systems (@pxref{Derivations}).
ru: Вернуть деривацию(-ии), производящие данные элементы склада (@pxref{Derivations}).

note: type: item
en: profile-collisions
ru: противоречеия профиля

note: type: item
en: archival
ru: архивирование

note: type: item
en: --no-network
ru: --network

note: type: section
en: Invoking @command{guix size}
ru: Вызов @command{guix size}

note: type: Plain text
en: The available options are:
ru: Доступные опции:

note: type: section
en: Invoking @command{guix graph}
ru: Вызов @command{guix graph}

note: type: Plain text
en: The output looks like this:
ru: Вывод должен быть таким:

note: type: Plain text
en: Nice little graph, no?
ru: Неплохой граф, не так ли?

note: type: example
en: guix graph -t derivation $(guix system build -d my-config.scm)
ru: guix graph -t derivation `guix system build -d my-config.scm`

note: type: item
en: module
ru: модуль

note: type: example
en: guix graph -t references $(readlink -f ~/.guix-profile)
ru: guix graph -t references `readlink -f ~/.guix-profile`

note: type: cindex
en: shortest path, between packages
ru: кратчайший путь между пакетами

note: type: item
en: --path
ru: --paths

note: type: table
en: Display the graph for @var{system}---e.g., @code{i686-linux}.
ru: Вывести граф для @var{system}---например, @code{i686-linux}.

note: type: section
en: Invoking @command{guix publish}
ru: Вызов @command{guix publish}

note: type: item
en: --compression[=@var{method}[:@var{level}]]
ru: --log-compression=@var{type}

note: type: item
en: --negative-ttl=@var{ttl}
ru: --manifest=@var{file}

note: type: item
en: --cache-bypass-threshold=@var{size}
ru: --search-paths[=@var{kind}]

note: type: section
en: Invoking @command{guix challenge}
ru: Вызов @command{guix challenge}

note: type: item
en: --diff=@var{mode}
ru: --load=@var{file}

note: type: item
en: @code{simple} (the default)
ru: @code{speed} (default: @code{1.0})

note: type: table
en: Show the list of files that differ.
ru: Вывести список живых файлов и директорий склада.

note: type: section
en: Invoking @command{guix copy}
ru: Вызов @command{guix copy}

note: type: example
en: guix copy --to=@var{user}@@@var{host} \
              coreutils $(readlink -f ~/.guix-profile)
ru: guix graph -t references `readlink -f ~/.guix-profile`

note: type: section
en: Invoking @command{guix container}
ru: Вызов @command{guix container}

note: type: section
en: Invoking @command{guix weather}
ru: Вызов @command{guix weather}

note: type: example
en: guix weather @var{options}@dots{} [@var{packages}@dots{}]
ru: guix environment @var{options} @var{package}@dots{}

note: type: table
en: This option can be repeated several times, in which case the manifests are concatenated.
ru: Создать окружение для пакетов, содержащихся в объекте манифеста, возвращаемого кодом Scheme в файле @var{file}.

note: type: item
en: --display-missing
ru: --missing

note: type: section
en: Invoking @command{guix processes}
ru: Вызов @command{guix processes}

note: type: Plain text
en: Additional options are listed below.
ru: Доступные опции резюмированы ниже.

note: type: item
en: @code{kernel} (default: @code{linux-libre})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{hurd} (default: @code{#f})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{kernel-loadable-modules} (default: '())
ru: @code{features} (default: @code{'()})

note: type: item
en: @code{kernel-arguments} (default: @code{%default-kernel-arguments})
ru: @code{features} (default: @code{'()})

note: type: item
en: @code{firmware} (default: @code{%base-firmware})
ru: @code{port} (default: @code{22})

note: type: itemx
en: @code{groups} (default: @code{%base-groups})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{issue} (default: @code{%default-issue})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{packages} (default: @code{%base-packages})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{locale-definitions} (default: @code{%default-locale-definitions})
ru: @code{features} (default: @code{'()})

note: type: item
en: @code{name-service-switch} (default: @code{%default-nss})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{services} (default: @code{%base-services})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{setuid-programs} (default: @code{%setuid-programs})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{sudoers-file} (default: @code{%sudoers-specification})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{mount-may-fail?} (default: @code{#f})
ru: @code{speed} (default: @code{1.0})

note: type: deffn
en: {Scheme Procedure} file-system-label @var{str}
ru: {Процедура Scheme} inferior-package? @var{obj}

note: type: deffn
en: {Scheme Procedure} uuid @var{str} [@var{type}]
ru: {Процедура Scheme} lookup-inferior-packages @var{inferior} @var{name} @

note: type: defvr
en: {Scheme Variable} lvm-device-mapping
ru: {Процедура Scheme} sane-service-type

note: type: cindex
en: swap space
ru: место на диске

note: type: deffn
en: {Scheme Procedure} keyboard-layout @var{name} [@var{variant}] @
ru: {Scheme Procedure} directory-union @var{name} @var{things}

note: type: defvr
en: {Scheme Variable} console-font-service-type
ru: {Процедура Scheme} sane-service-type

note: type: item
en: @code{clear-on-logout?} (default: @code{#t})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{font-engine} (default: @code{"pango"})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{font-size} (default: @code{12})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{caches} (default: @code{%nscd-default-caches})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{authorized-keys} (default: @code{%default-authorized-guix-keys})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{substitute-urls} (default: @code{%default-substitute-urls})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{discover?} (default: @code{#f})
ru: @code{features} (default: @code{'()})

note: type: example
en: herd set-http-proxy guix-daemon
ru: herd start ssh-daemon

note: type: deffn
en: {Scheme Procedure} udev-rules-service [@var{name} @var{rules}] @
ru: {Процедура Scheme} lookup-inferior-packages @var{inferior} @var{name} @

note: type: item
en: @code{advertise?} (default: @code{#f})
ru: @code{features} (default: @code{'()})

note: type: item
en: @code{compression} (default: @code{'(("gzip" 3) ("zstd" 3))})
ru: @code{compression-level} (default: @code{3})

note: type: item
en: @code{cache-bypass-threshold} (default: 10 MiB)
ru: @code{port} (default: @code{22})

note: type: cindex
en: nofile
ru: профиль

note: type: cindex
en: open file descriptors
ru: Краткие обзоры и описания

note: type: item
en: @code{requirement} (default: @code{'(user-processes loopback syslogd)}
ru: @code{features} (default: @code{'()})

note: type: item
en: @code{usb-modeswitch} (default: @code{usb-modeswitch})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{usb-modeswitch-data} (default: @code{usb-modeswitch-data})
ru: @code{port} (default: @code{22})

note: type: defvr
en: {Scheme Variable} hostapd-service-type
ru: {Процедура Scheme} sane-service-type

note: type: deftp
en: {Data Type} hostapd-configuration
ru: Конфигурирование системы

note: type: deftp
en: This data type represents the configuration of the hostapd service, with the following fields:
ru: Этот тип данных представляет машины для сборки, на которые демон может разгружать сборки. Важные поля:

note: type: item
en: @code{package} (default: @code{hostapd})
ru: @code{speed} (default: @code{1.0})

note: type: table
en: The hostapd package to use.
ru: Используемый пакет hostapd.

note: type: item
en: @code{interface} (default: @code{"wlan0"})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{broadcast-ssid?} (default: @code{#t})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{channel} (default: @code{1})
ru: @code{speed} (default: @code{1.0})

note: type: table
en: The WiFi channel to use.
ru: Используемый канал Wi-Fi.

note: type: item
en: @code{driver} (default: @code{"nl80211"})
ru: @code{speed} (default: @code{1.0})

note: type: defvr
en: {Scheme Variable} simulated-wifi-service-type
ru: {Процедура Scheme} sane-service-type

note: type: deftp
en: {Data Type} nftables-configuration
ru: {Тип данных} build-machine

note: type: deftp
en: The data type representing the configuration of nftables.
ru: Управление конфигурацией операционной системы.

note: type: item
en: @code{package} (default: @code{nftables})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{ruleset} (default: @code{%default-nftables-ruleset})
ru: @code{features} (default: @code{'()})

note: type: item
en: @code{allow-large-adjustment?} (default: @code{#t})
ru: @code{parallel-builds} (default: @code{1})

note: type: item
en: @code{type} (default: @code{'server})
ru: @code{port} (default: @code{22})

note: type: table
en: The address of the server, as a string.
ru: Порядок следования устройств имеет значение.

note: type: item
en: @code{server} (default: @code{'()})
ru: @code{features} (default: @code{'()})

note: type: item
en: @code{servers} (default: @code{%openntp-servers})
ru: @code{features} (default: @code{'()})

note: type: defvr
en: {Scheme Variable} opendht-service-type
ru: {Scheme Variable} etc-service-type

note: type: deftp
en: {Data Type} opendht-configuration
ru: Конфигурирование системы

note: type: table
en: The @code{opendht} package to use.
ru: Используемый пакет @code{webssh}.

note: type: item
en: @code{control-socket?} (default: @code{#f})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{address} (default: @code{#f})
ru: @code{features} (default: @code{'()})

note: type: item
en: @code{user} (default: @code{"root"})
ru: @code{port} (default: @code{22})

note: type: Plain text
en: The @code{(gnu services syncthing)} module provides the following services:
ru: Модуль @code{(guix inferior)} предоставляет следующие процедуры для работы с ранними версиями:

note: type: deffn
en: {Scheme Variable} syncthing-service-type
ru: {Процедура Scheme} sane-service-type

note: type: lisp
en: (service syncthing-service-type
             (syncthing-configuration (user "alice")))
ru: (service openssh-service-type
             (openssh-configuration))

note: type: deftp
en: {Data Type} syncthing-configuration
ru: Конфигурирование системы

note: type: deftp
en: Data type representing the configuration for @code{syncthing-service-type}.
ru: Управление конфигурацией операционной системы.

note: type: item
en: @code{syncthing} (default: @var{syncthing})
ru: @code{features} (default: @code{'()})

note: type: table
en: @code{syncthing} package to use.
ru: пакет @code{syncthing} для использования.

note: type: item
en: @code{arguments} (default: @var{'()})
ru: @code{arguments} (default: @code{'()})

note: type: table
en: List of command-line arguments passing to @code{syncthing} binary.
ru: Список флагов командной строки, которые следует передать команде @code{patch}.

note: type: item
en: @code{logflags} (default: @var{0})
ru: @code{features} (default: @code{'()})

note: type: item
en: @code{user} (default: @var{#f})
ru: @code{features} (default: @code{'()})

note: type: item
en: @code{group} (default: @var{"users"})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{home} (default: @var{#f})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{openssh} (default @var{openssh})
ru: @code{port} (default: @code{22})

note: type: deffn
en: {Scheme Variable} autossh-service-type
ru: {Процедура Scheme} sane-service-type

note: type: deftp
en: {Data Type} autossh-configuration
ru: {Тип данных} build-machine

note: type: deftp
en: This data type represents the configuration of an AutoSSH service.
ru: Управление конфигурацией операционной системы.

note: type: item
en: @code{user} (default @code{"autossh"})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{poll} (default @code{600})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{first-poll} (default @code{#f})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{gate-time} (default @code{30})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{log-level} (default @code{1})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{max-start} (default @code{#f})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{message} (default @code{""})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{port} (default @code{"0"})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{ssh-options} (default @code{'()})
ru: @code{features} (default: @code{'()})

note: type: deffn
en: {Scheme Variable} webssh-service-type
ru: {Процедура Scheme} sane-service-type

note: type: deftp
en: {Data Type} webssh-configuration
ru: Конфигурирование системы

note: type: deftp
en: Data type representing the configuration for @code{webssh-service}.
ru: Управление конфигурацией операционной системы.

note: type: item
en: @code{package} (default: @var{webssh})
ru: @code{port} (default: @code{22})

note: type: table
en: @code{webssh} package to use.
ru: Используемый пакет @code{webssh}.

note: type: item
en: @code{user-name} (default: @var{"webssh"})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{group-name} (default: @var{"webssh"})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{address} (default: @var{#f})
ru: @code{features} (default: @code{'()})

note: type: item
en: @code{port} (default: @var{8888})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{policy} (default: @var{#f})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{known-hosts} (default: @var{'()})
ru: @code{inputs} (default: @code{'()})

note: type: item
en: @code{log-file} (default: @file{"/var/log/webssh.log"})
ru: @code{daemon-socket} (default: @code{"/var/guix/daemon-socket/socket"})

note: type: item
en: @code{log-level} (default: @var{#f})
ru: @code{features} (default: @code{'()})

note: type: deftp
en: Data type representing the configuration of PageKite.
ru: Управление конфигурацией операционной системы.

note: type: item
en: @code{package} (default: @var{pagekite})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{kitename} (default: @code{#f})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{kitesecret} (default: @code{#f})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{frontend} (default: @code{#f})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{extra-file} (default: @code{#f})
ru: @code{speed} (default: @code{1.0})

note: type: defvr
en: {Scheme Variable} yggdrasil-service-type
ru: {Процедура Scheme} sane-service-type

note: type: deftp
en: {Data Type} yggdrasil-configuration
ru: Конфигурирование системы

note: type: deftp
en: Data type representing the configuration of Yggdrasil.
ru: Управление конфигурацией операционной системы.

note: type: item
en: @code{package} (default: @code{yggdrasil})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{json-config} (default: @code{'()})
ru: @code{inputs} (default: @code{'()})

note: type: item
en: @code{autoconf?} (default: @code{#f})
ru: @code{features} (default: @code{'()})

note: type: item
en: @code{log-to} (default: @code{'stdout})
ru: @code{outputs} (default: @code{'("out")})

note: type: item
en: @code{config-file} (default: @code{"/etc/yggdrasil-private.conf"})
ru: @code{features} (default: @code{'()})

note: type: defvr
en: {Scheme Variable} ipfs-service-type
ru: {Процедура Scheme} sane-service-type

note: type: lisp
en: (service ipfs-service-type
             (ipfs-configuration
              (gateway "/ip4/127.0.0.1/tcp/8880")
              (api "/ip4/127.0.0.1/tcp/8881")))
ru: (service guix-service-type
             (guix-configuration
               (build-accounts 5)
               (use-substitutes? #f)))

note: type: deftp
en: {Data Type} ipfs-configuration
ru: Конфигурирование системы

note: type: deftp
en: Data type representing the configuration of IPFS.
ru: Управление конфигурацией операционной системы.

note: type: item
en: @code{package} (default: @code{go-ipfs})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{gateway} (default: @code{"/ip4/127.0.0.1/tcp/8082"})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{api} (default: @code{"/ip4/127.0.0.1/tcp/5001"})
ru: @code{speed} (default: @code{1.0})

note: type: cindex
en: keepalived
ru: --keep-failed

note: type: deffn
en: {Scheme Variable} keepalived-service-type
ru: {Scheme Variable} profile-service-type

note: type: defvr
en: {Scheme Variable} unattended-upgrade-service-type
ru: {Процедура Scheme} sane-service-type

note: type: deftp
en: {Data Type} unattended-upgrade-configuration
ru: {Тип данных} build-machine

note: type: deftp
en: This data type represents the configuration of the unattended upgrade service.  The following fields are available:
ru: Этот тип данных представляет машины для сборки, на которые демон может разгружать сборки. Важные поля:

note: type: item
en: @code{schedule} (default: @code{"30 01 * * 0"})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{channels} (default: @code{#~%default-channels})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{operating-system-file} (default: @code{"/run/current-system/configuration.scm"})
ru: @code{daemon-socket} (default: @code{"/var/guix/daemon-socket/socket"})

note: type: item
en: @code{services-to-restart} (default: @code{'(mcron)})
ru: @code{features} (default: @code{'()})

note: type: item
en: @code{system-expiration} (default: @code{(* 3 30 24 3600)})
ru: @code{features} (default: @code{'()})

note: type: item
en: @code{maximum-duration} (default: @code{3600})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{log-file} (default: @code{"/var/log/unattended-upgrade.log"})
ru: @code{daemon-socket} (default: @code{"/var/guix/daemon-socket/socket"})

note: type: item
en: @code{display} (default @code{":0"})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{vt} (default @code{"vt7"})
ru: @code{port} (default: @code{22})

note: type: deftp
en: This data type represents the configuration of the SDDM login manager.  The available fields are:
ru: Этот тип данных представляет машины для сборки, на которые демон может разгружать сборки. Важные поля:

note: type: item
en: @code{sddm} (default: @code{sddm})
ru: @code{speed} (default: @code{1.0})

note: type: table
en: The SDDM package to use.
ru: Используемый пакет SDDM.

note: type: item
en: @code{minimum-uid} (default: 1000)
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{maximum-uid} (default: 2000)
ru: @code{parallel-builds} (default: @code{1})

note: type: item
en: @code{gnome} (default: @code{gnome})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{xfce} (default: @code{xfce})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{mate} (default: @code{mate})
ru: @code{port} (default: @code{22})

note: type: deffn
en: {Scheme Variable} lxqt-desktop-service-type
ru: {Scheme Variable} etc-service-type

note: type: deftp
en: {Data Type} lxqt-desktop-configuration
ru: Конфигурирование системы

note: type: deftp
en: Configuration record for the LXQt desktop environment.
ru: Конфигурации для среды рабочего стола LXQt.

note: type: item
en: @code{lxqt} (default: @code{lxqt})
ru: @code{port} (default: @code{22})

note: type: table
en: The LXQT package to use.
ru: Используемый пакет LXQT.

note: type: item
en: @code{enlightenment} (default: @code{enlightenment})
ru: @code{features} (default: @code{'()})

note: type: defvr
en: {Scheme Variable} sane-service-type
ru: {Процедура Scheme} sane-service-type

note: type: defvr
en: {Scheme Variable} sane-backends-minimal
ru: {Scheme Variable} ant-build-system

note: type: defvr
en: {Scheme Variable} sane-backends
ru: {Scheme Variable} ant-build-system

note: type: item
en: @code{keyring} (default: @code{gnome-keyring})
ru: @code{port} (default: @code{22})

note: type: code{#1}
en: pam-services
ru: Базовые сервисы

note: type: deftp
en: {Data Type} pulseaudio-configuration
ru: {Тип данных} build-machine

note: type: item
en: @code{client-conf} (default: @code{'()})
ru: @code{features} (default: @code{'()})

note: type: item
en: @code{daemon-conf} (default: @code{'((flat-volumes . no))})
ru: @code{features} (default: @code{'()})

note: type: item
en: @code{script-file} (default: @code{(file-append pulseaudio "/etc/pulse/default.pa")})
ru: @code{features} (default: @code{'()})

note: type: deftp
en: {Data Type} postgresql-configuration
ru: Конфигурирование системы

note: type: deftp
en: Data type representing the configuration for the @code{postgresql-service-type}.
ru: Управление конфигурацией операционной системы.

note: type: table
en: PostgreSQL package to use for the service.
ru: Пакет PostgreSQL для использования в сервисе.

note: type: item
en: @code{port} (default: @code{5432})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{config-file} (default: @code{(postgresql-config-file)})
ru: @code{features} (default: @code{'()})

note: type: item
en: @code{log-directory} (default: @code{"/var/log/postgresql"})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{data-directory} (default: @code{"/var/lib/postgresql/data"})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{extension-packages} (default: @code{'()})
ru: @code{patches} (по умолчанию: @code{'()})

note: type: deftp
en: {Data Type} postgresql-config-file
ru: Конфигурирование системы

note: type: item
en: @code{log-destination} (default: @code{"syslog"})
ru: @code{compression-level} (default: @code{3})

note: type: item
en: @code{hba-file} (default: @code{%default-postgres-hba})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{ident-file} (default: @code{%default-postgres-ident})
ru: @code{features} (default: @code{'()})

note: type: deffn
en: {Scheme Variable} postgresql-role-service-type
ru: {Scheme Variable} profile-service-type

note: type: deftp
en: {Data Type} postgresql-role
ru: Конфигурирование системы

note: type: table
en: The role name.
ru: Имя роли.

note: type: item
en: @code{permissions} (default: @code{'(createdb login)})
ru: @code{features} (default: @code{'()})

note: type: item
en: @code{create-database?} (default: @code{#f})
ru: @code{features} (default: @code{'()})

note: type: deftp
en: {Data Type} postgresql-role-configuration
ru: Конфигурирование системы

note: type: deftp
en: Data type representing the configuration of @var{postgresql-role-service-type}.
ru: Управление конфигурацией операционной системы.

note: type: item
en: @code{host} (default: @code{"/var/run/postgresql"})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{log} (default: @code{"/var/log/postgresql_roles.log"})
ru: @code{daemon-socket} (default: @code{"/var/guix/daemon-socket/socket"})

note: type: table
en: File name of the log file.
ru: Имя используемой базы данных.

note: type: item
en: @code{roles} (default: @code{'()})
ru: @code{modules} (по умолчанию: @code{'()})

note: type: defvr
en: {Scheme Variable} mysql-service-type
ru: {Процедура Scheme} sane-service-type

note: type: deftp
en: Data type representing the configuration of @var{mysql-service-type}.
ru: Управление конфигурацией операционной системы.

note: type: item
en: @code{socket} (default: @code{"/run/mysqld/mysqld.sock"})
ru: @code{daemon-socket} (default: @code{"/var/guix/daemon-socket/socket"})

note: type: item
en: @code{extra-environment} (default: @code{#~'()})
ru: @code{features} (default: @code{'()})

note: type: table
en: List of environment variables passed to the @command{mysqld} process.
ru: Список переменных среды, которые необходимо определить.

note: type: item
en: @code{auto-upgrade?} (default: @code{#t})
ru: @code{port} (default: @code{22})

note: type: subsubheading
en: Getmail service
ru: Почтовые сервисы

note: type: deftypevr
en: The getmail package to use.
ru: Используемый пакет getmail.

note: type: deftypevr
en: The getmail configuration file to use.
ru: Используемый файл конфигурации getmail.

note: type: deftypevr
en: CA certificates to use.
ru: Сертификаты CA для использования.

note: type: subsubheading
en: Radicale Service
ru: Почтовые сервисы

note: type: deffn
en: {Scheme Variable} radicale-service-type
ru: {Процедура Scheme} sane-service-type

note: type: deftp
en: {Data Type} radicale-configuration
ru: {Data Type} pagekite-configuration

note: type: deftp
en: Data type representing the configuration of @command{radicale}.
ru: Управление конфигурацией операционной системы.

note: type: item
en: @code{package} (default: @code{radicale})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{config-file} (default: @code{%default-radicale-config-file})
ru: @code{features} (default: @code{'()})

note: type: Plain text
en: The @code{(gnu services messaging)} module provides Guix service definitions for messaging services.  Currently it provides the following services:
ru: Модуль @code{(guix inferior)} предоставляет следующие процедуры для работы с ранними версиями:

note: type: item
en: @code{bitlbee} (default: @code{bitlbee})
ru: @code{port} (default: @code{22})

note: type: Plain text
en: The @code{(gnu services file-sharing)} module provides services that assist with transferring files over peer-to-peer file-sharing networks.
ru: Модуль @code{(gnu services file-sharing)} предоставляет следующие сервисы, помогающие с передачей файлов через одноранговые сети.

note: type: subsubheading
en: Transmission Daemon Service
ru: Сервисы упраления версиями

note: type: deffn
en: {Scheme Variable} transmission-daemon-service-type
ru: {Процедура Scheme} sane-service-type

note: type: deffn
en: {Scheme Procedure} transmission-password-hash @var{password} @var{salt}
ru: {Процедура Scheme} lookup-inferior-packages @var{inferior} @var{name} @

note: type: deffn
en: {Scheme Procedure} transmission-random-salt
ru: {Процедура Scheme} open-inferior @var{directory} @

note: type: example
en: # herd reload transmission-daemon
ru: herd start ssh-daemon

note: type: deftp
en: {Data Type} transmission-daemon-configuration
ru: {Тип данных} build-machine

note: type: deftypevr
en: The Transmission package to use.
ru: Используемый пакет nfs-utils.

note: type: lisp
en: (service sysctl-service-type
             (sysctl-configuration
              (settings
               ("net.ipv4.tcp_allowed_congestion_control" .
                "reno cubic lp"))))
ru: (service cups-service-type
             (cups-configuration
               (web-interface? #t)
               (extensions
                 (list cups-filters epson-inkjet-printer-escpr hplip-minimal))))

note: type: lisp
en: (service prometheus-node-exporter-service-type)
ru: (service openssh-service-type)

note: type: item
en: @code{textfile-directory} (default: @code{"/var/lib/prometheus/node-exporter"})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{lua-package-path} (default: @code{'()})
ru: @code{native-search-paths} (default: @code{'()})

note: type: item
en: @code{lua-package-cpath} (default: @code{'()})
ru: @code{native-search-paths} (default: @code{'()})

note: type: item
en: @code{global-directives} (default: @code{'((events . ()))})
ru: @code{features} (default: @code{'()})

note: type: defvr
en: Service type for Patchwork.
ru: Поделитесь своей работой.

note: type: item
en: @code{patchwork} (default: @code{patchwork})
ru: @code{port} (default: @code{22})

note: type: table
en: The Patchwork package to use.
ru: Используемый пакет Patchwork.

note: type: item
en: @code{static-path}  (default: @code{"/static/"})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{secret-key-file} (default: @code{"/etc/patchwork/django-secret-key"})
ru: @code{daemon-socket} (default: @code{"/var/guix/daemon-socket/socket"})

note: type: item
en: @code{static-url} (default: @code{#f})
ru: @code{features} (default: @code{'()})

note: type: item
en: @code{admins} (default: @code{'()})
ru: @code{features} (default: @code{'()})

note: type: item
en: @code{enable-rest-api?} (default: @code{#t})
ru: @code{features} (default: @code{'()})

note: type: item
en: @code{enable-xmlrpc?} (default: @code{#t})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{force-https-links?} (default: @code{#t})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{engine} (default: @code{"django.db.backends.postgresql_psycopg2"})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{name} (default: @code{"patchwork"})
ru: @code{port} (default: @code{22})

note: type: table
en: The name of the database to use.
ru: Имя используемой базы данных.

note: type: item
en: @code{password} (default: @code{""})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{host} (default: @code{""})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{port} (default: @code{""})
ru: @code{port} (default: @code{22})

note: type: cindex
en: Mumi, Debbugs Web interface
ru: пользовательские интерфейсы

note: type: cindex
en: Debbugs, Mumi Web interface
ru: пользовательские интерфейсы

note: type: deftp
en: {Data Type} mumi-configuration
ru: {Тип данных} build-machine

note: type: deftp
en: Data type representing the Mumi service configuration.  This type has the following fields:
ru: Тип данных, представляющий конфигурацию сервиса Mumi.  Этот тип имеет следующие поля:

note: type: item
en: @code{mumi} (default: @code{mumi})
ru: @code{port} (default: @code{22})

note: type: table
en: The Mumi package to use.
ru: Используемый пакет Mumi.

note: type: item
en: @code{mailer?} (default: @code{#true})
ru: @code{speed} (default: @code{1.0})

note: type: code{#1}
en: mumi-configuration-sender
ru: Конфигурирование системы

note: type: code{#1}
en: mumi-configuration-smtp
ru: Конфигурирование системы

note: type: item
en: @code{socket-group} (default: @code{nginx})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{php-ini-file} (default @code{#f})
ru: @code{speed} (default: @code{1.0})

note: type: deffn
en: {Scheme Procedure} nginx-php-location @
ru: {Процедура Scheme} inferior-package-location @var{package}

note: type: deffn
en: {Scheme Variable} gmnisrv-service-type
ru: {Процедура Scheme} sane-service-type

note: type: deftp
en: {Data Type} gmnisrv-configuration
ru: Конфигурирование системы

note: type: deftp
en: Data type representing the configuration of gmnisrv.
ru: Управление конфигурацией операционной системы.

note: type: item
en: @code{package} (default: @var{gmnisrv})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{config-file} (default: @code{%default-gmnisrv-config-file})
ru: @code{features} (default: @code{'()})

note: type: deffn
en: {Scheme Variable} agate-service-type
ru: {Процедура Scheme} sane-service-type

note: type: deftp
en: {Data Type} agate-configuration
ru: {Data Type} pagekite-configuration

note: type: deftp
en: Data type representing the configuration of Agate.
ru: Управление конфигурацией операционной системы.

note: type: item
en: @code{package} (default: @code{agate})
ru: @code{speed} (default: @code{1.0})

note: type: table
en: The package object of the Agate server.
ru: Пакет для использования.

note: type: item
en: @code{content} (default: @file{"/srv/gemini"})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{cert} (default: @code{#f})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{addr} (default: @code{'("0.0.0.0:1965" "[::]:1965")})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{lang} (default: @code{#f})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{silent?} (default: @code{#f})
ru: @code{snippet} (по умолчанию: @code{#f})

note: type: item
en: @code{serve-secret?} (default: @code{#f})
ru: @code{features} (default: @code{'()})

note: type: item
en: @code{log-ip?} (default: @code{#t})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{user} (default: @code{"agate"})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{group} (default: @code{"agate"})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{log-file} (default: @file{"/var/log/agate.log"})
ru: @code{daemon-socket} (default: @code{"/var/guix/daemon-socket/socket"})

note: type: item
en: @code{email} (default: @code{#f})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{server} (default: @code{#f})
ru: @code{features} (default: @code{'()})

note: type: subsubheading
en: Knot Resolver Service
ru: Сервисы Kerberos

note: type: deftp
en: Data type representing the configuration of knot-resolver.
ru: Управление конфигурацией операционной системы.

note: type: item
en: @code{package} (default: @var{knot-resolver})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{kresd-config-file} (default: %kresd.conf)
ru: @code{compression-level} (default: @code{3})

note: type: item
en: @code{garbage-collection-interval} (default: 1000)
ru: @code{parallel-builds} (default: @code{1})

note: type: item
en: @code{addresses} (default: @code{'()})
ru: @code{features} (default: @code{'()})

note: type: item
en: @code{tftp-enable?} (default: @code{#f})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{tftp-no-fail?} (default: @code{#f})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{tftp-single-port?} (default: @code{#f})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{tftp-secure?} (default: @code{#f})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{tftp-max} (default: @code{#f})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{tftp-mtu} (default: @code{#f})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{tftp-no-blocksize?} (default: @code{#f})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{tftp-lowercase?} (default: @code{#f})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{tftp-port-range} (default: @code{#f})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{tftp-root} (default: @code{/var/empty,lo})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{tftp-unique-root} (default: @code{#f})
ru: @code{port} (default: @code{22})

note: type: Plain text
en: The @code{(gnu services vpn)} module provides services related to @dfn{virtual private networks} (VPNs).
ru: Модуль @code{(gnu services file-sharing)} предоставляет следующие сервисы, помогающие с передачей файлов через одноранговые сети.

note: type: defvr
en: {Scheme Variable} wireguard-service-type
ru: {Процедура Scheme} sane-service-type

note: type: deftp
en: {Data Type} wireguard-configuration
ru: {Тип данных} build-machine

note: type: deftp
en: Data type representing the configuration of the Wireguard service.
ru: Управление конфигурацией операционной системы.

note: type: table
en: The wireguard package to use for this service.
ru: Пакет @code{ganeti} для использования в этой службе.

note: type: item
en: @code{interface} (default: @code{"wg0"})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{addresses} (default: @code{'("10.0.0.1/32")})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{private-key} (default: @code{"/etc/wireguard/private.key"})
ru: @code{features} (default: @code{'()})

note: type: item
en: @code{peers} (default: @code{'()})
ru: @code{features} (default: @code{'()})

note: type: deftp
en: {Data Type} wireguard-peer
ru: {Тип данных} build-machine

note: type: deftp
en: Data type representing a Wireguard peer attached to a given interface.
ru: Управление конфигурацией операционной системы.

note: type: table
en: The peer name.
ru: Имя роли.

note: type: item
en: @code{endpoint} (default: @code{#f})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{keep-alive} (default: @code{#f})
ru: @code{speed} (default: @code{1.0})

note: type: subsubheading
en: NFS Service
ru: Сервисы DNS

note: type: cindex
en: NFS, server
ru: NFS, сервер

note: type: deftp
en: {Data Type} nfs-configuration
ru: Конфигурирование системы

note: type: deftp
en: It has the following parameters:
ru: GNU Guix зависит от следующих пакетов:

note: type: table
en: The nfs-utils package to use.
ru: Используемый пакет nfs-utils.

note: type: item
en: @code{nfs-versions} (default: @code{'("4.2" "4.1" "4.0")})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{exports} (default: @code{'()})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{rpcmountd-port} (default: @code{#f})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{rpcstatd-port} (default: @code{#f})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{idmap-domain} (default: @code{"localdomain"})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{nfsd-port} (default: @code{2049})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{nfsd-threads} (default: @code{8})
ru: @code{features} (default: @code{'()})

note: type: item
en: @code{nfsd-tcp?} (default: @code{#t})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{nfsd-udp?} (default: @code{#f})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{debug} (default: @code{'()"})
ru: @code{features} (default: @code{'()})

note: type: item
en: @code{verbosity} (default: @code{0})
ru: @code{port} (default: @code{22})

note: type: table
en: The verbosity level of the daemon.
ru: Уровень детализации демона.

note: type: item
en: @code{web-log-file} (default: @code{"/var/log/cuirass-web.log"})
ru: @code{daemon-socket} (default: @code{"/var/guix/daemon-socket/socket"})

note: type: item
en: @code{parameters} (default: @code{#f})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{remote-server} (default: @code{#f})
ru: @code{features} (default: @code{'()})

note: type: item
en: @code{database} (default: @code{"dbname=cuirass host=/var/run/postgresql"})
ru: @code{port} (default: @code{22})

note: type: cindex
en: remote build
ru: воспроизводимые сборки

note: type: subsubheading
en: Cuirass remote building
ru: последний коммит, сборка

note: type: item
en: Using the local Guix daemon.
ru: Запуск демона сборки.

note: type: item
en: Using the remote build mechanism.
ru: Подготовка отдельного окружения сборки.

note: type: deftp
en: {Data Type} cuirass-remote-server-configuration
ru: {Data Type} pagekite-configuration

note: type: deftp
en: Data type representing the configuration of the Cuirass remote-server.
ru: Управление конфигурацией операционной системы.

note: type: item
en: @code{backend-port} (default: @code{5555})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{log-port} (default: @code{5556})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{publish-port} (default: @code{5557})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{log-file} (default: @code{"/var/log/cuirass-remote-server.log"})
ru: @code{daemon-socket} (default: @code{"/var/guix/daemon-socket/socket"})

note: type: item
en: @code{cache} (default: @code{"/var/cache/cuirass/remote"})
ru: @code{daemon-socket} (default: @code{"/var/guix/daemon-socket/socket"})

note: type: item
en: @code{trigger-url} (default: @code{#f})
ru: @code{features} (default: @code{'()})

note: type: deftp
en: {Data Type} cuirass-remote-worker-configuration
ru: {Тип данных} build-machine

note: type: deftp
en: Data type representing the configuration of the Cuirass remote-worker.
ru: Управление конфигурацией операционной системы.

note: type: item
en: @code{workers} (default: @code{1})
ru: @code{features} (default: @code{'()})

note: type: item
en: @code{systems} (default: @code{(list (%current-system))})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{log-file} (default: @code{"/var/log/cuirass-remote-worker.log"})
ru: @code{daemon-socket} (default: @code{"/var/guix/daemon-socket/socket"})

note: type: item
en: @code{publish-port} (default: @code{5558})
ru: @code{port} (default: @code{22})

note: type: defvr
en: {Scheme Procedure} laminar-service-type
ru: {Процедура Scheme} sane-service-type

note: type: lisp
en: (service laminar-service-type)
ru: (service openssh-service-type)

note: type: deftp
en: {Data Type} laminar-configuration
ru: {Тип данных} build-machine

note: type: deftp
en: Data type representing the configuration of Laminar.
ru: Управление конфигурацией операционной системы.

note: type: item
en: @code{laminar} (default: @code{laminar})
ru: @code{port} (default: @code{22})

note: type: table
en: The Laminar package to use.
ru: Используемый пакет Mumi.

note: type: item
en: @code{home-directory} (default: @code{"/var/lib/laminar"})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{bind-http} (default: @code{"*:8080"})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{bind-rpc} (default: @code{"unix-abstract:laminar"})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{title} (default: @code{"Laminar"})
ru: @code{port} (default: @code{22})

note: type: table
en: The page title to show in the web frontend.
ru: Сервис rottlog.

note: type: item
en: @code{keep-rundirs} (default: @code{0})
ru: @code{features} (default: @code{'()})

note: type: item
en: @code{archive-url} (default: @code{#f})
ru: @code{features} (default: @code{'()})

note: type: item
en: @code{base-url} (default: @code{#f})
ru: @code{features} (default: @code{'()})

note: type: table
en: Base URL to use for links to laminar itself.
ru: URI для использования в базе данных.

note: type: item
en: @code{outputs} (default: @code{"(list (mpd-output))"})
ru: @code{features} (default: @code{'()})

note: type: item
en: @code{name} (default: @code{"MPD"})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{type} (default: @code{"pulse"})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{enabled?} (default: @code{#t})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{tags?} (default: @code{#t})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{always-on?} (default: @code{#f})
ru: @code{port} (default: @code{22})

note: type: lisp
en: (service qemu-binfmt-service-type
             (qemu-binfmt-configuration
               (platforms (lookup-qemu-platforms "arm"))))
ru: (service qemu-binfmt-service-type
             (qemu-binfmt-configuration
               (platforms (lookup-qemu-platforms "arm" "aarch64"))))

note: type: item
en: @code{qemu} (default: @code{qemu-minimal})
ru: @code{port} (default: @code{22})

note: type: subsubheading
en: The Hurd in a Virtual Machine
ru: Установка Guix на виртуальную машину (VM)

note: type: defvr
en: {Scheme Variable} hurd-vm-service-type
ru: {Процедура Scheme} sane-service-type

note: type: deftp
en: {Data Type} hurd-vm-configuration
ru: {Тип данных} build-machine

note: type: deftp
en: The data type representing the configuration for @code{hurd-vm-service-type}.
ru: Управление конфигурацией операционной системы.

note: type: item
en: @code{os} (default: @var{%hurd-vm-operating-system})
ru: @code{features} (default: @code{'()})

note: type: item
en: @code{image} (default: @var{hurd-vm-disk-image})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{disk-size} (default: @code{'guess})
ru: @code{features} (default: @code{'()})

note: type: table
en: The size of the disk image.
ru: Лицензия этого руководства.

note: type: item
en: @code{memory-size} (default: @code{512})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{options} (default: @code{'("--snapshot")})
ru: @code{outputs} (default: @code{'("out")})

note: type: item
en: @code{net-options} (default: @var{hurd-vm-net-options})
ru: @code{features} (default: @code{'()})

note: type: item
en: @code{secret-root} (default: @file{/etc/childhurd})
ru: @code{private-key} (default: @file{~root/.ssh/id_rsa})

note: type: cindex
en: childhurd, offloading
ru: разгрузка

note: type: cindex
en: Hurd, offloading
ru: разгрузка

note: type: defvr
en: {Scheme Variable} ganeti-service-type
ru: {Процедура Scheme} sane-service-type

note: type: deftp
en: {Data Type} ganeti-configuration
ru: Конфигурирование системы

note: type: deftp
en: The @code{ganeti} service takes the following configuration options:
ru: Модуль @code{(guix inferior)} предоставляет следующие процедуры для работы с ранними версиями:

note: type: item
en: @code{ganeti} (default: @code{ganeti})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{noded-configuration} (default: @code{(ganeti-noded-configuration)})
ru: @code{port} (default: @code{22})

note: type: itemx
en: @code{confd-configuration} (default: @code{(ganeti-confd-configuration)})
ru: @code{port} (default: @code{22})

note: type: itemx
en: @code{wconfd-configuration} (default: @code{(ganeti-wconfd-configuration)})
ru: @code{port} (default: @code{22})

note: type: itemx
en: @code{luxid-configuration} (default: @code{(ganeti-luxid-configuration)})
ru: @code{port} (default: @code{22})

note: type: itemx
en: @code{rapi-configuration} (default: @code{(ganeti-rapi-configuration)})
ru: @code{port} (default: @code{22})

note: type: itemx
en: @code{kvmd-configuration} (default: @code{(ganeti-kvmd-configuration)})
ru: @code{port} (default: @code{22})

note: type: itemx
en: @code{mond-configuration} (default: @code{(ganeti-mond-configuration)})
ru: @code{port} (default: @code{22})

note: type: itemx
en: @code{metad-configuration} (default: @code{(ganeti-metad-configuration)})
ru: @code{port} (default: @code{22})

note: type: itemx
en: @code{watcher-configuration} (default: @code{(ganeti-watcher-configuration)})
ru: @code{port} (default: @code{22})

note: type: itemx
en: @code{cleaner-configuration} (default: @code{(ganeti-cleaner-configuration)})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{file-storage-paths} (default: @code{'()})
ru: @code{native-search-paths} (default: @code{'()})

note: type: item
en: @code{os} (default: @code{%default-ganeti-os})
ru: @code{port} (default: @code{22})

note: type: deftp
en: {Data Type} ganeti-os
ru: {Тип данных} build-machine

note: type: item
en: @code{variants} (default: @code{'()})
ru: @code{inputs} (default: @code{'()})

note: type: deftp
en: {Data Type} ganeti-os-variant
ru: {Тип данных} build-machine

note: type: table
en: The name of this variant.
ru: Лицензия этого руководства.

note: type: code{#1}
en: configuration
ru: Конфигурирование системы

note: type: table
en: A configuration file for this variant.
ru: Файл конфигурации для этого варианта.

note: type: defvr
en: {Scheme Variable} %default-debootstrap-hooks
ru: {Scheme Variable} ant-build-system

note: type: defvr
en: {Scheme Variable} %default-debootstrap-extra-pkgs
ru: {Scheme Variable} ant-build-system

note: type: deftp
en: {Data Type} debootstrap-configuration
ru: Конфигурирование системы

note: type: item
en: @code{hooks} (default: @code{%default-debootstrap-hooks})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{proxy} (default: @code{#f})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{mirror} (default: @code{#f})
ru: @code{features} (default: @code{'()})

note: type: item
en: @code{arch} (default: @code{#f})
ru: @code{features} (default: @code{'()})

note: type: item
en: @code{suite} (default: @code{"stable"})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{extra-pkgs} (default: @code{%default-debootstrap-extra-pkgs})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{components} (default: @code{#f})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{generate-cache?} (default: @code{#t})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{clean-cache} (default: @code{14})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{partition-style} (default: @code{'msdos})
ru: @code{features} (default: @code{'()})

note: type: item
en: @code{partition-alignment} (default: @code{2048})
ru: @code{arguments} (default: @code{'()})

note: type: deffn
en: {Scheme Procedure} debootstrap-variant @var{name} @var{configuration}
ru: {Процедура Scheme} lookup-inferior-packages @var{inferior} @var{name} @

note: type: deffn
en: {Scheme Procedure} debootstrap-os @var{variants}@dots{}
ru: {Процедура Scheme} lookup-inferior-packages @var{inferior} @var{name} @

note: type: deffn
en: {Scheme Procedure} guix-variant @var{name} @var{configuration}
ru: {Процедура Scheme} lookup-inferior-packages @var{inferior} @var{name} @

note: type: deffn
en: {Scheme Procedure} guix-os @var{variants}@dots{}
ru: {Процедура Scheme} lookup-inferior-packages @var{inferior} @var{name} @

note: type: defvr
en: {Scheme Variable} %default-debootstrap-variants
ru: {Процедура Scheme} sane-service-type

note: type: defvr
en: {Scheme Variable} %default-guix-variants
ru: {Scheme Variable} ant-build-system

note: type: defvr
en: {Scheme Variable} ganeti-noded-service-type
ru: {Процедура Scheme} sane-service-type

note: type: deftp
en: {Data Type} ganeti-noded-configuration
ru: {Data Type} pagekite-configuration

note: type: table
en: The @code{ganeti} package to use for this service.
ru: Пакет @code{ganeti} для использования в этой службе.

note: type: item
en: @code{port} (default: @code{1811})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{address} (default: @code{"0.0.0.0"})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{max-clients} (default: @code{20})
ru: @code{inputs} (default: @code{'()})

note: type: item
en: @code{ssl?} (default: @code{#t})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{ssl-key} (default: @file{"/var/lib/ganeti/server.pem"})
ru: @code{daemon-socket} (default: @code{"/var/guix/daemon-socket/socket"})

note: type: item
en: @code{ssl-cert} (default: @file{"/var/lib/ganeti/server.pem"})
ru: @code{speed} (default: @code{1.0})

note: type: defvr
en: {Scheme Variable} ganeti-confd-service-type
ru: {Процедура Scheme} sane-service-type

note: type: deftp
en: {Data Type} ganeti-confd-configuration
ru: Конфигурирование системы

note: type: item
en: @code{port} (default: @code{1814})
ru: @code{port} (default: @code{22})

note: type: defvr
en: {Scheme Variable} ganeti-wconfd-service-type
ru: {Процедура Scheme} sane-service-type

note: type: deftp
en: {Data Type} ganeti-wconfd-configuration
ru: Конфигурирование системы

note: type: item
en: @code{no-voting?} (default: @code{#f})
ru: @code{port} (default: @code{22})

note: type: defvr
en: {Scheme Variable} ganeti-luxid-service-type
ru: {Процедура Scheme} sane-service-type

note: type: deftp
en: {Data Type} ganeti-luxid-configuration
ru: {Тип данных} build-machine

note: type: defvr
en: {Scheme Variable} ganeti-rapi-service-type
ru: {Процедура Scheme} sane-service-type

note: type: deftp
en: {Data Type} ganeti-rapi-configuration
ru: Конфигурирование системы

note: type: item
en: @code{require-authentication?} (default: @code{#f})
ru: @code{features} (default: @code{'()})

note: type: item
en: @code{port} (default: @code{5080})
ru: @code{port} (default: @code{22})

note: type: defvr
en: {Scheme Variable} ganeti-kvmd-service-type
ru: {Процедура Scheme} sane-service-type

note: type: deftp
en: {Data Type} ganeti-kvmd-configuration
ru: {Тип данных} build-machine

note: type: defvr
en: {Scheme Variable} ganeti-mond-service-type
ru: {Процедура Scheme} sane-service-type

note: type: deftp
en: {Data Type} ganeti-mond-configuration
ru: {Тип данных} build-machine

note: type: item
en: @code{port} (default: @code{1815})
ru: @code{port} (default: @code{22})

note: type: defvr
en: {Scheme Variable} ganeti-metad-service-type
ru: {Процедура Scheme} sane-service-type

note: type: deftp
en: {Data Type} ganeti-metad-configuration
ru: {Тип данных} build-machine

note: type: defvr
en: {Scheme Variable} ganeti-watcher-service-type
ru: {Процедура Scheme} sane-service-type

note: type: deftp
en: {Data Type} ganeti-watcher-configuration
ru: {Data Type} pagekite-configuration

note: type: item
en: @code{rapi-ip} (default: @code{#f})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{job-age} (default: @code{(* 6 3600)})
ru: @code{features} (default: @code{'()})

note: type: item
en: @code{verify-disks?} (default: @code{#t})
ru: @code{port} (default: @code{22})

note: type: defvr
en: {Scheme Variable} ganeti-cleaner-service-type
ru: {Процедура Scheme} sane-service-type

note: type: deftp
en: {Data Type} ganeti-cleaner-configuration
ru: {Тип данных} build-machine

note: type: item
en: @code{master-schedule} (default: @code{"45 1 * * *"})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{node-schedule} (default: @code{"45 2 * * *"})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{package} (default: @code{git})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{export-all?} (default: @code{#f})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{user-path} (default: @code{#f})
ru: @code{features} (default: @code{'()})

note: type: item
en: @code{listen} (default: @code{'()})
ru: @code{inputs} (default: @code{'()})

note: type: item
en: @code{port} (default: @code{#f})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{whitelist} (default: @code{'()})
ru: @code{inputs} (default: @code{'()})

note: type: item
en: @code{uri-path} (default: @samp{/git/})
ru: @code{port} (default: @code{22})

note: type: deftp
en: Data type representing the configuration of PAM Mount.
ru: Управление конфигурацией операционной системы.

note: type: code{#1}
en: rules
ru: Модули

note: type: defvar
en: {Scheme Variable} guix-build-coordinator-service-type
ru: {Scheme Variable} boot-service-type

note: type: deftp
en: {Data Type} guix-build-coordinator-configuration
ru: Конфигурирование системы

note: type: deftp
en: Data type representing the configuration of the Guix Build Coordinator.
ru: Управление конфигурацией операционной системы.

note: type: item
en: @code{package} (default: @code{guix-build-coordinator})
ru: @code{speed} (default: @code{1.0})

note: type: table
en: The Guix Build Coordinator package to use.
ru: Используемый пакет Guix Build Coordinator.

note: type: item
en: @code{user} (default: @code{"guix-build-coordinator"})
ru: @code{speed} (default: @code{1.0})

note: type: table
en: The system user to run the service as.
ru: Сервис mcron.

note: type: item
en: @code{group} (default: @code{"guix-build-coordinator"})
ru: @code{port} (default: @code{22})

note: type: table
en: The URI to use for the database.
ru: URI для использования в базе данных.

note: type: item
en: @code{agent-communication-uri} (default: @code{"http://0.0.0.0:8745"})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{client-communication-uri} (default: @code{"http://127.0.0.1:8746"})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{allocation-strategy} (default: @code{#~basic-build-allocation-strategy})
ru: @code{features} (default: @code{'()})

note: type: item
en: @code{hooks} (default: @var{'()})
ru: @code{inputs} (default: @code{'()})

note: type: item
en: @code{guile} (default: @code{guile-3.0-latest})
ru: @code{port} (default: @code{22})

note: type: defvar
en: {Scheme Variable} guix-build-coordinator-agent-service-type
ru: {Процедура Scheme} sane-service-type

note: type: deftp
en: {Data Type} guix-build-coordinator-agent-configuration
ru: Конфигурирование системы

note: type: deftp
en: Data type representing the configuration a Guix Build Coordinator agent.
ru: Управление конфигурацией операционной системы.

note: type: item
en: @code{user} (default: @code{"guix-build-coordinator-agent"})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{coordinator} (default: @code{"http://localhost:8745"})
ru: @code{port} (default: @code{22})

note: type: code{#1}
en: authentication
ru: channel-authentication

note: type: item
en: @code{systems} (default: @code{#f})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{max-parallel-builds} (default: @code{1})
ru: @code{parallel-builds} (default: @code{1})

note: type: table
en: The number of builds to perform in parallel.
ru: Число сборок, которые могут быть запущены на машине.

note: type: item
en: @code{max-1min-load-average} (default: @code{#f})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{derivation-substitute-urls} (default: @code{#f})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{non-derivation-substitute-urls} (default: @code{#f})
ru: @code{native-inputs} (default: @code{'()})

note: type: deftp
en: {Data Type} guix-build-coordinator-agent-password-auth
ru: Конфигурирование системы

note: type: deftp
en: Data type representing an agent authenticating with a coordinator via a UUID and password.
ru: Управление конфигурацией операционной системы.

note: type: deftp
en: {Data Type} guix-build-coordinator-agent-password-file-auth
ru: Конфигурирование системы

note: type: code{#1}
en: password-file
ru: профиль

note: type: deftp
en: {Data Type} guix-build-coordinator-agent-dynamic-auth
ru: Конфигурирование системы

note: type: deftp
en: Data type representing an agent authenticating with a coordinator via a dynamic auth token and agent name.
ru: Управление конфигурацией операционной системы.

note: type: code{#1}
en: agent-name
ru: каналы

note: type: deftp
en: {Data Type} guix-build-coordinator-agent-dynamic-auth-with-file
ru: Конфигурирование системы

note: type: deftp
en: Data type representing an agent authenticating with a coordinator via a dynamic auth token read from a file and agent name.
ru: Управление конфигурацией операционной системы.

note: type: code{#1}
en: token-file
ru: профиль

note: type: defvar
en: {Scheme Variable} guix-build-coordinator-queue-builds-service-type
ru: {Процедура Scheme} sane-service-type

note: type: deftp
en: {Data Type} guix-build-coordinator-queue-builds-configuration
ru: Конфигурирование системы

note: type: deftp
en: Data type representing the options to the queue builds from guix data service script.
ru: Управление конфигурацией операционной системы.

note: type: item
en: @code{user} (default: @code{"guix-build-coordinator-queue-builds"})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{coordinator} (default: @code{"http://localhost:8746"})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{systems-and-targets} (default: @code{#f})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{guix-data-service} (default: @code{"https://data.guix.gnu.org"})
ru: @code{speed} (default: @code{1.0})

note: type: subsubheading
en: Guix Data Service
ru: Сервисы баз данных

note: type: item
en: @code{package} (default: @code{guix-data-service})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{user} (default: @code{"guix-data-service"})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{group} (default: @code{"guix-data-service"})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{port} (default: @code{8765})
ru: @code{port} (default: @code{22})

note: type: table
en: The port to bind the web service to.
ru: Сервис rottlog.

note: type: item
en: @code{host} (default: @code{"127.0.0.1"})
ru: @code{speed} (default: @code{1.0})

note: type: table
en: The host to bind the web service to.
ru: Сервис rottlog.

note: type: item
en: @code{getmail-idle-mailboxes} (default: @code{#f})
ru: @code{parallel-builds} (default: @code{1})

note: type: item
en: @code{commits-getmail-retriever-configuration} (default: @code{#f})
ru: @code{compression-level} (default: @code{3})

note: type: table
en: Extra command line options for @code{guix-data-service}.
ru: Дополнительные параметры командной строки для @code {guix-data-service}.

note: type: item
en: @code{extra-process-jobs-options} (default: @var{'()})
ru: @code{features} (default: @code{'()})

note: type: subsubheading
en: Early OOM Service
ru: Почтовые сервисы

note: type: item
en: @code{earlyoom} (default: @var{earlyoom})
ru: @code{port} (default: @code{22})

note: type: table
en: The Earlyoom package to use.
ru: Используемый пакет Earlyoom.

note: type: item
en: @code{minimum-available-memory} (default: @code{10})
ru: @code{parallel-builds} (default: @code{1})

note: type: item
en: @code{minimum-free-swap} (default: @code{10})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{prefer-regexp} (default: @code{#f})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{avoid-regexp} (default: @code{#f})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{memory-report-interval} (default: @code{0})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{ignore-positive-oom-score-adj?} (default: @code{#f})
ru: @code{compression-level} (default: @code{3})

note: type: item
en: @code{show-debug-messages?} (default: @code{#f})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{send-notification-command} (default: @code{#f})
ru: @code{speed} (default: @code{1.0})

note: type: subsubheading
en: Kernel Module Loader Service
ru: Сервисы Kerberos

note: type: deffn
en: {Scheme Variable} kernel-module-loader-service-type
ru: {Процедура Scheme} sane-service-type

note: type: cindex
en: rasdaemon
ru: демон

note: type: subsubheading
en: Rasdaemon Service
ru: Почтовые сервисы

note: type: itemize
en: faults
ru: по умолчанию

note: type: defvr
en: {Scheme Variable} rasdaemon-service-type
ru: {Процедура Scheme} sane-service-type

note: type: lisp
en: (service rasdaemon-service-type)
ru: (service openssh-service-type)

note: type: deftp
en: {Data Type} rasdaemon-configuration
ru: {Data Type} pagekite-configuration

note: type: deftp
en: The data type representing the configuration of @command{rasdaemon}.
ru: Управление конфигурацией операционной системы.

note: type: item
en: @code{record?} (default: @code{#f})
ru: @code{features} (default: @code{'()})

note: type: subsubheading
en: Zram Device Service
ru: Игровые службы

note: type: deffn
en: {Scheme Variable} zram-device-service-type
ru: {Процедура Scheme} sane-service-type

note: type: deftp
en: {Data Type} zram-device-configuration
ru: {Data Type} pagekite-configuration

note: type: deftp
en: This is the data type representing the configuration for the zram-device service.
ru: Управление конфигурацией операционной системы.

note: type: item
en: @code{size} (default @code{"1G"})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{compression-algorithm} (default @code{'lzo})
ru: @code{compression-level} (default: @code{3})

note: type: item
en: @code{memory-limit} (default @code{0})
ru: @code{port} (default: @code{22})

note: type: defvr
en: {Scheme Variable} hurd-console-service-type
ru: {Процедура Scheme} sane-service-type

note: type: deftp
en: {Data Type} hurd-console-configuration
ru: Конфигурирование системы

note: type: deftp
en: This is the data type representing the configuration for the hurd-console-service.
ru: Управление конфигурацией операционной системы.

note: type: item
en: @code{hurd} (default: @var{hurd})
ru: @code{port} (default: @code{22})

note: type: table
en: The Hurd package to use.
ru: Используемый пакет Hurd.

note: type: defvr
en: {Scheme Variable} hurd-getty-service-type
ru: {Процедура Scheme} sane-service-type

note: type: deftp
en: {Data Type} hurd-getty-configuration
ru: {Тип данных} build-machine

note: type: deftp
en: This is the data type representing the configuration for the hurd-getty-service.
ru: Управление конфигурацией операционной системы.

note: type: item
en: @code{baud-rate} (default: @code{38400})
ru: @code{port} (default: @code{22})

note: type: defvr
en: Since @code{sysctl-service-type} is used in the default lists of services, @code{%base-services} and @code{%desktop-services}, you can use @code{modify-services} to change its configuration and add the kernel parameters that you want (@pxref{Service Reference, @code{modify-services}}).
ru: Поскольку @code{sysctl-service-type} используется в списках служб по умолчанию, @code{%base-services} и @code{%desktop-services}, вы можете использовать @code{modify-services}, чтобы изменить его конфигурации и добить нужные параметры ядра (@pxref{Service Reference, @code{modify-services}}).

note: type: lisp
en: (modify-services %base-services
      (sysctl-service-type config =>
                           (sysctl-configuration
                             (settings (append '(("net.ipv4.ip_forward" . "1"))
                                               %default-sysctl-settings)))))
ru: (service postgresql-role-service-type
                (postgresql-role-configuration
                 (roles
                  (list (postgresql-role
                         (name "test")
                         (create-database? #t))))))

note: type: item
en: @code{settings} (default: @code{%default-sysctl-settings})
ru: @code{port} (default: @code{22})

note: type: defvr
en: {Scheme Variable} %default-sysctl-settings
ru: {Scheme Variable} ant-build-system

note: type: subsubheading
en: Dictionary Service
ru: Создание служб

note: type: defvr
en: {Scheme Variable} dicod-service-type
ru: {Процедура Scheme} sane-service-type

note: type: Plain text
en: The @code{(gnu services docker)} module provides the following services.
ru: Модуль @code{(gnu services docker)} предоставляет следующие сервисы.

note: type: table
en: The Docker daemon package to use.
ru: Используемый пакет Docker демона.

note: type: table
en: The Docker client package to use.
ru: Используемый Docker клиент.

note: type: item
en: @code{proxy} (default @var{docker-libnetwork-cmd-proxy})
ru: @code{port} (default: @code{22})

note: type: table
en: The Docker user-land networking proxy package to use.
ru: Используемый пользователей сетевой прокси-пакет Docker.

note: type: item
en: @code{enable-proxy?} (default @code{#t})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{debug?} (default @code{#f})
ru: @code{features} (default: @code{'()})

note: type: table
en: Enable or disable debug output.
ru: Как включить или отключить подстановки.

note: type: item
en: @code{enable-iptables?} (default @code{#t})
ru: @code{speed} (default: @code{1.0})

note: type: cindex
en: Singularity, container service
ru: целостность, склада

note: type: subsubheading
en: Auditd Service
ru: Сервисы аудио

note: type: Plain text
en: The @code{(gnu services auditd)} module provides the following service.
ru: Модуль @code{(gnu services auditd)} предоставляет следующие сервисы.

note: type: enumerate
en: File accesses
ru: Файловые системы

note: type: enumerate
en: System calls
ru: Установка системы

note: type: enumerate
en: Invoked commands
ru: Вызов @command{guix gc}

note: type: enumerate
en: Network access
ru: Сервисы сети

note: type: deftp
en: {Data Type} auditd-configuration
ru: {Тип данных} build-machine

note: type: item
en: @code{audit} (default: @code{audit})
ru: @code{port} (default: @code{22})

note: type: table
en: The audit package to use.
ru: Пакет аудита для использования.

note: type: item
en: @code{configuration-directory} (default: @code{%default-auditd-configuration-directory})
ru: @code{features} (default: @code{'()})

note: type: subsubheading
en: R-Shiny service
ru: Сервисы DNS

note: type: Plain text
en: The @code{(gnu services science)} module provides the following service.
ru: Модуль @code{(gnu services science)} предоставляет следующие сервис.

note: type: defvr
en: {Scheme Variable} rshiny-service-type
ru: {Процедура Scheme} sane-service-type

note: type: deftp
en: {Data Type} rshiny-configuration
ru: Конфигурирование системы

note: type: deftp
en: This is the data type representing the configuration of rshiny.
ru: Управление конфигурацией операционной системы.

note: type: item
en: @code{package} (default: @code{r-shiny})
ru: @code{speed} (default: @code{1.0})

note: type: table
en: The package to use.
ru: Пакет для использования.

note: type: subsubheading
en: Nix service
ru: Сервисы DNS

note: type: Plain text
en: The @code{(gnu services nix)} module provides the following service.
ru: Модуль @code{(gnu services nix)} предоставляет следующий сервис.

note: type: deftp
en: {Data Type} nix-configuration
ru: Конфигурирование системы

note: type: deftp
en: This data type represents the configuration of the Nix daemon.
ru: Управление конфигурацией операционной системы.

note: type: item
en: @code{nix} (default: @code{nix})
ru: @code{speed} (default: @code{1.0})

note: type: table
en: The Nix package to use.
ru: Используемый пакет Nix.

note: type: item
en: @code{sandbox} (default: @code{#t})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{build-sandbox-items} (default: @code{'()})
ru: @code{inputs} (default: @code{'()})

note: type: table
en: Extra command line options for @code{nix-service-type}.
ru: Дополнительные параметры командной строки для @code{nix-service-type}.

note: type: example
en: guix install nss-certs
    export CURL_CA_BUNDLE="$HOME/.guix-profile/etc/ssl/certs/ca-certificates.crt"
ru: $ guix install glibc-locales
    $ export GUIX_LOCPATH=$HOME/.guix-profile/lib/locale

note: type: vindex
en: grub-efi-netboot-bootloader
ru: grub-efi-bootloader

note: type: item
en: @code{terminal-outputs} (default: @code{'(gfxterm)})
ru: @code{features} (default: @code{'()})

note: type: item
en: @code{linux} (default: @code{#f})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{initrd} (default: @code{#f})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{multiboot-kernel} (default: @code{#f})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{multiboot-arguments} (default: @code{()})
ru: @code{arguments} (default: @code{'()})

note: type: item
en: @code{multiboot-modules} (default: @code{()})
ru: @code{features} (default: @code{'()})

note: type: cindex
en: resolution
ru: изоляция

note: type: deftp
en: {Data Type} grub-theme
ru: {Тип данных} build-machine

note: type: item
en: @code{gfxmode} (default: @code{'("auto")})
ru: @code{port} (default: @code{22})

note: type: deffn
en: {Scheme Procedure} grub-theme
ru: {Процедура Scheme} sane-service-type

note: type: Plain text
en: Once you have written an operating system declaration as seen in the previous section, it can be @dfn{instantiated} using the @command{guix system} command.  The synopsis is:
ru: Однажды объявленное описание операционной системы, описанное в предыдущих разделах, может быть @dfn{применено} с помощью  команды @command{guix system}. Синопсис:

note: type: Plain text
en: @var{file} must be the name of a file containing an @code{operating-system} declaration.  @var{action} specifies how the operating system is instantiated.  Currently the following values are supported:
ru: @var{file} должно быть именем файла, содержащего определение @code{operating-system}. @var{action} указывает, как воспроизводится операционная система. В настоящее время поддерживаются следующие значения:

note: type: table
en: Display available service type definitions that match the given regular expressions, sorted by relevance:
ru: Показывает доступные определения типов служб, в соответствии с указанным регулярным выражениям, отсортированные по релевантности:

note: type: table
en: As for @command{guix package --search}, the result is written in @code{recutils} format, which makes it easy to filter the output (@pxref{Top, GNU recutils databases,, recutils, GNU recutils manual}).
ru: Так же как для @command{guix package --search}, результат будет выведен в @code{recutils} формате, что делает его простым для фильтрации и вывода (@pxref{Top, GNU recutils databases, recutils, GNU recutils manual}).

note: type: table
en: Build the operating system described in @var{file}, activate it, and switch to it@footnote{This action (and the related actions @code{switch-generation} and @code{roll-back}) are usable only on systems already running Guix System.}.
ru: Собирает операционную систему описанную в @var{file}, активирует её и переключается на неё@footnote{Это действие (и связанные с ним @code{switch-generation} и @code{roll-back}) можно использовать только в системах, в которых уже работает Guix System.}.

note: type: quotation
en: It is highly recommended to run @command{guix pull} once before you run @command{guix system reconfigure} for the first time (@pxref{Invoking guix pull}).  Failing to do that you would see an older version of Guix once @command{reconfigure} has completed.
ru: Настоятельно рекомендуется запустить команду @command{guix pull} перед первым запуском @command{guix system reconfigure} (@pxref{Invoking guix pull}). В противном случае вы можете получить старую версию Guix после завершения @command{reconfigure}

note: type: table
en: 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 @code{herd restart X}).
ru: Это действие повлияет на всю конфигурацию, указанную в @var{file}: учетные записи пользователей, системные службы, глобальный список пакетов, программы setuid и т.д. Команда запустит системные службы, указанные в @var{file}, которые в данный момент не запущены; если служба в данный момент запущена, изменения вступят в силу при следующем перезапуске (например@: по @code{herd stop X} или @code{herd restart X}).

note: type: table
en: This command creates a new generation whose number is one greater than the current generation (as reported by @command{guix system list-generations}).  If that generation already exists, it will be overwritten.  This behavior mirrors that of @command{guix package} (@pxref{Invoking guix package}).
ru: Эта команда создает новое поколение, число которого на единицу больше, чем у текущего поколения (как описано @command{guix system list-generations}). Если это поколение уже существует, оно будет перезаписано. Это поведение описано в @command{guix package} (@pxref{Invoking guix package}).

note: type: table
en: It also adds a bootloader menu entry for the new OS configuration, ---unless @option{--no-bootloader} is passed.  For GRUB, it moves entries for older configurations to a submenu, allowing you to choose an older system generation at boot time should you need it.
ru: Она также добавляет пункты меню загрузчика для новой конфигурации ОС, если не передана опция @option{--no-bootloader}. Для GRUB она перемещает записи для более старых конфигураций вподменю, позволяя вам выбрать более старое поколение системы во время загрузки, если вам это понадобится.

note: type: cindex
en: provenance tracking, of the operating system
ru: трекинг источника, артефакты программного обеспечения

note: type: table
en: Upon completion, the new system is deployed under @file{/run/current-system}.  This directory contains @dfn{provenance meta-data}: the list of channels in use (@pxref{Channels}) and @var{file} itself, when available.  You can view it by running:
ru: По завершении новая система развертывается в @file{/run/current-system}. Этот каталог содержит @dfn{метаданные о происхождении}: список используемых каналов (@pxref{Channels}) и сам @var{file}, если он доступен. Вы можете просмотреть его, запустив:

note: type: table
en: This information is useful should you later want to inspect how this particular generation was built.  In fact, assuming @var{file} is self-contained, you can later rebuild generation @var{n} of your operating system with:
ru: Эта информация пригодится, если позже вы захотите проверить, как было собрано это конкретное поколение. Фактически, предполагая, что @var{file} содержит всё необходимое, вы можете позже пересобрать поколение @var{n} в вашей операционной системы с помощью:

note: type: table
en: You can think of it as some sort of built-in version control! Your system is not just a binary artifact: @emph{it carries its own source}.  @xref{Service Reference, @code{provenance-service-type}}, for more information on provenance tracking.
ru: Вы можете думать об этом как о чем-то вроде встроенного контроля версий! Ваша система теперь не просто набор двоичных файлов: @emph{она содержит свой собственный источник}. @xref{Service Reference, @code{provenance-service-type}}, для получения дополнительной информации об отслеживании происхождения.

note: type: table
en: By default, @command{reconfigure} @emph{prevents you from downgrading your system}, which could (re)introduce security vulnerabilities and also cause problems with ``stateful'' services such as database management systems.  You can override that behavior by passing @option{--allow-downgrades}.
ru: По умолчанию @command{reconfigure} @emph{препятствует откату вашей системы}, что может (пере)внести уязвимости безопасности, а также вызвать проблемы со службами "отслеживающими состояние", такими как системы управления базами данных. Вы можете переопределить это поведение, передав @option{--allow-downgrades}.

note: type: table
en: Switch to an existing system generation.  This action atomically switches the system profile to the specified system generation.  It also rearranges the system's existing bootloader menu entries.  It makes the menu entry for the specified system generation the default, and it moves the entries for the other generations to a submenu, if supported by the bootloader being used.  The next time the system boots, it will use the specified system generation.
ru: Переключает на существующее поколение системы. Эта команда атомарной операцией переключает системный профиль на указанное поколение системы. Она также изменяет порядок существующих элементов меню загрузчика системы. Она устанавливает в загрузчике запуск по умолчанию указанного поколения и перемещает другие поколения в подменю, если это поддерживается используемым загрузчиком. При следующей загрузке системы она будет использовать указанное поколение системы.

note: type: table
en: The bootloader itself is not being reinstalled when using this command.  Thus, the installed bootloader is used with an updated configuration file.
ru: Сам загрузчик не переустанавливается при использовании этой команды. Таким образом, установленный загрузчик используется с обновленным файлом конфигурации.

note: type: table
en: The target generation can be specified explicitly by its generation number.  For example, the following invocation would switch to system generation 7:
ru: Нужное поколение может быть явно указано по его номеру. Например, следующий вызов переключится на поколение 7:

note: type: table
en: The target generation can also be specified relative to the current generation with the form @code{+N} or @code{-N}, where @code{+3} means ``3 generations ahead of the current generation,'' and @code{-1} means ``1 generation prior to the current generation.'' When specifying a negative value such as @code{-1}, you must precede it with @code{--} to prevent it from being parsed as an option.  For example:
ru: Нужное поколение также может быть указано относительно текущего поколения @code{+N} или @code{-N}, где @code{+3} означает "на 3 поколения старше текущего", а @code{-1} означает "на 1 поколение младше текущего". При задании отрицательного значения @code{-1}, перед ним нужно поставить @code{--} чтобы не воспринимать его в качестве опции. Например:

note: type: table
en: Currently, the effect of invoking this action is @emph{only} to switch the system profile to an existing generation and rearrange the bootloader menu entries.  To actually start using the target system generation, you must reboot after running this action.  In the future, it will be updated to do the same things as @command{reconfigure}, like activating and deactivating services.
ru: В настоящее время результатом вызова этого действия является @emph{только} переключение профиля на существующее поколение и изменение элементов меню загрузчика. Чтобы начать использовать указанное поколение, вы должны перезагрузиться. В будущем поведение будет аналогично @command{reconfigure}, например, запуск и остановка служб.

note: type: table
en: This action will fail if the specified generation does not exist.
ru: Это действие завершится ошибкой, если указанное поколение не существует.

note: type: table
en: Switch to the preceding system generation.  The next time the system boots, it will use the preceding system generation.  This is the inverse of @command{reconfigure}, and it is exactly the same as invoking @command{switch-generation} with an argument of @code{-1}.
ru: Переключает на предыдущее поколение системы. При следующей загрузке система будет использовать предыдущее. Команда отменяет @command{reconfigure}, и делает то же самое, что @command{switch-generation} с аргументом @code{-1}.

note: type: table
en: Currently, as with @command{switch-generation}, you must reboot after running this action to actually start using the preceding system generation.
ru: В настоящее время, как и в случае с @command{switch-generation}, вы должны перезагрузиться после выполнения этого действия, чтобы фактически начать использовать предыдущее поколение системы.

note: type: table
en: Delete system generations, making them candidates for garbage collection (@pxref{Invoking guix gc}, for information on how to run the ``garbage collector'').
ru: Удаляет поколение, делая их кандидатами на для сборщика мусора (@pxref{Invoking guix gc}, для получения информации о том, как запустить "сборщик мусора").

note: type: table
en: This works in the same way as @samp{guix package --delete-generations} (@pxref{Invoking guix package, @option{--delete-generations}}).  With no arguments, all system generations but the current one are deleted:
ru: Работает так же, как и @samp{guix package --delete-generations} (@pxref{Invoking guix package, @option{--delete-generations}}). Без аргументов удаляются все системные поколения, кроме текущего:

note: type: table
en: 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.
ru: Выполнение этой команды автоматически переустановит загрузчик с обновлением меню—например, подменю "old generations" в GRUB не будет содержать удаленные поколения.

note: type: table
en: Build the derivation of the operating system, which includes all the configuration files and programs needed to boot and run the system.  This action does not actually install anything.
ru: Собирает деривацию операционной системы, которая включает в себя все файлы конфигурации и программы, необходимые для загрузки и запуска системы. Это действие на самом деле ничего не устанавливает.

note: type: table
en: 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:
ru: Наполняет указанную директорию всем необходимым для запуска операционной системы, указанным в @var{файле}. Это полезно при первой установке системы Guix. В качестве примера:

note: type: table
en: copies to @file{/mnt} all the store items required by the configuration specified in @file{my-os-config.scm}.  This includes configuration files, packages, and so on.  It also creates other essential files needed for the system to operate correctly---e.g., the @file{/etc}, @file{/var}, and @file{/run} directories, and the @file{/bin/sh} file.
ru: копирует в @file{/mnt} все элементы хранилища, необходимые для конфигурации, указанной в @file{my-os-config.scm}. Включая файлы конфигурации, пакеты и так далее. Он также создает другие важные файлы, необходимые для правильной работы системы, такие как каталоги @file{/etc}, @file{/var} и @file{/run} и файл @file{/bin/sh}.

note: type: quotation
en: 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 @file{/dev/kvm} device node must exist and be readable and writable by the user and by the build users of the daemon (@pxref{Build Environment Setup}).
ru: Параметры @code{vm} и другие, приведенные ниже, могут использовать поддержку KVM ядра Linux-libre. В частности, если машина поддерживает аппаратную виртуализацию,следует загрузить соответствующий модуль ядра KVM а файл устройства @file{/dev/kvm} должен существовать и быть доступен для чтения и записи пользователю и процессамсборки демона (@pxref{Build Environment Setup}).

note: type: table
en: Arguments given to the script are passed to QEMU as in the example below, which enables networking and requests 1@tie{}GiB of RAM for the emulated machine:
ru: Аргументы, переданные скрипту, передаются в QEMU, как в приведенном ниже примере,который включает сеть и запрашивает 1@tie{}GiB оперативной памяти для эмулируемоймашины:

note: type: table
en: The VM shares its store with the host system.
ru: Виртуальная машина использует свое хранилище совместно с хост-системой.

note: type: table
en: Additional file systems can be shared between the host and the VM using the @option{--share} and @option{--expose} command-line options: the former specifies a directory to be shared with write access, while the latter provides read-only access to the shared directory.
ru: Дополнительные файловые системы могут быть разделены между хостом и виртуальной машиной с помощью параметров @option{--share} и @option{--expose}: первый указывает директорию, к которой должен быть предоставлен общий доступ с правом на запись, последний обеспечивает доступ только на чтение.

note: type: table
en: The example below creates a VM in which the user's home directory is accessible read-only, and where the @file{/exchange} directory is a read-write mapping of @file{$HOME/tmp} on the host:
ru: Пример ниже создает виртуальную машину, которой доступна домашняя директория пользователя с правами на чтение, а директория @file{$HOME/tmp} хоста размещена в @file{/exchange} с правами на чтение и запись:

note: type: table
en: On GNU/Linux, the default is to boot directly to the kernel; this has the advantage of requiring only a very tiny root disk image since the store of the host can then be mounted.
ru: В GNU / Linux по умолчанию загрузка выполняется непосредственно в ядро; это имеет преимущество в том, что требуется только очень крошечный образ корневого диска, так как затем можно смонтировать хранилище хоста.

note: type: item
en: --image-type=@var{type}
ru: --target=@var{triplet}

note: type: table
en: For the @code{image} action, create an image of the given @var{size}.  @var{size} may be a number of bytes, or it may include a unit as a suffix (@pxref{Block size, size specifications,, coreutils, GNU Coreutils}).
ru: Если задана @var{min}, остановиться, когда @var{min} байт собрано.  @var{min} может быть числом байт или может содержать единицу измерения в суффиксе, как например, @code{MiB} для мебибайт и @code{GB} гигабайт (@pxref{Block size, size specifications,, coreutils, GNU Coreutils}).

note: type: Plain text
en: Do note that you first need to generate a key pair on the coordinator machine to allow the daemon to export signed archives of files from the store (@pxref{Invoking guix archive}), though this step is automatic on Guix System:
ru: Есть ещё одна вещь, которую нужно выполнить после размещения @file{machines.scm}. Выше описано, что при разгрузке файлы передаются вперёд и назад между складами на машинах. Для этого необходимо сгенерировать ключ-пару на кадой машине, чтобы позволить демону экспортировать подписанные архивы файлов из склада (@pxref{Invoking guix archive}):

note: type: Plain text
en: Each target machine must authorize the key of the master machine so that it accepts store items it receives from the coordinator:
ru: Каждая машина для сорки должна авторизовать ключ машины-инициатора, чтобы принимать элементы из склада, которые присылает инициатор:

note: type: example
en: # guix archive --authorize < coordinator-public-key.txt
ru: # guix archive --authorize < master-public-key.txt

note: type: deftp
en: {Data Type} machine
ru: {Тип данных} build-machine

note: type: table
en: The object of the operating system configuration to deploy.
ru: Управление конфигурацией операционной системы.

note: type: code{#1}
en: environment
ru: guix environment

note: type: item
en: @code{configuration} (default: @code{#f})
ru: @code{port} (default: @code{22})

note: type: deftp
en: {Data Type} machine-ssh-configuration
ru: {Тип данных} build-machine

note: type: item
en: @code{build-locally?} (default: @code{#t})
ru: @code{speed} (default: @code{1.0})

note: type: table
en: The system type describing the architecture of the machine being deployed to---e.g., @code{"x86_64-linux"}.
ru: Тип системы удалённой машины, то есть @code{x86_64-linux}.

note: type: item
en: @code{authorize?} (default: @code{#t})
ru: @code{port} (default: @code{22})

note: type: item
en: @code{identity} (default: @code{#f})
ru: @code{speed} (default: @code{1.0})

note: type: item
en: @code{host-key} (default: @code{#f})
ru: @code{port} (default: @code{22})

note: type: example
en: ssh-ed25519 AAAAC3Nz@dots{} root@@example.org
ru: ssh-ed25519 AAAAC3NzaC@dots{}mde+UhL hint@@example.org

note: type: item
en: @code{allow-downgrades?} (default: @code{#f})
ru: @code{port} (default: @code{22})

note: type: code{#1}
en: ssh-key
ru: host-key

note: type: lisp
en: (service guix-service-type
             (guix-configuration
               (build-accounts 5)
               (extra-options '("--gc-keep-derivations"))))
ru: (service guix-service-type
             (guix-configuration
               (build-accounts 5)
               (use-substitutes? #f)))

note: type: deffn
en: For instance, this:
ru: Например:

note: type: deffn
en: is equivalent to this:
ru: равнозачно этому:

note: type: item
en: @code{default-value} (default: @code{&no-default-value})
ru: @code{port} (default: @code{22})

note: type: item
en: channels.scm
ru: каналы

note: type: item
en: configuration.scm
ru: Конфигурирование системы

note: type: defvr
en: {Scheme Variable} linux-loadable-module-service-type
ru: {Процедура Scheme} sane-service-type

note: type: cindex
en: shepherd services
ru: сервисы shepherd

note: type: item
en: @code{requirement} (default: @code{'()})
ru: @code{features} (default: @code{'()})

note: type: item
en: procedure
ru: процедура

note: type: deftp
en: {Data Type} shepherd-configuration
ru: Конфигурирование системы

note: type: deftp
en: This data type represents the Shepherd's configuration.
ru: Управление конфигурацией операционной системы.

note: type: item
en: shepherd (default: @code{shepherd})
ru: @code{port} (default: @code{22})

note: type: table
en: The Shepherd package to use.
ru: Используемый пакет Hurd.

note: type: item
en: services (default: @code{'()})
ru: @code{features} (default: @code{'()})

note: type: Plain text
en: The following example specifies the Shepherd package for the operating system:
ru: Следующий пример порождает новую оболочку, установленную для разработки GNU@tie{}Guile:

note: type: example
en: $ man -k TLS
    SSL (7)              - OpenSSL SSL/TLS library
    certtool (1)         - GnuTLS certificate tool
    @dots {}
ru: $ man -k TLS
    SSL (7)              - OpenSSL SSL/TLS library
    certtool (1)         - GnuTLS certificate tool
    @dots{}

note: type: Plain text
en: or:
ru: или:

note: type: cindex
en: debugging files
ru: отладка файлов

note: type: cindex
en: security updates
ru: обновление безопасности

note: type: Plain text
en: @xref{Invoking guix lint}, for more information.
ru: @xref{Invoking guix lint}, для получения дополнительной информации.

note: type: Plain text
en: To verify which Bash your whole profile refers to, you can run (@pxref{Invoking guix gc}):
ru: Чтобы проверить, к какому именно Bash установлен в вашем профилt, вы можете запустить (@pxref{Invoking guix gc}):

note: type: example
en: guix gc -R $(readlink -f ~/.guix-profile) | grep bash
ru: guix gc -R `readlink -f ~/.guix-profile` | grep bash

note: type: example
en: guix gc -R $(guix system build my-config.scm) | grep bash
ru: guix gc -R `guix system build my-config.scm` | grep bash

note: type: unnumberedsec
en: Building the Build Tools
ru: Сборка инструментов сборки

note: type: Plain text
en: @image{images/bootstrap-packages,6in,,Dependency graph of the early packages}
ru: @image{images/bootstrap-packages,6in,,График зависимости ранних пакетов}

note: type: Plain text
en: The first tool that gets built with the bootstrap binaries is GNU@tie{}Make---noted @code{make-boot0} above---which is a prerequisite for all the following packages.  From there Findutils and Diffutils get built.
ru: Первый инструмент, который собирается с помощью двоичных файлов начальной загрузки, - это GNU@tie{}Make---отмеченный @code{make-boot0} выше---который является обязательным для всех следующих пакетов. После собираются Findutils и Diffutils.

note: type: Plain text
en: Then come the first-stage Binutils and GCC, built as pseudo cross tools---i.e., with @option{--target} equal to @option{--host}.  They are used to build libc.  Thanks to this cross-build trick, this libc is guaranteed not to hold any reference to the initial tool chain.
ru: Затем идут Binutils и GCC, построенные как псевдо-кросс-инструменты---т.е. с @code{--target}, равным @code{--host}. Они используются для сборки libc. Благодаря этому кросс-сборочному трюку, libc гарантированно не будет содержать никаких ссылок на начальный набор инструментов.

note: type: Plain text
en: From there the final Binutils and GCC (not shown above) are built.  GCC uses @command{ld} from the final Binutils, and links programs against the just-built libc.  This tool chain is used to build the other packages used by Guix and by the GNU Build System: Guile, Bash, Coreutils, etc.
ru: Оттуда создаются финальные версии Binutils и GCC (не показаны выше). GCC использует @code{ld} из финального Binutils и связывает программы с только что созданным libc. Эта цепочка инструментов используется для сборки других пакетов, используемых Guix и система сборки GNU: Guile, Bash, Coreutils и т.д.

note: type: Plain text
en: And voilà! At this point we have the complete set of build tools that the GNU Build System expects.  These are in the @code{%final-inputs} variable of the @code{(gnu packages commencement)} module, and are implicitly used by any package that uses @code{gnu-build-system} (@pxref{Build Systems, @code{gnu-build-system}}).
ru: И вуаля! Теперь у нас есть полный набор инструментов сборки, который ожидает система сборки GNU. Они находятся в переменной @code{%final-input} модуля @code{(gnu packages commencement)} и неявно используются любым пакетом, использующим @code{gnu-build-system} (@pxref{Build Systems, @code{gnu-build-system}}).

note: type: unnumberedsec
en: Building the Bootstrap Binaries
ru: Сборка двоичных файлов двоичной загрузки

note: type: Plain text
en: Because the final tool chain does not depend on the bootstrap binaries, those rarely need to be updated.  Nevertheless, it is useful to have an automated way to produce them, should an update occur, and this is what the @code{(gnu packages make-bootstrap)} module provides.
ru: Поскольку окончательный набор инструментов не зависит от двоичных файлов начальной загрузки, их редко требуется обновлять. Тем не менее, полезно иметь автоматический способ их создания, если произойдет обновление, и это то, что обеспечивает модуль @code{(gnu packages make-bootstrap)}.

note: type: Plain text
en: The following command builds the tarballs containing the bootstrap binaries (Binutils, GCC, glibc, for the traditional bootstrap and linux-libre-headers, bootstrap-mescc-tools, bootstrap-mes for the Reduced Binary Seed bootstrap, and Guile, and a tarball containing a mixture of Coreutils and other basic command-line tools):
ru: Следующая команда создает tar-архивы, содержащие двоичные файлы начальной загрузки (Binutils, GCC, glibc, для традиционной загрузки и linux-libre-headers, bootstrap-mescc-tools, bootstrap-mes для начальной загрузки Reduced Binary Seed, Guile и tarball содержащий смесь Coreutils и других основных инструментов командной строки):

note: type: example
en: guix build bootstrap-tarballs
ru: tar архив начальной сборки guix

note: type: Plain text
en: The generated tarballs are those that should be referred to in the @code{(gnu packages bootstrap)} module mentioned at the beginning of this section.
ru: Сгенерированные тарболы - это те, на которые нужно ссылаться в модуле @code{(gnu packages bootstrap)}, упомянутом в начале этого раздела.

note: type: Plain text
en: Still here? Then perhaps by now you've started to wonder: when do we reach a fixed point? That is an interesting question! The answer is unknown, but if you would like to investigate further (and have significant computational and storage resources to do so), then let us know.
ru: Все еще здесь? Тогда, может быть, вы задались вопросом: когда мы достигнем фиксированной точки? Это интересный вопрос! Ответ неизвестен, но если вы хотите продолжить исследование (и располагаете значительными вычислительными ресурсами для этого), сообщите нам.

note: type: unnumberedsec
en: Reducing the Set of Bootstrap Binaries
ru: Сокращение набора Bootstrap Binaries

note: type: chapter
en: Porting to a New Platform
ru: Портирование на новую платформу

note: type: include
en: contributing.texi
ru: contributing.ru.texi

note: type: Plain text
en: The Nix-based software distributions, Nixpkgs and NixOS, have also been an inspiration for Guix.
ru: Дистрибутивы, основанный на Nix, Nixpkgs and NixOS, также были источником вдохновения для Guix.

note: type: cindex
en: license, GNU Free Documentation License
ru: лицензия, GNU Free Documentation License
