Bug 188968

Summary: [handbook] Error in 11.2 Linux Compatability
Product: Documentation Reporter: Tom <trh411>
Component: Books & ArticlesAssignee: Allan Jude <allanjude>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   
Attachments:
Description Flags
linuxemu.txt none

Description Tom 2014-04-24 17:10:00 UTC 
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.

Fix: 

Reverse the steps in the documentation. Show the linux kernel module being loaded first followed by the installation of emulators/linux_base-f10.
How-To-Repeat: Open Handbook to Section 11.2.
Comment 1 Allan Jude freebsd_committer freebsd_triage 2014-05-19 21:09:35 UTC 
Responsible Changed
From-To: freebsd-doc->allanjude

take
Comment 2 dfilter service freebsd_committer freebsd_triage 2014-05-21 03:59:54 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"
Comment 3 Allan Jude freebsd_committer freebsd_triage 2014-05-21 04:01:48 UTC 
State Changed
From-To: open->closed

committed