Port of Xv6 for 25∞2
Go to file
Frans Kaashoek ed396c068b Eliminate code for gs trick to track per-cpu state. We rely on lapiccpunum()
to find a per-cpu id with which we locate a cpu's cpu struct.
2017-02-01 18:04:13 -05: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 Remove left-over print statements 2016-09-15 19:16:30 -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 Check result of write (thans to Alexander Kapshuk <alexander.kapshuk@gmail) 2016-09-19 07:01:30 -04:00
console.c Start of an experiment to remove the use of gs for cpu local variables. 2017-01-31 17:47:16 -05: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 Eliminate code for gs trick to track per-cpu state. We rely on lapiccpunum() 2017-02-01 18:04:13 -05: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 Read curproc from cpu structure, but be careful because after a schedule event 2017-01-31 20:21:14 -05: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 Start of an experiment to remove the use of gs for cpu local variables. 2017-01-31 17:47:16 -05: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 Start of an experiment to remove the use of gs for cpu local variables. 2017-01-31 17:47:16 -05: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 Eliminate code for gs trick to track per-cpu state. We rely on lapiccpunum() 2017-02-01 18:04:13 -05: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 Eliminate code for gs trick to track per-cpu state. We rely on lapiccpunum() 2017-02-01 18:04:13 -05:00
Makefile Thanks to Wolfgang Keller <nubok@users.noreply.github.com> 2017-01-30 20:09:54 -05:00
memide.c Thanks to Jeehoon Kang <jeehoon.kang@sf.snu.ac.kr> 2017-01-30 20:01:33 -05: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 Eliminate code for gs trick to track per-cpu state. We rely on lapiccpunum() 2017-02-01 18:04:13 -05: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 Start of an experiment to remove the use of gs for cpu local variables. 2017-01-31 17:47:16 -05: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 Eliminate code for gs trick to track per-cpu state. We rely on lapiccpunum() 2017-02-01 18:04:13 -05:00
proc.h Eliminate code for gs trick to track per-cpu state. We rely on lapiccpunum() 2017-02-01 18:04:13 -05:00
README wolfgang keller 2017-01-30 20:24:13 -05: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 Add sleeplock.[ch] to listing 2016-09-14 08:43:57 -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 Start of an experiment to remove the use of gs for cpu local variables. 2017-01-31 17:47:16 -05:00
sleeplock.h sleeplock files 2016-09-11 21:01:24 -04:00
spinlock.c Start of an experiment to remove the use of gs for cpu local variables. 2017-01-31 17:47:16 -05: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 Read curproc from cpu structure, but be careful because after a schedule event 2017-01-31 20:21:14 -05:00
syscall.h Remove left-over from some logging plan making complete syscalls atomic 2012-08-22 20:28:58 -04:00
sysfile.c Read curproc from cpu structure, but be careful because after a schedule event 2017-01-31 20:21:14 -05:00
sysproc.c Start of an experiment to remove the use of gs for cpu local variables. 2017-01-31 17:47:16 -05: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 Start of an experiment to remove the use of gs for cpu local variables. 2017-01-31 17:47:16 -05:00
trapasm.S Eliminate code for gs trick to track per-cpu state. We rely on lapiccpunum() 2017-02-01 18:04:13 -05: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 Add mikecat's argp test 2016-09-26 07:54:02 -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 Eliminate code for gs trick to track per-cpu state. We rely on lapiccpunum() 2017-02-01 18:04:13 -05: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, Cody Cutler, Mike CAT, Nelson Elhage, Nathaniel Filardo, Peter
Froehlich, Yakir Goaron, Shivam Handa, Bryan Henry, Jim Huang, Anders Kaseorg,
kehao95, Wolfgang Keller, 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 system 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/.