安装函数参考

以下函数由软件包管理器提供，用于处理各种与安装相关的任务。${ED} 会自动附加到安装位置之前。

当给定多个参数时，do* 函数将作用于多个目标。 new* 函数接受两个参数（除非另有说明）——第一个是源名称，第二个是安装时使用的名称。

*into 函数在目录不存在时创建目录。

函数	详情
`into`	更改 `dobin`、 `newbin`、 `dosbin`、 `newsbin`、 `dolib`、 `dolib.a`、 `newlib.a`、 `dolib.so`、 `newlib.so` 的安装位置
`insinto`	更改 `doins`、 `newins` 的安装位置
`exeinto`	更改 `doexe`、 `newexe` 的安装位置
`docinto`	更改 `dodoc`、 `newdoc` 的安装位置
`insopts`	指定传递给 `install` 的参数（例如 `-s`、 `-m644`）
`diropts`	指定传递给 `install` 的目录参数
`exeopts`	指定传递给 `install` 的可执行文件参数
`libopts`	指定传递给 `install` 的库参数注意：在 EAPI=7 中被禁用
`dobin`	将二进制文件安装到由 `into` 提供的位置的 `bin` 子目录（默认情况下为 `/usr/bin`），模式为 0755，所有权设置为超级用户或系统或当前安装的等效用户
`doconfd`	安装 `/etc/conf.d` 文件
`dodir`	安装一个在软件包合并时将非空的目录。对于将为空的目录，请使用 `keepdir`。
`dodoc`	将文档文件安装到 `/usr/share/doc/${PF}` 中。 `-r` 选项允许递归安装目录。
`einstalldocs`	使用 `dodoc -r` 将 `DOCS` 和 `HTML_DOCS` 变量指定的的文件和目录递归安装到 `/usr/share/doc/${PF}` 中。注意：在 EAPI 6 中获批。
`doenvd`	安装 `/etc/env.d` 文件
`doexe`	将可执行文件安装到由 `exeinto` 提供的位置，默认模式为 0755 或由 `exeopts` 设置的安装选项
`doheader`	将头文件安装到 `/usr/include` 中。 `-r` 选项允许递归安装目录。
`dohtml`	将 HTML 文档文件安装到 `/usr/share/doc/${PF}/html` 中。 `-r` 选项允许递归安装目录。注意：在 EAPI 6 中弃用，改用 `einstalldocs`。注意：在 EAPI=7 中被禁用
`doinfo`	安装 GNU Info 文档
`doinitd`	安装 `/etc/init.d` 文件
`doins`	安装杂项文件。 `-r` 选项允许递归安装目录。递归安装时，遇到的任何符号链接都将作为符号链接安装。
`dolib`	安装库文件注意：在 EAPI=7 中被禁用
`dolib.a`	安装库（`.a`）文件
`dolib.so`	安装库（共享对象）文件
`doman`	将手册页安装到 `/usr/share/man` 的适当部分。例如，`foo.1` 将安装在 `/usr/share/man/man1/foo.1` 中。如果手册页命名为 `foo.<lang>.1`，那么它将安装在 `/usr/share/man/<lang>/man1/foo.1` 中，其中 `<lang>` 是语言代码。选项 `-i18n=<lang>` 可用于显式指定子目录（或为空时将其抑制）。
`domo`	安装 Gettext `.mo` 文件。（EAPI=7）不再查看 `into` 的值
`dosbin`	安装 `sbin/` 文件
`dosym`	在由第二个参数指定的路径上创建指向作为第一个参数指定的 target 的符号链接。使用 `-r` 选项（EAPI 8），为 target 指定的绝对路径将转换为相对于链接位置的路径。注意：没有 `-r` 选项，绝对链接目标将按原样解释，即在适用时必须包含 `${EPREFIX}`。
`fowners`	在 `${ED}` 中指定的文件上调用 `chown`
`fperms`	在 `${ED}` 中指定的文件上调用 `chmod`
`keepdir`	安装一个在软件包合并时为空的目录。这类似于 `dodir`，但用于空目录。软件包管理器规范未定义空目录的处理方式，而 `keepdir` 函数的存在是为了确保跟踪（原本为空的）目录。这是通过将以 `.keep` 为前缀的隐藏文件安装到所讨论的目录来实现的。
`newbin`	使用第二个参数作为名称安装二进制文件
`newconfd`	使用第二个参数作为名称安装 `/etc/conf.d` 条目
`newdoc`	使用第二个参数作为名称安装文档文件
`newenvd`	使用第二个参数作为名称安装 `/etc/env.d` 文件
`newexe`	使用第二个参数作为名称安装可执行文件
`newheader`	使用第二个参数作为名称安装头文件
`newinitd`	使用第二个参数作为名称安装 `/etc/init.d` 文件
`newins`	使用第二个参数作为名称安装杂项文件
`newlib.a`	使用第二个参数作为名称安装 `.a` 库文件
`newlib.so`	使用第二个参数作为名称安装 `.so` 库文件
`newman`	使用第二个参数作为名称安装手册页
`newsbin`	使用第二个参数作为名称安装 `sbin` 文件
`docompress`	控制文件的压缩。通常执行以排除压缩，例如 `docompress -x /usr/share/doc/${PF}/examples`。
`dostrip`	控制可执行文件的剥离。通常用于排除剥离，例如 `dostrip -x /usr/$(get_libdir)/important.so`。也可以在没有 `-x` 选项的情况下使用，当 `RESTRICT=strip` 设置时，将包括要剥离的二进制文件。提供的路径相对于 `${ED}`，即使它们以斜杠开头。