summaryrefslogtreecommitdiff
path: root/distrib/notes/i386/upgrade
diff options
context:
space:
mode:
authorKenneth R Westerback <krw@cvs.openbsd.org>2003-09-07 12:01:57 +0000
committerKenneth R Westerback <krw@cvs.openbsd.org>2003-09-07 12:01:57 +0000
commit2f5f8cba460804d959b5542f9cd555577b9ba5a4 (patch)
treee8073a74441421a688f9c7b3b0dd44298a5149d9 /distrib/notes/i386/upgrade
parent5215469caf7cf816ef552a677fc89fa6f3be5806 (diff)
i386: Some more verbiage around i386 a.out -> ELF upgrades.
Sparc64: Mention Blade 100 problems with upgrading over the network vs non-serial console. ok miod@.
Diffstat (limited to 'distrib/notes/i386/upgrade')
-rw-r--r--distrib/notes/i386/upgrade25
1 files changed, 20 insertions, 5 deletions
diff --git a/distrib/notes/i386/upgrade b/distrib/notes/i386/upgrade
index 47544532f9b..15245b370f2 100644
--- a/distrib/notes/i386/upgrade
+++ b/distrib/notes/i386/upgrade
@@ -1,12 +1,27 @@
-dnl $OpenBSD: upgrade,v 1.18 2003/09/07 00:21:47 miod Exp $
+dnl $OpenBSD: upgrade,v 1.19 2003/09/07 12:01:56 krw Exp $
dnl OpenBSDUpgrade({:-the CD-ROM or an installation floppy as you would do for
dnl a new installation-:})
-Due to the change in binary format from a.out to ELF in OpenBSD OSREV,
-upgrades, albeit possible, are very tricky. The best solution, whenever
+Due to the change from a.out to ELF binary format in OpenBSD OSREV,
+upgrades can be a complex, delicate process. The best solution, whenever
possible, is to backup your data and reinstall from scratch.
-The two main hurdles in the upgrade from an a.out system to an ELF OpenBSD
-OSREV system are:
+The second best solution is to remove all ports, third party programs and
+libraries installed on your system; upgrade; and then add ELF versions of
+the removed files.
+
+In all cases, once you start the upgrade you MUST complete it. If the
+upgrade process fails or is abandoned before it completes you will almost
+certainly be left with a non-functional system.
+
+Finally, you cannot use the bsd.rd kernel to upgrade the system. The
+existing bootblocks on your system cannot boot the OSREV bsd.rd.
+
+If you must do an upgrade while preserving the functionality of any
+existing a.out binary files, then the rest of this section will guide you
+through that process.
+
+The two main hurdles in upgrading from an a.out system to an ELF OpenBSD
+OSREV system while preserving the functioning of a.out binaryies are:
- the a.out binary emulation, required for compatibility with a.out
binaries using shared libraries, is not enabled by default, and requires
an explicit configuration change.