autofs: Remove BUGS section from autofs(5)
[dragonfly.git] / Makefile
CommitLineData
984263bc
MD
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#
e79a303f
AL
6# buildworld - Rebuild *everything* but the kernel, including glue to
7# help do upgrades.
f71956f7
AL
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.
bc897c50
AL
11# installworld - Install everything built by "buildworld", and the
12# rescue tools and initrd image if they do not exist.
f71956f7
AL
13# installworld-force - Install everything built by "buildworld";
14# special case for old systems.
984263bc 15# world - buildworld + installworld.
fc7aca3e 16# buildkernel - Rebuild the kernel and the kernel-modules from scratch
f71956f7
AL
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.
92c9dfec 23# realquickkernel - Like quickkernel, but skips depend too.
984263bc
MD
24# installkernel - Install the kernel and the kernel-modules.
25# reinstallkernel - Reinstall the kernel and the kernel-modules.
26# kernel - buildkernel + installkernel.
e79a303f
AL
27# preupgrade - Do certain upgrades (typically the addition of new
28# users and groups used by installed utilities) before
f71956f7 29# the installworld.
8db5e54f 30# upgrade - Upgrade the files in /etc and also setup the rest
f71956f7 31# of the system for DragonFly. ex. two compilers.
bc897c50
AL
32# initrd - Install the statically linked rescue tools and the
33# initrd image built by "buildworld".
f71956f7 34# backupworld - Copy /bin /sbin /usr/bin /usr/sbin /usr/lib
2decc9b9 35# /usr/libexec to manual backup dir.
f71956f7
AL
36# restoreworld - Install binaries from manual backup dir to world.
37# restoreworld-auto - Install binaries from auto-backup dir to world;
2decc9b9
JM
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.
984263bc 41#
114580ac 42# This makefile is simple by design. The DragonFly make automatically reads
f71956f7 43# /usr/share/mk/sys.mk unless the -m argument is specified on the
984263bc
MD
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#
f71956f7 49# Most of the user-driven targets (as listed above) are implemented in
e79a303f 50# Makefile.inc1.
984263bc
MD
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'
9b724c0d
MD
63# 3. `make buildkernel KERNCONF=YOUR_KERNEL_HERE' (default X86_64_GENERIC).
64# 4. `make installkernel KERNCONF=YOUR_KERNEL_HERE' (default X86_64_GENERIC).
30d6fede
SW
65# 5. `make installworld'
66# 6. `make upgrade'
67# 7. `reboot'
bc897c50 68# 8. `make initrd' (after making sure that the new world works well).
984263bc 69#
b2b3ffcd 70# If TARGET_ARCH=arch (e.g. x86_64) is specified you can
984263bc
MD
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#
f71956f7 75# For more information, see the build(7) manual page.
984263bc 76#
f71956f7 77
92c9dfec 78TGTS= all all-man buildkernel quickkernel realquickkernel nativekernel \
fc7aca3e 79 buildworld crossworld quickworld realquickworld checkdpadd clean \
5cccfb7b 80 cleandepend cleandir depend everything \
984263bc 81 hierarchy install installcheck installkernel \
fae4aceb 82 reinstallkernel installworld installworld-force os-release initrd \
f71956f7 83 libraries lint maninstall \
e972a8ba 84 manlint mk obj objlink regress rerelease tags \
e79a303f 85 backupworld restoreworld restoreworld-auto \
d0bcca46 86 build-all install-all \
2decc9b9 87 backup-clean backup-auto-clean \
fd4528de 88 _obj _includes _libraries _depend _worldtmp \
9f8ba22c 89 _bootstrap-tools _build-tools _cross-tools
1419a4e1 90#TGTS+= mandiff # XXX temporary target
984263bc
MD
91
92BITGTS= files includes
93BITGTS:=${BITGTS} ${BITGTS:S/^/build/} ${BITGTS:S/^/install/}
94
95.ORDER: buildworld installworld
828e58f9
SS
96.ORDER: buildworld buildkernel
97.ORDER: buildworld nativekernel
98.ORDER: buildworld quickkernel
92c9dfec 99.ORDER: buildworld realquickkernel
828e58f9
SS
100.ORDER: buildkernel installkernel
101.ORDER: buildkernel reinstallkernel
102.ORDER: quickworld installworld
828e58f9
SS
103.ORDER: quickworld buildkernel
104.ORDER: quickworld nativekernel
105.ORDER: quickworld quickkernel
92c9dfec 106.ORDER: quickworld realquickkernel
828e58f9
SS
107.ORDER: quickkernel installkernel
108.ORDER: quickkernel reinstallkernel
92c9dfec
SW
109.ORDER: realquickkernel installkernel
110.ORDER: realquickkernel reinstallkernel
d0bcca46 111.ORDER: build-all install-all
984263bc 112
83abeeca 113_HOSTPATH= /sbin:/bin:/usr/sbin:/usr/bin:/usr/local/bin:/usr/pkg/bin
114MAKE= PATH=${_HOSTPATH} make -m ${.CURDIR}/share/mk -f Makefile.inc1
984263bc
MD
115
116#
117# Handle the user-driven targets, using the source relative mk files.
118#
bc897c50 119${TGTS} ${BITGTS}: .PHONY
984263bc
MD
120 @cd ${.CURDIR}; \
121 ${MAKE} ${.TARGET}
122
982afa6b
AL
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
984263bc
MD
131
132STARTTIME!= LC_ALL=C date
982afa6b 133
984263bc
MD
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#
8db5e54f 140world:
984263bc 141 @echo "--------------------------------------------------------------"
24c1eacf 142 @echo ">>> make world started on ${STARTTIME}"
984263bc
MD
143 @echo "--------------------------------------------------------------"
144.if target(pre-world)
145 @echo
146 @echo "--------------------------------------------------------------"
24c1eacf 147 @echo ">>> starting pre-world target"
984263bc
MD
148 @echo "--------------------------------------------------------------"
149 @cd ${.CURDIR}; ${MAKE} pre-world
24c1eacf
JM
150 @echo "--------------------------------------------------------------"
151 @echo ">>> pre-world target complete"
152 @echo "--------------------------------------------------------------"
984263bc
MD
153.endif
154 @cd ${.CURDIR}; ${MAKE} buildworld
155 @cd ${.CURDIR}; ${MAKE} -B installworld
156.if target(post-world)
157 @echo
158 @echo "--------------------------------------------------------------"
24c1eacf 159 @echo ">>> starting post-world target"
984263bc
MD
160 @echo "--------------------------------------------------------------"
161 @cd ${.CURDIR}; ${MAKE} post-world
24c1eacf
JM
162 @echo "--------------------------------------------------------------"
163 @echo ">>> post-world target complete"
164 @echo "--------------------------------------------------------------"
984263bc
MD
165.endif
166 @echo
167 @echo "--------------------------------------------------------------"
24c1eacf 168 @printf ">>> make world completed on `LC_ALL=C date`\n (started ${STARTTIME})\n"
984263bc
MD
169 @echo "--------------------------------------------------------------"
170
984263bc
MD
171# kernel
172#
173# Short hand for `make buildkernel installkernel'
174#
175kernel: buildkernel installkernel
176
984263bc
MD
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
3da8e88f
JM
185.if defined(notdef) && ${notdef:tu}
186.endif
3da8e88f 187.endif
984263bc
MD
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#
30d8ccf3
SW
203# Handle the upgrade of /etc, post-installworld updating of static files
204# and removing obsolete files.
984263bc
MD
205#
206
f35282e3 207preupgrade:
ab64cf06 208 @cd ${.CURDIR}/etc; make -m ${.CURDIR}/share/mk preupgrade
f35282e3 209
30d8ccf3 210upgrade:
ab64cf06 211 @cd ${.CURDIR}/etc; make -m ${.CURDIR}/share/mk upgrade_etc
30d8ccf3 212.if !defined(NOMAN) && !defined(NO_MAKEDB_RUN)
e79a303f 213 @cd ${.CURDIR}/share/man; make makedb
30d8ccf3 214.endif
e79a303f
AL
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:"
bc14b951 222 @echo " # pkg update; pkg upgrade [-f]"
e79a303f 223 @echo "--------------------------------------------------------------"