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