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