Date: Fri, 8 Nov 2013 20:13:40 +0000 (UTC) From: Rene Ladan <rene@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r43145 - head/en_US.ISO8859-1/books/porters-handbook Message-ID: <201311082013.rA8KDein033959@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: rene Date: Fri Nov 8 20:13:39 2013 New Revision: 43145 URL: http://svnweb.freebsd.org/changeset/doc/43145 Log: Update for USES=kmod, most notably: - simplify the part on staging kernel module ports - rewrite the parts on checking for kernel sources Approved by: remko (mentor) Modified: head/en_US.ISO8859-1/books/porters-handbook/book.xml Modified: head/en_US.ISO8859-1/books/porters-handbook/book.xml ============================================================================== --- head/en_US.ISO8859-1/books/porters-handbook/book.xml Fri Nov 8 15:56:47 2013 (r43144) +++ head/en_US.ISO8859-1/books/porters-handbook/book.xml Fri Nov 8 20:13:39 2013 (r43145) @@ -2225,7 +2225,10 @@ PORTEPOCH= 1</programlisting> <listitem> <para>Ports which install loadable kernel modules should have the virtual category <filename>kld</filename> in - their <varname>CATEGORIES</varname> line.</para> + their <varname>CATEGORIES</varname> line. This is one + of the things handled automatically by adding + <literal>kmod</literal> to the <varname>USES</varname> + line.</para> </listitem> <listitem> @@ -5322,27 +5325,8 @@ PORTVERSION= 1.0</programlisting> <para>Ports that install kernel modules must prepend the <varname>STAGEDIR</varname> variable to - their default destination, <filename>/boot/modules</filename>. Then the - <buildtarget>pre-install</buildtarget> target can be used to handle - the creation of this directory:</para> - - <programlisting>pre-install: - ${MKDIR} ${STAGEDIR}/boot/modules</programlisting> - - <para>&man.kldxref.8; should not be run when installing to - the temporary staging directory. To prevent this, define - the<varname>NO_XREF</varname> variable and add it - to <varname>MAKE_ENV</varname> in the port's - <filename>Makefile</filename>:</para> - - <programlisting>MAKE_ENV+= KMODDIR=/boot/modules NO_XREF=yes</programlisting> - <para>The hints files for the kernel loader should - be regenerated only when the package is installed or - deinstalled. Do this by invoking &man.kldxref.8; from - <filename>pkg-plist</filename>:</para> - - <programlisting>@unexec kldxref /boot/modules -@exec kldxref /boot/modules</programlisting> + their destination, by default + <filename>/boot/modules</filename>.</para> </sect1> <sect1 xml:id="porting-shlibs"> @@ -10046,9 +10030,11 @@ GROUPS= pulse pulse-access pulse-rt</pro correct way to determine if the user has them installed:</para> - <programlisting>.if !exists(${SRC_BASE}/sys/Makefile) -IGNORE= requires kernel sources to be installed -.endif</programlisting> + <programlisting>USES= kmod</programlisting> + + <para>Apart from this check, the <literal>kmod</literal> feature + takes care of most items that these ports need to take into + account.</para> </sect1> </chapter> @@ -11989,11 +11975,6 @@ exec %%LOCALBASE%%/bin/java -jar %%DATAD </listitem> <listitem> - <para>requires &os; kernel sources to build, but the - user does not have them installed</para> - </listitem> - - <listitem> <para>has a distfile which may not be automatically fetched due to licensing restrictions</para> </listitem>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201311082013.rA8KDein033959>