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