From owner-svn-doc-all@freebsd.org Sat Apr 18 03:17:48 2020 Return-Path: Delivered-To: svn-doc-all@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 7D3D32B73F9; Sat, 18 Apr 2020 03:17:48 +0000 (UTC) (envelope-from linimon@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) server-signature RSA-PSS (4096 bits) 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 493ynm2jDwz4KdS; Sat, 18 Apr 2020 03:17:48 +0000 (UTC) (envelope-from linimon@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 551E957D5; Sat, 18 Apr 2020 03:17:48 +0000 (UTC) (envelope-from linimon@FreeBSD.org) Received: from repo.freebsd.org ([127.0.1.37]) by repo.freebsd.org (8.15.2/8.15.2) with ESMTP id 03I3HmWx065353; Sat, 18 Apr 2020 03:17:48 GMT (envelope-from linimon@FreeBSD.org) Received: (from linimon@localhost) by repo.freebsd.org (8.15.2/8.15.2/Submit) id 03I3HmPb065352; Sat, 18 Apr 2020 03:17:48 GMT (envelope-from linimon@FreeBSD.org) Message-Id: <202004180317.03I3HmPb065352@repo.freebsd.org> X-Authentication-Warning: repo.freebsd.org: linimon set sender to linimon@FreeBSD.org using -f From: Mark Linimon Date: Sat, 18 Apr 2020 03:17:48 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r54060 - head/en_US.ISO8859-1/books/porters-handbook/testing X-SVN-Group: doc-head X-SVN-Commit-Author: linimon X-SVN-Commit-Paths: head/en_US.ISO8859-1/books/porters-handbook/testing X-SVN-Commit-Revision: 54060 X-SVN-Commit-Repository: doc 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.29 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, 18 Apr 2020 03:17:48 -0000 Author: linimon Date: Sat Apr 18 03:17:47 2020 New Revision: 54060 URL: https://svnweb.freebsd.org/changeset/doc/54060 Log: Reflect that the minimum supported version of FreeBSD is now 11.3. Yes, these are only examples, but let's be consistent. Inspired by PR 245711 from Felix Palmen. Modified: head/en_US.ISO8859-1/books/porters-handbook/testing/chapter.xml Modified: head/en_US.ISO8859-1/books/porters-handbook/testing/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/testing/chapter.xml Sat Apr 18 02:58:05 2020 (r54059) +++ head/en_US.ISO8859-1/books/porters-handbook/testing/chapter.xml Sat Apr 18 03:17:47 2020 (r54060) @@ -417,15 +417,15 @@ SVN_HOST=svn.FreeBSD.org Poudriere will use for building: - &prompt.root; poudriere jail -c -j 111Ramd64 -v 11.1-RELEASE -a amd64 + &prompt.root; poudriere jail -c -j 113Ramd64 -v 11.3-RELEASE -a amd64 - Fetch a 11.1-RELEASE for + Fetch a 11.3-RELEASE for amd64 from the FTP server given by FREEBSD_HOST in poudriere.conf, create the zfs file - system tank/poudriere/jails/111Ramd64, mount - it on /poudriere/jails/111Ramd64 and - extract the 11.1-RELEASE tarballs into this + system tank/poudriere/jails/113Ramd64, mount + it on /poudriere/jails/113Ramd64 and + extract the 11.3-RELEASE tarballs into this file system. &prompt.root; poudriere jail -c -j 11i386 -v stable/11 -a i386 -m svn+https @@ -453,7 +453,7 @@ SVN_HOST=svn.FreeBSD.org an older version, most of the time it will not run. For example, if a stable/11 jail is needed, the host will have to run stable/11 too. - Running 11.0-RELEASE is not + Running 11.3-RELEASE is not enough. @@ -468,7 +468,7 @@ SVN_HOST=svn.FreeBSD.org running 13.0-CURRENT. In general, newer kernels can build and run older jails. For instance, a 13.0-CURRENT kernel can build and run a - 11.1-STABLE + 11.3-STABLE Poudriere jails if the COMPAT_FREEBSD11 kernel option was compiled in (on by default in @@ -490,8 +490,8 @@ SVN_HOST=svn.FreeBSD.org &prompt.root; poudriere jail -l JAILNAME VERSION ARCH METHOD -111Ramd64 11.1-RELEASE amd64 ftp -11i386 11.0-STABLE i386 svn+https +113Ramd64 11.3-RELEASE amd64 ftp +11i386 11.3-STABLE i386 svn+https @@ -654,9 +654,9 @@ development - /work/ports For example, local modifications to the www/firefox port located in /work/ports/www/firefox can be tested in - the previously created 11.1-RELEASE jail: + the previously created 11.3-RELEASE jail: - &prompt.root; poudriere testport -j 111Ramd64 -p development -o www/firefox + &prompt.root; poudriere testport -j 113Ramd64 -p development -o www/firefox This will build all dependencies of Firefox. If a dependency has been @@ -667,13 +667,13 @@ development - /work/ports built. The complete build of every port is logged to - /poudriere/data/logs/bulk/111Ri386-development/build-time/logs. + /poudriere/data/logs/bulk/113Ri386-development/build-time/logs. - The directory name 111Ri386-development + The directory name 113Ri386-development is derived from the arguments to -j and -p, respectively. For convenience, a symbolic link - /poudriere/data/logs/bulk/111Ri386-development/latest + /poudriere/data/logs/bulk/113Ri386-development/latest is also maintained. The link points to the latest build-time directory. Also in this directory is an index.html for observing @@ -685,7 +685,7 @@ development - /work/ports the build by adding to testport: - &prompt.root; poudriere testport -j 111Ramd64 -p development -i -o www/firefox + &prompt.root; poudriere testport -j 113Ramd64 -p development -i -o www/firefox After the build completes, and regardless of whether it was successful, a shell is provided within the jail. The @@ -696,16 +696,16 @@ development - /work/ports will show the command to run when the jail is no longer needed. It is then possible to &man.jexec.8; into it: - &prompt.root; poudriere testport -j 111Ramd64 -p development -I -o www/firefox + &prompt.root; poudriere testport -j 113Ramd64 -p development -I -o www/firefox [...] ====>> Installing local Pkg repository to /usr/local/etc/pkg/repos -====>> Leaving jail 111Ramd64-development-n running, mounted at /poudriere/data/.m/111Ramd64-development/ref for interactive run testing -====>> To enter jail: jexec 111Ramd64-development-n env -i TERM=$TERM /usr/bin/login -fp root -====>> To stop jail: poudriere jail -k -j 111Ramd64 -p development -&prompt.root; jexec 111Ramd64-development-n env -i TERM=$TERM /usr/bin/login -fp root +====>> Leaving jail 113Ramd64-development-n running, mounted at /poudriere/data/.m/113Ramd64-development/ref for interactive run testing +====>> To enter jail: jexec 113Ramd64-development-n env -i TERM=$TERM /usr/bin/login -fp root +====>> To stop jail: poudriere jail -k -j 113Ramd64 -p development +&prompt.root; jexec 113Ramd64-development-n env -i TERM=$TERM /usr/bin/login -fp root &prompt.root; [do some stuff in the jail] &prompt.root; exit -&prompt.root; poudriere jail -k -j 111Ramd64 -p development +&prompt.root; poudriere jail -k -j 113Ramd64 -p development ====>> Umounting file systems An integral part of the &os; ports build infrastructure is @@ -760,22 +760,22 @@ development - /work/ports -z devset parameter to the testport command: - &prompt.root; poudriere testport -j 111Ramd64 -p development -z devset -o www/firefox + &prompt.root; poudriere testport -j 113Ramd64 -p development -z devset -o www/firefox This will look for the existence of these directories in this order: - /usr/local/etc/poudriere.d/111Ramd64-development-devset-options + /usr/local/etc/poudriere.d/113Ramd64-development-devset-options - /usr/local/etc/poudriere.d/111Ramd64-devset-options + /usr/local/etc/poudriere.d/113Ramd64-devset-options - /usr/local/etc/poudriere.d/111Ramd64-development-options + /usr/local/etc/poudriere.d/113Ramd64-development-options @@ -787,7 +787,7 @@ development - /work/ports - /usr/local/etc/poudriere.d/111Ramd64-options + /usr/local/etc/poudriere.d/113Ramd64-options @@ -834,7 +834,7 @@ development - /work/ports matching a name scheme derived from the command line. For instance: - &prompt.root; poudriere testport -j 111Ramd64 -p development -z devset -o www/firefox + &prompt.root; poudriere testport -j 113Ramd64 -p development -z devset -o www/firefox causes Poudriere to check for the existence of these files in this order: @@ -853,19 +853,19 @@ development - /work/ports - /usr/local/etc/poudriere.d/111Ramd64-make.conf + /usr/local/etc/poudriere.d/113Ramd64-make.conf - /usr/local/etc/poudriere.d/111Ramd64-development-make.conf + /usr/local/etc/poudriere.d/113Ramd64-development-make.conf - /usr/local/etc/poudriere.d/111Ramd64-devset-make.conf + /usr/local/etc/poudriere.d/113Ramd64-devset-make.conf - /usr/local/etc/poudriere.d/111Ramd64-development-devset-make.conf + /usr/local/etc/poudriere.d/113Ramd64-development-devset-make.conf @@ -878,7 +878,7 @@ development - /work/ports Special variables, intended to affect only certain jails or sets can be set in specialised make.conf files, such as - /usr/local/etc/poudriere.d/111Ramd64-development-devset-make.conf. + /usr/local/etc/poudriere.d/113Ramd64-development-devset-make.conf. Using <filename>make.conf</filename> to Change Default