更新 INDEX 对照表

4.x 的 INDEX 位於 /usr/ports/INDEX，5.x 位於 /usr/ports/INDEX-5。 INDEX 是对照 ports 所有相依等资讯的对照表，若长期未更新的话，会导致ports 对照失败。官方有定期更新 INDEX，如果 想自行更新的话，则：
cd /usr/ports/
make fetchindex

更新 INDEX HTML

FreeBSD 提供了用网页的方式来观看 ports collection，即可使用 lynx, w3m, links 或其它可浏览网页的程式来查阅。制作全部 ports collection 的方式如下：
cd /usr/ports/
make readmes  
如果是仅须要做目前目录下的资讯，或单一更新某一分类下的资讯，如 /usr/ports/ftp/ 的话，则：
cd /usr/ports/ftp/
make readme  
则仅会更新 /usr/ports/ftp/ 这个目录的资讯，其上与其下的目录皆不会更动到。 执行成功後，会在相对应的目录下产生 README.html 的档案。

更新 ports Mk

Mk (/usr/ports/Mk/) 是编译 ports 时所叁考的设定，有时若发生 ports
collections 太新，而导致 Mk 的内容不符，此时 就是应该更新 Mk 的时候了。

cd /usr/src/
make update
cd /usr/src/share/mk
make install


以关键字在ports寻找软件

如果要从全部的 ports collection 中找寻与关键字 "ldap" 有关的 ports，则：
cd /usr/ports/
make search key=ldap | grep ^Path

如果只要从与 ftp 相关的 ports 下找寻与关键字 "ldap" 有关的 ports，则：
cd /usr/ports/ftp/
make search key=ldap | grep ^Path
还有另一个用法，方法只是将 key 换成 name 。如果已经知道要搜寻 ports 的名称，或只想找名称相关的关键字 "ldap"， 则：
cd /usr/ports/
make search name=ldap | grep ^Path

如果只要从 ftp 相关的 ports 下找寻名称与关键字 "ldap" 有关的 ports，则：

cd /usr/ports/ftp/
make search name=ldap | grep ^Path


安装一个新的 port

如果系统上未安装此软体，则可以选择安装一个新的 port。以 editors/joe 为例的话，则：
cd /usr/ports/editors/joe/
make install  
如此会在系统上安装一个新的 joe 软体。如果需要在安装完成後，一并清除编辑时期所留下来的暂存目录，则：
cd /usr/ports/editors/joe/
make clean

如何得知 ports system 对某个 ports 所提供的编译叁数

所有的 ports collections 中所提供的编译叁数都会在对应的 Makefile 档案内详述，如 sysutils/portupgrade 的话，则是位在 /usr/ports/sysutils/portupgrade/Makefile 档案下。
可以对此档案浏览以得知编译时期可以下达的叁数，如对 sysutils/portupgrade 有提供 NOPORTDOCS，则：

cd /usr/ports/sysutils/portupgrade/
make -DNOPORTDOCS install 和make NOPORTDOCS=yes install 亦同那麽安装此 ports 时，会将 NOPORTDOCS 所对应的相关叁数指定进去。有时候设定较人性化的 ports 会在安装前提供叁数供选择，但是其实大部份的ports 都没有提供，因此必须自行去搜寻可编 译的叁数，在此我提供的方式如下：

cd /usr/ports/sysutils/portupgrade/
grep defined Makefile  
如此几乎可以知道所有提供的可编译叁数，虽然有时会多出一些不相干的资料，不会这个确实是一个不错可叁考的方式。

安装 ports 前查询所需依赖/相关的套件

在安装 ports 前，可以查询所需依赖/相关的套件。以 mail/p5-Mail-SpamAssassin 为例的话，则：
cd /usr/ports/mail/p5-Mail-SpamAssassin/
make all-depends-list                      #显示所有相关的套件
make pretty-print-build-depends-list          #显示编译期间所需要的套件
make pretty-print-run-depends-list            #显示此套件要执行时所需要的套件

