这个portupgrade手册页是根据 FreeBSD 6.2 release 的手册页进行翻译，不当之处，恳请指正 :-)

　　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(二进制软件包)升级系统安装的软件包。portinstall命令等效于portupgrade -N。

　　在阅读这个手册页之前，你必须清楚一个port/package与其他的ports/packages可能有下面两种关系：

　　required(必须)

　　有些ports/packages是一个port/package建立或运行的必要条件。这个软件的port的Makefiles文件中使用 BUILD_DEPENDS 和 RUN_DEPENDS 宏分别来定义必须的建立和运行所需要的ports/packages.

　　dependent(隶属依赖)

　　某些ports/packages的建立或运行需要这个port/package软件包

　　警告：

　　请仔细阅读这个手册页，知悉你利用portupgrade将要做的更新操作。

　　当这个工具运行提示“pkgdb -F“时，立刻运行它。因为如果本地package数据库与当前的ports不一致的话，当同时升级一定数量的package时会导致本地package数据库出现错误的结果。

　　自从 portupgrade 允许在不 rebuilding 和 reinstalling

　　依赖包的情况下升级系统安装的package，这个工具有时会导致升级的软件包与其他相关的软件包二进制不兼容。对付这样的情况的方法是运行工具时必须使

　　用 -f,-r 和 -R 命令行选项。

　　当portupgrade更新package数据库时，不要中断这个程序。即使你没有任何的错误操作，中断这个程序会造成数据库不完整或者造成数据库数据

　　存在矛盾。运行 pkgdb -fu

　　可以重新建立这个数据库，如果不能修复，移除package数据库文件(/var/db/pkg/pkgdb.db)。

　　养成定期备份你的重要数据和配置文件的习惯，包括系统的package数据库文件。

　　选项：

　　这个工具支持以下命令行参数：

　　-h

　　--help

　　显示help，然后退出

　　-a

　　--all

　　对所有已经安装的packages进行操作，等效于使用通配符 ‘*’指定pkgname_glob

　　-A -file ... -CMD

　　--afterinstall -file ... -CMD

　　在每个软件包安装完之后，使用root权限运行指定的命令

　　-b

　　--backup-packages

　　升级软件包时保留先前版本packages的备份，保存在 PKG_TMPDIR 和 TMPDIR 环境变量指定的目录下。

　　--batch

　　在批处理模式下运行一个升级进程(with BATCH=yes)。

　　-B -file ... -CMD

　　--beforebuild -file ... -CMD

　　ports软件包在 build 之前，运行指定的命令。如果执行 CMD 失败退出，这个port/package的升级将被跳过。下面是一些典型的应用：

　　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之前执行 "make clean",这是默认的选项。参见下面的 -w 选项。

　　-C

　　--cleanup

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

　　每个port安装完成之后，执行"make clean"，这是默认的选项，参见下面的 -W 选项。

　　-D

　　--distclean

　　如果distfile的和校验失败，删除失败的distfile.

　　-e

　　--emit-summaries

　　每个port处理完成后显示摘要信息。

　　-f

　　--force

　　强制执行一个package的升级，即使是降级安装或者重新安装同样的版本，或者在pkgtools.conf中用 HOLD_PKGS 定义的port.

　　-F

　　--fetch-only

　　仅仅是下载distfiles或者packages(编译好的二进制软件包)(如果 -P 被指定)。不进行 build,升级,安装等操作。这个选项经常用在下载所有的distfile或package之后，进行安装和更新。

　　默认情况下，ports系统在建立或安装一个package失败时，与这个package相依赖的ports/packages也将被跳过。

　　--ignore-moved

　　忽略MOVED文件

　　-i

　　--interactive

　　打开交互模式，每个port/package安装或更新之前都要你进行确认，这个选项隐含使用 -v选项。

　　-j

　　--jet-mode

　　打开jet模式，这个选项目前还没有实现。

　　-k

　　--keep-going

　　强制升级一个package，即使一些这个package所必须的packages安装失败。

　　-l -file ... -FILE