Annotation of www/23.html, Revision 1.45
1.44 bentley 1: <!doctype html>
2: <html lang=en id=release>
3: <meta charset=utf-8>
4:
1.33 deraadt 5: <title>OpenBSD 2.3</title>
1.41 tb 6: <meta name="description" content="OpenBSD 2.3">
7: <meta name="viewport" content="width=device-width, initial-scale=1">
8: <link rel="stylesheet" type="text/css" href="openbsd.css">
1.43 tb 9: <link rel="canonical" href="https://www.openbsd.org/23.html">
1.44 bentley 10: <style>
11: #release #OpenBSD + table td {
12: vertical-align: middle;
13: }
14: </style>
1.1 deraadt 15:
1.44 bentley 16: <h2 id=OpenBSD>
1.41 tb 17: <a href="index.html">
1.44 bentley 18: <i>Open</i><b>BSD</b></a>
19: 2.3
1.41 tb 20: </h2>
1.1 deraadt 21:
1.44 bentley 22: <table>
23: <tr>
24: <td>
1.33 deraadt 25: <a href=images/openbsd23_cover.gif>
1.44 bentley 26: <img src=images/cd23-s.gif alt="CD 2.3"></a>
27: <td>
1.7 deraadt 28: Released May 19, 1998.<br>
1.33 deraadt 29: Copyright 1997-1998, Theo de Raadt.<br>
1.44 bentley 30: <cite class=isbn>ISBN 0-9683637-1-7</cite>.
1.1 deraadt 31: <p>
32: <ul>
1.33 deraadt 33: <li>See the information on <a href=ftp.html>The FTP page</a> for
34: a list of mirror machines
1.44 bentley 35: <li>Go to the <code class=reldir>pub/OpenBSD/2.3/</code> directory on
1.33 deraadt 36: one of the mirror sites
1.16 deraadt 37: <li>Have a look at <a href=errata23.html>The 2.3 Errata page</a> for a list
1.1 deraadt 38: of bugs and workarounds.
39: </ul>
1.42 tb 40: <p>
1.41 tb 41: All applicable copyrights and credits are in the src.tar.gz,
42: sys.tar.gz, xenocara.tar.gz, ports.tar.gz files, or in the
43: files fetched via ports.tar.gz.
1.44 bentley 44: </table>
1.1 deraadt 45:
1.41 tb 46: <hr>
1.44 bentley 47:
48: <section id=install>
49: <h3>How to install</h3>
1.1 deraadt 50: <p>
1.9 deraadt 51: Following this are the instructions which you would have on a piece of
1.33 deraadt 52: paper if you had purchased a CDROM set instead of doing an alternate
53: form of install. The instructions for doing an FTP (or other style
54: of) install are very similar; the CDROM instructions are left intact
55: so that you can see how much easier it would have been if you had
56: purchased a CDROM instead.
1.1 deraadt 57: <p>
1.33 deraadt 58:
1.1 deraadt 59: <hr>
1.25 jsyn 60: Please refer to the following files on the two CDROMs for extensive
1.1 deraadt 61: details on how to install OpenBSD 2.3 on your machine:
62: <p>
1.44 bentley 63: <ul>
1.45 ! deraadt 64: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/2.3/i386/INSTALL.i386">
! 65: .../OpenBSD/2.3/i386/INSTALL.i386 (on CD1)</a>
! 66: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/2.3/arc/INSTALL.arc">
! 67: .../OpenBSD/2.3/arc/INSTALL.arc (on CD1)</a>
! 68: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/2.3/mac68k/INSTALL.mac68k">
! 69: .../OpenBSD/2.3/mac68k/INSTALL.mac68k (on CD1)</a>
! 70: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/2.3/pmax/INSTALL.pmax">
! 71: .../OpenBSD/2.3/pmax/INSTALL.pmax (on CD1)</a>
! 72: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/2.3/sparc/INSTALL.sparc">
! 73: .../OpenBSD/2.3/sparc/INSTALL.sparc (on CD1)</a>
! 74: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/2.3/hp300/INSTALL.hp300">
! 75: .../OpenBSD/2.3/hp300/INSTALL.hp300 (on CD1)</a>
! 76: <p>
! 77: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/2.3/amiga/INSTALL.amiga">
! 78: .../OpenBSD/2.3/amiga/INSTALL.amiga (on CD2)</a>
! 79: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/2.3/alpha/INSTALL.alpha">
! 80: .../OpenBSD/2.3/alpha/INSTALL.alpha (on CD2)</a>
! 81: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/2.3/mvme68k/INSTALL.mvme68k">
! 82: .../OpenBSD/2.3/mvme68k/INSTALL.mvme68k (on CD2)</a>
! 83: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/2.3/powerpc/INSTALL.powerpc">
! 84: .../OpenBSD/2.3/powerpc/INSTALL.powerpc (on CD2)</a>
1.44 bentley 85: </ul>
1.45 ! deraadt 86: </section>
1.44 bentley 87:
1.1 deraadt 88: <hr>
1.44 bentley 89:
90: <section id=quickinstall>
1.1 deraadt 91: <p>
92: Quick installer information for people familiar with OpenBSD, and the
93: use of the new "disklabel -E" command. If you are at all confused when
94: installing OpenBSD, read the relevant INSTALL.* file as listed above!
95: <p>
1.45 ! deraadt 96: <h3>OpenBSD/i386:</h3>
1.1 deraadt 97: <p>
98: Play with your BIOS options, and see if you can enable booting off a
1.4 deraadt 99: CD; try using CD1. If not, write CD1:2.3/i386/floppy23.fs to a
1.1 deraadt 100: floppy, then boot that. If you are mixing OpenBSD with another
101: operating system, you will surely need to read the INSTALL.i386
102: document.
103: <p>
104: To make a floppy under MS-DOS, use /2.3/tools/rawrite.exe. Under
1.22 wvdputte 105: Unix, use "dd if=<file> of=/dev/<device> bs=32k" (where device could
1.1 deraadt 106: be "floppy" or "rfd0c" or "rfd0a"). Use properly formatted perfect
107: floppies with NO BAD BLOCKS or you will lose.
108: <p>
1.45 ! deraadt 109: <h3>OpenBSD/arc:</h3>
1.1 deraadt 110: <p>
111: Using CD1, tell the BOOT ROM to load the file CD1:\2.3\arc\bsd.rd. If
112: that does not work, create a MS-DOS filesystem using your vendor's arc
113: setup program, copy CD1:2.3/arc/bsd.rd to there and attempt to boot
114: it.
115: <p>
1.45 ! deraadt 116: <h3>OpenBSD/sparc:</h3>
1.1 deraadt 117: <p>
118: To boot off CD1, type "boot cdrom 2.3/sparc/bsd.rd", or
119: "b sd(0,6,0)2.3/sparc/bsd.rd" depending on your ROM version.
1.4 deraadt 120: Alternatively, write CD1:2.3/sparc/floppy23.fs to a floppy and boot it
1.1 deraadt 121: using "boot fd()" or "boot floppy" depending on your ROM version.
122: Finally, a third alternative is to write CD1:2.3/sparc/kc.fs and
1.14 ryker 123: CD1:2.3/sparc/inst.fs to two separate floppies. Then insert "kc.fs",
1.1 deraadt 124: and boot as described above. As soon as the floppy drive ejects a
125: floppy, insert "inst.fs". Answer a bunch of questions. Reboot from
126: the "kc.fs" floppy. This time, when the floppy is ejected simply
127: re-insert "kc.fs" again and answer a different set of questions.
128: <p>
1.45 ! deraadt 129: <h3>OpenBSD/pmax:</h3>
1.1 deraadt 130: <p>
1.4 deraadt 131: Write the simpleroot23.fs onto the start of the disk using dd on another
1.1 deraadt 132: machine. After moving the disk drive, use "boot -f rz(0,0,0)/bsd"
133: (2100/3100) or "boot 5/rz0a/bsd" (5000). Alternatively, install via
134: network as described in detail in INSTALL.pmax.
135: <p>
1.45 ! deraadt 136: <h3>OpenBSD/amiga:</h3>
1.1 deraadt 137: <p>
138: Create BSD partitions according to INSTALL.amiga's preparation section.
139: Mount the CD2 under AmigaOS as device CD0: Next, execute the following
140: CLI command: "CD0:2.3/amiga/utils/loadbsd CD0:2.3/amiga/bsd.rd".
141: <p>
1.45 ! deraadt 142: <h3>OpenBSD/hp300:</h3>
1.1 deraadt 143: <p>
144: You can boot over the network by following the instructions in
145: INSTALL.hp300.
146: <p>
1.45 ! deraadt 147: <h3>OpenBSD/alpha:</h3>
1.1 deraadt 148: <p>
149: Your alpha must use SRM firmware (not ARC). If you have a CDROM, you
150: can try "boot -fi 2.3/alpha/bsd.rd dkaX" (use "show device" to find your
151: CDROM drive identifier). Otherwise, write CD2:2.3/alpha/floppy.fs to a
152: floppy and boot that by typing "boot dva0". If this fails, you can place
153: bsd.rd on some other device and boot it, or use the provided simpleroot.
154: <p>
1.45 ! deraadt 155: <h3>OpenBSD/mac68k:</h3>
1.1 deraadt 156: <p>
157: Boot MacOS as normal and partition your disk with the appropriate A/UX
158: configurations. Then, extract the Macside utilities from
159: CD1:2.3/mac68k/utils onto your hard disk. Run Mkfs to create your
160: filesystems on the A/UX partitions you just made. Then, use the
161: BSD/Mac68k Installer to copy all the sets in CD1:2.3/mac68k/ onto your
162: partitions. Finally, you will be ready to configure the BSD/Mac68k
163: Booter with the location of your kernel and boot the system.
164: <p>
1.45 ! deraadt 165: <h3>OpenBSD/mvme68k:</h3>
1.1 deraadt 166: <p>
167: Theo has no real idea. In the rush to get everything else done, the
168: install stuff for the mvme68k was never completed. Enough pieces are
169: included so that a really skilled person could find a way to install
170: it; perhaps using netbooting. Good luck!
1.44 bentley 171: </section>
172:
1.1 deraadt 173: <hr>
1.44 bentley 174:
175: <section id=sourcecode>
1.45 ! deraadt 176: <h3>Notes about the source code</h3>
1.1 deraadt 177: <p>
178: src.tar.gz contains a source archive starting at /usr/src. This file
179: contains everything you need except for the kernel sources, which are
1.14 ryker 180: in a separate archive. To extract:
1.1 deraadt 181: <p>
1.45 ! deraadt 182: <blockquote><pre>
! 183: # <kbd>mkdir -p /usr/src</kbd>
! 184: # <kbd>cd /usr/src</kbd>
! 185: # <kbd>tar xvfz /tmp/src.tar.gz</kbd>
! 186: </pre></blockquote>
1.1 deraadt 187: <p>
188: srcsys.tar.gz contains a source archive starting at /usr/src/sys.
189: This file contains all the kernel sources you need to rebuild kernels.
190: To extract:
191: <p>
1.45 ! deraadt 192: <blockquote><pre>
! 193: # <kbd>mkdir -p /usr/src/sys</kbd>
! 194: # <kbd>cd /usr/src</kbd>
! 195: # <kbd>tar xvfz /tmp/srcsys.tar.gz</kbd>
! 196: </pre></blockquote>
1.1 deraadt 197: <p>
198: Both of these trees are a regular CVS checkout. Using these trees it
199: is possible to get a head-start on using the anoncvs servers as
1.45 ! deraadt 200: described <a href="anoncvs.html">here</a>.
1.1 deraadt 201: Using these files
202: results in a much faster initial CVS update than you could expect from
203: a fresh checkout of the full OpenBSD source tree.
1.44 bentley 204: </section>
205:
1.1 deraadt 206: <hr>
1.44 bentley 207:
208: <section id=ports>
1.45 ! deraadt 209: <h3>Ports Tree</h3>
1.1 deraadt 210: <p>
211: A ports tree archive is also provided. To extract:
212: <p>
1.45 ! deraadt 213: <blockquote><pre>
! 214: # <kbd>cd /usr</kbd>
! 215: # <kbd>tar xvfz /tmp/ports.tar.gz</kbd>
! 216: # <kbd>cd ports</kbd>
! 217: # <kbd>ls</kbd>
1.1 deraadt 218: ...
1.45 ! deraadt 219: </pre></blockquote>
1.1 deraadt 220: <p>
221: The ports/ subdirectory is a checkout of the OpenBSD ports tree. Go
1.31 jasper 222: read <a href=faq/faq15.html>http://www.OpenBSD.org/faq/faq15.html</a>
1.1 deraadt 223: if you know nothing about ports
224: at this point. This text is not a manual of how to use ports.
225: Rather, it is a set of notes meant to kickstart the user on the
226: OpenBSD ports system.
227: <p>
228: Certainly, the OpenBSD ports system is not complete. This is because
229: the full integration of ports into the OpenBSD environment is a very
230: young project as of this release. We believe the ports that are
231: provided here are stable, but it is most important to realize that
1.14 ryker 232: ports will continue to grow a great deal in functionality in the
1.1 deraadt 233: future.
234: <p>
235: As we said, ports will be growing a lot in the future. The ports/
236: directory represents a CVS (see the manpage for cvs(1) if you aren't
237: familiar with CVS) checkout of our ports. As with our complete source
238: tree, we will soon be making ports available via anoncvs. So, in
239: order to keep current with the, you must make the ports/ tree
240: available on a read-write medium and update the tree with a command
241: like:
242: <p>
1.45 ! deraadt 243: <blockquote><pre>
! 244: # <kbd>cd [portsdir]/; cvs -d anoncvs@server.openbsd.org:/cvs update -Pd</kbd>
! 245: </pre></blockquote>
1.1 deraadt 246: <p>
247: [Of course, you must replace the local directory and server name here
248: with the location of your ports collection and a nearby anoncvs
249: server.]
250: <p>
251: Again, it's important to see the webpage for specific instructions as
252: this is a very new service which hasn't yet been ironed out
253: completely.
254: <p>
255: Finally, despite ports' youth, help is never far. If you're
256: interested in seeing a port added, would like to help out, or just
1.45 ! deraadt 257: would like to know more, the mailing list
! 258: <a href="mail.html">ports@openbsd.org</a> is a good place to know.
1.44 bentley 259: </section>