資料來源：http://std1.mis.yzu.edu.tw/~s882617/FNP2/faq/ports_pkg.php


FNP：FAQ - Ports and Packages v 1.0

Table of Contents

  1. 如何只抓取 tarball？
  2. 如何僅做到解開 tarball的步驟？
  3. 如何僅做到解開 tarball 並補上官方提供的 patch？
  4. 如何安裝一個新的 port？
  5. 如何安裝一個新的 port，並將打包(package)起來？
  6. 如何打包一個 port，並將其所有相依的 ports 也打包起來？
  7. 如何對一個已經安裝的 port 打包？
  8. 如何清理 ports 編輯期間所產生的暫存資料？
  9. 如何在安裝 ports 前查詢所需依賴/相關的套件？
  10. 如何移除已安裝的 ports？
  11. 如何一併移除所相依的 ports？
  12. 如何重新安裝已安裝過的 ports？
  13. 如何以關鍵字搜尋 ports？
  14. 如何升級已安裝的 ports？
  15. 如何查詢目前系統安裝了哪些套件？
  16. 如何查詢目前系統有沒有安裝這個關鍵字的套件？
  17. 如何查詢某個檔案是屬於哪些套件？
  18. 如何查詢某個套件安裝了哪些檔案？
  19. 如何安裝舊版的 ports？
  20. 如何更新 ports Mk？
  21. 如何解決安裝 ports 時出現 sed -i 的錯誤？
  22. 如何列出所有可以升級的 ports？
  23. 如何得知 ports system 對某個 ports 所提供的編譯參數？
  24. 如何手動加入編譯 ports 的參數？
  25. 如何指定 ports 的安裝路徑？
  26. 安裝 ports 出現 FORCE_PKG_REGISTER 的錯誤訊息
  27. 安裝 ports 出現 Shared object libintl.so.X not found 的錯誤訊息
  28. 如何安裝 packages？
  29. 如何遠端安裝 packages？
  30. 如何更新 INDEX 對照表？
  31. 如何針對某些 ports 不做 CVSup？
  32. 如何使用 CVSup 同步 ports collections？

