Annotation of www/53.html, Revision 1.92
1.91 bentley 1: <!doctype html>
2: <html lang=en id=release>
3: <meta charset=utf-8>
4:
1.75 deraadt 5: <title>OpenBSD 5.3</title>
1.1 sthen 6: <meta name="description" content="OpenBSD 5.3">
1.85 tj 7: <meta name="viewport" content="width=device-width, initial-scale=1">
8: <link rel="stylesheet" type="text/css" href="openbsd.css">
1.87 tb 9: <link rel="canonical" href="https://www.openbsd.org/53.html">
1.91 bentley 10: <style>
11: #sourcecode h3 {
12: color: var(--red);
13: }
14:
15: #sourcecode p {
16: margin-left: 2.75em;
17: }
18:
19: #sourcecode blockquote {
20: margin-left: 4.5em;
21: }
22: </style>
1.1 sthen 23:
1.91 bentley 24: <h2 id=OpenBSD>
1.1 sthen 25: <a href="index.html">
1.91 bentley 26: <i>Open</i><b>BSD</b></a>
27: 5.3
1.85 tj 28: </h2>
1.1 sthen 29:
1.91 bentley 30: <table>
31: <tr>
32: <td>
1.62 sthen 33: <a href="images/RoyPuffy.jpg">
1.91 bentley 34: <img width="227" height="343" src="images/RoyPuffy.jpg" alt="Roy Puffy"></a>
35: <td>
1.73 sthen 36: Released May 1, 2013<br>
1.1 sthen 37: Copyright 1997-2013, Theo de Raadt.<br>
1.91 bentley 38: <cite class=isbn>ISBN 978-0-9881561-1-1</cite>
1.1 sthen 39: <br>
1.82 deraadt 40: 5.3 Song: <a href="lyrics.html#53">"Blade Swimmer"</a>
1.90 deraadt 41: <br>
42: <br>
1.1 sthen 43: <ul>
44: <li>See the information on <a href="ftp.html">The FTP page</a> for
45: a list of mirror machines.
1.91 bentley 46: <li>Go to the <code class=reldir>pub/OpenBSD/5.3/</code> directory on
1.1 sthen 47: one of the mirror sites.
48: <li>Have a look at <a href="errata53.html">The 5.3 Errata page</a> for a list
49: of bugs and workarounds.
50: <li>See a <a href="plus53.html">detailed log of changes</a> between the
51: 5.2 and 5.3 releases.
52: </ul>
1.85 tj 53: <p>
54: All applicable copyrights and credits are in the src.tar.gz,
55: sys.tar.gz, xenocara.tar.gz, ports.tar.gz files, or in the
56: files fetched via ports.tar.gz.
1.91 bentley 57: </table>
1.85 tj 58:
59: <hr>
1.1 sthen 60:
1.91 bentley 61: <section id=new>
62: <h3>What's New</h3>
63:
1.1 sthen 64: <p>
65: This is a partial list of new features and systems included in OpenBSD 5.3.
66: For a comprehensive list, see the <a href="plus53.html">changelog</a> leading
67: to 5.3.
68: <p>
69:
1.51 sthen 70: <ul>
1.1 sthen 71: <li>Improved hardware support, including:
72: <ul>
1.91 bentley 73: <li>New driver <a href="https://man.openbsd.org/oce.4">oce(4)</a> for Emulex OneConnect 10Gb Ethernet adapters.
74: <li>New driver <a href="https://man.openbsd.org/rtsx.4">rtsx(4)</a> for the Realtek RTS5209 card reader.
75: <li>New driver <a href="https://man.openbsd.org/mfii.4">mfii(4)</a> for the LSI Logic MegaRAID SAS Fusion controllers.
76: <li>New driver <a href="https://man.openbsd.org/smsc.4">smsc(4)</a> for SMSC LAN95xx 10/100 USB Ethernet adapters.
77: <li>New drivers for Toradex OAK USB sensors: <a href="https://man.openbsd.org/uoaklux.4">uoaklux(4)</a> (illuminance), <a href="https://man.openbsd.org/uoakrh.4">uoakrh(4)</a> (temperature and relative humidity) and <a href="https://man.openbsd.org/uoakv.4">uoakv(4)</a> (+/- 10V 8channel ADC).
78: <li>New drivers for <a href="https://man.openbsd.org/virtio.4">virtio(4)</a> devices: <a href="https://man.openbsd.org/vio.4">vio(4)</a> (network), <a href="https://man.openbsd.org/vioblk.4">vioblk(4)</a> (block devices, attaching as SCSI disks) and <a href="https://man.openbsd.org/viomb.4">viomb(4)</a> (memory ballooning).
79: <li>Support for Adaptec 39320LPE added to <a href="https://man.openbsd.org/ahd.4">ahd(4)</a>.
80: <li>Broadcom 5718/5719/5720 Gigabit Ethernet devices supported in <a href="https://man.openbsd.org/bge.4">bge(4)</a>.
81: <li>Intel X540-based 10Gb Ethernet devices supported in <a href="https://man.openbsd.org/ix.4">ix(4)</a>.
82: <li>Support for SFP+ hot-plug (82599) and various other improvements in <a href="https://man.openbsd.org/ix.4">ix(4)</a>.
83: <li>TX interrupt mitigation, hardware VLAN tagging and checksum offload reduce CPU use in <a href="https://man.openbsd.org/vr.4">vr(4)</a>.
84: <li>Baby jumbo frames supported in <a href="https://man.openbsd.org/vr.4">vr(4)</a> and <a href="https://man.openbsd.org/sis.4">sis(4)</a> useful for e.g. MPLS, <a href="https://man.openbsd.org/vlan.4">vlan(4)</a> tag stacking (QinQ) and RFC4638 <a href="https://man.openbsd.org/pppoe.4">pppoe(4)</a>.
85: <li>TCP RX Checksum offload in <a href="https://man.openbsd.org/gem.4">gem(4)</a>.
86: <li>Improvements for NICs using 82579/pch2 in <a href="https://man.openbsd.org/em.4">em(4)</a>.
87: <li>Flow control is now supported on <a href="https://man.openbsd.org/bnx.4">bnx(4)</a> 5708S/5709S adapters, <a href="https://man.openbsd.org/gem.4">gem(4)</a> and <a href="https://man.openbsd.org/jme.4">jme(4)</a>.
88:
89: <li>Power-saving clients supported in hostap mode with <a href="https://man.openbsd.org/acx.4">acx(4)</a> and <a href="https://man.openbsd.org/athn.4">athn(4)</a>.
90: <li>A cause of RT2661 <a href="https://man.openbsd.org/ral.4">ral(4)</a> wedging in hostap mode was fixed.
91: <li><a href="https://man.openbsd.org/iwn.4">iwn(4)</a> supports additional devices (Centrino Advanced-N 6235 and initial support for Centrino Wireless-N 1030).
1.29 sthen 92:
1.91 bentley 93: <li>Improvements to <a href="https://man.openbsd.org/ahci.4">ahci(4)</a>.
1.29 sthen 94: <li>Support for the fixed-function performance counter on newer x86 chips with constant time stamp counters.
1.91 bentley 95: <li>Elantech touchpads supported in <a href="https://man.openbsd.org/pms.4">pms(4)</a> and <a href="https://man.openbsd.org/synaptics.4">synaptics(4)</a>.
96: <li>Support for "physical devices" on skinny <a href="https://man.openbsd.org/mfi.4">mfi(4)</a> controllers.
97: <li>VMware emulated SAS adapters supported by <a href="https://man.openbsd.org/mpi.4">mpi(4)</a>.
1.29 sthen 98: <li>Support for Intel's Supervisor Mode Execution Protection (SMEP) and Supervisor Mode Access Prevention (SMAP) features on i386 and amd64.
99: <li>Support for the RDRAND instruction to read the hardware random number generator on recent Intel processors.
100: <li>amd64 PCI memory extent changed to cover the whole 64-bit memory space; fixes erroneous extent allocation panic on IBM x3100.
1.91 bentley 101: <li><a href="https://man.openbsd.org/ulpt.4">ulpt(4)</a> can now upload firmware to certain HP LaserJet printers.
1.29 sthen 102: <li>Added stat clock to Loongson machines, improving accuracy of CPU usage statistics.
103: <li>CPU throttling supported on Loongson 2F.
1.91 bentley 104: <li>Support for Apple UniNorth and U3 AGP added to <a href="https://man.openbsd.org/agp.4">agp(4)</a>.
1.29 sthen 105: <li>DRM support for macppc.
1.1 sthen 106: </ul>
107: <p>
108:
109: <li>Generic network stack improvements:
110: <ul>
1.91 bentley 111: <li>Restriction on writing to <a href="https://man.openbsd.org/trunk.4">trunk(4)</a> member interfaces relaxed; BPF can now write to interfaces directly (useful for LLDP).
112: <li>UDP support added to <a href="https://man.openbsd.org/sosplice.9">sosplice(9)</a> (zero-copy socket splicing).
113: <li>IPv6 autoconfprivacy is enabled by default (can be disabled per-interface with an <a href="https://man.openbsd.org/ifconfig.8">ifconfig(8)</a> flag).
114: <li><a href="https://man.openbsd.org/ifconfig.8">ifconfig(8)</a> <code>hwfeatures</code> displays the maximum MTU supported by the driver (indicating support for jumbo/baby-jumbo frames).
1.34 mikeb 115: <li>Vastly improved IPsec v3 compatibility, including support for Extended Sequence Numbers in the AES-NI driver for AES-GCM and other modes.
1.1 sthen 116: </ul>
117: <p>
118:
119: <li>Routing daemons and other userland network improvements:
120: <ul>
1.91 bentley 121: <li>OpenBSD now includes <a href="https://man.openbsd.org/npppd.8">npppd(8)</a>, a server-side daemon for L2TP, L2TP/IPsec, PPTP and PPPoE.
122: <li>New standalone <a href="https://man.openbsd.org/tftp-proxy.8">tftp-proxy(8)</a> to replace the old <a href="https://man.openbsd.org/inetd.8">inetd(8)</a>-based implementation.
123: <li>SNMPv3 supported in <a href="https://man.openbsd.org/snmpd.8">snmpd(8)</a>.
124: <li><a href="https://man.openbsd.org/bgpd.8">bgpd(8)</a> is more tolerant of unknown capabilities when bringing up a session (logs a warning rather than fails).
125: <li><a href="https://man.openbsd.org/bgpd.8">bgpd(8)</a> now handles client side of "graceful restart".
126: <li><a href="https://man.openbsd.org/bgpd.8">bgpd(8)</a> can now filter based on the NEXTHOP attribute.
127: <li>A stratum can now be assigned to hardware sensors in <a href="https://man.openbsd.org/ntpd.8">ntpd(8)</a>.
128: <li><a href="https://man.openbsd.org/authpf.8">authpf(8)</a> now supports the use of per-group rules files.
129: <li><a href="https://man.openbsd.org/ftp.1">ftp(1)</a> client now supports basic HTTP authentication as per RFC 2617 and 3986 like "ftp http[s]://user:pass@host/file".
130: <li><a href="https://man.openbsd.org/ftp.1">ftp(1)</a> client's mput command allows to upload a directory tree recursively using the -r switch.
131: <li><a href="https://man.openbsd.org/relayd.8">relayd(8)</a> has various improvements including additional scheduling algorithms (least-states, for redirections, and random/source-hash, for relays).
132: <li>The <a href="https://man.openbsd.org/iked.8">iked(8)</a> IKEv2 daemon supports NAT-T. (The isakmpd daemon for IKEv1 has supported this for a long time).
133: <li><a href="https://man.openbsd.org/iked.8">iked(8)</a> blocks IPv6 traffic unless there are v6 VPN flows; this is to prevent leakages as described in <a href="http://tools.ietf.org/html/draft-gont-opsec-vpn-leakages">draft-gont-opsec-vpn-leakages</a>.
1.1 sthen 134: </ul>
135: <p>
136:
1.91 bentley 137: <li><a href="https://man.openbsd.org/dhclient.8">dhclient(8)</a> improvements:
1.40 krw 138: <ul>
139: <li>dhclient-script eliminated, all configuration is done with ioctl's and routing sockets.
140: <li>interface configuration is much faster.
1.91 bentley 141: <li>HUP signals cause dhclient to restart; making it re-read the <a href="https://man.openbsd.org/dhclient.conf.5">dhclient.conf(5)</a> and <a href="https://man.openbsd.org/resolv.conf.tail.5">resolv.conf.tail(5)</a> files, and obtain a new lease.
1.40 krw 142: <li>INIT, USR1, USR2 signals cause dhclient to exit after attempting to remove routes and addresses it configured.
1.91 bentley 143: <li><a href="https://man.openbsd.org/resolv.conf.5">resolv.conf(5)</a> is written only when the in-use default route was inserted by dhclient. Possible changes to the default route are detected and cause dhclient to write out resolv.conf when appropriate.
1.49 sthen 144: <li>interface hardware address changes are detected and cause dhclient to restart.
1.40 krw 145: <li>dhclient.conf directive 'ignore' and command line option '-i' added, allowing the suppression of specific options offered by server.
146: <li>'-L' command line option added, allowing the creation of a complete record of the most recent offer and what we modified it to when binding the lease.
147: <li>rejected offers no longer prevent dhclient from trying recorded leases and going daemon.
148: <li>cleanup of routing tables when starting and exiting is more complete.
149: <li>log messages cleaned up and reduced.
150: <li>dhclient is automatically placed in the routing domain of the interface.
151: <li>incoming and outgoing packet buffers are separate, eliminating possible transmission of inappropriate packets when re-trying DISCOVER and REQUEST.
152: <li>resolv.conf.tail read only once, at startup.
153: <li>both OFFER and ACK packets that lack required options are rejected.
1.49 sthen 154: <li>file names passed to '-L' and '-l' are constrained to be regular files.
1.40 krw 155: <li>bind success reported after binding complete, not when it is started.
156: <li>privileged process daemonizes, eliminating its controlling terminal.
157: <li>STDIN/STDOUT/STDERR no longer redirected to /dev/null when '-d' specified.
158: <li>all existing addresses on the interface are deleted when binding a new lease.
159: <li>leases which would cause routing problems because another interface is already configured with the same subnet are rejected.
160: <li>premature and repeated DISCOVER and/or REQUEST messages at startup are avoided.
161: <li>permanent ARP cache entries are no longer deleted during binding.
1.49 sthen 162: <li>allow empty lists of option names for 'ignore', 'request', and 'require' dhclient.conf directives, so lists can be reset in interface declarations.
1.91 bentley 163: <li><a href="https://man.openbsd.org/dhcpd.8">dhcpd(8)</a> and dhclient recognize the same list of dhcp options.
164: <li>hand-rolled IMSG implementation replaced with <a href="https://man.openbsd.org/imsg_init.3">imsg_init(3)</a> and related functions..
165: <li>hand-rolled date string construction replaced with <a href="https://man.openbsd.org/strftime.3">strftime(3)</a> invocations.
166: <li>hand-rolled '%m' option replaced with <a href="https://man.openbsd.org/strerror.3">strerror(3)</a> invocations.
1.40 krw 167: <li>many other internal code improvements.
168: </ul>
169: <p>
170:
1.91 bentley 171: <li><a href="https://man.openbsd.org/pf.4">pf(4)</a> improvements:
1.1 sthen 172: <ul>
1.91 bentley 173: <li> The <a href="https://man.openbsd.org/divert.4">divert(4)</a>
1.46 lteo 174: socket now supports the new IP_DIVERTFL socket option to control whether both inbound and outbound packets are diverted (the default) or only packets travelling in one direction.
1.52 sthen 175: <li>Sloppy state tracking (a special mode occasionally needed with asymmetric routing) now works correctly with ICMP.
176: <li>PF now restricts the fragment limit to protect against a misconfiguration running the kernel out of mbuf clusters.
1.1 sthen 177: </ul>
178: <p>
179:
1.48 gilles 180: <li>OpenSMTPD 5.3:
181: <ul>
182: <li>New features:
183: <ul>
184: <li>code is now considered stable and suitable for use in production.
1.91 bentley 185: <li><a href="https://man.openbsd.org/smtpctl.8">smtpctl(8)</a> <i>trace</i> supports runtime tracing of various components, including imsg exchanges, incoming and outgoing sessions, aliases expansion and much more.
186: <li><a href="https://man.openbsd.org/smtpctl.8">smtpctl(8)</a> <i>monitor</i> can now be used to monitor in real-time an instance of <a href="https://man.openbsd.org/smtpd.8">smtpd(8)</a>.
187: <li><a href="https://man.openbsd.org/smtpctl.8">smtpctl(8)</a> <i>show queue</i> now supports an "online" mode where the scheduler is queried instead of the disk-based queue to provide more accurate information.
1.49 sthen 188: <li>virtual domain support has been reworked to simplify and bring support for new features like global catch-alls and shared user mappings.
1.48 gilles 189: <li>new table API replaces the map API: better handling of transient errors, improved performances and a much better interface.
190: <li>the transfer process may now select the source IP address to use as well as the HELO hostname to advertise from a table.
191: <li>each listener may advertise a different banner hostname.
1.91 bentley 192: <li>an alternate user database may be provided instead of relying on <a href="https://man.openbsd.org/getpwnam.3">getpwnam(3)</a>.
1.48 gilles 193: <li>users may now be authenticated using credentials from a table.
194: <li>incoming sessions can be tagged, allowing for rules to only match envelopes that have been reinjected in the daemon after being passed to a proxy tool.
195: <li>intermediate bounces are now sent at configurable rates.
196: <li>rules can now check for a sender email address or domain.
1.50 sthen 197: <li>experimental (yet functional) support for aldap and sqlite as table backends.
1.48 gilles 198: </ul>
199:
200: <li>Improvements:
201: <ul>
202: <li>improved logging format to make it both easier to read and parse.
203: <li>improved memory use by scheduler, smtp, queue and transfer processes.
204: <li>more reliable and efficient disk-based queue.
205: <li>improved scheduler, dns and relaying logic that optimizes transfers.
1.91 bentley 206: <li>simplified grammar for <a href="https://man.openbsd.org/smtpd.conf.5">smtpd.conf(5)</a>.
1.48 gilles 207: <li>initial support for client and server SSL peer certificates validation.
208: <li>SSL certificate tree is now isolated and network-facing processes request SSL information on-demand by imsg.
209: <li>improved and simplified SMTP and MTA engines.
210: <li>much improved performances on both incoming and outgoing code paths.
211: <li>tons of cleanup and assorted minor bug fixes.
212: </ul>
213: </ul>
214: <p>
215:
1.59 tedu 216: <li>Security improvements:
217: <ul>
218: <li>Position-independent executables (PIE) are now used <b>by default</b> on alpha, amd64, hppa, landisk, loongson, sgi and sparc64.
1.91 bentley 219: <li><a href="https://man.openbsd.org/gcc.1">gcc(1)</a> stack smashing protector added for Alpha and MIPS (enabled by default).
1.59 tedu 220: <li>Shared libraries on GCC 4 platforms now each get their own stack protector cookies instead of sharing a single global cookie.
221: </ul>
222: <p>
223:
224: <li>Performance improvements:
225: <ul>
226: <li>Switch default disk I/O sort algorithm to NSCAN for improved fairness and response times.
227: <li>Softdep speedup improvements by the revert of a previously necessary workaround to prevent kva starvation.
1.92 ! deraadt 228: <li>Large performance and reliability improvements in
1.91 bentley 229: <a href="https://man.openbsd.org/make.1">make(1)</a>,
1.59 tedu 230: especially in parallel mode. make no longer does any busy waiting, it handles
231: concurrent targets correctly, and displays more accurate error messages.
232: <li>Increased stack alignment in constructor functions and new threads on i386 to meet requirements for SSE.
233: <li>Coredumping no longer hogs CPU or I/O and can be aborted by sending the process a SIGKILL signal.
234: </ul>
235: <p>
236:
237: <li>Threading improvements:
238: <ul>
239: <li>Threaded programs and libraries can now be linked with the POSIX-standard -lpthread flag instead of the OpenBSD-specific -pthread flag
1.91 bentley 240: <li><a href="https://man.openbsd.org/abort.3">abort(3)</a> and <a href="https://man.openbsd.org/raise.3">raise(3)</a> now direct the signal to the calling thread, as specified by POSIX.
241: <li>Whether a thread is currently executing on an alternate signal stack (c.f. <a href="https://man.openbsd.org/sigaltstack.2">sigaltstack(2)</a>) is now determined dynamically, so the stack can be reused if <a href="https://man.openbsd.org/siglongjmp.3">siglongjmp(3)</a> is used to exit the signal handler.
1.59 tedu 242: <li>libpthread now caches automatically allocated, default size thread stacks.
243: <li>Improvements in the handling of profiling, tracing, and %cpu calculation of threaded processes.
244: </ul>
245: <p>
246:
1.1 sthen 247: <li>Assorted improvements:
248: <ul>
1.91 bentley 249: <li><a href="https://man.openbsd.org/sparc64/ldomctl.8">ldomctl(8)</a>
1.9 sthen 250: was added to manage logical domains on sun4v systems through
1.91 bentley 251: <a href="https://man.openbsd.org/sparc64/ldomd.8">ldomd(8)</a>.
1.29 sthen 252: <li>Support for WPA Enterprise was added to the wpa_supplicant package.
1.91 bentley 253: <li>OpenBSD/luna88k and OpenBSD/mvme88k have switched to GCC 3, <a href="https://man.openbsd.org/elf.5">elf(5)</a> and gained shared library support.
254: <li>OpenBSD/hp300 and OpenBSD/mvme68k have switched to GCC 3 and <a href="https://man.openbsd.org/elf.5">elf(5)</a>.
255: <li><a href="https://man.openbsd.org/softraid.4">softraid(4)</a> RAID1 and crypto volumes are now bootable on i386 and amd64 (full disk encryption).
256: <li>The <a href="https://man.openbsd.org/mg.1">mg(1)</a>
257: emacs-like editor now supports <code>diff-buffer-with-file</code>, <code>make-directory</code> and <code>revert-buffer</code>.
1.43 lum 258: Column numbers have been made configurable and locale is respected for ctype purposes, like displaying ISO Latin 1 characters.
1.91 bentley 259: <li>Improved our own <a href="https://man.openbsd.org/pkg-config.1">pkg-config(1)</a>
1.7 sthen 260: implementation to make it compatible with freedesktop.org's 0.27.1 release.
1.29 sthen 261: <li>A number of improvements to the buffer cache and page daemon interactions to avoid issues in low memory/low kva situations.
1.16 beck 262: <li>Various bug fixes in uvm to avoid potential races and deadlock issues.
1.29 sthen 263: <li>Memory filesystem (mfs) switched to bufq, giving us queue limits and FIFO queueing (rather than the current LIFO queueing).
1.91 bentley 264: <li>Many improvements to the <a href="https://man.openbsd.org/cwm.1">cwm(1)</a> window manager,
1.29 sthen 265: including tab completion and Xft support for menus, improved Xinerama support, and per-group vertical/horizontal manual tiling support.
1.91 bentley 266: <li>Added <a href="https://man.openbsd.org/dprintf.3">dprintf(3)</a>, <a href="https://man.openbsd.org/grantpt.3">grantpt(3)</a>, <a href="https://man.openbsd.org/posix_openpt.3">posix_openpt(3)</a>, <a href="https://man.openbsd.org/ptsname.3">ptsname(3)</a>, <a href="https://man.openbsd.org/unlockpt.3">unlockpt(3)</a>, and <a href="https://man.openbsd.org/vdprintf.3">vdprintf(3)</a>.
1.32 guenther 267: <li>Corrected the order of invocation of constructor and destruction functions.
268: <li>Improved compliance and/or cleanliness of header files, particularly
269: <dlfcn.h>, <netdb.h>, <net/if.h>,
270: <netinet/in.h>, <sys/socket.h>, <sys/uio.h>,
271: and <sys/un.h>.
1.1 sthen 272: </ul>
273: <p>
274:
275: <li>OpenSSH 6.2:
276: <ul>
277: <li>New features:
278: <ul>
1.91 bentley 279: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>
1.37 sobrado 280: and
1.91 bentley 281: <a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
1.37 sobrado 282: Added support for AES-GCM authenticated encryption in SSH protocol 2.
283: The new cipher is available as "aes128-gcm@openssh.com" and
284: "aes256-gcm@openssh.com". It uses an identical packet format to the
285: AES-GCM mode specified in RFC 5647, but uses simpler and different
286: selection rules during key exchange.
1.91 bentley 287: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>
1.37 sobrado 288: and
1.91 bentley 289: <a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
1.37 sobrado 290: Added support for encrypt-then-mac (EtM) MAC modes for SSH protocol 2.
291: These modes alter the packet format and compute the MAC over the
292: packet length and encrypted packet rather than over the plaintext
293: data. These modes are considered more secure and are used by default
294: when available.
1.91 bentley 295: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>
1.37 sobrado 296: and
1.91 bentley 297: <a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
1.37 sobrado 298: Added support for the UMAC-128 MAC as "umac-128@openssh.com" and
299: "umac-128-etm@openssh.com". The latter being an encrypt-then-mac mode.
1.91 bentley 300: <li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
1.37 sobrado 301: Added support for multiple required authentication in SSH protocol 2
1.91 bentley 302: via an <code>AuthenticationMethods</code> option. This option lists one
1.37 sobrado 303: or more comma-separated lists of authentication method names.
304: Successful completion of all the methods in any list is required for
305: authentication to complete. This allows, for example, requiring a
306: user having to authenticate via public key or GSSAPI before they are
307: offered password authentication.
1.91 bentley 308: <li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>
1.37 sobrado 309: and
1.91 bentley 310: <a href="https://man.openbsd.org/ssh-keygen.1">ssh-keygen(1)</a>:
1.37 sobrado 311: Added support for Key Revocation Lists (KRLs), a compact binary
312: format to represent lists of revoked keys and certificates that take
313: as little as one bit per certificate when revoking by serial number.
314: KRLs may be generated using
1.91 bentley 315: <a href="https://man.openbsd.org/ssh-keygen.1">ssh-keygen(1)</a>
1.37 sobrado 316: and are loaded into
1.91 bentley 317: <a href="https://man.openbsd.org/sshd.8">sshd(8)</a>
318: via the existing <code>RevokedKeys</code>
319: <a href="https://man.openbsd.org/sshd_config.5">sshd_config(5)</a>
1.37 sobrado 320: option.
1.91 bentley 321: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
322: <code>IdentitiesOnly</code> now applies to keys obtained from a
1.37 sobrado 323: PKCS11Provider. This allows control of which keys are offered from
1.91 bentley 324: tokens using <code>IdentityFile</code>.
325: <li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
326: <a href="https://man.openbsd.org/sshd_config.5">sshd_config(5)</a>'s
327: AllowTcpForwarding now accepts "<code>local</code>" and "<code>remote</code>"
328: in addition to its previous "<code>yes</code>"/"<code>no</code>" keywords to
1.37 sobrado 329: allow the server to specify whether just local or remote TCP
330: forwarding is enabled.
1.91 bentley 331: <li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
1.37 sobrado 332: Added a
1.91 bentley 333: <a href="https://man.openbsd.org/sshd_config.5">sshd_config(5)</a>
334: option <code>AuthorizedKeysCommand</code> to support fetching
1.37 sobrado 335: authorized_keys from a command in addition to (or instead of) from
336: the filesystem. The command is run under an account specified by an
1.91 bentley 337: <code>AuthorizedKeysCommandUser</code>
338: <a href="https://man.openbsd.org/sshd_config.5">sshd_config(5)</a>
1.37 sobrado 339: option.
1.91 bentley 340: <li><a href="https://man.openbsd.org/sftp-server.8">sftp-server(8)</a>:
341: Now supports a <code>-d</code> option to allow the starting directory to
1.37 sobrado 342: be something other than the user's home directory.
1.91 bentley 343: <li><a href="https://man.openbsd.org/ssh-keygen.1">ssh-keygen(1)</a>:
1.37 sobrado 344: Now allows fingerprinting of keys hosted in PKCS#11 tokens using
345: "ssh-keygen -lD pkcs11_provider".
1.91 bentley 346: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
1.37 sobrado 347: When SSH protocol 2 only is selected (the default),
1.91 bentley 348: <a href="https://man.openbsd.org/ssh.1">ssh(1)</a>
1.37 sobrado 349: now immediately sends its SSH protocol banner to the server without
350: waiting to receive the server's banner, saving time when connecting.
1.91 bentley 351: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>
352: Added <code>~v</code> and <code>~V</code> escape sequences to raise and lower
1.37 sobrado 353: the logging level respectively.
1.91 bentley 354: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>
355: Made the escape command help (<code>~?</code>) context sensitive so that
1.37 sobrado 356: only commands that will work in the current session are shown.
1.91 bentley 357: <li><a href="https://man.openbsd.org/ssh-keygen.1">ssh-keygen(1)</a>:
1.37 sobrado 358: When deleting host lines from known_hosts using "ssh-keygen -R host",
1.91 bentley 359: <a href="https://man.openbsd.org/ssh-keygen.1">ssh-keygen(1)</a>
1.37 sobrado 360: now prints details of which lines were removed.
1.1 sthen 361: </ul>
362: <li>The following significant bugs have been fixed in this release:
363: <ul>
1.91 bentley 364: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
1.37 sobrado 365: Force a clean shutdown of ControlMaster client sessions when the
1.91 bentley 366: <code>~.</code> escape sequence is used. This means that <code>~.</code>
1.37 sobrado 367: should now work in mux clients even if the server is no longer
368: responding.
1.91 bentley 369: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
1.37 sobrado 370: Correctly detect errors during local TCP forward setup in multiplexed
371: clients. (bz#2055)
1.91 bentley 372: <li><a href="https://man.openbsd.org/ssh-add.1">ssh-add(1)</a>:
1.37 sobrado 373: Made deleting explicit keys "ssh-add -d" symmetric with adding keys
374: with respect to certificates. It now tries to delete the
1.91 bentley 375: corresponding certificate and respects the <code>-k</code> option to
1.37 sobrado 376: allow deleting of the key only.
1.91 bentley 377: <li><a href="https://man.openbsd.org/sftp.1">sftp(1)</a>:
1.37 sobrado 378: Fix a number of parsing and command-editing bugs, including bz#1956.
1.91 bentley 379: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
380: When muxmaster is run with <code>-N</code>, ensure that it shuts down
1.37 sobrado 381: gracefully when a client sends it "-O stop" rather than hanging
382: around. (bz#1985)
1.91 bentley 383: <li><a href="https://man.openbsd.org/ssh-keygen.1">ssh-keygen(1)</a>:
1.37 sobrado 384: When screening moduli candidates, append to the file rather than
385: overwriting to allow resumption. (bz#1957)
1.91 bentley 386: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
1.37 sobrado 387: Record "Received disconnect" messages at ERROR rather than INFO
388: priority. (bz#2057)
1.91 bentley 389: <li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
1.37 sobrado 390: Loudly warn if explicitly-provided private key is unreadable.
391: (bz#1981)
1.1 sthen 392: </ul>
393: </ul>
394: <p>
395:
1.92 ! deraadt 396: <li>Over 7,800 ports, major performance and stability improvements in
1.1 sthen 397: the package build process
398: <ul>
1.28 espie 399: <li>The parallel ports builder is more efficient. The main improvement is
400: that dpb consumes much less cpu on busy boxes, but there are lots of small
401: optimizations that amount to a large performance increase:
1.92 ! deraadt 402: dpb can now build selected large ports using parallel make, and it
! 403: has a notion of affinity, so that ports failing on a cluster will be
1.29 sthen 404: preferentially restarted on the same machine.
1.1 sthen 405: </ul>
406: <p>
407: <li>Many pre-built packages for each architecture:
1.91 bentley 408: <ul style="column-count: 4">
1.38 deraadt 409: <li>i386: 7670
410: <li>sparc64: 6756
1.64 deraadt 411: <li>alpha: 6151
1.71 pirofti 412: <li>sh: 1111
1.54 deraadt 413: <li>amd64: 7632
1.63 deraadt 414: <li>powerpc: 7215
1.70 sthen 415: <li>sparc: 4635
1.72 sthen 416: <li>arm: 4944
1.56 deraadt 417: <li>hppa: 6401
1.68 sebastia 418: <li>vax: 2081
1.56 deraadt 419: <li>mips64: 6519
1.60 sthen 420: <li>mips64el: 6539
1.91 bentley 421: </ul>
1.1 sthen 422: <p>
423:
424: <li>Some highlights:
425: <ul>
426: <li>GNOME 3.6.2 <li>KDE 3.5.10
427: <li>Xfce 4.10 <li>MySQL 5.1.68
1.13 sthen 428: <li>PostgreSQL 9.2.3 <li>Postfix 2.9.6
1.1 sthen 429: <li>OpenLDAP 2.3.43 and 2.4.33 <li>Mozilla Firefox 3.6.28 and 18.0.2
430: <li>Mozilla Thunderbird 17.0.2 <li>GHC 7.4.2
431: <li>LibreOffice 3.6.5.2 <li>Emacs 21.4 and 24.2
432: <li>Vim 7.3.154 <li>PHP 5.2.17 and 5.3.21
1.39 lteo 433: <li>Python 2.5.4, 2.7.3 and 3.2.3 <li>Ruby 1.8.7.370 and 1.9.3.392
1.1 sthen 434: <li>Tcl/Tk 8.5.13 and 8.6.0 <li>Jdk 1.6.0.32 and 1.7.0.11
435: <li>Mono 2.10.9 <li>Chromium 24.0.1312.68
436: <li>Groff 1.21 <li>Go 1.0.3
437: <li>GCC 4.6.3 and 4.7.2 <li>LLVM/Clang 3.2
438: </ul>
439: <p>
440:
441: <li>As usual, steady improvements in manual pages and other documentation.
442: <p>
443:
444: <li>The system includes the following major components from outside suppliers:
445: <ul>
1.12 matthieu 446: <li>Xenocara (based on X.Org 7.7 with xserver 1.12.3 + patches,
1.2 sthen 447: freetype 2.4.11, fontconfig 2.8.0, Mesa 7.11.2, xterm 287,
448: xkeyboard-config 2.7 and more)
1.33 jsg 449: <li>Gcc 4.2.1 (+patches), 3.3.6 (+ patches) and 2.95.3 (+ patches)
1.1 sthen 450: <li>Perl 5.12.2 (+ patches)
451: <li>Our improved and secured version of Apache 1.3, with
452: SSL/TLS and DSO support
1.2 sthen 453: <li>Nginx 1.2.6 (+ patches)
454: <li>OpenSSL 1.0.1c (+ patches)
455: <li>SQLite 3.7.14.1 (+ patches)
456: <li>Sendmail 8.14.6, with libmilter
1.1 sthen 457: <li>Bind 9.4.2-P2 (+ patches)
1.31 sthen 458: <li>NSD 3.2.15
1.1 sthen 459: <li>Lynx 2.8.7rel.2 with HTTPS and IPv6 support (+ patches)
460: <li>Sudo 1.7.2p8
461: <li>Ncurses 5.7
462: <li>Heimdal 0.7.2 (+ patches)
463: <li>Binutils 2.15 (+ patches)
464: <li>Gdb 6.3 (+ patches)
465: <li>Less 444 (+ patches)
466: <li>Awk Aug 10, 2011 version
467: </ul>
468: </ul>
1.91 bentley 469: </section>
1.1 sthen 470:
471: <hr>
1.91 bentley 472:
473: <section id=install>
474: <h3>How to install</h3>
475:
1.1 sthen 476: <p>
477: Following this are the instructions which you would have on a piece of
478: paper if you had purchased a CDROM set instead of doing an alternate
479: form of install. The instructions for doing an FTP (or other style
480: of) install are very similar; the CDROM instructions are left intact
481: so that you can see how much easier it would have been if you had
482: purchased a CDROM instead.
483: <p>
484:
485: <hr>
486: Please refer to the following files on the three CDROMs or FTP mirror for
487: extensive details on how to install OpenBSD 5.3 on your machine:
488: <p>
489: <ul>
490: <li>CD1:5.3/i386/INSTALL.i386
491: <p>
492: <li>CD2:5.3/amd64/INSTALL.amd64
493: <p>
494: <li>CD3:5.3/sparc64/INSTALL.sparc64
495: <p>
496: <li>FTP:.../OpenBSD/5.3/alpha/INSTALL.alpha
497: <li>FTP:.../OpenBSD/5.3/armish/INSTALL.armish
498: <li>FTP:.../OpenBSD/5.3/hp300/INSTALL.hp300
499: <li>FTP:.../OpenBSD/5.3/hppa/INSTALL.hppa
500: <li>FTP:.../OpenBSD/5.3/landisk/INSTALL.landisk
501: <li>FTP:.../OpenBSD/5.3/loongson/INSTALL.loongson
502: <li>FTP:.../OpenBSD/5.3/luna88k/INSTALL.luna88k
503: <li>FTP:.../OpenBSD/5.3/macppc/INSTALL.macppc
504: <li>FTP:.../OpenBSD/5.3/mvme68k/INSTALL.mvme68k
505: <li>FTP:.../OpenBSD/5.3/mvme88k/INSTALL.mvme88k
506: <li>FTP:.../OpenBSD/5.3/sgi/INSTALL.sgi
507: <li>FTP:.../OpenBSD/5.3/socppc/INSTALL.socppc
508: <li>FTP:.../OpenBSD/5.3/sparc/INSTALL.sparc
509: <li>FTP:.../OpenBSD/5.3/vax/INSTALL.vax
510: <li>FTP:.../OpenBSD/5.3/zaurus/INSTALL.zaurus
511: </ul>
512: <hr>
513:
1.91 bentley 514: <section id=quickinstall>
515:
1.1 sthen 516: <p>
517: Quick installer information for people familiar with OpenBSD, and the
518: use of the "disklabel -E" command. If you are at all confused when
519: installing OpenBSD, read the relevant INSTALL.* file as listed above!
1.91 bentley 520:
521: <h3>OpenBSD/i386:</h3>
522:
1.1 sthen 523: <p>
524: Play with your BIOS options to enable booting from a CD. The OpenBSD/i386
525: release is on CD1. If your BIOS does not support booting from CD, you will need
526: to create a boot floppy to install from. To create a boot floppy write
527: <i>CD1:5.3/i386/floppy53.fs</i> to a floppy and boot via the floppy drive.
528:
529: <p>
530: Use <i>CD1:5.3/i386/floppyB53.fs</i> instead for greater SCSI controller
531: support, or <i>CD1:5.3/i386/floppyC53.fs</i> for better laptop support.
532:
533: <p>
534: If you can't boot from a CD or a floppy disk,
535: you can install across the network using PXE as described in
536: the included INSTALL.i386 document.
537:
538: <p>
539: If you are planning on dual booting OpenBSD with another OS, you will need to
540: read INSTALL.i386.
541:
542: <p>
543: To make a boot floppy under MS-DOS, use the "rawrite" utility located
544: at <i>CD1:5.3/tools/rawrite.exe</i>. To make the boot floppy under a Unix OS,
545: use the
1.91 bentley 546: <a href="https://man.openbsd.org/dd.1">dd(1)</a>
1.1 sthen 547: utility. The following is an example usage of
1.91 bentley 548: <a href="https://man.openbsd.org/dd.1">dd(1)</a>,
1.1 sthen 549: where the device could be "floppy", "rfd0c", or
550: "rfd0a".
551:
1.91 bentley 552: <blockquote><pre>
1.1 sthen 553: # <strong>dd if=<file> of=/dev/<device> bs=32k</strong>
1.91 bentley 554: </pre></blockquote>
1.1 sthen 555:
556: <p>
557: Make sure you use properly formatted perfect floppies with NO BAD BLOCKS or
558: your install will most likely fail. For more information on creating a boot
559: floppy and installing OpenBSD/i386 please refer to
1.86 tj 560: <a href="faq/faq4.html#MkFlop">this page</a>.
1.91 bentley 561:
562: <h3>OpenBSD/amd64:</h3>
1.1 sthen 563:
564: <p>
565: The 5.3 release of OpenBSD/amd64 is located on CD2.
566: Boot from the CD to begin the install - you may need to adjust
567: your BIOS options first.
568: If you can't boot from the CD, you can create a boot floppy to install from.
569: To do this, write <i>CD2:5.3/amd64/floppy53.fs</i> to a floppy, then
570: boot from the floppy drive.
571:
572: <p>
573: If you can't boot from a CD or a floppy disk,
574: you can install across the network using PXE as described in the included
575: INSTALL.amd64 document.
576:
577: <p>
578: If you are planning to dual boot OpenBSD with another OS, you will need to
579: read INSTALL.amd64.
1.91 bentley 580:
581: <h3>OpenBSD/macppc:</h3>
1.1 sthen 582:
583: <p>
584: Burn the image from the FTP site to a CDROM, and poweron your machine
585: while holding down the <i>C</i> key until the display turns on and
586: shows <i>OpenBSD/macppc boot</i>.
587:
588: <p>
589: Alternatively, at the Open Firmware prompt, enter <i>boot cd:,ofwboot
590: /5.3/macppc/bsd.rd</i>
1.91 bentley 591:
592: <h3>OpenBSD/sparc64:</h3>
1.1 sthen 593:
594: <p>
595: Put CD3 in your CDROM drive and type <i>boot cdrom</i>.
596:
597: <p>
598: If this doesn't work, or if you don't have a CDROM drive, you can write
599: <i>CD3:5.3/sparc64/floppy53.fs</i> or <i>CD3:5.3/sparc64/floppyB53.fs</i>
600: (depending on your machine) to a floppy and boot it with <i>boot
601: floppy</i>. Refer to INSTALL.sparc64 for details.
602:
603: <p>
604: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
605: will most likely fail.
606:
607: <p>
608: You can also write <i>CD3:5.3/sparc64/miniroot53.fs</i> to the swap partition on
609: the disk and boot with <i>boot disk:b</i>.
610:
611: <p>
612: If nothing works, you can boot over the network as described in INSTALL.sparc64.
1.91 bentley 613:
614: <h3>OpenBSD/alpha:</h3>
1.1 sthen 615:
616: <p>
1.91 bentley 617: Write <i>FTP:5.3/alpha/floppy53.fs</i> or
1.1 sthen 618: <i>FTP:5.3/alpha/floppyB53.fs</i> (depending on your machine) to a diskette and
619: enter <i>boot dva0</i>. Refer to INSTALL.alpha for more details.
620:
621: <p>
622: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
623: will most likely fail.
624:
1.91 bentley 625: <h3>OpenBSD/armish:</h3>
1.1 sthen 626:
627: <p>
628: After connecting a serial port, Thecus can boot directly from the network
629: either tftp or http. Configure the network using fconfig, reset,
630: then load bsd.rd, see INSTALL.armish for specific details.
631: IOData HDL-G can only boot from an EXT-2 partition. Boot into linux
632: and copy 'boot' and bsd.rd into the first partition on wd0 (hda1)
633: then load and run bsd.rd, preserving the wd0i (hda1) ext2fs partition.
634: More details are available in INSTALL.armish.
635:
1.91 bentley 636: <h3>OpenBSD/hp300:</h3>
637:
1.1 sthen 638: <p>
639: Boot over the network by following the instructions in INSTALL.hp300.
1.91 bentley 640:
641: <h3>OpenBSD/hppa:</h3>
1.1 sthen 642:
643: <p>
644: Boot over the network by following the instructions in INSTALL.hppa or the
645: <a href="hppa.html#install">hppa platform page</a>.
646:
1.91 bentley 647: <h3>OpenBSD/landisk:</h3>
648:
1.1 sthen 649: <p>
650: Write <i>miniroot53.fs</i> to the start of the CF
651: or disk, and boot normally.
652:
1.91 bentley 653: <h3>OpenBSD/loongson:</h3>
654:
1.1 sthen 655: <p>
656: Write <i>miniroot53.fs</i> to a USB stick and boot bsd.rd from it
657: or boot bsd.rd via tftp.
658: Refer to the instructions in INSTALL.loongson for more details.
659:
1.91 bentley 660: <h3>OpenBSD/luna88k:</h3>
661:
1.1 sthen 662: <p>
663: Copy bsd.rd to a Mach or UniOS partition, and boot it from the PROM.
664: Alternatively, you can create a bootable tape and boot from it. Refer to
665: the instructions in INSTALL.luna88k for more details.
666:
1.91 bentley 667: <h3>OpenBSD/mvme68k:</h3>
668:
1.1 sthen 669: <p>
670: You can create a bootable installation tape or boot over the network.<br>
671: The network boot requires a MVME68K BUG version that supports the <i>NIOT</i>
672: and <i>NBO</i> debugger commands. Follow the instructions in INSTALL.mvme68k
673: for more details.
1.91 bentley 674:
675: <h3>OpenBSD/mvme88k:</h3>
1.1 sthen 676:
677: <p>
678: You can create a bootable installation tape or boot over the network.<br>
679: The network boot requires a MVME88K BUG version that supports the <i>NIOT</i>
680: and <i>NBO</i> debugger commands. Follow the instructions in INSTALL.mvme88k
681: for more details.
682:
1.91 bentley 683: <h3>OpenBSD/sgi:</h3>
684:
1.1 sthen 685: <p>
686: To install on an O2, burn cd53.iso on a CD-R, put it in the CD drive of your
687: machine and select <i>Install System Software</i> from the System Maintenance
688: menu.
689:
690: <p>
691: On other systems, or if your machine doesn't have a CD drive, you can
692: setup a DHCP/tftp network server, and boot using "bootp()/bsd.rd.IP##" using
693: the kernel matching your system type.
694: Refer to the instructions in INSTALL.sgi for more details.
695:
1.91 bentley 696: <h3>OpenBSD/socppc:</h3>
697:
1.1 sthen 698: <p>
699: After connecting a serial port, boot over the network via DHCP/tftp.
700: Refer to the instructions in INSTALL.socppc for more details.
1.91 bentley 701:
702: <h3>OpenBSD/sparc:</h3>
1.1 sthen 703:
704: <p>
705: Boot from one of the provided install ISO images, using one of the two
706: commands listed below, depending on the version of your ROM.
707:
1.91 bentley 708: <blockquote><pre>
709: ok <kbd>boot cdrom 5.3/sparc/bsd.rd</kbd>
1.1 sthen 710: or
1.91 bentley 711: > <kbd>b sd(0,6,0)5.3/sparc/bsd.rd</kbd>
712: </pre></blockquote>
1.1 sthen 713:
714: <p>
715: If your SPARC system does not have a CD drive, you can alternatively boot from floppy.
716: To do so you need to write <i>floppy53.fs</i> to a floppy.
1.86 tj 717: For more information see <a href="faq/faq4.html#MkFlop">this page</a>.
1.1 sthen 718: To boot from the floppy use one of the two commands listed below,
719: depending on the version of your ROM.
720:
1.91 bentley 721: <blockquote><pre>
722: ok <kbd>boot floppy</kbd>
1.1 sthen 723: or
1.91 bentley 724: > <kbd>b fd()</kbd>
725: </pre></blockquote>
1.1 sthen 726:
727: <p>
728: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
729: will most likely fail.
730:
731: <p>
732: If your SPARC system doesn't have a floppy drive nor a CD drive, you can either
733: setup a bootable tape, or install via network, as told in the
734: INSTALL.sparc file.
1.91 bentley 735:
736: <h3>OpenBSD/vax:</h3>
1.1 sthen 737:
738: <p>
739: Boot over the network via mopbooting as described in INSTALL.vax.
1.91 bentley 740:
741: <h3>OpenBSD/zaurus:</h3>
1.1 sthen 742:
743: <p>
744: Using the Linux built-in graphical ipkg installer, install the
745: openbsd53_arm.ipk package. Reboot, then run it. Read INSTALL.zaurus
746: for a few important details.
1.91 bentley 747:
748: </section>
749:
750: <section id=sourcecode>
751: <h3>Notes about the source code:</h3>
1.1 sthen 752:
753: <p>
754: src.tar.gz contains a source archive starting at /usr/src. This file
755: contains everything you need except for the kernel sources, which are
756: in a separate archive. To extract:
1.91 bentley 757:
758: <blockquote><pre>
759: # <kbd>mkdir -p /usr/src</kbd>
760: # <kbd>cd /usr/src</kbd>
761: # <kbd>tar xvfz /tmp/src.tar.gz</kbd>
762: </pre></blockquote>
763:
1.1 sthen 764: <p>
765: sys.tar.gz contains a source archive starting at /usr/src/sys.
766: This file contains all the kernel sources you need to rebuild kernels.
767: To extract:
1.91 bentley 768:
769: <blockquote><pre>
770: # <kbd>mkdir -p /usr/src/sys</kbd>
771: # <kbd>cd /usr/src</kbd>
1.1 sthen 772: # <strong>tar xvfz /tmp/sys.tar.gz</strong>
1.91 bentley 773: </pre></blockquote>
774:
1.1 sthen 775: <p>
776: Both of these trees are a regular CVS checkout. Using these trees it
777: is possible to get a head-start on using the anoncvs servers as
778: described <a href="anoncvs.html">here</a>.
779: Using these files
780: results in a much faster initial CVS update than you could expect from
781: a fresh checkout of the full OpenBSD source tree.
782:
1.91 bentley 783: </section>
784: </section>
785:
1.1 sthen 786: <hr>
1.91 bentley 787:
788: <section id=upgrade>
789: <h3>How to upgrade</h3>
1.1 sthen 790: <p>
791: If you already have an OpenBSD 5.2 system, and do not want to reinstall,
792: upgrade instructions and advice can be found in the
793: <a href="faq/upgrade53.html">Upgrade Guide</a>.
1.91 bentley 794: </section>
1.1 sthen 795:
796: <hr>
1.91 bentley 797:
798: <section id=ports>
799: <h3>Ports Tree</h3>
1.1 sthen 800: <p>
801: A ports tree archive is also provided. To extract:
802: <p>
1.91 bentley 803: <blockquote><pre>
804: # <kbd>cd /usr</kbd>
805: # <kbd>tar xvfz /tmp/ports.tar.gz</kbd>
806: </pre></blockquote>
1.1 sthen 807: <p>
808: The <i>ports/</i> subdirectory is a checkout of the OpenBSD ports tree. Go
809: read the <a href="faq/ports/index.html">ports</a> page
810: if you know nothing about ports
811: at this point. This text is not a manual of how to use ports.
812: Rather, it is a set of notes meant to kickstart the user on the
813: OpenBSD ports system.
814: <p>
815: The <i>ports/</i> directory represents a CVS (see the manpage for
1.91 bentley 816: <a href="https://man.openbsd.org/i386/cvs.1">
1.1 sthen 817: cvs(1)</a> if
818: you aren't familiar with CVS) checkout of our ports. As with our complete
1.17 rpe 819: source tree, our ports tree is available via
820: <a href="anoncvs.html">AnonCVS</a>.
821: So, in order to keep current with it, you must make the <i>ports/</i> tree
1.1 sthen 822: available on a read-write medium and update the tree with a command
823: like:
824: <p>
1.91 bentley 825: <blockquote><pre>
1.67 rpe 826: # <strong>cd /usr/ports</strong>
827: # <strong>cvs -d anoncvs@server.openbsd.org:/cvs update -Pd -rOPENBSD_5_3</strong>
1.91 bentley 828: </pre></blockquote>
1.1 sthen 829: <p>
1.67 rpe 830: [Of course, you must replace the server name here with a nearby anoncvs
1.1 sthen 831: server.]
832: <p>
833: Note that most ports are available as packages through FTP. Updated
834: packages for the 5.3 release will be made available if problems arise.
835: <p>
836: If you're interested in seeing a port added, would like to help out, or just
837: would like to know more, the mailing list
838: <a href="mail.html">ports@openbsd.org</a> is a good place to know.
1.91 bentley 839: </section>