Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

docs: virt: user_mode_linux.rst: update compiling instructions

Instead of pointing for a pre-2.4 and a seaparate patch,
update it to match current upstream, as UML was merged
a long time ago.

Signed-off-by: Mauro Carvalho Chehab <mchehab+huawei@kernel.org>
Signed-off-by: Paolo Bonzini <pbonzini@redhat.com>

authored by

Mauro Carvalho Chehab and committed by
Paolo Bonzini
72f8a49d 7d94ab16

+9 -53
+9 -53
Documentation/virt/uml/user_mode_linux.rst
··· 5 5 ===================== 6 6 7 7 :Author: User Mode Linux Core Team 8 - :Last-updated: Mon Nov 18 14:16:16 EST 2002 8 + :Last-updated: Sat Jan 25 16:07:55 CET 2020 9 9 10 10 This document describes the use and abuse of Jeff Dike's User Mode 11 11 Linux: a port of the Linux kernel as a normal Intel Linux process. ··· 223 223 224 224 225 225 Compiling the user mode kernel is just like compiling any other 226 - kernel. Let's go through the steps, using 2.4.0-prerelease (current 227 - as of this writing) as an example: 226 + kernel. 228 227 229 228 230 - 1. Download the latest UML patch from 231 - the download page <http://user-mode-linux.sourceforge.net/ 232 - 233 - In this example, the file is uml-patch-2.4.0-prerelease.bz2. 234 - 235 - 236 - 2. Download the matching kernel from your favourite kernel mirror, 229 + 1. Download the latest kernel from your favourite kernel mirror, 237 230 such as: 238 231 239 - ftp://ftp.ca.kernel.org/pub/kernel/v2.4/linux-2.4.0-prerelease.tar.bz2 232 + https://mirrors.edge.kernel.org/pub/linux/kernel/v5.x/linux-5.4.14.tar.xz 240 233 241 - 242 - 3. Make a directory and unpack the kernel into it:: 234 + 2. Make a directory and unpack the kernel into it:: 243 235 244 236 host% 245 237 mkdir ~/uml ··· 240 248 cd ~/uml 241 249 242 250 host% 243 - tar -xzvf linux-2.4.0-prerelease.tar.bz2 251 + tar xvf linux-5.4.14.tar.xz 244 252 245 253 246 - 247 - 4. Apply the patch using:: 248 - 249 - host% 250 - cd ~/uml/linux 251 - 252 - host% 253 - bzcat uml-patch-2.4.0-prerelease.bz2 | patch -p1 254 - 255 - 256 - 257 - 5. Run your favorite config; ``make xconfig ARCH=um`` is the most 254 + 3. Run your favorite config; ``make xconfig ARCH=um`` is the most 258 255 convenient. ``make config ARCH=um`` and ``make menuconfig ARCH=um`` 259 256 will work as well. The defaults will give you a useful kernel. If 260 257 you want to change something, go ahead, it probably won't hurt ··· 257 276 258 277 259 278 260 - 6. Finish with ``make linux ARCH=um``: the result is a file called 279 + 4. Finish with ``make linux ARCH=um``: the result is a file called 261 280 ``linux`` in the top directory of your source tree. 262 - 263 - Make sure that you don't build this kernel in /usr/src/linux. On some 264 - distributions, /usr/include/asm is a link into this pool. The user- 265 - mode build changes the other end of that link, and things that include 266 - <asm/anything.h> stop compiling. 267 - 268 - The sources are also available from cvs at the project's cvs page, 269 - which has directions on getting the sources. You can also browse the 270 - CVS pool from there. 271 - 272 - If you get the CVS sources, you will have to check them out into an 273 - empty directory. You will then have to copy each file into the 274 - corresponding directory in the appropriate kernel pool. 275 - 276 - If you don't have the latest kernel pool, you can get the 277 - corresponding user-mode sources with:: 278 - 279 - 280 - host% cvs co -r v_2_3_x linux 281 - 282 - 283 - 284 - 285 - where 'x' is the version in your pool. Note that you will not get the 286 - bug fixes and enhancements that have gone into subsequent releases. 287 281 288 282 289 283 2.2. Compiling and installing kernel modules ··· 372 416 3.1. Running UML 373 417 ----------------- 374 418 375 - It runs on 2.2.15 or later, and all 2.4 kernels. 419 + It runs on 2.2.15 or later, and all kernel versions since 2.4. 376 420 377 421 378 422 Booting UML is straightforward. Simply run 'linux': it will try to