GNU Guix 参考手册

Table of Contents

Next: , Up: (dir)   [Contents][Index]

GNU Guix

这份文档介绍GNU Guix版本47ea688，一个为GNU系统编写的函数式包管理器。

This manual is also available in Simplified Chinese (see GNU Guix参考手册), French (see Manuel de référence de GNU Guix), German (see Referenzhandbuch zu GNU Guix), Spanish (see Manual de referencia de GNU Guix), Brazilian Portuguese (see Manual de referência do GNU Guix), and Russian (see Руководство GNU Guix). If you would like to translate it in your native language, consider joining Weblate (see 翻译 Guix).

• 介绍  Guix是关于什么的？
• 安装  安装Guix。
• 系统安装  安装整个操作系统。
• System Troubleshooting Tips  When things don’t go as planned.
• 入门  Your first steps.
• 软件包管理  软件包安装、升级等。
• 通道  定制软件包集合。
• 开发  Guix辅助的软件开发。
• 编程接口  在Scheme里使用Guix。
• 工具  软件包管理命令。
• Foreign Architectures  Build for foreign architectures.
• 系统配置  配置操作系统。
• Home Configuration  Configuring the home environment.
• 文档  浏览软件用户手册。
• Platforms  Defining platforms.
• System Images  Creating system images.
• 安装调试文件  为调试工具提供输入。
• Using TeX and LaTeX  Typesetting.
• 安全更新  快速部署安全补丁。
• 引导  从头开始构建GNU/Linux。
• 移植  以别的平台或内核为目标。
• 贡献  你需要帮助！
• 致谢  感谢！
• GNU自由文档许可证  这个用户手册的许可证。
• 概念索引  概念。
• 编程索引  数据类型、函数和变量。 


 －－－详细的章节列表－－－



介绍
• 以Guix的方式管理软件  特殊的地方。
• GNU发行版  软件包和工具。 

安装
• 二进制文件安装  立刻运行Guix！
• 需求  构建和运行Guix需要的软件。
• 运行测试套件  测试Guix。
• 设置后台进程  准备“构建后台进程”的环境。
• 调用guix-daemon  运行后台构建进程。
• 设置应用程序  应用程序相关的设置。
• Upgrading Guix  升级 Guix 及其构建守护进程。 

设置后台进程
• 设置构建环境  准备隔离的构建环境。
• 下发工作给后台进程的设置  下发构建工作给远程的机器。
• SELinux的支持  为后台进程使用SELinux规则。 

系统安装
• 限制  你可以期待什么。
• 硬件的考虑  支持的硬件。
• U盘和DVD安装  准备安装介质。
• 准备安装  网络、分区等。
• 指导的图形安装  简单的图形安装。
• 手动安装  适合巫师的手动安装。
• 系统安装之后  当安装成功后。
• 在虚拟机里安装 Guix  Guix系统游乐场。
• 构建安装镜像  这是怎样实现的。 

System Troubleshooting Tips
• 改变目录进入现有系统  Fixing things from a chroot 

手动安装
• 键盘布局、网络和分区  初始设置。
• 继续安装步骤  安装。 

软件包管理
• 功能  Guix怎样让你的生活更美好。
• 调用guix package  软件包安装，移除等。
• substitutes  下载构建好的二进制文件。
• 有多个输出的软件包  单个输入多个输出的软件包。
• 调用guix gc  运行垃圾回收器。
• 调用guix pull  获取最新的Guix和发行版。
• Invoking guix time-machine  Running an older revision of Guix.
• Inferiors  和其它版本的Guix交互。
• 调用guix describe  显示你的Guix版本信息。
• 调用guix archive  导出和导入仓库文件。 

substitutes
• Official Substitute Servers  substitute的一个特殊来源。
• substitute服务器授权  怎么开启或关闭substitute。
• Getting Substitutes from Other Servers  substitutes多样化。
• 验证substitute  Guix怎样验证substitute。
• 代理设置  怎样通过代理获取substitute。
• substitute失败  当substitute失败时会发生什么。
• 关于信任二进制文件  你怎么能信任二进制的 blob 呢？ 

通道
• Specifying Additional Channels  拓展软件包集合。
• Using a Custom Guix Channel  Using a customized Guix.
• Replicating Guix  Running the exact same Guix.
• Channel Authentication  How Guix verifies what it fetches.
• Channels with Substitutes  Using channels with available substitutes.
• 创建一个频道  How to write your custom channel.
• Package Modules in a Sub-directory  Specifying the channel’s package modules location.
• Declaring Channel Dependencies  How to depend on other channels.
• Specifying Channel Authorizations  Defining channel authors authorizations.
• Primary URL  Distinguishing mirror to original.
• Writing Channel News  Communicating information to channel’s users. 

开发
• Invoking guix shell  Spawning one-off software environments.
• 调用guix environment  设置开发环境。
• 调用guix pack  创建软件bundle。
• The GCC toolchain  Working with languages supported by GCC.
• 调用guix git授权  Authenticating Git repositories. 

