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 20000205:
   9         The xinstall problem has kinda sorta been corrected.  The
  10         following is known to work by the author of UPDATING.  It
  11         is what he did to update his laptop.  It is likely the same
  12         effect as the work around listed in 20000129.
  13                 make buildworld
  14                 make installworld       This will fail
  15                 cd usr.bin/xinstall
  16                 make clean all install NOSHARED=YES
  17                 cd ../..
  18                 make installworld
  19         If it doesn't work for you, then I'm sure that there will be
  20         another 100 messages in -current.
  21
  22 20000204:
  23         libipsec version number changed from 2 to 0.  The original
  24         commit of Jan 6 incorrectly set this to 2.  Remove
  25         /usr/lib/libipsec.so.2* before the buildworld and rebuild
  26         anything that uses libipsec.so after you install the new
  27         version.
  28
  29 20000201:
  30         The rcmd related functions have been aligned with other BSD
  31         implementations.  rlogind and rshd have been changed to use
  32         the new API.  A make world is recommended to keep them in sync
  33         with the libraries they use.
  34
  35         http://www.FreeBSD.org/cgi/cvsweb.cgi/src/lib/libc/net/rcmd.c
  36         has the details.
  37
  38 20000129:
  39         {set,get}flags have been added to the tree for rather dubious
  40         reasons.
  41
  42         IF AND ONLY IF installworld fails:
  43                 make -k -DNOFSCHG installworld
  44                 make installworld
  45         This issue was resolved Feb 5, 2000.
  46
  47 20000125:
  48         rcmd_af() is added for multiple address family support.  rsh
  49         and rlogin have been updated to use this to support INET6.  A
  50         make world is recommended to keep them in sync with the
  51         libraries they use.
  52
  53 20000124:
  54         The default way that virtual tables in our default C++
  55         compiler has changed.  We used to use THUNKS for virtual
  56         inheritance.  Unfortunately there are bugs that The GCC
  57         developers thought would be fixed in GCC 2.95.  However it
  58         isn't.
  59
  60         After this change existing applications written in C++ may
  61         give errors like below when you try to run them:
  62
  63 /usr/libexec/ld-elf.so.1: /usr/lib/libstdc++.so.3: Undefined symbol "__vt_7filebuf"
  64
  65         The only fix is to rebuild the application and any C++
  66         libraries used.
  67
  68 20000124:
  69         The management of next_writeable has been move from the
  70         kernel to userspace. This means that the burncd command
  71         must be in sync with the kernel. So make world is your
  72         friend.
  73
  74 20000117:
  75         GNU texinfo upgraded to 4.0.  It is recommended that you use
  76         make buildworld to update.
  77
  78 20000117:
  79         CAM_VERSION has been increased.  Recompile all programs that
  80         depend on it (tosha, camcontrol, etc) when moving to kernels
  81         past this date.
  82
  83 20000115:
  84         pccard ioctls changed with a commit to have the kernel tell
  85         pccardd which device it created, rather than having pccardd
  86         dictate it to the kernel.  Recompile kernel and
  87         pccardd/pccardc together.  pccardd/pccardc rely on a kernel
  88         Makefile that must be installed prior to building them.  Make
  89         world will automatically take care of this issue, but you need
  90         to know if you are building by hand.
  91
  92 20000109:
  93         Your kernel config files need to be changed to s/controller/device/
  94         in them.  You will need a new version of config to do this.
  95
  96 20000107:
  97         chown & chgrp moved again
  98
  99         This is a heads up to let you know that you need to
 100                     rm -f /sbin/chown /bin/chgrp
 101         after your next `make world'.  Additionally you need to install
 102         a new /dev/MAKEDEV (mergemaster(8) will assist you in this).
 103
 104 20000107:
 105         SHA-1 password support gone
 106
 107         As warned yesterday, I've just removed the ability for
 108         libcrypt to understand SHA-1 passwords. This was present but
 109         undocumented in the tree for the past few months and was
 110         removed so it can be reimplemented properly as part of a
 111         revamped libcrypt at a later date. Anyone who was actually
 112         making use of the feature will have to update their passwords
 113         back to MD5 before they reinstall the library.
 114
 115 20000106:
 116         ioctl numbers changed for dvdio ioctls.  You will need to recompile
 117         anything that uses them.  wormcontrol has been deprecated in
 118         favor of burncd.
 119
 120 19991223:
 121         Building linux and svr4 compatibility into the kernel now
 122         requires /usr/bin/genassym.  Go to /usr/src/usr.bin/genassym,
 123         do "make obj ; make clean depend all install" before building
 124         your kernel.
 125
 126 19991218:
 127         sendmail.cf has moved from /etc/sendmail.cf to
 128         /etc/mail/sendmail.cf.  You may need to adjust /etc/rc.conf
 129         and /etc/rc to cope as well as moving sendmail.cf.
 130
 131 19991216:
 132         ntp 4.0.98 has replaced the ancient xntpd.  The daemon name
 133         changed from xntpd to ntpd, so you may need to update your
 134         /etc/rc.conf file.  The ntp.conf files are compatible with the
 135         old release, unless you are using a local reference clock.
 136         Details about ntp4 can be found at http://www.ntp.org/.
 137
 138         xntpd will be cvs removed from the repo in about a week.
 139
 140 19991213:
 141         Soren updated the ata driver.  Please update to at least this
 142         version before submitting bug reports.
 143
 144 19991210:
 145         The ata driver has become the primary ata/ide/atapi driver in
 146         the kernel.  The wd driver is obsolete.  You should upgrade your
 147         machine to the new ata driver.  You will need to follow the
 148         directions for updating the devices in the 19991205 entry.  You
 149         will need to update all occurances of wd to ad in your config files
 150         (/etc/rc.conf, /etc/fstab, etc).  A compatibility device exists
 151         for wd for the time being, but once you have determined that
 152         ata is working for you, transition to the new ad devices.
 153
 154 19991205:
 155         Block devices are going away.  You will need to update your /dev
 156         tree with a fresh copy of MAKEDEV for things to always work in
 157         the future.  fsck is unable to cope with dirty file systems
 158         after this change, so it may work for you or it may not.
 159
 160         See "To rebuild disk /dev entries" at the end of the file.
 161
 162         *** All uses of block devices must be converted to char devices.
 163         *** Likely the only thing impacted is dumpdev in /etc/rc.conf
 164
 165 19991204:
 166         The dc interface has replaced al, ax, dm, pn and mx.  The former
 167         have been removed.
 168
 169 19991204:
 170         Support for the old 'sd' device names has been removed in
 171         favor of 'da'.  Please update your /etc/fstab, /etc/rc.conf
 172         and any other places you might have sd names cached.
 173         Generally these changes are as simple as s=/dev/sd=/dev/da=g,
 174         but be careful to make sure that things are really that
 175         simple.  You may also need to create /dev entries for the da
 176         devices as well.
 177
 178         See "To rebuild disk /dev entries" at the end of the file.
 179
 180 19991203:
 181         BAD144 support has been removed.  Cope or replace the hardware.
 182
 183 19991129:
 184         ALPHA users take note.  All klds will need to be recompiled for
 185         kernels build after this date.  It is a good time to update since
 186         pal.s will be going away soon.
 187
 188 19991126:
 189         MFS_ROOT and MFS_ROOT_SIZE are gone, replaced by MD_ROOT and
 190         MD_ROOT_SIZE options in the md driver.  md driver now deals with
 191         the hacks.  You should add md driver to kerneles that have
 192         MFS_ROOT, et al.  See GENERIC or LINT for details.
 193
 194 19991125:
 195         The ep changed a while ago and can no longer be used with hard
 196         wired addresses in the config file.
 197
 198 19991122:
 199         The bridge drivers for sound cards have been committed.  Please
 200         see LINT for instructions for your card, if it still works at
 201         all.
 202
 203 19991113:
 204         Gcc 2.95.2 is now the default compiler.
 205
 206 19991030:
 207         /etc/radius.conf file format has changed.The format change is
 208         as follows.  Each server line in the file should now begin
 209         with a new field containing either "auth" for RADIUS
 210         authentication, or "acct" for RADIUS accounting.  Formerly
 211         only authentication was supported.  If the first field isn't
 212         "auth" or "acct" then the code assumes that "auth" is
 213         intended.  (That's the compatibility hack.)
 214
 215 19991015:
 216         PCCARD has been updated to attach pcic to the isa bus.  Therefore
 217         you will need to modify kernel config files that have pcic/card
 218         in them as follows:
 219                 controller      pcic0   at isa?
 220                 controller      pcic1   at isa?
 221                 controller      card0
 222
 223 19990929:
 224         The sigset_t datatype has been changed from an integral type
 225         to a compound type and can hold 128 signals. Syscalls directly
 226         or indirectly using the new sigset_t have been added as to
 227         maintain compatibility with existing binaries. A new kernel must
 228         be made and installed and booted with before a make world can
 229         be done.
 230
 231 19990919:
 232         New jail syscall format requires recompilation of jail(8) with
 233         fresh headers installed (or a make world will do it for you).
 234
 235 19990914:
 236         Matt Dillon checked in many vm related things and sent a heads up
 237         to -current urging caution and to report vm problems to him.
 238         As of the 19th, no killer problems have been reported, but you
 239         have been warned.
 240
 241 19990908:
 242         The new miibus has been added to the system.  If you are using
 243         the dm, rl, sf, sis, ste, tl, wb or xl drivers, you need to
 244         add "controller miibus0" to your config file.
 245
 246 19990905:
 247         /var/cron/log has been moved to /var/log/cron to get all the
 248         log files in one place.
 249
 250 19990831:
 251         tn3270 has been removed from the base system and added as a port.
 252
 253 19990830:
 254         User-visible TCP timers are now expressed in units of 1ms, instead
 255         of 500ms, so if you've customized any timer values under
 256         ``net.inet.tcp'', multiply them by 500 to preserve TCP's behavior.
 257
 258 19990828:
 259         RCS Id tags changed to FreeBSD.  This will cause huge cvsup
 260         updates.
 261
 262 19990821:
 263         On 28-May-1999 libreadline was upgraded from readline-2.2 to
 264         readline-4.0.  At that time the shared library major version
 265         number was bumped from "3" to "4".  It has been deemed that
 266         the interface change between readline-2.2 and readline-4.0 was
 267         not sufficient to warrant the version number bump.
 268
 269         Thus I have reverted it back to "3".  You will need to perform
 270         the below immediately before your next ``make world'':
 271             cd /usr/lib
 272             ls -l libreadline.so.4
 273                 (if you have /usr/lib/libreadline.so.4)
 274             mv libreadline.so.4 libreadline.so.3
 275             rm -f libreadline.so
 276             ln -s libreadline.so.3 libreadline.so
 277
 278 19990801:
 279         Changes to the pccardd kernel interface require that you recompile
 280         pccardd for new kernel.
 281
 282 19980725:
 283         The ipfw interface to the kernel has changed.  You will need to
 284         recompile ipfw programs for the new kernel.
 285
 286 19990715:
 287         The bpfilter device has been renamed to bpf.  You will need to
 288         change your config files in order to enable this in newer kernels.
 289
 290 19990704:
 291         src/contrib/sys/softupdates is moving to
 292         src/sys/contrib/softupdates.  Update your symbolic links/etc.
 293
 294 19990702:
 295         Major changes have been made to vinum and its interface.  See
 296         the man page (vinum(8)) for details.  Look at the concat,
 297         mirror and stripe commands, as well as the SIMPLIFIED
 298         CONFIGURATION section.
 299
 300 19990628:
 301         Newsyslog.conf has had a minor, but potentially dangerous,
 302         change to its username/group syntax.  The old syntax was
 303         user.group, while the new syntax is user:group.
 304
 305 19990627:
 306         Inetd wrapping default has changed.  Please see the updated
 307         man page for details.
 308
 309 19990623:
 310         Compaq Smart Raid driver committed as ida.
 311
 312 19990622:
 313         The second phase of syscons cleanup has happened.  Some
 314         functionality has been made optional.  For details, see
 315         http://www.freebsd.org/~yokota/sc_update-June.txt
 316         Everyone will need to re-config(8) their kernels, but old
 317         binaries will work with the new kernel.
 318
 319 19990620:
 320         IPFW uid/gid-based filtering support has been committed. This
 321         breaks binary compatibility with previous copies of
 322         ipfw(8). Any utilities using the ioctl()s of ipfw (especially
 323         ipfw(8)) need to be recompiled with the newest headers
 324         installed.
 325
 326 19990618:
 327         Inetd now wraps all stream-based services, including internals.
 328         Syslog "severity" options are honoured. Installed syslog.conf
 329         and hosts.allow should be checked.
 330
 331 19990509:
 332         Most of the problems with newbus have been corrected, but
 333         it is still current and evolving.
 334
 335         libcam's ABI has changed.  You must recompile the world and
 336         any ports that use it.
 337
 338 19990427:
 339         Massive changes to SMP went into the tree that should speed
 340         things up.  However, if you experience problems with SMP
 341         machines, you can back off to the PRE_SMP_VMSHARE tag in the
 342         CVS repository (or run an MP kernel).
 343
 344 19990420:
 345         Pccardd and the pccard bus in general seem to be broken or
 346         most people.  Soren has patches to make it better for some,
 347         but not all people.  Work is underway to make it better for
 348         all people.
 349
 350 19990416:
 351         new bus changes integrated into -current.  Many problems were
 352         initially reported, but most have been fixed.  You'll need a
 353         new config and to tweak your kernel config file the way that
 354         GENERIC was tweaked.  Keep a copy of your old kernel when
 355         upgrading in case your new kernel doesn't work (and report the
 356         breakage to current@freebsd.org).
 357
 358         As of 19990421 the remaining problems/quirks are
 359
 360         o sio no longer supports pnp nor pccard.  This will be corrected,
 361           but the new pccard code needs to be completed.
 362         o Some of the sound drivers broke for some people.  It seems
 363           inconsistant as to who/what/when/where things broke.
 364         o Duplicate device entries in your config do not work.  Previously
 365           they were silently ignored.  psm0 seems to be the most common
 366           duplicate choice, although some reports have come in from people
 367           that wired their scsi disk entries.
 368         o You must move the keyboard and mouse attachments from the
 369           isa bus to the atkbdc bus.  See GENERIC for details.
 370         o Machines with multiple host-pci bridges (Intel 450NX) will not
 371           probe the second pci bus.
 372         o Some probe ordering may have changed, so device naming may change
 373           with the new kernel.  If you have multiple devices, please double
 374           check to make sure they didn't move.  This is especially true
 375           for cards on different buses.
 376         o The bus attachment for vga0 is always isa0 and never pci0 when
 377           it is in fact a pci card.  It is safe to ignore this.
 378         o The format of the boot messages has changed (and is not
 379           guaranteed to be constant for a while) so you may see this
 380           in some shell scripts that diff dmesg from day to day as well
 381           as scripts that parse dmesg output.
 382
 383 19990414:
 384         cc -aout sometimes has problems compiling with -g, remove -g
 385         from those compilation units affected until this is corrected.
 386
 387         cc -aout has problems with producing some threaded libraries,
 388         so make world -DWANT_AOUT is not functional at this time.
 389
 390         Since make world for a.out isn't functional, you cannot do
 391         make aout-to-elf from a pre-egcs a.out system.  To work around
 392         this problem, make aout-to-elf using 3.1-stable first (or a
 393         pre egcs -current) and then a simple make world will take you
 394         the rest of the way with a -current source base.
 395
 396 19990413:
 397         Make -j works again for make world.  As always, use it with
 398         care, and be sure to try a make world w/o -j before reporting
 399         problems (that is, know if the problem exists w/o -j before
 400         reporting the problem with -j).
 401
 402 19990413:
 403         Note cc -aout, which had been broken since the conversion to
 404         egcs, now supposedly works.  If you have rebuilt things like
 405         XFree86 a.out libraries, you should rebuild them again or
 406         progams that use them, including netscape, will fail to work.
 407
 408 19990409:
 409         NOTE: New c++ compiler cannot be used with c++ binaries from
 410         the old compiler and vice versa.
 411
 412 19990408:
 413         In recent days egcs has been imported into the tree.  A number
 414         of problems have been discussed in -current.  Here is a highlight
 415         of a few of the more common ones.  With the exception of make
 416         -j n, they have been claimed to have been fixed.
 417
 418         c++ is broken after make world: This is correct.  Because we
 419         changed compilers two make worlds are necessary to get C++
 420         working again.  The code generated by the old compiler and new
 421         compiler are not compatible, so things wind up being
 422         undefined.
 423
 424         cpp is broken in make world:  There was a window where cpp
 425         would be built incorrectly.  The fix for this is
 426                 cd src/gnu/usr.bin/cc
 427                 make clean
 428                 make all
 429                 make install
 430         and this should correct your problems.  See the -current
 431         archives for a version of this that does moer cleaning.
 432
 433         Make -j n doesn't work.  Work contiunes to make this work,
 434         I've seen no reports of success as of April 7th.
 435
 436 19990329:
 437         Previously, one would define "NOAOUT" to keep from building
 438         the legacy a.out bits.  Now one would define "WANT_AOUT" to
 439         build them.
 440
 441 19990316:
 442         The name of the old wd.c and atapi.c based CDROM driver has
 443         been changed back to wcd. So update your config file to use
 444         "device wcd" instead of "device acd".
 445
 446 19990314:
 447         For those of you using the VN device as a loadable module,
 448         please be aware that the new VN device has been committed to
 449         -4.x and cannot yet be used as a loadable module.  This will
 450         be fixed in the future.
 451
 452 19990309:
 453         New loader.rc mechanism.  Please see src/sys/boot/README for
 454         details.
 455
 456 19990225:
 457         struct proc size changed.  Recompile kernel and the
 458         usual suspects.  Make world if in doubt.
 459
 460 19990214:
 461         The nlpt driver has changed names back to be the lpt driver.
 462         See ppbus(4) or http://www.freebsd.org/~nsouch/ppbus.html
 463         for proper configuration details.
 464
 465 19990210:
 466         The 'lpt' driver is now obsolete.  Replace it with the 'nlpt'
 467         driver and 'ppbus' controller combination.
 468
 469 19990209:
 470         New devstat API requires recompilation of libdevstat, systat,
 471         iostat, vmstat and rpc.rstatd.  A new kernel is also required.
 472         make world + building a kernel should do all of this.  Any
 473         ports that use devstat need to be recompiled as well.
 474
 475 19990125:
 476         Linux threads options has gone away (they are now standard in
 477         the FreeBSD kernel).  A recompile of all libkvm using programs
 478         is in order (or better yet a make world).
 479
 480 19990122:
 481         On or about this date there was a small window when the boot
 482         blocks had some minor problems which seemed to force one to
 483         edit /etc/fstab.  This has been corrected, if you are seeing this
 484         problem, please rebuild and reinstall your boot blocks.
 485
 486 19990121:
 487         Vinum has changed.  The "vinum read" command has changed.  For
 488         updates, please see
 489
 490 http://www.freebsd.org/cgi/getmsg.cgi?fetch=800363+0+current/freebsd-current
 491
 492         for details.
 493
 494         Matt Dillon committed a boatload of VM changes, for
 495         information please see
 496
 497 http://www.freebsd.org/cgi/getmsg.cgi?fetch=886676+0+current/freebsd-current
 498         or
 499 http://www.freebsd.org/cgi/getmsg.cgi?fetch=827400+0+current/freebsd-current
 500
 501         for details.  These changes will likely not impact anybody,
 502         but large chagnes to the VM need at least a heads up.
 503
 504 19990120:
 505         Stable branch created.  You might want to consider using this
 506         branch.  It is tagged with RELENG_3.
 507
 508 19990119:
 509         More work on the syscons driver has been committed.  Since
 510         files moved around, you will need to reconfigure your kernel,
 511         and make clean; make depend before rebuilding the kernel.  No
 512         config file changes are needed.
 513
 514 19990111:
 515         New keyboard and video card drivers are introduced as the first
 516         stage of console driver reorganization.  You are required to
 517         update the kernel configuration file and rebuild the kernel.
 518         kbdcontrol, vidcontrol, and screen savers also need recompilation.
 519         The instruction can be found in
 520
 521                 http://www.freebsd.org/~yokota/sc_update.txt
 522
 523         It has notes on splash screen too.
 524
 525 19990106:
 526         Robert Nordier was kind enough to make this page to enable people to
 527         install the new bootblocks:
 528
 529                 http://www.freebsd.org/~rnordier/boot.txt
 530
 531         When updating to ELF, make sure that you have updated your
 532         /etc/rc files which have different ldconfig invocations for
 533         elf and aout.  Otherwise things like X will stop working with
 534         messages about being unable to find library files.  The
 535         mergemaster utility in ports/sysutils/mergemaster helps to
 536         keep critical files like this in sync, and its use is
 537         recommended.
 538
 539 19990104:
 540         Information about ELF day (see 19981230) can be found in
 541
 542                 http://www.freebsd.org/~peter/elfday.html
 543
 544         about the upcoming change, its motivations and instructions
 545         for doing the upgrade.
 546
 547 19981230:
 548         You should install new bootblocks now.  The ELF kernel will
 549         become default soon.  In addition, you'll need to upgrade
 550         your userland programs to ELF before then as well.  Use
 551         make aout-to-elf to upgrade your userland programs (old
 552         a.out programs in, for example, /usr/local/bin will
 553         continue to work, even after the upgrade).  See src/Makefile
 554         for more details.
 555
 556 19981224:
 557         The old wcd driver has been deleted from the kernel.  The
 558         driver that replaces it is named acd.  You'll need to change
 559         this in your configuration files.
 560
 561         Failure to do this will result in "ATAPI CD-ROMs not
 562         configured" at boot time.
 563
 564         The floppy tape driver (ft) has been removed from the kernel,
 565         with no replacement driver.
 566
 567 19981202:
 568         New groups from 19981201 commented out of mtree, so they
 569         aren't strictly needed, but still a good idea to have.
 570
 571 19981201:
 572         New user/group added: bind.  From src/etc/master.passwd and
 573         src/etc/group:
 574                 % grep <newstuff> /usr/src/etc/group
 575                 bind:*:53:
 576                 % grep <newstuff> /usr/src/etc/master.passwd
 577                 tty:*:4:65533::0:0:Tty Sandbox:/:/sbin/nologin
 578                 kmem:*:5:65533::0:0:KMem Sandbox:/:/sbin/nologin
 579                 bind:*:53:53::0:0:Bind Sandbox:/:/sbin/nologin
 580
 581 19981118:
 582         PAM integrated into the tree.   Requires new /etc/pam.conf file
 583         to silence warnings from authentication programs (login, etc).
 584         See src/etc/pam.conf for a sample.
 585
 586 COMMON ITEMS:
 587
 588         To build a kernel
 589         -----------------
 590         Update config, genassym and go:
 591                 cd src/usr.bin/genassym
 592                 make depend all install clean
 593                 cd ../../usr.sbin/config
 594                 make depend all install clean
 595                 cd ../../sys/i386/conf
 596                 config YOUR_KERNEL_HERE
 597                 cd ../../compile/YOUR_KERNEL_HERE
 598                 make depend && make
 599
 600         To rebuild disk /dev entries
 601         ----------------------------
 602
 603         MAKEDEV should be copied from src/etc/MAKEDEV to /dev before
 604         starting the following:
 605
 606                 For N in the list of disks
 607                         MAKEDEV N                       # eg ad0
 608                         for M in the list of slices
 609                                 MAKEDEV NsMa            # eg ad0s1a
 610
 611
 612         To rebuild everything
 613         ---------------------
 614         make world
 615
 616         To update from 3.x to 4.0 stable
 617         --------------------------------
 618         make world
 619
 620 FORMAT:
 621
 622 This file contains a list, in reverse chronologocal order, of major
 623 breakages in tracking -current.  Not all things will be listed here,
 624 and it only starts on November 18, 1998.  If you have an earlier
 625 version of FreeBSD, you are on your own to get to November 18, 1998.
 626
 627 Please filter your entries through Warner (imp@village.org) so that
 628 the style, formatting, etc of this file can be maintained.
 629
 630 $FreeBSD$