手动加入编译 ports 的叁数

在ports collections 有提供的前提之下，有时候并不是所有该软体所支援的叁数 都会收纳在 ports collections 中，因此有时候会需要手动加入编译的叁数。如 ftp/pure-ftpd 中，如果不想把 inetd 的支援编入的选项，并没有被 ports collections 所纳入，因此必须手动加上这个 编译叁数，如下：

cd /usr/ports/ftp/pure-ftpd/
make CONFIGURE_ARGS+="--without-inetd" install

指定 ports 的安装路径

预设 ports collecions 已安排安装的路径 (/usr/local/)，如果不想将套件安装在预设路径的话，可以手动指定安装路径。 以 editors/joe 为例，则：

cd /usr/ports/editors/joe/
make PREFIX=/usr install
那么 joe 就会将档案对应在 /usr 目录下，而不是预设的 /usr/local 目录下。

只下载源码包
cd /usr/ports/editors/joe/
make fetch  
预设会将 joe 的 源码包 下载至 /usr/ports/distfiles/ 目录下。


下载安装此 ports 所有须要的其他 ports 的 源码包
cd /usr/ports/systuils/portupgrade/
make fetch-recursive
预设会将此 ports 的源码包与所有须要的其他ports 的源码包，下载至 /usr/ports/distfiles/ 目录下。

下载全部所有 ports 的 源码包
cd /usr/ports/
make fetch  
则会所将全部所有 ports 的 源码包 下载至 /usr/ports/distfiles/ 目录下。

下载全部 ftp 下所有 ports 的 源码包
cd /usr/ports/ftp/
make fetch  
则会所将全部 ftp 下所有 ports 的 源码包 下载至 /usr/ports/distfiles/目录下。
下载并解开源码包的步骤
cd /usr/ports/editors/joe/
make extract  
会将源码包解开至 /usr/ports/editors/joe/work/ 目录下。

解开源码包并补上官方提供的 patch

先补上官方提供的 patch ，再行 patch 自己的修正。以 editors/joe 为例的话，则：
cd /usr/ports/editors/joe/
make patch  
会将源码包解开至 /usr/ports/editors/joe/work/ 目录下，并已经 patch 上官方提供的 patch。

如果想要一次清掉所有 ports 产生的暂存资料，则只要回到 ports 的根目录执行即可：
cd /usr/ports/
make clean

安装一个新的 port，并将打包(package)起来

将安装完成的软体打包起来，有许多便利性：包括在丛集系统中，可供其它机器 使用，或将未来此软体出问题可重新利用此 package 重新快速安装。以 editors/joe 为例的话，则：

cd /usr/ports/editors/joe/
make package
如此会在系统上安装一个新的 joe 软体，并将此软体打包(package)起来。package 预设会在 /usr/ports/editors/joe/ 目录下，如果希望集中管理的话，建议做如下的步骤：

mkdir -p /usr/ports/packages/All/以後打包的 packages 都会存放在此目录下，并且系统会自动做分类，以方便管理。如果需要在安装完成後，一并清除编辑 时期所留下来的暂存目录，使用，如：
cd /usr/ports/editors/joe/
make package clean

打包一个 port，并将其所有相依的 ports 也打包起来

如果编辑一个 port 需要依赖其它的ports，那麽必须将其它 ports 也一起打包，否则安装 packages 会有相 依赖其它 ports 的 packages 的问题。以 sysutils/portupgrade 为例的话，则：

cd /usr/ports/sysutils/portupgrade/
make DEPENDS_TARGET=package package  
如此会在对所有 portupgrade 所相依赖的 ports 一并打包，也包括自己本身。

对一个已经安装的 port 打包

如果安装好一个套软，事前并未打包，事後想打包的话，则：
以 editors/joe 为例的话

cd /var/db/pkg/
pkg_create -b joe-{版本号}
会将已安装的 port 打包起来，放在 /var/db/pkg/ 目录下。