编程接口
• 软件包模块  从程序员的角度看软件包。
• 定义软件包  定义新软件包。
• Defining Package Variants  Customizing packages.
• 书写清单  The bill of materials of your environment.
• 构建系统  指定如何构建软件包。
• Build Phases  Phases of the build process of a package.
• Build Utilities  Helpers for your package definitions and more.
• Search Paths  Declaring search path environment variables.
• 仓库  操纵软件包仓库。
• Derivations  软件包derivation的底层接口。
• 仓库monad  仓库的纯函数式接口。
• G-表达式  操纵构建表达式。
• 调用guix repl  在Guile中为Guix编程
• Using Guix Interactively  Fine-grain interaction at the REPL. 

定义软件包
• 软件包引用  软件包数据类型。
• origin参考手册  origin数据类型。 

工具
• 调用guix build  用命令行构建软件包。
• 调用guix edit。  编辑软件包定义。
• 调用guix download  下载一个文件并打印它的hash。
• 调用guix hash  计算一个文件的密码学hash。
• 调用guix import  导入软件包定义。
• 调用guix refresh  更新软件包定义。
• Invoking guix style  Styling package definitions.
• 调用guix lint  从软件包定义里寻找错误。
• 调用guix size  分析硬盘使用情况。
• 调用guix graph  展示软件包的关系图。
• 调用guix publish  分享substitute。
• 调用guix challenge  挑战subtitute服务器。
• 调用guix copy  复制到远程的仓库，或从远程的仓库复制。
• 调用guix container  进程隔离。
• 调用guix weather  评估substitute的可用性。
• 调用guix processes  列出客户端进程。 

调用guix build
• 普通的构建选项  大部分命令的构建选项。
• 软件包转换选项  创建软件包的变体。
• 额外的构建选项  只属于’guix build’的选项。
• 调试构建错误  真实的打包经验。 

Foreign Architectures
• 交叉编译  Cross-compiling for another architecture.
• Native Builds  Targeting another architecture through native builds. 

系统配置
• 使用配置系统  定制你的GNU系统。
• 操作系统参考  操作系统声明详情。
• 文件系统  设置文件系统挂载。
• 映射的设备  块设备额外的处理。
• Swap Space  Backing RAM with disk space.
• 用户帐号  指定用户帐号。
• 键盘布局  系统怎样理解按键。
• 区域  语言和文化惯例设置。
• 服务  指定系统服务。
• setuid程序  Programs running with elevated privileges.
• X.509证书  认证HTTPS服务器。
• Name Service Switch  设置libc的name service switch。
• 初始的内存虚拟硬盘  Linux-Libre引导。
• 引导设置  设置引导程序。
• 调用guix system  实例化一个系统配置。
• 调用 guix deploy  Deploying a system configuration to a remote host.
• 在虚拟机里运行Guix  怎样在虚拟机里运行Guix。
• 定义服务  添加新的服务定义。 

Home Environment Configuration
• Invoking guix home  Instantiating a home environment configuration. 

服务
• 基础服务  必要的系统服务。
• 执行计划任务  mcron服务。
• 日志轮替  rottlog服务。
• Networking Setup  配置网络接口。
• 网络服务  防火墙，SSH后台进程等。
• Unattended Upgrades  Automated system upgrades.
• X窗口  图形显示器。
• 打印服务  本地和远程打印机的支持。
• 桌面服务  D-Bus和桌面服务。
• 声音服务  ALSA和Pulseaudio服务。
• 数据库服务  SQL数据库，键值仓库等。
• 邮件服务  IMAP，POP3，SMTP等。
• 消息服务  消息服务。
• 电话服务  电话服务。
• 监控服务  监控服务。
• Kerberos服务  Kerberos服务。
• LDAP Services  LDAP services.
• Web服务  Web服务。
• 证书服务  Let’s Encrypt TLS证书。
• DNS服务  DNS后台进程。
• VPN服务  VPN后台进程。
• 网络文件系统  网络文件系统相关的服务。
• Samba Services  Samba services.
• 持续集成  Cuirass and Laminar services.
• 电源管理服务  延长电池寿命。
• 音频服务  MPD。
• 虚拟化服务  虚拟化服务。
• 版本控制服务  远程访问Git仓库。
• 游戏服务  游戏服务器。
• PAM Mount Service  Service to mount volumes when logging in.
• Guix Services  Services relating specifically to Guix.
• Linux Services  Services tied to the Linux kernel.
• Hurd Services  Services specific for a Hurd System.
• 其它各种服务  其它服务。 

定义服务
• 合成服务  服务合成的模型。
• 服务类型和服务  类型和服务。
• 服务参考  API参考。
• Shepherd服务  一种特别的服务。
• Complex Configurations  Defining bindings for complex configurations. 

Platforms
• platform Reference  Detail of platform declarations.
• Supported Platforms  Description of the supported platforms. 

System Images
• image Reference  Detail of image declarations.
• Instantiate an Image  How to instantiate an image record.
• image-type Reference  Detail of image types declaration.
• Image Modules  Definition of image modules. 

安装调试文件
• Separate Debug Info  安装“调试”输出
• Rebuilding Debug Info  Building missing debug info. 

引导
• Reduced Binary Seed Bootstrap  A Bootstrap worthy of GNU.
• Preparing to Use the Bootstrap Binaries  Building that what matters most.

Next: , Up: (dir)   [Contents][Index]