forked from openbsd/www
-
Notifications
You must be signed in to change notification settings - Fork 0
/
58.html
943 lines (860 loc) · 43.6 KB
/
58.html
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
489
490
491
492
493
494
495
496
497
498
499
500
501
502
503
504
505
506
507
508
509
510
511
512
513
514
515
516
517
518
519
520
521
522
523
524
525
526
527
528
529
530
531
532
533
534
535
536
537
538
539
540
541
542
543
544
545
546
547
548
549
550
551
552
553
554
555
556
557
558
559
560
561
562
563
564
565
566
567
568
569
570
571
572
573
574
575
576
577
578
579
580
581
582
583
584
585
586
587
588
589
590
591
592
593
594
595
596
597
598
599
600
601
602
603
604
605
606
607
608
609
610
611
612
613
614
615
616
617
618
619
620
621
622
623
624
625
626
627
628
629
630
631
632
633
634
635
636
637
638
639
640
641
642
643
644
645
646
647
648
649
650
651
652
653
654
655
656
657
658
659
660
661
662
663
664
665
666
667
668
669
670
671
672
673
674
675
676
677
678
679
680
681
682
683
684
685
686
687
688
689
690
691
692
693
694
695
696
697
698
699
700
701
702
703
704
705
706
707
708
709
710
711
712
713
714
715
716
717
718
719
720
721
722
723
724
725
726
727
728
729
730
731
732
733
734
735
736
737
738
739
740
741
742
743
744
745
746
747
748
749
750
751
752
753
754
755
756
757
758
759
760
761
762
763
764
765
766
767
768
769
770
771
772
773
774
775
776
777
778
779
780
781
782
783
784
785
786
787
788
789
790
791
792
793
794
795
796
797
798
799
800
801
802
803
804
805
806
807
808
809
810
811
812
813
814
815
816
817
818
819
820
821
822
823
824
825
826
827
828
829
830
831
832
833
834
835
836
837
838
839
840
841
842
843
844
845
846
847
848
849
850
851
852
853
854
855
856
857
858
859
860
861
862
863
864
865
866
867
868
869
870
871
872
873
874
875
876
877
878
879
880
881
882
883
884
885
886
887
888
889
890
891
892
893
894
895
896
897
898
899
900
901
902
903
904
905
906
907
908
909
910
911
912
913
914
915
916
917
918
919
920
921
922
923
924
925
926
927
928
929
930
931
932
933
934
935
936
937
938
939
940
941
942
943
<!doctype html>
<html lang=en id=release>
<meta charset=utf-8>
<title>OpenBSD 5.8</title>
<meta name="description" content="OpenBSD 5.8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<link rel="stylesheet" type="text/css" href="openbsd.css">
<link rel="canonical" href="https://www.openbsd.org/58.html">
<h2 id=OpenBSD>
<a href="index.html">
<i>Open</i><b>BSD</b></a>
5.8
</h2>
<table>
<tr>
<td>
<a href="images/fishhearts.jpg">
<img width="227" height="343" src="images/fishhearts.jpg" alt="Fish Hearts"></a>
<td>
Released Oct 18, 2015<br>
Copyright 1997-2015, Theo de Raadt.<br>
<cite class=isbn>ISBN 978-0-9881561-6-6</cite>
<br>
5.8 Songs: <a href="lyrics.html#58a">"20 years ago today"</a>,
<a href="lyrics.html#58b">"Fanza"</a>,
<a href="lyrics.html#58c">"So much better"</a>,
<a href="lyrics.html#58d">"A Year in the Life"</a>
<br>
<br>
<ul>
<li>See the information on <a href="ftp.html">the FTP page</a> for
a list of mirror machines.
<li>Go to the <code class=reldir>pub/OpenBSD/5.8/</code> directory on
one of the mirror sites.
<li>Have a look at <a href="errata58.html">the 5.8 errata page</a> for a list
of bugs and workarounds.
<li>See a <a href="plus58.html">detailed log of changes</a> between the
5.7 and 5.8 releases.
<p>
<li><a href="https://man.openbsd.org/signify.1">signify(1)</a>
pubkeys for this release:<p>
<table class=signify>
<tr><td>
openbsd-58-base.pub:
<td>
RWQNNZXtC/MqP3Eiu+6FBz/qrxiWQwDhd+9Yljzp62UP4KzFmmvzVk60
<tr><td>
openbsd-58-fw.pub:
<td>
RWTpkvg4fhJCDx9yL4bUCou/vtAecPVTfcaaGESQeBruwX/qHToMvWh6
<tr><td>
openbsd-58-pkg.pub:
<td>
RWRlkI2aFHvL/XGqD+lFerD/xUi/jnAXKwdFQwZDekYwDrEPSpSWgpI9
</table>
</ul>
<p>
All applicable copyrights and credits are in the src.tar.gz,
sys.tar.gz, xenocara.tar.gz, ports.tar.gz files, or in the
files fetched via <code>ports.tar.gz</code>.
</table>
<p>
NOTE: The src.tar.gz file on the CD is incorrect; see
<a href="errata58.html#006_src">5.8 errata 006</a>.
<hr>
<section id=new>
<h3>What's New</h3>
<p>
This is a partial list of new features and systems included in OpenBSD 5.8.
For a comprehensive list, see the <a href="plus58.html">changelog</a> leading
to 5.8.
<ul>
<li>Improved hardware support, including:
<ul>
<li>New <a href="https://man.openbsd.org/rtwn&sec=4">rtwn(4)</a> driver for Realtek RTL8188CE wifi cards.
<li>New <a href="https://man.openbsd.org/hpb&sec=4&arch=macppc">hpb(4)</a> driver for HyperTransport bridges as found in the IBM CPC945.
<li>The <a href="https://man.openbsd.org/ugold&sec=4">ugold(4)</a> driver now supports TEMPerHUMV1.x temperature and humidity sensors.
<li>Improved sensor support for the <a href="https://man.openbsd.org/upd&sec=4">upd(4)</a> driver for USB Power Devices (UPS).
<li>Support for jumbo frames on <a href="https://man.openbsd.org/re&sec=4">re(4)</a> devices using RTL8168C/D/E/F/G and RTL8411, including PC Engines APU.
<li><a href="https://man.openbsd.org/re&sec=4">re(4)</a> now works with newer devices e.g. RTL8111GU.
<li>Partial support has been added for full-speed isochronous devices in <a href="https://man.openbsd.org/ehci&sec=4">ehci(4)</a>, allowing USB 1.1 audio devices to be used on EHCI-only systems in some cases.
<li>Improved macppc stability and G5 performances with MP kernels.
<li><a href="https://man.openbsd.org/acpicpu&sec=4">acpicpu(4)</a> uses ACPI C-state information to reduce power consumption of idle CPUs.
<li>Kernel supports x86 AVX instructions on CPUs that have them.
<li>Avoid assigning low address to PCI BARs, fixing various issues on machines whose BIOSes neglect to claim low memory.
<li><a href="https://man.openbsd.org/wscons&sec=4">wscons(4)</a> works with even more odd trackpads.
<li>Added <a href="https://man.openbsd.org/pvbus&sec=4">pvbus(4)</a> paravirtual device tree root on virtual machines that are running on hypervisors.
<li>New octdwctwo(4) driver for USB support on OpenBSD/octeon.
<li>New <a href="https://man.openbsd.org/amdcf&sec=4">amdcf(4)</a> driver for embedded flash on OpenBSD/octeon.
<li>Support for RTL8188EU devices was added to the <a href="https://man.openbsd.org/urtwn&sec=4">urtwn(4)</a> driver.
</ul>
<p>
<li>Removed hardware support:
<ul>
<li>The <a href="https://man.openbsd.org/OpenBSD-5.7/man4/lmc.4">lmc(4)</a> driver for Lan Media Corporation SSI/T1/DS1/HSSI/DS3 devices has been removed.
<li>The <a href="https://man.openbsd.org/OpenBSD-5.7/man4/san.4">san(4)</a> driver for Sangoma Technologies AFT T1/E1 devices has been removed.
</ul>
<p>
<li>Generic network stack improvements:
<ul>
<li>MTU of <a href="https://man.openbsd.org/vlan.4">vlan(4)</a> devices can now be set independently from the parent interface's MTU.
<li>The same network range can now be assigned to multiple interfaces, using interface priorities to choose between them.
<li>New MPLS pseudowire driver <a href="https://man.openbsd.org/mpw.4">mpw(4)</a>.
<li>Much preparatory work for MP unlocking of the network stack.
</ul>
<p>
<li>Installer improvements:
<ul>
<li>The logic of the 'Allow root ssh login?' question has been changed.
<ul>
<li>The default answer is now 'no'.
<li>'prohibit-password' has been added to the list of possible answers.
</ul>
<li><a href="https://man.openbsd.org/autoinstall&sec=8">autoinstall(8)</a>
has been extended to allow
<ul>
<li><code>hostname-mode.conf</code> response file names.
<li>response files to be placed in a subdir of the webserver's document root.
<li>passing a template file to
<a href="https://man.openbsd.org/disklabel&sec=8">disklabel(8)</a>
to automatically partition the disk.
</ul>
<li><a href="https://man.openbsd.org/ntpd&sec=8">ntpd(8)</a>
is now enabled by default at install time.
<li>DUID support has improved enough that new installs now use them unconditionally.
<li>Installing sets from CD-ROM has been fixed if more than one CD-ROM drive is present.
<li>The 'Which CD-ROM contains the install media?' question has been removed.
Available cdrom devices are now shown directly in the 'Location of sets?' prompt.
</ul>
<p>
<li>Routing daemons and other userland network improvements:
<ul>
<li>Many improvements and simplifications in <a href="https://man.openbsd.org/ldpd.8">ldpd(8)</a>, including configuration reload and support for <a href="https://man.openbsd.org/mpw.4">mpw(4)</a> pseudowire interfaces.
<li><a href="https://man.openbsd.org/bgpd.8">bgpd(8)</a> now allows rules to match on the peer AS number.
<li>For terminated BGP sessions, <a href="https://man.openbsd.org/bgpctl.8">bgpctl(8)</a> now displays the number of prefixes received on the last session.
<li><a href="https://man.openbsd.org/ospfd.8">ospfd(8)</a> now correctly handles <a href="https://man.openbsd.org/carp.4">carp(4)</a> interfaces in "backup" mode at startup.
<li>Log messages in <a href="https://man.openbsd.org/bgpd.8">bgpd(8)</a> and <a href="https://man.openbsd.org/ospfd.8">ospfd(8)</a> have been made more specific.
<li>The default Diffie-Hellman group for VPNs configured by <a href="https://man.openbsd.org/ipsec.conf.5">ipsec.conf(5)</a> has been changed to modp3072.
<li>New <a href="https://man.openbsd.org/radiusd.8">radiusd(8)</a>,
Remote Authentication Dial In User Service (RADIUS) daemon.
</ul>
<p>
<li>Security improvements:
<ul>
<li>sudo in base has been replaced with <a href="https://man.openbsd.org/doas.1">doas(1)</a>, sudo is available as a package.
<li><a href="https://man.openbsd.org/file.1">file(1)</a> has been replaced with a new modern implementation, including sandbox and privilege separation.
<li><a href="https://man.openbsd.org/pax.1">pax(1)</a> (and <a href="https://man.openbsd.org/tar.1">tar(1)</a> and <a href="https://man.openbsd.org/cpio.1">cpio(1)</a>) now prevent archive extraction from escaping the current directory via symlinks; <a href="https://man.openbsd.org/tar.1">tar(1)</a> without <code>-P</code> option now strips up through any "<code>..</code>" path components.
<li>Static PIE support for sparc.
<li>Alpha switched to secure PLT.
<li>Improved kernel checks of ELF headers.
<li>Support for the NX (No-eXecute) bit on i386, resulting in much better W^X enforcement in userland for hardware that has this feature.
<li>Enforcement of W^X in the kernel address space on i386 when using processors with the NX bit.
<li>Work started on a new process-containment facility called <a href="https://man.openbsd.org/OpenBSD-5.8/tame.2">tame(2)</a>.
</ul>
<p>
<li>Assorted improvements:
<ul>
<li>The <a href="https://man.openbsd.org/worm.6">worm(6)</a>
now grows at a rate proportional to terminal size.
<li><a href="https://man.openbsd.org/dlfcn.3">dlclose(3)</a> now unregisters handlers registered by a <a href="https://man.openbsd.org/pthread_atfork.3">pthread_atfork(3)</a> call from the unloaded libraries.
<li><a href="https://man.openbsd.org/cp.1">cp(1)</a>, <a href="https://man.openbsd.org/mv.1">mv(1)</a>, and <a href="https://man.openbsd.org/pax.1">pax(1)</a> with the <code>-rw</code> option now preserve timestamps with full nanosecond precision.
<li><a href="https://man.openbsd.org/pax.1">pax(1)</a> now detects failure to decompress an archive when reading it and errors out immediately.
<li><a href="https://man.openbsd.org/nm.1">nm(1)</a> now supports the <code>-D</code> option for displaying the dynamic symbol table.
<li><a href="https://man.openbsd.org/dump.8">dump(8)</a> now uses DUIDs in <code>/etc/dumpdates</code> when present and the <code>-U</code> option has thus been removed.
<li>Corrected <a href="https://man.openbsd.org/kdump.1">kdump(1)</a> reporting of <a href="https://man.openbsd.org/lseek.2">lseek(2)</a> return value on ILP32 archs and <a href="https://man.openbsd.org/getsockopt.2">getsockopt/setsockopt(2)</a> level and optname arguments. <code>iovec</code>, <code>msghdr</code>, and <code>cmsghdr</code> structures are now dumped.
<li><a href="https://man.openbsd.org/sed.1">sed(1)</a> <code>-i</code> option added.
<li>New, much simpler <a href="https://man.openbsd.org/man.conf.5">man.conf(5)</a> configuration file format
for <a href="https://man.openbsd.org/man.1">man(1)</a>,
<a href="https://man.openbsd.org/apropos.1">apropos(1)</a>,
and <a href="https://man.openbsd.org/makewhatis.8">makewhatis(8)</a>.
<li>When using <a href="https://man.openbsd.org/man.1">man(1)</a>
with the <a href="https://man.openbsd.org/less.1">less(1)</a> pager,
support the <code>:t</code> internal command
to search for definitions of keywords similar to what
<a href="https://man.openbsd.org/ctags.1">ctags(1)</a> provides.
<li>Improvements in checking of numeric option values in <b>many</b> utilities.
<li>Upgraded to binutils version 2.17 with additional fixes.
<li>Improved correctness of <a href="https://man.openbsd.org/poll.2">poll(2)</a> and <a href="https://man.openbsd.org/poll.2">poll(2)</a> of <code>O_RDONLY</code> FIFO fds.
<li>Restored reporting of closed sockets by <a href="https://man.openbsd.org/netstat.1">netstat(1)</a> and <a href="https://man.openbsd.org/systat.1">systat(1)</a>.
<li><a href="https://man.openbsd.org/fdisk.8">fdisk(8)</a> now zeros correct GPT sector at end of disk.
<li><a href="https://man.openbsd.org/fdisk.8">fdisk(8)</a> now accepts 'T' sizes for terabytes.
<li><a href="https://man.openbsd.org/fdisk.8">fdisk(8)</a> repaired to work on 4K sector disks again.
<li><a href="https://man.openbsd.org/dhcpd.8">dhcpd(8)</a> now logs correct giaddr and ciaddr information even when DHCP relays are present.
<li><a href="https://man.openbsd.org/dhcpd.8">dhcpd(8)</a> now accommodates Linux and MS clients by not sending routers or static routes info when classless static routes are sent.
<li><a href="https://man.openbsd.org/dhcpd.8">dhcpd(8)</a> and <a href="https://man.openbsd.org/dhclient.8">dhclient(8)</a> now accept hostnames beginning with a digit.
<li><a href="https://man.openbsd.org/dhclient.8">dhclient(8)</a> no longer rejects leases with addresses overlapping existing subnets on other interfaces. Kernel routing logic now just works.
<li>Improvements to <a href="https://man.openbsd.org/realloc.3">realloc(3)</a> decrease system calls and increase efficiency.
<li>The reaper now tears down dead processes without holding on to
the kernel lock. This greatly reduces latency and increases
performance on multi-processor systems.
</ul>
<p>
<li>OpenBSD <a href="https://man.openbsd.org/httpd.8">httpd(8)</a>:
<ul>
<li>New features:
<ul>
<li>Added support for matching and redirections with Lua <a href="https://man.openbsd.org/OpenBSD-current/man7/patterns.7">patterns(7)</a>.
<li>Implemented If-Modified-Since for conditional GET or HEAD requests (RFC 7232).
<li>Added byte-range support for range requests (RFC 7233).
<li>Allowing to specify a global or per-location default media type instead of <code>application/octet-stream</code>.
<li>Added support for HTTP Strict Transport Security (HSTS; RFC 6797).
<li>Added initial regression test suite based on <a href="https://man.openbsd.org/OpenBSD-current/man8/relayd.8">relayd(8)</a>'s implementation.
</ul>
<li>Fixes and improvements:
<ul>
<li>TLS in <a href="https://man.openbsd.org/OpenBSD-current/man8/httpd.8">httpd(8)</a> and <a href="https://man.openbsd.org/OpenBSD-current/man8/relayd.8">relayd(8)</a> now defaults to TLSv1.2-only.
<li>Fixed support for large TLS keys or certificate bundles with up to 16KB each.
<li>Fixed the Content-Length header for files larger than 2 GB on 32-bit architectures.
<li>Fixed translation of CGI environment variables in accordance with RFCs 7230 and 3875.
<li>Improved memory usage and fixed possible memory exhaustion on large file transfers.
<li>Added URL-encoding of specific CGI variables before using them in the Location header.
<li>Prepend files or directories containing ":" with "./" in directory indexes as per RFC 3986.
<li>Allowing to specify characters like "?" in the Location URI.
<li>Various other bug fixes and improvements.
</ul>
</ul>
<p>
<li>OpenSMTPD 5.4.4
<ul>
<li><a href="https://man.openbsd.org/smtpd.8">smtpd(8)</a> reliability and bug fixes.
<li><b>NOTE: Some security risks were discovered and fixed after the
OpenBSD 5.8 release.
See <a href="errata58.html#004_smtpd">5.8 errata 004</a>.</b>
</ul>
<p>
<li>OpenSSH 7.0
<ul>
<li>Security:
<ul>
<li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
when forwarding X11 connections with <code>ForwardX11Trusted=no</code>,
connections made after <code>ForwardX11Timeout</code> expired could be
permitted and no longer subject to XSECURITY restrictions because of
an ineffective timeout check in
<a href="https://man.openbsd.org/ssh.1">ssh(1)</a>
coupled with "fail open" behaviour in the X11 server when clients
attempted connections with expired credentials.
This problem was reported by Jann Horn.
<li><a href="https://man.openbsd.org/ssh-agent.1">ssh-agent(1)</a>:
fix weakness of agent locking (<code>ssh-add -x</code>) to
password guessing by implementing an increasing failure delay,
storing a salted hash of the password rather than the password
itself and using a timing-safe comparison function for verifying
unlock attempts. This problem was reported by Ryan Castellucci.
<li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
OpenSSH 6.8 and 6.9 incorrectly set TTYs to be world-writable.
Local attackers may be able to write arbitrary messages to logged-in
users, including terminal escape sequences.
<li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
fix circumvention of <code>MaxAuthTries</code> using keyboard-interactive
authentication. By specifying a long, repeating keyboard-interactive
"devices" string, an attacker could request the same authentication
method be tried thousands of times in a single pass. The
<code>LoginGraceTime</code> timeout in
<a href="https://man.openbsd.org/sshd.8">sshd(8)</a>
and any authentication failure delays implemented by the authentication
mechanism itself were still applied.
</ul>
<li>Potentially-incompatible changes:
<ul>
<li>Support for the legacy <i>SSH version 1 protocol</i> is disabled by
default at compile time.
<li>Support for the 1024-bit diffie-hellman-group1-sha1 key exchange
is disabled by default at run-time. It may be re-enabled using
the instructions at <code>https://www.openssh.com/legacy.html</code>.
<li>Support for <code>ssh-dss</code>, <code>ssh-dss-cert-*</code> <i>host</i>
and <i>user</i> keys is disabled by default at run-time. These may
be re-enabled using the instructions at
<code>https://www.openssh.com/legacy.html</code>.
<li>Support for the legacy <i>v00 cert format</i> has been removed.
<li>The default for the
<a href="https://man.openbsd.org/sshd_config.5">sshd_config(5)</a>
<code>PermitRootLogin</code> option has changed from "yes" to
"prohibit-password" (but the OpenBSD installer defaults to "no").
<li><b>NOTE: 'PermitRootLogin prohibit-password' is subtly broken
in the OpenBSD 5.8 / OpenSSH 7.0. See
<a href="errata58.html#001_sshd">5.8 errata 001</a>.</b>
</ul>
<li>New/changed features:
<ul>
<li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>,
<a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
promote <code>chacha20-poly1305@openssh.com</code> to be the default
cipher.
<li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
support admin-specified arguments to <code>AuthorizedKeysCommand</code>.
(bz#2081)
<li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
add <code>AuthorizedPrincipalsCommand</code> that allows retrieving
authorized principals information from a subprocess rather than a
file.
<li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>,
<a href="https://man.openbsd.org/ssh-add.1">ssh-add(1)</a>:
support PKCS#11 devices with external PIN entry devices. (bz#2240)
<li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
allow GSSAPI host credential check to be relaxed for multihomed
hosts via <code>GSSAPIStrictAcceptorCheck</code> option. (bz#928)
<li><a href="https://man.openbsd.org/ssh-keygen.1">ssh-keygen(1)</a>:
support <code>ssh-keygen -lF hostname</code> to search <code>known_hosts</code>
and print key hashes rather than full keys.
<li><a href="https://man.openbsd.org/ssh-agent.1">ssh-agent(1)</a>:
add <code>-D</code> flag to leave
<a href="https://man.openbsd.org/ssh-agent.1">ssh-agent(1)</a>
in foreground without enabling debug mode. (bz#2381)
<li><a href="https://man.openbsd.org/ssh_config.5">ssh_config(5)</a>:
add <code>PubkeyAcceptedKeyTypes</code> option to control which public
key types are available for user authentication.
<li><a href="https://man.openbsd.org/sshd_config.5">sshd_config(5)</a>:
add <code>HostKeyAlgorithms</code> option to control which public key
types are offered for host authentications.
<li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>,
<a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
extend <code>Ciphers</code>, <code>MACs</code>, <code>KexAlgorithms</code>,
<code>HostKeyAlgorithms</code>, <code>PubkeyAcceptedKeyTypes</code> and
<code>HostbasedKeyTypes</code> options to allow appending to the default
set of algorithms instead of replacing it. Options may now be
prefixed with a <code>+</code> to append to the default, e.g.
"<code>HostKeyAlgorithms=+ssh-dss</code>".
</ul>
<li>The following significant bugs have been fixed in this release:
<ul>
<li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>,
<a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
deprecate legacy <code>SSH2_MSG_KEX_DH_GEX_REQUEST_OLD</code> message and
do not try to use it against some 3rd-party SSH implementations that
use it (older PuTTY, WinSCP).
<li>Many fixes for problems caused by compile-time deactivation of
SSH1 support. (including bz#2369)
<li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>,
<a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
cap DH-GEX group size at 4Kbits for Cisco implementations as some
would fail when attempting to use group sizes greater than 4K.
(bz#2209)
<li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
fix out-of-bound read in <code>EscapeChar</code> configuration option
parsing. (bz#2396)
<li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
fix application of <code>PermitTunnel</code>, <code>LoginGraceTime</code>,
<code>AuthenticationMethods</code> and <code>StreamLocalBindMask</code>
options in <code>Match</code> blocks.
<li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>,
<a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
improve disconnection message on TCP reset. (bz#2257)
<li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
remove failed remote forwards established by multiplexing from the
list of active forwards. (bz#2363)
<li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
make parsing of <code>authorized_keys</code> "<code>environment=</code>"
options independent of <code>PermitUserEnv</code> being enabled. (bz#2329)
<li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
fix post-auth crash with <code>permitopen=none</code>. (bz#2355)
<li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>,
<a href="https://man.openbsd.org/ssh-add.1">ssh-add(1)</a>,
<a href="https://man.openbsd.org/ssh-keygen.1">ssh-keygen(1)</a>:
allow new-format private keys to be encrypted with AEAD ciphers.
(bz#2366)
<li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
allow <code>ListenAddress</code>, <code>Port</code> and <code>AddressFamily</code>
configuration options to appear in any order. (bz#86)
<li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
check for and reject missing arguments for <code>VersionAddendum</code>
and <code>ForceCommand</code>. (bz#2281)
<li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>,
<a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
don't treat unknown certificate extensions as fatal. (bz#2387)
<li><a href="https://man.openbsd.org/ssh-keygen.1">ssh-keygen(1)</a>:
make <code>stdout</code> and <code>stderr</code> output consistent. (bz#2325)
<li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
mention missing <code>DISPLAY</code> environment in debug log when X11
forwarding requested. (bz#1682)
<li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
correctly record login when <code>UseLogin</code> is set. (bz#378)
<li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
add some missing options to <code>sshd -T</code> output and fix output
of <code>VersionAddendum</code> and <code>HostCertificate</code>. (bz#2346)
<li>Document and improve consistency of options that accept a
"<code>none</code>" argument: <code>TrustedUserCAKeys</code>,
<code>RevokedKeys</code> (bz#2382), <code>AuthorizedPrincipalsFile</code>
(bz#2288).
<li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
include remote username in debug output. (bz#2368)
<li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
avoid compatibility problem with some versions of Tera Term, which
would crash when they received the hostkeys notification message
(<code>hostkeys-00@openssh.com</code>).
<li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
mention <code>ssh-keygen -E</code> as useful when comparing legacy
<i>MD5 host key fingerprints</i>. (bz#2332)
<li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
clarify pseudo-terminal request behaviour and use make manual language
consistent. (bz#1716)
<li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
document that the <code>TERM</code> environment variable is not subject
to <code>SendEnv</code> and <code>AcceptEnv</code>. (bz#2386)
<li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>,
<a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
add compatibility workarounds for Cisco and more PuTTY versions.
(bz#2424)
<li>Fix some omissions and errors in the <code>PROTOCOL</code> and
<code>PROTCOL.mux</code> documentation relating to <i>Unix domain
socket</i> forwarding. (bz#2421, bz#2422)
<li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>:
Improve the
<a href="https://man.openbsd.org/ssh.1">ssh(1)</a>
manual page to include a better description of Unix domain socket
forwarding. (bz#2423)
<li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>,
<a href="https://man.openbsd.org/ssh-agent.1">ssh-agent(1)</a>:
skip uninitialised PKCS#11 slots, fixing failures to load keys when
they are present. (bz#2427)
<li><a href="https://man.openbsd.org/ssh.1">ssh(1)</a>,
<a href="https://man.openbsd.org/ssh-agent.1">ssh-agent(1)</a>:
do not ignore PKCS#11 hosted keys that wth empty <code>CKA_ID</code>.
(bz#2429)
<li><a href="https://man.openbsd.org/sshd.8">sshd(8)</a>:
clarify documentation for <code>UseDNS</code> option. (bz#2045)
</ul>
</ul>
<p>
<li>LibreSSL
<ul>
<li>User-visible features:
<ul>
<li>Reject all <i>server DH keys</i> smaller than 1024 bits.
<li>Multiple CVEs fixed including CVE-2015-0207, CVE-2015-0209,
CVE-2015-0286, CVE-2015-0287, CVE-2015-0288, CVE-2015-0289,
CVE-2015-1788, CVE-2015-1789, CVE-2015-1792.
<li>Protocol parsing conversions to BoringSSL's <i>CRYPTO ByteString</i>
(CBS) API.
<li>Added <code>EC_curve_nid2nist</code> and <code>EC_curve_nist2nid</code>
from OpenSSL.
<li>Removed Dynamic Engine support.
<li>Removed MDC-2DES support.
<li>Switched <code>openssl dhparam</code> default from 512 to 2048 bits.
<li>Fixed <code>openssl pkeyutl -verify</code> to exit with a 0 on success.
<li>Fixed dozens of Coverity issues including dead code, memory leaks,
logic errors and more.
<li>Ensure that
<a href="https://man.openbsd.org/openssl.1">openssl(1)</a>
restores terminal echo state after reading a password.
<li>Incorporated fix for OpenSSL issue #3683.
<li>Removed SSLv3 support from
<a href="https://man.openbsd.org/openssl.1">openssl(1)</a>.
<li>Modified <code>tls_write</code> in <code>libtls</code> to allow partial
writes, clarified with examples in the documentation.
<li>Removed RSAX engine.
<li>Tested SSLv3 removal with the OpenBSD ports tree and found several
applications that were not ready to build without SSLv3 yet.
For now, building a program that intentionally uses SSLv3 will
result in a linker warning.
<li>Added <code>TLS_method</code>, <code>TLS_client_method</code> and
<code>TLS_server_method</code> as a replacement for the
<code>SSLv23_*method</code> calls.
<li>Default <code>cert.pem</code>, <code>openssl.cnf</code>, and
<code>x509v3.cnf</code> files are now installed under
<code>$sysconfdir/ssl</code> or the directory specified by
<code>--with-openssldir</code>. Previous versions of LibreSSL left
these empty.
<li><b>NOTE: LibreSSL 2.2.2 in OpenBSD 5.8 incorrectly handles
ClientHello messages that do not include TLS extensions, resulting
in such handshakes being aborted. See
<a href="errata58.html#002_sslhello">5.8 errata 002</a>.</b>
<li><b>NOTE: An issue (likely denial of service) was found in LibreSSL;
See <a href="errata58.html#007_obj2txt">5.8 errata 007</a>.</b>
</ul>
<li>Code improvements:
<ul>
<li>Fix incorrect comparison function in <a href="https://man.openbsd.org/openssl.1">openssl(1)</a> certhash command.
Thanks to Christian Neukirchen / Void Linux.
<li>Removal of <code>OPENSSL_issetugid</code> and all library getenv calls.
Applications can and should no longer rely on environment variables
for changing library behavior.
<code>OPENSSL_CONF</code> and <code>SSLEAY_CONF</code> are still supported with the
<a href="https://man.openbsd.org/openssl.1">openssl(1)</a>
command, but note that $ENV:: is no longer supported in .cnf files.
<li><code>libtls</code> API and documentation additions.
<li>Various bug fixes and simplifications to <code>libssl</code> and
<code>libcrypto</code>.
<li>Reworked
<a href="https://man.openbsd.org/openssl.1">openssl(1)</a>
option handling.
<li>LibreSSL version define <code>LIBRESSL_VERSION_NUMBER</code> will now
be bumped for each portable release.
<li>Removed workarounds for TLS client padding bugs.
<li>Removed IE 6 SSLv3 workarounds.
<li><code>--with-enginesdir</code> is removed as a configuration parameter.
</ul>
</ul>
<p>
<li>Syslogd:
<ul>
<li>OpenBSD
<a href="https://man.openbsd.org/syslogd.8">syslogd(8)</a>
can bind to explicitly given UDP or TCP sockets to receive messages.
TCP streams are accepted with the octet counting or the non
transparent framing method.
<li>Blocks in
<a href="https://man.openbsd.org/syslog.conf.5">syslog.conf(5)</a>
started with <code>+host</code> process messages created by
certain hosts specifically.
<li>Handle situations when the file descriptor limit is exhausted
gracefully.
<li>Since libtls handles short writes smarter, <a href="https://man.openbsd.org/syslogd.8">syslogd(8)</a> can use the
complete output buffer to save messages, coping with
longer TLS server down times without losing messages.
</ul>
<p>
<li><p>Ports and packages:
<p>Many pre-built packages for each architecture:
<ul style="column-count: 4">
<li>alpha: 7093
<li>amd64: 8866
<li>hppa: 5813
<li>i386: 8839
<li>mips64: 4267
<li>mips64el: 5922
<li>powerpc: 8114
<li>sh: 133
<li>sparc64: 7851
<li>sparc: 3655
<li>vax: 1959
</ul>
<p>Some highlights:
<ul style="column-count: 2">
<li>Chromium 44.0.2403.125
<li>Emacs 21.4 and 24.5
<li>GCC 4.8.4 and 4.9.3
<li>GHC 7.8.4
<li>GNOME 3.16.2
<li>Go 1.4.2
<li>Groff 1.22.3
<li>JDK 1.7.0.80 and 1.8.0.45
<li>KDE 3.5.10 and 4.14.3 (plus KDE4 core updates)
<li>LLVM/Clang 3.5 (20140228)
<li>LibreOffice 4.4.4.3
<li>MariaDB 10.0.20
<li>Mono 3.12.1
<li>Mozilla Firefox 38.1.1esr and 39.0.3
<li>Mozilla Thunderbird 38.1.0
<li>Node.js 0.10.35
<li>OpenLDAP 2.3.43 and 2.4.41
<li>PHP 5.4.43, 5.5.27 and 5.6.11
<li>Postfix 3.0.2
<li>PostgreSQL 9.4.4
<li>Python 2.7.10 and 3.4.3
<li>R 3.2.1
<li>Ruby 1.8.7.374, 1.9.3.551, 2.0.0.645, 2.1.6, and 2.2.2
<li>Sendmail 8.15.2
<li>Sudo 1.8.14.3
<li>Tcl/Tk 8.5.18 and 8.6.4
<li>TeX Live 2014
<li>Vim 7.4.769
<li>Xfce 4.12
</ul>
<li>As usual, steady improvements in manual pages and other documentation.
<li>The system includes the following major components from outside suppliers:
<ul>
<li>Xenocara (based on X.Org 7.7 with xserver 1.16.4 + patches,
freetype 2.6, fontconfig 2.11.1, Mesa 10.2.9, xterm 314,
xkeyboard-config 2.14 and more)
<li>Gcc 4.2.1 (+ patches) and 3.3.6 (+ patches)
<li>Perl 5.20.2 (+ patches)
<li>SQLite 3.8.9 (+ patches)
<li>NSD 4.1.3
<li>Unbound 1.5.4
<li>Ncurses 5.7
<li>Binutils 2.17 (+ patches)
<li>Gdb 6.3 (+ patches)
<li>Less 458 (+ patches)
<li>Awk Aug 10, 2011 version
</ul>
</ul>
</section>
<hr>
<section id=install>
<h3>How to install</h3>
<p>
Following this are the instructions which you would have on a piece of
paper if you had purchased a CDROM set instead of doing an alternate
form of install. The instructions for doing an HTTP (or other style
of) install are very similar; the CDROM instructions are left intact
so that you can see how much easier it would have been if you had
purchased a CDROM instead.
<p>
<hr>
Please refer to the following files on the three CDROMs or mirror site for
extensive details on how to install OpenBSD 5.8 on your machine:
<p>
<ul>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.8/alpha/INSTALL.alpha">
.../OpenBSD/5.8/alpha/INSTALL.alpha (on CD1)</a>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.8/i386/INSTALL.i386">
.../OpenBSD/5.8/i386/INSTALL.i386 (on CD1)</a>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.8/hppa/INSTALL.hppa">
.../OpenBSD/5.8/hppa/INSTALL.hppa (on CD1)</a>
<p>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.8/amd64/INSTALL.amd64">
.../OpenBSD/5.8/amd64/INSTALL.amd64 (on CD2)</a>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.8/macppc/INSTALL.macppc">
.../OpenBSD/5.8/macppc/INSTALL.macppc (on CD2)</a>
<p>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.8/sparc64/INSTALL.sparc64">
.../OpenBSD/5.8/sparc64/INSTALL.sparc64 (on CD3)</a>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.8/sparc/INSTALL.sparc">
.../OpenBSD/5.8/sparc/INSTALL.sparc (on CD3)</a>
<p>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.8/alpha/INSTALL.alpha">
.../OpenBSD/5.8/alpha/INSTALL.alpha</a>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.8/armish/INSTALL.armish">
.../OpenBSD/5.8/armish/INSTALL.armish</a>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.8/hppa/INSTALL.hppa">
.../OpenBSD/5.8/hppa/INSTALL.hppa</a>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.8/landisk/INSTALL.landisk">
.../OpenBSD/5.8/landisk/INSTALL.landisk</a>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.8/loongson/INSTALL.loongson">
.../OpenBSD/5.8/loongson/INSTALL.loongson</a>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.8/luna88k/INSTALL.luna88k">
.../OpenBSD/5.8/luna88k/INSTALL.luna88k</a>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.8/macppc/INSTALL.macppc">
.../OpenBSD/5.8/macppc/INSTALL.macppc</a>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.8/octeon/INSTALL.octeon">
.../OpenBSD/5.8/octeon/INSTALL.octeon</a>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.8/sgi/INSTALL.sgi">
.../OpenBSD/5.8/sgi/INSTALL.sgi</a>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.8/socppc/INSTALL.socppc">
.../OpenBSD/5.8/socppc/INSTALL.socppc</a>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.8/sparc/INSTALL.sparc">
.../OpenBSD/5.8/sparc/INSTALL.sparc</a>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.8/vax/INSTALL.vax">
.../OpenBSD/5.8/vax/INSTALL.vax</a>
<li><a href="https://ftp.openbsd.org/pub/OpenBSD/5.8/zaurus/INSTALL.zaurus">
.../OpenBSD/5.8/zaurus/INSTALL.zaurus</a>
</ul>
</section>
<hr>
<section id=quickinstall>
<p>
Quick installer information for people familiar with OpenBSD, and the
use of the "disklabel -E" command. If you are at all confused when
installing OpenBSD, read the relevant INSTALL.* file as listed above!
<h3>OpenBSD/i386:</h3>
<p>
The OpenBSD/i386 release is on CD1.
Boot from the CD to begin the install - you may need to adjust
your BIOS options first.
<p>
If your machine can boot from USB, you can write <i>install58.fs</i> or
<i>miniroot58.fs</i> to a USB stick and boot from it.
<p>
If you can't boot from a CD, floppy disk, or USB,
you can install across the network using PXE as described in
the included INSTALL.i386 document.
<p>
If you are planning on dual booting OpenBSD with another OS, you will need to
read INSTALL.i386.
<h3>OpenBSD/amd64:</h3>
<p>
The OpenBSD/amd64 release is on CD2.
Boot from the CD to begin the install - you may need to adjust
your BIOS options first.
<p>
If your machine can boot from USB, you can write <i>install58.fs</i> or
<i>miniroot58.fs</i> to a USB stick and boot from it.
<p>
If you can't boot from a CD, floppy disk, or USB,
you can install across the network using PXE as described in the included
INSTALL.amd64 document.
<p>
If you are planning to dual boot OpenBSD with another OS, you will need to
read INSTALL.amd64.
<h3>OpenBSD/macppc:</h3>
<p>
Burn the image from a mirror site to a CDROM, and power on your machine
while holding down the <i>C</i> key until the display turns on and
shows <i>OpenBSD/macppc boot</i>.
<p>
Alternatively, at the Open Firmware prompt, enter <i>boot cd:,ofwboot
/5.8/macppc/bsd.rd</i>
<h3>OpenBSD/sparc64:</h3>
<p>
Put CD3 in your CDROM drive and type <i>boot cdrom</i>.
<p>
If this doesn't work, or if you don't have a CDROM drive, you can write
<i>CD3:5.8/sparc64/floppy58.fs</i> or <i>CD3:5.8/sparc64/floppyB58.fs</i>
(depending on your machine) to a floppy and boot it with <i>boot
floppy</i>. Refer to INSTALL.sparc64 for details.
<p>
Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
will most likely fail.
<p>
You can also write <i>CD3:5.8/sparc64/miniroot58.fs</i> to the swap partition on
the disk and boot with <i>boot disk:b</i>.
<p>
If nothing works, you can boot over the network as described in INSTALL.sparc64.
<h3>OpenBSD/alpha:</h3>
<p>
Write <i>5.8/alpha/floppy58.fs</i> or
<i>5.8/alpha/floppyB58.fs</i> (depending on your machine) to a diskette and
enter <i>boot dva0</i>. Refer to INSTALL.alpha for more details.
<p>
Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
will most likely fail.
<h3>OpenBSD/armish:</h3>
<p>
After connecting a serial port, Thecus can boot directly from the network
either tftp or http. Configure the network using fconfig, reset,
then load bsd.rd, see INSTALL.armish for specific details.
IOData HDL-G can only boot from an EXT-2 partition. Boot into linux
and copy 'boot' and bsd.rd into the first partition on wd0 (hda1)
then load and run bsd.rd, preserving the wd0i (hda1) ext2fs partition.
More details are available in INSTALL.armish.
<h3>OpenBSD/hppa:</h3>
<p>
Boot over the network by following the instructions in INSTALL.hppa or the
<a href="hppa.html#install">hppa platform page</a>.
<h3>OpenBSD/landisk:</h3>
<p>
Write <i>miniroot58.fs</i> to the start of the CF
or disk, and boot normally.
<h3>OpenBSD/loongson:</h3>
<p>
Write <i>miniroot58.fs</i> to a USB stick and boot bsd.rd from it
or boot bsd.rd via tftp.
Refer to the instructions in INSTALL.loongson for more details.
<h3>OpenBSD/luna88k:</h3>
<p>
Copy 'boot' and 'bsd.rd' to a Mach or UniOS partition, and boot the bootloader
from the PROM, and then bsd.rd from the bootloader.
Refer to the instructions in INSTALL.luna88k for more details.
<h3>OpenBSD/octeon:</h3>
<p>
After connecting a serial port, boot bsd.rd over the network via DHCP/tftp.
Refer to the instructions in INSTALL.octeon for more details.
<h3>OpenBSD/sgi:</h3>
<p>
To install, burn cd58.iso on a CD-R, put it in the CD drive of your
machine and select <i>Install System Software</i> from the System Maintenance
menu. Indigo/Indy/Indigo2 (R4000) systems will not boot automatically from
CD-ROM, and need a proper invocation from the PROM prompt.
Refer to the instructions in INSTALL.sgi for more details.
<p>
If your machine doesn't have a CD drive, you can setup a DHCP/tftp network
server, and boot using "bootp()/bsd.rd.IP##" using the kernel matching your
system type. Refer to the instructions in INSTALL.sgi for more details.
<h3>OpenBSD/socppc:</h3>
<p>
After connecting a serial port, boot over the network via DHCP/tftp.
Refer to the instructions in INSTALL.socppc for more details.
<h3>OpenBSD/sparc:</h3>
<p>
Boot from one of the provided install ISO images, using one of the two
commands listed below, depending on the version of your ROM.
<blockquote><pre>
ok <kbd>boot cdrom 5.8/sparc/bsd.rd</kbd>
or
> <kbd>b sd(0,6,0)5.8/sparc/bsd.rd</kbd>
</pre></blockquote>
<p>
If your SPARC system does not have a CD drive, you can alternatively boot from floppy.
To do so you need to write <i>floppy58.fs</i> to a floppy.
For more information see <a href="faq/faq4.html#MkFlop">this page</a>.
To boot from the floppy use one of the two commands listed below,
depending on the version of your ROM.
<blockquote><pre>
ok <kbd>boot floppy</kbd>
or
> <kbd>b fd()</kbd>
</pre></blockquote>
<p>
Make sure you use a properly formatted floppy with NO BAD BLOCKS or your install
will most likely fail.
<p>
If your SPARC system doesn't have a floppy drive nor a CD drive, you can either
setup a bootable tape, or install via network, as told in the
INSTALL.sparc file.
<h3>OpenBSD/vax:</h3>
<p>
Boot over the network via mopbooting as described in INSTALL.vax.
<h3>OpenBSD/zaurus:</h3>
<p>
Using the Linux built-in graphical ipkg installer, install the
openbsd58_arm.ipk package. Reboot, then run it. Read INSTALL.zaurus
for a few important details.
</section>
<hr>
<section id=upgrade>
<h3>How to upgrade</h3>
<p>
If you already have an OpenBSD 5.7 system, and do not want to reinstall,
upgrade instructions and advice can be found in the
<a href="faq/upgrade58.html">Upgrade Guide</a>.
</section>
<hr>
<section id=sourcecode>
<h3>Notes about the source code</h3>
<p>
<code>src.tar.gz</code> contains a source archive starting at <code>/usr/src</code>.
This file contains everything you need except for the kernel sources, which are
in a separate archive. To extract:
<blockquote><pre>
# <kbd>mkdir -p /usr/src</kbd>
# <kbd>cd /usr/src</kbd>
# <kbd>tar xvfz /tmp/src.tar.gz</kbd>
</pre></blockquote>
<p>
<code>sys.tar.gz</code> contains a source archive starting at <code>/usr/src/sys</code>.
This file contains all the kernel sources you need to rebuild kernels.
To extract:
<blockquote><pre>
# <kbd>mkdir -p /usr/src/sys</kbd>
# <kbd>cd /usr/src</kbd>
# <kbd>tar xvfz /tmp/sys.tar.gz</kbd>
</pre></blockquote>
<p>
Both of these trees are a regular CVS checkout. Using these trees it
is possible to get a head-start on using the anoncvs servers as
described <a href="anoncvs.html">here</a>.
Using these files
results in a much faster initial CVS update than you could expect from
a fresh checkout of the full OpenBSD source tree.
</section>
<hr>
<section id=ports>
<h3>Ports Tree</h3>
<p>
A ports tree archive is also provided. To extract:
<blockquote><pre>
# <kbd>cd /usr</kbd>
# <kbd>tar xvfz /tmp/ports.tar.gz</kbd>
</pre></blockquote>
<p>
Go read the <a href="faq/ports/index.html">ports</a> page
if you know nothing about ports
at this point. This text is not a manual of how to use ports.
Rather, it is a set of notes meant to kickstart the user on the
OpenBSD ports system.
<p>
The <i>ports/</i> directory represents a CVS (see the manpage for
<a href="https://man.openbsd.org/cvs.1">cvs(1)</a> if
you aren't familiar with CVS) checkout of our ports. As with our complete
source tree, our ports tree is available via
<a href="anoncvs.html">AnonCVS</a>.
So, in order to keep up to date with the -stable branch, you must make
the <i>ports/</i> tree available on a read-write medium and update the tree
with a command like:
<blockquote><pre>
# <kbd>cd /usr/ports</kbd>
# <kbd>cvs -d anoncvs@server.openbsd.org:/cvs update -Pd -rOPENBSD_5_8</kbd>
</pre></blockquote>
<p>
[Of course, you must replace the server name here with a nearby anoncvs
server.]
<p>
Note that most ports are available as packages on our mirrors. Updated
ports for the 5.8 release will be made available if problems arise.
<p>
If you're interested in seeing a port added, would like to help out, or just
would like to know more, the mailing list
<a href="mail.html">ports@openbsd.org</a> is a good place to know.
</section>