annotate README.md @ 0:53676d1f5817 default tip

firsh commit
author tobaru
date Sun, 04 Feb 2018 17:54:49 +0900
parents
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
0
53676d1f5817 firsh commit
tobaru
parents:
diff changeset
1 xv6-rpi
53676d1f5817 firsh commit
tobaru
parents:
diff changeset
2 =======
53676d1f5817 firsh commit
tobaru
parents:
diff changeset
3
53676d1f5817 firsh commit
tobaru
parents:
diff changeset
4 Project description
53676d1f5817 firsh commit
tobaru
parents:
diff changeset
5 -------
53676d1f5817 firsh commit
tobaru
parents:
diff changeset
6
53676d1f5817 firsh commit
tobaru
parents:
diff changeset
7 [Xv6](http://pdos.csail.mit.edu/6.828/2012/xv6.html) is a simple Unix-like teaching operating system developed in 2006 by MIT for its operating system course. Xv6 is inspired by and modeled after the Sixth Edition Unix (aka V6). Xv6 is fairly complete educational operating system while remaining simply and manageable. It has most components in an early Unix system, such as processes, virtual memory, kernel-user separation, interrupt, file system...
53676d1f5817 firsh commit
tobaru
parents:
diff changeset
8
53676d1f5817 firsh commit
tobaru
parents:
diff changeset
9 The original xv6 is implemented for the x86 architecture. This is an effort to port xv6 to ARM, particularly [Raspberry Pi](http://www.raspberrypi.org/). The initial porting of xv6 to ARM (QEMU/ARMv6) has been completed by people in the department of [computer science](http://www.cs.fsu.edu/) in [Florida State University](http://www.fsu.edu/).
53676d1f5817 firsh commit
tobaru
parents:
diff changeset
10
53676d1f5817 firsh commit
tobaru
parents:
diff changeset
11 Debug
53676d1f5817 firsh commit
tobaru
parents:
diff changeset
12 -------
53676d1f5817 firsh commit
tobaru
parents:
diff changeset
13 1. use QEMU to dump a execution trace
53676d1f5817 firsh commit
tobaru
parents:
diff changeset
14 `qemu-system-arm -M versatilepb -m 128 -cpu arm1176 -nographic -singlestep \
53676d1f5817 firsh commit
tobaru
parents:
diff changeset
15 -d exec,cpu,guest_errors -D qemu.log -kernel kernel.elf`
53676d1f5817 firsh commit
tobaru
parents:
diff changeset
16
53676d1f5817 firsh commit
tobaru
parents:
diff changeset
17 2. insert `show_callstk` in the kernel to dump current call stacks.
53676d1f5817 firsh commit
tobaru
parents:
diff changeset
18
53676d1f5817 firsh commit
tobaru
parents:
diff changeset
19 License
53676d1f5817 firsh commit
tobaru
parents:
diff changeset
20 -------
53676d1f5817 firsh commit
tobaru
parents:
diff changeset
21 The MIT License (MIT)
53676d1f5817 firsh commit
tobaru
parents:
diff changeset
22
53676d1f5817 firsh commit
tobaru
parents:
diff changeset
23 Copyright (c) 2013
53676d1f5817 firsh commit
tobaru
parents:
diff changeset
24
53676d1f5817 firsh commit
tobaru
parents:
diff changeset
25 Permission is hereby granted, free of charge, to any person obtaining a copy of
53676d1f5817 firsh commit
tobaru
parents:
diff changeset
26 this software and associated documentation files (the "Software"), to deal in
53676d1f5817 firsh commit
tobaru
parents:
diff changeset
27 the Software without restriction, including without limitation the rights to
53676d1f5817 firsh commit
tobaru
parents:
diff changeset
28 use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of
53676d1f5817 firsh commit
tobaru
parents:
diff changeset
29 the Software, and to permit persons to whom the Software is furnished to do so,
53676d1f5817 firsh commit
tobaru
parents:
diff changeset
30 subject to the following conditions:
53676d1f5817 firsh commit
tobaru
parents:
diff changeset
31
53676d1f5817 firsh commit
tobaru
parents:
diff changeset
32 The above copyright notice and this permission notice shall be included in all
53676d1f5817 firsh commit
tobaru
parents:
diff changeset
33 copies or substantial portions of the Software.
53676d1f5817 firsh commit
tobaru
parents:
diff changeset
34
53676d1f5817 firsh commit
tobaru
parents:
diff changeset
35 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
53676d1f5817 firsh commit
tobaru
parents:
diff changeset
36 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS
53676d1f5817 firsh commit
tobaru
parents:
diff changeset
37 FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR
53676d1f5817 firsh commit
tobaru
parents:
diff changeset
38 COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER
53676d1f5817 firsh commit
tobaru
parents:
diff changeset
39 IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
53676d1f5817 firsh commit
tobaru
parents:
diff changeset
40 CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.