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

Reflect that the minimum supported version of FreeBSD is now 11.3. Yes,

Browse source 
these are only examples, but let's be consistent.

Inspired by PR 245711 from Felix Palmen.
This commit is contained in:
Mark Linimon 2020-04-18 03:17:47 +00:00
parent 339eaf7d0a
commit aced09b56e
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=54060
1 changed files with 32 additions and 32 deletions

64
en_US.ISO8859-1/books/porters-handbook/testing/chapter.xml
View file

@ -417,15 +417,15 @@ SVN_HOST=svn.FreeBSD.org</programlisting>
<application>Poudriere</application> will use for
building:</para>
<screen>&prompt.root; <userinput>poudriere jail -c -j 111Ramd64 -v 11.1-RELEASE -a amd64</userinput></screen>
<screen>&prompt.root; <userinput>poudriere jail -c -j 113Ramd64 -v 11.3-RELEASE -a amd64</userinput></screen>
<para>Fetch a <literal>11.1-RELEASE</literal> for
<para>Fetch a <literal>11.3-RELEASE</literal> for
<literal>amd64</literal> from the <acronym>FTP</acronym>
server given by <varname>FREEBSD_HOST</varname> in
<filename>poudriere.conf</filename>, create the zfs file
system <literal>tank/poudriere/jails/111Ramd64</literal>, mount
it on <filename>/poudriere/jails/111Ramd64</filename> and
extract the <literal>11.1-RELEASE</literal> tarballs into this
system <literal>tank/poudriere/jails/113Ramd64</literal>, mount
it on <filename>/poudriere/jails/113Ramd64</filename> and
extract the <literal>11.3-RELEASE</literal> tarballs into this
file system.</para>
<screen>&prompt.root; <userinput>poudriere jail -c -j 11i386 -v stable/11 -a i386 -m svn+https</userinput></screen>
@ -453,7 +453,7 @@ SVN_HOST=svn.FreeBSD.org</programlisting>
an older version, most of the time it will not run. For
example, if a <literal>stable/11</literal> jail is needed,
the host will have to run <literal>stable/11</literal> too.
Running <literal>11.0-RELEASE</literal> is not
Running <literal>11.3-RELEASE</literal> is not
enough.</para>
</note>
@ -468,7 +468,7 @@ SVN_HOST=svn.FreeBSD.org</programlisting>
running <literal>13.0-CURRENT</literal>. In general, newer
kernels can build and run older jails. For instance, a
<literal>13.0-CURRENT</literal> kernel can build and run a
<literal>11.1-STABLE</literal>
<literal>11.3-STABLE</literal>
<application>Poudriere</application> jails if the
<literal>COMPAT_FREEBSD11</literal> kernel option was
compiled in (on by default in
@ -490,8 +490,8 @@ SVN_HOST=svn.FreeBSD.org</programlisting>
<screen>&prompt.root; <userinput>poudriere jail -l</userinput>
JAILNAME VERSION ARCH METHOD
111Ramd64 11.1-RELEASE amd64 ftp
11i386 11.0-STABLE i386 svn+https</screen>
113Ramd64 11.3-RELEASE amd64 ftp
11i386 11.3-STABLE i386 svn+https</screen>
</sect2>
@ -654,9 +654,9 @@ development - /work/ports</screen>
<para>For example, local modifications to the <package
role="port">www/firefox</package> port located in
<filename>/work/ports/www/firefox</filename> can be tested in
the previously created 11.1-RELEASE jail:</para>
the previously created 11.3-RELEASE jail:</para>
<screen>&prompt.root; <userinput>poudriere testport -j 111Ramd64 -p development -o www/firefox</userinput></screen>
<screen>&prompt.root; <userinput>poudriere testport -j 113Ramd64 -p development -o www/firefox</userinput></screen>
<para>This will build all dependencies of
<application>Firefox</application>. If a dependency has been
@ -667,13 +667,13 @@ development - /work/ports</screen>
built.</para>
<para>The complete build of every port is logged to
<filename>/poudriere/data/logs/bulk/111Ri386-development/<replaceable>build-time</replaceable>/logs</filename>.</para>
<filename>/poudriere/data/logs/bulk/113Ri386-development/<replaceable>build-time</replaceable>/logs</filename>.</para>
<para>The directory name <literal>111Ri386-development</literal>
<para>The directory name <literal>113Ri386-development</literal>
is derived from the arguments to <literal>-j</literal> and
<literal>-p</literal>, respectively. For convenience, a
symbolic link
<filename>/poudriere/data/logs/bulk/111Ri386-development/latest</filename>
<filename>/poudriere/data/logs/bulk/113Ri386-development/latest</filename>
is also maintained. The link points to the latest
<replaceable>build-time</replaceable> directory. Also in this
directory is an <filename>index.html</filename> for observing
@ -685,7 +685,7 @@ development - /work/ports</screen>
the build by adding <option>-i</option> to
<command>testport</command>:</para>
<screen>&prompt.root; <userinput>poudriere testport -j 111Ramd64 -p development -i -o www/firefox</userinput></screen>
<screen>&prompt.root; <userinput>poudriere testport -j 113Ramd64 -p development -i -o www/firefox</userinput></screen>
<para>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</screen>
will show the command to run when the jail is no longer
needed. It is then possible to &man.jexec.8; into it:</para>
<screen>&prompt.root; <userinput>poudriere testport -j 111Ramd64 -p development -I -o www/firefox</userinput>
<screen>&prompt.root; <userinput>poudriere testport -j 113Ramd64 -p development -I -o www/firefox</userinput>
[...]
====>> 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; <userinput>jexec 111Ramd64-development-n env -i TERM=$TERM /usr/bin/login -fp root</userinput>
====>> 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; <userinput>jexec 113Ramd64-development-n env -i TERM=$TERM /usr/bin/login -fp root</userinput>
&prompt.root; <userinput><replaceable>[do some stuff in the jail]</replaceable></userinput>
&prompt.root; <userinput>exit</userinput>
&prompt.root; <userinput>poudriere jail -k -j 111Ramd64 -p development</userinput>
&prompt.root; <userinput>poudriere jail -k -j 113Ramd64 -p development</userinput>
====>> Umounting file systems</screen>
<para>An integral part of the &os; ports build infrastructure is
@ -760,22 +760,22 @@ development - /work/ports</screen>
<literal>-z devset</literal> parameter to the testport
command:</para>
<screen>&prompt.root; <userinput>poudriere testport -j 111Ramd64 -p development -z devset -o www/firefox</userinput></screen>
<screen>&prompt.root; <userinput>poudriere testport -j 113Ramd64 -p development -z devset -o www/firefox</userinput></screen>
<para>This will look for the existence of these directories in
this order:</para>
<itemizedlist>
<listitem>
<para><filename>/usr/local/etc/poudriere.d/111Ramd64-development-devset-options</filename></para>
<para><filename>/usr/local/etc/poudriere.d/113Ramd64-development-devset-options</filename></para>
</listitem>
<listitem>
<para><filename>/usr/local/etc/poudriere.d/111Ramd64-devset-options</filename></para>
<para><filename>/usr/local/etc/poudriere.d/113Ramd64-devset-options</filename></para>
</listitem>
<listitem>
<para><filename>/usr/local/etc/poudriere.d/111Ramd64-development-options</filename></para>
<para><filename>/usr/local/etc/poudriere.d/113Ramd64-development-options</filename></para>
</listitem>
<listitem>
@ -787,7 +787,7 @@ development - /work/ports</screen>
</listitem>
<listitem>
<para><filename>/usr/local/etc/poudriere.d/111Ramd64-options</filename></para>
<para><filename>/usr/local/etc/poudriere.d/113Ramd64-options</filename></para>
</listitem>
<listitem>
@ -834,7 +834,7 @@ development - /work/ports</screen>
matching a name scheme derived from the command line. For
instance:</para>
<screen>&prompt.root; <userinput>poudriere testport -j 111Ramd64 -p development -z devset -o www/firefox</userinput></screen>
<screen>&prompt.root; <userinput>poudriere testport -j 113Ramd64 -p development -z devset -o www/firefox</userinput></screen>
<para>causes <application>Poudriere</application> to check for
the existence of these files in this order:</para>
@ -853,19 +853,19 @@ development - /work/ports</screen>
</listitem>
<listitem>
<para><filename>/usr/local/etc/poudriere.d/111Ramd64-make.conf</filename></para>
<para><filename>/usr/local/etc/poudriere.d/113Ramd64-make.conf</filename></para>
</listitem>
<listitem>
<para><filename>/usr/local/etc/poudriere.d/111Ramd64-development-make.conf</filename></para>
<para><filename>/usr/local/etc/poudriere.d/113Ramd64-development-make.conf</filename></para>
</listitem>
<listitem>
<para><filename>/usr/local/etc/poudriere.d/111Ramd64-devset-make.conf</filename></para>
<para><filename>/usr/local/etc/poudriere.d/113Ramd64-devset-make.conf</filename></para>
</listitem>
<listitem>
<para><filename>/usr/local/etc/poudriere.d/111Ramd64-development-devset-make.conf</filename></para>
<para><filename>/usr/local/etc/poudriere.d/113Ramd64-development-devset-make.conf</filename></para>
</listitem>
</itemizedlist>
@ -878,7 +878,7 @@ development - /work/ports</screen>
Special variables, intended to affect only certain jails or
sets can be set in specialised <filename>make.conf</filename>
files, such as
<filename>/usr/local/etc/poudriere.d/111Ramd64-development-devset-make.conf</filename>.</para>
<filename>/usr/local/etc/poudriere.d/113Ramd64-development-devset-make.conf</filename>.</para>
<example xml:id="testing-poudriere-sets-perl">
<title>Using <filename>make.conf</filename> to Change Default