清理 ports 编辑期间所产生的暂存资料

在编辑 port 的时候，会有编辑期间所需要的工作目录(work)，因此通常安装好一个套件後，会清除此暂存目录，以节省系 统磁碟空间。以 editors/joe 为例的话，则：

cd /usr/ports/editors/joe/
make clean

如果是希望清除所有 ports 的暂存目录，则：
cd /usr/ports/
make clean

如果是希望清除全部 ftp 下所有的暂存目录，则：
cd /usr/ports/ftp/
make clean

清理 ports 编辑期间所产生的暂存资料，以及其相对应的源码包


make clean，仅只是清除编辑期间所需要的工作目录(work)，并没有将编译ports 时一并下载的 源码包 删除(相对应之 源码包 预设会存放在 /usr/ports/distfiles/)，如果欲把 源码包 一并删除，以 editors/joe 为例的话，则：
cd /usr/ports/editors/joe/
make distclean
make distclean 的步骤包含了 make clean 的功能，也就是说除了会删除源码包 外，还会一并清除编辑期间所产生的工作目录。

如果是希望清除所有 ports 的暂存目录，及源码包 ，则：
cd /usr/ports/
make distclean

如果是希望清除全部 ftp 下所有的暂存目录，及 源码包，则：
cd /usr/ports/ftp/
make distclean

移除已安装的 ports
以 editors/joe 为例的话，则：
cd /usr/ports/editors/joe/
make deinstall  
或是使用 pkg_delete
cd /var/db/pkg/
pkg_delete joe-{version}  
有时候套件之间的相依性会导致无法直接移除，如果要强制移除的话，则：
cd /var/db/pkg/
pkg_delete -f joe-{version}但很有可能会导致其它的套件执行起来出现问题。

一并移除所相依的 ports

以 sysutils/portupgrade 为例的话，则：
cd /usr/ports/sysutils/portupgrade/
make deinstall-depends  
执行此步骤前，请注意是否会移除应该保护的套件。
或是使用 pkg_delete
cd /var/db/pkg/
pkg_delete -r portupgrade-{version}   重新安装已安装过的 ports
重新安装的前提是，之前有安装过或目前已安装。以 editors/joe 为例的话，
则：
cd /usr/ports/editors/joe/
make deinstall
make clean
make install 或 make reinstall  

升级已安装的 ports

如果已经安装好套件，事後欲升级的话，必须先移除旧版本的 port，移除的方法以 editors/joe 为例，则：

cd /var/db/pkg/
pkg_delete joe-{version}
cd /usr/ports/editors/joe/
make install  
或是
cd /usr/ports/editors/joe/
make clean
make reinstall  

安装旧版的 ports

有时候会因为相依性，或是新版有问题，而会想装旧版本的套件。这里的方法是利用 CVS 的好处，回归到以前旧版本存在的日子，以安装旧版本的套件。首先，若我们要回复到某一个套件的版本时，需要去查询 FreeBSD ports CVS repository。最常见的就是 Freshports 网站、 FreeBSD 的 Mailing FreeBSD cvs 或是 FreeBSD ports cvsweb。
查到该套件版本所依存的日子後，就修改 CVS tag。一般预设 ports 的 CVStag 会写在 /usr/share/examples/cvsup/ports-supfile ，如要回朔到2002/10/05 号的话，则：

vi /usr/share/examples/cvsup/ports-supfile
******************************************
default date=2002.10.05.00.00.00         #将 date 改成当日然後按照一般 CVSup 的时候一样，执行 CVSup (make update)，此时的 portscollections 就会回到当时的情形，那麽该套件旧版本也会出现在 ports collections 中，只要安装即可。

如果仅是想把某部份的 ports 回朔，则必须加上额外的资讯，如仅希望把lang/perl5.8 回朔，而得知此属於 lang 中的一支，则：

vi /usr/share/examples/cvsup/ports-supfile
******************************************
ports-all #将 ports-all 标示起来ports-lang #加入这行最後，执行 CVSup，并安装即可。目前若希望单独回朔单一的 ports，则比较麻烦。

