FreeBSD
更新 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
