UPDATING

   1 Updating Information for FreeBSD current users
   2
   3 This file is maintained by imp@village.org.  Please send new entries
   4 directly to him.  See end of file for further details.  For commonly
   5 done items, please see the end of the file.  Search for 'COMMON
   6 ITEMS:'
   7
   8 20000711:
   9         If you use CVSUP or CTM to get CVS trees, AND you used to get
  10         the old crypto files from internat.freebsd.org AND you check
  11         out files from the CVS tree with the cvs command, please read
  12                 http://people.freebsd.org/~imp/internat.txt
  13         for details on potential problems that you might have and how
  14         to get around them.
  15
  16         If you are merely a mirror, or don't answer yes to each of the
  17         clauses above, you needn't worry.
  18
  19 20000711:
  20         /etc/security has been updated to print the inode number of
  21         setuid programs that have changed.  You will see a large spike
  22         in the number of changed programs the first time when you run
  23         mergemaster to get a new /etc/security.
  24
  25 20000710:
  26         /dev/random now has good entropy collection (from the keyboard
  27         and sysmouse drivers). Please ensure that either `options
  28         RANDOMDEV' is present in your kernel config file or that
  29         `randomdev_load="YES"' is in your /boot/loader.conf. If you do
  30         not have the /dev/random driver, OpenSSL (and consequently
  31         lots of crypto tools (like SSH)) will fail with strange
  32         errors. (see below, 20000624).
  33
  34 20000709:
  35         phk made the default options AJ.  This may slow things down
  36         and uncover other latent bugs in the code.  If you need to run
  37         at full speed, you can disable this by doing the following:
  38                 ln -s aj /etc/malloc.conf
  39
  40 20000706:
  41         libftpio's version was accidentally bumped a few days ago.  This
  42         has been corrected.  You may need to remove /usr/lib/libftpio.so.6
  43         before doing your next buildworld/installworld pair.  It certainly
  44         won't hurt to remove it before the update proceedure.  It will
  45         break fetch until a new one is built, but ftp can be used in the
  46         interrum if needed.
  47
  48 20000705:
  49         The crypto packages have changed for the cvsup.  This has been done
  50         in a backward compatible way, but the old packages will go away at
  51         some point in the future.  Look at /usr/share/examples/cvsup for
  52         details.
  53
  54 20000704:
  55         With the new sys/modules/sound/drivers/*, you will need to
  56         set SYSDIR until you do an installworld after July 7th.
  57
  58 20000704:
  59         rc.shutdown and rc will now call the rc.d scripts with start
  60         or stop.  This may cause some harmless warnings from older
  61         rc.d scripts that haven't been updated.
  62
  63 20000630:
  64         The libfetch based version of fetch has gone into the tree.
  65         Minor problems may result on some of the less popular sites,
  66         which should be reported to des@freebsd.org.
  67
  68 20000625:
  69         From approximately this date forward, one must have the crypto
  70         system installed in order to build the system and kernel.
  71         While not technically strictly true, one should treat it as
  72         required and grab the crypto bits.  If you are grabbing CVS
  73         trees, src-all and cvs-crypto should be treated as if they
  74         were required.  You should check with the latest collections
  75         to make sure that these haven't changed.
  76
  77 20000624:
  78         Mark Murray just committed the first parts of a cleanup of
  79         /dev/zero, et al.  This is also cleaning up /dev/random.
  80         The entropy is disconnected, so DO NOT USE VERSIONS OF FREEBSD
  81         -CURRENT FROM THIS POINT FORWARD for cryptographic services
  82         until Mark can merge in the fixes to this work in progress.
  83         openssh and openssl should not be used to generate keys from this
  84         date to the completion of the work.
  85
  86         If you must operate at this reduced level of security, add '
  87         options RANDOMDEV' to your kernel or modload the randomdev
  88         module.  You may also need to copy a new MAKEDEV to /dev and
  89         recreate the random and urandom devices.
  90
  91 20000622:
  92         The license on the softupdates is now a standard 2 clause
  93         BSD license.  You may need to remove your symbolic links
  94         that used to be required when updating.
  95
  96 20000621:
  97         Scott Flatman <sf@aracnet.com> sent in a decent writeup on
  98         the config file update procedure.
  99                 http://people.freebsd.org/~imp/config-upd.html
 100         NOTE: LINT is gone.  It has been replaced with NOTES.  NOTES
 101         isn't buildable.
 102
 103 20000620:
 104         Binutils 2.10 have hit the tree, or will shortly.  As soon
 105         as they do, the problem noted in 20000522 will be resolved and
 106         that workaround will no longer be required.
 107
 108 20000615:
 109         phk removed the compatibility creation of wd devices in the
 110         ad driver.  If you haven't done so already, you must update
 111         your fstab, etc to use the ad devices instead of the wd
 112         devices.
 113
 114         In addition, you'll need to update your boot blocks to a
 115         more modern version, if you haven't already done so.  Modern
 116         here means 4.0 release or newer (although older releases
 117         may work).
 118
 119 20000612:
 120         Peter took an axe to config(8).  Besure that you read his mail
 121         on the topic before even thinking about updating.  You will
 122         need to create a /boot/devices.hints or add a hints directive
 123         to your config file to compile them in statically.  The format
 124         of the config file has changed as well.  Please see LINT,
 125         GENERIC or NEWCARD for examples of the new format.
 126
 127 20000522:
 128         A new set of binutils went into the tree today.  Anybody
 129         building a kernel after this point is advised that they need
 130         to rebuild their binutils (or better yet do a
 131         buildworld/installworld) before building a new kernel.
 132
 133         Due to bugs in binutils, using malloc options (eg /etc/malloc.conf
 134         or MALLOC_OPTIONS env var) J will cause ld to dump core.  It
 135         is recommended that you don't set this option until the problem
 136         is resolved.
 137
 138 20000513:
 139         The ethernet drivers were all updated to clean up the BPF handling.
 140
 141 20000510:
 142         The problems with boot blocks on the alphas have been corrected.
 143         This will require some care in updating alphas.  A new libstand
 144         is requires for the boot blocks to build properly.
 145
 146 20000503:
 147         Recompile all kld modules.  Proper version dependency info
 148         is now available.
 149
 150 20000502:
 151         Modules have been disconnected from the buildworld tree and
 152         connected to the kernel building instead.
 153
 154 2000427:
 155         You may need to build gperf
 156                 cd /usr/src/gnu/usr.bin/gperf && make depend all install
 157         when upgrading from 4.0 -> current.  The build system now uses
 158         an option only in -current.
 159
 160 20000417:
 161         The method that we brand ELF binaries has changed to be more
 162         acceptible to the binutils maintainers.  You will need to
 163         rebrand your ELF binaries that aren't native.  One problem
 164         binary is the Linux ldconfig.  After your make world, but
 165         before you reboot, you'll neeed to issue:
 166                 brandelf -t Linux /compat/linux/sbin/ldconfig
 167         if you have Linux compatibility enabled on your machine.
 168
 169 20000320:
 170         If you have really bad/marginal IDE drives, you may find they
 171         don't work well.  Use pio mode instead.  The easiest way to
 172         cope if you have a problem combination is to add:
 173                 /sbin/sysctl -w hw.atamodes=pio,pio,pio,pio
 174         to the start of /etc/rc.conf.
 175
 176 20000319:
 177         The ISA and PCI compatability shims have been connected to the
 178         options COMPAT_OLDISA and COMPAT_OLDPCI.  If you are using old
 179         style PCI or ISA drivers (i.e. tx, voxware, etc.) you must
 180         include the appropriate option in your kernel config.  Drivers
 181         using the shims should be updated or they won't ship with
 182         5.0-RELEASE, targeted for 2001.
 183
 184 20000318:
 185         We've entered the tradtional post release dumping party.
 186         Large kernel changes are being committed and are in the
 187         works.  It is important to keep the systems' klds and kernel
 188         in sync as kernel interfaces and structures are changing.
 189         Before reporting kernel panics, make sure that all modules
 190         that you are loading are up to date.
 191
 192 20000315:
 193         If you are upgrading from an older version of FreeBSD, you
 194         need to update your boot blocks as well.  'disklabel -B ad0'
 195         will do the trick.  This isn't critical until you remove your
 196         wd device entries in /dev, at which point your system will not
 197         boot.
 198
 199 20000315:
 200         4.0 RELEASE shipped.  Please see the 4.0 UPDATING file for how
 201         to upgrade to 4.0 from 3.x.
 202
 203 COMMON ITEMS:
 204
 205         To build a kernel
 206         -----------------
 207         Update config, genassym and go:
 208                 config YOUR_KERNEL_HERE                 [1]
 209                 cd ../../compile/YOUR_KERNEL_HERE
 210                 make depend && make
 211                 make install
 212         [1] If upgrading, add -r won't hurt and sometimes helps.
 213
 214         To rebuild everything
 215         ---------------------
 216         make world
 217
 218         To upgrade from 4.0-stable to current
 219         -------------------------------------
 220         make buildworld
 221         make buildkernel KERNEL=YOUR_KERNEL_HERE
 222         make installkernel KERNEL=YOUR_KERNEL_HERE
 223         make installworld
 224         <reboot>
 225
 226         Make sure that you've read the UPDATING file to understand
 227         the tweaks to various things you need.  At this point in the
 228         life cycloe of current, things change often and you are on
 229         your own to cope.
 230
 231 FORMAT:
 232
 233 This file contains a list, in reverse chronologocal order, of major
 234 breakages in tracking -current.  Not all things will be listed here,
 235 and it only starts on March 15, 2000.  Updating files can found in
 236 previous releases if your system is older than this.
 237
 238 Please filter your entries through Warner Losh (imp@village.org) so
 239 that the style, formatting, etc of this file can be maintained.
 240
 241 $FreeBSD$