UPDATING revision 63924
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 820000711: 9 If you use CVSUP or CTM to get CVS trees, AND you used to get 10 the old crypto files from internat.freebsd.org AND you check 11 out files from the CVS tree with the cvs command, please read 12 http://people.freebsd.org/~imp/internat.txt 13 for details on potential problems that you might have and how 14 to get around them. 15 16 If you are merely a mirror, or don't answer yes to each of the 17 clauses above, you needn't worry. 18 1920000711: 20 /etc/security has been updated to print the inode number of 21 setuid programs that have changed. You will see a large spike 22 in the number of changed programs the first time when you run 23 mergemaster to get a new /etc/security. 24 2520000710: 26 /dev/random now has good entropy collection (from the keyboard 27 and sysmouse drivers). Please ensure that either `options 28 RANDOMDEV' is present in your kernel config file or that 29 `randomdev_load="YES"' is in your /boot/loader.conf. If you do 30 not have the /dev/random driver, OpenSSL (and consequently 31 lots of crypto tools (like SSH)) will fail with strange 32 errors. (see below, 20000624). 33 3420000709: 35 phk made the malloc default options AJ. This may slow things 36 down and uncover other latent bugs in the code. If you need to 37 run at full speed, you can disable this by doing the following: 38 ln -s aj /etc/malloc.conf 39 4020000706: 41 libftpio's version was accidentally bumped a few days ago. This 42 has been corrected. You may need to remove /usr/lib/libftpio.so.6 43 before doing your next buildworld/installworld pair. It certainly 44 won't hurt to remove it before the update proceedure. It will 45 break fetch until a new one is built, but ftp can be used in the 46 interrum if needed. 47 4820000705: 49 The crypto packages have changed for the cvsup. This has been done 50 in a backward compatible way, but the old packages will go away at 51 some point in the future. Look at /usr/share/examples/cvsup for 52 details. 53 5420000704: 55 With the new sys/modules/sound/drivers/*, you will need to 56 set SYSDIR until you do an installworld after July 7th. 57 5820000704: 59 rc.shutdown and rc will now call the rc.d scripts with start 60 or stop. This may cause some harmless warnings from older 61 rc.d scripts that haven't been updated. 62 6320000630: 64 The libfetch based version of fetch has gone into the tree. 65 Minor problems may result on some of the less popular sites, 66 which should be reported to des@freebsd.org. 67 6820000625: 69 From approximately this date forward, one must have the crypto 70 system installed in order to build the system and kernel. 71 While not technically strictly true, one should treat it as 72 required and grab the crypto bits. If you are grabbing CVS 73 trees, src-all and cvs-crypto should be treated as if they 74 were required. You should check with the latest collections 75 to make sure that these haven't changed. 76 7720000624: 78 Mark Murray just committed the first parts of a cleanup of 79 /dev/zero, et al. This is also cleaning up /dev/random. 80 The entropy is disconnected, so DO NOT USE VERSIONS OF FREEBSD 81 -CURRENT FROM THIS POINT FORWARD for cryptographic services 82 until Mark can merge in the fixes to this work in progress. 83 openssh and openssl should not be used to generate keys from this 84 date to the completion of the work. 85 86 If you must operate at this reduced level of security, add ' 87 options RANDOMDEV' to your kernel or modload the randomdev 88 module. You may also need to copy a new MAKEDEV to /dev and 89 recreate the random and urandom devices. 90 9120000622: 92 The license on the softupdates is now a standard 2 clause 93 BSD license. You may need to remove your symbolic links 94 that used to be required when updating. 95 9620000621: 97 Scott Flatman <sf@aracnet.com> sent in a decent writeup on 98 the config file update procedure. 99 http://people.freebsd.org/~imp/config-upd.html 100 NOTE: LINT is gone. It has been replaced with NOTES. NOTES 101 isn't buildable. 102 10320000620: 104 Binutils 2.10 have hit the tree, or will shortly. As soon 105 as they do, the problem noted in 20000522 will be resolved and 106 that workaround will no longer be required. 107 10820000615: 109 phk removed the compatibility creation of wd devices in the 110 ad driver. If you haven't done so already, you must update 111 your fstab, etc to use the ad devices instead of the wd 112 devices. 113 114 In addition, you'll need to update your boot blocks to a 115 more modern version, if you haven't already done so. Modern 116 here means 4.0 release or newer (although older releases 117 may work). 118 11920000612: 120 Peter took an axe to config(8). Besure that you read his mail 121 on the topic before even thinking about updating. You will 122 need to create a /boot/device.hints or add a hints directive 123 to your config file to compile them in statically. The format 124 of the config file has changed as well. Please see GENERIC or 125 NEWCARD for examples of the new format. 126 12720000522: 128 A new set of binutils went into the tree today. Anybody 129 building a kernel after this point is advised that they need 130 to rebuild their binutils (or better yet do a 131 buildworld/installworld) before building a new kernel. 132 133 Due to bugs in binutils, using malloc options (eg /etc/malloc.conf 134 or MALLOC_OPTIONS env var) J will cause ld to dump core. It 135 is recommended that you don't set this option until the problem 136 is resolved. 137 13820000513: 139 The ethernet drivers were all updated to clean up the BPF handling. 140 14120000510: 142 The problems with boot blocks on the alphas have been corrected. 143 This will require some care in updating alphas. A new libstand 144 is requires for the boot blocks to build properly. 145 14620000503: 147 Recompile all kld modules. Proper version dependency info 148 is now available. 149 15020000502: 151 Modules have been disconnected from the buildworld tree and 152 connected to the kernel building instead. 153 1542000427: 155 You may need to build gperf 156 cd /usr/src/gnu/usr.bin/gperf && make depend all install 157 when upgrading from 4.0 -> current. The build system now uses 158 an option only in -current. 159 16020000417: 161 The method that we brand ELF binaries has changed to be more 162 acceptible to the binutils maintainers. You will need to 163 rebrand your ELF binaries that aren't native. One problem 164 binary is the Linux ldconfig. After your make world, but 165 before you reboot, you'll neeed to issue: 166 brandelf -t Linux /compat/linux/sbin/ldconfig 167 if you have Linux compatibility enabled on your machine. 168 16920000320: 170 If you have really bad/marginal IDE drives, you may find they 171 don't work well. Use pio mode instead. The easiest way to 172 cope if you have a problem combination is to add: 173 /sbin/sysctl -w hw.atamodes=pio,pio,pio,pio 174 to the start of /etc/rc.conf. 175 17620000319: 177 The ISA and PCI compatability shims have been connected to the 178 options COMPAT_OLDISA and COMPAT_OLDPCI. If you are using old 179 style PCI or ISA drivers (i.e. tx, voxware, etc.) you must 180 include the appropriate option in your kernel config. Drivers 181 using the shims should be updated or they won't ship with 182 5.0-RELEASE, targeted for 2001. 183 18420000318: 185 We've entered the tradtional post release dumping party. 186 Large kernel changes are being committed and are in the 187 works. It is important to keep the systems' klds and kernel 188 in sync as kernel interfaces and structures are changing. 189 Before reporting kernel panics, make sure that all modules 190 that you are loading are up to date. 191 19220000315: 193 If you are upgrading from an older version of FreeBSD, you 194 need to update your boot blocks as well. 'disklabel -B ad0' 195 will do the trick. This isn't critical until you remove your 196 wd device entries in /dev, at which point your system will not 197 boot. 198 19920000315: 200 4.0 RELEASE shipped. Please see the 4.0 UPDATING file for how 201 to upgrade to 4.0 from 3.x. 202 203COMMON ITEMS: 204 205 To build a kernel 206 ----------------- 207 Update config, genassym and go: 208 config YOUR_KERNEL_HERE [1] 209 cd ../../compile/YOUR_KERNEL_HERE 210 make depend && make 211 make install 212 [1] If upgrading, add -r won't hurt and sometimes helps. 213 214 To rebuild everything 215 --------------------- 216 make world 217 218 To upgrade from 4.0-stable to current 219 ------------------------------------- 220 make buildworld 221 make buildkernel KERNEL=YOUR_KERNEL_HERE 222 make installkernel KERNEL=YOUR_KERNEL_HERE 223 make installworld 224 <reboot> 225 226 Make sure that you've read the UPDATING file to understand 227 the tweaks to various things you need. At this point in the 228 life cycloe of current, things change often and you are on 229 your own to cope. 230 231FORMAT: 232 233This file contains a list, in reverse chronologocal order, of major 234breakages in tracking -current. Not all things will be listed here, 235and it only starts on March 15, 2000. Updating files can found in 236previous releases if your system is older than this. 237 238Please filter your entries through Warner Losh (imp@village.org) so 239that the style, formatting, etc of this file can be maintained. 240 241$FreeBSD: head/UPDATING 63924 2000-07-27 20:49:24Z imp $ 242