Port of Xv6 for 25∞2
Go to file
Robert Morris 469aa8b9b3 xx
2016-09-15 12:01:52 -04:00
.cvsignore update .cvsignore 2008-10-15 04:54:24 +00:00
.dir-locals.el Setting indent-tabs-mode nil everywhere is dangerous 2011-09-05 15:22:16 -04:00
.gdbinit.tmpl Use the symbol file 2009-09-20 23:08:36 -04:00
.gitignore Sync up clean and gitignore better 2011-09-05 15:21:40 -04:00
asm.h add some comments 2010-08-05 21:16:55 -04:00
bio.c Move retry loop/sleep/wakeup in bio.c into sleeping locks 2016-09-11 20:17:22 -04:00
bootasm.S nits 2016-08-10 12:06:02 -04:00
bootmain.c Remove trailing white space with: 2016-08-25 09:13:00 -04:00
buf.h Move retry loop/sleep/wakeup in bio.c into sleeping locks 2016-09-11 20:17:22 -04:00
BUGS sh 2007-09-05 15:55:43 +00:00
cat.c more consistent spacing 2007-08-28 18:32:08 +00:00
console.c Replace I_BUSY with sleep locks 2016-09-11 20:59:57 -04:00
cuth delete unnecessary #include lines 2007-08-27 23:26:33 +00:00
date.h coding style (per Jeremías Feltan <jeremias.feltan@gmail.com>) 2015-06-30 16:23:56 -04:00
defs.h Move retry loop/sleep/wakeup in bio.c into sleeping locks 2016-09-11 20:17:22 -04:00
dot-bochsrc make bochsrc work for bochs 2.2.6 2008-09-03 14:10:47 +00:00
echo.c Remove puts in favor of printf. 2007-08-24 20:03:40 +00:00
elf.h Make runoff happy 2016-09-02 15:27:28 -04:00
entry.S even more explicit that entry.S is linked into kernel, unlike bootasm.S. 2016-08-10 11:22:36 -04:00
entryother.S nits 2016-08-10 12:06:02 -04:00
exec.c Straight replacement of B_BUSY with a sleeping lock. 2016-09-11 17:24:04 -04:00
fcntl.h nit 2007-08-28 04:13:24 +00:00
file.c Replace I_BUSY with sleep locks 2016-09-11 20:59:57 -04:00
file.h Replace I_BUSY with sleep locks 2016-09-11 20:59:57 -04:00
forktest.c Remove trailing white space with: 2016-08-25 09:13:00 -04:00
fs.c Replace I_BUSY with sleep locks 2016-09-11 20:59:57 -04:00
fs.h Fix a few lines that runoff is complaining about that they are too long 2016-09-02 14:59:00 -04:00
gdbutil GDB utilities 2009-11-23 17:47:57 -05:00
grep.c Remove trailing white space with: 2016-08-25 09:13:00 -04:00
ide.c Straight replacement of B_BUSY with a sleeping lock. 2016-09-11 17:24:04 -04:00
init.c group locks into structs they protect. 2009-05-31 05:12:21 +00:00
initcode.S nothing much 2016-08-11 15:41:53 -04:00
ioapic.c Remove trailing white space with: 2016-08-25 09:13:00 -04:00
kalloc.c p2v -> P2V 2016-08-24 13:40:06 -04:00
kbd.c be consistent: no underscores in function names 2009-03-08 22:07:13 +00:00
kbd.h formatting; split kbd constants into kbd.h 2007-08-14 19:31:16 +00:00
kernel.ld Nuke data.S, since we do have a custom linker script. 2011-09-02 14:51:55 -04:00
kill.c Disentangle block size from the disk's sector size. Set block size to 1024 to show 2015-04-03 08:22:02 -04:00
lapic.c APIC IDs may not be consecutive and start from zero, so we cannot really use it 2016-09-02 08:31:13 -04:00
LICENSE x 2016-09-08 21:20:17 -04:00
ln.c add ln 2007-08-22 05:54:55 +00:00
log.c Straight replacement of B_BUSY with a sleeping lock. 2016-09-11 17:24:04 -04:00
ls.c Remove trailing white space with: 2016-08-25 09:13:00 -04:00
main.c Make runoff happy 2016-09-02 15:27:28 -04:00
Makefile Straight replacement of B_BUSY with a sleeping lock. 2016-09-11 17:24:04 -04:00
memide.c one more BUSY 2016-09-13 14:51:44 -04:00
memlayout.h p2v -> P2V 2016-08-24 13:40:06 -04:00
mkdir.c more consistent spacing 2007-08-28 18:32:08 +00:00
mkfs.c Remove trailing white space with: 2016-08-25 09:13:00 -04:00
mmu.h Remove trailing white space with: 2016-08-25 09:13:00 -04:00
mp.c APIC IDs may not be consecutive and start from zero, so we cannot really use it 2016-09-02 08:31:13 -04:00
mp.h Nice layout for a printout of the code 2014-08-29 17:06:49 -04:00
Notes nit in console interrupts 2006-09-07 00:00:33 +00:00
param.h check blockno passed to idestart 2015-04-10 07:15:06 -04:00
picirq.c Make runoff happy 2016-09-02 15:27:28 -04:00
pipe.c Replace I_BUSY with sleep locks 2016-09-11 20:59:57 -04:00
pr.pl remove //DOC in the right place 2009-07-12 19:07:30 -07:00
printf.c spaces around else for rtm 2007-08-28 18:37:41 +00:00
printpcs Various fixes and improvements to printpcs 2012-08-24 14:51:52 -04:00
proc.c this might fix the reported deadlock, though I can't reproduce it. 2016-09-08 14:22:38 -04:00
proc.h APIC IDs may not be consecutive and start from zero, so we cannot really use it 2016-09-02 08:31:13 -04:00
README x 2016-09-08 21:20:17 -04:00
rm.c more consistent spacing 2007-08-28 18:32:08 +00:00
runoff no need to generate postscript version 2014-08-29 17:10:32 -04:00
runoff.list Remove data.S from runoff, too 2011-09-02 14:52:53 -04:00
runoff.spec Nice layout for a printout of the code 2014-08-29 17:06:49 -04:00
runoff1 xv6: formatting, cleanup, rev5 (take 2) 2011-02-19 21:17:55 -05:00
sh.c Remove trailing white space with: 2016-08-25 09:13:00 -04:00
show1 PDF at http://am.lcs.mit.edu/~rsc/xv6.pdf 2007-08-22 06:01:32 +00:00
sign.pl spacing fixes: no tabs, 2-space indents (for rtm) 2006-09-06 17:04:06 +00:00
sleep1.p Model verifying that wakeup really 2007-10-12 04:21:04 +00:00
sleeplock.c sleeplock files 2016-09-11 21:01:24 -04:00
sleeplock.h sleeplock files 2016-09-11 21:01:24 -04:00
spinlock.c xx 2016-09-15 12:01:52 -04:00
spinlock.h Remove trailing white space with: 2016-08-25 09:13:00 -04:00
spinp Model verifying that wakeup really 2007-10-12 04:21:04 +00:00
stat.h junk 2012-08-28 12:57:05 -04:00
stressfs.c Remove trailing white space with: 2016-08-25 09:13:00 -04:00
string.c Remove trailing white space with: 2016-08-25 09:13:00 -04:00
swtch.S move jkstack to main.c 2010-08-05 14:15:03 -04:00
symlink.patch symlink implementation 2007-08-30 18:36:38 +00:00
syscall.c Remove trailing white space with: 2016-08-25 09:13:00 -04:00
syscall.h Remove left-over from some logging plan making complete syscalls atomic 2012-08-22 20:28:58 -04:00
sysfile.c Replace I_BUSY with sleep locks 2016-09-11 20:59:57 -04:00
sysproc.c Remove trailing white space with: 2016-08-25 09:13:00 -04:00
timer.c shuffle and tweak for formatting. 2009-08-08 01:07:30 -07:00
toc.ftr Update index example in TOC footer 2011-09-02 16:30:20 -04:00
toc.hdr nits 2007-08-28 18:23:48 +00:00
trap.c APIC IDs may not be consecutive and start from zero, so we cannot really use it 2016-09-02 08:31:13 -04:00
trapasm.S One definition of several macros and constants 2011-08-08 13:30:08 -04:00
traps.h kill TLB shoot down code 2010-07-28 14:38:05 -04:00
TRICKS use acquire/release to force order for pid=np->pid;np->state=RUNNING 2014-08-04 06:13:49 -04:00
types.h some cleanup 2010-07-25 20:30:21 -04:00
uart.c Replace I_BUSY with sleep locks 2016-09-11 20:59:57 -04:00
ulib.c Remove trailing white space with: 2016-08-25 09:13:00 -04:00
umalloc.c make new code like old code 2011-01-11 13:01:13 -05:00
user.h cmosgetdate() for system-call homework 2014-09-12 18:09:51 -04:00
usertests.c set iomb to forbid i/o instructions from user space 2016-08-26 08:20:11 -04:00
usys.S uptime() sys call for benchmarking 2010-08-11 14:34:45 -04:00
vectors.pl sync with c; .text is implied 2009-05-31 01:00:38 +00:00
vm.c curproc -> proc in a comment 2016-09-01 17:21:37 -04:00
wc.c junk 2012-08-28 12:57:05 -04:00
x86.h Remove trailing white space with: 2016-08-25 09:13:00 -04:00
zombie.c Remove trailing white space with: 2016-08-25 09:13:00 -04:00

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.

