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.
   5
   6 19991205:
   7         Block devices are going away.  You will need to update your /dev
   8         tree with a fresh copy of MAKEDEV for things to always work in
   9         the future.  fsck is unable to cope with dirty file systems
  10         after this change, so it may work for you or it may not.
  11
  12         MAKEDEV should be copied from src/etc/MAKEDEV to /dev before
  13         starting the following:
  14
  15                 For N in the list of disks
  16                         MAKEDEV N                       # eg wd0
  17                         for M in the list of slices
  18                                 MAKEDEV NsMa            # eg wd0s1a
  19
  20         *** All uses of block devices must be converted to char devices.
  21         *** Likely the only thing impacted is dumpdev in /etc/rc.conf
  22
  23 19991204:
  24         Support for the old 'sd' device names has been removed in
  25         favor of 'da'.  Please update your /etc/fstab, /etc/rc.conf
  26         and any other places you might have sd names cached.
  27         Generally these changes are as simple as s=/dev/sd=/dev/da=g,
  28         but be careful to make sure that things are really that
  29         simple.  You may also need to create /dev entries for the da
  30         devices as well.
  31
  32         MAKEDEV should be copied from src/etc/MAKEDEV to /dev before
  33         starting the following:
  34
  35                 For N in the list of da disks on your system
  36                         MAKEDEV daN
  37                         for M in the list of slices
  38                                 MAKEDEV daNsMa
  39 19991203:
  40         BAD144 support has been removed.  Cope or replace the hardware.
  41
  42 19991126:
  43         MFS_ROOT and MFS_ROOT_SIZE are gone, replaced by MD_ROOT and
  44         MD_ROOT_SIZE options in the md driver.  md driver now deals with
  45         the hacks.  You should add md driver to kerneles that have
  46         MFS_ROOT, et al.  See GENERIC or LINT for details.
  47
  48 19991125:
  49         The ep changed a while ago and can no longer be used with hard
  50         wired addresses in the config file.
  51
  52 19991113:
  53         Gcc 2.95.2 is now the default compiler.
  54
  55 19991015:
  56         PCCARD has been updated to attach pcic to the isa bus.  Therefore
  57         you will need to modify kernel config files that have pcic/card
  58         in them as follows:
  59                 controller      pcic0   at isa?
  60                 controller      pcic1   at isa?
  61                 controller      card0
  62
  63 19990929:
  64         The sigset_t datatype has been changed from an integral type
  65         to a compound type and can hold 128 signals. Syscalls directly
  66         or indirectly using the new sigset_t have been added as to
  67         maintain compatibility with existing binaries. A new kernel must
  68         be made and installed and booted with before a make world can
  69         be done.
  70
  71 19990919:
  72         New jail syscall format requires recompilation of jail(8) with
  73         fresh headers installed (or a make world will do it for you).
  74
  75 19990914:
  76         Matt Dillon checked in many vm related things and sent a heads up
  77         to -current urging caution and to report vm problems to him.
  78         As of the 19th, no killer problems have been reported, but you
  79         have been warned.
  80
  81 19990908:
  82         The new miibus has been added to the system.  If you are using
  83         the dm, rl, sf, sis, ste, tl, wb or xl drivers, you need to
  84         add "controller miibus0" to your config file.
  85
  86 19990905:
  87         /var/cron/log has been moved to /var/log/cron to get all the
  88         log files in one place.
  89
  90 19990831:
  91         tn3270 has been removed from the base system and added as a port.
  92
  93 19990830:
  94         User-visible TCP timers are now expressed in units of 1ms, instead
  95         of 500ms, so if you've customized any timer values under
  96         ``net.inet.tcp'', multiply them by 500 to preserve TCP's behavior.
  97
  98 19990828:
  99         RCS Id tags changed to FreeBSD.  This will cause huge cvsup
 100         updates.
 101
 102 19990821:
 103         On 28-May-1999 libreadline was upgraded from readline-2.2 to
 104         readline-4.0.  At that time the shared library major version
 105         number was bumped from "3" to "4".  It has been deemed that
 106         the interface change between readline-2.2 and readline-4.0 was
 107         not sufficient to warrant the version number bump.
 108
 109         Thus I have reverted it back to "3".  You will need to perform
 110         the below immediately before your next ``make world'':
 111             cd /usr/lib
 112             ls -l libreadline.so.4
 113                 (if you have /usr/lib/libreadline.so.4)
 114             mv libreadline.so.4 libreadline.so.3
 115             rm -f libreadline.so
 116             ln -s libreadline.so.3 libreadline.so
 117
 118 19990801:
 119         Changes to the pccardd kernel interface require that you recompile
 120         pccardd for new kernel.
 121
 122 19980725:
 123         The ipfw interface to the kernel has changed.  You will need to
 124         recompile ipfw programs for the new kernel.
 125
 126 19990715:
 127         The bpfilter device has been renamed to bpf.  You will need to
 128         change your config files in order to enable this in newer kernels.
 129
 130 19990704:
 131         src/contrib/sys/softupdates is moving to
 132         src/sys/contrib/softupdates.  Update your symbolic links/etc.
 133
 134 19990702:
 135         Major changes have been made to vinum and its interface.  See
 136         the man page (vinum(8)) for details.  Look at the concat,
 137         mirror and stripe commands, as well as the SIMPLIFIED
 138         CONFIGURATION section.
 139
 140 19990628:
 141         Newsyslog.conf has had a minor, but potentially dangerous,
 142         change to its username/group syntax.  The old syntax was
 143         user.group, while the new syntax is user:group.
 144
 145 19990627:
 146         Inetd wrapping default has changed.  Please see the updated
 147         man page for details.
 148
 149 19990623:
 150         Compaq Smart Raid driver committed as ida.
 151
 152 19990622:
 153         The second phase of syscons cleanup has happened.  Some
 154         functionality has been made optional.  For details, see
 155         http://www.freebsd.org/~yokota/sc_update-June.txt
 156         Everyone will need to re-config(8) their kernels, but old
 157         binaries will work with the new kernel.
 158
 159 19990620:
 160         IPFW uid/gid-based filtering support has been committed. This
 161         breaks binary compatibility with previous copies of
 162         ipfw(8). Any utilities using the ioctl()s of ipfw (especially
 163         ipfw(8)) need to be recompiled with the newest headers
 164         installed.
 165
 166 19990618:
 167         Inetd now wraps all stream-based services, including internals.
 168         Syslog "severity" options are honoured. Installed syslog.conf
 169         and hosts.allow should be checked.
 170
 171 19990509:
 172         Most of the problems with newbus have been corrected, but
 173         it is still current and evolving.
 174
 175         libcam's ABI has changed.  You must recompile the world and
 176         any ports that use it.
 177
 178 19990427:
 179         Massive changes to SMP went into the tree that should speed
 180         things up.  However, if you experience problems with SMP
 181         machines, you can back off to the PRE_SMP_VMSHARE tag in the
 182         CVS repository (or run an MP kernel).
 183
 184 19990420:
 185         Pccardd and the pccard bus in general seem to be broken or
 186         most people.  Soren has patches to make it better for some,
 187         but not all people.  Work is underway to make it better for
 188         all people.
 189
 190 19990416:
 191         new bus changes integrated into -current.  Many problems were
 192         initially reported, but most have been fixed.  You'll need a
 193         new config and to tweak your kernel config file the way that
 194         GENERIC was tweaked.  Keep a copy of your old kernel when
 195         upgrading in case your new kernel doesn't work (and report the
 196         breakage to current@freebsd.org).
 197
 198         As of 19990421 the remaining problems/quirks are
 199
 200         o sio no longer supports pnp nor pccard.  This will be corrected,
 201           but the new pccard code needs to be completed.
 202         o Some of the sound drivers broke for some people.  It seems
 203           inconsistant as to who/what/when/where things broke.
 204         o Duplicate device entries in your config do not work.  Previously
 205           they were silently ignored.  psm0 seems to be the most common
 206           duplicate choice, although some reports have come in from people
 207           that wired their scsi disk entries.
 208         o You must move the keyboard and mouse attachments from the
 209           isa bus to the atkbdc bus.  See GENERIC for details.
 210         o Machines with multiple host-pci bridges (Intel 450NX) will not
 211           probe the second pci bus.
 212         o Some probe ordering may have changed, so device naming may change
 213           with the new kernel.  If you have multiple devices, please double
 214           check to make sure they didn't move.  This is especially true
 215           for cards on different buses.
 216         o The bus attachment for vga0 is always isa0 and never pci0 when
 217           it is in fact a pci card.  It is safe to ignore this.
 218         o The format of the boot messages has changed (and is not
 219           guaranteed to be constant for a while) so you may see this
 220           in some shell scripts that diff dmesg from day to day as well
 221           as scripts that parse dmesg output.
 222
 223 19990414:
 224         cc -aout sometimes has problems compiling with -g, remove -g
 225         from those compilation units affected until this is corrected.
 226
 227         cc -aout has problems with producing some threaded libraries,
 228         so make world -DWANT_AOUT is not functional at this time.
 229
 230         Since make world for a.out isn't functional, you cannot do
 231         make aout-to-elf from a pre-egcs a.out system.  To work around
 232         this problem, make aout-to-elf using 3.1-stable first (or a
 233         pre egcs -current) and then a simple make world will take you
 234         the rest of the way with a -current source base.
 235
 236 19990413:
 237         Make -j works again for make world.  As always, use it with
 238         care, and be sure to try a make world w/o -j before reporting
 239         problems (that is, know if the problem exists w/o -j before
 240         reporting the problem with -j).
 241
 242 19990413:
 243         Note cc -aout, which had been broken since the conversion to
 244         egcs, now supposedly works.  If you have rebuilt things like
 245         XFree86 a.out libraries, you should rebuild them again or
 246         progams that use them, including netscape, will fail to work.
 247
 248 19990409:
 249         NOTE: New c++ compiler cannot be used with c++ binaries from
 250         the old compiler and vice versa.
 251
 252 19990408:
 253         In recent days egcs has been imported into the tree.  A number
 254         of problems have been discussed in -current.  Here is a highlight
 255         of a few of the more common ones.  With the exception of make
 256         -j n, they have been claimed to have been fixed.
 257
 258         c++ is broken after make world: This is correct.  Because we
 259         changed compilers two make worlds are necessary to get C++
 260         working again.  The code generated by the old compiler and new
 261         compiler are not compatible, so things wind up being
 262         undefined.
 263
 264         cpp is broken in make world:  There was a window where cpp
 265         would be built incorrectly.  The fix for this is
 266                 cd src/gnu/usr.bin/cc
 267                 make clean
 268                 make all
 269                 make install
 270         and this should correct your problems.  See the -current
 271         archives for a version of this that does moer cleaning.
 272
 273         Make -j n doesn't work.  Work contiunes to make this work,
 274         I've seen no reports of success as of April 7th.
 275
 276 19990329:
 277         Previously, one would define "NOAOUT" to keep from building
 278         the legacy a.out bits.  Now one would define "WANT_AOUT" to
 279         build them.
 280
 281 19990316:
 282         The name of the old wd.c and atapi.c based CDROM driver has
 283         been changed back to wcd. So update your config file to use
 284         "device wcd" instead of "device acd".
 285
 286 19990314:
 287         For those of you using the VN device as a loadable module,
 288         please be aware that the new VN device has been committed to
 289         -4.x and cannot yet be used as a loadable module.  This will
 290         be fixed in the future.
 291
 292 19990309:
 293         New loader.rc mechanism.  Please see src/sys/boot/README for
 294         details.
 295
 296 19990225:
 297         struct proc size changed.  Recompile kernel and the
 298         usual suspects.  Make world if in doubt.
 299
 300 19990214:
 301         The nlpt driver has changed names back to be the lpt driver.
 302         See ppbus(4) or http://www.freebsd.org/~nsouch/ppbus.html
 303         for proper configuration details.
 304
 305 19990210:
 306         The 'lpt' driver is now obsolete.  Replace it with the 'nlpt'
 307         driver and 'ppbus' controller combination.
 308
 309 19990209:
 310         New devstat API requires recompilation of libdevstat, systat,
 311         iostat, vmstat and rpc.rstatd.  A new kernel is also required.
 312         make world + building a kernel should do all of this.  Any
 313         ports that use devstat need to be recompiled as well.
 314
 315 19990125:
 316         Linux threads options has gone away (they are now standard in
 317         the FreeBSD kernel).  A recompile of all libkvm using programs
 318         is in order (or better yet a make world).
 319
 320 19990122:
 321         On or about this date there was a small window when the boot
 322         blocks had some minor problems which seemed to force one to
 323         edit /etc/fstab.  This has been corrected, if you are seeing this
 324         problem, please rebuild and reinstall your boot blocks.
 325
 326 19990121:
 327         Vinum has changed.  The "vinum read" command has changed.  For
 328         updates, please see
 329
 330 http://www.freebsd.org/cgi/getmsg.cgi?fetch=800363+0+current/freebsd-current
 331
 332         for details.
 333
 334         Matt Dillon committed a boatload of VM changes, for
 335         information please see
 336
 337 http://www.freebsd.org/cgi/getmsg.cgi?fetch=886676+0+current/freebsd-current
 338         or
 339 http://www.freebsd.org/cgi/getmsg.cgi?fetch=827400+0+current/freebsd-current
 340
 341         for details.  These changes will likely not impact anybody,
 342         but large chagnes to the VM need at least a heads up.
 343
 344 19990120:
 345         Stable branch created.  You might want to consider using this
 346         branch.  It is tagged with RELENG_3.
 347
 348 19990119:
 349         More work on the syscons driver has been committed.  Since
 350         files moved around, you will need to reconfigure your kernel,
 351         and make clean; make depend before rebuilding the kernel.  No
 352         config file changes are needed.
 353
 354 19990111:
 355         New keyboard and video card drivers are introduced as the first
 356         stage of console driver reorganization.  You are required to
 357         update the kernel configuration file and rebuild the kernel.
 358         kbdcontrol, vidcontrol, and screen savers also need recompilation.
 359         The instruction can be found in
 360
 361                 http://www.freebsd.org/~yokota/sc_update.txt
 362
 363         It has notes on splash screen too.
 364
 365 19990106:
 366         Robert Nordier was kind enough to make this page to enable people to
 367         install the new bootblocks:
 368
 369                 http://www.freebsd.org/~rnordier/boot.txt
 370
 371         When updating to ELF, make sure that you have updated your
 372         /etc/rc files which have different ldconfig invocations for
 373         elf and aout.  Otherwise things like X will stop working with
 374         messages about being unable to find library files.  The
 375         mergemaster utility in ports/sysutils/mergemaster helps to
 376         keep critical files like this in sync, and its use is
 377         recommended.
 378
 379 19990104:
 380         Information about ELF day (see 19981230) can be found in
 381
 382                 http://www.freebsd.org/~peter/elfday.html
 383
 384         about the upcoming change, its motivations and instructions
 385         for doing the upgrade.
 386
 387 19981230:
 388         You should install new bootblocks now.  The ELF kernel will
 389         become default soon.  In addition, you'll need to upgrade
 390         your userland programs to ELF before then as well.  Use
 391         make aout-to-elf to upgrade your userland programs (old
 392         a.out programs in, for example, /usr/local/bin will
 393         continue to work, even after the upgrade).  See src/Makefile
 394         for more details.
 395
 396 19981224:
 397         The old wcd driver has been deleted from the kernel.  The
 398         driver that replaces it is named acd.  You'll need to change
 399         this in your configuration files.
 400
 401         Failure to do this will result in "ATAPI CD-ROMs not
 402         configured" at boot time.
 403
 404         The floppy tape driver (ft) has been removed from the kernel,
 405         with no replacement driver.
 406
 407 19981202:
 408         New groups from 19981201 commented out of mtree, so they
 409         aren't strictly needed, but still a good idea to have.
 410
 411 19981201:
 412         New user/group added: bind.  From src/etc/master.passwd and
 413         src/etc/group:
 414                 % grep <newstuff> /usr/src/etc/group
 415                 bind:*:53:
 416                 % grep <newstuff> /usr/src/etc/master.passwd
 417                 tty:*:4:65533::0:0:Tty Sandbox:/:/sbin/nologin
 418                 kmem:*:5:65533::0:0:KMem Sandbox:/:/sbin/nologin
 419                 bind:*:53:53::0:0:Bind Sandbox:/:/sbin/nologin
 420
 421 19981118:
 422         PAM integrated into the tree.   Requires new /etc/pam.conf file
 423         to silence warnings from authentication programs (login, etc).
 424         See src/etc/pam.conf for a sample.
 425
 426 This file contains a list, in reverse chronologocal order, of major
 427 breakages in tracking -current.  Not all things will be listed here,
 428 and it only starts on November 18, 1998.  If you have an earlier
 429 version of FreeBSD, you are on your own to get to November 18, 1998.
 430
 431 Please filter your entries through Warner (imp@village.org) so that
 432 the style, formatting, etc of this file can be maintained.
 433
 434 $FreeBSD$