List

  1. 如何只抓取 tarball？

    如果只希望抓取 tarball 下來的話，僅需下 make fetch 即可。
    以 editors/joe 為例的話，則：

    cd /usr/ports/editors/joe/
    make fetch

    預設會將 joe 的 tarball 下載至 /usr/ports/distfiles/ 目錄下。


  2. 如何僅做到解開 tarball的步驟？

    有時候習慣自己 patch/修正 原始碼的時候，很常用到這個功能。
    以 editors/joe 為例的話，則：

    cd /usr/ports/editors/joe/
    make extract

    會將 tarball解開至 /usr/ports/editors/joe/work/ 目錄下。


  3. 如何僅做到解開 tarball 並補上官方提供的 patch？

    此方法與 2 有一些類似，不同於是先補上官方提供的 patch ，再行 patch 自己的修正。
    以 editors/joe 為例的話，則：

    cd /usr/ports/editors/joe/
    make patch

    會將 tarball解開至 /usr/ports/editors/joe/work/ 目錄下，並已經 patch 上官方提供的 patch。


  4. 如何安裝一個新的 port？

    如果系統上未安裝此軟體，則可以選擇安裝一個新的 port。
    以 editors/joe 為例的話，則：

    cd /usr/ports/editors/joe/
    make install

    如此會在系統上安裝一個新的 joe 軟體。如果需要在安裝完成後，一併清除編輯時期所留下來的暫存目錄，則可參考 FAQ 8 的方法，一起使用，如：

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



  5. 如何安裝一個新的 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 都會存放在此目錄下，並且系統會自動做分類，以方便管理。如果需要在安裝完成後，一併清除編輯 時期所留下來的暫存目錄，則可參考 FAQ 8 的方法，一起使用，如：

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



  6. 如何打包一個 port，並將其所有相依的 ports 也打包起來？

    因為 FAQ 5 只有對最終的 port 才進行打包，中間依賴的 ports 並沒有一起打包，這會出現一個常遇到 的問題，就是如果編輯一個 port 需要依賴其它的 ports，那麼必須將其它 ports 也一起打包，否則安裝 packages 會有相 依賴其它 ports 的 packages 的問題。
    以 sysutils/portupgrade 為例的話，則：

    cd /usr/ports/sysutils/portupgrade/
    make DEPENDS_TARGET=package package

    如此會在對所有 portupgrade 所相依賴的 ports 一併打包，也包括自己本身。


  7. 如何對一個已經安裝的 port 打包？

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

    cd /var/db/pkg/
    pkg_create -b joe-{版本號}

    會將已安裝的 port 打包起來，放在 /var/db/pkg/ 目錄下。


  8. 如何清理 ports 編輯期間所產生的暫存資料？

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

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



  9. 如何在安裝 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 #顯示此套件要執行時所需要的套件



  10. 如何移除已安裝的 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}

    但很有可能會導致其它的套件執行起來出現問題。


  11. 如何一併移除所相依的 ports？

    以 sysutils/portupgrade 為例的話，則：

    cd /usr/ports/sysutils/portupgrade/
    make deinstall-depends

    執行此步驟前，請注意是否會移除應該保護的套件。建議先參考 FAQ 9 的方法來檢查。


  12. 如何重新安裝已安裝過的 ports？

    以 editors/joe 為例的話，則：

    cd /usr/ports/editors/joe/
    make reinstall



  13. 如何以關鍵字搜尋 ports？

    如果要從全部的 ports collection 中找尋與關鍵字 "ldap" 有關的 ports，則：

    cd /usr/ports/
    make search key=ldap

    如果只要從與 ftp 相關的 ports 下找尋與關鍵字 "ldap" 有關的 ports，則：

    cd /usr/ports/ftp/
    make search key=ldap

    還有另一個用法，方法只是將 key 換成 name 。如果已經知道要搜尋 ports 的名稱，或只想找名稱相關的關鍵字 "ldap"， 則：

    cd /usr/ports/
    make search name=ldap

    如果只要從 ftp 相關的 ports 下找尋名稱與關鍵字 "ldap" 有關的 ports，則：

    cd /usr/ports/ftp/
    make search name=ldap



  14. 如何升級已安裝的 ports？

    如果已經安裝好套件，事後欲升級的話，以 editors/joe 為例，則：

    cd /usr/ports/editors/joe/
    make deinstall
    make install

    或是

    cd /usr/ports/editors/joe/
    make reinstall



  15. 如何查詢目前系統安裝了哪些套件？

    查詢目前系統已安裝的全部套件：

    pkg_info



  16. 如何查詢目前系統有沒有安裝這個關鍵字的套件？

    此方法類似 FAQ 14 ：

    pkg_info | grep



  17. 如何查詢某個檔案是屬於哪些套件？

    如果想查詢 /usr/local/bin/joe 是屬於哪個套件的話，則：

    pkg_info -W /usr/local/bin/joe

    如果沒有回傳任何資訊的話，代表著這個檔案是由 FreeBSD 內建的。


  18. 如何查詢某個套件安裝了哪些檔案？

    如果想查詢目前系統所安裝的 joe 包含了哪些檔案，則：

    pkg_info -L /var/db/pkg/joe-{version}



  19. 如何安裝舊版的 ports？

    有時候會因為相依性，或是新版有問題，而會想裝舊版本的套件。
    這裡的方法是利用 CVS 的好處，回歸到以前舊版本存在的日子，以安裝舊版本的套件。
    首先，若我們要回復到某一個套件的版本時，需要去查詢 FreeBSD ports CVS repository。
    最常見的就是 Freshports 網站、 FreeBSD ports news group， 或是 FreeBSD ports cvsweb。

    查到該套件版本所依存的日子後，就修改 CVS tag。一般預設 ports 的 CVS tag 會寫在 /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)，此時的 ports collections 就會回到當時的情形，那麼該套件 舊版本也會出現在 ports collections 中，只要安裝即可。

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

    # vi /usr/share/examples/cvsup/ports-supfile
    ******************************************
    #ports-all #將 ports-all 標示起來
    ports-lang #加入這行

    最後，執行 CVSup，並安裝即可。目前若希望單獨回朔單一的 ports，則比較麻煩。


  20. 如何更新 ports Mk？

    Mk (/usr/ports/Mk/) 是編譯 ports 時所參考的設定，有時若發生 ports collections 太新，而導致 Mk 的內容不符，此時 就是應該更新 Mk 的時候了。

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



  21. 如何解決安裝 ports 時出現 sed -i 的錯誤？

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

    cd /usr/ports/???/???/
    make -DUSE_REINPLACE install



  22. 如何列出所有可以升級的 ports？

    ports collection 的更新速度很快，在每次更新 ports collections 後，往往會出現比目前現在安裝的套件還新的版本，可 以令系統自行整理並提供可升級套件的列表：

    pkg_version -c



  23. 如何得知 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

    如此幾乎可以知道所有提供的可編譯參數，雖然有時會多出一些不相干的資料，不會這個確實是一個不錯可參考的方式。


  24. 如何手動加入編譯 ports 的參數？

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

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



  25. 如何指定 ports 的安裝路徑？

    預設 ports collecions 已安排安裝的路徑 (/usr/local/)，如果不想將套件安裝在預設路徑的話，可以手動指定安裝路徑。 以 editors/joe 為例，則：

    cd /usr/ports/editors/joe/
    make PREFIX=/usr install

    那麼 joe 就會將檔案對應在 /usr 目錄下，而不是預設的 /usr/local 目錄下。


  26. 安裝 ports 出現 FORCE_PKG_REGISTER 的錯誤訊息

    請參考 Ohaha 的 FAQ。


  27. 安裝 ports 出現 Shared object libintl.so.X not found 的錯誤訊息

    請參考 Ohaha 的 FAQ。


  28. 如何安裝 packages？

    目前 FreeBSD 的 packages 是由 .tgz 所打包。如果想安裝一個 packages ，可使用 pkg_add，如安裝一個 joe 的 tgz：

    pkg_add joe-{version}.tgz



  29. 如何遠端安裝 packages？

    有兩種設定方式，首先是 PACKAGEROOT，如：

    setenv PACKAGEROOT ftp://ftp.tw.freebsd.org #設定 PACKAGEROOT 為 ftp.tw.freebsd.org 站台

    另一種方式是設定 PACKAGESITE，好處是若該站台的 packages 倉儲並不是符合官方的設定或你想自己指定一個路徑。
    以 ftp.tw.freebsd.org i386 的 current pakcages 為例：

    setenv PACKAGESITE ftp://ftp.tw.freebsd.org/pub/FreeBSD/ports/i386/packages-current/Latest/

    兩種方式選擇其中一種皆可，接下來的步驟都一樣。
    往後要安裝 packages 的時候，如 portupgrade 的話，則：

    pkg_add -r portupgrade

    則系統會自動於 ftp.tw.freebsd.org 抓取所有與 portupgrade 相依的 packages 並安裝。


  30. 如何更新 INDEX 對照表？

    4.x 的 INDEX 位於 /usr/ports/INDEX，5.x 位於 /usr/ports/INDEX-5。
    INDEX 是對照 ports 所有相依等資訊的對照表，若長期未更新的話，會導致 ports 對照失敗。官方有定期更新 INDEX，如果 想自行更新的話，則：

    cd /usr/ports/
    make index



  31. 如何針對某些 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*



  32. 如何使用 CVSup 同步 ports collections？

    請參考 gslin 的 用 CVSup 去更新你的 source tree 以及 ports tree。

Copyright (c) 2003, Tzeng, Yi-Feng.
All Rights Reserved.