Annotation of www/35.html, Revision 1.126
1.119 bentley 1: <!doctype html>
2: <html lang=en id=release>
3: <meta charset=utf-8>
4:
1.100 deraadt 5: <title>OpenBSD 3.5</title>
1.1 deraadt 6: <meta name="description" content="OpenBSD 3.5">
1.111 tb 7: <meta name="viewport" content="width=device-width, initial-scale=1">
8: <link rel="stylesheet" type="text/css" href="openbsd.css">
1.114 tb 9: <link rel="canonical" href="https://www.openbsd.org/35.html">
1.1 deraadt 10:
1.119 bentley 11: <h2 id=OpenBSD>
1.1 deraadt 12: <a href="index.html">
1.119 bentley 13: <i>Open</i><b>BSD</b></a>
14: 3.5
1.111 tb 15: </h2>
1.1 deraadt 16:
1.119 bentley 17: <table>
18: <tr>
19: <td>
1.1 deraadt 20: <a href="images/Carp.gif">
1.126 ! deraadt 21: <img width="255" height="343" src="images/Carp.gif" alt="Carp"></a>
1.119 bentley 22: <td>
1.1 deraadt 23: Released May 1, 2004<br>
24: Copyright 1997-2004, Theo de Raadt.<br>
1.119 bentley 25: <cite class=isbn>ISBN 0-9731791-3-9</cite>
1.93 deraadt 26: <br>
1.108 deraadt 27: 3.5 Song: <a href="lyrics.html#35">"CARP License" and "Redundancy must be free"</a>
1.118 deraadt 28: <br>
29: <br>
1.1 deraadt 30: <ul>
1.123 deraadt 31: <li>See the information on <a href="ftp.html">the FTP page</a> for
1.1 deraadt 32: a list of mirror machines.
1.119 bentley 33: <li>Go to the <code class=reldir>pub/OpenBSD/3.5/</code> directory on
1.1 deraadt 34: one of the mirror sites.
1.92 miod 35: <li>Have a look at <a href="errata35.html">The 3.5 Errata page</a> for a list
1.1 deraadt 36: of bugs and workarounds.
1.88 deraadt 37: <li>See a <a href="plus35.html">detailed log of changes</a> between the
1.1 deraadt 38: 3.4 and 3.5 releases.
39: </ul>
1.112 tb 40: <p>
1.111 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
1.122 deraadt 43: files fetched via <code>ports.tar.gz</code>.
1.119 bentley 44: </table>
1.1 deraadt 45:
1.111 tb 46: <hr>
1.119 bentley 47:
48: <section id=new>
49: <h3>What's New</h3>
1.1 deraadt 50: <p>
51: This is a partial list of new features and systems included in OpenBSD 3.5.
1.88 deraadt 52: For a comprehensive list, see the <a href="plus35.html">changelog</a> leading
1.1 deraadt 53: to 3.5.
54: <p>
55:
56: <ul>
57:
1.14 deraadt 58: <li> New platforms:
59: <ul>
1.74 deraadt 60: <li><a href="amd64.html">OpenBSD/amd64</a><br>
61: Supporting the AMD64 architecture natively,
62: with full 64-bit support, 8 extra registers in the architecture
63: to significantly increase performance, and a memory management
64: Non-Executable bit that permits full W^X support.<br>
1.94 david 65: (Note: The upcoming Intel "ia32e" AMD64-compatible CPUs have also
1.74 deraadt 66: been tested, and work, even though they lack the NX bit).
67: <li><a href="cats.html">OpenBSD/cats</a><br>
1.94 david 68: Our first entry in the ARM-CPU landscape. We intend to use this as a
1.74 deraadt 69: development platform for something else we plan for the future...
70: <li><a href="mvme88k.html">OpenBSD/mvme88k</a><br>
1.94 david 71: Supporting an older, but very cool CPU architecture, perhaps the
72: most pure RISC CPU ever.
1.14 deraadt 73: </ul>
74: <p>
75:
1.35 otto 76: <li>Replacement of the GNU
1.119 bentley 77: <a href="https://man.openbsd.org/bc">bc(1)</a>,
78: <a href="https://man.openbsd.org/dc">dc(1)</a>,
79: <a href="https://man.openbsd.org/nm">nm(1)</a> and
80: <a href="https://man.openbsd.org/size">size(1)</a>
1.1 deraadt 81: commands with BSD licensed equivalents.
82: <p>
83:
1.5 mcbride 84: <li>A large number of bug fixes, changes, and optimizations to our packet filter
1.119 bentley 85: <a href="https://man.openbsd.org/pf">pf(4)</a>
1.5 mcbride 86: including:
87: <ul>
1.19 otto 88: <li>Atomic commits of ruleset changes (reduce the chance of ending up in an
89: inconsistent state).
1.69 djm 90: <li>A 30% reduction in the size of state table entries.
1.19 otto 91: <li>Source-tracking (limit number of clients and states per client).
92: <li>Sticky-address (the flexibility of round-robin with the benefits of
93: source-hash).
1.53 mcbride 94: <li>Invert the socket match order when redirecting to
1.34 avsm 95: localhost (prevents the potential security problem of remote connections
1.19 otto 96: being identified as local).
1.5 mcbride 97: <li>Significant improvements to interface handling.
98: </ul>
99: <p>
100:
1.53 mcbride 101: <li>New tools for filtering gateway failover:
1.5 mcbride 102: <ul>
103: <li>CARP (the Common Address Redundancy Protocol)
1.119 bentley 104: <a href="https://man.openbsd.org/carp">carp(4)</a>
1.5 mcbride 105: allows multiple machines to share responsibility for a given IP address or
106: addresses. If the owner of the address fails, another member of the group
107: will take over for it. A discussion of the history of CARP can be found
1.62 deraadt 108: <a href="lyrics.html">here</a>.
1.5 mcbride 109: <li>Additions to the
1.119 bentley 110: <a href="https://man.openbsd.org/pfsync">pfsync(4)</a>
1.5 mcbride 111: interface allow it to synchronise state table entries between two or more
112: firewalls which are operating in parallel, allowing stateful connections
113: to cross any of the firewalls regardless of where the state was initially
114: created.
115: </ul>
116: <p>
117:
1.6 todd 118: <li> New functionality:
119: <ul>
1.119 bentley 120: <li><a href="https://man.openbsd.org/pty.4">pty(4)</a> devices are now allocated on demand, up to a configurable limit.
121: <li>New ptm device (see <a href="https://man.openbsd.org/pty.4">pty(4)</a>)
1.47 deraadt 122: that allows non-privileged processes to allocate a properly-permissioned pty.<br>
123: As a result any process can now open a pty easily, meaning
1.119 bentley 124: <a href="https://man.openbsd.org/xterm.1">xterm(1)</a>
1.111 tb 125: and
1.119 bentley 126: <a href="https://man.openbsd.org/xconsole.1">xconsole(1)</a>
1.47 deraadt 127: are no longer setuid root. (In 3.4 they were setuid root, but privilege revoking).
1.119 bentley 128: <li>The <a href="https://man.openbsd.org/closefrom.2">closefrom(2)</a>
1.17 otto 129: system call has been added.
1.119 bentley 130: <li>TCP MD5 signatures (used by <a href="https://man.openbsd.org/nc.1">nc(1)</a>
131: and <a href="https://man.openbsd.org/bgpd.8">bgpd(8)</a>).
1.70 djm 132: <li>Network boot support for i386 and amd64, using
1.119 bentley 133: <a href="https://man.openbsd.org/i386/pxeboot.8">pxeboot(8)</a>.
1.19 otto 134: <li>The i386 8GB boot loader limitation has been removed.
1.119 bentley 135: <li><a href="https://man.openbsd.org/spamd.8">spamd(8)</a>
1.52 beck 136: gains <a href="http://projects.puremagic.com/greylisting/">greylisting</a> support. This allows greylisting (a very powerful spam reduction technique) to be
137: done on a firewall for many mail hosts, no matter what MTA is being used.
1.80 tdeval 138: <li>Interface 'cloning', accessed by
1.119 bentley 139: <a href="https://man.openbsd.org/ifconfig.8">ifconfig(8)</a>
140: commands <em>create</em> and <em>destroy</em>. E.g. 'ifconfig vlan100 create'.
1.82 tdeval 141: <li>
1.119 bentley 142: <a href="https://man.openbsd.org/ifconfig.8">ifconfig(8)</a>
143: can now be used with a generic <em>interface</em> name, for listing all such configured interfaces. E.g. 'ifconfig carp'.
1.47 deraadt 144: <li>The MAKEDEV(8) manual pages are now generated, and hence, accurate.
1.119 bentley 145: <li>Complete rewrite of <a href="https://man.openbsd.org/pkg_add.1">package</a> tools in perl.
146: <li><a href="https://man.openbsd.org/syslogd.8">syslogd(8)</a>
1.111 tb 147: now supports logging to memory buffers, to be read using
1.119 bentley 148: <a href="https://man.openbsd.org/syslogc.8">syslogc(8)</a>.
1.47 deraadt 149: This is useful for diskless or flash-based computers.
1.119 bentley 150: <li><a href="https://man.openbsd.org/ipsec.4">IPsec</a> ESP in UDP encapsulation.
151: <li><a href="https://man.openbsd.org/malloc.3">
1.79 tdeval 152: malloc(3)</a> chunk randomization and guard pages. This helps to detect out-of-bounds
1.33 otto 153: reads and writes.
1.119 bentley 154: <li><a href="https://man.openbsd.org/authpf.8">
1.43 beck 155: authpf(8)</a> now tags traffic in
1.119 bentley 156: <a href="https://man.openbsd.org/pflog.4">
1.43 beck 157: pflog(4)</A> so that users may be associated with traffic through a NAT setup.
1.46 tedu 158: <li>hw.setperf sysctl allows controlling the speed of many new i386
1.119 bentley 159: <a href="https://man.openbsd.org/cpu&arch=i386">CPUs</a>,
1.91 henning 160: great for prolonged battery life.
1.48 beck 161: <li>XFS has been added to the GENERIC kernels so that
1.119 bentley 162: <a href="https://man.openbsd.org/afsd.8">afsd(8)
1.48 beck 163: </a> may be started easily, eliminating the need to recompile the kernel
1.49 deraadt 164: to use AFS.<br>
165: AFS can now be used anonymously by enabling it in
1.119 bentley 166: <a href="https://man.openbsd.org/rc.conf.8">rc.conf(8)</a>
1.48 beck 167: with no further configuration.
1.119 bentley 168: <li>The <a href="https://man.openbsd.org/ps.1">ps</a>, <a href="https://man.openbsd.org/top.1">top</a> and <a href="https://man.openbsd.org/w.1">w</a> utilities no longer break when changes are made in kernel structures.
169: <li>A <a href="https://man.openbsd.org/poll.2">poll</a> interface has been added to the <a href="https://man.openbsd.org/rpc.3">rpc</a> routines in the standard C library. Use of <a href="https://man.openbsd.org/poll.2">poll</a> over <a href="https://man.openbsd.org/select.2">select</a> can result in better performance for programs with a large number of open file descriptors.
170: <li><a href="https://man.openbsd.org/dhclient.8"
1.64 krw 171: >dhclient(8)</a> now detects when the interface it configured is modified and
172: gracefully exits.
173: e.g. repeatedly running it against the same interface leaves only the
174: last instance active.
1.6 todd 175: </ul>
176: <p>
177:
1.47 deraadt 178: <li> Privilege separation added to allow complex operations to occur in an untrusted, unprivileged process, resulting in much greater security for the following processes:
1.6 todd 179: <ul>
1.119 bentley 180: <li><a href="https://man.openbsd.org/isakmpd.8">isakmpd(8)</a>
181: <li><a href="https://man.openbsd.org/named.8">named(8)</a>
1.47 deraadt 182: (Previously privilege revoking, but this had a small breakage).
1.119 bentley 183: <li><a href="https://man.openbsd.org/pflogd.8">pflogd(8)</a>
184: <li><a href="https://man.openbsd.org/tcpdump.8">tcpdump(8)</a>
1.6 todd 185: </ul>
186: <p>
187:
188: <li> New tools:
189: <ul>
1.119 bentley 190: <li><a href="https://man.openbsd.org/sensorsd.8">sensorsd(8)</a>, monitoring hardware sensors.
191: <li><a href="https://man.openbsd.org/procmap.1">procmap(1)</a>, to examine a process' memory map.
192: <li><a href="https://man.openbsd.org/bgpd.8">bgpd(8)</a>, implementing the <a href="https://www.rfc-editor.org/rfc/rfc1771.txt">BGP-4</a> routing protocol.
193: <li><a href="https://man.openbsd.org/pkill.1">pkill(1)</a> and
194: <a href="https://man.openbsd.org/pgrep.1">pgrep(1)</a>, finding or signalling processes by name.
1.6 todd 195: </ul>
196: <p>
197:
1.23 henning 198: <li> Performance improvements:
199: <ul>
1.35 otto 200: <li>Improved connection/socket lookup - about 100 times faster at 10000 sockets than 3.4.
1.72 djm 201: <li>TCP SYN cache. Greatly reduces the memory cost of half-open TCP connections.
1.71 djm 202: <li>Implemented TCP adjustments recommended by
1.116 tb 203: <a href="https://www.rfc-editor.org/rfc/rfc3390.txt">RFC3390</a>,
1.71 djm 204: controllable via
1.119 bentley 205: <a href="https://man.openbsd.org/sysctl.8">sysctl</a>.
1.23 henning 206: <li>OpenSSL speedup on i386, up to 100% improvement for md5, sha1, blowfish,
1.42 henning 207: des, 3des, rsa, dsa and bn.
1.77 tdeval 208: <li>OpenSSL now directly uses the new AES instructions some VIA C3 processors
209: provide, increasing AES to 780MBytes/second (so you get to see a fan-less
1.94 david 210: CPU performing AES more than 10x faster than the fastest CPU currently sold).
1.45 tedu 211: <li>Directory hashing makes lookups in large directories much faster.
1.90 mcbride 212: <li>Zeroing pages with SSE. Faster operation, and avoids clobbering the cache.
1.23 henning 213: </ul>
214: <p>
215:
1.119 bentley 216: <li><a href="https://man.openbsd.org/scsi.4">SCSI(4)</a> improvements:
1.67 krw 217: <ul>
1.73 otto 218: <li>Bus probe made faster by skipping non-existent LUNs.
1.67 krw 219: <li>Bus probe made saner by elimination of spurious commands.
220: <li>Bus probe made safer by having INQUIRY commands ask only for available data.
1.81 krw 221: <li>Eliminated a race that, e.g., caused problems burning CDs at high speeds.
1.67 krw 222: <li>SCSIDEBUG output can now be restricted to specified buses.
223: <li>ASC/ASCQ diagnostic messages updated to SCSI-3 standards.
224: <li>Better error handling.
225: </ul>
226: <p>
227:
1.29 henning 228: <li>Improved hardware support, including:
229: <ul>
1.111 tb 230: <li>The <a href="hppa.html">hppa</a> architecture gets support for many
1.119 bentley 231: <a href="https://man.openbsd.org/pci">PCI</a>
232: based machines w/ addition of <a href="https://man.openbsd.org/hppa/dino.4">dino(4)</a> GSC-PCI bridge.
233: <li>New <a href="https://man.openbsd.org/oosiop.4">oosiop(4)</a> driver for NCR 53C700 SCSI host adapters.
234: <li>Major improvements to <a href="https://man.openbsd.org/ahc.4">ahc(4)</a>, bringing support for many new models.
235: <li>New <a href="https://man.openbsd.org/bce.4">bce(4)</a> driver, supporting the Broadcom BCM4401 FastEthernet chipset.
236: <li>New <a href="https://man.openbsd.org/mpt.4">mpt(4)</a> driver for LSI Fusion-MPT SCSI and FibreChannel host adapters.
237: <li>New <a href="https://man.openbsd.org/macppc/snapper.4">snapper(4)</a> audio driver for recent iBook (since May 02) and PowerBook (since Apr 02) models.
238: <li>Improved stability of the <a href="https://man.openbsd.org/wi.4">wi(4)</a> driver as well as support for USB-based adapters and software WEP.
239: <li><a href="https://man.openbsd.org/wi.4">wi(4)</a> in HostAP mode now supports SSID hiding and newer prism firmware revisions.
240: <li>Fixed several firmware incompatibility issues in <a href="https://man.openbsd.org/an.4">an(4)</a>.
1.68 grange 241: <li>Improved ATA and SATA support.
1.119 bentley 242: <li>Support for i835 AGP GART in <a href="https://man.openbsd.org/vga.4">vga(4)</a>.
243: <li>Improved Gigabit Ethernet support for <a href="https://man.openbsd.org/em.4">em(4)</a>, <a href="https://man.openbsd.org/sk.4">sk(4)</a> & <a href="https://man.openbsd.org/bge.4">bge(4)</a>.
244: <li>Several fixes for <a href="https://man.openbsd.org/apm.4">apm(4)</a>.
1.63 marco 245: <li>Support for Intel 852/855/865 AGP chipsets.
1.67 krw 246: <li>Many more USB Flash and other
1.119 bentley 247: <a href="https://man.openbsd.org/umass.4">umass(4)</a> devices work as a result of SCSI improvements.
1.29 henning 248: </ul>
1.20 otto 249: <p>
250:
1.57 marco 251: <li> This release ships with Firefox for all major architectures.
252: <p>
253:
1.119 bentley 254: <li> Major improvements in <a href="https://man.openbsd.org/pthreads.3">pthreads(3)</a>.
1.58 marco 255: <p>
256:
1.18 sturm 257: <li> Over 2500 ports, 2300 pre-built packages.
258: <p>
259:
1.7 todd 260: <li>Many improvements for security and reliability (look for the red
1.88 deraadt 261: print in the <a href="plus35.html">complete changelog</a>).
1.7 todd 262: <p>
263:
1.19 otto 264: <li>Many improvements in manual pages and other documentation.
265: <p>
266:
1.40 tdeval 267: <li>Gcc 3.3.2, including local additions like ProPolice support, for the
1.62 deraadt 268: <a href="amd64.html">OpenBSD/amd64</a>,
269: <a href="cats.html">OpenBSD/cats</a> and
270: <a href="sparc64.html">OpenBSD/sparc64</a>
1.28 henning 271: platforms.
272: Other architectures still use gcc 2.95.3 with the same local additions.
273: <p>
1.75 markus 274: <li>OpenSSH 3.8.1:
275: <ul>
276: <li>
1.119 bentley 277: <a href="https://man.openbsd.org/sshd.8">sshd(8)</a>
1.75 markus 278: now supports forced changes of expired passwords via
1.119 bentley 279: <a href="https://man.openbsd.org/passwd.1">passwd(1)</a>.
1.75 markus 280: <li>
1.119 bentley 281: <a href="https://man.openbsd.org/ssh.1">ssh(1)</a>
1.75 markus 282: now uses untrusted cookies for X11-Forwarding.
283: Some X11 applications might need full access to the X11 server,
284: see ForwardX11Trusted in
1.119 bentley 285: <a href="https://man.openbsd.org/ssh_config.5">ssh_config(5)</a>
1.75 markus 286: and
1.119 bentley 287: <a href="https://man.openbsd.org/xauth.1">xauth(1)</a>.
1.75 markus 288: <li>
1.119 bentley 289: <a href="https://man.openbsd.org/ssh.1">ssh(1)</a>
1.75 markus 290: now supports sending application layer
291: keep-alive messages to the server. See ServerAliveInterval in
1.119 bentley 292: <a href="https://man.openbsd.org/ssh_config.5">ssh_config(5)</a>.
1.75 markus 293: <li> Improved
1.119 bentley 294: <a href="https://man.openbsd.org/sftp.1">sftp(1)</a>
1.75 markus 295: batch file support.
296: <li> New KerberosGetAFSToken option for
1.119 bentley 297: <a href="https://man.openbsd.org/sshd.8">sshd(8)</a>.
1.75 markus 298: <li> Updated /etc/moduli file and improved performance for
299: protocol version 2.
300: <li> Support for host keys in DNS.
301: <li> The experimental "gssapi" support has been replaced with
302: the "gssapi-with-mic" to fix possible MITM attacks.
303: The two versions are not compatible.
304: </ul>
305: <p>
1.28 henning 306:
307: <li>The system includes the following major components from outside suppliers:
308: <ul>
309: <li>XFree86 4.4.0 unencumbered (+ patches, and i386 contains 3.3.X servers also, thus
310: providing support for all chipsets)
1.40 tdeval 311: <li>Gcc 2.95.3 (+ patches) and 3.3.2 (+ patches)
1.28 henning 312: <li>Perl 5.8.2 (+ patches)
313: <li>Apache 1.3.29, mod_ssl 2.8.16, DSO support (+ patches)
314: <li>OpenSSL 0.9.7c (+ patches)
315: <li>Groff 1.15
316: <li>Sendmail 8.12.11
317: <li>Bind 9.2.3 (+ patches)
318: <li>Lynx 2.8.4rel.1 with HTTPS and IPv6 support (+ patches)
319: <li>Sudo 1.6.7p5
320: <li>Ncurses 5.2
321: <li>Latest KAME IPv6
322: <li>Heimdal 0.6rc1 (+ patches)
323: <li>Arla-current
324: </ul>
325: <p>
1.1 deraadt 326:
327: </ul>
1.119 bentley 328: </section>
1.1 deraadt 329:
330: <hr>
1.119 bentley 331:
332: <section id=install>
333: <h3>How to install</h3>
1.1 deraadt 334: <p>
335: Following this are the instructions which you would have on a piece of
336: paper if you had purchased a CDROM set instead of doing an alternate
337: form of install. The instructions for doing an ftp (or other style
338: of) install are very similar; the CDROM instructions are left intact
339: so that you can see how much easier it would have been if you had
340: purchased a CDROM instead.
341: <p>
342:
343: <hr>
344: Please refer to the following files on the three CDROMs or ftp mirror for
345: extensive details on how to install OpenBSD 3.5 on your machine:
346: <p>
347: <ul>
1.120 deraadt 348: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.5/i386/INSTALL.i386">
349: .../OpenBSD/3.5/i386/INSTALL.i386 (on CD1)</a>
350: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.5/vax/INSTALL.vax">
351: .../OpenBSD/3.5/vax/INSTALL.vax (on CD1)</a>
352: <p>
353: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.5/amd64/INSTALL.amd64">
354: .../OpenBSD/3.5/amd64/INSTALL.amd64 (on CD2)</a>
355: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.5/macppc/INSTALL.macppc">
356: .../OpenBSD/3.5/macppc/INSTALL.macppc (on CD2)</a>
357: <p>
358: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.5/sparc/INSTALL.sparc">
359: .../OpenBSD/3.5/sparc/INSTALL.sparc (on CD3)</a>
360: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.5/sparc64/INSTALL.sparc64">
361: .../OpenBSD/3.5/sparc64/INSTALL.sparc64 (on CD3)</a>
362: <p>
363: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.5/alpha/INSTALL.alpha">
364: .../OpenBSD/3.5/alpha/INSTALL.alpha</a>
365: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.5/cats/INSTALL.cats">
366: .../OpenBSD/3.5/cats/INSTALL.cats</a>
367: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.5/hp300/INSTALL.hp300">
368: .../OpenBSD/3.5/hp300/INSTALL.hp300</a>
369: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.5/hppa/INSTALL.hppa">
370: .../OpenBSD/3.5/hppa/INSTALL.hppa</a>
371: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.5/mac68k/INSTALL.mac68k">
372: .../OpenBSD/3.5/mac68k/INSTALL.mac68k</a>
373: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.5/mvme68k/INSTALL.mvme68k">
374: .../OpenBSD/3.5/mvme68k/INSTALL.mvme68k</a>
375: <li><a href="https://ftp.openbsd.org/pub/OpenBSD/3.5/mvme88k/INSTALL.mvme88k">
376: .../OpenBSD/3.5/mvme88k/INSTALL.mvme88k</a>
1.1 deraadt 377: </ul>
1.120 deraadt 378: </section>
379:
1.1 deraadt 380: <hr>
381:
1.119 bentley 382: <section id=quickinstall>
383:
1.1 deraadt 384: <p>
385: Quick installer information for people familiar with OpenBSD, and the
386: use of the "disklabel -E" command. If you are at all confused when
387: installing OpenBSD, read the relevant INSTALL.* file as listed above!
1.119 bentley 388:
389: <h3>OpenBSD/i386:</h3>
390:
1.1 deraadt 391: <p>
392: Play with your BIOS options to enable booting from a CD. The OpenBSD/i386
393: release is on CD1. If your BIOS does not support booting from CD, you will need
394: to create a boot floppy to install from. To create a boot floppy write
1.2 deraadt 395: <i>CD1:3.5/i386/floppy35.fs</i> to a floppy and boot via the floppy drive.
1.1 deraadt 396:
397: <p>
1.2 deraadt 398: Use <i>CD1:3.5/i386/floppyB35.fs</i> instead for greater scsi controller
399: support, or <i>CD1:3.5/i386/floppyC35.fs</i> for better laptop support.
1.1 deraadt 400:
401: <p>
1.83 tom 402: If you can't boot from a CD or a floppy disk,
403: you can install across the network using PXE as described in
404: the included INSTALL.i386 document.
405:
406: <p>
1.1 deraadt 407: If you are planning on dual booting OpenBSD with another OS, you will need to
1.83 tom 408: read INSTALL.i386.
1.1 deraadt 409:
410: <p>
411: To make a boot floppy under MS-DOS, use the "rawrite" utility located
1.83 tom 412: at <i>CD1:3.5/tools/rawrite.exe</i>. To make the boot floppy under a Unix OS,
1.119 bentley 413: use the <a href="https://man.openbsd.org/dd.1">dd(1)</a>
414: utility. The following is an example usage of
415: <a href="https://man.openbsd.org/dd.1">dd(1)
1.1 deraadt 416: </a>, where the device could be "floppy", "rfd0c", or
417: "rfd0a".
418:
1.119 bentley 419: <blockquote><pre>
420: # <kbd>dd if=<file> of=/dev/<device> bs=32k</kbd>
421: </pre></blockquote>
1.1 deraadt 422:
423: <p>
424: Make sure you use properly formatted perfect floppies with NO BAD BLOCKS or
425: your install will most likely fail. For more information on creating a boot
426: floppy and installing OpenBSD/i386 please refer to
1.113 tj 427: <a href="faq/faq4.html#MkFlop">this page</a>.
1.119 bentley 428:
429: <h3>OpenBSD/vax:</h3>
1.1 deraadt 430:
431: <p>
1.84 miod 432: Boot over the network via mopbooting as described in INSTALL.vax.
1.119 bentley 433:
434: <h3>OpenBSD/amd64:</h3>
1.1 deraadt 435:
436: <p>
1.84 miod 437: The 3.5 release of OpenBSD/amd64 is located on CD2.
1.83 tom 438: Boot from the CD to begin the install - you may need to adjust
439: your BIOS options first.
440: If you can't boot from the CD, you can create a boot floppy to install from.
1.85 tom 441: To do this, write <i>CD2:3.5/amd64/floppy35.fs</i> to a floppy, then
1.83 tom 442: boot from the floppy drive.
443:
444: <p>
445: If you can't boot from a CD or a floppy disk,
446: you can install across the network using PXE as described in the included
447: INSTALL.amd64 document.
448:
449: <p>
450: If you are planning to dual boot OpenBSD with another OS, you will need to
451: read INSTALL.amd64.
1.119 bentley 452:
453: <h3>OpenBSD/macppc:</h3>
1.2 deraadt 454:
455: <p>
1.84 miod 456: Put the CD2 in your CDROM drive and poweron your machine while holding down the
457: <i>C</i> key until the display turns on and shows <i>OpenBSD/macppc boot</i>.
458:
459: <p>
460: Alternatively, at the Open Firmware prompt, enter <i>boot cd:,ofwboot
461: /3.5/macppc/bsd.rd</i>
1.119 bentley 462:
463: <h3>OpenBSD/sparc:</h3>
1.1 deraadt 464:
465: <p>
466: The 3.5 release of OpenBSD/sparc is located on CD3. To boot off of this CD you
467: can use one of the two commands listed below, depending on the version of your
468: ROM.
469:
1.119 bentley 470: <blockquote><pre>
471: ok <kbd>boot cdrom 3.5/sparc/bsd.rd</kbd>
1.1 deraadt 472: or
1.119 bentley 473: > <kbd>b sd(0,6,0)3.5/sparc/bsd.rd</kbd>
474: </pre></blockquote>
1.1 deraadt 475:
476: <p>
477: If your sparc does not have a CD drive, you can alternatively boot from floppy.
1.84 miod 478: To do so you need to write <i>CD3:3.5/sparc/floppy35.fs</i> to a floppy.
1.113 tj 479: For more information see <a href="faq/faq4.html#MkFlop">this page</a>. To boot from
1.1 deraadt 480: the floppy use one of the two commands listed below, depending on the version of
481: your ROM.
482:
1.119 bentley 483: <blockquote><pre>
484: ok <kbd>boot floppy</kbd>
1.1 deraadt 485: or
1.119 bentley 486: > <kbd>boot fd()</kbd>
487: </pre></blockquote>
1.1 deraadt 488:
489: <p>
490: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
491: will most likely fail.
492:
493: <p>
494: If your sparc doesn't have a floppy drive nor a CD drive, you can either
495: setup a bootable tape, or install via network, as told in the
496: INSTALL.sparc file.
1.119 bentley 497:
498: <h3>OpenBSD/sparc64:</h3>
1.1 deraadt 499:
500: <p>
501: Put the CD3 in your CDROM drive and type <i>boot cdrom</i>.
502:
503: <p>
504: If this doesn't work, or if you don't have a CDROM drive, you can write
1.2 deraadt 505: <i>CD3:3.5/sparc64/floppy35.fs</i> to a floppy and boot it with <i>boot
1.1 deraadt 506: floppy</i>.<br>
507: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
508: will most likely fail.
509:
510: <p>
1.2 deraadt 511: You can also write <i>CD3:3.5/sparc64/miniroot35.fs</i> to the swap partition on
1.1 deraadt 512: the disk and boot with <i>boot disk:b</i>.
513:
514: <p>
515: If nothing works, you can boot over the network as described in INSTALL.sparc64
1.119 bentley 516:
517: <h3>OpenBSD/alpha:</h3>
1.1 deraadt 518:
519: <p>
1.120 deraadt 520: Write <i>3.5/alpha/floppy35.fs</i> or
521: <i>3.5/alpha/floppyB35.fs</i> (depending on your machine) to a diskette and
1.1 deraadt 522: enter <i>boot dva0</i>. Refer to INSTALL.alpha for more details.
523:
524: <p>
525: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
526: will most likely fail.
527:
1.119 bentley 528: <h3>OpenBSD/cats:</h3>
1.1 deraadt 529:
530: <p>
1.87 miod 531: After updating the firmware to at least ABLE 1.95 if necessary, boot
1.120 deraadt 532: <i>3.5/cats/bsd.rd</i> from an ABLE-supported device (such as a CD-ROM
1.87 miod 533: or an existing FFS or EXT2FS partition).
1.119 bentley 534:
535: <h3>OpenBSD/hp300:</h3>
1.87 miod 536:
537: <p>
1.1 deraadt 538: Boot over the network by following the instructions in INSTALL.hp300.
1.119 bentley 539:
540: <h3>OpenBSD/hppa:</h3>
1.1 deraadt 541:
542: <p>
543: Boot over the network by following the instructions in INSTALL.hppa or the
544: <a href="hppa.html#netboot">hppa platform page</a>.
545:
1.119 bentley 546: <h3>OpenBSD/mac68k:</h3>
547:
1.1 deraadt 548: <p>
549: Boot MacOS as normal and partition your disk with the appropriate A/UX
550: configurations. Then, extract the Macside utilities from
1.120 deraadt 551: <i>3.5/mac68k/utils</i> onto your hard disk. Run Mkfs to create your
1.1 deraadt 552: filesystems on the A/UX partitions you just made. Then, use the
1.120 deraadt 553: "BSD/Mac68k Installer" to copy all the sets in <i>3.5/mac68k/</i> onto your
1.1 deraadt 554: partitions. Finally, you will be ready to configure the "BSD/Mac68k
555: Booter" with the location of your kernel and boot the system.
556:
1.119 bentley 557: <h3>OpenBSD/mvme68k:</h3>
558:
1.1 deraadt 559: <p>
560: You can create a bootable installation tape or boot over the network.<br>
561: The network boot requires a MVME68K BUG version that supports the <i>NIOT</i>
562: and <i>NBO</i> debugger commands. Follow the instructions in INSTALL.mvme68k
563: for more details.
564:
1.119 bentley 565: <h3>OpenBSD/mvme88k:</h3>
566:
1.2 deraadt 567: <p>
568: You can create a bootable installation tape or boot over the network.<br>
569: The network boot requires a MVME88K BUG version that supports the <i>NIOT</i>
570: and <i>NBO</i> debugger commands. Follow the instructions in INSTALL.mvme88k
571: for more details.
1.120 deraadt 572: </section>
1.119 bentley 573:
1.120 deraadt 574: <hr>
1.119 bentley 575:
576: <section id=sourcecode>
1.120 deraadt 577: <h3>Notes about the source code</h3>
1.2 deraadt 578: <p>
1.122 deraadt 579: <code>src.tar.gz</code> contains a source archive starting at <code>/usr/src</code>.
580: This file contains everything you need except for the kernel sources, which are
1.1 deraadt 581: in a separate archive. To extract:
1.119 bentley 582: <blockquote><pre>
583: # <kbd>mkdir -p /usr/src</kbd>
584: # <kbd>cd /usr/src</kbd>
585: # <kbd>tar xvfz /tmp/src.tar.gz</kbd>
586: </pre></blockquote>
1.1 deraadt 587: <p>
1.122 deraadt 588: <code>sys.tar.gz</code> contains a source archive starting at <code>/usr/src/sys</code>.
1.1 deraadt 589: This file contains all the kernel sources you need to rebuild kernels.
590: To extract:
1.119 bentley 591: <blockquote><pre>
592: # <kbd>mkdir -p /usr/src/sys</kbd>
593: # <kbd>cd /usr/src</kbd>
594: # <kbd>tar xvfz /tmp/sys.tar.gz</kbd>
595: </pre></blockquote>
1.1 deraadt 596: <p>
597: Both of these trees are a regular CVS checkout. Using these trees it
598: is possible to get a head-start on using the anoncvs servers as
599: described <a href="anoncvs.html">here</a>.
600: Using these files
601: results in a much faster initial CVS update than you could expect from
602: a fresh checkout of the full OpenBSD source tree.
1.119 bentley 603: </section>
604:
1.1 deraadt 605: <hr>
1.119 bentley 606:
607: <section id=ports>
608: <h3>Ports Tree</h3>
1.1 deraadt 609: <p>
610: A ports tree archive is also provided. To extract:
1.119 bentley 611: <blockquote><pre>
612: # <kbd>cd /usr</kbd>
613: # <kbd>tar xvfz /tmp/ports.tar.gz</kbd>
614: </pre></blockquote>
1.1 deraadt 615: <p>
616: The <i>ports/</i> subdirectory is a checkout of the OpenBSD ports tree. Go
1.98 jasper 617: read the <a href="faq/faq15.html">ports</a> page
1.1 deraadt 618: if you know nothing about ports
619: at this point. This text is not a manual of how to use ports.
620: Rather, it is a set of notes meant to kickstart the user on the
621: OpenBSD ports system.
622: <p>
623: The <i>ports/</i> directory represents a CVS (see the manpage for
1.121 bentley 624: <a href="https://man.openbsd.org/cvs.1">cvs(1)</a> if
1.1 deraadt 625: you aren't familiar with CVS) checkout of our ports. As with our complete
626: source tree, our ports tree is available via anoncvs. So, in
627: order to keep current with it, you must make the <i>ports/</i> tree
628: available on a read-write medium and update the tree with a command
629: like:
1.119 bentley 630: <blockquote><pre>
631: # <kbd>cd [portsdir]/; cvs -d anoncvs@server.openbsd.org:/cvs update -Pd -rOPENBSD_3_5</kbd>
632: </pre></blockquote>
1.1 deraadt 633: <p>
634: [Of course, you must replace the local directory and server name here
635: with the location of your ports collection and a nearby anoncvs
636: server.]
637: <p>
1.120 deraadt 638: Note that most ports are available as packages on our mirrors. Updated
1.1 deraadt 639: packages for the 3.5 release will be made available if problems arise.
640: <p>
641: If you're interested in seeing a port added, would like to help out, or just
1.120 deraadt 642: would like to know more, the mailing list
643: <a href="mail.html">ports@openbsd.org</a> is a good place to know.
1.119 bentley 644: </section>