Table of Contents

1. Introduction

1.1 Getting Started

1.1.1 Obtaining Pintos
1.1.2 Building Bochs
1.1.3 Installing QEMU
1.1.4 Setting up your Path
1.1.5 Building Pintos
1.1.6 Running Pintos
1.1.7 Source Tree Overview
1.1.8 What "make" makes for you
1.1.9 Debugging versus Testing

1.2 Grading

1.2.1 Testing
1.2.2 Design

1.2.2.1 Design Document
1.2.2.2 Source Code

1.3 Submitting
1.4 Legal and Ethical Issues
1.5 Acknowledgements
1.6 Trivia

2. Project 1: Threads

2.1 Background

2.1.1 Understanding Threads
2.1.2 Source Files

2.1.2.1 devices code
2.1.2.2 lib files

2.1.3 Synchronization
2.1.4 Development Suggestions

2.2 Requirements

2.2.1 Design Document
2.2.2 Understanding Context Switching
2.2.3 Alarm Clock
2.2.4 Priority Scheduling

2.3 FAQ

2.3.1 Alarm Clock FAQ
2.3.2 Priority Scheduling FAQ

3. Project 2: User Programs

3.1 Background

3.1.1 Source Files
3.1.2 Using the File System
3.1.3 How User Programs Work
3.1.4 Virtual Memory Layout

3.1.4.1 Typical Memory Layout

3.1.5 Accessing User Memory

3.2 Project 2 Suggested Order of Things You Should Do
3.3 Requirements

3.3.1 Design Document
3.3.2 Process Termination Messages
3.3.3 Argument Passing
3.3.4 System Calls
3.3.5 Denying Writes to Executables

3.4 FAQ

3.4.1 Argument Passing FAQ
3.4.2 System Calls FAQ

3.5 80x86 Calling Convention

3.5.1 Program Startup Details
3.5.2 System Call Details

4. Project 3: Virtual Memory

4.1 Background

4.1.1 Source Files
4.1.2 Memory Terminology

4.1.2.1 Pages
4.1.2.2 Frames
4.1.2.3 Page Tables
4.1.2.4 Swap Slots

4.1.3 Resource Management Overview
4.1.4 Managing the Supplemental Page Table
4.1.5 Managing the Frame Table

4.1.5.1 Accessed and Dirty Bits

4.1.6 Managing the Swap Table
4.1.7 Managing Memory Mapped Files

4.2 Suggested Order of Implementation
4.3 Requirements

4.3.1 Design Document
4.3.2 System Call Completion
4.3.3 Paging
4.3.4 Stack Growth
4.3.5 Memory Mapped Files
4.3.6 Accessing User Memory

4.4 FAQ

5. Project 4: File Systems

5.1 Background

5.1.1 New Code
5.1.2 Testing File System Persistence

5.2 Suggested Order of Implementation
5.3 Requirements

5.3.1 Design Document
5.3.2 Indexed and Extensible Files
5.3.3 Subdirectories
5.3.4 Buffer Cache
5.3.5 Synchronization

5.4 FAQ

5.4.1 Indexed Files FAQ
5.4.2 Subdirectories FAQ
5.4.3 Buffer Cache FAQ

A. Reference Guide

A.1 Loading

A.1.1 The Loader
A.1.2 Low-Level Kernel Initialization
A.1.3 High-Level Kernel Initialization
A.1.4 Physical Memory Map

A.2 Threads

A.2.1 struct thread
A.2.2 Thread Functions
A.2.3 Thread Switching

A.3 Synchronization

A.3.1 Disabling Interrupts
A.3.2 Semaphores
A.3.3 Locks
A.3.4 Monitors

A.3.4.1 Monitor Example

A.4 Interrupt Handling

A.4.1 Interrupt Infrastructure
A.4.2 Internal Interrupt Handling
A.4.3 External Interrupt Handling

A.5 Memory Allocation

A.5.1 Page Allocator
A.5.2 Block Allocator

A.6 Virtual Addresses
A.7 Page Table

A.7.1 Creation, Destruction, and Activation
A.7.2 Inspection and Updates
A.7.3 Accessed and Dirty Bits
A.7.4 Page Table Details

A.7.4.1 Structure
A.7.4.2 Page Table Entry Format
A.7.4.3 Page Directory Entry Format

A.8 Hash Table

A.8.1 Data Types
A.8.2 Basic Functions
A.8.3 Search Functions
A.8.4 Iteration Functions
A.8.5 Hash Table Example
A.8.6 Auxiliary Data
A.8.7 Synchronization

B. Coding Standards

B.1 Style
B.2 C99
B.3 Unsafe String Functions

C. Project Documentation

C.1 Sample Assignment
C.2 Sample Design Document

D. Debugging Tools

D.1 printf()
D.2 ASSERT
D.3 Function and Parameter Attributes
D.4 Backtraces

D.4.1 Example

D.5 GDB

D.5.1 Using GDB
D.5.2 Example GDB Session
D.5.3 FAQ

D.6 Triple Faults
D.7 Tips

E. Development Tools

E.1 Tags
E.2 cscope

F. Installing Pintos
Bibliography

F.1 Hardware References
F.2 Software References
F.3 Operating System Design References

License