用户指南 - 5. Fink 配置文件

本章会解释 Fink 配置文件（fink.conf）中的设置项，以及他们会对 Fink 的工作产生什么作用，尤其是 fink 命令行工具（也就是说使用源代码发布版本）。

5.1 关于 fink.conf

在 Fink 安装的时候，它会询问你几个问题以建立起你的配置文件，就好像选择你希望使用来下载文件的镜像网站以及如何获得超级用户权限。你可以用fink configure 命令来重新进行这个过程。而有一些选项，则需要直接编辑 fink.conf 文件。通常来说，这些选项对于熟练用户才会有用。

fink.conf 文件的位置在 /opt/sw/etc/fink.conf，它可以用你喜欢的纯文本编辑器来编辑它。要编辑它，你需要超级用户的权限。

5.2 fink.conf 文件的语法

你的 fink.conf 文件由多行组成，格式是：

选项名: 选项值

每行一个选项，选项名和选项值之间以一个冒号和一个空格分开。选项值的内容取决每个不同的选项，但通常会是一个布尔值（"True" 或 "False"），一个字符串，或用空格分开的多个字符串。例如：

BooleanOption: True
StringOption: Something
ListOption: Option1 Option2 Option3

5.3 必需的设置

fink.conf 文件里面的一些设置是不可缺的。如果缺少它们，Fink 就无法正常工作。下面的设置就属于这一类。

Basepath: 路径

它告诉 Fink 它被安装在什么位置。默认的情况是 /opt/sw，除非你在第一次安装的时候更改了它的位置。安装以后，你决不能再更改这个设置，否则会使 fink 陷入混乱中。

5.4 可选用户设置

有很多设置用户可以进行调整，来对 Fink 进行优化。

RootMethod: su 或 sudo 或 none

对一些操作，Fink 需要有超级用户权限。可供选择的选项包括 sudo 或 su。你也可以把它设为 none，这时，你需要自己转换到 root 权限后再运行 Fink。默认值是 sudo，多数情况下这不应该修改。
Trees: 代码树列表

可供选择的代码树包括：
```
local/main      - 所有你希望安装的本地软件包
local/bootstrap - Fink　安装过程需要使用的软件包
stable/crypto   - 稳定的可靠（经过数字签名）软件包
stable/main     - 其它稳定软件包
unstable/crypto - 未稳定的可靠（经过数字签名）软件包
unstable/main   - 其它未稳定软件包
```
你可以根据需要在　/opt/sw/fink/dists　目录中加入你自己的代码树，但通常来说不需要这样做。默认的代码树是 "local/main local/bootstrap　stable/main"。这个设置清单应该与 /opt/sw/etc/apt/sources.list 文件内容保持一致。 (As of fink 0.21.0, fink does this for you automatically.)

The order of the trees is meaningful, as packages from later trees in the list may override packages from earlier ones.
Distribution: 10.1、10.2、10.2-gcc3.3, 10.3 或 10.4

Fink 需要知道你使用的 Mac OS X 版本是什么。10.0 或更早的版本不能够被支持，从这个版本的 Fink 开始，10.1 或 10.2 也不被支持。 Mac OS X 10.2 users are restricted to fink-0.24.7, released in June 2005. 这个字段是通过运行 /opt/sw/lib/fink/postinstall.pl 来设置的。你不应该手工改变这个设置值。
FetchAltDir: 路径

通常来说 fink 会保存它下载的源代码到 /opt/sw/src　目录中。你可以用这个选项来更换保存下载源程序的目录。例如：
```
FetchAltDir: /usr/src
```
Verbose: 0 到 3　之间的数字

