From owner-svn-doc-head@FreeBSD.ORG Wed Mar 19 23:47:12 2014 Return-Path: Delivered-To: svn-doc-head@freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [8.8.178.115]) (using TLSv1 with cipher ADH-AES256-SHA (256/256 bits)) (No client certificate requested) by hub.freebsd.org (Postfix) with ESMTPS id 640CC694; Wed, 19 Mar 2014 23:47:12 +0000 (UTC) Received: from svn.freebsd.org (svn.freebsd.org [IPv6:2001:1900:2254:2068::e6a:0]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mx1.freebsd.org (Postfix) with ESMTPS id 46F7AEE6; Wed, 19 Mar 2014 23:47:12 +0000 (UTC) Received: from svn.freebsd.org ([127.0.1.70]) by svn.freebsd.org (8.14.8/8.14.8) with ESMTP id s2JNlCkA003916; Wed, 19 Mar 2014 23:47:12 GMT (envelope-from dru@svn.freebsd.org) Received: (from dru@localhost) by svn.freebsd.org (8.14.8/8.14.8/Submit) id s2JNlCvn003915; Wed, 19 Mar 2014 23:47:12 GMT (envelope-from dru@svn.freebsd.org) Message-Id: <201403192347.s2JNlCvn003915@svn.freebsd.org> From: Dru Lavigne Date: Wed, 19 Mar 2014 23:47:12 +0000 (UTC) To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r44292 - head/en_US.ISO8859-1/books/handbook/linuxemu X-SVN-Group: doc-head MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-BeenThere: svn-doc-head@freebsd.org X-Mailman-Version: 2.1.17 Precedence: list List-Id: SVN commit messages for the doc tree for head List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 19 Mar 2014 23:47:12 -0000 Author: dru Date: Wed Mar 19 23:47:11 2014 New Revision: 44292 URL: http://svnweb.freebsd.org/changeset/doc/44292 Log: Start editorial review. More commits to come. Sponsored by: iXsystems 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 Wed Mar 19 23:15:50 2014 (r44291) +++ head/en_US.ISO8859-1/books/handbook/linuxemu/chapter.xml Wed Mar 19 23:47:11 2014 (r44292) @@ -51,19 +51,17 @@ Linux - &os; provides binary compatibility with &linux;, allowing - users to install and run &linux; binaries on a &os; system. - Many companies and developers develop only for &linux;, and - binary compatibility allows &os; users to run about 90% of all - &linux; applications without modification. This includes - productivity applications, games, and more. It has even been - reported that, in some situations, &linux; binaries perform + &os; provides 32-bit binary compatibility with &linux;, allowing + users to install and run most 32-bit &linux; binaries on a &os; system + without having to first modify the binary. It has even been + reported that, in some situations, 32-bit &linux; binaries perform better on &os; than they do on &linux;. However, some &linux;-specific operating system features are not supported under &os;. For example, &linux; binaries will not work on &os; if they overly use &i386; specific - calls, such as enabling virtual 8086 mode. + calls, such as enabling virtual 8086 mode. In addition, 64-bit + &linux; binaries are not supported at this time. After reading this chapter, you will know: @@ -101,51 +99,49 @@ - Installation + Configuring &linux; Binary Compatibility Ports Collection - &linux; libraries are not installed on &os; by default - and &linux; binary compatibility is not enabled by default. - &linux; libraries can be installed using the &os; Ports - Collection. Alternately, &linux; libraries can be installed - manually. - - Using the Ports Collection is by far the easiest way to - install &linux; libraries: + By default, &linux; libraries are not installed and + &linux; binary compatibility is not enabled. + &linux; libraries can either be installed manually or from the &os; Ports + Collection. + + The emulators/linux-base-f10 package or + port is the easiest way to + install a base set of &linux; libraries and binaries on + a &os; system. To install the port: &prompt.root; cd /usr/ports/emulators/linux_base-f10 &prompt.root; make install distclean - Once the port is installed, enable &linux; binary - compatibility by loading the linux module. - Type the following as - root: + Once installed, enable &linux; binary + compatibility by loading the linux module: &prompt.root; kldload linux - In order for &linux; compatibility to always be enabled at - boot time, add the following line to - /etc/rc.conf: - - linux_enable="YES" - - To verify that the module is loaded, use - &man.kldstat.8;: + To verify that the module is loaded: &prompt.user; kldstat Id Refs Address Size Name 1 2 0xc0100000 16bdb8 kernel 7 1 0xc24db000 d000 linux.ko + In order for &linux; compatibility to be enabled at + boot time, add the following line to + /etc/rc.conf: + + linux_enable="YES" + kernel options COMPAT_LINUX Users who prefer to statically link &linux; binary - compatibility into the kernel should add - options COMPAT_LINUX to the custom kernel + compatibility into a custom kernel should add + options COMPAT_LINUX to their custom kernel configuration file. Compile and install the new kernel as described in .