Sync our gcc5 manual pages with gcc-5.4.0
[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*, including glue to help do
7 #                       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".
12 # installworld-force  - Install everything built by "buildworld", special case for old systems
13 # world               - buildworld + installworld.
14 # buildkernel         - Rebuild the kernel and the kernel-modules from scratch
15 #                       using build/bootstrap/cross tools from the last
16 #                       buildworld.
17 # nativekernel        - Rebuild the kernel and the kernel-modules from scratch
18 #                       using native tools.
19 # quickkernel         - rebuild the kernel quickly (build or native), and do
20 #                       not clean out the obj modules.
21 # realquickkernel     - Like quickkernel, but skips depend too.
22 # installkernel       - Install the kernel and the kernel-modules.
23 # reinstallkernel     - Reinstall the kernel and the kernel-modules.
24 # kernel              - buildkernel + installkernel.
25 # preupgrade          - Certain upgrades may have to be done before installworld.
26 #                       installworld will complain if they have not been done.  This
27 #                       target will do those upgrades... typically the addition of
28 #                       new special groups and users used by installed utilities.
29 # upgrade             - Upgrade the files in /etc and also setup the rest
30 #                       of the system for DragonFly. ex. two compilers
31 # most                - Build user commands, no libraries or include files.
32 # installmost         - Install user commands, no libraries or include files.
33 # rescue              - Create rescue image in /boot
34 # backupworld         - Copies /bin /sbin /usr/bin /usr/sbin /usr/lib
35 #                       /usr/libexec to manual backup dir.
36 # restoreworld        - Installs binaries from manual backup dir to world.
37 # restoreworld-auto   - Installs 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 # The user-driven targets (as listed above) are implemented in Makefile.inc1.
50 #
51 # If you want to build your system from source be sure that /usr/obj has
52 # at least 800MB of diskspace available.
53 #
54 # For individuals wanting to build from the sources currently on their
55 # system, the simple instructions are:
56 #
57 # 1.  `cd /usr/src'  (or to the directory containing your source tree).
58 # 2.  `make world'
59 #
60 # For individuals wanting to upgrade their sources (even if only a
61 # delta of a few days):
62 #
63 # 1.  `cd /usr/src'       (or to the directory containing your source tree).
64 # 2.  `make buildworld'
65 # 3.  `make buildkernel KERNCONF=YOUR_KERNEL_HERE'   (default is X86_64_GENERIC).
66 # 4.  `make installkernel KERNCONF=YOUR_KERNEL_HERE' (default is X86_64_GENERIC).
67 # 5.  `make installworld'
68 # 6.  `make upgrade'
69 # 7.  `reboot'
70 #
71 # See src/UPDATING `COMMON ITEMS' for more complete information.
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 # Define the user-driven targets. These are listed here in alphabetical
79 # order, but that's not important.
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 installmost installworld installworld-force libraries lint maninstall \
86         manlint mk most obj objlink regress rerelease tags \
87         rescue backupworld restoreworld restoreworld-auto \
88         backup-clean backup-auto-clean \
89         _obj _includes _libraries _depend _worldtmp \
90         _bootstrap-tools _build-tools _cross-tools
91 TGTS+=  mandiff # XXX temporary target
92
93 BITGTS= files includes
94 BITGTS:=${BITGTS} ${BITGTS:S/^/build/} ${BITGTS:S/^/install/}
95
96 .ORDER: buildworld installworld
97 .ORDER: buildworld buildkernel
98 .ORDER: buildworld nativekernel
99 .ORDER: buildworld quickkernel
100 .ORDER: buildworld realquickkernel
101 .ORDER: buildkernel installkernel
102 .ORDER: buildkernel reinstallkernel
103 .ORDER: quickworld installworld
104 .ORDER: quickworld buildkernel
105 .ORDER: quickworld nativekernel
106 .ORDER: quickworld quickkernel
107 .ORDER: quickworld realquickkernel
108 .ORDER: quickkernel installkernel
109 .ORDER: quickkernel reinstallkernel
110 .ORDER: realquickkernel installkernel
111 .ORDER: realquickkernel reinstallkernel
112
113 PATH=   /sbin:/bin:/usr/sbin:/usr/bin:/usr/local/bin:/usr/pkg/bin
114 MAKE=   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}:
120         @cd ${.CURDIR}; \
121                 ${MAKE} ${.TARGET}
122
123 # Set a reasonable default
124 .MAIN:  all
125
126 STARTTIME!= 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 #
133 world:
134         @echo "--------------------------------------------------------------"
135         @echo ">>> make world started on ${STARTTIME}"
136         @echo "--------------------------------------------------------------"
137 .if target(pre-world)
138         @echo
139         @echo "--------------------------------------------------------------"
140         @echo ">>> starting pre-world target"
141         @echo "--------------------------------------------------------------"
142         @cd ${.CURDIR}; ${MAKE} pre-world
143         @echo "--------------------------------------------------------------"
144         @echo ">>> pre-world target complete"
145         @echo "--------------------------------------------------------------"
146 .endif
147         @cd ${.CURDIR}; ${MAKE} buildworld
148         @cd ${.CURDIR}; ${MAKE} -B installworld
149 .if target(post-world)
150         @echo
151         @echo "--------------------------------------------------------------"
152         @echo ">>> starting post-world target"
153         @echo "--------------------------------------------------------------"
154         @cd ${.CURDIR}; ${MAKE} post-world
155         @echo "--------------------------------------------------------------"
156         @echo ">>> post-world target complete"
157         @echo "--------------------------------------------------------------"
158 .endif
159         @echo
160         @echo "--------------------------------------------------------------"
161         @printf ">>> make world completed on `LC_ALL=C date`\n                        (started ${STARTTIME})\n"
162         @echo "--------------------------------------------------------------"
163
164 #
165 # kernel
166 #
167 # Short hand for `make buildkernel installkernel'
168 #
169 kernel: buildkernel installkernel
170
171 #
172 # A simple test target used as part of the test to see if make supports
173 # the -m argument.  Also test that make will only evaluate a conditional
174 # as far as is necessary to determine its value.
175 #
176 test:
177 .if defined(notdef)
178 .undef notdef
179 .if defined(notdef) && ${notdef:tu}
180 .endif
181 .endif
182
183 #
184 # Upgrade the installed make to the current version using the installed
185 # headers, libraries and build tools. This is required on installed versions
186 # prior to 2.2.5 in which the installed make doesn't support the -m argument.
187 #
188 make:
189         @echo
190         @echo "--------------------------------------------------------------"
191         @echo " Upgrading the installed make"
192         @echo "--------------------------------------------------------------"
193         @cd ${.CURDIR}/usr.bin/make; \
194                 make obj && make depend && make all && make install
195
196 #
197 # Handle the upgrade of /etc, post-installworld updating of static files
198 # and removing obsolete files.
199 #
200
201 preupgrade:
202         @cd ${.CURDIR}/etc; make -m ${.CURDIR}/share/mk preupgrade
203
204 upgrade:
205         @cd ${.CURDIR}/etc; make -m ${.CURDIR}/share/mk upgrade_etc
206 .if !defined(NOMAN) && !defined(NO_MAKEDB_RUN)
207         cd ${.CURDIR}/share/man; make makedb
208 .endif