Date: Wed, 19 Mar 2014 23:47:12 +0000 (UTC) From: Dru Lavigne <dru@FreeBSD.org> 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 Message-ID: <201403192347.s2JNlCvn003915@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
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 @@ <secondary>Linux</secondary> </indexterm> - <para>&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 + <para>&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;.</para> <para>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.</para> + calls, such as enabling virtual 8086 mode. In addition, 64-bit + &linux; binaries are not supported at this time.</para> <para>After reading this chapter, you will know:</para> @@ -101,51 +99,49 @@ </sect1> <sect1 xml:id="linuxemu-lbc-install"> - <title>Installation</title> + <title>Configuring &linux; Binary Compatibility</title> <indexterm><primary>Ports Collection</primary></indexterm> - <para>&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 - <link linkend="linuxemu-libs-manually">manually</link>.</para> - - <para>Using the Ports Collection is by far the easiest way to - install &linux; libraries:</para> + <para>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.</para> + + <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 port:</para> <screen>&prompt.root; <userinput>cd /usr/ports/emulators/linux_base-f10</userinput> &prompt.root; <userinput>make install distclean</userinput></screen> - <para>Once the port is installed, enable &linux; binary - compatibility by loading the <literal>linux</literal> module. - Type the following as - <systemitem class="username">root</systemitem>:</para> + <para>Once installed, enable &linux; binary + compatibility by loading the <literal>linux</literal> module:</para> <screen>&prompt.root; <userinput>kldload linux</userinput></screen> - <para>In order for &linux; compatibility to always be enabled at - boot time, add the following line to - <filename>/etc/rc.conf</filename>:</para> - - <programlisting>linux_enable="YES"</programlisting> - - <para>To verify that the module is loaded, use - &man.kldstat.8;:</para> + <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> + + <programlisting>linux_enable="YES"</programlisting> + <indexterm> <primary>kernel options</primary> <secondary>COMPAT_LINUX</secondary> </indexterm> <para>Users who prefer to statically link &linux; binary - compatibility into the kernel should add - <literal>options COMPAT_LINUX</literal> to the custom kernel + compatibility into a custom kernel should add + <literal>options COMPAT_LINUX</literal> to their custom kernel configuration file. Compile and install the new kernel as described in <xref linkend="kernelconfig"/>.</para>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201403192347.s2JNlCvn003915>