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