5692823b1f
cut last line of readme so that readme fits on single page
50 lines
1.9 KiB
Plaintext
50 lines
1.9 KiB
Plaintext
xv6 is a re-implementation of Dennis Ritchie's and Ken Thompson's Unix
|
|
Version 6 (v6). xv6 loosely follows the structure and style of v6,
|
|
but is implemented for a modern x86-based multiprocessor using ANSI C.
|
|
|
|
ACKNOWLEDGEMENTS
|
|
|
|
xv6 is inspired by John Lions' Commentary on UNIX 6th Edition (Peer
|
|
to Peer Communications; ISBN: 1-57398-013-7; 1st edition (June 14,
|
|
2000)). See also http://pdos.csail.mit.edu/6.828/2006/v6.html, which
|
|
provides pointers to on-line resources for v6.
|
|
|
|
xv6 borrows code from the following sources:
|
|
JOS (asm.h, elf.h, mmu.h, bootasm.S, ide.c, console.c, and others)
|
|
Plan 9 (bootother.S, mp.h, mp.c, ioapic.h, lapic.c)
|
|
FreeBSD (ioapic.c)
|
|
NetBSD (console.c)
|
|
|
|
The following people made contributions:
|
|
Russ Cox (context switching, locking)
|
|
Cliff Frey (MP)
|
|
Xiao Yu (MP)
|
|
|
|
The code in the files that constitute xv6 are
|
|
Copyright 2006 Frans Kaashoek, Robert Morris, and Russ Cox.
|
|
|
|
ERROR REPORTS
|
|
|
|
If you spot errors or have suggestions for improvement, please send
|
|
email to Frans Kaashoek and Robert Morris
|
|
({kaashoek,rtm}@csail.mit.edu). This version is the very first one,
|
|
so don't be surprised if there are errors or the code is unclear.
|
|
|
|
BUIDLING AND RUNNING XV6
|
|
|
|
To build xv6 on an x86 ELF machine (like Linux or FreeBSD), run "make".
|
|
On non-x86 or non-ELF machines (like OS X, even on x86), you will
|
|
need to install a cross-compiler gcc suite capable of producing x86 ELF
|
|
binaries. See http://pdos.csail.mit.edu/6.828/2006/tools.html.
|
|
Then run "make TOOLPREFIX=i386-jos-elf-".
|
|
|
|
To run xv6, you can use Bochs or QEMU, both PC simulators. Bochs makes
|
|
debugging easier, but QEMU is much faster.
|
|
To run in Bochs, run "make bochs" and then type "c" at the bochs prompt.
|
|
To run in QEMU, run "make qemu". Both log the xv6 screen output to
|
|
standard output.
|
|
|
|
To create a typeset version of the code, run "make xv6.pdf".
|
|
This requires the "mpage" text formatting utility.
|
|
See http://www.mesa.nl/pub/mpage/.
|