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