ACKNOWLEDGMENTS

xv6 is inspired by John Lions's 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/2016/xv6.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 (entryother.S, mp.h, mp.c, lapic.c)
    FreeBSD (ioapic.c)
    NetBSD (console.c)

The following people have made contributions: Russ Cox (context switching,
locking), Cliff Frey (MP), Xiao Yu (MP), Nickolai Zeldovich, and Austin
Clements.

We are also grateful for the bug reports and patches contributed by Silas
Boyd-Wickizer, Mike CAT, Nelson Elhage, Nathaniel Filardo, Peter Froehlich,
Yakir Goaran, Shivam Handa, Bryan Henry, Jim Huang, Anders Kaseorg, kehao95,
Eddie Kohler, Imbar Marinescu, Yandong Mao, Hitoshi Mitake, Carmi Merimovich,
Joel Nider, Greg Price, Ayan Shafqat, Eldar Sehayek, Yongming Shen, Cam Tenny,
Rafael Ubal, Warren Toomey, Stephen Tu, Pablo Ventura, Xi Wang, Keiichi
Watanabe, Nicolas Wolovick, Jindong Zhang, and Zou Chang Wei.

The code in the files that constitute xv6 is
Copyright 2006-2016 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).  If you have
suggestions for improvements, please keep in mind that the main purpose of xv6
is as a teaching operating systems for MIT's 6.828. For example, we are in
particular interested in simplifications and clarifications, instead of
suggestions for new systems calls, more portability, etc.

BUILDING 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/2016/tools.html.
Then run "make TOOLPREFIX=i386-jos-elf-".

To run xv6, install the QEMU PC simulators.  To run in QEMU, run "make qemu".

To create a typeset version of the code, run "make xv6.pdf".  This
requires the "mpage" utility.  See http://www.mesa.nl/pub/mpage/.