UPDATING revision 1.122
1$NetBSD: UPDATING,v 1.122 2004/05/31 00:18:58 itojun Exp $ 2 3This file is intended to be a brief introduction to the build 4process and a reference on what to do if something doesn't work. 5 6For a more detailed description see Makefile. 7 8Recent changes: 9^^^^^^^^^^^^^^^ 10 1120040516: 12 The end-user modifiable X11 configuration has been moved 13 from /usr/X11R6/lib/X11/<dir> to /etc/X11/<dir>. 14 Ensure that src and xsrc is up to date, and run 15 "make cleandir" in src/x11 before your next build. 16 1720040426: 18 Support for the original dynamic sysctl node structure has 19 been removed in favor of the newer layout. This affects 20 consumers of the create and delete interface, as well as 21 the dynamic discovery mechanism. This is believed only to 22 be the sysctl(8) binary itself, at this point in time, so 23 the only effect of this should be that a sysctl binary 24 built from sources dated between 2003/12/04 and 2004/03/24 25 will not work on a kernel built from sources dated after 26 2004/04/25. If you need a new sysctl binary but build.sh 27 does not work, make sure that your revision of 28 src/sys/sys/sysctl.h is 1.112 (or later), and then the 29 do the following: 30 31 cd /usr/src (or wherever your source tree is) 32 make USETOOLS=no includes 33 cd lib/libc 34 make USETOOLS=no dependall install 35 cd ../../sbin/sysctl 36 make USETOOLS=no dependall install 37 38 If you are using older sysctl binary, GNU autoconf would fail to 39 identify your machine architecture, and tries to build binary for 40 "unknown-unknown-netbsd20F" or something like that. if that happens, 41 make sure to follow the above steps. 42 4320040425: 44 The ffs superblock issues listed below under 20040109 and 20030402 45 are now automatically addressed by the /etc/rc.d/fixsb script or by 46 sysinst when it checks a a filesystem. The manual fsck_ffs -b16 -c4 47 invocation mentioned below will continue to work and is now 48 automated by those scripts. Note that under certain circumstances, 49 affected filesystems upgraded to a -current kernel first before 50 upgrading their userland with the fixsb and fsck_ffs fixes may 51 encounter a 'freeing free inode' panic when writing to the affected 52 filesystem, so it is a good idea to repair the filesystem as soon as 53 possible. For more details on the fixsb script, see pr install/25138. 54 5520040418: 56 statfs(2) and friends have been replaced with statvfs(2). Before 57 installing a newly build userland make sure that you are running 58 a newly built kernel with COMPAT_20 set. In addition your libc 59 build might not work (undefined SYS_statfs symbol) because make 60 clean does not know how to remove files it does not know about 61 anymore. Manually remove all generated .S sources and objects 62 from the libc build directory. 63 6420040326: 65 The method by which athhal-elf.o gets pulled into i386 kernel builds 66 has been changed. The file is now stored as a uuencoded file in CVS 67 and the generated Makefile will use the new .uue rules from bsd.file.mk 68 to build it. 69 70 This means you must have the latest bsd.files.mk installed when 71 building a kernel without USETOOLS=yes. 72 7320040318: 74 A bug in the cgd(4) blowfish code was corrected, without 75 provision of backwards compatibility, after several public 76 notices over several months. Users of cgd with blowfish cipher 77 ONLY must dump their data before updating their kernels, and 78 recreate cgd's and restore data using the new kernel. See 79 (recent message to current-users, URL when mail-index has updated) 80 8120040313: 82 On acorn32, the opms and qms drivers have been withdrawn, and 83 the old wsqms driver is now called qms. Kernel config files 84 will need updating. See the ones in sys/arch/acorn32/conf 85 for examples. 86 8720040125: 88 On acorn32, the beep and sysbeep devices are no longer 89 needed, and will need to be deleted from kernel configuration 90 files. 91 9220040109: 93 Compatibility for old ffs superblock layouts has been 94 added, and the restrictive fsck checks have been reenabled 95 when using those layouts. If you have been using -current 96 since 20030402, you may find that fsck again signals fatal 97 superblock mismatches. To repair, make sure you have 98 an updated fsck_ffs and then you can use fsck_ffs -b 16 -c 4 99 to complete the filesystem upgrade. A message has 100 been added to the kernel which should detect this problem. 101 See the following discussion for more information: 102 http://mail-index.NetBSD.org/current-users/2004/01/11/0022.html 103 10420031203: 105 New binutils builds may fail due to old dependencies. 106 It's necessary to "make cleandir" to ensure that 107 the dependencies will be rebuilt correctly. 108 10920031111: 110 A newer mkdep is needed. Error noting that is 111 cc: Ambiguous abbreviation -- 112 11320031008: 114 /usr/include/sys/disklabel_mbr.h was removed. 115 It's necessary to "make cleandir" to ensure that 116 the dependencies will be rebuilt correctly. 117 11820031007: 119 A sign exension bug was fixed which set all the high bits 120 of our newly expanded ffs fs_flags. This should only 121 affect users who installed or upgraded in September of 2003. 122 A small utility program was posted to tech-kern which 123 should fix this problem, and a warning message was added 124 to the kernel which should discover and warn about it. See 125 http://mail-index.NetBSD.org/tech-kern/2003/10/07/0005.html 126 12720030906: 128 With the addition of siginfo support the old signal trampoline 129 code has been deprecated to COMPAT_16. Make sure that your running 130 kernel has COMPAT_16 enabled before building userland. 131 13220030801: 133 With the new openssl, there is some header and library shuffling. 134 rm -f /usr/include/des.h /usr/include/kerberosIV/* /lib/libdes* \ 135 /usr/lib/libdes* before building. 136 13720030703: 138 Texinfo was updated to 4.6. To avoid failures when trying to 139 build the included texinfo files, do: 140 141 cd src/gnu/usr.bin/texinfo 142 make MKINFO=no dependall install 143 14420030630: 145 Groff was updated to 1.19; it's probably necessary to do 146 cd share/mk && make install 147 cd src/gnu/usr.bin/groff 148 make MKMAN=no dependall install 149 (untested). 150 15120030516: 152 Due to bugs in the export handling code, invalid export lines 153 were accepted before and caused the kernel to panic when 154 mountd got restarted because it freed memory that had already 155 been freed. This has been fixed and the kernel checks 156 export addresses very strictly. If you upgrade your kernel, 157 make sure you also upgrade mountd, because if your export 158 file contains lines with an old inet4 address syntax (i.e. 159 a.b.c or a.b or a), they will get rejected by the new kernel. 160 16120030402: 162 The superblock layout for FFS was changed. If you have 1.6 163 fsck binaries, they will signal a fatal superblock mismatch 164 with the first alternate, because they compare too many 165 fields (even ones that aren't useful). If possible, upgrade 166 your fsck_ffs binary before using a new kernel. 167 None of this signals actual filesystem damage. 168 16920030324: 170 sendmail version 8.12.8 was imported. Since sendmail is 171 now setgid to the smmsp group, and runs in "collection" 172 mode for most common activities, there is a new config 173 file called submit.cf that needs to live in /etc/mail. 174 The generic submit.cf sample in /usr/share/sendmail/cf 175 is named netbsd-msp.cf. Upgrading your regular sendmail 176 configuration file is also strongly advised. 177 178 See the section named "MESSAGE SUBMISSION PROGRAM" in 179 the updated /usr/share/sendmail/README file for more 180 information. 181 18220030117: 183 Texinfo was updated to 4.3. To avoid failures when trying to 184 build the included texinfo files, do: 185 186 cd src/gnu/usr.bin/texinfo 187 make MKINFO=no dependall install 188 18920021223: 190 The METALOG format changed slightly, to remove the leading 191 "${DESTDIR}" from path names. 192 This only affects people building with UNPRIVED. 193 For complete safety, remove the DESTDIR entirely and 194 update tools/mtree, before running make build. 195 19620021219: 197 CVS repository layout was changed. See the following for details 198 if you are using (anonymous) cvs to update your tree. 199 200 http://mail-index.NetBSD.org/netbsd-announce/2002/12/19/0000.html 201 20220021219: 203 install(1) had a '-N dbdir' option added, to specify an 204 alternate location to look up users & groups (instead 205 of the host system passwd(5) and group(5) databases). 206 207 The build system was modified to take advantage of 208 this option (using ${NETBSDSRCDIR}/etc), so if you 209 use USETOOLS==no, you may have to rebuild and 210 reinstall usr.bin/xinstall first. 211 21220021130: 213 fparseln(3) moved from libutil to libc. 214 If building to DESTDIR=/, reinstall the includes 215 and rebuild libc: 216 make includes 217 make do-lib-libc 218 If using build.sh, "cd tools/compat && make clean" 219 before rebuilding the tools. 220 22120021126: 222 The mk.conf(5) variable SYS_INCLUDE has been deprecated, 223 including the optional "SYS_INCLUDE=symlinks" support. 224 All header files, including <sys/*.h> are copied into 225 /usr/include. 226 22720021121: 228 The C run-time support files crtbegin.o and crtend.o 229 (and their companions crtbeginS.o and crtendS.o) were 230 split up, with new crti.o and crtn.o files resulting. 231 This means that libtool needs to be rebuilt once the 232 new libraries are installed. The process of rebuilding 233 libtool will cause it to automatically notice the new 234 required files, but it *must* be rebuilt in order to 235 do this. 236 237 An out-of-date libtool will result in shared libraries 238 which lack _init() and _fini() routines, which means that 239 their global contructors/destructors will not be invoked. 240 24120021121: 242 A bug related to how ARM ELF objects were tagged has been 243 corrected. 244 245 NetBSD ARM ELF uses the soft-VFP floating point model by 246 default. However, the assembler lacked support for marking 247 objects as using the VFP floating point format, and the 248 compiler was not properly passing the flag indicating "soft-VFP" 249 to the assembler. 250 251 Unfortunately, this means that the linker will now consider 252 old (i.e. not marked "softvfp") NetBSD ARM ELF objects to be 253 incompatible with new (properly marked) objects. 254 255 The problem will only manifest itself if you attempt to compile 256 a new program using the fixed toolchain, and link that program 257 against old libraries which do not have the proper "softvfp" 258 markings. ALL OF YOUR EXISTING BINARIES AND SHARED LIBRARIES 259 WILL CONTINUE TO WORK PROPERLY. 260 261 The only work-around for the problem is to recompile all of 262 the libraries on the system. The easiest way to do this for 263 system libraries is to install a binary snapshot; they are 264 generally available on releng.NetBSD.org. Any packages you 265 have installed which supply libraries will have to be recompiled 266 if you wish to link new programs against those libraries. 267 268 If you have questions about this matter, please contact 269 port-arm@NetBSD.org. 270 27120021011: 272 Systrace has been improved to support privilege elevation. 273 Updating the kernel requires the userland part of systrace 274 to be rebuilt. 275 27620021010: 277 The config(8) grammar was changed to allow options to register 278 dependencies on attributes, as well as other options. Users 279 must update and reinstall usr.sbin/config before building a new 280 kernel. 281 28220021009: 283 A new attribute dependency syntax was introduced to config(8), 284 which is now used by the SCSI configuration description. Users 285 must update and reinstall usr.sbin/config before building a new 286 kernel. 287 28820021003: 289 Several changes have been made to the autoconfiguration 290 framework. Users must update and reinstall usr.sbin/config 291 before building a new kernel. 292 29320021001: 294 The i386mp branch has been merged. To compile a kernel, users 295 will need to add the option 'cpu* at mainbus?' to their configuration 296 file. Multiprocessor kernels will need 297 ioapic* at mainbus? apid ? 298 options MULTIPROCESSOR 299 options COM_MPLOCK 300 30120020922: 302 MKDYNAMICROOT=yes enabled by default, which means that 303 certain shared libraries are installed into /lib, the shared 304 linker is installed into /libexec, and all programs in /bin 305 and /sbin are dynamically linked. 306 If you do not use "make build", you should ensure that 307 you have the libraries and shared linker in the new locations, 308 with: 309 make do-lib-csu do-lib-libc do-lib do-gnu-lib do-ld.elf_so 310 31120020917: 312 USE_NEW_TOOLCHAIN has been replaced with: 313 - TOOLCHAIN_MISSING -- set to "yes" on platforms for which 314 there is no working in-tree toolchain (hppa, ns32k, sh5, 315 x86_64). 316 - EXTERNAL_TOOLCHAIN -- if defined by the user, points to the 317 root of an external toolchain (e.g. /usr/local/gnu). This 318 enables the cross-build framework even for TOOLCHAIN_MISSING 319 platforms. 320 32120020906: 322 gehenna-devsw has been merged into the trunk. Need to update and 323 reinstall usr.sbin/config before building the kernel. 324 32520020822: 326 Crunched rescue tools (contents of /bin and /sbin, plus others) 327 are now provided in /rescue. 328 329 To ensure that these are built statically linked (no matter 330 what the setting of LDSTATIC is), use a crunchgen(1) built 331 from sources newer than 20020820 (see the next entry). 332 33320020820: 334 crunchgen(1) changed to ensure that the generated program 335 is statically linked. 336 337 Solution: update and reinstall usr.bin/crunch 338 33920020605: 340 smmsp user/group has been added for sendmail. 341 342 Add the following into /etc/group: 343 344 smmsp:*:17: 345 346 and the following to /etc/master.passwd (via vipw): 347 348 smmsp:*:17:17::0:0:Sendmail Message Submission Program:/nonexistent:/sbin/nologin 349 35020020515: 351 sshd user/group has been added. Need to hand add this in, or sshd 352 will not let you log in (with default, or UsePrivlegeSeparation=yes) 353 354 Add the following into /etc/group: 355 356 sshd:*:16: 357 358 and the following to /etc/master.passwd (via vipw): 359 360 sshd:*:16:16::0:0:& pseudo-user:/var/chroot/sshd:/sbin/nologin 361 362 Also /var/chroot/sshd directory needs to be present (digged as part of 363 the build process). 364 36520020426: 366 NBUILDJOBS obsoleted in favor of just using -j. 367 36820020426: 369 etc/postinstall added, which performs various checks for 370 configuration file updates and changes, and can fix most of 371 the problems identified. 372 This should make it much easier to upgrade a system's 373 configuration from earlier systems (as far back as NetBSD 1.5). 374 37520020320: 376 <bsd.lib.mk> needs a new install(1) for its "-a cmd" support. 377 Build and install at usr.bin/xinstall before the build. 378 37920020319: 380 Raw IPv6 socket now makes strict checking for sa_family and sa_len 381 on send(2) operation. Be sure to have sbin/rtsol and usr.sbin/rtsold 382 newer than November 2001 when you upgrade the kernel. 383 38420020311: 385 ssh configuration files were moved from /etc to /etc/ssh. Beware 386 if you restart your machine from remote. Note that sshd.conf needs 387 to be changed (due to the use of "/etc" inside). 388 38920020223: 390 Users of the VAX port will need to rebuild and install gas 391 so it deal with the now present register prefix used in all 392 the VAX assembly files. 393 39420020118: 395 ntpd user/group has been added. Need to hand add this in or builds 396 will break as mtree aborts early. 397 398 Add the following into /etc/group: 399 400 ntpd:*:15: 401 402 and the following to /etc/master.passwd (via vipw): 403 404 ntpd:*:15:15::0:0:Ntpd pseudo-user:/var/chroot/ntpd:/sbin/nologin 405 40620011207: 407 If you're attempting to build a snapshot on sparc64 and are getting 408 reloc errors from the toolchain groff binary this means your native 409 toolchain has some broken C++ bits. 410 411 To fix: 412 413 Build a new toolchain (i.e. build.sh -t) 414 Use the new toolchain to build and install natively (i.e. /usr/lib) 415 416 gnu/lib/libgcc 417 gnu/lib/libstdc++ 418 419 After this a snapshot will be able to be built. 420 42120011201: 422 In order for a sparc64 build to work you must have a working awk. If 423 you've built and installed a system with the new toolchain up to this 424 point you do not have a working awk as its ability to do floating 425 point is broken. 426 427 To build: 428 429 remake and install gnu/lib/libgcc 430 remake and install gnu/usr.bin/gawk into /usr/bin (make sure it links 431 against the new libgcc.a) 432 43320011128: 434 Kernel config information was changed to use defflag in 435 the various "files" files. Bug fixes to config(8) are 436 required in order for this to work properly. Make sure 437 to build and install in usr.sbin/config before attempting 438 to build a new kernel. 439 44020011030: 441 libc/locale/wcstod.c now needs new lint(1). Update lint(1) 442 before building libc. 443 44420011029: 445 The new document BUILDING.mdoc (view with nroff | more, or 446 see pre-generated .txt and .html versions) describes the build 447 procedure in great detail. BUILDING, and the USE_NEW_TOOLCHAIN 448 build process, are intended in the long run to replace this 449 manual update log. 450 451 Users building a USE_NEW_TOOLCHAIN system should read the 452 BUILDING document for caveats. Generally, BUILDING supersedes 453 UPDATING for these systems, as tool updating is taken care of 454 by the new build system. 455 45620011028: 457 src/etc/Makefile now needs install to be able to handle 458 symlinks that point to nowhere. A bug in install that 459 prevented this was corrected. 460 461 Solution: update and reinstall usr.bin/xinstall 462 Better Solution: Use the new toolchain and it will just work 463 for you. 464 46520011006: 466 /etc/mtree/NetBSD.dist has been updated to take advantage of 467 absolute path support added to mtree(8). Older mtree(8)s don't 468 understand the format. 469 470 Solution: update and reinstall usr.sbin/mtree 471 47220011004: 473 Crunchgen has been updated to work via reach-over makefiles. Updating 474 is suggested before running a snapshot build 475 47620010915: 477 The new "ubcperf" code committed by Chuck Silvers removed 478 a header file, uvm/uvm_vnode.h. There may be stale .depend 479 files that still reference this file. 480 481 Solution: "make cleandir && make dependall" in affected 482 directories. 483 48420010803: 485 grep.info is now built from grep.texi using makeinfo. Since it 486 requires makeinfo v4.0, you need to install new texinfo before 487 building gnu/usr.bin/grep. To install new texinfo, please follow 488 the instruction described in 20010726 entry. 489 49020010803: 491 (i386 only): i386 kernel now uses new instructions like 492 `fxsave' which old gas doesn't understand. To build the 493 kernel successfully, you need to build and install a new toolchain, 494 (i.e., build.sh -t) or (temporarily) comment out "options I686_CPU" 495 from your kernel configuration until you rebuild your userland. 496 See 20011029 above and BUILDING file in this directory for more information. 497 [updated 20020630 since i386 gas moved when USE_NEW_TOOLCHAIN enabled] 498 49920010731: 500 Bootloader update on ELF platforms. DDB in kernels from before 501 this will be unable to read symbol tables provided by newer 502 bootloaders. 503 50420010726: 505 Texinfo was updated to 4.0. To avoid failures when trying to 506 build the included texinfo files, do: 507 508 cd src/gnu/usr.bin/texinfo 509 make MKINFO=no dependall install 510 51120010718: 512 Enabled correct .init/.fini processing in crt0. The way this 513 was done was to change a -I directive to cc(1), which means 514 make(1) will have a stale dependency (it will be checking the 515 timestamp on the wrong "dot_init.h"). 516 517 The symptom you will see is that new programs die with SIGSEGV 518 if you have a stale dependency. 519 520 Solution: "make cleandir" in both lib/csu and libexec/ld.elf_so 521 before starting your build. 522 52320010628: 524 A construct was added to uvm_page.h that uncovered a bug 525 in lint(1). If you get a warning/error about a non-portable 526 bitfield, update your lint(1) before proceeding. 527 52820010226: 529 Added named user/group to system. Need to hand add this in or builds 530 will break as mtree aborts early. 531 532 To work around add by hand: 533 534 named:*:14: 535 536 to /etc/group and add: 537 538 named:*:14:14::0:0:Named pseudo-user:/var/named:/sbin/nologin 539 540 to master.passwd (use vipw for instance if doing by hand). 541 542 Now a make build should progress. 543 54420010219: 545 get/setprogname() added. Any hostprogs that may use this will need 546 to be bootstrapped manually until the host system is current. 547 548 Known problems: sys/arch/macppc/stand/fixcoff 549 usr.sbin/config (adding -DMAKE_BOOTSTRAP to 550 CFLAGS and rebuilding should work) 551 usr.sbin/mdsetimage - Build a static copy if 552 building a snapshot before fully bootstrapped. 553 55420010204: 555 prepare the code to compile with stricter gcc flags. in 556 particular start eliminating redundant declarations. Yacc 557 needs to be installed before make build. 558 55920010114: 560 introduce .if commands(target) in make(1). You need to 561 bring everything up-to-date first, then without installing 562 anything make and install in usr.bin/make, then proceed 563 with make build. 564 56520010101: 566 bsd.subdir.mk committed 20001230 had a bug which caused 567 afterinstall targets to run too soon; update again. 568 56920001230: 570 New share/mk files needed to support .WAIT in SUBDIR variables. 571 If you get make errors, 572 (cd share/mk; make install) 573 Also, PRINTOBJDIR has changed and is now used more heavily. 574 57520001019: 576 The `ca' device driver has been replaced by `ld'; although the 577 major and minor numbers haven't changed, you should update your /dev 578 directory. 579 58020000929: 581 The following make directives are obsoleted. 582 MKCRYPTO_RSA NOCRYPTO_RSA NOCRYPTO_RC5 NOCRYPTO_IDEA 583 By default, RSA is built into libcrypto. IDEA and RC5 will not be 584 built into libcrypto. By using MKCRYPTO_{RC5,IDEA}, you can build 585 additional library libcrypto_{idea,rc5}. 586 587 588Hints for a more successful build: 589^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 590 Build a new kernel first: 591 This makes sure that any new system calls or features 592 expected by the new userland will be present. This 593 helps to avoid critical errors when upgrading. 594 Use object directories: 595 This helps to keep stale object 596 files from polluting the build if a Makefile "forgets" 597 about one. It also makes it easier to clean up after 598 a build. It's also necessary if you want to use the 599 same source tree for multiple machines. 600 To use object directories: 601 a) cd /usr/src ; make cleandir 602 b) Add "OBJMACHINE=yes" to /etc/mk.conf 603 c) Add "MKOBJDIRS=yes" to /etc/mk.conf 604 d) cd /usr/src ; make build 605 Note that running "make obj" in a directory will create 606 in obj.$MACHINE directory. 607 Build to a DESTDIR: 608 This helps to keep old 609 installed files (especially libraries) from interfering 610 with the new build. 611 To build to a DESTDIR, set the DESTDIR environment 612 variable before running make build. It should be set to 613 the pathname of an initially empty directory. 614 Problems: you might need to update critical utilities 615 without using DESTDIR since nothing is executed 616 from what is installed in DESTDIR. 617 (See critical utils, below) 618 Build often: 619 This keeps critical utilities current enough to not choke 620 on any other part of the source tree that depends on up to 621 date functionality. 622 623What to do if things don't work: 624^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 625When things don't work there is usually a few things that commonly 626should be done. 627 1) make includes 628 This should be done automatically by make build. 629 2) cd share/mk && make install 630 Again, automatically done by make build. 631 632Failsafe rebuild of a small part of the tree: 633^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 634To make sure you rebuild something correctly you want to do 635something like the following: 636 1) Make sure the includes and .mk files are up to date. 637 2) Make sure any program used to build the particular 638 utility is up to date. (yacc, lex, etc...) 639 3) cd ...path/to/util... 640 make cleandir 641 rm ...all obj directories... 642 make cleandir # yes, again 643 make obj 644 make depend && make 645 646Failsafe rebuild of the entire tree: 647^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 648If you really want to make sure the source tree is clean and 649ready for a build try the following. Note that sourcing /etc/mk.conf 650(a make(1) Makefile) in this manner is not right, and will not work 651for anyone who uses any make(1) features in /etc/mk.conf. 652 653---cut here--- 654#!/bin/sh 655. /etc/mk.conf 656 657if [ -z $NETBSDSRCDIR ] ; then 658 NETBSDSRCDIR=/usr/src 659fi 660if [ \! -d $NETBSDSRCDIR ] ; then 661 echo Unable to find sources 662 exit 1 663fi 664find $NETBSDSRCDIR -name \*.o -o -name obj.\* -o -name obj -exec rm \{\} \; 665 666if [ -z $BSDOBJDIR ] ; then 667 BSDOBJDIR=/usr/obj 668fi 669if [ -d $BSDOBJDIR ] ; then 670 rm -rf $BSDOBJDIR 671fi 672 673cd $NETBSDSRCDIR && make cleandir 674 675---cut here--- 676 677Critical utilities: 678^^^^^^^^^^^^^^^^^^^ 679 gnu/usr.bin/egcs 680 usr.bin/compile_et 681 usr.bin/make 682 usr.bin/yacc 683 usr.bin/lex 684 usr.bin/xlint 685 usr.sbin/config 686 687Other problems and possible solutions: 688^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ 689Symptom:Unreasonable compiler errors. 690Fix: Rebuild gnu/usr.bin/egcs 691 692Symptom:Complaints involving a Makefile. 693Fix: Rebuild usr.bin/make: 694 cd usr.bin/make && make && make install 695 Or, a failsafe method if that doesn't work: 696 cd usr.bin/make && cc *.c */*.c -I . -o make && mv make /usr/bin 697 698Fix: Make sure .mk files are up to date. 699 cd share/mk && make install 700 701Symptom:Kernel `config' fails to configure any kernel, including GENERIC. 702Fix: Rebuild usr.sbin/config 703 704Symptom: 705Fix: Rebuild usr.bin/yacc 706 707Symptom: 708Fix: Rebuild usr.bin/lex 709 710Symptom: 711Fix: rm /usr/lib/libbfd.a 712 713Symptom:Obsolete intermediate files are used during compilation 714Fix: Try the following sequence of commands in the directory in question. 715 make cleandir; rm `make print-objdir`; make cleandir; make obj 716 (If you built the tree without "make obj" in the past, obsolete files 717 may remain. The command tries to clean everything up) 718 719Symptom:.../sysinst/run.c:xx: warning: initialization from incompatible pointer type 720Fix: Rebuild and install usr.bin/menuc 721 722Symptom:mklocale not found during build in share/locale/ctype 723Fix: Build and install usr.bin/mklocale 724 725Symptom:undefined reference to `__assert13' or `__unsetenv13' 726Fix: Rebuild and install lib/libc 727 728Symptom:usr.sbin/config fails to build. 729Fix: Try building with -DMAKE_BOOTSTRAP added to CFLAGS in Makefile. 730 731Symptom:undefined reference to `getprogname' or `setprogname' 732Fix: Rebuild and install lib/libc 733 734Symptom:lint does not understand the '-X' option 735Fix: May need to build & install libs with NOLINT=1 before rebuilding lint 736