xref: /freebsd/Makefile (revision ae83180158c4c937f170e31eff311b18c0286a93)
1#
2# $FreeBSD$
3#
4# The user-driven targets are:
5#
6# buildworld          - Rebuild *everything*, including glue to help do
7#                       upgrades.
8# installworld        - Install everything built by "buildworld".
9# world               - buildworld + installworld.
10# buildkernel         - Rebuild the kernel and the kernel-modules.
11# installkernel       - Install the kernel and the kernel-modules.
12# reinstallkernel     - Reinstall the kernel and the kernel-modules.
13# kernel              - buildkernel + installkernel.
14# update              - Convenient way to update your source tree (cvs).
15# upgrade             - Upgrade a.out (2.2.x/3.0) system to the new ELF way
16# most                - Build user commands, no libraries or include files.
17# installmost         - Install user commands, no libraries or include files.
18# aout-to-elf         - Upgrade an system from a.out to elf format (see below).
19# aout-to-elf-build   - Build everything required to upgrade a system from
20#                       a.out to elf format (see below).
21# aout-to-elf-install - Install everything built by aout-to-elf-build (see
22#                       below).
23# move-aout-libs      - Move the a.out libraries into an aout sub-directory
24#                       of each elf library sub-directory.
25#
26# This makefile is simple by design. The FreeBSD make automatically reads
27# the /usr/share/mk/sys.mk unless the -m argument is specified on the
28# command line. By keeping this makefile simple, it doesn't matter too
29# much how different the installed mk files are from those in the source
30# tree. This makefile executes a child make process, forcing it to use
31# the mk files from the source tree which are supposed to DTRT.
32#
33# The user-driven targets (as listed above) are implemented in Makefile.inc1.
34#
35# If you want to build your system from source be sure that /usr/obj has
36# at least 400MB of diskspace available.
37#
38# For individuals wanting to build from the sources currently on their
39# system, the simple instructions are:
40#
41# 1.  `cd /usr/src'  (or to the directory containing your source tree).
42# 2.  `make world'
43#
44# For individuals wanting to upgrade their sources (even if only a
45# delta of a few days):
46#
47# 1.  `cd /usr/src'       (or to the directory containing your source tree).
48# 2.  `make buildworld'
49# 3.  `make buildkernel KERNCONF=YOUR_KERNEL_HERE'     (default is GENERIC).
50# 4.  `make installkernel KERNCONF=YOUR_KERNEL_HERE'   (default is GENERIC).
51# 5.  `reboot'        (in single user mode: boot -s from the loader prompt).
52# 6.  `mergemaster -p'
53# 7.  `make installworld'
54# 8.  `mergemaster'
55# 9.  `reboot'
56#
57# See src/UPDATING `COMMON ITEMS' for more complete information.
58#
59# If -DWANT_AOUT is specified, a `make world' with OBJFORMAT=elf will
60# update the legacy support for aout. This includes all libraries, ld.so
61# and boot objects. This part of build should be regarded as
62# deprecated and you should _not_ expect to be able to do this past the
63# release of 4.0. You have exactly one major release to move entirely
64# to elf.
65#
66# If TARGET_ARCH=arch (e.g. ia64, sparc64, ...) is specified you can
67# cross build world for other architectures using the buildworld target,
68# and once the world is built you can cross build a kernel using the
69# buildkernel target.
70#
71# ----------------------------------------------------------------------------
72#
73#           Upgrading an i386 system from a.out to elf format
74#
75#
76# The aout->elf transition build is performed by doing a `make upgrade' (or
77# `make aout-to-elf') or in two steps by a `make aout-to-elf-build' followed
78# by a `make aout-to-elf-install', depending on user preference.
79# You need to have at least 320 Mb of free space for the object tree.
80#
81# The upgrade process checks the installed release. If this is 3.0-CURRENT,
82# it is assumed that your kernel contains all the syscalls required by the
83# current sources.
84#
85# The upgrade procedure will stop and ask for confirmation to proceed
86# several times. On each occasion, you can type Ctrl-C to abort the
87# upgrade.  Optionally, you can also start it with NOCONFIRM=yes and skip
88# the confirmation steps.
89#
90# At the end of the upgrade procedure, /etc/objformat is created or
91# updated to contain OBJFORMAT=elf. From then on, you're elf by default.
92#
93# ----------------------------------------------------------------------------
94#
95#
96# Define the user-driven targets. These are listed here in alphabetical
97# order, but that's not important.
98#
99TGTS=	all all-man buildkernel buildworld checkdpadd clean \
100	cleandepend cleandir depend distribute distributeworld everything \
101	hierarchy install installcheck installkernel \
102	reinstallkernel installmost installworld libraries lint maninstall \
103	mk most obj objlink regress rerelease tags update
104
105BITGTS=	files includes
106BITGTS:=${BITGTS} ${BITGTS:S/^/build/} ${BITGTS:S/^/install/}
107
108.ORDER: buildworld installworld
109.ORDER: buildworld distributeworld
110.ORDER: buildkernel installkernel
111.ORDER: buildkernel reinstallkernel
112
113PATH=	/sbin:/bin:/usr/sbin:/usr/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}: upgrade_checks
120	@cd ${.CURDIR}; \
121		${MAKE} ${.TARGET}
122
123# Set a reasonable default
124.MAIN:	all
125
126STARTTIME!= LC_ALL=C date
127#
128# world
129#
130# Attempt to rebuild and reinstall *everything*, with reasonable chance of
131# success, regardless of how old your existing system is.
132#
133world: upgrade_checks
134	@echo "--------------------------------------------------------------"
135	@echo ">>> ${OBJFORMAT} make world started on ${STARTTIME}"
136	@echo "--------------------------------------------------------------"
137.if target(pre-world)
138	@echo
139	@echo "--------------------------------------------------------------"
140	@echo ">>> Making 'pre-world' target"
141	@echo "--------------------------------------------------------------"
142	@cd ${.CURDIR}; ${MAKE} pre-world
143.endif
144	@cd ${.CURDIR}; ${MAKE} buildworld
145	@cd ${.CURDIR}; ${MAKE} -B installworld
146.if target(post-world)
147	@echo
148	@echo "--------------------------------------------------------------"
149	@echo ">>> Making 'post-world' target"
150	@echo "--------------------------------------------------------------"
151	@cd ${.CURDIR}; ${MAKE} post-world
152.endif
153	@echo
154	@echo "--------------------------------------------------------------"
155	@printf ">>> ${OBJFORMAT} make world completed on `LC_ALL=C date`\n                       (started ${STARTTIME})\n"
156	@echo "--------------------------------------------------------------"
157
158#
159# kernel
160#
161# Short hand for `make buildkernel installkernel'
162#
163kernel: buildkernel installkernel
164
165#
166# Perform a few tests to determine if the installed tools are adequate
167# for building the world. These are for older systems (prior to 2.2.5).
168#
169# From 2.2.5 onwards, the installed tools will pass these upgrade tests,
170# so the normal make world is capable of doing what is required to update
171# the system to current.
172#
173upgrade_checks:
174	@cd ${.CURDIR}; \
175	if ! make -m ${.CURDIR}/share/mk -Dnotdef test >/dev/null 2>&1; then \
176		make make; \
177	fi
178	@cd ${.CURDIR}; \
179	if make -V .CURDIR:C/.// 2>&1 >/dev/null | \
180	    grep -q "Unknown modifier 'C'"; then \
181		make make; \
182	fi
183
184#
185# A simple test target used as part of the test to see if make supports
186# the -m argument.  Also test that make will only evaluate a conditional
187# as far as is necessary to determine its value.
188#
189test:
190.if defined(notdef)
191.undef notdef
192.if defined(notdef) && ${notdef:U}
193.endif
194.endif
195
196#
197# Upgrade the installed make to the current version using the installed
198# headers, libraries and build tools. This is required on installed versions
199# prior to 2.2.5 in which the installed make doesn't support the -m argument.
200#
201make:
202	@echo
203	@echo "--------------------------------------------------------------"
204	@echo " Upgrading the installed make"
205	@echo "--------------------------------------------------------------"
206	@cd ${.CURDIR}/usr.bin/make; \
207		make obj && make depend && make all && make install
208
209#
210# Define the upgrade targets. These are listed here in alphabetical
211# order, but that's not important.
212#
213UPGRADE=	aout-to-elf aout-to-elf-build aout-to-elf-install \
214		move-aout-libs
215
216#
217# Handle the upgrade targets, using the source relative mk files.
218#
219
220upgrade:	aout-to-elf
221
222${UPGRADE} : upgrade_checks
223	@cd ${.CURDIR}; \
224		${MAKE} -f Makefile.upgrade -m ${.CURDIR}/share/mk ${.TARGET}
225