103f48901SAustin Clements# Is sheet 01 (after the TOC) a left sheet or a right sheet? 2*74c77da6SFrans Kaashoeksheet1: left 39d7a63e0SAustin Clements 4d2c7f649SAustin Clements# "left" and "right" specify which page of a two-page spread a file 5d2c7f649SAustin Clements# must start on. "left" means that a file must start on the first of 6d49d3138SAustin Clements# the two pages. "right" means it must start on the second of the two 7d2c7f649SAustin Clements# pages. The file may start in either column. 8d2c7f649SAustin Clements# 9d2c7f649SAustin Clements# "even" and "odd" specify which column a file must start on. "even" 10cf4b1ad9SRuss Cox# means it must start in the left of the two columns (00). "odd" means it 11cf4b1ad9SRuss Cox# must start in the right of the two columns (50). 12d49d3138SAustin Clements# 13d49d3138SAustin Clements# You'd think these would be the other way around. 14d2c7f649SAustin Clements 15eaea18cbSrsc# types.h either 16eaea18cbSrsc# param.h either 17eaea18cbSrsc# defs.h either 18eaea18cbSrsc# x86.h either 19eaea18cbSrsc# asm.h either 20eaea18cbSrsc# mmu.h either 21eaea18cbSrsc# elf.h either 22eaea18cbSrsc# mp.h either 23eaea18cbSrsc 242a2e6eb1SAustin Clementseven: entry.S # mild preference 252a2e6eb1SAustin Clementseven: entryother.S # mild preference 26f1f8dd91Srsceven: main.c 27eaea18cbSrsc# mp.c don't care at all 280aef8914SRuss Cox# even: initcode.S 290aef8914SRuss Cox# odd: init.c 30eaea18cbSrsc 312a2e6eb1SAustin Clementsleft: spinlock.h 322a2e6eb1SAustin Clementseven: spinlock.h 33d8828817SAustin Clements 34d8828817SAustin Clements# This gets struct proc and allocproc on the same spread 35cf4b1ad9SRuss Coxleft: proc.h 36cf4b1ad9SRuss Coxeven: proc.h 370aef8914SRuss Cox 380aef8914SRuss Cox# goal is to have two action-packed 2-page spreads, 390aef8914SRuss Cox# one with 40d8828817SAustin Clements# userinit growproc fork exit wait 410aef8914SRuss Cox# and another with 420aef8914SRuss Cox# scheduler sched yield forkret sleep wakeup1 wakeup 43cf4b1ad9SRuss Coxright: proc.c # VERY important 44cf4b1ad9SRuss Coxeven: proc.c # VERY important 450aef8914SRuss Cox 46f25a3f9aSAustin Clements# A few more action packed spreads 47f25a3f9aSAustin Clements# page table creation and process loading 482a2e6eb1SAustin Clements# walkpgdir mappages setupkvm switch[ku]vm inituvm (loaduvm) 49f25a3f9aSAustin Clements# process memory management 50f25a3f9aSAustin Clements# allocuvm deallocuvm freevm 51cf4b1ad9SRuss Coxleft: vm.c 52f25a3f9aSAustin Clements 532a2e6eb1SAustin Clementseven: kalloc.c # mild preference 54eaea18cbSrsc 55eaea18cbSrsc# syscall.h either 56eaea18cbSrsc# trapasm.S either 57eaea18cbSrsc# traps.h either 580aef8914SRuss Cox# even: trap.c 59eaea18cbSrsc# vectors.pl either 60eaea18cbSrsc# syscall.c either 61eaea18cbSrsc# sysproc.c either 62eaea18cbSrsc 63eaea18cbSrsc# buf.h either 64eaea18cbSrsc# dev.h either 65eaea18cbSrsc# fcntl.h either 66eaea18cbSrsc# stat.h either 67eaea18cbSrsc# file.h either 68eaea18cbSrsc# fs.h either 69eaea18cbSrsc# fsvar.h either 70cf4b1ad9SRuss Cox# left: ide.c # mild preference 715bf11c50SAustin Clementseven: ide.c 72eaea18cbSrsc# odd: bio.c 73cf4b1ad9SRuss Cox 742a2e6eb1SAustin Clements# log.c fits nicely in a spread 752a2e6eb1SAustin Clementseven: log.c 762a2e6eb1SAustin Clementsleft: log.c 772a2e6eb1SAustin Clements 78cf4b1ad9SRuss Cox# with fs.c starting on 2nd column of a left page, we get these 2-page spreads: 79cf4b1ad9SRuss Cox# ialloc iupdate iget idup ilock iunlock iput iunlockput 80cf4b1ad9SRuss Cox# bmap itrunc stati readi writei 81cf4b1ad9SRuss Cox# namecmp dirlookup dirlink skipelem namex namei 822a2e6eb1SAustin Clements# fileinit filealloc filedup fileclose filestat fileread filewrite 83cf4b1ad9SRuss Cox# starting on 2nd column of a right page is not terrible either 84eaea18cbSrscodd: fs.c # VERY important 85cf4b1ad9SRuss Coxleft: fs.c # mild preference 86eaea18cbSrsc# file.c either 87eaea18cbSrsc# exec.c either 88eaea18cbSrsc# sysfile.c either 89eaea18cbSrsc 902a2e6eb1SAustin Clements# Mild preference, but makes spreads of mp.c, lapic.c, and ioapic.c+picirq.c 912a2e6eb1SAustin Clementseven: mp.c 922a2e6eb1SAustin Clementsleft: mp.c 932a2e6eb1SAustin Clements 940c931af5Srsc# even: pipe.c # mild preference 95eaea18cbSrsc# string.c either 96cf4b1ad9SRuss Cox# left: kbd.h # mild preference 975bf11c50SAustin Clementseven: kbd.h 98eae04163Srsceven: console.c 99eae04163Srscodd: sh.c 1002a2e6eb1SAustin Clements 1012a2e6eb1SAustin Clementseven: bootasm.S # mild preference 1022a2e6eb1SAustin Clementseven: bootmain.c # mild preference 103