From owner-svn-doc-all@FreeBSD.ORG Sat May 16 21:32:52 2015 Return-Path: Delivered-To: svn-doc-all@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 728C7651; Sat, 16 May 2015 21:32:52 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mx1.freebsd.org (Postfix) with ESMTPS id 6248116CE; Sat, 16 May 2015 21:32:52 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.9/8.14.9) with ESMTP id t4GLWqwB016221; Sat, 16 May 2015 21:32:52 GMT (envelope-from brd@FreeBSD.org) Received: (from brd@localhost) by svn.freebsd.org (8.14.9/8.14.9/Submit) id t4GLWqJF016220; Sat, 16 May 2015 21:32:52 GMT (envelope-from brd@FreeBSD.org) Message-Id: <201505162132.t4GLWqJF016220@svn.freebsd.org> X-Authentication-Warning: svn.freebsd.org: brd set sender to brd@FreeBSD.org using -f From: Brad Davis Date: Sat, 16 May 2015 21:32:52 +0000 (UTC) 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 X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-all@freebsd.org X-Mailman-Version: 2.1.20 Precedence: list List-Id: "SVN commit messages for the entire doc trees \(except for " user" , " projects" , and " translations" \)" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Sat, 16 May 2015 21:32:52 -0000 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 = WITH_PKGNG= yes - The pkg package management - system uses a package repository for most operations. The - default package repository location is defined in - /usr/local/etc/pkg.conf or by the - PACKAGESITE environment variable, which - overrides the configuration file. + By default pkg uses the &os; + package mirrors. For information about building a custom + package repository, see Additional pkg - configuration options are described in pkg.conf(5). + configuration options are described in &man.pkg.conf.5;. Usage information for pkg is - available in pkg(8) or by running + available in the &man.pkg.8; manpage or by running pkg without additional arguments. Each pkg command argument is @@ -1319,7 +1316,7 @@ Deinstalling ca_root_nss-3.15.1_1... don Installed ports can be uninstalled using pkg delete. Examples for using this command can be - found in . + found in the &man.pkg-delete.8; manpage. Alternately, make deinstall can be run in the port's directory: @@ -1764,6 +1761,40 @@ ports-mgmt/pkg and the main web site, . + + Configuring pkg clients to use a Poudriere repository + + 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 + /usr/local/etc/pkg/repos/FreeBSD.conf + that contains the following: + + FreeBSD: { + enabled: no +} + + 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: + /usr/local/poudriere/data/packages/10amd64. + Where 10amd64 is the name of the build. + + + If the URL to the package repository is: + http://pkg.example.com/10amd64, then the + repository configuration file in + /usr/local/etc/pkg/repos/custom.conf would + look like: + + custom: { + url: "http://pkg.example.com/10amd64", + mirror_type: "http", + enabled: yes, +} +