Date: Sat, 16 May 2015 21:32:52 +0000 (UTC) From: Brad Davis <brd@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r46699 - head/en_US.ISO8859-1/books/handbook/ports Message-ID: <201505162132.t4GLWqJF016220@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: brd Date: Sat May 16 21:32:51 2015 New Revision: 46699 URL: https://svnweb.freebsd.org/changeset/doc/46699 Log: Note that pkg(8) uses the official mirrors by default and link to the Poudriere section for more information about building a custom repository. Clean up some man page links. Add a section about configuring Poudriere repositories and configuring pkg(8) to use them. Modified: head/en_US.ISO8859-1/books/handbook/ports/chapter.xml Modified: head/en_US.ISO8859-1/books/handbook/ports/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/ports/chapter.xml Sat May 16 16:56:01 2015 (r46698) +++ head/en_US.ISO8859-1/books/handbook/ports/chapter.xml Sat May 16 21:32:51 2015 (r46699) @@ -698,18 +698,15 @@ docbook = <programlisting>WITH_PKGNG= yes</programlisting> - <para>The <application>pkg</application> package management - system uses a package repository for most operations. The - default package repository location is defined in - <filename>/usr/local/etc/pkg.conf</filename> or by the - <envar>PACKAGESITE</envar> environment variable, which - overrides the configuration file.</para> + <para>By default <application>pkg</application> uses the &os; + package mirrors. For information about building a custom + package repository, see <xref linkend="ports-poudriere"/></para> <para>Additional <application>pkg</application> - configuration options are described in pkg.conf(5).</para> + configuration options are described in &man.pkg.conf.5;.</para> <para>Usage information for <application>pkg</application> is - available in pkg(8) or by running + available in the &man.pkg.8; manpage or by running <command>pkg</command> without additional arguments.</para> <para>Each <application>pkg</application> command argument is @@ -1319,7 +1316,7 @@ Deinstalling ca_root_nss-3.15.1_1... don <para>Installed ports can be uninstalled using <command>pkg delete</command>. Examples for using this command can be - found in <xref linkend="pkgng-intro"/>.</para> + found in the &man.pkg-delete.8; manpage.</para> <para>Alternately, <command>make deinstall</command> can be run in the port's directory:</para> @@ -1764,6 +1761,40 @@ ports-mgmt/pkg and the main web site, <link xlink:href="https://github.com/freebsd/poudriere/wiki"></link>.</para>; </sect2> + <sect2> + <title>Configuring pkg clients to use a Poudriere repository</title> + + <para>While it is possible to use both a custom repository along + side of the official repository. Sometimes it is useful to + disable the official repository. This is done by creating a + configuration file that overrides and disables the official + configuration file. Create + <filename>/usr/local/etc/pkg/repos/FreeBSD.conf</filename> + that contains the following:</para> + + <screen>FreeBSD: { + enabled: no +}</screen> + + <para>Usually it is easiest to serve a poudriere repository to the + client machines via HTTP. Setup a webserver to serve up the + package directory, usually something like: + <filename>/usr/local/poudriere/data/packages/<replaceable>10amd64</replaceable></filename>. + Where <filename>10amd64</filename> is the name of the build. + </para> + + <para>If the URL to the package repository is: + <literal>http://pkg.example.com/10amd64</literal>, then the + repository configuration file in + <filename>/usr/local/etc/pkg/repos/custom.conf</filename> would + look like:</para> + + <screen>custom: { + url: "<replaceable>http://pkg.example.com/10amd64</replaceable>", + mirror_type: "http", + enabled: yes, +}</screen> + </sect2> </sect1> <sect1 xml:id="ports-nextsteps">
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201505162132.t4GLWqJF016220>