UPDATING revision 64519
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 820000810: 9 suidperl (aka sperl) is no longer build by default. You must 10 specifically define BUILD_SUIDPERL to "true" for it to be build. 11 Furthermore, we recommend that you remove /usr/bin/sperl* and 12 /usr/bin/suidperl files from your system unless you have a 13 specific use for it. 14 1520000729: 16 Networking defaults have been tightened. Anybody upgrading 17 /etc/defaults/rc.conf needs to add the following lines to 18 /etc/rc.conf if they want to have the same setup 19 afterwards (unless the variables already are set, of course): 20 # Enable network daemons for user convenience. 21 inetd_enable="YES" 22 portmap_enable="YES" 23 sendmail_enable="YES" 24 2520000728: 26 If you have null_load="YES" in your /boot/loader.conf, you 27 will need to change that to nullfs_load="YES". 28 2920000728: 30 The "installkernel" target has changed slightly. Now even if 31 you override KERNEL e.g. 'make installkernel KERNEL=MYKERNEL' 32 it will install the MYKERNEL file (built with the buildkernel 33 target) as /kernel rather than /MYKERNEL. Those who have 34 updated their /boot/loader.conf files to point to /MYKERNEL 35 should remove that entry or perform manual rename of /kernel 36 to /MYKERNEL. 37 3820000711: 39 If you use CVSUP or CTM to get CVS trees, AND you used to get 40 the old crypto files from internat.freebsd.org AND you check 41 out files from the CVS tree with the cvs command, please read 42 http://people.freebsd.org/~imp/internat.txt 43 for details on potential problems that you might have and how 44 to get around them. 45 46 If you are merely a mirror, or don't answer yes to each of the 47 clauses above, you needn't worry. 48 4920000711: 50 /etc/security has been updated to print the inode number of 51 setuid programs that have changed. You will see a large spike 52 in the number of changed programs the first time when you run 53 mergemaster to get a new /etc/security. 54 5520000710: 56 /dev/random now has good entropy collection (from the keyboard 57 and sysmouse drivers). Please ensure that either `options 58 RANDOMDEV' is present in your kernel config file or that 59 `randomdev_load="YES"' is in your /boot/loader.conf. If you do 60 not have the /dev/random driver, OpenSSL (and consequently 61 lots of crypto tools (like SSH)) will fail with strange 62 errors. (see below, 20000624). 63 64 FreeBSD-current is safe again to run Crypto. 65 6620000709: 67 phk made the malloc default options AJ. This may slow things 68 down and uncover other latent bugs in the code. If you need to 69 run at full speed, you can disable this by doing the following: 70 ln -s aj /etc/malloc.conf 71 7220000706: 73 libftpio's version was accidentally bumped a few days ago. This 74 has been corrected. You may need to remove /usr/lib/libftpio.so.6 75 before doing your next buildworld/installworld pair. It certainly 76 won't hurt to remove it before the update proceedure. It will 77 break fetch until a new one is built, but ftp can be used in the 78 interrum if needed. 79 8020000705: 81 The crypto packages have changed for the cvsup. This has been done 82 in a backward compatible way, but the old packages will go away at 83 some point in the future. Look at /usr/share/examples/cvsup for 84 details. 85 8620000704: 87 With the new sys/modules/sound/drivers/*, you will need to 88 set SYSDIR until you do an installworld after July 7th. 89 9020000704: 91 rc.shutdown and rc will now call the rc.d scripts with start 92 or stop. This may cause some harmless warnings from older 93 rc.d scripts that haven't been updated. 94 9520000630: 96 The libfetch based version of fetch has gone into the tree. 97 Minor problems may result on some of the less popular sites, 98 which should be reported to des@freebsd.org. 99 10020000625: 101 From approximately this date forward, one must have the crypto 102 system installed in order to build the system and kernel. 103 While not technically strictly true, one should treat it as 104 required and grab the crypto bits. If you are grabbing CVS 105 trees, src-all and cvs-crypto should be treated as if they 106 were required. You should check with the latest collections 107 to make sure that these haven't changed. 108 10920000624: 110 Mark Murray just committed the first parts of a cleanup of 111 /dev/zero, et al. This is also cleaning up /dev/random. 112 The entropy is disconnected, so DO NOT USE VERSIONS OF FREEBSD 113 -CURRENT FROM THIS POINT FORWARD for cryptographic services 114 until Mark can merge in the fixes to this work in progress. 115 openssh and openssl should not be used to generate keys from this 116 date to the completion of the work. 117 118 If you must operate at this reduced level of security, add ' 119 options RANDOMDEV' to your kernel or modload the randomdev 120 module. You may also need to copy a new MAKEDEV to /dev and 121 recreate the random and urandom devices. 122 12320000622: 124 The license on the softupdates is now a standard 2 clause 125 BSD license. You may need to remove your symbolic links 126 that used to be required when updating. 127 12820000621: 129 Scott Flatman <sf@aracnet.com> sent in a decent writeup on 130 the config file update procedure. 131 http://people.freebsd.org/~imp/config-upd.html 132 NOTE: LINT is gone. It has been replaced with NOTES. NOTES 133 isn't buildable. 134 13520000620: 136 Binutils 2.10 have hit the tree, or will shortly. As soon 137 as they do, the problem noted in 20000522 will be resolved and 138 that workaround will no longer be required. 139 14020000615: 141 phk removed the compatibility creation of wd devices in the 142 ad driver. If you haven't done so already, you must update 143 your fstab, etc to use the ad devices instead of the wd 144 devices. 145 146 In addition, you'll need to update your boot blocks to a 147 more modern version, if you haven't already done so. Modern 148 here means 4.0 release or newer (although older releases 149 may work). 150 15120000612: 152 Peter took an axe to config(8). Besure that you read his mail 153 on the topic before even thinking about updating. You will 154 need to create a /boot/device.hints or add a hints directive 155 to your config file to compile them in statically. The format 156 of the config file has changed as well. Please see GENERIC or 157 NEWCARD for examples of the new format. 158 15920000522: 160 A new set of binutils went into the tree today. Anybody 161 building a kernel after this point is advised that they need 162 to rebuild their binutils (or better yet do a 163 buildworld/installworld) before building a new kernel. 164 165 Due to bugs in binutils, using malloc options (eg /etc/malloc.conf 166 or MALLOC_OPTIONS env var) J will cause ld to dump core. It 167 is recommended that you don't set this option until the problem 168 is resolved. 169 17020000513: 171 The ethernet drivers were all updated to clean up the BPF handling. 172 17320000510: 174 The problems with boot blocks on the alphas have been corrected. 175 This will require some care in updating alphas. A new libstand 176 is requires for the boot blocks to build properly. 177 17820000503: 179 Recompile all kld modules. Proper version dependency info 180 is now available. 181 18220000502: 183 Modules have been disconnected from the buildworld tree and 184 connected to the kernel building instead. 185 1862000427: 187 You may need to build gperf 188 cd /usr/src/gnu/usr.bin/gperf && make depend all install 189 when upgrading from 4.0 -> current. The build system now uses 190 an option only in -current. 191 19220000417: 193 The method that we brand ELF binaries has changed to be more 194 acceptible to the binutils maintainers. You will need to 195 rebrand your ELF binaries that aren't native. One problem 196 binary is the Linux ldconfig. After your make world, but 197 before you reboot, you'll neeed to issue: 198 brandelf -t Linux /compat/linux/sbin/ldconfig 199 if you have Linux compatibility enabled on your machine. 200 20120000320: 202 If you have really bad/marginal IDE drives, you may find they 203 don't work well. Use pio mode instead. The easiest way to 204 cope if you have a problem combination is to add: 205 /sbin/sysctl -w hw.atamodes=pio,pio,pio,pio 206 to the start of /etc/rc.conf. 207 20820000319: 209 The ISA and PCI compatability shims have been connected to the 210 options COMPAT_OLDISA and COMPAT_OLDPCI. If you are using old 211 style PCI or ISA drivers (i.e. tx, voxware, etc.) you must 212 include the appropriate option in your kernel config. Drivers 213 using the shims should be updated or they won't ship with 214 5.0-RELEASE, targeted for 2001. 215 21620000318: 217 We've entered the tradtional post release dumping party. 218 Large kernel changes are being committed and are in the 219 works. It is important to keep the systems' klds and kernel 220 in sync as kernel interfaces and structures are changing. 221 Before reporting kernel panics, make sure that all modules 222 that you are loading are up to date. 223 22420000315: 225 If you are upgrading from an older version of FreeBSD, you 226 need to update your boot blocks as well. 'disklabel -B ad0' 227 will do the trick. This isn't critical until you remove your 228 wd device entries in /dev, at which point your system will not 229 boot. 230 23120000315: 232 4.0 RELEASE shipped. Please see the 4.0 UPDATING file for how 233 to upgrade to 4.0 from 3.x. 234 235COMMON ITEMS: 236 237 To build a kernel 238 ----------------- 239 If you are updating from a prior version of FreeBSD (even one just 240 a few days old), you should follow this proceedure. With a 241 /usr/obj tree with a fresh buildworld, 242 make buildkernel KERNEL=YOUR_KERNEL_HERE 243 make installkernel KERNEL=YOUR_KERNEL_HERE 244 245 To just build a kernel when you know that it won't mess you up 246 -------------------------------------------------------------- 247 cd src/sys/{i386,alpha}/conf 248 config KERNEL_NAME_HERE [1] 249 cd ../../compile/KERNEL_NAME_HERE 250 make depend 251 make 252 make install 253 254 [1] If in doubt, -r might help here. 255 256 If this fails, go to the "To build a kernel" section. 257 258 To rebuild everything and install it on the current system. 259 ----------------------------------------------------------- 260 make world 261 262 To upgrade from 4.x-stable to current 263 ------------------------------------- 264 make buildworld 265 make buildkernel KERNEL=YOUR_KERNEL_HERE 266 make installkernel KERNEL=YOUR_KERNEL_HERE 267 make installworld 268 [1] 269 <reboot> 270 271 Make sure that you've read the UPDATING file to understand 272 the tweaks to various things you need. At this point in the 273 life cycloe of current, things change often and you are on 274 your own to cope. 275 276 Also, if you are tracking -current, you must be subscribed to 277 freebsd-current@freebsd.org. Make sure that before you update 278 your sources that you have read and understood all the recent 279 messages there. If in doubt, please track -stable which has 280 much fewer pitfalls. 281 282 [1] If you have third party modules, such as vmware, you 283 should disable them at this point so they don't crash your 284 system on reboot. 285 286FORMAT: 287 288This file contains a list, in reverse chronologocal order, of major 289breakages in tracking -current. Not all things will be listed here, 290and it only starts on March 15, 2000. Updating files can found in 291previous releases if your system is older than this. 292 293Please filter your entries through Warner Losh (imp@village.org) so 294that the style, formatting, etc of this file can be maintained. 295 296$FreeBSD: head/UPDATING 64519 2000-08-10 23:16:32Z imp $ 297