安装 ports 出现 FORCE_PKG_REGISTER 的错误讯息

問題敘述:
當你先前已經用ports 安裝過某一軟體 當你要再次透過ports 安裝同一軟體時,
很有可能會出現類似下述的錯誤訊息產生. 意思是說 你可以透過 make deinstall 解除安裝 然後透過 make reinstall來再次安裝

若你確定想要*覆蓋*此安裝 可以透過設定 FORCE_PKG_REGISTER 變數達成目標.
===>; An older version of PORTS資料夾位置 is already installed (軟體版本)
You may wish to ``make deinstall'' and install this port again
by ``make reinstall'' to upgrade it properly.
If you really wish to overwrite the old port of PORTS資料夾位置
without deleting it first, set the variable "FORCE_PKG_REGISTER"
in your environment or the "make install" command line.

處理方式:
只要在make install 時加上 FORCE_PKG_REGISTER="yes" 就可以強制安裝.
也就是: /usr/ports/資料夾位址/#make install FORCE_PKG_REGISTER="yes"


解决安装 ports 时出现 sed -i 的错误

因为 BSD style 的 sed ，也就是 BSD 本身自有的 sed ，与一些 ports 编译期间所执行的 sed 不一致，所以会导致一些语 法错误。此时先安装 sed_inplace(textproc/sed_inplace)，然後再安装原本无法安装的 ports：
cd /usr/ports/???/???/
make -DUSE_REINPLACE install  

安装 ports 出现 Shared object libintl.so.X not found 的错误讯息

Shared object "libintl.so.4" 或 (libc.so.4) not found
問題敘述:
近來的FreeBSD版本,常常在安裝某些軟體時,會出現類似的失敗畫面並且告訴你缺乏 libintl.so.4或是 libc.so.4 這個函式.
Shared object "libc.so.4" not found
如下圖:是近來版本安裝某些程式問題時常見的問題,缺少 libc.so.4 函式.

問題分析:
提到libc.so函式 首先想到的是與 linux 程式相關共享函式庫. FreeBSD在讀取相關函式前,首先會在 /compat/linux 資料夾中尋找; 然後若找不到則會嘗試搜尋 /lib 資料夾. 以 libc.so 函式為例,會先尋找/compat/linux/lib/libc.so ; 其次才是/lib/libc.so .     簡單的解決方式:
Shared object "libintl.so.4" not found
跟 libc.so 函式一樣 也是在安裝某些軟體就會出現錯誤畫面.
問題分析:
libintl.so 函式是安裝 /usr/port/devel/gettext/ 程式後取得. 理論上來說 目前版本的相關函數是 libintl.so.5 為何還要去讀取舊的 libintl.so.4 版本. 當你在安裝gmake時,gmake會去連結安裝gmake當時的libinl.so的版本,是version 4. 也就是 libintl.so.4 當你更新過相關的ports (devel/gettext) 將會用 libintl.so.5 取代 libintl.so.4 除非你能取得先前某些系統保留舊有的 libintl.so.4 否則就會出現安裝失敗狀況.

很可惜的是...有很多程式需要 gettext 函式.
你可以用 cd /usr/ports/ ; make search key="gettext" | more 查詢為什麼要加上more 因為太多怕你看到昏頭...

問題解決:
要解決這個問題 你可以透過重新建立所有與 gettext 相關的ports程式
# portupgrade -fr gettext
重新建立或重新安裝所有與 gettext相關連的程式, 若你忘掉了 請參閱 更新ports/升級系統 >; portupgrade 軟體更新或是簡單的用偷吃步 把*目前版本*link過去..QQ (版本6..類推)然後就可以順利進行程式安裝.

针对某些 ports 不做 CVSup

若 ports 底下的某些分类完全用不到，则可以在 CVSup 时，不做更新，以节省
网路频宽与时间。


