UPDATING revision 62749
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 820000706: 9 libftpio's version was accidentally bumped a few days ago. This 10 has been corrected. You may need to remove /usr/lib/libftpio.so.6 11 before doing your next buildworld/installworld pair. It certainly 12 won't hurt to remove it before the update proceedure. It will 13 break fetch until a new one is built, but ftp can be used in the 14 interrum if needed. 15 1620000705: 17 The crypto packages have changed for the cvsup. This has been done 18 in a backward compatible way, but the old packages will go away at 19 some point in the future. Look at /usr/share/examples/cvsup for 20 details. 21 2220000704: 23 With the new sys/modules/sound/drivers/*, you will need to 24 set SYSDIR until you do an installworld after July 7th. 25 2620000704: 27 rc.shutdown and rc will now call the rc.d scripts with start 28 or stop. This may cause some harmless warnings from older 29 rc.d scripts that haven't been updated. 30 3120000630: 32 The libfetch based version of fetch has gone into the tree. 33 Minor problems may result on some of the less popular sites, 34 which should be reported to des@freebsd.org. 35 3620000625: 37 From approximately this date forward, one must have the crypto 38 system installed in order to build the system and kernel. 39 While not technically strictly true, one should treat it as 40 required and grab the crypto bits. If you are grabbing CVS 41 trees, src-all and cvs-crypto should be treated as if they 42 were required. You should check with the latest collections 43 to make sure that these haven't changed. 44 4520000624: 46 Mark Murray just committed the first parts of a cleanup of 47 /dev/zero, et al. This is also cleaning up /dev/random. 48 The entropy is disconnected, so DO NOT USE VERSIONS OF FREEBSD 49 -CURRENT FROM THIS POINT FORWARD for cryptographic services 50 until Mark can merge in the fixes to this work in progress. 51 openssh and openssl should not be used to generate keys from this 52 date to the completion of the work. 53 54 If you must operate at this reduced level of security, add ' 55 options RANDOMDEV' to your kernel or modload the randomdev 56 module. You may also need to copy a new MAKEDEV to /dev and 57 recreate the random and urandom devices. 58 5920000622: 60 The license on the softupdates is now a standard 2 clause 61 BSD license. You may need to remove your symbolic links 62 that used to be required when updating. 63 6420000621: 65 Scott Flatman <sf@aracnet.com> sent in a decent writeup on 66 the config file update procedure. 67 http://people.freebsd.org/~imp/config-upd.html 68 NOTE: LINT is gone. It has been replaced with NOTES. NOTES 69 isn't buildable. 70 7120000620: 72 Binutils 2.10 have hit the tree, or will shortly. As soon 73 as they do, the problem noted in 20000522 will be resolved and 74 that workaround will no longer be required. 75 7620000615: 77 phk removed the compatibility creation of wd devices in the 78 ad driver. If you haven't done so already, you must update 79 your fstab, etc to use the ad devices instead of the wd 80 devices. 81 82 In addition, you'll need to update your boot blocks to a 83 more modern version, if you haven't already done so. Modern 84 here means 4.0 release or newer (although older releases 85 may work). 86 8720000612: 88 Peter took an axe to config(8). Besure that you read his mail 89 on the topic before even thinking about updating. You will 90 need to create a /boot/devices.hints or add a hints directive 91 to your config file to compile them in statically. The format 92 of the config file has changed as well. Please see LINT, 93 GENERIC or NEWCARD for examples of the new format. 94 9520000522: 96 A new set of binutils went into the tree today. Anybody 97 building a kernel after this point is advised that they need 98 to rebuild their binutils (or better yet do a 99 buildworld/installworld) before building a new kernel. 100 101 Due to bugs in binutils, using malloc options (eg /etc/malloc.conf 102 or MALLOC_OPTIONS env var) J will cause ld to dump core. It 103 is recommended that you don't set this option until the problem 104 is resolved. 105 10620000513: 107 The ethernet drivers were all updated to clean up the BPF handling. 108 10920000510: 110 The problems with boot blocks on the alphas have been corrected. 111 This will require some care in updating alphas. A new libstand 112 is requires for the boot blocks to build properly. 113 11420000503: 115 Recompile all kld modules. Proper version dependency info 116 is now available. 117 11820000502: 119 Modules have been disconnected from the buildworld tree and 120 connected to the kernel building instead. 121 1222000427: 123 You may need to build gperf 124 cd /usr/src/gnu/usr.bin/gperf && make depend all install 125 when upgrading from 4.0 -> current. The build system now uses 126 an option only in -current. 127 12820000417: 129 The method that we brand ELF binaries has changed to be more 130 acceptible to the binutils maintainers. You will need to 131 rebrand your ELF binaries that aren't native. One problem 132 binary is the Linux ldconfig. After your make world, but 133 before you reboot, you'll neeed to issue: 134 brandelf -t Linux /compat/linux/sbin/ldconfig 135 if you have Linux compatibility enabled on your machine. 136 13720000320: 138 If you have really bad/marginal IDE drives, you may find they 139 don't work well. Use pio mode instead. The easiest way to 140 cope if you have a problem combination is to add: 141 /sbin/sysctl -w hw.atamodes=pio,pio,pio,pio 142 to the start of /etc/rc.conf. 143 14420000319: 145 The ISA and PCI compatability shims have been connected to the 146 options COMPAT_OLDISA and COMPAT_OLDPCI. If you are using old 147 style PCI or ISA drivers (i.e. tx, voxware, etc.) you must 148 include the appropriate option in your kernel config. Drivers 149 using the shims should be updated or they won't ship with 150 5.0-RELEASE, targeted for 2001. 151 15220000318: 153 We've entered the tradtional post release dumping party. 154 Large kernel changes are being committed and are in the 155 works. It is important to keep the systems' klds and kernel 156 in sync as kernel interfaces and structures are changing. 157 Before reporting kernel panics, make sure that all modules 158 that you are loading are up to date. 159 16020000315: 161 If you are upgrading from an older version of FreeBSD, you 162 need to update your boot blocks as well. 'disklabel -B ad0' 163 will do the trick. This isn't critical until you remove your 164 wd device entries in /dev, at which point your system will not 165 boot. 166 16720000315: 168 4.0 RELEASE shipped. Please see the 4.0 UPDATING file for how 169 to upgrade to 4.0 from 3.x. 170 171COMMON ITEMS: 172 173 To build a kernel 174 ----------------- 175 Update config, genassym and go: 176 config YOUR_KERNEL_HERE [1] 177 cd ../../compile/YOUR_KERNEL_HERE 178 make depend && make 179 make install 180 [1] If upgrading, add -r won't hurt and sometimes helps. 181 182 To rebuild everything 183 --------------------- 184 make world 185 186 To upgrade from 4.0-stable to current 187 ------------------------------------- 188 make buildworld 189 make buildkernel KERNEL=YOUR_KERNEL_HERE 190 make installkernel KERNEL=YOUR_KERNEL_HERE 191 make installworld 192 <reboot> 193 194 Make sure that you've read the UPDATING file to understand 195 the tweaks to various things you need. At this point in the 196 life cycloe of current, things change often and you are on 197 your own to cope. 198 199FORMAT: 200 201This file contains a list, in reverse chronologocal order, of major 202breakages in tracking -current. Not all things will be listed here, 203and it only starts on March 15, 2000. Updating files can found in 204previous releases if your system is older than this. 205 206Please filter your entries through Warner Losh (imp@village.org) so 207that the style, formatting, etc of this file can be maintained. 208 209$FreeBSD: head/UPDATING 62749 2000-07-07 05:17:49Z imp $ 210