Annotation of www/48.html, Revision 1.37
1.1 deraadt 1: <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
2: <html>
3: <head>
4: <title>OpenBSD 4.8 Release</title>
5: <meta name="resource-type" content="document">
6: <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
7: <meta name="description" content="OpenBSD 4.8">
8: <meta name="keywords" content="openbsd,main">
9: <meta name="distribution" content="global">
10: <meta name="copyright" content="This document copyright 2010 by OpenBSD.">
11: </head>
12:
13: <body bgcolor="#ffffff" text="#000000" link="#24248E">
14:
15: <a href="index.html">
16: <img alt="[OpenBSD]" height="30" width="141" hspace="24" src="images/smalltitle.gif" border="0"></a>
17: <hr>
18:
19: <p>
1.2 deraadt 20: <a href="images/ElPuffiachi.jpg">
1.1 deraadt 21: <img align="left" width="227" height="343" hspace="24" vspace="30"
22: src="images/ElPuffiachi.jpg" alt="OpenBSD 4.8 logo"></a>
23: <h2><font color="#0000e0">The OpenBSD 4.8 Release:</font></h2>
24: <p>
1.33 deraadt 25: Released Nov 1, 2010<br>
1.1 deraadt 26: Copyright 1997-2010, Theo de Raadt.<br>
27: <font color="#e00000">ISBN 978-0-9784475-6-4</font>
28: <br>
29: <a href="lyrics.html#48">4.8 Song: "El Puffiachi"</a>
30: <p>
31:
32: <a href="#new">What's New</a><br>
33: <a href="#install">How to install</a><br>
34: <a href="#upgrade">How to upgrade</a><br>
35: <a href="#ports">How to use the ports tree</a><br>
36: <a href="orders.html">Ordering a CD set</a><br>
37:
38: <p>
39: <h3><font color="#0000e0">
40: To get the files for this release:
41: <ul>
1.36 dcoppa 42: <li>Order a CDROM from our <a href="orders.html">ordering system</a>.
1.1 deraadt 43: <li>See the information on <a href="ftp.html">The FTP page</a> for
44: a list of mirror machines.
45: <li>Go to the <font color="#e00000">pub/OpenBSD/4.8/</font> directory on
46: one of the mirror sites.
47: <li>Briefly read the rest of this document.
48: <li>Have a look at <a href="errata48.html">The 4.8 Errata page</a> for a list
49: of bugs and workarounds.
50: <li>See a <a href="plus48.html">detailed log of changes</a> between the
51: 4.7 and 4.8 releases.
52: </ul>
53: </font></h3>
54: <br clear=all>
55:
56: <strong>Note:</strong> All applicable copyrights and credits can be found
57: in the applicable file sources found in the files src.tar.gz, sys.tar.gz,
58: xenocara.tar.gz, or in the files fetched via ports.tar.gz. The distribution
59: files used to build packages from the ports.tar.gz file are not included on
60: the CDROM because of lack of space.
61: <p>
62:
63: <a name="new"></a>
64: <hr>
65: <p>
66: <h3><font color="#0000e0">What's New</font></h3>
67: <p>
68: This is a partial list of new features and systems included in OpenBSD 4.8.
69: For a comprehensive list, see the <a href="plus48.html">changelog</a> leading
70: to 4.8.
71: <p>
72:
73: <ul>
74:
75: <li>New/extended platforms:
76: <ul>
1.21 deraadt 77: <li>i386 and amd64:
78: <ul>
79: <li>ACPI-based suspend/resume works on most machines with Intel/ATI video.
1.28 stsp 80: Machines using NVidia graphics will not resume the graphics. cardbus(4) and
1.21 deraadt 81: pcmcia(4) will still have some problems, too.
82: </ul>
1.1 deraadt 83: </ul>
84: <p>
85:
86: <li>Improved hardware support, including:
87: <ul>
1.6 jsg 88: <li>New <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=acpisony&sektion=4&format=html">acpisony(4)</a>
89: driver for Sony ACPI control.
90: <li>New <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=itherm&sektion=4&format=html">itherm(4)</a>
91: driver for Intel 3400 temperature sensor.
92: <li>New <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=se&sektion=4&format=html">se(4)</a>
93: driver for SiS 190 10/100/Gigabit Ethernet devices.
94: <li>New <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=uguru&sektion=4&format=html">uguru(4)</a>
95: driver for ABIT temperature, voltage and fan sensors.
96: <li>New <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=owctr&sektion=4&format=html">owctr(4)</a>
97: driver for 1-Wire counter devices.
1.14 jasper 98: <li>New <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=pgs&arch=macppc&secktion=4">pgs(4)</a>
99: driver for Programmers Switch found on some macppc machines.
1.7 jsg 100: <li>Support for 82576 fiber and 82577/82578 (PCH) based devices
101: has been added to <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=em&sektion=4">em(4)</a>.
102: <li>Support for 24-bit encodings and USB 2.0 playback
103: has been added to <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=uaudio&sektion=4">uaudio(4)</a>.
104: <li>Support for Winbond/Nuvoton W83627DHG-P
105: has been added to <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=wbsio&sektion=4">wbsio(4)</a>.
106: <li>Support for RTL8168E
107: has been added to <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=re&sektion=4">re(4)</a>.
108: <li>Support for 800x480
109: has been added to <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=udl&sektion=4">udl(4)</a>.
110: <li>Support for M-audio Audiophile 192k
111: has been added to <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=envy&sektion=4">envy(4)</a>.
112: <li>Support for Intel Core i3/i5 internal graphics (Ironlake)
113: has been added to <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=inteldrm&sektion=4">inteldrm(4)</a>
114: and <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=agp&sektion=4">agp(4)</a>.
1.34 damien 115: <li>The <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ss&sektion=4&manpath=OpenBSD+4.7&format=html">ss(4)</a> and
116: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=usscanner&sektion=4&manpath=OpenBSD+4.7&format=html">usscanner(4)</a>
1.14 jasper 117: drivers have been removed.
1.22 mikeb 118: <li>Improved robustness of several SCSI/SAS/RAID HBA drivers, including
119: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=mpi&sektion=4&format=html">mpi(4)</a>,
120: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=mpii&sektion=4&format=html">mpii(4)</a> and
121: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ciss&sektion=4&format=html">ciss(4)</a>.
1.1 deraadt 122: </ul>
123: <p>
124:
125: <li>New tools:
126: <ul>
1.11 jsg 127: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=iked&sektion=8">iked(8)</a>,
128: an Internet Key Exchange version 2 (IKEv2) daemon.
129: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ldapd&sektion=8">ldapd(8)</a>,
130: a Lightweight Directory Access Protocol (LDAP) daemon.
1.1 deraadt 131: </ul>
132: <p>
133:
134: <li>Filesystem midlayer improvements:
135: <ul>
1.30 stsp 136: <li>fix internal locking in (still experimental!) NTFS.
1.1 deraadt 137: </ul>
138: <p>
139:
140: <li>OpenBGPD, OpenOSPFD and other routing daemon improvements:
141: <ul>
1.24 claudio 142: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=bgpd&sektion=8">bgpd(8)</a> control sockets are now specified in the config file. This removes the -s and -r arguments to bgpd.
143: <li>Extended the BGP MPLS VPN support to allow Layer-3 MPLS VPNs to be
144: terminated on OpenBSD with the help of
145: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=mpe&sektion=4">mpe(4)</a>,
146: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ldpd&sektion=8">ldpd(8)</a>, and
147: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=bgpd&sektion=8">bgpd(8)</a>.
148: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=bgpd&sektion=8">bgpd(8)</a>
149: supports multiple FIBs and it is possible to assign them to RIBs for
150: redistribution.
151: <li>bgpd now supports to use neighbor-as in AS filter statements and added
1.25 deraadt 152: two new filters -- max-as-seq and max-as-len -- to limit the length of
1.24 claudio 153: a sequence of a single AS or the total length of an AS path.
154: <li>Added softreconfig support in bgpd for peers changing the RIB.
155: <li>Fixed multiprotocol MRT dumps and added 4-byte AS-Number support in
156: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=bgpd&sektion=8">bgpd(8)</a>.
157: <li>Added support for ping6 and traceroute6 in
158: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=bgplg&sektion=8">bgplg(8)</a>
159: and
160: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=bgplgsh&sektion=8">bgplgsh(8)</a>
161: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ospfd&sektion=8">ospfd(8)</a>
162: has better LSA pruning and config reload support.
1.20 stsp 163: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ospf6d&sektion=8">ospf6d(8)</a>
1.26 stsp 164: now supports LSAs larger than the link MTU, has improved interoperability
1.20 stsp 165: with other OSPFv3 implementations, can redistribute the default route,
166: and will correctly handle IPv6 prefixes advertised by neighbours on
167: the same link but not configured on the router itself.
1.24 claudio 168: <li>Various improvements in
169: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ldpd&sektion=8">ldpd(8)</a>
170: including correct penultimate hop popping, better session handling,
1.32 jj 171: and a improved config file parser.
1.1 deraadt 172: </ul>
173: <p>
174:
175: <li>Generic network stack improvements:
176: <ul>
1.17 schwarze 177: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ifconfig&sekti
178: on=8">ifconfig(8)</a> and
1.24 claudio 179: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=route&sektion=8">route(8)</a>
180: get better Multiprotocol Label Switching support.
181: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=traceroute&sektion=8">traceroute(8)</a>
182: now supports extended ICMP headers which allows printing of MPLS
183: labels.
1.8 stsp 184: <li>Support for RFC 4941 privacy extensions for stateless address
185: autoconfiguration has been added to <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=inet6&sektion=4">inet6(4)</a> and can be enabled via
186: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ifconfig&sektion=8">ifconfig(8)</a>.
1.16 schwarze 187: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ifconfig&sektion=8">ifconfig(8)</a>
188: now supports random selection of MAC addresses.
189: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=tcpdump&sektion=8">tcpdump(8)</a>
1.17 schwarze 190: now decodes Multicast Listener Discovery version 2 and
191: Internet Key Exchange version 2 traffic.
1.11 jsg 192: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=enc&sektion=4">enc(4)</a> and
193: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ipsec&sektion=4">ipsec(4)</a> are now
194: aware of routing domains.
1.24 claudio 195: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dhcpd&sektion=8">dhcpd(8)</a> and
196: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dhclient&sektion=8">dhclient(8)</a> and
197: are now capable of running in different routing domains.
198: <li>Added MPLS support and a simple keepalive mechanism to
199: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=gre&sektion=4">gre(4)</a>.
200: <li>Added MPLS support to
201: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=gif&sektion=4">gif(4)</a>.
202: <li>Support for 802.1ad-style QinQ nested VLANs with the addition of
203: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=svlan&sektion=4">svlan(4)</a> (service VLAN) interfaces.
204: <li>Added a RTM_DESYNC routing message as indicator that route messages
205: got dropped because of insufficent buffer space.
206: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ospfd&sektion=8">ospfd(8)</a>
207: uses this message to keep the internal view of the routing table in sync.
1.1 deraadt 208: </ul>
209: <p>
210:
1.29 krw 211: <li>SCSI improvements:
212: <ul>
213: <li>better <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=cd&sektion=4">cd(4)</a> detaching.
214: <li>better <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=st&sektion=4">st(4)</a> sense data and buf handling.
215: <li>eliminate excessive delays when starting DVD playing.
216: <li>ask only for minimal (i.e. 18 bytes) sense data, fixing usb devices.
217: <li>migrate to using bufq.
218: <li>always try READ CAPACITY 16 on devices claiming to be SCSI-3.
219: <li>many performance and reliability improvements as a result of new SCSI midlayer:
220: <ul>
1.31 dlg 221: <li>introduce round-robin scheduling of resources for outstanding device commands to prevent a single device from monopolising the bus.
222: <li>significant reduction in memory consumption used for tracking devices attached to buses.
1.29 krw 223: <li>eliminate many unnecessary splbio/splx calls in SCSI drivers.
224: <li>eliminate many use after free's exposed by new SCSI midlayer.
225: <li>eliminate scsi_scsi_cmd(), simplifying calling inside SCSI midlayer.
226: <li>eliminate struct scsi_device.
227: <li>eliminate many uninitialized data references and invalid scsi_done() calls exposed by new SCSI midlayer.
228: <li>eliminate use of EAGAIN.
229: <li>eliminate almost all uses of NO_CCB and XS_NO_CCB.
230: </ul>
231: </ul>
232: <p>
233:
1.1 deraadt 234: <li>Assorted improvements:
235: <ul>
1.17 schwarze 236: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=mbtowc&sektion=3">mbtowc(3)</a> multi-byte/wide-character conversion functions
237: have been added to the C library, and
238: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=setlocale&sektion=3">setlocale(3)</a>
239: now supports the en_US.UTF-8 locale.
240: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=posix_madvise&sektion=2">posix_madvise(2)</a>,
241: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=posix_memalign&sektion=3">posix_memalign(3)</a>,
242: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=strndup&sektion=3">strndup(3)</a>, and
243: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=strnlen&sektion=3">strnlen(3)</a>
244: have been added to the C library.
1.16 schwarze 245: <li>The <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=event&sektion=3">event(3)</a> library
1.17 schwarze 246: was updated to version 1.4.14b.
1.16 schwarze 247: <li>The <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=pthreads&sektion=3">pthreads(3)</a> library
248: now implements the <tt>pthread_rwlock_timed{rd,wr}lock</tt> interfaces.
1.17 schwarze 249: <li>AES-NI support has been integrated into the OpenSSL
250: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=crypto&sektion=3">crypto(3)</a> library.
1.12 ratchov 251: <li>MIDI control in non-server mode was added to
252: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=aucat&sektion=1">aucat(1)</a>,
253: including seeking within .wav files
254: <li>A new record-what-you-hear feature was added to
255: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=aucat&sektion=1">aucat(1)</a>.
256: <li>The minimum extra latency of the
257: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=aucat&sektion=1">aucat(1)</a>
258: server was lowered to a single block, improving
259: usability of low-latency programs without stability compromise.
1.16 schwarze 260: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=disklabel&sektion=8">disklabel(8)</a>
261: now supports unique disk identifiers.
1.17 schwarze 262: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ftp&sektion=1">ftp(1)</a>
263: now handles redirection to relative URLs in the Location: header
264: of HTTP responses.
265: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=lint&sektion=1">lint(1)</a>
266: now recognizes the C99 data types _Bool and _Complex
267: and some related gcc extensions.
268: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=make&sektion=1">make(1)</a>
269: now allows variables in SysV modifiers,
270: and implements the :QL (quote list) modifier.
1.16 schwarze 271: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=man&sektion=1">man(1)</a> now allows to combine the -s option with -m or -M.
1.17 schwarze 272: <li>Improved directory editing in <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=mg&sektion=1">mg(1)</a>.
1.16 schwarze 273: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=newfs&sektion=8">newfs(8)</a> has been tweaked to better support large file systems.
274: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=od&sektion=1">od(1)</a>
275: now supports the POSIX -A option to select an input address base.
276: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sendbug&sektion=1">sendbug(1)</a>
277: now includes the output of <tt>usbdevs -v</tt> into the template.
278: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=smtpd&sektion=8">smtpd(8)</a>
279: now supports the SIZE and ENHANCEDSTATUSCODES extensions
1.17 schwarze 280: and the "plain" backend for maps, and performance was improved when handling large amounts of mail.
1.24 claudio 281: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=snmpd&sektion=8">snmpd(8)</a>
282: now supports the IP-FORWARD-MIB.
1.17 schwarze 283: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=wsconsctl&sektion=8">wsconsctl(8)</a> now handles more than one keyboard, mouse and display.
1.14 jasper 284: <li>Many memory leaks have been fixed in various userland utilities.
1.23 mikeb 285: <li><a href="http://www.openbsd.org/amd64.html">amd64</a>,
286: <a href="http://www.openbsd.org/i386.html">i386</a>,
287: <a href="http://www.openbsd.org/hppa.html">hppa</a>,
288: <a href="http://www.openbsd.org/sparc64.html">sparc64</a>,
289: <a href="http://www.openbsd.org/socppc.html">socppc</a> and
290: <a href="http://www.openbsd.org/macppc.html">macppc</a>
291: platforms were switched over to gcc4.
1.29 krw 292: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=newfs&sektion=8">newfs(8)</a> now makes FFS2 the default for partitions larger than INT_MAX blocks.
293: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dhcpd&sektion=8">dhcpd(8)</a> now includes the server id in NAK messages, as required by some
294: relays.
295: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=disklabel&sektion=8">disklabel(8)</a> now aligns the start and end of FFS partitions on bsize boundaries where it can, to improve performance on 4096-byte block devices.
296: <li>by default, read and write caching is now turned on for non-USB scsi disks.
297: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=getdirentries&sektion=2">getdirentries(2)</a> now checks to ensure that it doesn't wrap or truncate directory information on architectures where LONG is a different size from LONG LONG.
298: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=disklabel&sektion=8">disklabel(8)</a> now ensures correct physical bounds and disk size are used when building a disklabel from saved ascii disklabel.
299: <li>it is again possible to build a bsd.rd that has DDB.
300: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=pms&sektion=4">pms(4)</a> now works much better with various trackpads and over suspend/resume cycles.
301: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=fdisk&sektion=8">fdisk(8)</a> now aligns the OpenBSD partition on a power of 2 block boundary to improve performance on 4096-byte block devices.
302: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=nfsd&sektion=8">nfsd(8)</a> now logs start up errors to the system log as well as the console.
303: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=nfsd&sektion=8">nfsd(8)</a> now errors out if given an invalid number of servers to run.
1.1 deraadt 304: </ul>
305: <p>
306:
307: <li>Install/Upgrade process changes:
308: <ul>
1.13 jasper 309: <li>If the system time is off by more than 120 seconds, ask if the user
310: wants to set it accordingly.
1.16 schwarze 311: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=disklabel&sektion=8">disklabel(8)</a>
312: now allows to customize auto allocated labels using the -R option.
1.13 jasper 313: <li>Default network install method changed from FTP to HTTP.
314: <li>Automatically set
315: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=pkg.conf&sektion=5">/etc/pkg.conf</a>
316: `installfrom' entry to the public mirror used while installing or upgrading.
1.17 schwarze 317: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sysmerge&sektion=8">sysmerge(8)</a> now automatically installs missing users and groups.
1.29 krw 318: <li>Eliminate more excessively chatty remarks during install.
319: <li>Handle disk UID partitions better.
1.1 deraadt 320: </ul>
321: <p>
322:
1.7 jsg 323: <li>OpenSSH 5.6:
1.1 deraadt 324: <ul>
325: <li>New features:
1.14 jasper 326: <ul>
327: <li>Added a <em>ControlPersist</em> option to
328: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh_config&sektion=5">ssh_config(5)</a>.
329: <li>Hostbased authentication may now use certificate host keys.
330: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-keygen&sektion=1">ssh-keygen(1)</a>
331: now supports signing certificate using a CA key that has been stored
332: in a PKCS#11 token.
333: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>
334: will now log the hostname and address that we connected to at
335: LogLevel=verbose after authentication is successful to mitigate
336: "phishing" attacks.
337: <li>Expand %h to the hostname in ssh_config Hostname options.
338: <li>Allow <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-keygen&sektion=1">ssh-keygen(1)</a>
339: to import and export of PEM and PKCS#8 keys.
340: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>
341: will now queue debug messages for bad ownership or permissions on
342: the user's keyfiles encountered during authentication.
343: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>
344: connection multiplexing now supports remote forwarding with
345: dynamic port allocation and can report the allocated port back to
346: the user.
347: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>
348: now supports indirection in matching of principal names listed in
349: certificates.
350: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>
351: now has a new <em>AuthorizedPrincipalsFile</em> option.
352: <li>Additional <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd_config&sektion=5">sshd_config(5)</a>
353: options are now valid inside Match blocks:
354: <ul>
355: <li><em>AuthorizedKeysFile</em>
356: <li><em>AuthorizedPrincipalsFile</em>
357: <li><em>HostbasedUsesNameFromPacketOnly</em>
358: <li><em>PermitTunnel</em>
359: </ul>
1.1 deraadt 360: </ul>
361: <li>The following significant bugs have been fixed in this release:
362: <ul>
1.14 jasper 363: <li>The PKCS#11 code now retries a lookup for a private key if there is
364: no matching key with <em>CKA_SIGN</em> attribute enabled (bz#1736).
365: <li>Unbreak strdelim() skipping past quoted strings.
366: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sftp&sektion=1">sftp(1)</a>:
367: fix swapped args in upload_dir_internal() (bz#1797).
368: <li>Fix a longstanding problem where if you suspend
369: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=scp&sektion=1">scp(1)</a>
370: at the password/passphrase prompt the terminal mode is not restored.
371: <li>Fix a PKCS#11 crash on some smartcards by validating the length
372: returned for C_GetAttributValue (bz#1773).
373: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sftp&sektion=1">sftp(1)</a>:
374: fix ls in working directories that contain globbing
375: characters in their pathnames (bz#1655).
376: <li>Print warning for missing home directory when
377: <em>ChrootDirectory=none.</em> (bz#1564).
378: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sftp&sektion=1">sftp(1)</a>:
379: fix a memory leak in do_realpath() error path (bz#1771).
380: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-keygen&sektion=1">ssh-keygen(1)</a>:
381: Standardise error messages when attempting to open
382: private key files to include "progname: filename: error reason" (bz#1783).
383: <li>Replace verbose and overflow-prone Linebuf code with
384: read_keyfile_line() (bz#1565).
385: <li>Include the user name on "subsystem request for ..." log messages.
386: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>
387: and
388: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
389: remove hardcoded limit of 100 permitopen clauses and port forwards
390: per direction (bz#1327).
391: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
392: ignore stderr output from subsystems to avoid hangs if a subsystem
393: or shell initialisation writes to stderr (bz#1750).
394: <li>Skip the initial check for access with an empty password when
395: <em>PermitEmptyPasswords=no</em> (bz#1638).
396: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=sshd&sektion=8">sshd(8)</a>:
397: fix logspam when key options (from="..." especially) deny
398: non-matching keys (bz#1765).
399: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-keygen&sektion=1">ssh-keygen(1)</a>:
400: display a more helpful error message when $HOME is
401: inaccessible while trying to create .ssh directory (bz#1740).
402: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh&sektion=1">ssh(1)</a>:
403: fix hang when terminating a mux slave using ~ (bz#1758).
404: <li><a href="http://www.openbsd.org/cgi-bin/man.cgi?query=ssh-keygen&sektion=1">ssh-keygen(1)</a>:
405: refuse to generate keys longer than
406: <em>OPENSSL_[RD]SA_MAX_MODULUS_BITS</em> (bz#1516).
407: <li>Suppress spurious tty warning when using -O and stdin is not a tty
408: (bz#1746).
409: <li>Kill channel when pty allocation requests fail (bz#1698).
1.1 deraadt 410: </ul>
411: </ul>
412: <p>
413:
1.15 schwarze 414: <li>Mandoc 1.10.5:
415: <ul>
416: <li>The <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=mandoc&sektion=1">mandoc(1)</a>
417: utility is now used to build all manuals in the base system
418: and in Xenocara from
419: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=mdoc&sektion=7">mdoc(7)</a> and
420: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=man&sektion=7">man(7)</a>
421: sources.
422: <li>New integrated roff preprocessor with minimal support for conditional
423: requests, nested roff requests, string definitions, roff registers,
424: also parsing and ignoring macro definitions.
425: <li>Improved support for manual pages generated by
426: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=pod2man&sektion=1">pod2man(1)</a>.
427: <li>Many parser improvements, in particular
428: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=mdoc&sektion=7">mdoc(7)</a>
429: support for word keeps, synopsis mode in arbitrary sections,
430: graceful handling of badly nested blocks, and improved parsing
431: of column displays.
432: <li>New PostScript and PDF output frontends.
433: <li>Many ASCII and HTML output formatting improvements, for example
434: proper synopsis indentation and improved end-of-sentence detection.
435: <li>Considerably improved syntax checking and error reporting.
436: </ul>
1.1 deraadt 437: <p>
438:
439: <li>Over 6,400 ports, major robustness and speed improvements in package tools.
440: <li>Many pre-built packages for each architecture:
441: <table border=0 cellspacing=0 cellpadding=2 width="95%">
442: <tr>
443: <td valign="top" width="25%">
444: <ul>
445: <li>i386: 6218
446: <li>sparc64: 5950
447: <li>alpha: 5827
448: </ul></td><td valign=top width="25%"><ul>
1.18 deraadt 449: <li>sh: 1100
1.1 deraadt 450: <li>amd64: 6166
451: <li>powerpc: 5996
452: </ul></td><td valign=top width="25%"><ul>
453: <li>sparc: 4130
1.19 deraadt 454: <li>arm: 5628
1.1 deraadt 455: <li>hppa: 5632
456: </ul></td><td valign=top width="25%"><ul>
457: <li>vax: 1528
458: <li>mips64: 3632
459: <li>mips64el: 4486
460: </ul></td></tr></table>
461: Some highlights:
462: <ul>
1.3 landry 463: <li>Gnome 2.30.2.
1.1 deraadt 464: <li>KDE 3.5.10.
1.3 landry 465: <li>Xfce 4.6.2.
1.5 jasper 466: <li>MySQL 5.1.48.
1.3 landry 467: <li>PostgreSQL 8.4.4.
468: <li>Postfix 2.7.1.
1.1 deraadt 469: <li>OpenLDAP 2.3.43.
1.3 landry 470: <li>Mozilla Firefox 3.6.8 and 3.5.11.
471: <li>Mozilla Thunderbird 3.1.1.
472: <li>OpenOffice.org 3.2.1.
1.1 deraadt 473: <li>Emacs 21.4 and 22.3
1.3 landry 474: <li>Vim 7.2.444.
475: <li>PHP 5.2.13.
476: <li>Python 2.4.6, 2.5.4 and 2.6.5.
1.1 deraadt 477: <li>Ruby 1.8.6.369.
1.13 jasper 478: <li>Mono 2.6.4.
1.1 deraadt 479: </ul>
480: <p>
481:
482: <li>As usual, steady improvements in manual pages and other documentation.
483: <p>
484:
485: <li>The system includes the following major components from outside suppliers:
486: <ul>
1.9 matthieu 487: <li>Xenocara (based on X.Org 7.5 with xserver 1.8 + patches,
1.4 jasper 488: freetype 2.3.12,
489: fontconfig 2.8.0, Mesa 7.8.2, xterm 258 and more)
490: <li>Gcc 2.95.3 (+ patches), 3.3.5 (+ patches) and 4.2.1 (+patches)
1.1 deraadt 491: <li>Perl 5.10.1 (+ patches)
492: <li>Our improved and secured version of Apache 1.3, with SSL/TLS
493: and DSO support
494: <li>OpenSSL 0.9.8k (+ patches)
495: <li>Groff 1.15
496: <li>Sendmail 8.14.3, with libmilter
497: <li>Bind 9.4.2-P2 (+ patches)
498: <li>Lynx 2.8.6rel.5 with HTTPS and IPv6 support (+ patches)
499: <li>Sudo 1.7.2
500: <li>Ncurses 5.7
501: <li>Latest KAME IPv6
502: <li>Heimdal 0.7.2 (+ patches)
503: <li>Arla 0.35.7
504: <li>Binutils 2.15 (+ patches)
505: <li>Gdb 6.3 (+ patches)
506: </ul>
507: <p>
508:
509: </ul>
510:
511: <a name="install"></a>
512: <hr>
513: <p>
514: <h3><font color="#0000e0">How to install</font></h3>
515: <p>
516: Following this are the instructions which you would have on a piece of
517: paper if you had purchased a CDROM set instead of doing an alternate
518: form of install. The instructions for doing an FTP (or other style
519: of) install are very similar; the CDROM instructions are left intact
520: so that you can see how much easier it would have been if you had
521: purchased a CDROM instead.
522: <p>
523:
524: <hr>
525: Please refer to the following files on the three CDROMs or FTP mirror for
526: extensive details on how to install OpenBSD 4.8 on your machine:
527: <p>
528: <ul>
529: <li>CD1:4.8/i386/INSTALL.i386
530: <p>
531: <li>CD2:4.8/amd64/INSTALL.amd64
532: <li>CD2:4.8/macppc/INSTALL.macppc
533: <p>
534: <li>CD3:4.8/sparc64/INSTALL.sparc64
535: <p>
536: <li>FTP:.../OpenBSD/4.8/alpha/INSTALL.alpha
537: <li>FTP:.../OpenBSD/4.8/armish/INSTALL.armish
538: <li>FTP:.../OpenBSD/4.8/hp300/INSTALL.hp300
539: <li>FTP:.../OpenBSD/4.8/hppa/INSTALL.hppa
540: <li>FTP:.../OpenBSD/4.8/landisk/INSTALL.landisk
541: <li>FTP:.../OpenBSD/4.8/loongson/INSTALL.loongson
542: <li>FTP:.../OpenBSD/4.8/mvme68k/INSTALL.mvme68k
543: <li>FTP:.../OpenBSD/4.8/mvme88k/INSTALL.mvme88k
544: <li>FTP:.../OpenBSD/4.8/sgi/INSTALL.sgi
545: <li>FTP:.../OpenBSD/4.8/socppc/INSTALL.socppc
546: <li>FTP:.../OpenBSD/4.8/sparc/INSTALL.sparc
547: <li>FTP:.../OpenBSD/4.8/vax/INSTALL.vax
548: <li>FTP:.../OpenBSD/4.8/zaurus/INSTALL.zaurus
549: </ul>
550: <hr>
551:
552: <p>
553: Quick installer information for people familiar with OpenBSD, and the
554: use of the "disklabel -E" command. If you are at all confused when
555: installing OpenBSD, read the relevant INSTALL.* file as listed above!
556: <p>
557:
558: <h3><font color="#e00000">OpenBSD/i386:</font></h3>
559: <ul>
560: Play with your BIOS options to enable booting from a CD. The OpenBSD/i386
561: release is on CD1. If your BIOS does not support booting from CD, you will need
562: to create a boot floppy to install from. To create a boot floppy write
563: <i>CD1:4.8/i386/floppy48.fs</i> to a floppy and boot via the floppy drive.
564:
565: <p>
566: Use <i>CD1:4.8/i386/floppyB48.fs</i> instead for greater SCSI controller
567: support, or <i>CD1:4.8/i386/floppyC48.fs</i> for better laptop support.
568:
569: <p>
570: If you can't boot from a CD or a floppy disk,
571: you can install across the network using PXE as described in
572: the included INSTALL.i386 document.
573:
574: <p>
575: If you are planning on dual booting OpenBSD with another OS, you will need to
576: read INSTALL.i386.
577:
578: <p>
579: To make a boot floppy under MS-DOS, use the "rawrite" utility located
580: at <i>CD1:4.8/tools/rawrite.exe</i>. To make the boot floppy under a Unix OS,
581: use the
582: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dd&sektion=1">dd(1)</a>
583: utility. The following is an example usage of
584: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=dd&sektion=1">dd(1)</a>,
585: where the device could be "floppy", "rfd0c", or
586: "rfd0a".
587:
588: <ul><pre>
589: # <strong>dd if=<file> of=/dev/<device> bs=32k</strong>
590: </pre></ul>
591:
592: <p>
593: Make sure you use properly formatted perfect floppies with NO BAD BLOCKS or
594: your install will most likely fail. For more information on creating a boot
595: floppy and installing OpenBSD/i386 please refer to
1.10 lum 596: <a href="faq/faq4.html#MkFlop">FAQ 4.3.2</a>.
1.1 deraadt 597: </ul>
598:
599: <p>
600: <h3><font color="#e00000">OpenBSD/amd64:</font></h3>
601: <ul>
602: The 4.8 release of OpenBSD/amd64 is located on CD2.
603: Boot from the CD to begin the install - you may need to adjust
604: your BIOS options first.
605: If you can't boot from the CD, you can create a boot floppy to install from.
606: To do this, write <i>CD2:4.8/amd64/floppy48.fs</i> to a floppy, then
607: boot from the floppy drive.
608:
609: <p>
610: If you can't boot from a CD or a floppy disk,
611: you can install across the network using PXE as described in the included
612: INSTALL.amd64 document.
613:
614: <p>
615: If you are planning to dual boot OpenBSD with another OS, you will need to
616: read INSTALL.amd64.
617: </ul>
618:
619: <p>
620: <h3><font color="#e00000">OpenBSD/macppc:</font></h3>
621: <ul>
622: Put CD2 in your CDROM drive and poweron your machine while holding down the
623: <i>C</i> key until the display turns on and shows <i>OpenBSD/macppc boot</i>.
624:
625: <p>
626: Alternatively, at the Open Firmware prompt, enter <i>boot cd:,ofwboot
627: /4.8/macppc/bsd.rd</i>
628: </ul>
629:
630: <p>
631: <h3><font color="#e00000">OpenBSD/sparc64:</font></h3>
632: <ul>
633: Put CD3 in your CDROM drive and type <i>boot cdrom</i>.
634:
635: <p>
636: If this doesn't work, or if you don't have a CDROM drive, you can write
637: <i>CD3:4.8/sparc64/floppy48.fs</i> or <i>CD3:4.8/sparc64/floppyB48.fs</i>
638: (depending on your machine) to a floppy and boot it with <i>boot
639: floppy</i>. Refer to INSTALL.sparc64 for details.
640:
641: <p>
642: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
643: will most likely fail.
644:
645: <p>
646: You can also write <i>CD3:4.8/sparc64/miniroot48.fs</i> to the swap partition on
647: the disk and boot with <i>boot disk:b</i>.
648:
649: <p>
650: If nothing works, you can boot over the network as described in INSTALL.sparc64.
651: </ul>
652:
653: <p>
654: <h3><font color="#e00000">OpenBSD/alpha:</font></h3>
655: <ul>
656: <p>Write <i>FTP:4.8/alpha/floppy48.fs</i> or
657: <i>FTP:4.8/alpha/floppyB48.fs</i> (depending on your machine) to a diskette and
658: enter <i>boot dva0</i>. Refer to INSTALL.alpha for more details.
659:
660: <p>
661: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
662: will most likely fail.
663:
664: </ul>
665:
666: <p>
667: <h3><font color="#e00000">OpenBSD/armish:</font></h3>
668: <ul>
669: <p>
670: After connecting a serial port, Thecus can boot directly from the network
671: either tftp or http. Configure the network using fconfig, reset,
672: then load bsd.rd, see INSTALL.armish for specific details.
673: IOData HDL-G can only boot from an EXT-2 partition. Boot into linux
674: and copy 'boot' and bsd.rd into the first partition on wd0 (hda1)
675: then load and run bsd.rd, preserving the wd0i (hda1) ext2fs partition.
676: More details are available in INSTALL.armish.
677: </ul>
678:
679: <p>
680: <h3><font color="#e00000">OpenBSD/hp300:</font></h3>
681: <ul>
682: <p>
683: Boot over the network by following the instructions in INSTALL.hp300.
684: </ul>
685:
686: <p>
687: <h3><font color="#e00000">OpenBSD/hppa:</font></h3>
688: <ul>
689: <p>
690: Boot over the network by following the instructions in INSTALL.hppa or the
691: <a href="hppa.html#install">hppa platform page</a>.
692: </ul>
693:
694: <p>
695: <h3><font color="#e00000">OpenBSD/landisk:</font></h3>
696: <ul>
697: <p>
698: Write <i>miniroot48.fs</i> to the start of the CF
699: or disk, and boot normally.
700: </ul>
701:
702: <p>
703: <h3><font color="#e00000">OpenBSD/loongson:</font></h3>
704: <ul>
705: <p>
706: Write <i>miniroot48.fs</i> to a USB stick and boot bsd.rd from it
707: or boot bsd.rd via tftp.
708: Refer to the instructions in INSTALL.loongson for more details.
709: </ul>
710: <p>
711:
712: <p>
713: <h3><font color="#e00000">OpenBSD/mvme68k:</font></h3>
714: <ul>
715: <p>
716: You can create a bootable installation tape or boot over the network.<br>
717: The network boot requires a MVME68K BUG version that supports the <i>NIOT</i>
718: and <i>NBO</i> debugger commands. Follow the instructions in INSTALL.mvme68k
719: for more details.
720: </ul>
721:
722: <p>
723: <h3><font color="#e00000">OpenBSD/mvme88k:</font></h3>
724: <ul>
725: <p>
726: You can create a bootable installation tape or boot over the network.<br>
727: The network boot requires a MVME88K BUG version that supports the <i>NIOT</i>
728: and <i>NBO</i> debugger commands. Follow the instructions in INSTALL.mvme88k
729: for more details.
730: </ul>
731:
732: <p>
733: <h3><font color="#e00000">OpenBSD/sgi:</font></h3>
734: <ul>
735: <p>
736: To install on an O2, burn cd48.iso on a CD-R, put it in the CD drive of your
737: machine and select <i>Install System Software</i> from the System Maintenance
738: menu.
739:
740: <p>
741: On other systems, or if your machine doesn't have a CD drive, you can
742: setup a DHCP/tftp network server, and boot using "bootp()/bsd.rd.IP##" using
743: the kernel matching your system type.
744: Refer to the instructions in INSTALL.sgi for more details.
745: </ul>
746:
747: <p>
748: <h3><font color="#e00000">OpenBSD/socppc:</font></h3>
749: <ul>
750: <p>
751: After connecting a serial port, boot over the network via DHCP/tftp.
752: Refer to the instructions in INSTALL.socppc for more details.
753: </ul>
754:
755: <p>
756: <h3><font color="#e00000">OpenBSD/sparc:</font></h3>
757: <ul>
758: Boot from one of the provided install ISO images, using one of the two
759: commands listed below, depending on the version of your ROM.
760:
761: <ul><pre>
762: ok <strong>boot cdrom 4.8/sparc/bsd.rd</strong>
763: or
764: > <strong>b sd(0,6,0)4.8/sparc/bsd.rd</strong>
765: </pre></ul>
766:
767: <p>
768: If your SPARC system does not have a CD drive, you can alternatively boot from floppy.
769: To do so you need to write <i>floppy48.fs</i> to a floppy.
1.35 lum 770: For more information see <a href="faq/faq4.html#MkFlop">FAQ 4.3.2</a>.
1.1 deraadt 771: To boot from the floppy use one of the two commands listed below,
772: depending on the version of your ROM.
773:
774: <ul><pre>
775: ok <strong>boot floppy</strong>
776: or
777: > <strong>b fd()</strong>
778: </pre></ul>
779:
780: <p>
781: Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
782: will most likely fail.
783:
784: <p>
785: If your SPARC system doesn't have a floppy drive nor a CD drive, you can either
786: setup a bootable tape, or install via network, as told in the
787: INSTALL.sparc file.
788: </ul>
789:
790: <p>
791: <h3><font color="#e00000">OpenBSD/vax:</font></h3>
792: <ul>
793: Boot over the network via mopbooting as described in INSTALL.vax.
794: </ul>
795:
796: <p>
797: <h3><font color="#e00000">OpenBSD/zaurus:</font></h3>
798: <ul>
799: <p>
800: Using the Linux built-in graphical ipkg installer, install the
801: openbsd48_arm.ipk package. Reboot, then run it. Read INSTALL.zaurus
802: for a few important details.
803: </ul>
804:
805: <p>
806: <h3><font color="#e00000">Notes about the source code:</font></h3>
807: <ul>
808: src.tar.gz contains a source archive starting at /usr/src. This file
809: contains everything you need except for the kernel sources, which are
810: in a separate archive. To extract:
811: <p>
812: <ul><pre>
813: # <strong>mkdir -p /usr/src</strong>
814: # <strong>cd /usr/src</strong>
815: # <strong>tar xvfz /tmp/src.tar.gz</strong>
816: </pre></ul>
817: <p>
818: sys.tar.gz contains a source archive starting at /usr/src/sys.
819: This file contains all the kernel sources you need to rebuild kernels.
820: To extract:
821: <p>
822: <ul><pre>
823: # <strong>mkdir -p /usr/src/sys</strong>
824: # <strong>cd /usr/src</strong>
825: # <strong>tar xvfz /tmp/sys.tar.gz</strong>
826: </pre></ul>
827: <p>
828: Both of these trees are a regular CVS checkout. Using these trees it
829: is possible to get a head-start on using the anoncvs servers as
830: described <a href="anoncvs.html">here</a>.
831: Using these files
832: results in a much faster initial CVS update than you could expect from
833: a fresh checkout of the full OpenBSD source tree.
834: <p>
835: </ul>
836:
837: <a name="upgrade"></a>
838: <hr>
839: <p>
840: <h3><font color="#0000e0">How to upgrade</font></h3>
841: <p>
842: If you already have an OpenBSD 4.7 system, and do not want to reinstall,
843: upgrade instructions and advice can be found in the
844: <a href="faq/upgrade48.html">Upgrade Guide</a>.
845:
846: <a name="ports"></a>
847: <hr>
848: <p>
849: <h3><font color="#0000e0">Ports Tree</font></h3>
850: <p>
851: A ports tree archive is also provided. To extract:
852: <p>
853: <ul><pre>
854: # <strong>cd /usr</strong>
855: # <strong>tar xvfz /tmp/ports.tar.gz</strong>
856: # <strong>cd ports</strong>
857: </pre></ul>
858: <p>
859: The <i>ports/</i> subdirectory is a checkout of the OpenBSD ports tree. Go
860: read the <a href="faq/ports/index.html">ports</a> page
861: if you know nothing about ports
862: at this point. This text is not a manual of how to use ports.
863: Rather, it is a set of notes meant to kickstart the user on the
864: OpenBSD ports system.
865: <p>
866: The <i>ports/</i> directory represents a CVS (see the manpage for
867: <a href="http://www.openbsd.org/cgi-bin/man.cgi?query=cvs&apropos=0&sektion=1&manpath=OpenBSD+Current&arch=i386">
868: cvs(1)</a> if
869: you aren't familiar with CVS) checkout of our ports. As with our complete
870: source tree, our ports tree is available via anoncvs. So, in
871: order to keep current with it, you must make the <i>ports/</i> tree
872: available on a read-write medium and update the tree with a command
873: like:
874: <p>
875: <ul><pre>
876: # <strong>cd [portsdir]/; cvs -d anoncvs@server.openbsd.org:/cvs update -Pd -rOPENBSD_4_8</strong>
877: </pre></ul>
878: <p>
879: [Of course, you must replace the local directory and server name here
880: with the location of your ports collection and a nearby anoncvs
881: server.]
882: <p>
883: Note that most ports are available as packages through FTP. Updated
884: packages for the 4.8 release will be made available if problems arise.
885: <p>
886: If you're interested in seeing a port added, would like to help out, or just
887: would like to know more, the mailing list ports@openbsd.org is a good
888: place to know.
889: <p>
890:
891: </body>
892: </html>