这个选项设置 Fink 应该在运行过程中告诉你详细到什么程度的信息。取值的含义是： 0 Quiet (安静模式)（不显示下载状态） 1 Low (低模式)（不显示正在展开的压缩档的信息） 2 Medium (中模式)（几乎显示所有信息） 3 High (高模式)（显示所有信息）默认值是 1。
SkipPrompts: a comma-delimited list
(fink-0.25 and later) This option instructs fink to refrain from asking for input when the user does not want to be prompted. Each prompt belongs to a category. If a prompt's category is in the SkipPrompts list then the default option will be chosen within a very short period of time.
Currently, the following categories of prompts exist:
fetch - Downloads and mirrors
virtualdep - Choosing between alternative packages
By default, no prompts are skipped.
NoAutoIndex: 布尔值

Fink 会缓存它的软件包描述文件在 /opt/sw/var/db/fink.db 中，这会减少每次运行时读取和解析这些文件的时间。除非这个值被设成 "True"，否则 Fink 会每次都检查软件包的索引时候需要更新。默认情况下它被设成 "False"。我们不推荐你更改它。如果你真的改动了它，你需要手工运行　fink index 命令来更新索引。
SelfUpdateNoCVS: 布尔值

fink selfupdate　命令会更新 Fink软件管理器到最新的版本。当这个选项设为 True 的时候，将保证不会使用协作式版本管理系统（CVS）来更新软件包。它由 fink　selfupdate-cvs 命令自动设置，所以你不需要手工改变它。
Buildpath: 路径

Fink 在从源代码编译的时候，需要创建几个临时的目录。默认情况下，它们被放置在 /opt/sw/src (on Panther and earlier) 下， /opt/sw/src/fink.build (on Tiger) 下，不过，如果你想把它们放在其它地方的话，可以在这里指明路径。查阅本文档后面关于 KeepRootDir 和 KeepBuildDir 字段的描述获取关于这个临时目录的更多信息 (Developer Settings)。

On Tiger, it is recommended that the Buildpath end with .noindex or .build. Otherwise, Spotlight will attempt to index the temporary files in the Buildpath, slowing down builds.
Bzip2Path: the path to your bzip2 (or compatible) binary
(fink-0.25 and later) The Bzip2Path option lets you override the default path for the bzip2 command-line tool. This allows you to specify an alternate location to your bzip2 executable, pass optional command-line options, or use a drop-in replacement like pbzip2 for decompressing .bz2 archives.

5.5 下载设置

有几个设置会影响 Fink 下载软件包数据的方式。

ProxyPassiveFTP: 布尔值

这个选项使得 Fink 使用 "被动" 模式来进行 FTP 下载。某些 FTP 服务器或网络配置会要求这个设置必须为。建议永远保持这个选项为打开，因为主动模式的 FTP 已经过时了。
ProxyFTP: url

如果你使用 FTP 代理，那么你应该这里输入它的地址，例如：
```
ProxyFTP: ftp://yourhost.com:2121/
```
留空这一项，如果你不需要使用 FTP 代理。
ProxyHTTP: url

如果你使用 HTTP 代理，那么你应该在这里输入它的地址，例如：
```
ProxyHTTP: http://yourhost.com:3128/
```
留空这一项，如果你不需要使用 HTTP 代理。
DownloadMethod: wget 或 curl 或 axel 或 axelautomirror