# vi /usr/sup/refuse
******************************************
ports/french
ports/german
ports/hebrew
ports/hungarian
ports/japanese
那麽则上述目录下的档案皆不会更新。

如果是想要某些单一的 ports 不做同步，例如想保留旧版不做同步，或新版出现
问题时。


# vi /usr/sup/refuse
******************************************
ports/lang/perl5.8  
那麽 ports/lang/perl5.8 这个 ports 不会做 CVSup 同步。这些设定方法支援万用字元。

# vi /usr/sup/refuse
******************************************
ports/lang/perl*
ports/po*

安装 ports 出现 port is outdated 的错误讯息

例如安装 imap-uw 时，出现以下内容：
Your installation of the cclient port is outdated. Please delete it before continuing.

表示因为相对应，且已安装好的 cclient 这个软体过於老旧，建议先升级这个软
体再行安装 imap-uw。因此只要先升级 cclient 後，再安装即可。

# cd /usr/ports/mail/cclient/
# make reinstall 或 # make deinstall && make install
# cd /usr/ports/mail/imap-uw/
# make install  


安装 ports 出现 OpenSSL vulnerabilities 的错误讯息

在安装有些套件时，如果有相依於 OpenSSL 时，且判断系统目前使用的 OpenSSL 版本有漏洞问题时，会出现如下的讯息：     Dependency warning: used OpenSSL version contains known
vulnerabilities Please update or define either WITH_OPENSSL_BASE or
WITH_OPENSSL_PORT
一般建议的解决方法有二种。

第一种：升级系统(需含系统内建之 OpenSSL 一并升级)，再安装该套件可以先查询目前系统所用之 OpenSSL 的版本：
openssl version -v
升级系统可叁考 FNP: upgrade core system 或 FNP: upgrade major system。 升级完系统後，再进行一次 OpenSSL 版本之确认。然後再安装该套件，这讯息就不会出现了。

第二种：使该套件相依於 ports tree 中的 OpenSSL 这种方法会安装 ports tree 中新版本的 OpenSSL，然後相依於此新版本的OpenSSL，而不是系统本身内建的 OpenSSL。只要安装套件时，加入 WITH_OPENSSL_PORT 的叁数，即会安装 ports tree 中的 OpenSSL，并且该套件 也会相依於此。方法如下：

make -DWITH_OPENSSL_PORT install这里不建议用叁数 WITH_OPENSSL_BASE，因为这表示安装套件时，是相依於原本系统中可能有漏洞的 OpenSSL，这样会导致安全性的问题。

安装 ports 时，原本应该出现的清单选项不见了

这是由於系统会纪录曾安装过 ports 的当时所选择的清单选项，因此有时会因为安装时出了问题，或是再一次安装时，就不会出现清单可以选择。如何让清单选项重新出现呢？

make clean
make showconfig  # 显示设定的内容
make rmconfig    # 清除设定的内容
make config  
之前设定 ports 的选项预设会纪录在 /var/db/ports/{ports_name}/options 内容中。如要查看之前 python 有选择的清单选项：
cat /var/db/ports/python/options  


检查是否有安装重覆的 ports/packages

随着时间的演进，不同时间安装的软体会有不同版本的释出，而且不同软体相依的版本号也不同，所以往往会造成同一个软体安装过多版本的情形发生。这里我必须声明的是，虽然套件名称相同，可是可能没办法上下相容，因此造成有些软体必须依赖比较旧的版本，而有些软体必须依赖比较新的版本，如果有这种情形发生的话，那麽二个版本的存在是正常的。
否则的话，我们会建议移除旧版的套件，将所有相依於此套件改为相依於新版的。也就是说，移除旧版的套件，然後将原本相依於旧版的套件，改为相依於新版的套件。注意，我强调的是新旧版套件是相容的。因为这种做法有点危险，因此不提供做法，请使用更水阶的套件管理工具，如 portupgrade 来完成。检查是否有安装重覆的 ports/packages 的方法如下：

