From nobody@FreeBSD.org  Thu Apr 24 16:08:03 2014
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1])
	(using TLSv1 with cipher ADH-AES256-SHA (256/256 bits))
	(No client certificate requested)
	by hub.freebsd.org (Postfix) with ESMTPS id 1F9526DF
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 24 Apr 2014 16:08:03 +0000 (UTC)
Received: from cgiserv.freebsd.org (cgiserv.freebsd.org [IPv6:2001:1900:2254:206a::50:4])
	(using TLSv1 with cipher DHE-RSA-AES256-SHA (256/256 bits))
	(Client did not present a certificate)
	by mx1.freebsd.org (Postfix) with ESMTPS id 0CA341CCE
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 24 Apr 2014 16:08:03 +0000 (UTC)
Received: from cgiserv.freebsd.org ([127.0.1.6])
	by cgiserv.freebsd.org (8.14.8/8.14.8) with ESMTP id s3OG82Ix084336
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 24 Apr 2014 16:08:02 GMT
	(envelope-from nobody@cgiserv.freebsd.org)
Received: (from nobody@localhost)
	by cgiserv.freebsd.org (8.14.8/8.14.8/Submit) id s3OG82Jc084322;
	Thu, 24 Apr 2014 16:08:02 GMT
	(envelope-from nobody)
Message-Id: <201404241608.s3OG82Jc084322@cgiserv.freebsd.org>
Date: Thu, 24 Apr 2014 16:08:02 GMT
From: Tom Hoffmann <trh411@gmail.com>
To: freebsd-gnats-submit@FreeBSD.org
Subject: Handbook, Error in 11.2 Linux Compatability
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         188968
>Category:       docs
>Synopsis:       [handbook] Error in 11.2 Linux Compatability
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    allanjude
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Apr 24 16:10:00 UTC 2014
>Closed-Date:    Wed May 21 03:01:56 UTC 2014
>Last-Modified:  Wed May 21 03:01:56 UTC 2014
>Originator:     Tom Hoffmann
>Release:        11.0-CURRENT r264862
>Organization:
N/A
>Environment:
FreeBSD tortoise 11.0-CURRENT FreeBSD 11.0-CURRENT #37 r264862: Wed Apr 23 22:44:37 EDT 2014     root@tortoise:/usr/obj/usr/src/sys/NEWCONS  amd64
>Description:
Section 11.2 of the Handbook shows emulators/linux_base-f10 being installed before loading the linux kernel module. However, if emulators/linux_base-f10 is installed before the linux kernel is loaded it fails with a "linux_base-f10 linuxulator is not (kld)loaded" error.
>How-To-Repeat:
Open Handbook to Section 11.2.
>Fix:
Reverse the steps in the documentation. Show the linux kernel module being loaded first followed by the installation of emulators/linux_base-f10.

>Release-Note:
>Audit-Trail:

From: venture37 <venture37@geeklan.co.uk>
To: bug-followup@FreeBSD.org, trh411@gmail.com
Cc:  
Subject: Re: docs/188968: [handbook] Error in 11.2 Linux Compatability
Date: Sat, 17 May 2014 21:24:21 -0400

 This is a multi-part message in MIME format.
 --------------070804050907040809020801
 Content-Type: text/plain; charset=ISO-8859-1; format=flowed
 Content-Transfer-Encoding: 7bit
 
 
 --------------070804050907040809020801
 Content-Type: text/plain; charset=UTF-8;
  name="linuxemu.txt"
 Content-Transfer-Encoding: 7bit
 Content-Disposition: attachment;
  filename="linuxemu.txt"
 
 Index: linuxemu/chapter.xml
 ===================================================================
 --- linuxemu/chapter.xml	(revision 44860)
 +++ linuxemu/chapter.xml	(working copy)
 @@ -108,6 +108,18 @@
        either be installed manually or from the &os; Ports
        Collection.</para>
  
 +    <para>Before attempting to build the port, load the &linux; kernel
 +      module otherwise the build will fail</para>
 +
 +    <screen>&prompt.root; <userinput>kldload linux</userinput></screen>
 +
 +    <para>To verify that the module is loaded:</para>
 +
 +    <screen>&prompt.user; <userinput>kldstat</userinput>
 +      Id Refs Address    Size     Name
 +      1    2 0xc0100000 16bdb8   kernel
 +      7    1 0xc24db000 d000     linux.ko</screen>
 +
      <para>The <package>emulators/linux-base-f10</package> package or
        port is the easiest way to install a base set of &linux;
        libraries and binaries on a &os; system.  To install the
 @@ -116,18 +128,6 @@
      <screen>&prompt.root; <userinput>cd /usr/ports/emulators/linux_base-f10</userinput>
  &prompt.root; <userinput>make install distclean</userinput></screen>
  
 -    <para>Once installed, enable &linux; binary compatibility by
 -      loading the <literal>linux</literal> module:</para>
 -
 -    <screen>&prompt.root; <userinput>kldload linux</userinput></screen>
 -
 -    <para>To verify that the module is loaded:</para>
 -
 -    <screen>&prompt.user; <userinput>kldstat</userinput>
 -Id Refs Address    Size     Name
 - 1    2 0xc0100000 16bdb8   kernel
 - 7    1 0xc24db000 d000     linux.ko</screen>
 -
      <para>In order for &linux; compatibility to be enabled at boot
        time, add the following line to
        <filename>/etc/rc.conf</filename>:</para>
 
 --------------070804050907040809020801--