Fink 可以使用三种不同的程序来从网上下载程序 —— wget，curl 或 axel。而 axelautomirror 会使用 axel 的一种实验中的模式，这种模式会自动检测包含你要下载的文件的离你最近的服务器。目前不推荐使用 axelmirror。默认值是 curl。 你这里选择的程序必须已经安装在你的计算机上！ (i.e. finkwon't fall back to curl if you try to use a download application that isn't present.
SelfUpdateMethod: point, rsync or git

fink can use some different methods to update the package info files. rsync is the recommended setting; it uses rsync to download only modified files in the trees that you have enabled. Note that if you have changed or added to files in the stable or unstable trees, using rsync will delete them. Make a backup first, e.g. in your local tree. git will download using anonymous or Github access from the Fink repository. This has the disadvantage that git can not switch mirrors; if the server is unavailable you will not be able to update. point will download only the latest released version of the packages. It is not recommended as your packages may be quite out of date.
SelfUpdateCVSTrees: list of trees
(fink-0.25 and later) By default, the cvs selfupdate method will update only the current distribution's tree. This option overrides the list of distribu- tion versions that will be updated during a selfupdate. Please note that you will need a recent "cvs" binary installed if you wish to include directories that do not have CVS/ directories in their entire path (e.g., dists/local/main or similar).
UseBinaryDist: boolean

Causes fink to try to download pre-compiled binary packages from the binary distribution if available and if the binary package is not already on the system. This can save a lot of installation time and it is therefore recommended to set this option. Passing fink the --use-binary-dist option (or the -b flag) has the same effect, but only operates on that single fink invocation. Passing fink the --no-use-binary-dist flag overrides this, and compiles from source for that single fink invocation. Only available as of fink version 0.23.0.
Note that this mode instructs fink to download an available binary if that version is the latest available version of the package; it does not cause fink to choose a version based on its binary availability.

5.6 镜像站点设置

从网上获取软件可能会是一个冗长的过程。经常下载的速度不会象我们所希望的那样快。镜像服务器会从其它服务器中拷贝文件，但可能它会有一个更快的网络连接，或者它在地理上离你更近，这样从它上面下载会更快些。同时它们也可以分担主服务器的负担，其中一个例子是ftp.gnu.org，在一个访问不到的时候，它会提供另一个替代的服务器。

为了让 Fink 能够使用最合适你的镜像服务器，你要告诉它你居住在哪个洲和哪个国家。如果不能从某个服务器下载，它会提示你是：重试相同的镜像站点，连接与你在相同国家或洲的另一个镜像服务器，还是世界上任意一个镜像服务器。

fink.conf 文件中保存着你希望使用哪些镜像服务器的信息。

MirrorContinent: 三个字母的代号

你应该使用 fink configure 命令来更改这些取值。三个字母的代号可以在 /opt/sw/lib/fink/mirror/_keys 文件中找到。例如，如果你住在亚洲：
```
MirrorContinent: asi
```
MirrorCountry: 六个字母代号

你应该使用 fink configure 命令来更改这些取值。六个字母由三个字母的洲代号（见上面的描述），一个减号，以及两个字母的国家代号组成。你可以在 /opt/sw/lib/fink/mirror/_keys 文件中找到它们。例如，如果你住在中国：
```
MirrorCountry: asi-CN
```
MirrorOrder: MasterFirst 或 MasterLast 或 MasterNever 或 ClosestFirst

Fink 支持 '主（master）镜像服务器'，它镜像保存了 Fink 中有的所有软件包的源程序压缩档。使用主镜像服务器的好处是下载源程序的链接不会失效。用户可以选择使用这些由 Fink 团队维护的镜像服务器，或使用那些原始的源程序站点和外部的镜像服务器：例如 gnome，KDE 和　debian 的镜像网站。另外，用户还可以选择结合两种设置，并按上文所说的办法以邻近的次序来进行搜索。如果使用 MasterFirst 或 MasterLast 选项，当某个服务器失效时，用户可以“跳转到”到主服务器（或非主服务器）组。选项包括：
```
MasterFirst - 优先搜索 "主" 镜像服务器。
MasterLast - 最后搜索 "主" 镜像服务器。
MasterNever - 不搜索 "主" 镜像服务器。
ClosestFirst - 优先搜索最近的镜像服务器（把所有镜像服务器合在一组）。
```
Mirror-rsync:
(fink-0.25.2 and later) When doing fink selfupdate with the SelfupdateMethod set to rsync, this is the rsync url to sync from. This should be an anonymous rsync url, pointing to a directory which contains all the fink Dis- trubutions and Trees.

5.7 开发人员设置

在 fink.conf 中一些选项只是对开发人员有用。我们不推荐 Fink 用户修改它们。下面的一些选项属于这一类。

KeepRootDir: 布尔值

使得 fink 不会在构建好一个软件包以后删除 root-[name]-[version]-[revision] 目录会在 BuildPath。默认值是 False。注意，使用这个选项可以很快塞满你的硬盘！ 传递 -K 标志给 fink 可以起到相同的效果，但只对单次的 fink 调用起作用。
KeepBuildDir: boolean

使得 Fink 不会在构建好一个软件包以后删除 [name]-[version]-[revision] 目录会在 BuildPath。默认值是 False。注意，使用这个选项可以很快塞满你的硬盘！ 传递 -K 标志给 fink 可以起到相同的效果，但只对单次的 fink 调用起作用。

5.8 Advanced Settings

There are some other options which may be useful, but require some knowledge to get right.

MatchPackageRegEx:

Causes fink not to ask which package to install if one (and only one) of the choices matches the perl Regular Expression given here. Example:
```
MatchPackageRegEx: (.*-ssl$|^xfree86$|^xfree86-shlibs$)
```
will match packages ending in '-ssl', and will match 'xfree86' and 'xfree86-shlibs' exactly.
CCacheDir: path

If the Fink package ccache-default is installed, the cache files it makes while building Fink packages will be placed here. Defaults to /opt/sw/var/ccache. If set to none, fink will not set the CCACHE_DIR environment variable and ccache will use $HOME/.ccache, potentially putting root-owned files into your home directory. Only available in fink newer than version 0.21.0.
NotifyPlugin: plugin
Specify a notification plugin to tell you when packages have been installed/uninstalled. Defaults to Growl (requires Mac::Growl to operate). Other plugins can be found in the /opt/sw/lib/perl5/Fink/Notify directory.
AutoScanpackages: boolean
When fink builds new packages, apt-get does not immediately know about them. Historically, the command fink scanpackages had to be run for apt-get to notice the new packages, but now this happens auto matically. If this option is present and false, then fink scanpackages will no longer be run automatically after packages are built. Defaults to true.
ScanRestrictivePackages: boolean
When scanning the packages for apt-get, fink normally scans all packages in the current trees. However, if the resuting apt repository will be made publically available, the administrator may be legally obligated not to include packages with Restrictive or Commercial licenses. If this option is present and false, then Fink will omit those packages when scanning.

5.9 Managing apt's sources.list file

Starting with fink 0.21.0, fink actively manages the file /opt/sw/etc/apt/sources.list which is used by apt to locate binary files for installation. The default sources.list file looks something like this, adjusted to match your Distribution and Trees:

# Local modifications should either go above this line, or at the end.
#
# Default APT sources configuration for Fink, written by the fink program

# Local package trees - packages built from source locally
# NOTE: this is automatically kept in sync with the Trees: line in 
# /opt/sw/etc/fink.conf
# NOTE: run 'fink scanpackages' to update the corresponding Packages.gz files
deb file:/opt/sw/fink local main
deb file:/opt/sw/fink stable main crypto

# Official binary distribution: download location for packages
# from the latest release
deb http://us.dl.sourceforge.net/fink/direct_download 10.3/release main crypto

# Official binary distribution: download location for updated
# packages built between releases
deb http://us.dl.sourceforge.net/fink/direct_download 10.3/current main crypto

# Put local modifications to this file below this line, or at the top.

With this default file, apt-get first looks in your local installation for already-compiled binaries, and then looks in the official binary distribution. You can alter this by making entries at the beginning of the file (which will be searched first) or at the end of the file (which will be searched last).

If you change your Trees line or the Distribution you are using, fink will automatically modify the "default" portion of the file to correspond to the new values. Fink will, however, preserve any local modifications you have made to the file, provided that you confine your modifications to the top of the file (above the first default line) and the bottom of the file (below the last default line).

Note: If you had modified /opt/sw/etc/apt/sources.list prior to upgrading to fink 0.21.0, you will find your former file stored at /opt/sw/etc/apt/sources.list.finkbak .

Next: 6. 在命令行使用 Fink 工具