[BACK]Return to 48.html CVS log [TXT][DIR] Up to [local] / www

Annotation of www/48.html, Revision 1.59

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