Annotation of www/52.html, Revision 1.21
1.1 deraadt 1: <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2: <html>
3: <head>
4: <title>OpenBSD 5.2 Release</title>
5: <link rev=made href="mailto:www@openbsd.org">
6: <meta name="resource-type" content="document">
7: <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
8: <meta name="description" content="OpenBSD 5.2">
9: <meta name="keywords" content="openbsd,main">
10: <meta name="distribution" content="global">
11: <meta name="copyright" content="This document copyright 2012 by OpenBSD.">
12: </head>
13:
14: <body bgcolor="#ffffff" text="#000000" link="#24248E">
15:
16: <a href="index.html">
17: <img alt="[OpenBSD]" height="30" width="141" hspace="24" src="images/smalltitle.gif" border="0"></a>
18: <hr>
19:
20: <p>
21: <a href="images/Brazil.jpg">
22: <img align="left" width="227" height="343" hspace="24" vspace="30"
23: src="images/Brazil.jpg" alt="OpenBSD 5.2 logo"></a>
24: <h2><font color="#0000e0">The OpenBSD 5.2 Release:</font></h2>
25: <p>
1.2 deraadt 26: To be released Nov 1, 2012<br>
1.1 deraadt 27: Copyright 1997-2012, Theo de Raadt.<br>
28: <font color="#e00000">ISBN 978-0-9881561-0-4</font>
29: <br>
30: <a href="lyrics.html#52">5.2 Song: song not released yet</a>
31: <p>
32:
33: <a href="#new">What's New</a><br>
34: <a href="#install">How to install</a><br>
35: <a href="#upgrade">How to upgrade</a><br>
36: <a href="#ports">How to use the ports tree</a><br>
37: <a href="orders.html">Ordering a CD set</a><br>
38:
39: <p>
40: <h3><font color="#0000e0">
41: To get the files for this release:
42: <ul>
43: <li>Order a CDROM from our <a href="orders.html">ordering system</a>.
44: <li>See the information on <a href="ftp.html">The FTP page</a> for
45: a list of mirror machines.
46: <li>Go to the <font color="#e00000">pub/OpenBSD/5.2/</font> directory on
47: one of the mirror sites.
48: <li>Briefly read the rest of this document.
49: <li>Have a look at <a href="errata52.html">The 5.2 Errata page</a> for a list
50: of bugs and workarounds.
51: <li>See a <a href="plus52.html">detailed log of changes</a> between the
52: 5.1 and 5.2 releases.
53: </ul>
54: </font></h3>
55: <br clear=all>
56:
57: <strong>Note:</strong> All applicable copyrights and credits can be found
58: in the applicable file sources found in the files src.tar.gz, sys.tar.gz,
59: xenocara.tar.gz, or in the files fetched via ports.tar.gz. The distribution
60: files used to build packages from the ports.tar.gz file are not included on
61: the CDROM because of lack of space.
62: <p>
63:
64: <a name="new"></a>
65: <hr>
66: <p>
67: <h3><font color="#0000e0">What's New</font></h3>
68: <p>
69: This is a partial list of new features and systems included in OpenBSD 5.2.
70: For a comprehensive list, see the <a href="plus52.html">changelog</a> leading
71: to 5.2.
72: <p>
73:
74: <ul>
1.17 lteo 75: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=pthreads&sektion=3">pthreads(3)</a> support:
1.1 deraadt 76: <ul>
77: <li>The most significant change in this release is the replacement of
78: the user-level uthreads by kernel-level rthreads.
79: <li>Use PTHREAD_MUTEX_STRICT_NP as default mutex type.
1.6 guenther 80: <li>Added pthread spinlock and barrier routines.
81: <li>Added <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=pthread_mutex_lock&sektion=3">pthread_mutex_timedlock(3)</a> and <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sem_wait&sektion=3">sem_timedwait(3)</a>.
82: <li>Added <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=pthread_condattr_init&sektion=3">pthread_condattr_setclock(3)</a>.
1.1 deraadt 83: <li>Added support for live multi-threaded debugging in <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=gdb&sektion=1">gdb(1)</a>.
1.6 guenther 84: <li>Improved handling for <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=getrusage&sektion=2">rusage</a> totals and <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=getitimer&sektion=2">interval times</a> in threaded processes.
85: <li>Changed the RLIMIT_CPU <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=getrlimit&sektion=2">rlimit</a> to count processes instead of threads.
86: <li>Added a new system limit <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sysctl&sektion=8">kern.maxthread</a> for the max number of threads.
87: <li>Closed race conditions in thread creation, and in <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=fork&sektion=2">fork(2)</a> and <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=open&sektion=2">open(2)</a> in a threaded process.
1.16 lteo 88: <li>Improved handling of threaded processes in <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ps&sektion=1">ps(1)</a> and <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=fstat&sektion=1">fstat(1)</a>.
1.19 guenther 89: <li>Changed the lock around <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dlfcn&sektion=3">dlopen()</a> to be recursive, so that dl*() operations from <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=atexit&sektion=3">atexit()</a> handlers don't deadlock.
1.21 ! guenther 90: <li>Many fixes to pthread attribute and mutex error checking and cancellation handling.
1.1 deraadt 91: </ul>
92: <p>
93:
94: <li>Improved hardware support, including:
95: <ul>
1.17 lteo 96: <li>Added hibernation support on i386. Currently only working on <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=pciide&sektion=4">pciide(4)</a> and <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=wd&sektion=4">wd(4)</a> disks.
1.10 sthen 97: <li>Improved support for ALPS based touchpads in <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=wsmouse&sektion=4">wsmouse(4)</a> and the <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=synaptics&sektion=4">synaptics(4)</a> X.Org input driver</a>.
98: <li>Performance improvements with <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ix&sektion=4">ix(4)</a> Intel 10Gb ethernet NICs.
99: <li>Support for i350 based devices in <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=em&sektion=4">em(4)</a>.
100: <li>Flow control support for <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=bnx&sektion=4">bnx(4)</a>.
101: <li>Hardware watchdog and HPET support for <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=tcpcib&sektion=4">tcpcib(4)</a> (Intel Atom E600) as found in some embedded x86 systems.
102: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=urndis&sektion=4">urndis(4)</a> supports additional Android devices.
1.20 lteo 103: <li>Support for Winbond W83627UHG has been added to <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=wbsio&sektion=4">wbsio(4)</a>.
1.1 deraadt 104: <li>...
105: </ul>
106: <p>
107:
108: <li>Generic network stack improvements:
109: <ul>
1.10 sthen 110: <li>Cleanup handling of sockaddrs in degenerate use cases.
1.6 guenther 111: <li>Improved handling of error and limit cases in file-descriptor passing.
112: <li>Improved error handling in socket splicing.
1.12 sperreau 113: <li>IPv6 privacy addresses now appear alongside SLAAC addresses.
1.1 deraadt 114: <li>...
115: </ul>
116: <p>
117:
118: <li>Routing daemons and other userland network improvements:
119: <ul>
1.5 camield 120: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=aucat&sektion=1">aucat(1)</a>,
121: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=bgpd&sektion=8">bgpd(8)</a>,
122: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dvmrpd&sektion=8">dvmrpd(8)</a>,
123: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ftp-proxy&sektion=8">ftp-proxy(8)</a>,
124: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=iked&sektion=8">iked(8)</a>,
125: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=iscsid&sektion=8">iscsid(8)</a>,
1.1 deraadt 126: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ldapd&sektion=8">ldapd(8)</a>,
1.5 camield 127: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ldpd&sektion=8">ldpd(8)</a>,
128: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=nsd&sektion=8">nsd(8)</a>,
129: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ospf6d&sektion=8">ospf6d(8)</a>,
130: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ospfd&sektion=8">ospfd(8)</a>,
131: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=relayd&sektion=8">relayd(8)</a>,
132: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ripd&sektion=8">ripd(8)</a>,
133: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=snmpd&sektion=8">snmpd(8)</a>,
134: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=spamd&sektion=8">spamd(8)</a>,
135: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>,
136: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=tcpbench&sektion=1">tcpbench(1)</a> and
137: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=tmux&sektion=1">tmux(1)</a>
1.1 deraadt 138: now rate limit their accepting of new connections when experiencing file descriptor exhaustion.
139: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=tcpdump&sektion=8">tcpdump(8)</a>
140: now recognizes additional Internet Key Exchange DH groups.
141: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ipsecctl&sektion=8">ipsecctl(8)</a>
142: now allows SA lifetimes to be specified in its
143: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ipsec.conf&sektion=5">ipsec.conf(5)</a>
144: file.
145: <li>Rewrote <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=tftpd&sektion=8">tftpd(8)</a> as a persistent, non-blocking daemon.
1.9 sthen 146: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=snmpd&sektion=8">snmpd(8)</a> now supports PF-MIB, UCD-DISKIO-MIB, and
147: additional OIDs in HOST-RESOURCES-MIB.
148: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=bgpd&sektion=8">bgpd(8)</a> is now more robust to network instability.
149: <li>ASCII packet dumping support in <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=tcpdump&sektion=8">tcpdump(8)</a>.
150: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=tftp&sektion=1">tftp(1)</a> client now supports IPv6.
1.17 lteo 151: <li>Various bug fixes and better standard compliance in <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=relayd&sektion=8">relayd(8)</a>.
1.20 lteo 152: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=rtadvd&sektion=8">rtadvd(8)</a>
153: can now advertise DNS servers and search paths in router advertisements.
154: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=rtadvd&sektion=8">rtadvd(8)</a>
155: can now send router advertisements with no prefix information using the noifprefix option.
156: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ftp&sektion=1">ftp(1)</a>
157: client now allows the source IP address of the connection to be specified.
1.1 deraadt 158: <li>...
159: </ul>
160: <p>
161:
162: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=pf&sektion=4">pf(4)</a> improvements:
163: <ul>
1.9 sthen 164: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=pf&sektion=4">pf(4)</a> now ignores/preserves the lower 2 bits of the tos-header (used for Explicit Congestion Notification).
1.17 lteo 165: <li>Allow more than 16 <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=pflog&sektion=4">pflog(4)</a> interfaces.
1.15 benno 166: <li>...
1.1 deraadt 167: </ul>
168: <p>
169:
170: <li>Assorted improvements:
171: <ul>
172: <li>Added <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=nginx&sektion=8">nginx(8)</a>,
173: an HTTP server, reverse proxy server and mail proxy server.
1.8 espie 174: <li>Added SQLite 3.7.13, a self-contained SQL database engine.
1.1 deraadt 175: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=pcap&sektion=3">libpcap</a>
176: has been updated with several core functions from tcpdump.org's libpcap-1.2.0 API, without
177: the clutter.
178: <li>Disabled SSLv2 in OpenSSL.
1.8 espie 179: <li>Moved <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=libtool&sektion=1">libtool(1)</a> into the base system. Much work remains to be done.
1.18 lteo 180: <li>Removed <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=lint&sektion=1&manpath=OpenBSD+5.1">lint(1)</a>.
181: <li>Removed <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=raid&sektion=4&manpath=OpenBSD+5.1">raid(4)</a>
182: RAIDframe driver and the corresponding
183: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=raidctl&sektion=8&manpath=OpenBSD+5.1">raidctl(8)</a> utility.
1.16 lteo 184: <li>Added <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=posix_spawn&sektion=3">posix_spawn(3)</a>.
185: <li>Added <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=mbsnrtowcs&sektion=3">mbsnrtowcs(3)</a>,
186: and <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=wcsnrtombs&sektion=3">wcsnrtombs(3)</a>.
187: <li>Added <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=getdelim&sektion=3">getdelim(3)</a>
188: and <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=getline&sektion=3">getline(3)</a>.
189: <li>More configuration variables for <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sysconf&sektion=3">sysconf(3)</a> and
190: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=pathconf&sektion=2">pathconf(2)</a>.
191: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dirfd&sektion=3">dirfd(3)</a>
1.17 lteo 192: is now a function instead of a macro.
1.16 lteo 193: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=posix_memalign&sektion=3">posix_memalign(3)</a>
194: supports arbitrarily large alignments.
195: <li>Improved <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=realloc&sektion=3">realloc(3)</a> performance.
196: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ld.so&sektion=1">ld.so(1)</a>
197: recognizes the DF_1_NOOPEN flag and refuses to
198: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dlopen&sektion=3">dlopen(3)</a>
199: shared objects linked with "-z nodlopen".
1.6 guenther 200: <li>Improved compliance and/or cleanliness of header files, particularly
1.7 guenther 201: <dirent.h>, <time.h>, <sys/time.h>, <limits.h>,
1.6 guenther 202: <arpa/inet.h>, <netinet/in.h>, and <sys/param.h>.
203: <li>Improved kernel uvm memory allocator.
1.7 guenther 204: <li>Added support for using AMT to provide console-over-ethernet. (c.f. the amtterm port).
1.6 guenther 205: <li>Improved support for amd64 boxes with many memory extents.
1.16 lteo 206: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=compat_linux&sektion=8">compat_linux(8)</a>
207: improvements: TLS-vs-clone and futex fixes, added support
1.6 guenther 208: for statfs64(), tgkill(), gettid(), SOCK_CLOEXEC, and SOCK_NONBLOCK.
1.7 guenther 209: <li>Improved handling of bare FAT media.
1.16 lteo 210: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=kdump&sektion=1">kdump(1)</a>
211: improvements, including the ability to show thread IDs and dumping of timespec, timeval, sigaction, rlimit, sigset, clockid, and fdset arguments and results.
212: <li>Various improvements in <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=smtpd&sektion=8">smtpd(8)</a>:
1.17 lteo 213: reliability fixes, new MTA client, new scheduler and improved queue logic, simplified smtpd.conf syntax, better RFC compliance and several cosmetic changes.
1.16 lteo 214: <li>The <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=mg&sektion=1">mg(1)</a>
1.17 lteo 215: emacs-like editor now allows backup files to be saved in a user's home directory.
1.19 guenther 216: <li>Fixed operation of <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=kvm_getfiles&sektion=3">kvm_getfile2()</a> (and therefore <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=fstat&sektion=1">fstat</a> and <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=pstat&sektion=8">pstat</a>) on kernel crash dumps.
217: <li>Improved emacs-style key bindings and handling of large arrays in <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ksh&sektion=1">ksh</a>.
218: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=reboot&sektion=8">halt</a> disables "suspend-on-lid-close" so that you don't accidentally suspend instead of shutting down.
1.1 deraadt 219: <li>...
220: </ul>
221: <p>
222:
223: <li>OpenSSH 6.1:
224: <ul>
225: <li>New features:
226: <ul>
227: <li>...
228: </ul>
229: <li>The following significant bugs have been fixed in this release:
230: <ul>
231: <li>...
232: </ul>
233: </ul>
234: <p>
235:
1.8 espie 236: <li>Over 7600 ports, major performance and stability improvements in
1.1 deraadt 237: the package build process
238: <ul>
1.8 espie 239: <li>dpb got simpler and faster. Handles distfiles, works without any
240: option.
1.17 lteo 241: <li>Simpler and less error-prone mechanisms for handling MD differences.
1.8 espie 242: <li>dpb is now used for mirroring distfiles, to the great joy of
243: <a href="ftp://ftp.openbsd.org/pub/OpenBSD/distfiles/">ftp://ftp.openbsd.org/pub/OpenBSD/distfiles/</a>
1.1 deraadt 244: </ul>
245: <p>
246: <li>Many pre-built packages for each architecture:
247: <table border=0 cellspacing=0 cellpadding=2 width="95%">
248: <tr>
249: <td valign="top" width="25%">
250: <ul>
251: <li>i386: 7483
252: <li>sparc64: 6820
253: <li>alpha: 5993
254: </ul></td><td valign=top width="25%"><ul>
255: <li>sh: XXXX
256: <li>amd64: 7439
257: <li>powerpc: 7050
258: </ul></td><td valign=top width="25%"><ul>
259: <li>sparc: 4466
260: <li>arm: XXXX
261: <li>hppa: 6316
262: </ul></td><td valign=top width="25%"><ul>
263: <li>vax: XXXX
264: <li>mips64: 5845
265: <li>mips64el: 5908
266: </ul></td></tr></table>
267: <p>
268:
269: <li>Some highlights:
270: <ul>
1.11 sthen 271: <li>GNOME 3.4.2 <li>KDE 3.5.10
1.1 deraadt 272: <li>Xfce 4.10 <li>MySQL 5.1.63
273: <li>PostgreSQL 9.1.4 <li>Postfix 2.9.3
274: <li>OpenLDAP 2.3.43 and 2.4.31 <li>Mozilla Firefox 3.5.19, 3.6.28 and 13.0.1
275: <li>Mozilla Thunderbird 13.0.1 <li>GHC 7.0.4
276: <li>LibreOffice 3.5.5.3 <li>Emacs 21.4, 22.3 and 23.4
277: <li>Vim 7.3.154 <li>PHP 5.2.17 and 5.3.14
278: <li>Python 2.5.4, 2.7.3 and 3.2.3 <li>Ruby 1.8.7.370 and 1.9.3.194
279: <li>Tcl/Tk 8.5.11 <li>Jdk 1.7
280: <li>Mono 2.10.9 <li>Chromium 20.0.1132.57
281: <li>Groff 1.21 <li>Go 1.0.2
282: <li>GCC 4.6.3 and 4.7.1 <li>LLVM/Clang 3.1
1.20 lteo 283: <li>Lua 5.1.5 and 5.2.1
1.1 deraadt 284: </ul>
285: <p>
286:
287: <li>As usual, steady improvements in manual pages and other documentation.
288: <p>
289:
290: <li>The system includes the following major components from outside suppliers:
291: <ul>
1.3 matthieu 292: <li>Xenocara (based on X.Org 7.7 with xserver 1.12.2 + patches,
293: freetype 2.4.10, fontconfig 2.8.0, Mesa 7.10.3, xterm 279,
294: xkeyboard-config 2.6 and more)
1.1 deraadt 295: <li>Gcc 4.2.1 (+patches), 3.3.5 (+ patches) and 2.95.3 (+ patches)
296: <li>Perl 5.12.2 (+ patches)
297: <li>Our improved and secured version of Apache 1.3, with
298: SSL/TLS and DSO support
299: <li>Nginx 1.2.2 (+ patches)
300: <li>OpenSSL 1.0.0f (+ patches)
301: <li>SQLite 3.7.13 (+ patches)
302: <li>Sendmail 8.14.5, with libmilter
303: <li>Bind 9.4.2-P2 (+ patches)
304: <li>NSD 3.2.11
305: <li>Lynx 2.8.7rel.2 with HTTPS and IPv6 support (+ patches)
306: <li>Sudo 1.7.2p8
307: <li>Ncurses 5.7
308: <li>Heimdal 0.7.2 (+ patches)
309: <li>Arla 0.35.7
310: <li>Binutils 2.15 (+ patches)
311: <li>Gdb 6.3 (+ patches)
312: <li>Less 444 (+ patches)
313: <li>Awk Aug 10, 2011 version
314: </ul>
315:
316: </ul>
317:
318: <a name="install"></a>
319: <hr>
320: <p>
321: <h3><font color="#0000e0">How to install</font></h3>
322: <p>
323: Following this are the instructions which you would have on a piece of
324: paper if you had purchased a CDROM set instead of doing an alternate
325: form of install. The instructions for doing an FTP (or other style
326: of) install are very similar; the CDROM instructions are left intact
327: so that you can see how much easier it would have been if you had
328: purchased a CDROM instead.
329: <p>
330:
331: <hr>
332: Please refer to the following files on the three CDROMs or FTP mirror for
333: extensive details on how to install OpenBSD 5.2 on your machine:
334: <p>
335: <ul>
336: <li>CD1:5.2/i386/INSTALL.i386
337: <p>
338: <li>CD2:5.2/amd64/INSTALL.amd64
339: <p>
340: <li>CD3:5.2/sparc64/INSTALL.sparc64
341: <p>
342: <li>FTP:.../OpenBSD/5.2/alpha/INSTALL.alpha
343: <li>FTP:.../OpenBSD/5.2/armish/INSTALL.armish
344: <li>FTP:.../OpenBSD/5.2/hp300/INSTALL.hp300
345: <li>FTP:.../OpenBSD/5.2/hppa/INSTALL.hppa
346: <li>FTP:.../OpenBSD/5.2/landisk/INSTALL.landisk
347: <li>FTP:.../OpenBSD/5.2/loongson/INSTALL.loongson
348: <li>FTP:.../OpenBSD/5.2/luna88k/INSTALL.luna88k
349: <li>FTP:.../OpenBSD/5.2/macppc/INSTALL.macppc
350: <li>FTP:.../OpenBSD/5.2/mvme68k/INSTALL.mvme68k
351: <li>FTP:.../OpenBSD/5.2/mvme88k/INSTALL.mvme88k
352: <li>FTP:.../OpenBSD/5.2/sgi/INSTALL.sgi
353: <li>FTP:.../OpenBSD/5.2/socppc/INSTALL.socppc
354: <li>FTP:.../OpenBSD/5.2/sparc/INSTALL.sparc
355: <li>FTP:.../OpenBSD/5.2/vax/INSTALL.vax
356: <li>FTP:.../OpenBSD/5.2/zaurus/INSTALL.zaurus
357: </ul>
358: <hr>
359:
360: <p>
361: Quick installer information for people familiar with OpenBSD, and the
362: use of the "disklabel -E" command. If you are at all confused when
363: installing OpenBSD, read the relevant INSTALL.* file as listed above!
364: <p>
365:
366: <h3><font color="#e00000">OpenBSD/i386:</font></h3>
367: <ul>
368: Play with your BIOS options to enable booting from a CD. The OpenBSD/i386
369: release is on CD1. If your BIOS does not support booting from CD, you will need
370: to create a boot floppy to install from. To create a boot floppy write
371: <i>CD1:5.2/i386/floppy52.fs</i> to a floppy and boot via the floppy drive.
372:
373: <p>
374: Use <i>CD1:5.2/i386/floppyB52.fs</i> instead for greater SCSI controller
375: support, or <i>CD1:5.2/i386/floppyC52.fs</i> for better laptop support.
376:
377: <p>
378: If you can't boot from a CD or a floppy disk,
379: you can install across the network using PXE as described in
380: the included INSTALL.i386 document.
381:
382: <p>
383: If you are planning on dual booting OpenBSD with another OS, you will need to
384: read INSTALL.i386.
385:
386: <p>
387: To make a boot floppy under MS-DOS, use the "rawrite" utility located
388: at <i>CD1:5.2/tools/rawrite.exe</i>. To make the boot floppy under a Unix OS,
389: use the
390: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dd&sektion=1">dd(1)</a>
391: utility. The following is an example usage of
392: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dd&sektion=1">dd(1)</a>,
393: where the device could be "floppy", "rfd0c", or
394: "rfd0a".
395:
396: <ul><pre>
397: # <strong>dd if=<file> of=/dev/<device> bs=32k</strong>
398: </pre></ul>
399:
400: <p>
401: Make sure you use properly formatted perfect floppies with NO BAD BLOCKS or
402: your install will most likely fail. For more information on creating a boot
403: floppy and installing OpenBSD/i386 please refer to
404: <a href="faq/faq4.html#MkFlop">FAQ 4.3.2</a>.
405: </ul>
406:
407: <p>
408: <h3><font color="#e00000">OpenBSD/amd64:</font></h3>
409: <ul>
410: The 5.2 release of OpenBSD/amd64 is located on CD2.
411: Boot from the CD to begin the install - you may need to adjust
412: your BIOS options first.
413: If you can't boot from the CD, you can create a boot floppy to install from.
414: To do this, write <i>CD2:5.2/amd64/floppy52.fs</i> to a floppy, then
415: boot from the floppy drive.
416:
417: <p>
418: If you can't boot from a CD or a floppy disk,
419: you can install across the network using PXE as described in the included
420: INSTALL.amd64 document.
421:
422: <p>
423: If you are planning to dual boot OpenBSD with another OS, you will need to
424: read INSTALL.amd64.
425: </ul>
426:
427: <p>
428: <h3><font color="#e00000">OpenBSD/macppc:</font></h3>
429: <ul>
430: Burn the image from the FTP site to a CDROM, and poweron your machine
431: while holding down the <i>C</i> key until the display turns on and
432: shows <i>OpenBSD/macppc boot</i>.
433:
434: <p>
435: Alternatively, at the Open Firmware prompt, enter <i>boot cd:,ofwboot
436: /5.2/macppc/bsd.rd</i>
437: </ul>
438:
439: <p>
440: <h3><font color="#e00000">OpenBSD/sparc64:</font></h3>
441: <ul>
442: Put CD3 in your CDROM drive and type <i>boot cdrom</i>.
443:
444: <p>
445: If this doesn't work, or if you don't have a CDROM drive, you can write
446: <i>CD3:5.2/sparc64/floppy52.fs</i> or <i>CD3:5.2/sparc64/floppyB52.fs</i>
447: (depending on your machine) to a floppy and boot it with <i>boot
448: floppy</i>. Refer to INSTALL.sparc64 for details.
449:
450: <p>
451: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
452: will most likely fail.
453:
454: <p>
455: You can also write <i>CD3:5.2/sparc64/miniroot52.fs</i> to the swap partition on
456: the disk and boot with <i>boot disk:b</i>.
457:
458: <p>
459: If nothing works, you can boot over the network as described in INSTALL.sparc64.
460: </ul>
461:
462: <p>
463: <h3><font color="#e00000">OpenBSD/alpha:</font></h3>
464: <ul>
465: <p>Write <i>FTP:5.2/alpha/floppy52.fs</i> or
466: <i>FTP:5.2/alpha/floppyB52.fs</i> (depending on your machine) to a diskette and
467: enter <i>boot dva0</i>. Refer to INSTALL.alpha for more details.
468:
469: <p>
470: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
471: will most likely fail.
472:
473: </ul>
474:
475: <p>
476: <h3><font color="#e00000">OpenBSD/armish:</font></h3>
477: <ul>
478: <p>
479: After connecting a serial port, Thecus can boot directly from the network
480: either tftp or http. Configure the network using fconfig, reset,
481: then load bsd.rd, see INSTALL.armish for specific details.
482: IOData HDL-G can only boot from an EXT-2 partition. Boot into linux
483: and copy 'boot' and bsd.rd into the first partition on wd0 (hda1)
484: then load and run bsd.rd, preserving the wd0i (hda1) ext2fs partition.
485: More details are available in INSTALL.armish.
486: </ul>
487:
488: <p>
489: <h3><font color="#e00000">OpenBSD/hp300:</font></h3>
490: <ul>
491: <p>
492: Boot over the network by following the instructions in INSTALL.hp300.
493: </ul>
494:
495: <p>
496: <h3><font color="#e00000">OpenBSD/hppa:</font></h3>
497: <ul>
498: <p>
499: Boot over the network by following the instructions in INSTALL.hppa or the
500: <a href="hppa.html#install">hppa platform page</a>.
501: </ul>
502:
503: <p>
504: <h3><font color="#e00000">OpenBSD/landisk:</font></h3>
505: <ul>
506: <p>
507: Write <i>miniroot52.fs</i> to the start of the CF
508: or disk, and boot normally.
509: </ul>
510:
511: <p>
512: <h3><font color="#e00000">OpenBSD/loongson:</font></h3>
513: <ul>
514: <p>
515: Write <i>miniroot52.fs</i> to a USB stick and boot bsd.rd from it
516: or boot bsd.rd via tftp.
517: Refer to the instructions in INSTALL.loongson for more details.
518: </ul>
519: <p>
520:
521: <p>
522: <h3><font color="#e00000">OpenBSD/luna88k:</font></h3>
523: <ul>
524: <p>
525: Copy bsd.rd to a Mach or UniOS partition, and boot it from the PROM.
526: Alternatively, you can create a bootable tape and boot from it. Refer to
527: the instructions in INSTALL.luna88k for more details.
528: </ul>
529:
530: <p>
531: <h3><font color="#e00000">OpenBSD/mvme68k:</font></h3>
532: <ul>
533: <p>
534: You can create a bootable installation tape or boot over the network.<br>
535: The network boot requires a MVME68K BUG version that supports the <i>NIOT</i>
536: and <i>NBO</i> debugger commands. Follow the instructions in INSTALL.mvme68k
537: for more details.
538: </ul>
539:
540: <p>
541: <h3><font color="#e00000">OpenBSD/mvme88k:</font></h3>
542: <ul>
543: <p>
544: You can create a bootable installation tape or boot over the network.<br>
545: The network boot requires a MVME88K BUG version that supports the <i>NIOT</i>
546: and <i>NBO</i> debugger commands. Follow the instructions in INSTALL.mvme88k
547: for more details.
548: </ul>
549:
550: <p>
551: <h3><font color="#e00000">OpenBSD/sgi:</font></h3>
552: <ul>
553: <p>
554: To install on an O2, burn cd52.iso on a CD-R, put it in the CD drive of your
555: machine and select <i>Install System Software</i> from the System Maintenance
556: menu.
557:
558: <p>
559: On other systems, or if your machine doesn't have a CD drive, you can
560: setup a DHCP/tftp network server, and boot using "bootp()/bsd.rd.IP##" using
561: the kernel matching your system type.
562: Refer to the instructions in INSTALL.sgi for more details.
563: </ul>
564:
565: <p>
566: <h3><font color="#e00000">OpenBSD/socppc:</font></h3>
567: <ul>
568: <p>
569: After connecting a serial port, boot over the network via DHCP/tftp.
570: Refer to the instructions in INSTALL.socppc for more details.
571: </ul>
572:
573: <p>
574: <h3><font color="#e00000">OpenBSD/sparc:</font></h3>
575: <ul>
576: Boot from one of the provided install ISO images, using one of the two
577: commands listed below, depending on the version of your ROM.
578:
579: <ul><pre>
580: ok <strong>boot cdrom 5.2/sparc/bsd.rd</strong>
581: or
582: > <strong>b sd(0,6,0)5.2/sparc/bsd.rd</strong>
583: </pre></ul>
584:
585: <p>
586: If your SPARC system does not have a CD drive, you can alternatively boot from floppy.
587: To do so you need to write <i>floppy52.fs</i> to a floppy.
588: For more information see <a href="faq/faq4.html#MkFlop">FAQ 4.3.2</a>.
589: To boot from the floppy use one of the two commands listed below,
590: depending on the version of your ROM.
591:
592: <ul><pre>
593: ok <strong>boot floppy</strong>
594: or
595: > <strong>b fd()</strong>
596: </pre></ul>
597:
598: <p>
599: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
600: will most likely fail.
601:
602: <p>
603: If your SPARC system doesn't have a floppy drive nor a CD drive, you can either
604: setup a bootable tape, or install via network, as told in the
605: INSTALL.sparc file.
606: </ul>
607:
608: <p>
609: <h3><font color="#e00000">OpenBSD/vax:</font></h3>
610: <ul>
611: Boot over the network via mopbooting as described in INSTALL.vax.
612: </ul>
613:
614: <p>
615: <h3><font color="#e00000">OpenBSD/zaurus:</font></h3>
616: <ul>
617: <p>
618: Using the Linux built-in graphical ipkg installer, install the
619: openbsd52_arm.ipk package. Reboot, then run it. Read INSTALL.zaurus
620: for a few important details.
621: </ul>
622:
623: <p>
624: <h3><font color="#e00000">Notes about the source code:</font></h3>
625: <ul>
626: src.tar.gz contains a source archive starting at /usr/src. This file
627: contains everything you need except for the kernel sources, which are
628: in a separate archive. To extract:
629: <p>
630: <ul><pre>
631: # <strong>mkdir -p /usr/src</strong>
632: # <strong>cd /usr/src</strong>
633: # <strong>tar xvfz /tmp/src.tar.gz</strong>
634: </pre></ul>
635: <p>
636: sys.tar.gz contains a source archive starting at /usr/src/sys.
637: This file contains all the kernel sources you need to rebuild kernels.
638: To extract:
639: <p>
640: <ul><pre>
641: # <strong>mkdir -p /usr/src/sys</strong>
642: # <strong>cd /usr/src</strong>
643: # <strong>tar xvfz /tmp/sys.tar.gz</strong>
644: </pre></ul>
645: <p>
646: Both of these trees are a regular CVS checkout. Using these trees it
647: is possible to get a head-start on using the anoncvs servers as
648: described <a href="anoncvs.html">here</a>.
649: Using these files
650: results in a much faster initial CVS update than you could expect from
651: a fresh checkout of the full OpenBSD source tree.
652: <p>
653: </ul>
654:
655: <a name="upgrade"></a>
656: <hr>
657: <p>
658: <h3><font color="#0000e0">How to upgrade</font></h3>
659: <p>
660: If you already have an OpenBSD 5.1 system, and do not want to reinstall,
661: upgrade instructions and advice can be found in the
662: <a href="faq/upgrade52.html">Upgrade Guide</a>.
663:
664: <a name="ports"></a>
665: <hr>
666: <p>
667: <h3><font color="#0000e0">Ports Tree</font></h3>
668: <p>
669: A ports tree archive is also provided. To extract:
670: <p>
671: <ul><pre>
672: # <strong>cd /usr</strong>
673: # <strong>tar xvfz /tmp/ports.tar.gz</strong>
674: # <strong>cd ports</strong>
675: </pre></ul>
676: <p>
677: The <i>ports/</i> subdirectory is a checkout of the OpenBSD ports tree. Go
678: read the <a href="faq/ports/index.html">ports</a> page
679: if you know nothing about ports
680: at this point. This text is not a manual of how to use ports.
681: Rather, it is a set of notes meant to kickstart the user on the
682: OpenBSD ports system.
683: <p>
684: The <i>ports/</i> directory represents a CVS (see the manpage for
685: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=cvs&apropos=0&sektion=1&manpath=OpenBSD+Current&arch=i386">
686: cvs(1)</a> if
687: you aren't familiar with CVS) checkout of our ports. As with our complete
688: source tree, our ports tree is available via anoncvs. So, in
689: order to keep current with it, you must make the <i>ports/</i> tree
690: available on a read-write medium and update the tree with a command
691: like:
692: <p>
693: <ul><pre>
694: # <strong>cd [portsdir]/; cvs -d anoncvs@server.openbsd.org:/cvs update -Pd -rOPENBSD_5_2</strong>
695: </pre></ul>
696: <p>
697: [Of course, you must replace the local directory and server name here
698: with the location of your ports collection and a nearby anoncvs
699: server.]
700: <p>
701: Note that most ports are available as packages through FTP. Updated
702: packages for the 5.2 release will be made available if problems arise.
703: <p>
704: If you're interested in seeing a port added, would like to help out, or just
705: would like to know more, the mailing list
706: <a href="mail.html">ports@openbsd.org</a> is a good place to know.
707: <p>
708:
709: <hr>
710: <a href="index.html"><img height="24" width="24" src="back.gif" border="0"
711: alt="OpenBSD"></a>
712: <a href="mailto:www@openbsd.org">www@openbsd.org</a>
713: <br><small>
1.21 ! guenther 714: $OpenBSD: 52.html,v 1.20 2012/09/06 03:43:10 lteo Exp $
1.1 deraadt 715: </small>
716:
717: </body>
718: </html>