更新 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 提供了用網(wǎng)頁的方式來觀看 ports collection，即可使用 lynx, w3m, links 或其它可瀏覽網(wǎng)頁的程式來查閱。制作全部 ports collection 的方式如下：
cd /usr/ports/
make readmes  
如果是僅須要做目前目錄下的資訊，或單一更新某一分類下的資訊，如 /usr/ports/ftp/ 的話，則：
cd /usr/ports/ftp/
make readme  
則僅會更新 /usr/ports/ftp/ 這個目錄的資訊，其上與其下的目錄皆不會更動到。 執(zhí)行成功後，會在相對應的目錄下產(chǎn)生 README.html 的檔案。

更新 ports Mk

Mk (/usr/ports/Mk/) 是編譯 ports 時所叁考的設定，有時若發(fā)生 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 。如果已經(jīng)知道要搜尋 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

如果系統(tǒng)上未安裝此軟體，則可以選擇安裝一個新的 port。以 editors/joe 為例的話，則：
cd /usr/ports/editors/joe/
make install  
如此會在系統(tǒng)上安裝一個新的 joe 軟體。如果需要在安裝完成後，一并清除編輯時期所留下來的暫存目錄，則：
cd /usr/ports/editors/joe/
make clean

如何得知 ports system 對某個 ports 所提供的編譯叁數(shù)

所有的 ports collections 中所提供的編譯叁數(shù)都會在對應的 Makefile 檔案內詳述，如 sysutils/portupgrade 的話，則是位在 /usr/ports/sysutils/portupgrade/Makefile 檔案下。
可以對此檔案瀏覽以得知編譯時期可以下達的叁數(shù)，如對 sysutils/portupgrade 有提供 NOPORTDOCS，則：

cd /usr/ports/sysutils/portupgrade/
make -DNOPORTDOCS install 和make NOPORTDOCS=yes install 亦同那麼安裝此 ports 時，會將 NOPORTDOCS 所對應的相關叁數(shù)指定進去。有時候設定較人性化的 ports 會在安裝前提供叁數(shù)供選擇，但是其實大部份的ports 都沒有提供，因此必須自行去搜尋可編 譯的叁數(shù)，在此我提供的方式如下：

cd /usr/ports/sysutils/portupgrade/
grep defined Makefile  
如此幾乎可以知道所有提供的可編譯叁數(shù)，雖然有時會多出一些不相干的資料，不會這個確實是一個不錯可叁考的方式。

安裝 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            #顯示此套件要執(zhí)行時所需要的套件

手動加入編譯 ports 的叁數(shù)

在ports collections 有提供的前提之下，有時候并不是所有該軟體所支援的叁數(shù) 都會收納在 ports collections 中，因此有時候會需要手動加入編譯的叁數(shù)。如 ftp/pure-ftpd 中，如果不想把 inetd 的支援編入的選項，并沒有被 ports collections 所納入，因此必須手動加上這個 編譯叁數(shù)，如下：

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/ 目錄下，并已經(jīng) patch 上官方提供的 patch。

如果想要一次清掉所有 ports 產(chǎn)生的暫存資料，則只要回到 ports 的根目錄執(zhí)行即可：
cd /usr/ports/
make clean

安裝一個新的 port，并將打包(package)起來

將安裝完成的軟體打包起來，有許多便利性：包括在叢集系統(tǒng)中，可供其它機器 使用，或將未來此軟體出問題可重新利用此 package 重新快速安裝。以 editors/joe 為例的話，則：

cd /usr/ports/editors/joe/
make package
如此會在系統(tǒng)上安裝一個新的 joe 軟體，并將此軟體打包(package)起來。package 預設會在 /usr/ports/editors/joe/ 目錄下，如果希望集中管理的話，建議做如下的步驟：

mkdir -p /usr/ports/packages/All/以後打包的 packages 都會存放在此目錄下，并且系統(tǒng)會自動做分類，以方便管理。如果需要在安裝完成後，一并清除編輯 時期所留下來的暫存目錄，使用，如：
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 一并打包，也包括自己本身。

對一個已經(jīng)安裝的 port 打包

如果安裝好一個套軟，事前并未打包，事後想打包的話，則：
以 editors/joe 為例的話

cd /var/db/pkg/
pkg_create -b joe-{版本號}
會將已安裝的 port 打包起來，放在 /var/db/pkg/ 目錄下。

清理 ports 編輯期間所產(chǎn)生的暫存資料

在編輯 port 的時候，會有編輯期間所需要的工作目錄(work)，因此通常安裝好一個套件後，會清除此暫存目錄，以節(jié)省系 統(tǒng)磁碟空間。以 editors/joe 為例的話，則：

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

如果是希望清除所有 ports 的暫存目錄，則：
cd /usr/ports/
make clean

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

清理 ports 編輯期間所產(chǎn)生的暫存資料，以及其相對應的源碼包


make clean，僅只是清除編輯期間所需要的工作目錄(work)，并沒有將編譯ports 時一并下載的 源碼包 刪除(相對應之 源碼包 預設會存放在 /usr/ports/distfiles/)，如果欲把 源碼包 一并刪除，以 editors/joe 為例的話，則：
cd /usr/ports/editors/joe/
make distclean
make distclean 的步驟包含了 make clean 的功能，也就是說除了會刪除源碼包 外，還會一并清除編輯期間所產(chǎn)生的工作目錄。

如果是希望清除所有 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}但很有可能會導致其它的套件執(zhí)行起來出現(xiàn)問題。

一并移除所相依的 ports

以 sysutils/portupgrade 為例的話，則：
cd /usr/ports/sysutils/portupgrade/
make deinstall-depends  
執(zhí)行此步驟前，請注意是否會移除應該保護的套件。
或是使用 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

如果已經(jīng)安裝好套件，事後欲升級的話，必須先移除舊版本的 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 網(wǎng)站、 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 的時候一樣，執(zhí)行 CVSup (make update)，此時的 portscollections 就會回到當時的情形，那麼該套件舊版本也會出現(xiàn)在 ports collections 中，只要安裝即可。

如果僅是想把某部份的 ports 回朔，則必須加上額外的資訊，如僅希望把lang/perl5.8 回朔，而得知此屬於 lang 中的一支，則：

vi /usr/share/examples/cvsup/ports-supfile
******************************************
ports-all #將 ports-all 標示起來ports-lang #加入這行最後，執(zhí)行 CVSup，并安裝即可。目前若希望單獨回朔單一的 ports，則比較麻煩。

安裝 ports 出現(xiàn) FORCE_PKG_REGISTER 的錯誤訊息

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

若你確定想要*覆蓋*此安裝 可以透過設定 FORCE_PKG_REGISTER 變數(shù)達成目標.
===>; 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 時出現(xiàn) sed -i 的錯誤

因為 BSD style 的 sed ，也就是 BSD 本身自有的 sed ，與一些 ports 編譯期間所執(zhí)行的 sed 不一致，所以會導致一些語 法錯誤。此時先安裝 sed_inplace(textproc/sed_inplace)，然後再安裝原本無法安裝的 ports：
cd /usr/ports/???/???/
make -DUSE_REINPLACE install  

安裝 ports 出現(xiàn) Shared object libintl.so.X not found 的錯誤訊息

Shared object "libintl.so.4" 或 (libc.so.4) not found
問題敘述:
近來的FreeBSD版本,常常在安裝某些軟體時,會出現(xiàn)類似的失敗畫面並且告訴你缺乏 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 .