2020-02-22 17:20:20

by Manbing

[permalink] [raw]
Subject: [PATCH] Documentation: update UserModeLinux-HOWTO.txt

Original content is obsolete. Which is based on kernel 2.4.0-prerelease.
Updating content according to kernel 5.5.1.

Signed-off-by: Manbing <[email protected]>
---
Documentation/virt/uml/UserModeLinux-HOWTO.txt | 42 +++++---------------------
1 file changed, 8 insertions(+), 34 deletions(-)

diff --git a/Documentation/virt/uml/UserModeLinux-HOWTO.txt b/Documentation/virt/uml/UserModeLinux-HOWTO.txt
index 87b80f5..08ee28d 100644
--- a/Documentation/virt/uml/UserModeLinux-HOWTO.txt
+++ b/Documentation/virt/uml/UserModeLinux-HOWTO.txt
@@ -1,6 +1,6 @@
User Mode Linux HOWTO
User Mode Linux Core Team
- Mon Nov 18 14:16:16 EST 2002
+ Mon Feb 10 08:27:24 EST 2020

This document describes the use and abuse of Jeff Dike's User Mode
Linux: a port of the Linux kernel as a normal Intel Linux process.
@@ -215,26 +215,17 @@


Compiling the user mode kernel is just like compiling any other
- kernel. Let's go through the steps, using 2.4.0-prerelease (current
+ kernel. Let's go through the steps, using 5.5.1 (current
as of this writing) as an example:


- 1. Download the latest UML patch from
-
- the download page <http://user-mode-linux.sourceforge.net/
-
- In this example, the file is uml-patch-2.4.0-prerelease.bz2.
-
-
- 2. Download the matching kernel from your favourite kernel mirror,
+ 1. Download the matching kernel from your favourite kernel mirror,
such as:

- ftp://ftp.ca.kernel.org/pub/kernel/v2.4/linux-2.4.0-prerelease.tar.bz2
- <ftp://ftp.ca.kernel.org/pub/kernel/v2.4/linux-2.4.0-prerelease.tar.bz2>
- .
+ wget https://cdn.kernel.org/pub/linux/kernel/v5.x/linux-5.5.1.tar.xz


- 3. Make a directory and unpack the kernel into it.
+ 2. Make a directory and unpack the kernel into it.



@@ -255,31 +246,14 @@


host%
- tar -xzvf linux-2.4.0-prerelease.tar.bz2
-
-
-
-
-
-
- 4. Apply the patch using
-
-
-
- host%
- cd ~/uml/linux
-
-
-
- host%
- bzcat uml-patch-2.4.0-prerelease.bz2 | patch -p1
+ tar xvf linux-5.5.1.tar.xz






- 5. Run your favorite config; `make xconfig ARCH=um' is the most
+ 3. Run your favorite config; `make xconfig ARCH=um' is the most
convenient. `make config ARCH=um' and 'make menuconfig ARCH=um'
will work as well. The defaults will give you a useful kernel. If
you want to change something, go ahead, it probably won't hurt
@@ -293,7 +267,7 @@



- 6. Finish with `make linux ARCH=um': the result is a file called
+ 4. Finish with `make linux ARCH=um': the result is a file called
`linux' in the top directory of your source tree.

Make sure that you don't build this kernel in /usr/src/linux. On some
--
2.7.4


2020-02-22 18:18:41

by Anton Ivanov

[permalink] [raw]
Subject: Re: [PATCH] Documentation: update UserModeLinux-HOWTO.txt



On 22/02/2020 17:19, Manbing wrote:
> Original content is obsolete. Which is based on kernel 2.4.0-prerelease.
> Updating content according to kernel 5.5.1.
>
> Signed-off-by: Manbing <[email protected]>
> ---
> Documentation/virt/uml/UserModeLinux-HOWTO.txt | 42 +++++---------------------
> 1 file changed, 8 insertions(+), 34 deletions(-)
>
> diff --git a/Documentation/virt/uml/UserModeLinux-HOWTO.txt b/Documentation/virt/uml/UserModeLinux-HOWTO.txt
> index 87b80f5..08ee28d 100644
> --- a/Documentation/virt/uml/UserModeLinux-HOWTO.txt
> +++ b/Documentation/virt/uml/UserModeLinux-HOWTO.txt
> @@ -1,6 +1,6 @@
> User Mode Linux HOWTO
> User Mode Linux Core Team
> - Mon Nov 18 14:16:16 EST 2002
> + Mon Feb 10 08:27:24 EST 2020
>
> This document describes the use and abuse of Jeff Dike's User Mode
> Linux: a port of the Linux kernel as a normal Intel Linux process.
> @@ -215,26 +215,17 @@
>
>
> Compiling the user mode kernel is just like compiling any other
> - kernel. Let's go through the steps, using 2.4.0-prerelease (current
> + kernel. Let's go through the steps, using 5.5.1 (current
> as of this writing) as an example:
>
>
> - 1. Download the latest UML patch from
> -
> - the download page <http://user-mode-linux.sourceforge.net/
> -
> - In this example, the file is uml-patch-2.4.0-prerelease.bz2.
> -
> -
> - 2. Download the matching kernel from your favourite kernel mirror,
> + 1. Download the matching kernel from your favourite kernel mirror,
> such as:
>
> - ftp://ftp.ca.kernel.org/pub/kernel/v2.4/linux-2.4.0-prerelease.tar.bz2
> - <ftp://ftp.ca.kernel.org/pub/kernel/v2.4/linux-2.4.0-prerelease.tar.bz2>
> - .
> + wget https://cdn.kernel.org/pub/linux/kernel/v5.x/linux-5.5.1.tar.xz
>
>
> - 3. Make a directory and unpack the kernel into it.
> + 2. Make a directory and unpack the kernel into it.
>
>
>
> @@ -255,31 +246,14 @@
>
>
> host%
> - tar -xzvf linux-2.4.0-prerelease.tar.bz2
> -
> -
> -
> -
> -
> -
> - 4. Apply the patch using
> -
> -
> -
> - host%
> - cd ~/uml/linux
> -
> -
> -
> - host%
> - bzcat uml-patch-2.4.0-prerelease.bz2 | patch -p1
> + tar xvf linux-5.5.1.tar.xz
>
>
>
>
>
>
> - 5. Run your favorite config; `make xconfig ARCH=um' is the most
> + 3. Run your favorite config; `make xconfig ARCH=um' is the most
> convenient. `make config ARCH=um' and 'make menuconfig ARCH=um'
> will work as well. The defaults will give you a useful kernel. If
> you want to change something, go ahead, it probably won't hurt
> @@ -293,7 +267,7 @@
>
>
>
> - 6. Finish with `make linux ARCH=um': the result is a file called
> + 4. Finish with `make linux ARCH=um': the result is a file called
> `linux' in the top directory of your source tree.
>
> Make sure that you don't build this kernel in /usr/src/linux. On some
>

I am rewriting the whole thing at the moment.

I will publish the finished sections for review at some point during the
coming week.

It needs to be rewritten from scratch, fixing a few things like this is
not enough.

Brgds,

--
Anton R. Ivanov

Cambridge Greys Limited, England and Wales company No 10273661
http://www.cambridgegreys.com/