FreeBSD常用命令--ports使用方法讲解

2024.05.27

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