From owner-freebsd-doc@FreeBSD.ORG Tue Mar 18 19:20:01 2008 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id C73DF1065676 for ; Tue, 18 Mar 2008 19:20:01 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (freefall.freebsd.org [IPv6:2001:4f8:fff6::28]) by mx1.freebsd.org (Postfix) with ESMTP id B7EA98FC26 for ; Tue, 18 Mar 2008 19:20:01 +0000 (UTC) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.14.2/8.14.2) with ESMTP id m2IJK1W6005476 for ; Tue, 18 Mar 2008 19:20:01 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.14.2/8.14.1/Submit) id m2IJK1Gi005475; Tue, 18 Mar 2008 19:20:01 GMT (envelope-from gnats) Resent-Date: Tue, 18 Mar 2008 19:20:01 GMT Resent-Message-Id: <200803181920.m2IJK1Gi005475@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, John Ferrell Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34]) by hub.freebsd.org (Postfix) with ESMTP id 3CC68106567C for ; Tue, 18 Mar 2008 19:13:21 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21]) by mx1.freebsd.org (Postfix) with ESMTP id 3EE6C8FC2C for ; Tue, 18 Mar 2008 19:13:21 +0000 (UTC) (envelope-from nobody@FreeBSD.org) Received: from www.freebsd.org (localhost [127.0.0.1]) by www.freebsd.org (8.14.2/8.14.2) with ESMTP id m2IJDKFo078172 for ; Tue, 18 Mar 2008 19:13:20 GMT (envelope-from nobody@www.freebsd.org) Received: (from nobody@localhost) by www.freebsd.org (8.14.2/8.14.1/Submit) id m2IJDKwR078171; Tue, 18 Mar 2008 19:13:20 GMT (envelope-from nobody) Message-Id: <200803181913.m2IJDKwR078171@www.freebsd.org> Date: Tue, 18 Mar 2008 19:13:20 GMT From: John Ferrell To: freebsd-gnats-submit@FreeBSD.org X-Send-Pr-Version: www-3.1 Cc: Subject: docs/121838: [patch] add portmaster(8) section to ports chapter of the handbook X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.5 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 18 Mar 2008 19:20:01 -0000 >Number: 121838 >Category: docs >Synopsis: [patch] add portmaster(8) section to ports chapter of the handbook >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: change-request >Submitter-Id: current-users >Arrival-Date: Tue Mar 18 19:20:01 UTC 2008 >Closed-Date: >Last-Modified: >Originator: John Ferrell >Release: 7.0 >Organization: >Environment: FreeBSD fbsd.local 7.0-RELEASE FreeBSD 7.0-RELEASE #0: Mon Mar 10 18:30:02 EDT 2008 root@fbsd.local:/usr/obj/usr/src/sys/JDF i386 >Description: Patch to add a section on portmaster(8) to the ports chapter of the handbook. Note: I submitted a patch, 'docs/121648: [patch] add portmaster(8) to man-refs.ent', that this patch relies on. >How-To-Repeat: >Fix: --- chapter.sgml.orig 2008-03-11 12:46:26.000000000 -0400 +++ chapter.sgml 2008-03-18 14:07:22.000000000 -0400 @@ -1293,6 +1293,97 @@ For further information see &man.portmanager.1;. + + + Upgrading Ports using Portmaster + + + portmaster + + + Portmaster is yet another utility for + upgrading installed ports. Portmaster + was designed make use of the tools found in the base + system (it does not depend upon any other ports) and uses the + information in /var/db/pkg/ + to determine which ports to upgrade. It is available from the + ports-mgmt/portmaster port: + + &prompt.root; cd /usr/ports/ports-mgmt/portmaster +&prompt.root; make install clean + + Portmaster groups ports into four + categories: + + + + Root ports (no dependencies, not depended on) + + + Trunk ports (no dependencies, are depended on) + + + Branch ports (have dependencies, are depended on) + + + Leaf ports (have dependencies, not depended on) + + + + You can list all the installed ports and search + for updates using the option: + +&prompt.root; portmaster -L +===>>> Root ports (No dependencies, not depended on) +===>>> ispell-3.2.06_18 +===>>> screen-4.0.3 + ===>>> New version available: screen-4.0.3_1 +===>>> tcpflow-0.21_1 +===>>> 7 root ports +... +===>>> Branch ports (Have dependencies, are depended on) +===>>> apache-2.2.3 + ===>>> New version available: apache-2.2.8 +... +===>>> Leaf ports (Have dependencies, not depended on) +===>>> automake-1.9.6_2 +===>>> bash-3.1.17 + ===>>> New version available: bash-3.2.33 +... +===>>> 32 leaf ports + +===>>> 137 total installed ports + ===>>> 83 have new versions available + + + All the installed ports can be upgraded using this simple + command: + + &prompt.root; portmaster -a + + By default, Portmaster + will make a backup package before deleting the existing port. If + the installation of the new version is successful, + Portmaster will delete the backup. + Using the will instruct + Portmaster not to automatically delete + the backup. Also, adding the option will start + Portmaster in interactive mode, prompting + you before upgrading each port. + + If you encounter errors during the upgrade process, you can use + the option to upgrade/rebuild all ports: + + &prompt.root; portmaster -af + + You can also use Portmaster to + install new ports on the system, upgrading all dependencies + before building and installing the new port: + + &prompt.root; portmaster -p /usr/ports/shells/bash + + Please see &man.portmaster.8; from more information. + >Release-Note: >Audit-Trail: >Unformatted: