Bug 188968 - [handbook] Error in 11.2 Linux Compatability
Summary: [handbook] Error in 11.2 Linux Compatability
Status: Closed FIXED
Alias: None
Product: Documentation
Classification: Unclassified
Component: Books & Articles (show other bugs)
Version: Latest
Hardware: Any Any
: Normal Affects Only Me
Assignee: Allan Jude
URL:
Keywords:
Depends on:
Blocks:
 
Reported: 2014-04-24 17:10 UTC by Tom
Modified: 2014-05-21 04:01 UTC (History)
0 users

See Also:


Attachments
linuxemu.txt (1.67 KB, text/plain; charset=UTF-8)
2014-05-18 02:24 UTC, Sevan Janiyan
no flags Details

Note You need to log in before you can comment on or make changes to this bug.
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