pkg_info | sort | sed -e 's/-[0-9].*$//' | uniq -c | grep -v '^[[]]*1'
如果有一行是显示" 3 libtool"，则表示目前系统有安装三种不同版本的
libtool套件。
接下来可以检查这三种版本是否可以相容：
cd /usr/ports/
make search name=libtool  
如果发现分别有三种 ports 来代表这三种不同版本的 libtool，就表示他们彼此不相容，必须保留三者，否则可能会发生相依问题。假设如下：
/usr/ports/devel/libtool13
/usr/ports/devel/libtool14
/usr/ports/devel/libtool15
反之，如果发现只有一种 ports 来代表这种不同版本的套件，则表示目前系统安装的三种版本是相容的，只要修改原本相容於其它二种版本所有的套件，并指向欲保留的那个版本，然後移除其它二种即可。如发现系统目前有安装三种不同版本的 gettext：

cd /usr/ports/
make search name=gettext  
然後检查的结果如下：
/usr/ports/devel/gettext  
则将所有相依於 gettext 旧版本的其它套件都改为相依於新版的 gettext，然後再移除系统中旧版的 gettext 即可。


`make deinstall' 与 `pkg_delete' 有什麽不同

简单来说，`make deinstall' 会移除该 port，并且不会叁照其相依/相关的 ports。 `pkg_delete' 在移除该 port 前，会叁照其相依/相关的 ports，并且 `pkg_delete' 有支援 wild card，如要移除所有 p 开头的 ports，则：

cd /var/db/pkg/
pkg_delete p*
要注意的是，如果使用 `make deinstall'，则最好确定系统目前所安装的版本，与 ports collection 中显示的版本符合，否则有可能会出现非预期性错误；而 `pkg_delete' 是因为直接删除系统中所安装的版本，所以没有此问题。

因此，换句话说，当系统所安装的版本符合 ports collections 中的版本，则可以使用 `make deinstall' 或 `pkg_delete'，否则的话最好用 `pkg_delete'。

安装 ports 出现 local modification time does not match remote 的错误讯息

这通常表示你已经下载了这个档案在 /usr/ports/distfiles 的对应目录中，但是它并不是 port collections 所期望下载的。通常的解决方法是在 /usr/ports/distfiles 的对应目录中移除此档案，再重新下载。
例如是安装 joe 时出现如下的错误讯息：
fetch: joe2.8.tar.Z: local modification time does not match remote 则将 joe2.8.tar.Z 於 /usr/ports/distfiles 中移除：
cd /usr/ports/editors/joe/
make distclean  
最後再重新安装即可

我有个问题请教
如果我已经安装了一套软件，比如xorg,
我想把它及其依赖的做成packages，该怎么做呢 ？？？
make package-recursive
前提是之前没有安装其中的包否则会有问题（我觉得这是bug，不过暂时还没有很好的解决办法）


在 FreeBSD 上模拟 Linux 的环境

最新最完整的资料在官方的 Handbook 上。

简单来说，FreeBSD 核心必须支援，且必须安装 Linux Runtime Libraries，最後做一些设定。
如果要执行 Linux ELF Binaries，可以先查询目前 FreeBSD 是否已经支援 Linux ELF。
brandelf -l
看是否有 Linux 的字样，如果没的话，请回头检查是否哪一步骤没有做到。然後检查执行档是否为 Linux ELF Binaries。

brandelf execution-binary-filename  
如果是 Linux ELF Binaries，则正常执行即可。

如果显示结果不是 Linux ELF Binaries，但是自己确定是 Linux ELF Binaries 的话，则只要更改一下 ELF 的格式即可。
brandelf -t Linux execution-binary-filename

然後再检查一次是否已经修正为正确的格式。

在 FreeBSD 上安装 Linux rpm

请确定已经成功在 FreeBSD 上模拟 Linux 的环境，安装 rpm 的方式如下：
rpm --ignoreos --root /compat/linux --dbpath /var/lib/rpm/ -Uvh xxx.rpm