华南俳烁实业有限公司

　　這個portupgrade手冊頁是根據(jù) FreeBSD 6.2 release 的手冊頁進(jìn)行翻譯，不當(dāng)之處，懇請指正 :-)

　　PORTUPGRADE

　　Section: User Commands (1) FreeBSD

　　軟件名稱：

　　portupgrade portinstall - 通過ports或package升級安裝包或者安裝新軟件的工具軟件。

　　命令摘要：

　　portupgrade [-habcCDDefFijknNOpPPqrRsuvwWy ] [-A -file ... -command ]

　　[-B -file ... -command ] [-l -file ... -file ] [-L -file ... -format ]

　　[-S -file ... -command ] [-x -file ... -pkgname_glob ] [[-o -file ...

　　-origin ] [-m -file ... -make_args ] [-M -file ... -make_env ]

　　pkgname_glob ... ]

　　工具描述：

　　portupgrade命令的作用是通過ports或packages(二進(jìn)制軟件包)升級系統(tǒng)安裝的軟件包。portinstall命令等效于portupgrade -N。

　　在閱讀這個手冊頁之前，你必須清楚一個port/package與其他的ports/packages可能有下面兩種關(guān)系：

　　required(必須)

　　有些ports/packages是一個port/package建立或運(yùn)行的必要條件。這個軟件的port的Makefiles文件中使用 BUILD_DEPENDS 和 RUN_DEPENDS 宏分別來定義必須的建立和運(yùn)行所需要的ports/packages.

　　dependent(隸屬依賴)

　　某些ports/packages的建立或運(yùn)行需要這個port/package軟件包

　　警告：

　　請仔細(xì)閱讀這個手冊頁，知悉你利用portupgrade將要做的更新操作。

　　當(dāng)這個工具運(yùn)行提示“pkgdb -F“時，立刻運(yùn)行它。因?yàn)槿绻�本地package數(shù)據(jù)庫與當(dāng)前的ports不一致的話，當(dāng)同時升級一定數(shù)量的package時會導(dǎo)致本地package數(shù)據(jù)庫出現(xiàn)錯誤的結(jié)果。

　　自從 portupgrade 允許在不 rebuilding 和 reinstalling

　　依賴包的情況下升級系統(tǒng)安裝的package，這個工具有時會導(dǎo)致升級的軟件包與其他相關(guān)的軟件包二進(jìn)制不兼容。對付這樣的情況的方法是運(yùn)行工具時必須使

　　用 -f,-r 和 -R 命令行選項(xiàng)。

　　當(dāng)portupgrade更新package數(shù)據(jù)庫時，不要中斷這個程序。即使你沒有任何的錯誤操作，中斷這個程序會造成數(shù)據(jù)庫不完整或者造成數(shù)據(jù)庫數(shù)據(jù)

　　存在矛盾。運(yùn)行 pkgdb -fu

　　可以重新建立這個數(shù)據(jù)庫，如果不能修復(fù)，移除package數(shù)據(jù)庫文件(/var/db/pkg/pkgdb.db)。

　　養(yǎng)成定期備份你的重要數(shù)據(jù)和配置文件的習(xí)慣，包括系統(tǒng)的package數(shù)據(jù)庫文件。

　　選項(xiàng)：

　　這個工具支持以下命令行參數(shù)：

　　-h

　　--help

　　顯示help，然后退出

　　-a

　　--all

　　對所有已經(jīng)安裝的packages進(jìn)行操作，等效于使用通配符 ‘*’指定pkgname_glob

　　-A -file ... -CMD

　　--afterinstall -file ... -CMD

　　在每個軟件包安裝完之后，使用root權(quán)限運(yùn)行指定的命令

　　-b

　　--backup-packages

　　升級軟件包時保留先前版本packages的備份，保存在 PKG_TMPDIR 和 TMPDIR 環(huán)境變量指定的目錄下。

　　--batch

　　在批處理模式下運(yùn)行一個升級進(jìn)程(with BATCH=yes)。

　　-B -file ... -CMD

　　--beforebuild -file ... -CMD

　　ports軟件包在 build 之前，運(yùn)行指定的命令。如果執(zhí)行 CMD 失敗退出，這個port/package的升級將被跳過。下面是一些典型的應(yīng)用：

　　portupgrade -B 'cvs update' 'gnome*'

　　portupgrade -B 'ports_glob -M $(pwd) | (cd ../..; xargs cvs up)' slave/port

　　portupgrade -aB 'test ! `make -V IS_INTERACTIVE`'

　　-c

　　--clean

　　建立port之前執(zhí)行 "make clean",這是默認(rèn)的選項(xiàng)。參見下面的 -w 選項(xiàng)。

　　-C

　　--cleanup

　　Do “make clean ” after each installation. This is the default behavior. See the -W option below.

　　每個port安裝完成之后，執(zhí)行"make clean"，這是默認(rèn)的選項(xiàng)，參見下面的 -W 選項(xiàng)。

　　-D

　　--distclean

　　如果distfile的和校驗(yàn)失敗，刪除失敗的distfile.

　　-e

　　--emit-summaries

　　每個port處理完成后顯示摘要信息。

　　-f

　　--force

　　強(qiáng)制執(zhí)行一個package的升級，即使是降級安裝或者重新安裝同樣的版本，或者在pkgtools.conf中用 HOLD_PKGS 定義的port.

　　-F

　　--fetch-only

　　僅僅是下載distfiles或者packages(編譯好的二進(jìn)制軟件包)(如果 -P 被指定)。不進(jìn)行 build,升級,安裝等操作。這個選項(xiàng)經(jīng)常用在下載所有的distfile或package之后，進(jìn)行安裝和更新。

　　默認(rèn)情況下，ports系統(tǒng)在建立或安裝一個package失敗時，與這個package相依賴的ports/packages也將被跳過。

　　--ignore-moved

　　忽略MOVED文件

　　-i

　　--interactive

　　打開交互模式，每個port/package安裝或更新之前都要你進(jìn)行確認(rèn)，這個選項(xiàng)隱含使用 -v選項(xiàng)。

　　-j

　　--jet-mode

　　打開jet模式，這個選項(xiàng)目前還沒有實(shí)現(xiàn)。

　　-k

　　--keep-going

　　強(qiáng)制升級一個package，即使一些這個package所必須的packages安裝失敗。

　　-l -file ... -FILE