os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Add a section about portmaster.

Browse source 
PR:		docs/121838
Submitted by:	John Ferrel
This commit is contained in:
Remko Lodder 2008-03-24 18:56:12 +00:00
parent 70801d2ee6
commit 650135e12c
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=31729
2 changed files with 92 additions and 0 deletions
en_US.ISO8859-1/books/handbook/ports
chapter.sgml
share/sgml
man-refs.ent

91
en_US.ISO8859-1/books/handbook/ports/chapter.sgml
View file

@ -1298,6 +1298,97 @@ ftp://ftp.FreeBSD.org/pub/FreeBSD/ports/distfiles/ fetch</userinput></screen>
<para>For further information see &man.portmanager.1;.</para>
</sect3>
<sect3 id="portmaster">
<title>Upgrading Ports using Portmaster</title>
<indexterm>
<primary>portmaster</primary>
</indexterm>
<para><application>Portmaster</application> is another utility for
upgrading installed ports. <application>Portmaster</application>
was designed make use of the tools found in the <quote>base</quote>
system (it does not depend upon other ports) and uses the
information in <filename class="directory">/var/db/pkg/</filename>
to determine which ports to upgrade. It is available from the
<filename role="package">ports-mgmt/portmaster</filename> port:</para>
<screen>&prompt.root; <userinput>cd <filename role="directory">/usr/ports/ports-mgmt/portmaster</filename></userinput>
&prompt.root; <userinput>make install clean</userinput></screen>
<para><application>Portmaster</application> groups ports into four
categories:</para>
<itemizedlist>
<listitem>
<para>Root ports (no dependencies, not depended on)</para>
</listitem>
<listitem>
<para>Trunk ports (no dependencies, are depended on)</para>
</listitem>
<listitem>
<para>Branch ports (have dependencies, are depended on)</para>
</listitem>
<listitem>
<para>Leaf ports (have dependencies, not depended on)</para>
</listitem>
</itemizedlist>
<para>You can list all the installed ports and search
for updates using the <option>-L</option> option:</para>
<screen>&prompt.root; <userinput>portmaster -L</userinput>
===>>> 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
</screen>
<para>All the installed ports can be upgraded using this simple
command:</para>
<screen>&prompt.root; <userinput>portmaster -a</userinput></screen>
<note><para>By default, <application>Portmaster</application>
will make a backup package before deleting the existing port. If
the installation of the new version is successful,
<application>Portmaster</application> will delete the backup.
Using the <option>-b</option> will instruct
<application>Portmaster</application> not to automatically delete
the backup. Adding the <option>-i</option> option will start
<application>Portmaster</application> in interactive mode, prompting
you before upgrading each port.</para></note>
<para>If you encounter errors during the upgrade process, you can use
the <option>-f</option> option to upgrade/rebuild all ports:</para>
<screen>&prompt.root; <userinput>portmaster -af</userinput></screen>
<para>You can also use <application>Portmaster</application> to
install new ports on the system, upgrading all dependencies
before building and installing the new port:</para>
<screen>&prompt.root; <userinput>portmaster <replaceable>shells/bash</replaceable></userinput></screen>
<para>Please see &man.portmaster.8; from more information.</para>
</sect3>
</sect2>
<sect2 id="ports-disk-space">

1
share/sgml/man-refs.ent
View file

@ -4397,6 +4397,7 @@
<!ENTITY man.pmcstat.8 "<citerefentry/<refentrytitle/pmcstat/<manvolnum/8//">
<!ENTITY man.pnpinfo.8 "<citerefentry/<refentrytitle/pnpinfo/<manvolnum/8//">
<!ENTITY man.portmap.8 "<citerefentry/<refentrytitle/portmap/<manvolnum/8//">
<!ENTITY man.portmaster.8 "<citerefentry vendor='ports'/<refentrytitle/portmaster/<manvolnum/8//">
<!ENTITY man.portsnap.8 "<citerefentry/<refentrytitle/portsnap/<manvolnum/8//">
<!ENTITY man.powerd.8 "<citerefentry/<refentrytitle/powerd/<manvolnum/8//">
<!ENTITY man.ppp.8 "<citerefentry/<refentrytitle/ppp/<manvolnum/8//">