Commit yaboot 1.3.1
[yaboot.git] / doc / README.rs6000
1 RS/6000 yaboot Notes
2 ---------------------
3
4 A. System Partitioning:
5    1. Only FDISK partitioning has been tested on the RS/6000.
6       However, yaboot does support mac partitions on a mac, so they should
7       work on an RS/6000 if you really want to go that route.
8    2. Extended FDISK partitions have not been tested and are not expected to
9       work at this time.
10    3. yaboot must be installed by itself in a bootable partition of type 0x41.
11       This partition must be less than 10MB.
12
13    Recommended partition configuration:
14       /dev/sda1 : PREP Boot.    Type 0x41. Size = 800K
15       /dev/sda2 : Linux swap.   Type 0x82. Size = 128 MB
16       /dev/sda3 : Linux native. Type 0x83.
17
18 B. Building & Installation:
19    1. See the partitioning section for notes & examples on how to configure
20       your system partitions when installing Linux.
21    2. Build yaboot by doing:
22        make clean; make
23    3. Make a yaboot.conf file in /etc/yaboot.conf
24    4. Install yaboot by doing (as root):
25       mkofboot
26
27 C. Configuration File (/etc/yaboot.conf):
28    1. See the yaboot.conf(5) man page for the full range of options.
29    2. Options tested on an RS/6000 include:
30       timeout = <time in tenths of a second>
31       default = <default label>
32       root= <device containing the root filesystem>
33       image = <path to vmlinux kernel file>
34       label = <short name for this image>
35
36    3. Examples:
37
38       ## example /etc/yaboot.conf for RS/6000
39       ## Timeout value is in tenths of a second
40       boot=/dev/sda1
41       fstype=raw
42       install=/usr/local/lib/yaboot/yaboot
43       nonvram
44       partition=3
45       timeout=200
46       default=linux
47
48       image=/boot/vmlinux
49       label=linux
50       root=/dev/sda3
51
52       image=/boot/vmlinux.new
53       label=new
54       root=/dev/sda3
55
56
57 D. Tested Configurations:
58    1. RS/6000 Model 150 (PPC 604e; CHRP IBM,7043-150)
59
60       fdisk -l /dev/sda
61
62       Disk /dev/sda: 64 heads, 32 sectors, 8678 cylinders
63       Units = cylinders of 2048 * 512 bytes
64
65          Device Boot    Start       End    Blocks   Id  System
66       /dev/sda1   *         1         9      9200   41  PPC PReP Boot
67       /dev/sda2            10      2010   2049024   83  Linux
68       /dev/sda3          2011      2139    132096   82  Linux swap
69
70    2. RS/6000 Model 260 (PPC 630; CHRP IBM,7043-260)
71
72    3. RS/6000 Model F50 (PPC 630; CHRP IBM,7025-F50)
73
74
75 E. Other Documentation:
76    1. man pages under man/
77    2. other README files in doc/
78
79 F. Questions & comments can be directed to:
80    engebret@us.ibm.com or
81    bergner@us.ibm.com
82