top(1): Fix building with -fno-common.
[dragonfly.git] / Makefile
1 #
2 # $FreeBSD: src/Makefile,v 1.234.2.19 2003/04/16 09:59:40 ru Exp $
3 #
4 # The user-driven targets are:
5 #
6 # buildworld          - Rebuild *everything* but the kernel, including glue to
7 #                       help do upgrades.
8 # quickworld          - Skip bootstrap, build and cross-build tool steps.
9 # realquickworld      - Skip above steps, plus depend.
10 # crossworld          - Just do the bootstrap, build, and cross-build steps.
11 # installworld        - Install everything built by "buildworld", and the
12 #                       rescue tools and initrd image if they do not exist.
13 # installworld-force  - Install everything built by "buildworld";
14 #                       special case for old systems.
15 # world               - buildworld + installworld.
16 # buildkernel         - Rebuild the kernel and the kernel-modules from scratch
17 #                       using build/bootstrap/cross tools from the last
18 #                       buildworld.
19 # nativekernel        - Rebuild the kernel and the kernel-modules from scratch
20 #                       using native tools.
21 # quickkernel         - Rebuild the kernel quickly (build or native), and do
22 #                       not clean out the obj modules.
23 # realquickkernel     - Like quickkernel, but skips depend too.
24 # installkernel       - Install the kernel and the kernel-modules.
25 # reinstallkernel     - Reinstall the kernel and the kernel-modules.
26 # kernel              - buildkernel + installkernel.
27 # preupgrade          - Do certain upgrades (typically the addition of new
28 #                       users and groups used by installed utilities) before
29 #                       the installworld.
30 # upgrade             - Upgrade the files in /etc and also setup the rest
31 #                       of the system for DragonFly. ex. two compilers.
32 # build-all           - Runs buildworld and buildkernel both with -j hw.ncpu
33 # install-all         - Runs installkernel, installworld and upgrade all with
34 #                       -j 1
35 # initrd              - Install the statically linked rescue tools and the
36 #                       initrd image built by "buildworld".
37 # backupworld         - Copy /bin /sbin /usr/bin /usr/sbin /usr/lib
38 #                       /usr/libexec to manual backup dir.
39 # restoreworld        - Install binaries from manual backup dir to world.
40 # restoreworld-auto   - Install binaries from auto-backup dir to world;
41 #                       installworld target makes backup to auto-backup dir.
42 # backup-auto-clean   - Delete backup from auto-backup dir.
43 # backup-clean        - Delete backup from manual backup dir.
44 #
45 # This makefile is simple by design. The DragonFly make automatically reads
46 # /usr/share/mk/sys.mk unless the -m argument is specified on the
47 # command line. By keeping this makefile simple, it doesn't matter too
48 # much how different the installed mk files are from those in the source
49 # tree. This makefile executes a child make process, forcing it to use
50 # the mk files from the source tree which are supposed to DTRT.
51 #
52 # Most of the user-driven targets (as listed above) are implemented in
53 # Makefile.inc1.
54 #
55 # For individuals wanting to build from the sources currently on their
56 # system, the simple instructions are:
57 #
58 # 1.  `cd /usr/src'  (or to the directory containing your source tree).
59 # 2.  `make world'
60 #
61 # For individuals wanting to upgrade their sources (even if only a
62 # delta of a few days):
63 #
64 # 1.  `cd /usr/src'       (or to the directory containing your source tree).
65 # 2.  `make buildworld'
66 # 3.  `make buildkernel KERNCONF=YOUR_KERNEL_HERE'   (default X86_64_GENERIC).
67 # 4.  `make installkernel KERNCONF=YOUR_KERNEL_HERE' (default X86_64_GENERIC).
68 # 5.  `make installworld'
69 # 6.  `make upgrade'
70 # 7.  `reboot'
71 # 8.  `make initrd'  (after making sure that the new world works well).
72 #
73 # If TARGET_ARCH=arch (e.g. x86_64) is specified you can
74 # cross build world for other architectures using the buildworld target,
75 # and once the world is built you can cross build a kernel using the
76 # buildkernel target.
77 #
78 # For more information, see the build(7) manual page.
79 #
80
81 TGTS=   all all-man buildkernel quickkernel realquickkernel nativekernel \
82         buildworld crossworld quickworld realquickworld checkdpadd clean \
83         cleandepend cleandir depend everything \
84         hierarchy install installcheck installkernel \
85         reinstallkernel installworld installworld-force os-release initrd \
86         libraries lint maninstall \
87         manlint mk obj objlink regress rerelease tags \
88         backupworld restoreworld restoreworld-auto \
89         build-all install-all \
90         backup-clean backup-auto-clean \
91         _obj _includes _libraries _depend _worldtmp \
92         _bootstrap-tools _build-tools _cross-tools
93 #TGTS+= mandiff # XXX temporary target
94
95 BITGTS= files includes
96 BITGTS:=${BITGTS} ${BITGTS:S/^/build/} ${BITGTS:S/^/install/}
97
98 .ORDER: buildworld installworld
99 .ORDER: buildworld buildkernel
100 .ORDER: buildworld nativekernel
101 .ORDER: buildworld quickkernel
102 .ORDER: buildworld realquickkernel
103 .ORDER: buildkernel installkernel
104 .ORDER: buildkernel reinstallkernel
105 .ORDER: quickworld installworld
106 .ORDER: quickworld buildkernel
107 .ORDER: quickworld nativekernel
108 .ORDER: quickworld quickkernel
109 .ORDER: quickworld realquickkernel
110 .ORDER: quickkernel installkernel
111 .ORDER: quickkernel reinstallkernel
112 .ORDER: realquickkernel installkernel
113 .ORDER: realquickkernel reinstallkernel
114 .ORDER: build-all install-all
115
116 _HOSTPATH=      /sbin:/bin:/usr/sbin:/usr/bin:/usr/local/bin:/usr/pkg/bin
117 MAKE=   PATH=${_HOSTPATH} make -m ${.CURDIR}/share/mk -f Makefile.inc1
118
119 #
120 # Handle the user-driven targets, using the source relative mk files.
121 #
122 ${TGTS} ${BITGTS}: .PHONY
123         @cd ${.CURDIR}; \
124                 ${MAKE} ${.TARGET}
125
126 # Fail with an error when no target is given.
127 .MAIN: _guard
128
129 _guard: .PHONY
130         @echo
131         @echo "Explicit target required.  See build(7)."
132         @echo
133         @false
134
135 STARTTIME!= LC_ALL=C date
136
137 #
138 # world
139 #
140 # Attempt to rebuild and reinstall *everything*, with reasonable chance of
141 # success, regardless of how old your existing system is.
142 #
143 world:
144         @echo "--------------------------------------------------------------"
145         @echo ">>> make world started on ${STARTTIME}"
146         @echo "--------------------------------------------------------------"
147 .if target(pre-world)
148         @echo
149         @echo "--------------------------------------------------------------"
150         @echo ">>> starting pre-world target"
151         @echo "--------------------------------------------------------------"
152         @cd ${.CURDIR}; ${MAKE} pre-world
153         @echo "--------------------------------------------------------------"
154         @echo ">>> pre-world target complete"
155         @echo "--------------------------------------------------------------"
156 .endif
157         @cd ${.CURDIR}; ${MAKE} buildworld
158         @cd ${.CURDIR}; ${MAKE} -B installworld
159 .if target(post-world)
160         @echo
161         @echo "--------------------------------------------------------------"
162         @echo ">>> starting post-world target"
163         @echo "--------------------------------------------------------------"
164         @cd ${.CURDIR}; ${MAKE} post-world
165         @echo "--------------------------------------------------------------"
166         @echo ">>> post-world target complete"
167         @echo "--------------------------------------------------------------"
168 .endif
169         @echo
170         @echo "--------------------------------------------------------------"
171         @printf ">>> make world completed on `LC_ALL=C date`\n                        (started ${STARTTIME})\n"
172         @echo "--------------------------------------------------------------"
173
174 # kernel
175 #
176 # Short hand for `make buildkernel installkernel'
177 #
178 kernel: buildkernel installkernel
179
180 #
181 # A simple test target used as part of the test to see if make supports
182 # the -m argument.  Also test that make will only evaluate a conditional
183 # as far as is necessary to determine its value.
184 #
185 test:
186 .if defined(notdef)
187 .undef notdef
188 .if defined(notdef) && ${notdef:tu}
189 .endif
190 .endif
191
192 #
193 # Upgrade the installed make to the current version using the installed
194 # headers, libraries and build tools. This is required on installed versions
195 # prior to 2.2.5 in which the installed make doesn't support the -m argument.
196 #
197 make:
198         @echo
199         @echo "--------------------------------------------------------------"
200         @echo " Upgrading the installed make"
201         @echo "--------------------------------------------------------------"
202         @cd ${.CURDIR}/usr.bin/make; \
203                 make obj && make depend && make all && make install
204
205 #
206 # Handle the upgrade of /etc, post-installworld updating of static files
207 # and removing obsolete files.
208 #
209
210 preupgrade:
211         @cd ${.CURDIR}/etc; make -m ${.CURDIR}/share/mk preupgrade
212
213 upgrade:
214         @cd ${.CURDIR}/etc; make -m ${.CURDIR}/share/mk upgrade_etc
215 .if !defined(NOMAN) && !defined(NO_MAKEDB_RUN)
216         @cd ${.CURDIR}/share/man; make makedb
217 .endif
218         @echo "--------------------------------------------------------------"
219         @echo "Now you can reboot into the new system!  If the new system works as"
220         @echo "expected, consider updating the rescue tools and initrd image with:"
221         @echo "    # cd ${.CURDIR}; make initrd"
222         @echo "NOTE: Do this only after verifying the new system works as expected!"
223         @echo ""
224         @echo "You also need to upgrade the 3rd-party packages with:"
225         @echo "    # pkg update; pkg upgrade [-f]"
226         @echo "--------------------------------------------------------------"