Responsible-Changed-From-To: freebsd-doc->allanjude 
Responsible-Changed-By: allanjude 
Responsible-Changed-When: Mon May 19 20:09:35 UTC 2014 
Responsible-Changed-Why:  
take 

http://www.freebsd.org/cgi/query-pr.cgi?pr=188968 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/188968: commit references a PR
Date: Wed, 21 May 2014 02:59:54 +0000 (UTC)

 Author: allanjude
 Date: Wed May 21 02:59:51 2014
 New Revision: 44893
 URL: http://svnweb.freebsd.org/changeset/doc/44893
 
 Log:
   Move the instructions to load the linux.ko module to before the instruction to
   install the port, as the port depends on the module being loaded.
   
   PR:		docs/188968
   Submitted by:	venture37 <venture37@geeklan.co.uk>
   Approved by:	eadler (mentor)
 
 Modified:
   head/en_US.ISO8859-1/books/handbook/linuxemu/chapter.xml
 
 Modified: head/en_US.ISO8859-1/books/handbook/linuxemu/chapter.xml
 ==============================================================================
 --- head/en_US.ISO8859-1/books/handbook/linuxemu/chapter.xml	Tue May 20 22:13:23 2014	(r44892)
 +++ head/en_US.ISO8859-1/books/handbook/linuxemu/chapter.xml	Wed May 21 02:59:51 2014	(r44893)
 @@ -108,6 +108,18 @@
        either be installed manually or from the &os; Ports
        Collection.</para>
  
 +    <para>Before attempting to build the port, load the &linux; kernel
 +      module otherwise the build will fail</para>
 +
 +    <screen>&prompt.root; <userinput>kldload linux</userinput></screen>
 +
 +    <para>To verify that the module is loaded:</para>
 +
 +    <screen>&prompt.user; <userinput>kldstat</userinput>
 +      Id Refs Address    Size     Name
 +      1    2 0xc0100000 16bdb8   kernel
 +      7    1 0xc24db000 d000     linux.ko</screen>
 +
      <para>The <package>emulators/linux-base-f10</package> package or
        port is the easiest way to install a base set of &linux;
        libraries and binaries on a &os; system.  To install the
 @@ -116,18 +128,6 @@
      <screen>&prompt.root; <userinput>cd /usr/ports/emulators/linux_base-f10</userinput>
  &prompt.root; <userinput>make install distclean</userinput></screen>
  
 -    <para>Once installed, enable &linux; binary compatibility by
 -      loading the <literal>linux</literal> module:</para>
 -
 -    <screen>&prompt.root; <userinput>kldload linux</userinput></screen>
 -
 -    <para>To verify that the module is loaded:</para>
 -
 -    <screen>&prompt.user; <userinput>kldstat</userinput>
 -Id Refs Address    Size     Name
 - 1    2 0xc0100000 16bdb8   kernel
 - 7    1 0xc24db000 d000     linux.ko</screen>
 -
      <para>In order for &linux; compatibility to be enabled at boot
        time, add the following line to
        <filename>/etc/rc.conf</filename>:</para>
 _______________________________________________
 svn-doc-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-doc-all
 To unsubscribe, send any mail to "svn-doc-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: open->closed 
State-Changed-By: allanjude 
State-Changed-When: Wed May 21 03:01:48 UTC 2014 
State-Changed-Why:  
committed 

http://www.freebsd.org/cgi/query-pr.cgi?pr=188968 
>Unformatted:
