From owner-svn-doc-head@freebsd.org Wed Aug 5 11:02:13 2020 Return-Path: Delivered-To: svn-doc-head@mailman.nyi.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2610:1c1:1:606c::19:1]) by mailman.nyi.freebsd.org (Postfix) with ESMTP id 2ECFC371E99; Wed, 5 Aug 2020 11:02:13 +0000 (UTC) (envelope-from bcr@FreeBSD.org) Received: from mxrelay.nyi.freebsd.org (mxrelay.nyi.freebsd.org [IPv6:2610:1c1:1:606c::19:3]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256 client-signature RSA-PSS (4096 bits) client-digest SHA256) (Client CN "mxrelay.nyi.freebsd.org", Issuer "Let's Encrypt Authority X3" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id 4BM7xK08sjz4gZs; Wed, 5 Aug 2020 11:02:13 +0000 (UTC) (envelope-from bcr@FreeBSD.org) Received: from repo.freebsd.org (repo.freebsd.org [IPv6:2610:1c1:1:6068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (Client did not present a certificate) by mxrelay.nyi.freebsd.org (Postfix) with ESMTPS id DBFCA14EE9; Wed, 5 Aug 2020 11:02:12 +0000 (UTC) (envelope-from bcr@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id 075B2Cp6072391; Wed, 5 Aug 2020 11:02:12 GMT (envelope-from bcr@FreeBSD.org) Received: (from bcr@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id 075B2CIl072390; Wed, 5 Aug 2020 11:02:12 GMT (envelope-from bcr@FreeBSD.org) Message-Id: <202008051102.075B2CIl072390@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: bcr set sender to bcr@FreeBSD.org using -f From: Benedict Reuschling Date: Wed, 5 Aug 2020 11:02:12 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r54395 - head/en_US.ISO8859-1/books/handbook/ports X-SVN-Group: doc-head X-SVN-Commit-Author: bcr X-SVN-Commit-Paths: head/en_US.ISO8859-1/books/handbook/ports X-SVN-Commit-Revision: 54395 X-SVN-Commit-Repository: doc MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.33 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 05 Aug 2020 11:02:13 -0000 Author: bcr Date: Wed Aug 5 11:02:12 2020 New Revision: 54395 URL: https://svnweb.freebsd.org/changeset/doc/54395 Log: Remove references to portsnap for newer FreeBSD versions. Provide instructions around the existing references for portsnap about how to fetch ports for FreeBSD versions after 12.1 or 11.4, respectively. While here: - replace a stray public address with a RFC1918 private address - move a plural outside of the tags - update FreeBSD versions in poudriere examples Submitted by: pauamma_gundo.com Approved by: bcr Differential Revision: https://reviews.freebsd.org/D25800 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 Tue Aug 4 08:47:17 2020 (r54394) +++ head/en_US.ISO8859-1/books/handbook/ports/chapter.xml Wed Aug 5 11:02:12 2020 (r54395) @@ -829,7 +829,7 @@ security/sudo Using the Ports Collection The Ports Collection is a set of - Makefiles, patches, and description files. + Makefiles, patches, and description files. Each set of these files is used to compile and install an individual application on &os;, and is called a port. @@ -848,7 +848,8 @@ security/sudo The base system of &os; includes Portsnap. This is a fast and user-friendly tool for retrieving the Ports Collection and - is the recommended choice for most users. This utility + is the recommended choice for most users not running + &os.current;. This utility connects to a &os; site, verifies the secure key, and downloads a new copy of the Ports Collection. The key is used to verify the integrity of all downloaded files. @@ -890,7 +891,7 @@ security/sudo Subversion Method If more control over the ports tree is needed or if local - changes need to be maintained, + changes need to be maintained, or if running &os.current;, Subversion can be used to obtain the Ports Collection. Refer to the @@ -1563,53 +1564,55 @@ The deinstallation will free 229 kB amd64. The default is the architecture shown by uname. - &prompt.root; poudriere jail -c -j 10amd64 -v 10.0-RELEASE -====>> Creating 10amd64 fs... done -====>> Fetching base.txz for FreeBSD 10.0-RELEASE amd64 -/poudriere/jails/10amd64/fromftp/base.txz 100% of 59 MB 1470 kBps 00m42s -====>> Extracting base.txz... done -====>> Fetching src.txz for FreeBSD 10.0-RELEASE amd64 -/poudriere/jails/10amd64/fromftp/src.txz 100% of 107 MB 1476 kBps 01m14s -====>> Extracting src.txz... done -====>> Fetching games.txz for FreeBSD 10.0-RELEASE amd64 -/poudriere/jails/10amd64/fromftp/games.txz 100% of 865 kB 734 kBps 00m01s -====>> Extracting games.txz... done -====>> Fetching lib32.txz for FreeBSD 10.0-RELEASE amd64 -/poudriere/jails/10amd64/fromftp/lib32.txz 100% of 14 MB 1316 kBps 00m12s -====>> Extracting lib32.txz... done -====>> Cleaning up... done -====>> Jail 10amd64 10.0-RELEASE amd64 is ready to be used + &prompt.root; poudriere jail -c -j 11amd64 -v 11.4-RELEASE +[00:00:00] Creating 11amd64 fs at /poudriere/jails/11amd64... done +[00:00:00] Using pre-distributed MANIFEST for FreeBSD 11.4-RELEASE amd64 +[00:00:00] Fetching base for FreeBSD 11.4-RELEASE amd64 +/poudriere/jails/11amd64/fromftp/base.txz 125 MB 4110 kBps 31s +[00:00:33] Extracting base... done +[00:00:54] Fetching src for FreeBSD 11.4-RELEASE amd64 +/poudriere/jails/11amd64/fromftp/src.txz 154 MB 4178 kBps 38s +[00:01:33] Extracting src... done +[00:02:31] Fetching lib32 for FreeBSD 11.4-RELEASE amd64 +/poudriere/jails/11amd64/fromftp/lib32.txz 24 MB 3969 kBps 06s +[00:02:38] Extracting lib32... done +[00:02:42] Cleaning up... done +[00:02:42] Recording filesystem state for clean... done +[00:02:42] Upgrading using ftp +/etc/resolv.conf -> /poudriere/jails/11amd64/etc/resolv.conf +Looking up update.FreeBSD.org mirrors... 3 mirrors found. +Fetching public key from update4.freebsd.org... done. +Fetching metadata signature for 11.4-RELEASE from update4.freebsd.org... done. +Fetching metadata index... done. +Fetching 2 metadata files... done. +Inspecting system... done. +Preparing to download files... done. +Fetching 124 patches.....10....20....30....40....50....60....70....80....90....100....110....120.. done. +Applying patches... done. +Fetching 6 files... done. +The following files will be added as part of updating to +11.4-RELEASE-p1: +/usr/src/contrib/unbound/.github +/usr/src/contrib/unbound/.github/FUNDING.yml +/usr/src/contrib/unbound/contrib/drop2rpz +/usr/src/contrib/unbound/contrib/unbound_portable.service.in +/usr/src/contrib/unbound/services/rpz.c +/usr/src/contrib/unbound/services/rpz.h +/usr/src/lib/libc/tests/gen/spawnp_enoexec.sh +The following files will be updated as part of updating to +11.4-RELEASE-p1: +[…] +Installing updates...Scanning //usr/share/certs/blacklisted for certificates... +Scanning //usr/share/certs/trusted for certificates... + done. +11.4-RELEASE-p1 +[00:04:06] Recording filesystem state for clean... done +[00:04:07] Jail 11amd64 11.4-RELEASE-p1 amd64 is ready to be used - &prompt.root; poudriere ports -c -p local -====>> Creating local fs... done -====>> Extracting portstree "local"... -Looking up portsnap.FreeBSD.org mirrors... 7 mirrors found. -Fetching public key from ec2-eu-west-1.portsnap.freebsd.org... done. -Fetching snapshot tag from ec2-eu-west-1.portsnap.freebsd.org... done. -Fetching snapshot metadata... done. -Fetching snapshot generated at Tue Feb 11 01:07:15 CET 2014: -94a3431f0ce567f6452ffde4fd3d7d3c6e1da143efec76100% of 69 MB 1246 kBps 00m57s -Extracting snapshot... done. -Verifying snapshot integrity... done. -Fetching snapshot tag from ec2-eu-west-1.portsnap.freebsd.org... done. -Fetching snapshot metadata... done. -Updating from Tue Feb 11 01:07:15 CET 2014 to Tue Feb 11 16:05:20 CET 2014. -Fetching 4 metadata patches... done. -Applying metadata patches... done. -Fetching 0 metadata files... done. -Fetching 48 patches. -(48/48) 100.00% done. -done. -Applying patches... -done. -Fetching 1 new ports or files... done. -/poudriere/ports/tester/CHANGES -/poudriere/ports/tester/COPYRIGHT + &prompt.root; poudriere ports -c -p local -m svn+https +[00:00:00] Creating local fs at /poudriere/ports/local... done +[00:00:00] Checking out the ports tree... done -[...] - -Building new INDEX files... done. - On a single computer, poudriere can build ports with multiple configurations, in multiple jails, and from different port trees. Custom configurations @@ -1625,13 +1628,13 @@ Building new INDEX files... done. >/usr/local/etc/poudriere.d. The filename in this example is created by combining the jail name, port name, and set name: - 10amd64-local-workstation-make.conf. + 11amd64-local-workstation-make.conf. The system make.conf and this new file are combined at build time to create the make.conf used by the build jail. Packages to be built are entered in - 10amd64-local-workstation-pkglist: + 11amd64-local-workstation-pkglist: editors/emacs devel/git @@ -1641,12 +1644,12 @@ ports-mgmt/pkg Options and dependencies for the specified ports are configured: - &prompt.root; poudriere options -j 10amd64 -p local -z workstation -f 10amd64-local-workstation-pkglist + &prompt.root; poudriere options -j 10amd64 -p local -z workstation -f 11amd64-local-workstation-pkglist Finally, packages are built and a package repository is created: - &prompt.root; poudriere bulk -j 10amd64 -p local -z workstation -f 10amd64-local-workstation-pkglist + &prompt.root; poudriere bulk -j 11amd64 -p local -z workstation -f 11amd64-local-workstation-pkglist While running, pressing Ctrlt @@ -1684,18 +1687,18 @@ ports-mgmt/pkg Usually it is easiest to serve a poudriere repository to the client machines via HTTP. Set up a webserver to serve up the package directory, for instance: - /usr/local/poudriere/data/packages/10amd64, - where 10amd64 + /usr/local/poudriere/data/packages/11amd64, + where 11amd64 is the name of the build. If the URL to the package repository is: - http://pkg.example.com/10amd64, then the + http://pkg.example.com/11amd64, then the repository configuration file in /usr/local/etc/pkg/repos/custom.conf would look like: custom: { - url: "http://pkg.example.com/10amd64", + url: "http://pkg.example.com/11amd64", enabled: yes, }