| @@ -1,1834 +1,1837 @@ | | | @@ -1,1834 +1,1837 @@ |
1 | # $NetBSD: bsd.README,v 1.290 2011/11/05 22:56:30 christos Exp $ | | 1 | # $NetBSD: bsd.README,v 1.291 2012/01/28 21:32:13 christos Exp $ |
2 | # @(#)bsd.README 8.2 (Berkeley) 4/2/94 | | 2 | # @(#)bsd.README 8.2 (Berkeley) 4/2/94 |
3 | | | 3 | |
4 | This is the README file for the make "include" files for the NetBSD | | 4 | This is the README file for the make "include" files for the NetBSD |
5 | source tree. The files are installed in /usr/share/mk, and are, | | 5 | source tree. The files are installed in /usr/share/mk, and are, |
6 | by convention, named with the suffix ".mk". | | 6 | by convention, named with the suffix ".mk". |
7 | | | 7 | |
8 | Note, this file is not intended to replace reading through the .mk | | 8 | Note, this file is not intended to replace reading through the .mk |
9 | files for anything tricky. | | 9 | files for anything tricky. |
10 | | | 10 | |
11 | =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= | | 11 | =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= |
12 | | | 12 | |
13 | RANDOM THINGS WORTH KNOWING: | | 13 | RANDOM THINGS WORTH KNOWING: |
14 | | | 14 | |
15 | The files are simply C-style #include files, and pretty much behave like | | 15 | The files are simply C-style #include files, and pretty much behave like |
16 | you'd expect. The syntax is slightly different in that a single '.' is | | 16 | you'd expect. The syntax is slightly different in that a single '.' is |
17 | used instead of the hash mark, i.e. ".include <bsd.prog.mk>". | | 17 | used instead of the hash mark, i.e. ".include <bsd.prog.mk>". |
18 | | | 18 | |
19 | One difference that will save you lots of debugging time is that inclusion | | 19 | One difference that will save you lots of debugging time is that inclusion |
20 | of the file is normally done at the *end* of the Makefile. The reason for | | 20 | of the file is normally done at the *end* of the Makefile. The reason for |
21 | this is because .mk files often modify variables and behavior based on the | | 21 | this is because .mk files often modify variables and behavior based on the |
22 | values of variables set in the Makefile. To make this work, remember that | | 22 | values of variables set in the Makefile. To make this work, remember that |
23 | the FIRST target found is the target that is used, i.e. if the Makefile has: | | 23 | the FIRST target found is the target that is used, i.e. if the Makefile has: |
24 | | | 24 | |
25 | a: | | 25 | a: |
26 | echo a | | 26 | echo a |
27 | a: | | 27 | a: |
28 | echo a number two | | 28 | echo a number two |
29 | | | 29 | |
30 | the command "make a" will echo "a". To make things confusing, the SECOND | | 30 | the command "make a" will echo "a". To make things confusing, the SECOND |
31 | variable assignment is the overriding one, i.e. if the Makefile has: | | 31 | variable assignment is the overriding one, i.e. if the Makefile has: |
32 | | | 32 | |
33 | a= foo | | 33 | a= foo |
34 | a= bar | | 34 | a= bar |
35 | | | 35 | |
36 | b: | | 36 | b: |
37 | echo ${a} | | 37 | echo ${a} |
38 | | | 38 | |
39 | the command "make b" will echo "bar". This is for compatibility with the | | 39 | the command "make b" will echo "bar". This is for compatibility with the |
40 | way the V7 make behaved. | | 40 | way the V7 make behaved. |
41 | | | 41 | |
42 | It's fairly difficult to make the BSD .mk files work when you're building | | 42 | It's fairly difficult to make the BSD .mk files work when you're building |
43 | multiple programs in a single directory. It's a lot easier to split up the | | 43 | multiple programs in a single directory. It's a lot easier to split up the |
44 | programs than to deal with the problem. Most of the agony comes from making | | 44 | programs than to deal with the problem. Most of the agony comes from making |
45 | the "obj" directory stuff work right, not because we switched to a new version | | 45 | the "obj" directory stuff work right, not because we switched to a new version |
46 | of make. So, don't get mad at us, figure out a better way to handle multiple | | 46 | of make. So, don't get mad at us, figure out a better way to handle multiple |
47 | architectures so we can quit using the symbolic link stuff. (Imake doesn't | | 47 | architectures so we can quit using the symbolic link stuff. (Imake doesn't |
48 | count.) | | 48 | count.) |
49 | | | 49 | |
50 | The file .depend in the source directory is expected to contain dependencies | | 50 | The file .depend in the source directory is expected to contain dependencies |
51 | for the source files. This file is read automatically by make after reading | | 51 | for the source files. This file is read automatically by make after reading |
52 | the Makefile. | | 52 | the Makefile. |
53 | | | 53 | |
54 | The variable DESTDIR works as before. It's not set anywhere but will change | | 54 | The variable DESTDIR works as before. It's not set anywhere but will change |
55 | the tree where the file gets installed. | | 55 | the tree where the file gets installed. |
56 | | | 56 | |
57 | The profiled libraries are no longer built in a different directory than | | 57 | The profiled libraries are no longer built in a different directory than |
58 | the regular libraries. A new suffix, ".po", is used to denote a profiled | | 58 | the regular libraries. A new suffix, ".po", is used to denote a profiled |
59 | object, and ".pico" denotes a shared (position-independent) object. | | 59 | object, and ".pico" denotes a shared (position-independent) object. |
60 | | | 60 | |
61 | There are various make variables used during the build. | | 61 | There are various make variables used during the build. |
62 | | | 62 | |
63 | Many variables support a (case sensitive) value of "no" or "yes", | | 63 | Many variables support a (case sensitive) value of "no" or "yes", |
64 | and are tested with ${VAR} == "no" and ${VAR} != "no" . | | 64 | and are tested with ${VAR} == "no" and ${VAR} != "no" . |
65 | | | 65 | |
66 | | | 66 | |
67 | The basic rule for the variable naming scheme is as follows: | | 67 | The basic rule for the variable naming scheme is as follows: |
68 | | | 68 | |
69 | HOST_xxx A command that runs on the host machine regardless of | | 69 | HOST_xxx A command that runs on the host machine regardless of |
70 | whether or not the system is being cross compiled, or | | 70 | whether or not the system is being cross compiled, or |
71 | flags for such a command. | | 71 | flags for such a command. |
72 | | | 72 | |
73 | MKxxx Can be set to "no" to disable functionality, or | | 73 | MKxxx Can be set to "no" to disable functionality, or |
74 | "yes" to enable it. | | 74 | "yes" to enable it. |
75 | Usually defaults to "yes", although some variables | | 75 | Usually defaults to "yes", although some variables |
76 | default to "no". | | 76 | default to "no". |
77 | Due to make(1) implementation issues, if a temporary | | 77 | Due to make(1) implementation issues, if a temporary |
78 | command-line override of a mk.conf(5) or <bsd.own.mk> | | 78 | command-line override of a mk.conf(5) or <bsd.own.mk> |
79 | setting is required whilst still honoring a particular | | 79 | setting is required whilst still honoring a particular |
80 | Makefile's setting of MKxxx, use | | 80 | Makefile's setting of MKxxx, use |
81 | env MKxxx=value make | | 81 | env MKxxx=value make |
82 | instead of | | 82 | instead of |
83 | make MKxxx=value | | 83 | make MKxxx=value |
84 | | | 84 | |
85 | NOxxx If defined, disables a feature. | | 85 | NOxxx If defined, disables a feature. |
86 | Not intended for users. | | 86 | Not intended for users. |
87 | This is to allow Makefiles to disable functionality | | 87 | This is to allow Makefiles to disable functionality |
88 | that they don't support (such as missing man pages). | | 88 | that they don't support (such as missing man pages). |
89 | NOxxx variables must be defined before <bsd.own.mk> | | 89 | NOxxx variables must be defined before <bsd.own.mk> |
90 | is included. | | 90 | is included. |
91 | | | 91 | |
92 | TOOL_xxx A tool that is provided as part of the USETOOLS | | 92 | TOOL_xxx A tool that is provided as part of the USETOOLS |
93 | framework. When not using the USETOOLS framework, | | 93 | framework. When not using the USETOOLS framework, |
94 | TOOL_xxx variables should refer to tools that are | | 94 | TOOL_xxx variables should refer to tools that are |
95 | already installed on the host system. | | 95 | already installed on the host system. |
96 | | | 96 | |
97 | The following variables that control how things are made/installed that | | 97 | The following variables that control how things are made/installed that |
98 | are not set by default. These should not be set by Makefiles; they're for | | 98 | are not set by default. These should not be set by Makefiles; they're for |
99 | the user to define in MAKECONF (see <bsd.own.mk>, below, or mk.conf(5)) | | 99 | the user to define in MAKECONF (see <bsd.own.mk>, below, or mk.conf(5)) |
100 | or on the make(1) command line: | | 100 | or on the make(1) command line: |
101 | | | 101 | |
102 | BUILD If defined, 'make install' checks that the targets in the | | 102 | BUILD If defined, 'make install' checks that the targets in the |
103 | source directories are up-to-date and remakes them if they | | 103 | source directories are up-to-date and remakes them if they |
104 | are out of date, instead of blindly trying to install | | 104 | are out of date, instead of blindly trying to install |
105 | out of date or non-existent targets. | | 105 | out of date or non-existent targets. |
106 | | | 106 | |
107 | MAKEVERBOSE Control how "verbose" the standard make(1) rules are. | | 107 | MAKEVERBOSE Control how "verbose" the standard make(1) rules are. |
108 | Default: 2 | | 108 | Default: 2 |
109 | Supported values: | | 109 | Supported values: |
110 | 0 Minimal output ("quiet") | | 110 | 0 Minimal output ("quiet") |
111 | 1 Describe what is occurring | | 111 | 1 Describe what is occurring |
112 | 2 Describe what is occurring and echo the actual command | | 112 | 2 Describe what is occurring and echo the actual command |
113 | 3 Ignore the effect of the "@" prefix in make commands | | 113 | 3 Ignore the effect of the "@" prefix in make commands |
114 | 4 Trace shell commands using the shell's -x flag | | 114 | 4 Trace shell commands using the shell's -x flag |
115 | | | 115 | |
116 | MKATF If "no", don't build libatf-c, libatf-c++ libraries associated | | 116 | MKATF If "no", don't build libatf-c, libatf-c++ libraries associated |
117 | with the Automated Testing Framework (ATF). | | 117 | with the Automated Testing Framework (ATF). |
118 | Default: yes | | 118 | Default: yes |
119 | | | 119 | |
120 | MKBFD Obsolete, use MKBINUTILS | | 120 | MKBFD Obsolete, use MKBINUTILS |
121 | | | 121 | |
122 | MKBINUTILS If "no", don't build binutils (gas, ld, etc and libbfd, | | 122 | MKBINUTILS If "no", don't build binutils (gas, ld, etc and libbfd, |
123 | libopcodes) | | 123 | libopcodes) |
124 | Default: yes | | 124 | Default: yes |
125 | | | 125 | |
126 | MKBSDTAR If "yes", use the libarchive based cpio and tar instead of | | 126 | MKBSDTAR If "yes", use the libarchive based cpio and tar instead of |
127 | the pax frontends. | | 127 | the pax frontends. |
128 | Default: no | | 128 | Default: no |
129 | | | 129 | |
130 | MKCATPAGES If "no", don't build or install the catman pages. | | 130 | MKCATPAGES If "no", don't build or install the catman pages. |
131 | Default: yes | | 131 | Default: yes |
132 | | | 132 | |
133 | MKCOMPAT If "no", don't build or install the src/compat. | | 133 | MKCOMPAT If "no", don't build or install the src/compat. |
134 | Default: yes on amd64/sparc64, no elsewhere. | | 134 | Default: yes on amd64/sparc64, no elsewhere. |
135 | | | 135 | |
136 | MKCOMPLEX If "no", don't build libm support for <complex.h> | | 136 | MKCOMPLEX If "no", don't build libm support for <complex.h> |
137 | Default: yes | | 137 | Default: yes |
138 | | | 138 | |
139 | MKCRYPTO If "no", no cryptography support will be built into the system, | | 139 | MKCRYPTO If "no", no cryptography support will be built into the system, |
140 | and also acts as "MKKERBEROS=no". | | 140 | and also acts as "MKKERBEROS=no". |
141 | Default: yes | | 141 | Default: yes |
142 | | | 142 | |
143 | MKCRYPTO_IDEA If not "no", IDEA support will be built into libcrypto_idea.a. | | 143 | MKCRYPTO_IDEA If not "no", IDEA support will be built into libcrypto_idea.a. |
144 | Default: no | | 144 | Default: no |
145 | | | 145 | |
146 | MKCRYPTO_MDC2 If not "no", MDC2 support will be built into libcrypto_mdc2.a | | 146 | MKCRYPTO_MDC2 If not "no", MDC2 support will be built into libcrypto_mdc2.a |
147 | Default: no | | 147 | Default: no |
148 | | | 148 | |
149 | MKCRYPTO_RC5 If not "no", RC5 support will be built into libcrypto_rc5.a. | | 149 | MKCRYPTO_RC5 If not "no", RC5 support will be built into libcrypto_rc5.a. |
150 | Default: no | | 150 | Default: no |
151 | | | 151 | |
152 | MKCVS If "no", don't build or install cvs(1). | | 152 | MKCVS If "no", don't build or install cvs(1). |
153 | Default: yes | | 153 | Default: yes |
154 | | | 154 | |
155 | MKDEBUG If "no", don't build and install separate debugging symbols | | 155 | MKDEBUG If "no", don't build and install separate debugging symbols |
156 | into /usr/libdata/debug. | | 156 | into /usr/libdata/debug. |
157 | Default: no | | 157 | Default: no |
158 | | | 158 | |
159 | MKDEBUGLIB Build *_g.a debugging libraries, which are compiled | | 159 | MKDEBUGLIB Build *_g.a debugging libraries, which are compiled |
160 | with -DDEBUG. | | 160 | with -DDEBUG. |
161 | Default: no | | 161 | Default: no |
162 | | | 162 | |
163 | MKDOC If "no", don't build or install the documentation. | | 163 | MKDOC If "no", don't build or install the documentation. |
164 | Default: yes | | 164 | Default: yes |
165 | | | 165 | |
166 | MKDYNAMICROOT If "no", build programs in /bin and /sbin statically, | | 166 | MKDYNAMICROOT If "no", build programs in /bin and /sbin statically, |
167 | don't install certain libraries in /lib, and don't | | 167 | don't install certain libraries in /lib, and don't |
168 | install the shared linker into /libexec. | | 168 | install the shared linker into /libexec. |
169 | Default: yes | | 169 | Default: yes |
170 | | | 170 | |
171 | MKEXTSRC If not "no", 'make build' also descends into either src/extsrc | | 171 | MKEXTSRC If not "no", 'make build' also descends into either src/extsrc |
172 | to cross-build programs and libraries externally added by | | 172 | to cross-build programs and libraries externally added by |
173 | users, and automatically enables creation of those sets. | | 173 | users, and automatically enables creation of those sets. |
174 | Default: no | | 174 | Default: no |
175 | | | 175 | |
176 | MKGCC If "no", don't build gcc(1) or any of the GCC-related | | 176 | MKGCC If "no", don't build gcc(1) or any of the GCC-related |
177 | libraries (libgcc, libobjc, libstdc++). | | 177 | libraries (libgcc, libobjc, libstdc++). |
178 | Default: yes | | 178 | Default: yes |
179 | | | 179 | |
180 | MKGCCCMDS If "no", don't build gcc(1), but do build the GCC-related | | 180 | MKGCCCMDS If "no", don't build gcc(1), but do build the GCC-related |
181 | libraries (libgcc, libobjc, libstdc++). | | 181 | libraries (libgcc, libobjc, libstdc++). |
182 | Default: yes | | 182 | Default: yes |
183 | | | 183 | |
184 | MKGDB If "no", don't build gdb(1). | | 184 | MKGDB If "no", don't build gdb(1). |
185 | Default: yes | | 185 | Default: yes |
186 | | | 186 | |
187 | MKHESIOD If "no", disables building of Hesiod infrastructure | | 187 | MKHESIOD If "no", disables building of Hesiod infrastructure |
188 | (libraries and support programs). | | 188 | (libraries and support programs). |
189 | Default: yes | | 189 | Default: yes |
190 | | | 190 | |
191 | MKHOSTOBJ If not "no", for programs intended to be run on the compile | | 191 | MKHOSTOBJ If not "no", for programs intended to be run on the compile |
192 | host, the name, release, and architecture of the host | | 192 | host, the name, release, and architecture of the host |
193 | operating system will be suffixed to the name of the object | | 193 | operating system will be suffixed to the name of the object |
194 | directory created by "make obj". | | 194 | directory created by "make obj". |
195 | Default: no | | 195 | Default: no |
196 | | | 196 | |
197 | MKHTML If "no", don't build or install the HTML man pages. | | 197 | MKHTML If "no", don't build or install the HTML man pages. |
198 | Default: yes | | 198 | Default: yes |
199 | | | 199 | |
200 | MKIEEEFP If "no", don't add code for IEEE754/IEC60559 conformance. | | 200 | MKIEEEFP If "no", don't add code for IEEE754/IEC60559 conformance. |
201 | Has no effect on most platforms. | | 201 | Has no effect on most platforms. |
202 | Default: yes | | 202 | Default: yes |
203 | | | 203 | |
204 | MKSTRIPIDENT Strip the RCS IDs from program binaries and shared libraries. | | 204 | MKSTRIPIDENT Strip the RCS IDs from program binaries and shared libraries. |
205 | Default: no | | 205 | Default: no |
206 | | | 206 | |
207 | MKINET6 If "no", disables building of INET6 (IPv6) infrastructure | | 207 | MKINET6 If "no", disables building of INET6 (IPv6) infrastructure |
208 | (libraries and support programs). This option must not be | | 208 | (libraries and support programs). This option must not be |
209 | set to "no" if MKX11 is not "no". | | 209 | set to "no" if MKX11 is not "no". |
210 | Default: yes | | 210 | Default: yes |
211 | | | 211 | |
212 | MKINFO If "no", don't build or install Info documentation from | | 212 | MKINFO If "no", don't build or install Info documentation from |
213 | Texinfo source files. | | 213 | Texinfo source files. |
214 | Default: yes | | 214 | Default: yes |
215 | | | 215 | |
216 | MKIPFILTER If "no", don't build or install the IP Filter programs and LKM. | | 216 | MKIPFILTER If "no", don't build or install the IP Filter programs and LKM. |
217 | Default: yes | | 217 | Default: yes |
218 | | | 218 | |
219 | MKISCSI If "no", don't build or install iSCSI library or applications | | 219 | MKISCSI If "no", don't build or install iSCSI library or applications |
220 | (depends on libpthread.) | | 220 | (depends on libpthread.) |
221 | Default: yes | | 221 | Default: yes |
222 | | | 222 | |
223 | MKKERBEROS If "no", disables building of Kerberos v5 | | 223 | MKKERBEROS If "no", disables building of Kerberos v5 |
224 | infrastructure (libraries and support programs). | | 224 | infrastructure (libraries and support programs). |
225 | Default: yes | | 225 | Default: yes |
226 | | | 226 | |
227 | MKLDAP If "no", disables building of LDAP infrastructure | | 227 | MKLDAP If "no", disables building of LDAP infrastructure |
228 | (libraries and support programs). | | 228 | (libraries and support programs). |
229 | Default: yes | | 229 | Default: yes |
230 | | | 230 | |
231 | MKLINKLIB If "no", act as "MKLINT=no MKPICINSTALL=no MKPROFILE=no". | | 231 | MKLINKLIB If "no", act as "MKLINT=no MKPICINSTALL=no MKPROFILE=no". |
232 | Also: | | 232 | Also: |
233 | - don't install the .a libraries | | 233 | - don't install the .a libraries |
234 | - don't install _pic.a libraries on PIC systems | | 234 | - don't install _pic.a libraries on PIC systems |
235 | - don't build .a libraries on PIC systems | | 235 | - don't build .a libraries on PIC systems |
236 | - don't install the .so symlink on ELF systems | | 236 | - don't install the .so symlink on ELF systems |
237 | I.e, only install the shared library (and the .so.major | | 237 | I.e, only install the shared library (and the .so.major |
238 | symlink on ELF). | | 238 | symlink on ELF). |
239 | Default: yes | | 239 | Default: yes |
240 | | | 240 | |
241 | MKLINT If "no", don't build or install the lint libraries. | | 241 | MKLINT If "no", don't build or install the lint libraries. |
242 | Default: yes | | 242 | Default: yes |
243 | | | 243 | |
244 | MKLVM If "no", don't build or install the logical volume manager | | 244 | MKLVM If "no", don't build or install the logical volume manager |
245 | and device mapper tools and libraries | | 245 | and device mapper tools and libraries |
246 | Default: yes | | 246 | Default: yes |
247 | | | 247 | |
248 | MKMAN If "no", don't build or install the man or catman pages, | | 248 | MKMAN If "no", don't build or install the man or catman pages, |
249 | and also acts as "MKCATPAGES=no MKHTML=no". | | 249 | and also acts as "MKCATPAGES=no MKHTML=no". |
250 | Default: yes | | 250 | Default: yes |
251 | | | 251 | |
252 | MKMANDOC If "yes", mandoc is built as tool and used to compile | | 252 | MKMANDOC If "yes", mandoc is built as tool and used to compile |
253 | catman or html pages. A directory can be exempted by | | 253 | catman or html pages. A directory can be exempted by |
254 | defining NOMANDOC. Individual man pages are exempted | | 254 | defining NOMANDOC. Individual man pages are exempted |
255 | if NOMANDOC.${target} is set to "yes". | | 255 | if NOMANDOC.${target} is set to "yes". |
256 | Default: no | | 256 | Default: no |
257 | | | 257 | |
258 | MKMANZ If not "no", compress manual pages at installation time. | | 258 | MKMANZ If not "no", compress manual pages at installation time. |
259 | Default: no | | 259 | Default: no |
260 | | | 260 | |
261 | MKMDNS If "no", disables building of mDNS infrastructure | | 261 | MKMDNS If "no", disables building of mDNS infrastructure |
262 | (libraries and support programs). | | 262 | (libraries and support programs). |
263 | Default: yes | | 263 | Default: yes |
264 | | | 264 | |
265 | MKNLS If "no", don't build or install the NLS files and locale | | 265 | MKNLS If "no", don't build or install the NLS files and locale |
266 | definition files. | | 266 | definition files. |
267 | Default: yes | | 267 | Default: yes |
268 | | | 268 | |
269 | MKNPF If "no", don't build or install the NPF and its modules. | | 269 | MKNPF If "no", don't build or install the NPF and its modules. |
270 | Default: yes | | 270 | Default: yes |
271 | | | 271 | |
272 | MKOBJ If "no", don't enable the rule which creates objdirs, | | 272 | MKOBJ If "no", don't enable the rule which creates objdirs, |
273 | and also acts as "MKOBJDIRS=no". | | 273 | and also acts as "MKOBJDIRS=no". |
274 | Default: yes | | 274 | Default: yes |
275 | | | 275 | |
276 | MKOBJDIRS If "no", don't create objdirs during a "make build". | | 276 | MKOBJDIRS If "no", don't create objdirs during a "make build". |
277 | Default: no | | 277 | Default: no |
278 | | | 278 | |
279 | MKPAM If "no", disables building of PAM authentication | | 279 | MKPAM If "no", disables building of PAM authentication |
280 | infrastructure (libraries and support programs). | | 280 | infrastructure (libraries and support programs). |
281 | Default: yes | | 281 | Default: yes |
282 | | | 282 | |
283 | MKPCC If "no", don't build pcc(1) or any of the PCC-related | | 283 | MKPCC If "no", don't build pcc(1) or any of the PCC-related |
284 | libraries (libpcc, libpccsoftfloat). | | 284 | libraries (libpcc, libpccsoftfloat). |
285 | Default: no | | 285 | Default: no |
286 | | | 286 | |
287 | MKPF If "no", don't build or install the pf programs and LKM. | | 287 | MKPF If "no", don't build or install the pf programs and LKM. |
288 | Default: yes | | 288 | Default: yes |
289 | | | 289 | |
290 | MKPIC If "no", don't build or install shared libraries, and | | 290 | MKPIC If "no", don't build or install shared libraries, and |
291 | also acts as "MKPICLIB=no" | | 291 | also acts as "MKPICLIB=no" |
292 | Default: yes (for MACHINE_ARCHs that support it) | | 292 | Default: yes (for MACHINE_ARCHs that support it) |
293 | | | 293 | |
294 | MKPICINSTALL If "no", don't install the *_pic.a libraries. | | 294 | MKPICINSTALL If "no", don't install the *_pic.a libraries. |
295 | Default: yes | | 295 | Default: yes |
296 | | | 296 | |
297 | MKPICLIB If "no", don't build *_pic.a libraries, and build the | | 297 | MKPICLIB If "no", don't build *_pic.a libraries, and build the |
298 | shared object libraries from the .a libraries. | | 298 | shared object libraries from the .a libraries. |
299 | A symlink is installed in ${DESTDIR}/usr/lib for the | | 299 | A symlink is installed in ${DESTDIR}/usr/lib for the |
300 | _pic.a library pointing to the .a library. | | 300 | _pic.a library pointing to the .a library. |
301 | Default: yes | | 301 | Default: yes |
302 | | | 302 | |
303 | MKPIE If "no", create regular executables. Otherwise create | | 303 | MKPIE If "no", create regular executables. Otherwise create |
304 | PIE (Position Independent Executables). | | 304 | PIE (Position Independent Executables). |
305 | Default: no | | 305 | Default: no |
306 | | | 306 | |
307 | MKPIGZGZIP If "no", only install pigz as pigz, not gzip. | | 307 | MKPIGZGZIP If "no", only install pigz as pigz, not gzip. |
308 | Default: no | | 308 | Default: no |
309 | | | 309 | |
310 | MKPOSTFIX If "no", don't build or install postfix(1). | | 310 | MKPOSTFIX If "no", don't build or install postfix(1). |
311 | Default: yes | | 311 | Default: yes |
312 | | | 312 | |
313 | MKPROFILE If "no", don't build or install the profiling (*_p.a) libraries. | | 313 | MKPROFILE If "no", don't build or install the profiling (*_p.a) libraries. |
314 | Default: yes | | 314 | Default: yes |
315 | | | 315 | |
316 | MKSHARE If "no", act as "MKCATPAGES=no MKDOC=no MKHTML=no MKINFO=no | | 316 | MKSHARE If "no", act as "MKCATPAGES=no MKDOC=no MKHTML=no MKINFO=no |
317 | MKMAN=no MKNLS=no". | | 317 | MKMAN=no MKNLS=no". |
318 | I.e, don't build catman pages, documentation, Info | | 318 | I.e, don't build catman pages, documentation, Info |
319 | documentation, man pages, NLS files, ... | | 319 | documentation, man pages, NLS files, ... |
320 | Default: yes | | 320 | Default: yes |
321 | | | 321 | |
322 | MKSKEY If "no", disables building of S/key authentication | | 322 | MKSKEY If "no", disables building of S/key authentication |
323 | infrastructure (libraries and support programs). | | 323 | infrastructure (libraries and support programs). |
324 | Default: yes | | 324 | Default: yes |
325 | | | 325 | |
326 | MKSOFTFLOAT If not "no", build with options to enable the compiler to | | 326 | MKSOFTFLOAT If not "no", build with options to enable the compiler to |
327 | generate output containing library calls for floating | | 327 | generate output containing library calls for floating |
328 | point and possibly soft-float library support. | | 328 | point and possibly soft-float library support. |
329 | Default: no | | 329 | Default: no |
330 | | | 330 | |
331 | MKSTATICLIB If "no", don't build or install the normal static (*.a) | | 331 | MKSTATICLIB If "no", don't build or install the normal static (*.a) |
332 | libraries. | | 332 | libraries. |
333 | Default: yes | | 333 | Default: yes |
334 | | | 334 | |
335 | MKUNPRIVED If not "no", don't set the owner/group/mode when installing | | 335 | MKUNPRIVED If not "no", don't set the owner/group/mode when installing |
336 | files or directories, and keep a metadata log of what | | 336 | files or directories, and keep a metadata log of what |
337 | the owner/group/mode should be. This allows a | | 337 | the owner/group/mode should be. This allows a |
338 | non-root "make install". | | 338 | non-root "make install". |
339 | Default: no | | 339 | Default: no |
340 | | | 340 | |
341 | MKUPDATE If not "no", 'make install' only installs targets that are | | 341 | MKUPDATE If not "no", 'make install' only installs targets that are |
342 | more recently modified in the source directories that their | | 342 | more recently modified in the source directories that their |
343 | installed counterparts. | | 343 | installed counterparts. |
344 | Default: no | | 344 | Default: no |
345 | | | 345 | |
346 | MKX11 If not "no", depending on the value of ${X11FLAVOUR}, | | 346 | MKX11 If not "no", depending on the value of ${X11FLAVOUR}, |
347 | 'make build' also descends into either src/x11 (XFree86) or | | 347 | 'make build' also descends into either src/x11 (XFree86) or |
348 | src/external/mit/xorg (modular Xorg) to cross-build X11 and | | 348 | src/external/mit/xorg (modular Xorg) to cross-build X11 and |
349 | automatically enables creation of X sets. | | 349 | automatically enables creation of X sets. |
350 | Default: no | | 350 | Default: no |
351 | | | 351 | |
352 | MKX11FONTS If not "no", if ${X11FLAVOUR} is "Xorg", do not build or | | 352 | MKX11FONTS If not "no", if ${X11FLAVOUR} is "Xorg", do not build or |
353 | install the X fonts. The xfont set is still created but | | 353 | install the X fonts. The xfont set is still created but |
354 | will be empty. | | 354 | will be empty. |
355 | Default: yes | | 355 | Default: yes |
356 | | | 356 | |
357 | MKYP If "no", disables building of YP (NIS) | | 357 | MKYP If "no", disables building of YP (NIS) |
358 | infrastructure (libraries and support programs). | | 358 | infrastructure (libraries and support programs). |
359 | Default: yes | | 359 | Default: yes |
360 | | | 360 | |
361 | MKZFS If "no", do not build and install utilities and libraries | | 361 | MKZFS If "no", do not build and install utilities and libraries |
362 | used to manage ZFS file system. Do not build zfs and solaris | | 362 | used to manage ZFS file system. Do not build zfs and solaris |
363 | compatibility kernel modules. | | 363 | compatibility kernel modules. |
364 | Default: yes on i386/amd64, no elsewhere. | | 364 | Default: yes on i386/amd64, no elsewhere. |
365 | | | 365 | |
366 | USE_HESIOD If "no", disables building Hesiod support into | | 366 | USE_HESIOD If "no", disables building Hesiod support into |
367 | various system utilities/libraries that support it. | | 367 | various system utilities/libraries that support it. |
368 | If ${MKHESIOD} is "no", USE_HESIOD will also be | | 368 | If ${MKHESIOD} is "no", USE_HESIOD will also be |
369 | forced to "no". | | 369 | forced to "no". |
370 | | | 370 | |
371 | USE_INET6 If "no", disables building INET6 (IPv6) support into | | 371 | USE_INET6 If "no", disables building INET6 (IPv6) support into |
372 | various system utilities/libraries that support it. | | 372 | various system utilities/libraries that support it. |
373 | If ${MKINET6} is "no", USE_INET6 will also be | | 373 | If ${MKINET6} is "no", USE_INET6 will also be |
374 | forced to "no". | | 374 | forced to "no". |
375 | | | 375 | |
376 | USE_JEMALLOC If "no", disables building the "jemalloc" allocator | | 376 | USE_JEMALLOC If "no", disables building the "jemalloc" allocator |
377 | designed for improved performance with threaded | | 377 | designed for improved performance with threaded |
378 | applications. The "phkmalloc" allocator as used up | | 378 | applications. The "phkmalloc" allocator as used up |
379 | before NetBSD-5.0 will be substituted. | | 379 | before NetBSD-5.0 will be substituted. |
380 | | | 380 | |
381 | USE_KERBEROS If "no", disables building Kerberos v5 | | 381 | USE_KERBEROS If "no", disables building Kerberos v5 |
382 | support into various system utilities/libraries that | | 382 | support into various system utilities/libraries that |
383 | support it. If ${MKKERBEROS} is "no", USE_KERBEROS | | 383 | support it. If ${MKKERBEROS} is "no", USE_KERBEROS |
384 | will also be forced to "no". | | 384 | will also be forced to "no". |
385 | | | 385 | |
386 | USE_LDAP If "no", disables building LDAP support into various | | 386 | USE_LDAP If "no", disables building LDAP support into various |
387 | system utilities/libraries that support it. | | 387 | system utilities/libraries that support it. |
388 | If ${MKLDAP} is "no", USE_LDAP will also be forced to "no". | | 388 | If ${MKLDAP} is "no", USE_LDAP will also be forced to "no". |
389 | | | 389 | |
390 | USE_PAM If "no", disables building PAM authentication support | | 390 | USE_PAM If "no", disables building PAM authentication support |
391 | into various system utilities/libraries that support it. | | 391 | into various system utilities/libraries that support it. |
392 | If ${MKPAM} is "no", USE_PAM will also be forced to "no". | | 392 | If ${MKPAM} is "no", USE_PAM will also be forced to "no". |
393 | | | 393 | |
394 | USE_SKEY If "no", disables building S/key authentication | | 394 | USE_SKEY If "no", disables building S/key authentication |
395 | support into various system utilities/libraries that | | 395 | support into various system utilities/libraries that |
396 | support it. If ${MKSKEY} is "no", USE_SKEY will | | 396 | support it. If ${MKSKEY} is "no", USE_SKEY will |
397 | also be forced to "no". | | 397 | also be forced to "no". |
398 | Default: no | | 398 | Default: no |
399 | | | 399 | |
400 | USE_SSP If "no", disables GCC stack protection code, which | | 400 | USE_SSP If "no", disables GCC stack protection code, which |
401 | detects stack overflows and aborts the program. The | | 401 | detects stack overflows and aborts the program. The |
402 | stack protection code imposes a performance penalty | | 402 | stack protection code imposes a performance penalty |
403 | of about 5%. | | 403 | of about 5%. |
404 | Default: "no", unless "USE_FORT" is set to "yes" | | 404 | Default: "no", unless "USE_FORT" is set to "yes" |
405 | | | 405 | |
406 | USE_FORT If "yes" turns on substitute wrappers for commonly used | | 406 | USE_FORT If "yes" turns on substitute wrappers for commonly used |
407 | functions that do not do bounds checking regularly, but | | 407 | functions that do not do bounds checking regularly, but |
408 | they could in some cases by using the gcc | | 408 | they could in some cases by using the gcc |
409 | __builtin_object_size() function to determine the buffer | | 409 | __builtin_object_size() function to determine the buffer |
410 | size where it is known and detect buffer overflows. | | 410 | size where it is known and detect buffer overflows. |
411 | These substitute functions are in /usr/include/ssp. | | 411 | These substitute functions are in /usr/include/ssp. |
412 | Default: depends on the part of the source tree | | 412 | Default: depends on the part of the source tree |
413 | | | 413 | |
414 | USE_YP If "no", disables building YP (NIS) support into | | 414 | USE_YP If "no", disables building YP (NIS) support into |
415 | various system utilities/libraries that support it. | | 415 | various system utilities/libraries that support it. |
416 | If ${MKYP} is "no", USE_YP will also be forced to "no". | | 416 | If ${MKYP} is "no", USE_YP will also be forced to "no". |
417 | | | 417 | |
418 | USE_PIGZGZIP If "no", use the host "gzip" program to compress things. | | 418 | USE_PIGZGZIP If "no", use the host "gzip" program to compress things. |
419 | Otherwise, build tools/pigz and use nbpigz to compress | | 419 | Otherwise, build tools/pigz and use nbpigz to compress |
420 | things. | | 420 | things. |
421 | Default: "no". | | 421 | Default: "no". |
422 | | | 422 | |
423 | X11FLAVOUR Set to "Xorg" or "XFree86", depending on whether to build | | 423 | X11FLAVOUR Set to "Xorg" or "XFree86", depending on whether to build |
424 | XFree86 or modular Xorg. Only matters if MKX11!=no. | | 424 | XFree86 or modular Xorg. Only matters if MKX11!=no. |
425 | Default: "Xorg" on amd64, i386, macppc, shark and sparc64, | | 425 | Default: "Xorg" on amd64, i386, macppc, shark and sparc64, |
426 | "XFree86" on everything else. | | 426 | "XFree86" on everything else. |
427 | | | 427 | |
428 | COPTS.lib<lib> | | 428 | COPTS.lib<lib> |
429 | OBJCOPTS.lib<lib> | | 429 | OBJCOPTS.lib<lib> |
430 | LDADD.lib<lib> | | 430 | LDADD.lib<lib> |
431 | CPPFLAGS.lib<lib> | | 431 | CPPFLAGS.lib<lib> |
432 | CXXFLAGS.lib<lib> | | 432 | CXXFLAGS.lib<lib> |
433 | COPTS.<prog> | | 433 | COPTS.<prog> |
434 | OBJCCOPTS.<prog> | | 434 | OBJCCOPTS.<prog> |
435 | LDADD.<prog> | | 435 | LDADD.<prog> |
436 | CPPFLAGS.<prog> | | 436 | CPPFLAGS.<prog> |
437 | CXXFLAGS.<prog> These provide a way to specify additions to the associated | | 437 | CXXFLAGS.<prog> These provide a way to specify additions to the associated |
438 | variables in a way that applies only to a particular library | | 438 | variables in a way that applies only to a particular library |
439 | or program. <lib> corresponds to the LIB variable set in | | 439 | or program. <lib> corresponds to the LIB variable set in |
440 | the library's makefile. <prog> corresponds to either PROG | | 440 | the library's makefile. <prog> corresponds to either PROG |
441 | or PROG_CXX (if set). For example, if COPTS.libcrypto is | | 441 | or PROG_CXX (if set). For example, if COPTS.libcrypto is |
442 | set to "-g", "-g" will be added to COPTS only when compiling | | 442 | set to "-g", "-g" will be added to COPTS only when compiling |
443 | the crypto library. | | 443 | the crypto library. |
444 | | | 444 | |
445 | The active compiler is selected using the following variables: | | 445 | The active compiler is selected using the following variables: |
446 | AVAILABLE_COMPILER | | 446 | AVAILABLE_COMPILER |
447 | List of available compiler suites. Processed in order | | 447 | List of available compiler suites. Processed in order |
448 | for selecting the active compiler for each frontend. | | 448 | for selecting the active compiler for each frontend. |
449 | HAVE_PCC If defined, PCC is present and enabled. | | 449 | HAVE_PCC If defined, PCC is present and enabled. |
450 | HAVE_LLVM If defined, LLVM/Clang is present and enabled. | | 450 | HAVE_LLVM If defined, LLVM/Clang is present and enabled. |
451 | UNSUPPORTED_COMPILER.xxx | | 451 | UNSUPPORTED_COMPILER.xxx |
452 | If defined, the support for compiler "xxx" is disabled. | | 452 | If defined, the support for compiler "xxx" is disabled. |
453 | | | 453 | |
454 | For the frontends (CC, CPP, CXX, FC and OBJC) the following variables exist: | | 454 | For the frontends (CC, CPP, CXX, FC and OBJC) the following variables exist: |
455 | ACTIVE_CC Active compile suite for the CC frontend. | | 455 | ACTIVE_CC Active compile suite for the CC frontend. |
456 | SUPPORTED_CC Compile suite with support for the CC frontend. | | 456 | SUPPORTED_CC Compile suite with support for the CC frontend. |
457 | TOOL_CC.xxx Path to the CC frontend for compiler "xxx" | | 457 | TOOL_CC.xxx Path to the CC frontend for compiler "xxx" |
458 | | | 458 | |
459 | =-=-=-=-= sys.mk =-=-=-=-= | | 459 | =-=-=-=-= sys.mk =-=-=-=-= |
460 | | | 460 | |
461 | The include file <sys.mk> has the default rules for all makes, in the BSD | | 461 | The include file <sys.mk> has the default rules for all makes, in the BSD |
462 | environment or otherwise. You probably don't want to touch this file. | | 462 | environment or otherwise. You probably don't want to touch this file. |
463 | | | 463 | |
464 | =-=-=-=-= bsd.own.mk =-=-=-=-= | | 464 | =-=-=-=-= bsd.own.mk =-=-=-=-= |
465 | | | 465 | |
466 | The include file <bsd.own.mk> contains source tree configuration parameters, | | 466 | The include file <bsd.own.mk> contains source tree configuration parameters, |
467 | such as the owners, groups, etc. for both manual pages and binaries, and | | 467 | such as the owners, groups, etc. for both manual pages and binaries, and |
468 | a few global "feature configuration" parameters. | | 468 | a few global "feature configuration" parameters. |
469 | | | 469 | |
470 | It has no targets. | | 470 | It has no targets. |
471 | | | 471 | |
472 | To get system-specific configuration parameters, <bsd.own.mk> will try to | | 472 | To get system-specific configuration parameters, <bsd.own.mk> will try to |
473 | include the file specified by the "MAKECONF" variable. If MAKECONF is not | | 473 | include the file specified by the "MAKECONF" variable. If MAKECONF is not |
474 | set, or no such file exists, the system make configuration file, /etc/mk.conf | | 474 | set, or no such file exists, the system make configuration file, /etc/mk.conf |
475 | is included. These files may define any of the variables described below. | | 475 | is included. These files may define any of the variables described below. |
476 | | | 476 | |
477 | <bsd.own.mk> sets the following variables, if they are not already defined | | 477 | <bsd.own.mk> sets the following variables, if they are not already defined |
478 | (defaults are in brackets): | | 478 | (defaults are in brackets): |
479 | | | 479 | |
480 | NETBSDSRCDIR Top of the NetBSD source tree. | | 480 | NETBSDSRCDIR Top of the NetBSD source tree. |
481 | If _SRC_TOP_ != "", that will be used as the default, | | 481 | If _SRC_TOP_ != "", that will be used as the default, |
482 | otherwise BSDSRCDIR will be used as the default. | | 482 | otherwise BSDSRCDIR will be used as the default. |
483 | Various makefiles within the NetBSD source tree will | | 483 | Various makefiles within the NetBSD source tree will |
484 | use this to reference the top level of the source tree. | | 484 | use this to reference the top level of the source tree. |
485 | | | 485 | |
486 | _SRC_TOP_ Top of the system source tree, as determined by <bsd.own.mk> | | 486 | _SRC_TOP_ Top of the system source tree, as determined by <bsd.own.mk> |
487 | based on the presence of tools/ and build.sh. This variable | | 487 | based on the presence of tools/ and build.sh. This variable |
488 | is "internal" to <bsd.own.mk>, although its value is only | | 488 | is "internal" to <bsd.own.mk>, although its value is only |
489 | determined once and then propagated to all sub-makes. | | 489 | determined once and then propagated to all sub-makes. |
490 | | | 490 | |
491 | BSDSRCDIR The real path to the system sources, so that 'make obj' | | 491 | BSDSRCDIR The real path to the system sources, so that 'make obj' |
492 | will work correctly. [/usr/src] | | 492 | will work correctly. [/usr/src] |
493 | | | 493 | |
494 | BSDOBJDIR The real path to the system 'obj' tree, so that 'make obj' | | 494 | BSDOBJDIR The real path to the system 'obj' tree, so that 'make obj' |
495 | will work correctly. [/usr/obj] | | 495 | will work correctly. [/usr/obj] |
496 | | | 496 | |
497 | BINGRP Binary group. [wheel] | | 497 | BINGRP Binary group. [wheel] |
498 | | | 498 | |
499 | BINOWN Binary owner. [root] | | 499 | BINOWN Binary owner. [root] |
500 | | | 500 | |
501 | BINMODE Binary mode. [555] | | 501 | BINMODE Binary mode. [555] |
502 | | | 502 | |
503 | NONBINMODE Mode for non-executable files. [444] | | 503 | NONBINMODE Mode for non-executable files. [444] |
504 | | | 504 | |
505 | MANDIR Base path for manual installation. [/usr/share/man/cat] | | 505 | MANDIR Base path for manual installation. [/usr/share/man/cat] |
506 | | | 506 | |
507 | MANGRP Manual group. [wheel] | | 507 | MANGRP Manual group. [wheel] |
508 | | | 508 | |
509 | MANOWN Manual owner. [root] | | 509 | MANOWN Manual owner. [root] |
510 | | | 510 | |
511 | MANMODE Manual mode. [${NONBINMODE}] | | 511 | MANMODE Manual mode. [${NONBINMODE}] |
512 | | | 512 | |
513 | MANINSTALL Manual installation type. Space separated list: | | 513 | MANINSTALL Manual installation type. Space separated list: |
514 | catinstall, htmlinstall, maninstall | | 514 | catinstall, htmlinstall, maninstall |
515 | [catinstall maninstall htmlinstall] | | 515 | [catinstall maninstall htmlinstall] |
516 | | | 516 | |
517 | LDSTATIC Control program linking; if set blank, link everything | | 517 | LDSTATIC Control program linking; if set blank, link everything |
518 | dynamically. If set to "-static", link everything statically. | | 518 | dynamically. If set to "-static", link everything statically. |
519 | If not set, programs link according to their makefile. | | 519 | If not set, programs link according to their makefile. |
520 | | | 520 | |
521 | LIBDIR Base path for library installation. [/usr/lib] | | 521 | LIBDIR Base path for library installation. [/usr/lib] |
522 | | | 522 | |
523 | LINTLIBDIR Base path for lint(1) library installation. [/usr/libdata/lint] | | 523 | LINTLIBDIR Base path for lint(1) library installation. [/usr/libdata/lint] |
524 | | | 524 | |
525 | LIBGRP Library group. [${BINGRP}] | | 525 | LIBGRP Library group. [${BINGRP}] |
526 | | | 526 | |
527 | LIBOWN Library owner. [${BINOWN}] | | 527 | LIBOWN Library owner. [${BINOWN}] |
528 | | | 528 | |
529 | LIBMODE Library mode. [${NONBINMODE}] | | 529 | LIBMODE Library mode. [${NONBINMODE}] |
530 | | | 530 | |
531 | DOCDIR Base path for system documentation (e.g. PSD, USD, etc.) | | 531 | DOCDIR Base path for system documentation (e.g. PSD, USD, etc.) |
532 | installation. [/usr/share/doc] | | 532 | installation. [/usr/share/doc] |
533 | | | 533 | |
534 | HTMLDOCDIR Base path for html system documentation installation. | | 534 | HTMLDOCDIR Base path for html system documentation installation. |
535 | [/usr/share/doc/html] | | 535 | [/usr/share/doc/html] |
536 | | | 536 | |
537 | DOCGRP Documentation group. [wheel] | | 537 | DOCGRP Documentation group. [wheel] |
538 | | | 538 | |
539 | DOCOWN Documentation owner. [root] | | 539 | DOCOWN Documentation owner. [root] |
540 | | | 540 | |
541 | DOCMODE Documentation mode. [${NONBINMODE}] | | 541 | DOCMODE Documentation mode. [${NONBINMODE}] |
542 | | | 542 | |
543 | NLSDIR Base path for Native Language Support files installation. | | 543 | NLSDIR Base path for Native Language Support files installation. |
544 | [/usr/share/nls] | | 544 | [/usr/share/nls] |
545 | | | 545 | |
546 | NLSGRP Native Language Support files group. [wheel] | | 546 | NLSGRP Native Language Support files group. [wheel] |
547 | | | 547 | |
548 | NLSOWN Native Language Support files owner. [root] | | 548 | NLSOWN Native Language Support files owner. [root] |
549 | | | 549 | |
550 | NLSMODE Native Language Support files mode. [${NONBINMODE}] | | 550 | NLSMODE Native Language Support files mode. [${NONBINMODE}] |
551 | | | 551 | |
552 | X11SRCDIR The path to the xsrc tree. [${NETBSDSRCDIR}/../xsrc, | | 552 | X11SRCDIR The path to the xsrc tree. [${NETBSDSRCDIR}/../xsrc, |
553 | if that exists; otherwise /usr/xsrc] | | 553 | if that exists; otherwise /usr/xsrc] |
554 | | | 554 | |
555 | X11SRCDIR.xc The path to the (old) X11 xc src tree. [${X11SRCDIR}/xfree/xc] | | 555 | X11SRCDIR.xc The path to the (old) X11 xc src tree. [${X11SRCDIR}/xfree/xc] |
556 | | | 556 | |
557 | X11SRCDIR.local The path to the local X11 src tree. [${X11SRCDIR}/local] | | 557 | X11SRCDIR.local The path to the local X11 src tree. [${X11SRCDIR}/local] |
558 | | | 558 | |
559 | X11SRCDIR.lib<package> | | 559 | X11SRCDIR.lib<package> |
560 | X11SRCDIR.<package> | | 560 | X11SRCDIR.<package> |
561 | The path to the xorg src tree for the specificed package>. | | 561 | The path to the xorg src tree for the specificed package>. |
562 | [${X11SRCDIR}/external/mit/xorg/<package>/dist] | | 562 | [${X11SRCDIR}/external/mit/xorg/<package>/dist] |
563 | | | 563 | |
564 | X11ROOTDIR Root directory of the X11 installation. [/usr/X11R6 or | | 564 | X11ROOTDIR Root directory of the X11 installation. [/usr/X11R6 or |
565 | [/usr/X11R7] | | 565 | [/usr/X11R7] |
566 | | | 566 | |
567 | X11BINDIR X11 bin directory. [${X11ROOTDIR}/bin] | | 567 | X11BINDIR X11 bin directory. [${X11ROOTDIR}/bin] |
568 | | | 568 | |
569 | X11FONTDIR X11 font directory. [${X11ROOTDIR}/lib/X11/fonts] | | 569 | X11FONTDIR X11 font directory. [${X11ROOTDIR}/lib/X11/fonts] |
570 | | | 570 | |
571 | X11INCDIR X11 include directory. [${X11ROOTDIR}/include] | | 571 | X11INCDIR X11 include directory. [${X11ROOTDIR}/include] |
572 | | | 572 | |
573 | X11LIBDIR X11 lib/x11 (config) directory. [${X11ROOTDIR}/lib/X11] | | 573 | X11LIBDIR X11 lib/x11 (config) directory. [${X11ROOTDIR}/lib/X11] |
574 | | | 574 | |
575 | X11MANDIR X11 manual directory. [${X11ROOTDIR}/man] | | 575 | X11MANDIR X11 manual directory. [${X11ROOTDIR}/man] |
576 | | | 576 | |
577 | X11USRLIBDIR X11 library directory. [${X11ROOTDIR}/lib] | | 577 | X11USRLIBDIR X11 library directory. [${X11ROOTDIR}/lib] |
578 | | | 578 | |
579 | STRIPFLAG The flag passed to the install program to cause the binary | | 579 | STRIPFLAG The flag passed to the install program to cause the binary |
580 | to be stripped. This is to be used when building your | | 580 | to be stripped. This is to be used when building your |
581 | own install script so that the entire system can be made | | 581 | own install script so that the entire system can be made |
582 | stripped/not-stripped using a single knob. [] | | 582 | stripped/not-stripped using a single knob. [] |
583 | | | 583 | |
584 | COPY The flag passed to the install program to cause the binary | | 584 | COPY The flag passed to the install program to cause the binary |
585 | to be copied rather than moved. This is to be used when | | 585 | to be copied rather than moved. This is to be used when |
586 | building our own install script so that the entire system | | 586 | building our own install script so that the entire system |
587 | can either be installed with copies, or with moves using | | 587 | can either be installed with copies, or with moves using |
588 | a single knob. [-c] | | 588 | a single knob. [-c] |
589 | | | 589 | |
590 | MAKEDIRTARGET dir target [params] | | 590 | MAKEDIRTARGET dir target [params] |
591 | Runs "cd $${dir} && ${MAKE} [params] $${target}", | | 591 | Runs "cd $${dir} && ${MAKE} [params] $${target}", |
592 | displaying a "pretty" message whilst doing so. | | 592 | displaying a "pretty" message whilst doing so. |
593 | | | 593 | |
594 | RELEASEMACHINEDIR | | 594 | RELEASEMACHINEDIR |
595 | Subdirectory used below RELEASEDIR when building | | 595 | Subdirectory used below RELEASEDIR when building |
596 | a release. [${MACHINE}] | | 596 | a release. [${MACHINE}] |
597 | | | 597 | |
598 | RELEASEMACHINE Subdirectory or path component used for the following | | 598 | RELEASEMACHINE Subdirectory or path component used for the following |
599 | paths: | | 599 | paths: |
600 | distrib/${RELEASEMACHINE} | | 600 | distrib/${RELEASEMACHINE} |
601 | distrib/notes/${RELEASEMACHINE} | | 601 | distrib/notes/${RELEASEMACHINE} |
602 | etc/etc.${RELEASEMACHINE} | | 602 | etc/etc.${RELEASEMACHINE} |
603 | Used when building a release. [${MACHINE}] | | 603 | Used when building a release. [${MACHINE}] |
604 | | | 604 | |
605 | Additionally, the following variables may be set by <bsd.own.mk> or in a | | 605 | Additionally, the following variables may be set by <bsd.own.mk> or in a |
606 | make configuration file to modify the behavior of the system build | | 606 | make configuration file to modify the behavior of the system build |
607 | process (default values are in brackets along with comments, if set by | | 607 | process (default values are in brackets along with comments, if set by |
608 | <bsd.own.mk>): | | 608 | <bsd.own.mk>): |
609 | | | 609 | |
610 | USETOOLS Indicates whether the tools specified by ${TOOLDIR} should | | 610 | USETOOLS Indicates whether the tools specified by ${TOOLDIR} should |
611 | be used as part of a build in progress. | | 611 | be used as part of a build in progress. |
612 | Supported values: | | 612 | Supported values: |
613 | | | 613 | |
614 | yes Use the tools from TOOLDIR. | | 614 | yes Use the tools from TOOLDIR. |
615 | Must be set to this if cross-compiling. | | 615 | Must be set to this if cross-compiling. |
616 | | | 616 | |
617 | no Do not use the tools from TOOLDIR, but refuse to | | 617 | no Do not use the tools from TOOLDIR, but refuse to |
618 | build native compilation tool components that are | | 618 | build native compilation tool components that are |
619 | version-specific for that tool. | | 619 | version-specific for that tool. |
620 | | | 620 | |
621 | never Do not use the tools from TOOLDIR, even when | | 621 | never Do not use the tools from TOOLDIR, even when |
622 | building native tool components. This is similar to | | 622 | building native tool components. This is similar to |
623 | the traditional NetBSD build method, but does not | | 623 | the traditional NetBSD build method, but does not |
624 | verify that the compilation tools in use are | | 624 | verify that the compilation tools in use are |
625 | up-to-date enough in order to build the tree | | 625 | up-to-date enough in order to build the tree |
626 | successfully. This may cause build or runtime | | 626 | successfully. This may cause build or runtime |
627 | problems when building the whole NetBSD source tree. | | 627 | problems when building the whole NetBSD source tree. |
628 | | | 628 | |
629 | Default: "yes" if building all or part of a whole NetBSD | | 629 | Default: "yes" if building all or part of a whole NetBSD |
630 | source tree (detected automatically); "no" otherwise | | 630 | source tree (detected automatically); "no" otherwise |
631 | (to preserve traditional semantics of the <bsd.*.mk> | | 631 | (to preserve traditional semantics of the <bsd.*.mk> |
632 | make(1) include files). | | 632 | make(1) include files). |
633 | | | 633 | |
634 | OBJECT_FMT Object file format. [set to "ELF" on architectures that | | 634 | OBJECT_FMT Object file format. [set to "ELF" on architectures that |
635 | use ELF -- currently all architectures]. | | 635 | use ELF -- currently all architectures]. |
636 | | | 636 | |
637 | TOOLCHAIN_MISSING | | 637 | TOOLCHAIN_MISSING |
638 | If not "no", this indicates that the platform being built | | 638 | If not "no", this indicates that the platform being built |
639 | does not have a working in-tree toolchain. If the | | 639 | does not have a working in-tree toolchain. If the |
640 | ${MACHINE_ARCH} in question falls into this category, | | 640 | ${MACHINE_ARCH} in question falls into this category, |
641 | TOOLCHAIN_MISSING is conditionally assigned the value "yes". | | 641 | TOOLCHAIN_MISSING is conditionally assigned the value "yes". |
642 | Otherwise, the variable is unconditionally assigned the | | 642 | Otherwise, the variable is unconditionally assigned the |
643 | value "no". | | 643 | value "no". |
644 | If not "no", ${MKBINUTILS}, ${MKGCC}, and ${MKGDB} are | | 644 | If not "no", ${MKBINUTILS}, ${MKGCC}, and ${MKGDB} are |
645 | unconditionally assigned the value "no". | | 645 | unconditionally assigned the value "no". |
646 | | | 646 | |
647 | EXTERNAL_TOOLCHAIN | | 647 | EXTERNAL_TOOLCHAIN |
648 | This variable is not directly set by <bsd.own.mk>, but | | 648 | This variable is not directly set by <bsd.own.mk>, but |
649 | including <bsd.own.mk> is the canonical way to gain | | 649 | including <bsd.own.mk> is the canonical way to gain |
650 | access to this variable. The variable should be defined | | 650 | access to this variable. The variable should be defined |
651 | either in the user's environment or in the user's mk.conf | | 651 | either in the user's environment or in the user's mk.conf |
652 | file. If defined, this variable indicates the root of | | 652 | file. If defined, this variable indicates the root of |
653 | an external toolchain which will be used to build the | | 653 | an external toolchain which will be used to build the |
654 | tree. For example, if a platform is a ${TOOLCHAIN_MISSING} | | 654 | tree. For example, if a platform is a ${TOOLCHAIN_MISSING} |
655 | platform, EXTERNAL_TOOLCHAIN can be used to re-enable the | | 655 | platform, EXTERNAL_TOOLCHAIN can be used to re-enable the |
656 | cross-compile framework. | | 656 | cross-compile framework. |
657 | | | 657 | |
658 | If EXTERNAL_TOOLCHAIN is defined, ${MKGCC} is unconditionally | | 658 | If EXTERNAL_TOOLCHAIN is defined, ${MKGCC} is unconditionally |
659 | assigned the value "no", since the external version of the | | 659 | assigned the value "no", since the external version of the |
660 | compiler may not be able to build the library components of | | 660 | compiler may not be able to build the library components of |
661 | the in-tree compiler. | | 661 | the in-tree compiler. |
662 | | | 662 | |
663 | NOTE: This variable is not yet used in as many places as | | 663 | NOTE: This variable is not yet used in as many places as |
664 | it should be. Expect the exact semantics of this variable | | 664 | it should be. Expect the exact semantics of this variable |
665 | to change in the short term as parts of the cross-compile | | 665 | to change in the short term as parts of the cross-compile |
666 | framework continue to be cleaned up. | | 666 | framework continue to be cleaned up. |
667 | | | 667 | |
668 | The following variables are defined to commands to perform the | | 668 | The following variables are defined to commands to perform the |
669 | appropriate operation, with the default in [brackets]. Note that | | 669 | appropriate operation, with the default in [brackets]. Note that |
670 | the defaults change if USETOOLS == "yes": | | 670 | the defaults change if USETOOLS == "yes": |
671 | | | 671 | |
672 | TOOL_AMIGAAOUT2BB aout to Amiga bootblock converter. [amiga-aout2bb] | | 672 | TOOL_AMIGAAOUT2BB aout to Amiga bootblock converter. [amiga-aout2bb] |
673 | | | 673 | |
674 | TOOL_AMIGAELF2BB ELF to Amiga bootblock converter. [amiga-elf2bb] | | 674 | TOOL_AMIGAELF2BB ELF to Amiga bootblock converter. [amiga-elf2bb] |
675 | | | 675 | |
676 | TOOL_AMIGATXLT Amige assembly language format translator. [amiga-txlt] | | 676 | TOOL_AMIGATXLT Amige assembly language format translator. [amiga-txlt] |
677 | | | 677 | |
678 | TOOL_ASN1_COMPILE ASN1 compiler. [asn1_compile] | | 678 | TOOL_ASN1_COMPILE ASN1 compiler. [asn1_compile] |
679 | | | 679 | |
680 | TOOL_AWK Pattern-directed scanning/processing language. [awk] | | 680 | TOOL_AWK Pattern-directed scanning/processing language. [awk] |
681 | | | 681 | |
682 | TOOL_CAP_MKDB Create capability database. [cap_mkdb] | | 682 | TOOL_CAP_MKDB Create capability database. [cap_mkdb] |
683 | | | 683 | |
684 | TOOL_CAT Concatenate and print files. [cat] | | 684 | TOOL_CAT Concatenate and print files. [cat] |
685 | | | 685 | |
686 | TOOL_CKSUM Display file checksums. [cksum] | | 686 | TOOL_CKSUM Display file checksums. [cksum] |
687 | | | 687 | |
688 | TOOL_COMPILE_ET Error table compiler. [compile_et] | | 688 | TOOL_COMPILE_ET Error table compiler. [compile_et] |
689 | | | 689 | |
690 | TOOL_CONFIG Build kernel compilation directories. [config] | | 690 | TOOL_CONFIG Build kernel compilation directories. [config] |
691 | | | 691 | |
692 | TOOL_CRUNCHGEN Generate crunched binary build environment. [crunchgen] | | 692 | TOOL_CRUNCHGEN Generate crunched binary build environment. [crunchgen] |
693 | | | 693 | |
694 | TOOL_CTAGS Create a tags file. [ctags] | | 694 | TOOL_CTAGS Create a tags file. [ctags] |
695 | | | 695 | |
696 | TOOL_DB Manipulate db(3) databases. [db] | | 696 | TOOL_DB Manipulate db(3) databases. [db] |
697 | | | 697 | |
698 | TOOL_DISKLABEL Read and write disk pack label. [disklabel] | | 698 | TOOL_DISKLABEL Read and write disk pack label. [disklabel] |
699 | | | 699 | |
700 | TOOL_EQN Format equations for groff. [eqn] | | 700 | TOOL_EQN Format equations for groff. [eqn] |
701 | | | 701 | |
702 | TOOL_FDISK MS-DOS partition maintenance program. [fdisk] | | 702 | TOOL_FDISK MS-DOS partition maintenance program. [fdisk] |
703 | | | 703 | |
704 | TOOL_FGEN IEEE 1275 Open Firmware FCode Tokenizer. [fgen] | | 704 | TOOL_FGEN IEEE 1275 Open Firmware FCode Tokenizer. [fgen] |
705 | | | 705 | |
706 | TOOL_GENASSYM Generate constants for assembly files. [genassym] | | 706 | TOOL_GENASSYM Generate constants for assembly files. [genassym] |
707 | | | 707 | |
708 | TOOL_GENCAT Generate NLS message catalogs. [gencat] | | 708 | TOOL_GENCAT Generate NLS message catalogs. [gencat] |
709 | | | 709 | |
710 | TOOL_GMAKE GNU make utility. [gmake] | | 710 | TOOL_GMAKE GNU make utility. [gmake] |
711 | | | 711 | |
712 | TOOL_GREP Print lines matching a pattern. [grep] | | 712 | TOOL_GREP Print lines matching a pattern. [grep] |
713 | | | 713 | |
714 | TOOL_GROFF Front end for groff document formatting system. [groff] | | 714 | TOOL_GROFF Front end for groff document formatting system. [groff] |
715 | | | 715 | |
716 | TOOL_HEXDUMP Ascii, decimal, hexadecimal, octal dump. [hexdump] | | 716 | TOOL_HEXDUMP Ascii, decimal, hexadecimal, octal dump. [hexdump] |
717 | | | 717 | |
718 | TOOL_HP300MKBOOT Make bootable image for hp300. [hp300-mkboot] | | 718 | TOOL_HP300MKBOOT Make bootable image for hp300. [hp300-mkboot] |
719 | | | 719 | |
720 | TOOL_HP700MKBOOT Make bootable image for hp700. [hp700-mkboot] | | 720 | TOOL_HP700MKBOOT Make bootable image for hp700. [hp700-mkboot] |
721 | | | 721 | |
722 | TOOL_INDXBIB Make bibliographic database's inverted index. [indxbib] | | 722 | TOOL_INDXBIB Make bibliographic database's inverted index. [indxbib] |
723 | | | 723 | |
724 | TOOL_INSTALLBOOT Install disk bootstrap software. [installboot] | | 724 | TOOL_INSTALLBOOT Install disk bootstrap software. [installboot] |
725 | | | 725 | |
726 | TOOL_INSTALL_INFO Update info/dir entries. [install-info] | | 726 | TOOL_INSTALL_INFO Update info/dir entries. [install-info] |
727 | | | 727 | |
728 | TOOL_JOIN Relational database operator. [join] | | 728 | TOOL_JOIN Relational database operator. [join] |
729 | | | 729 | |
730 | TOOL_M4 M4 macro language processor. [m4] | | 730 | TOOL_M4 M4 macro language processor. [m4] |
731 | | | 731 | |
732 | TOOL_MACPPCFIXCOFF Fix up xcoff headers for macppc. [macppc-fixcoff] | | 732 | TOOL_MACPPCFIXCOFF Fix up xcoff headers for macppc. [macppc-fixcoff] |
733 | | | 733 | |
734 | TOOL_MAKEFS Create file system image from directory tree. [makefs] | | 734 | TOOL_MAKEFS Create file system image from directory tree. [makefs] |
735 | | | 735 | |
736 | TOOL_MAKEINFO Translate Texinfo documents. [makeinfo] | | 736 | TOOL_MAKEINFO Translate Texinfo documents. [makeinfo] |
737 | | | 737 | |
738 | TOOL_MAKEWHATIS Create a whatis.db database. [makewhatis] | | 738 | TOOL_MAKEWHATIS Create a whatis.db database. [makewhatis] |
739 | | | 739 | |
740 | TOOL_MDSETIMAGE Set kernel RAM disk image. [mdsetimage] | | 740 | TOOL_MDSETIMAGE Set kernel RAM disk image. [mdsetimage] |
741 | | | 741 | |
742 | TOOL_MENUC Menu compiler. [menuc] | | 742 | TOOL_MENUC Menu compiler. [menuc] |
743 | | | 743 | |
744 | TOOL_MIPSELF2ECOFF Convert ELF-format executable to ECOFF for mips. | | 744 | TOOL_MIPSELF2ECOFF Convert ELF-format executable to ECOFF for mips. |
745 | [mips-elf2ecoff] | | 745 | [mips-elf2ecoff] |
746 | | | 746 | |
747 | TOOL_MKCSMAPPER Make charset mapping table. [mkcsmapper] | | 747 | TOOL_MKCSMAPPER Make charset mapping table. [mkcsmapper] |
748 | | | 748 | |
749 | TOOL_MKESDB Make encoding scheme database. [mkesdb] | | 749 | TOOL_MKESDB Make encoding scheme database. [mkesdb] |
750 | | | 750 | |
751 | TOOL_MKLOCALE Make LC_CTYPE locale files. [mklocale] | | 751 | TOOL_MKLOCALE Make LC_CTYPE locale files. [mklocale] |
752 | | | 752 | |
753 | TOOL_MKMAGIC Create database for file(1). [file] | | 753 | TOOL_MKMAGIC Create database for file(1). [file] |
754 | | | 754 | |
755 | TOOL_MKTEMP Make (unique) temporary file name. [mktemp] | | 755 | TOOL_MKTEMP Make (unique) temporary file name. [mktemp] |
756 | | | 756 | |
757 | TOOL_MSGC Simple message list compiler. [msgc] | | 757 | TOOL_MSGC Simple message list compiler. [msgc] |
758 | | | 758 | |
759 | TOOL_MTREE Map a directory hierarchy. [mtree] | | 759 | TOOL_MTREE Map a directory hierarchy. [mtree] |
760 | | | 760 | |
761 | TOOL_PAX Manipulate file archives and copy directories. [pax] | | 761 | TOOL_PAX Manipulate file archives and copy directories. [pax] |
762 | | | 762 | |
763 | TOOL_PIC Compile pictures for groff. [pic] | | 763 | TOOL_PIC Compile pictures for groff. [pic] |
764 | | | 764 | |
765 | TOOL_PIGZ Parallel compressor. [pigz] | | 765 | TOOL_PIGZ Parallel compressor. [pigz] |
766 | | | 766 | |
767 | TOOL_POWERPCMKBOOTIMAGE Make bootable image for powerpc. [powerpc-mkbootimage] | | 767 | TOOL_POWERPCMKBOOTIMAGE Make bootable image for powerpc. [powerpc-mkbootimage] |
768 | | | 768 | |
769 | TOOL_PWD_MKDB Generate the password databases. [pwd_mkdb] | | 769 | TOOL_PWD_MKDB Generate the password databases. [pwd_mkdb] |
770 | | | 770 | |
771 | TOOL_REFER Preprocess bibliographic references for groff. [refer] | | 771 | TOOL_REFER Preprocess bibliographic references for groff. [refer] |
772 | | | 772 | |
773 | TOOL_ROFF_ASCII Generate ASCII groff output. [nroff] | | 773 | TOOL_ROFF_ASCII Generate ASCII groff output. [nroff] |
774 | | | 774 | |
775 | TOOL_ROFF_DVI Generate DVI groff output. [${TOOL_GROFF} -Tdvi] | | 775 | TOOL_ROFF_DVI Generate DVI groff output. [${TOOL_GROFF} -Tdvi] |
776 | | | 776 | |
777 | TOOL_ROFF_HTML Generate HTML groff output. | | 777 | TOOL_ROFF_HTML Generate HTML groff output. |
778 | [${TOOL_GROFF} -Tlatin1 -mdoc2html] | | 778 | [${TOOL_GROFF} -Tlatin1 -mdoc2html] |
779 | | | 779 | |
780 | TOOL_ROFF_PS Generate PS groff output. [${TOOL_GROFF} -Tps] | | 780 | TOOL_ROFF_PS Generate PS groff output. [${TOOL_GROFF} -Tps] |
781 | | | 781 | |
782 | TOOL_ROFF_RAW Generate "raw" groff output. [${TOOL_GROFF} -Z] | | 782 | TOOL_ROFF_RAW Generate "raw" groff output. [${TOOL_GROFF} -Z] |
783 | | | 783 | |
784 | TOOL_RPCGEN Remote Procedure Call (RPC) protocol compiler. [rpcgen] | | 784 | TOOL_RPCGEN Remote Procedure Call (RPC) protocol compiler. [rpcgen] |
785 | | | 785 | |
786 | TOOL_SED Stream editor. [sed] | | 786 | TOOL_SED Stream editor. [sed] |
787 | | | 787 | |
788 | TOOL_SOELIM Eliminate .so's from groff input. [soelim] | | 788 | TOOL_SOELIM Eliminate .so's from groff input. [soelim] |
789 | | | 789 | |
790 | TOOL_SPARKCRC Generate a crc suitable for use in a sparkive file. | | 790 | TOOL_SPARKCRC Generate a crc suitable for use in a sparkive file. |
791 | [sparkcrc] | | 791 | [sparkcrc] |
792 | | | 792 | |
793 | TOOL_STAT Display file status. [stat] | | 793 | TOOL_STAT Display file status. [stat] |
794 | | | 794 | |
795 | TOOL_STRFILE Create a random access file for storing strings. | | 795 | TOOL_STRFILE Create a random access file for storing strings. |
796 | [strfile] | | 796 | [strfile] |
797 | | | 797 | |
798 | TOOL_SUNLABEL Read or modify a SunOS disk label. [sunlabel] | | 798 | TOOL_SUNLABEL Read or modify a SunOS disk label. [sunlabel] |
799 | | | 799 | |
800 | TOOL_TBL Format tables for groff. [tbl] | | 800 | TOOL_TBL Format tables for groff. [tbl] |
801 | | | 801 | |
802 | TOOL_UUDECODE Uudecode a binary file. [uudecode] | | 802 | TOOL_UUDECODE Uudecode a binary file. [uudecode] |
803 | | | 803 | |
804 | TOOL_VGRIND Grind nice listings of programs. [vgrind -f] | | 804 | TOOL_VGRIND Grind nice listings of programs. [vgrind -f] |
805 | | | 805 | |
806 | TOOL_ZIC Time zone compiler. [zic] | | 806 | TOOL_ZIC Time zone compiler. [zic] |
807 | | | 807 | |
808 | <bsd.own.mk> is generally useful when building your own Makefiles so that | | 808 | <bsd.own.mk> is generally useful when building your own Makefiles so that |
809 | they use the same default owners etc. as the rest of the tree. | | 809 | they use the same default owners etc. as the rest of the tree. |
810 | | | 810 | |
811 | | | 811 | |
812 | =-=-=-=-= bsd.clean.mk =-=-=-=-= | | 812 | =-=-=-=-= bsd.clean.mk =-=-=-=-= |
813 | | | 813 | |
814 | The include file <bsd.clean.mk> defines the clean and cleandir | | 814 | The include file <bsd.clean.mk> defines the clean and cleandir |
815 | targets. It uses the following variables: | | 815 | targets. It uses the following variables: |
816 | | | 816 | |
817 | CLEANFILES Files to remove for both the clean and cleandir targets. | | 817 | CLEANFILES Files to remove for both the clean and cleandir targets. |
818 | | | 818 | |
819 | CLEANDIRFILES Files to remove for the cleandir target, but not for | | 819 | CLEANDIRFILES Files to remove for the cleandir target, but not for |
820 | the clean target. | | 820 | the clean target. |
821 | | | 821 | |
822 | MKCLEANSRC Controls whether or not the clean and cleandir targets | | 822 | MKCLEANSRC Controls whether or not the clean and cleandir targets |
823 | will delete files from both the object directory, | | 823 | will delete files from both the object directory, |
824 | ${.OBJDIR}, and the source directory, ${.CURDIR}. | | 824 | ${.OBJDIR}, and the source directory, ${.CURDIR}. |
825 | | | 825 | |
826 | If MKCLEANSRC is set to "no", then the file names in | | 826 | If MKCLEANSRC is set to "no", then the file names in |
827 | CLEANFILES or CLEANDIRFILES are interpreted relative | | 827 | CLEANFILES or CLEANDIRFILES are interpreted relative |
828 | to the object directory, ${.OBJDIR}. This is the | | 828 | to the object directory, ${.OBJDIR}. This is the |
829 | traditional behaviour. | | 829 | traditional behaviour. |
830 | | | 830 | |
831 | If MKCLEANSRC is set to "yes", then the file deletion | | 831 | If MKCLEANSRC is set to "yes", then the file deletion |
832 | is performed relative to both the object directory, | | 832 | is performed relative to both the object directory, |
833 | ${.OBJDIR}, and the source directory, ${.CURDIR}. (This | | 833 | ${.OBJDIR}, and the source directory, ${.CURDIR}. (This |
834 | has no effect if ${.OBJDIR} is the same as ${.CURDIR}.) | | 834 | has no effect if ${.OBJDIR} is the same as ${.CURDIR}.) |
835 | Deleting files from ${.CURDIR} is intended to remove | | 835 | Deleting files from ${.CURDIR} is intended to remove |
836 | stray output files that had been left in the source | | 836 | stray output files that had been left in the source |
837 | directory by an earlier build that did not use object | | 837 | directory by an earlier build that did not use object |
838 | directories. | | 838 | directories. |
839 | | | 839 | |
840 | The default is MKCLEANSRC=yes. If you always build with | | 840 | The default is MKCLEANSRC=yes. If you always build with |
841 | separate object directories, and you are sure that there | | 841 | separate object directories, and you are sure that there |
842 | are no stray files in the source directories, then you | | 842 | are no stray files in the source directories, then you |
843 | may set MKCLEANSRC=no to save some time. | | 843 | may set MKCLEANSRC=no to save some time. |
844 | | | 844 | |
845 | MKCLEANVERIFY Controls whether or not the clean and cleandir targets | | 845 | MKCLEANVERIFY Controls whether or not the clean and cleandir targets |
846 | will verify that files have been deleted. | | 846 | will verify that files have been deleted. |
847 | | | 847 | |
848 | If MKCLEANVERIFY is set to "no", then the files will | | 848 | If MKCLEANVERIFY is set to "no", then the files will |
849 | be deleted using a "rm -f" command, and its success or | | 849 | be deleted using a "rm -f" command, and its success or |
850 | failure will be ignored. | | 850 | failure will be ignored. |
851 | | | 851 | |
852 | If MKCLEANVERIFY is set to "yes", then the success of | | 852 | If MKCLEANVERIFY is set to "yes", then the success of |
853 | the "rm -f" command will be verified using an "ls" | | 853 | the "rm -f" command will be verified using an "ls" |
854 | command. | | 854 | command. |
855 | | | 855 | |
856 | The default is MKCLEANVERIFY=yes. If you are sure that | | 856 | The default is MKCLEANVERIFY=yes. If you are sure that |
857 | there will be no problems caused by file permissions, | | 857 | there will be no problems caused by file permissions, |
858 | read-only file systems, or the like, then you may set | | 858 | read-only file systems, or the like, then you may set |
859 | MKCLEANVERIFY=no to save some time. | | 859 | MKCLEANVERIFY=no to save some time. |
860 | | | 860 | |
861 | To use the clean and cleandir targets defined in <bsd.clean.mk>, other | | 861 | To use the clean and cleandir targets defined in <bsd.clean.mk>, other |
862 | Makefiles or bsd.*.mk files should append file names to the CLEANFILES | | 862 | Makefiles or bsd.*.mk files should append file names to the CLEANFILES |
863 | or CLEANDIRFILES variables. For example: | | 863 | or CLEANDIRFILES variables. For example: |
864 | | | 864 | |
865 | CLEANFILES+= a.out | | 865 | CLEANFILES+= a.out |
866 | CLEANDIRFILES+= .depend | | 866 | CLEANDIRFILES+= .depend |
867 | | | 867 | |
868 | .include <bsd.clean.mk> | | 868 | .include <bsd.clean.mk> |
869 | | | 869 | |
870 | | | 870 | |
871 | =-=-=-=-= bsd.dep.mk =-=-=-=-= | | 871 | =-=-=-=-= bsd.dep.mk =-=-=-=-= |
872 | | | 872 | |
873 | The include file <bsd.dep.mk> contains the default targets for building | | 873 | The include file <bsd.dep.mk> contains the default targets for building |
874 | .depend files. It creates .d files from entries in SRCS and DPSRCS | | 874 | .depend files. It creates .d files from entries in SRCS and DPSRCS |
875 | that are C, C++, or Objective C source files, and builds .depend from the | | 875 | that are C, C++, or Objective C source files, and builds .depend from the |
876 | .d files. All other files in SRCS and all of DPSRCS will be used as | | 876 | .d files. All other files in SRCS and all of DPSRCS will be used as |
877 | dependencies for the .d files. In order for this to function correctly, | | 877 | dependencies for the .d files. In order for this to function correctly, |
878 | it should be .included after all other .mk files and directives that may | | 878 | it should be .included after all other .mk files and directives that may |
879 | modify SRCS or DPSRCS. It uses the following variables: | | 879 | modify SRCS or DPSRCS. It uses the following variables: |
880 | | | 880 | |
881 | SRCS List of source files to build the program. | | 881 | SRCS List of source files to build the program. |
882 | | | 882 | |
883 | DPSRCS List of source files which are needed for generating | | 883 | DPSRCS List of source files which are needed for generating |
884 | dependencies, but are not needed in ${SRCS}. | | 884 | dependencies, but are not needed in ${SRCS}. |
885 | | | 885 | |
886 | | | 886 | |
887 | =-=-=-=-= bsd.files.mk =-=-=-=-= | | 887 | =-=-=-=-= bsd.files.mk =-=-=-=-= |
888 | | | 888 | |
889 | The include file <bsd.files.mk> handles the FILES variables and is included | | 889 | The include file <bsd.files.mk> handles the FILES variables and is included |
890 | from <bsd.lib.mk> and <bsd.prog.mk>, and uses the following variables: | | 890 | from <bsd.lib.mk> and <bsd.prog.mk>, and uses the following variables: |
891 | | | 891 | |
892 | FILES The list of files to install. | | 892 | FILES The list of files to install. |
893 | | | 893 | |
894 | CONFIGFILES Similar semantics to FILES, except that the files | | 894 | CONFIGFILES Similar semantics to FILES, except that the files |
895 | are installed by the `configinstall' target, | | 895 | are installed by the `configinstall' target, |
896 | not the `install' target. | | 896 | not the `install' target. |
897 | The FILES* variables documented below also apply. | | 897 | The FILES* variables documented below also apply. |
898 | | | 898 | |
899 | FILESOWN File owner. [${BINOWN}] | | 899 | FILESOWN File owner. [${BINOWN}] |
900 | | | 900 | |
901 | FILESGRP File group. [${BINGRP}] | | 901 | FILESGRP File group. [${BINGRP}] |
902 | | | 902 | |
903 | FILESMODE File mode. [${NONBINMODE}] | | 903 | FILESMODE File mode. [${NONBINMODE}] |
904 | | | 904 | |
905 | FILESDIR The location to install the files. | | 905 | FILESDIR The location to install the files. |
906 | | | 906 | |
907 | FILESNAME Optional name to install each file as. | | 907 | FILESNAME Optional name to install each file as. |
908 | | | 908 | |
909 | FILESOWN_<fn> File owner of the specific file <fn>. | | 909 | FILESOWN_<fn> File owner of the specific file <fn>. |
910 | | | 910 | |
911 | FILESGRP_<fn> File group of the specific file <fn>. | | 911 | FILESGRP_<fn> File group of the specific file <fn>. |
912 | | | 912 | |
913 | FILESMODE_<fn> File mode of the specific file <fn>. | | 913 | FILESMODE_<fn> File mode of the specific file <fn>. |
914 | | | 914 | |
915 | FILESDIR_<fn> The location to install the specific file <fn>. | | 915 | FILESDIR_<fn> The location to install the specific file <fn>. |
916 | | | 916 | |
917 | FILESNAME_<fn> Optional name to install <fn> as. | | 917 | FILESNAME_<fn> Optional name to install <fn> as. |
918 | | | 918 | |
919 | FILESBUILD If this variable is defined, then its value will be | | 919 | FILESBUILD If this variable is defined, then its value will be |
920 | used as the default for all FILESBUILD_<fn> variables. | | 920 | used as the default for all FILESBUILD_<fn> variables. |
921 | Otherwise, the default will be "no". | | 921 | Otherwise, the default will be "no". |
922 | | | 922 | |
923 | FILESBUILD_<fn> A value different from "no" will add the file to the list of | | 923 | FILESBUILD_<fn> A value different from "no" will add the file to the list of |
924 | targets to be built by `realall'. Users of that variable | | 924 | targets to be built by `realall'. Users of that variable |
925 | should provide a target to build the file. | | 925 | should provide a target to build the file. |
926 | | | 926 | |
927 | | | 927 | |
928 | BUILDSYMLINKS List of two word items: | | 928 | BUILDSYMLINKS List of two word items: |
929 | lnsrc lntgt | | 929 | lnsrc lntgt |
930 | For each lnsrc item, create a symlink named lntgt. | | 930 | For each lnsrc item, create a symlink named lntgt. |
931 | The lntgt symlinks are removed by the cleandir target. | | 931 | The lntgt symlinks are removed by the cleandir target. |
932 | | | 932 | |
933 | UUDECODE_FILES List of files which are stored as <file>.uue in the source | | 933 | UUDECODE_FILES List of files which are stored as <file>.uue in the source |
934 | tree. Each one will be decoded with ${TOOL_UUDECODE}. | | 934 | tree. Each one will be decoded with ${TOOL_UUDECODE}. |
935 | The source files have a `.uue' suffix, the generated files do | | 935 | The source files have a `.uue' suffix, the generated files do |
936 | not. | | 936 | not. |
937 | | | 937 | |
938 | UUDECODE_FILES_RENAME_<fn> | | 938 | UUDECODE_FILES_RENAME_<fn> |
939 | Rename the output from the decode to the provided name. | | 939 | Rename the output from the decode to the provided name. |
940 | | | 940 | |
941 | *NOTE: These files are simply decoded, with no install or other | | 941 | *NOTE: These files are simply decoded, with no install or other |
942 | rule applying implicitly except being added to the clean | | 942 | rule applying implicitly except being added to the clean |
943 | target. | | 943 | target. |
944 | | | 944 | |
945 | =-=-=-=-= bsd.gcc.mk =-=-=-=-= | | 945 | =-=-=-=-= bsd.gcc.mk =-=-=-=-= |
946 | | | 946 | |
947 | The include file <bsd.gcc.mk> computes various parameters related to GCC | | 947 | The include file <bsd.gcc.mk> computes various parameters related to GCC |
948 | support libraries. It defines no targets. <bsd.own.mk> MUST be included | | 948 | support libraries. It defines no targets. <bsd.own.mk> MUST be included |
949 | before <bsd.gcc.mk>. | | 949 | before <bsd.gcc.mk>. |
950 | | | 950 | |
951 | The primary users of <bsd.gcc.mk> are <bsd.prog.mk> and <bsd.lib.mk>, each | | 951 | The primary users of <bsd.gcc.mk> are <bsd.prog.mk> and <bsd.lib.mk>, each |
952 | of which need to know where to find certain GCC support libraries. | | 952 | of which need to know where to find certain GCC support libraries. |
953 | | | 953 | |
954 | The behavior of <bsd.gcc.mk> is influenced by the EXTERNAL_TOOLCHAIN variable, | | 954 | The behavior of <bsd.gcc.mk> is influenced by the EXTERNAL_TOOLCHAIN variable, |
955 | which is generally set by the user. If EXTERNAL_TOOLCHAIN it set, then | | 955 | which is generally set by the user. If EXTERNAL_TOOLCHAIN it set, then |
956 | the compiler is asked where to find the support libraries, otherwise the | | 956 | the compiler is asked where to find the support libraries, otherwise the |
957 | support libraries are found in ${DESTDIR}/usr/lib. | | 957 | support libraries are found in ${DESTDIR}/usr/lib. |
958 | | | 958 | |
959 | <bsd.gcc.mk> sets the following variables: | | 959 | <bsd.gcc.mk> sets the following variables: |
960 | | | 960 | |
961 | _GCC_CRTBEGIN The full path name to crtbegin.o. | | 961 | _GCC_CRTBEGIN The full path name to crtbegin.o. |
962 | | | 962 | |
963 | _GCC_CRTBEGINS The full path name to crtbeginS.o. | | 963 | _GCC_CRTBEGINS The full path name to crtbeginS.o. |
964 | | | 964 | |
965 | _GCC_CRTEND The full path name to crtend.o. | | 965 | _GCC_CRTEND The full path name to crtend.o. |
966 | | | 966 | |
967 | _GCC_CRTENDS The full path name to crtendS.o. | | 967 | _GCC_CRTENDS The full path name to crtendS.o. |
968 | | | 968 | |
969 | _GCC_LIBGCCDIR The directory where libgcc.a is located. | | 969 | _GCC_LIBGCCDIR The directory where libgcc.a is located. |
970 | | | 970 | |
971 | | | 971 | |
972 | =-=-=-=-= bsd.inc.mk =-=-=-=-= | | 972 | =-=-=-=-= bsd.inc.mk =-=-=-=-= |
973 | | | 973 | |
974 | The include file <bsd.inc.mk> defines the includes target and uses the | | 974 | The include file <bsd.inc.mk> defines the includes target and uses the |
975 | variables: | | 975 | variables: |
976 | | | 976 | |
977 | INCS The list of include files. | | 977 | INCS The list of include files. |
978 | | | 978 | |
979 | INCSDIR The location to install the include files. | | 979 | INCSDIR The location to install the include files. |
980 | | | 980 | |
981 | INCSNAME Target name of the include file, if only one; same as | | 981 | INCSNAME Target name of the include file, if only one; same as |
982 | FILESNAME, but for include files. | | 982 | FILESNAME, but for include files. |
983 | | | 983 | |
984 | INCSYMLINKS Similar to SYMLINKS in <bsd.links.mk>, except that these | | 984 | INCSYMLINKS Similar to SYMLINKS in <bsd.links.mk>, except that these |
985 | are installed in the 'includes' target and not the | | 985 | are installed in the 'includes' target and not the |
986 | (much later) 'install' target. | | 986 | (much later) 'install' target. |
987 | | | 987 | |
988 | INCSNAME_<file> The name file <file> should be installed as, if not <file>, | | 988 | INCSNAME_<file> The name file <file> should be installed as, if not <file>, |
989 | same as FILESNAME_<file>, but for include files. | | 989 | same as FILESNAME_<file>, but for include files. |
990 | | | 990 | |
991 | | | 991 | |
992 | =-=-=-=-= bsd.info.mk =-=-=-=-= | | 992 | =-=-=-=-= bsd.info.mk =-=-=-=-= |
993 | | | 993 | |
994 | The include file <bsd.info.mk> is used to generate and install GNU Info | | 994 | The include file <bsd.info.mk> is used to generate and install GNU Info |
995 | documentation from respective Texinfo source files. It defines three | | 995 | documentation from respective Texinfo source files. It defines three |
996 | implicit targets (.txi.info, .texi.info, and .texinfo.info), and uses the | | 996 | implicit targets (.txi.info, .texi.info, and .texinfo.info), and uses the |
997 | following variables: | | 997 | following variables: |
998 | | | 998 | |
999 | TEXINFO List of Texinfo source files. Info documentation will | | 999 | TEXINFO List of Texinfo source files. Info documentation will |
1000 | consist of single files with the extension replaced by | | 1000 | consist of single files with the extension replaced by |
1001 | .info. | | 1001 | .info. |
1002 | | | 1002 | |
1003 | INFOFLAGS Flags to pass to makeinfo. [] | | 1003 | INFOFLAGS Flags to pass to makeinfo. [] |
1004 | | | 1004 | |
1005 | | | 1005 | |
1006 | =-=-=-=-= bsd.kernobj.mk =-=-=-=-= | | 1006 | =-=-=-=-= bsd.kernobj.mk =-=-=-=-= |
1007 | | | 1007 | |
1008 | The include file <bsd.kernobj.mk> defines variables related to the | | 1008 | The include file <bsd.kernobj.mk> defines variables related to the |
1009 | location of kernel sources and object directories. | | 1009 | location of kernel sources and object directories. |
1010 | | | 1010 | |
1011 | KERNSRCDIR Is the location of the top of the kernel src. | | 1011 | KERNSRCDIR Is the location of the top of the kernel src. |
1012 | [${_SRC_TOP_}/sys] | | 1012 | [${_SRC_TOP_}/sys] |
1013 | | | 1013 | |
1014 | KERNARCHDIR Is the location of the machine dependent kernel sources. | | 1014 | KERNARCHDIR Is the location of the machine dependent kernel sources. |
1015 | [arch/${MACHINE}] | | 1015 | [arch/${MACHINE}] |
1016 | | | 1016 | |
1017 | KERNCONFDIR Is where the configuration files for kernels are found. | | 1017 | KERNCONFDIR Is where the configuration files for kernels are found. |
1018 | [${KERNSRCDIR}/${KERNARCHDIR}/conf] | | 1018 | [${KERNSRCDIR}/${KERNARCHDIR}/conf] |
1019 | | | 1019 | |
1020 | KERNOBJDIR Is the kernel build directory. The kernel GENERIC for | | 1020 | KERNOBJDIR Is the kernel build directory. The kernel GENERIC for |
1021 | instance will be compiled in ${KERNOBJDIR}/GENERIC. | | 1021 | instance will be compiled in ${KERNOBJDIR}/GENERIC. |
1022 | The default value is | | 1022 | The default value is |
1023 | ${MAKEOBJDIRPREFIX}${KERNSRCDIR}/${KERNARCHDIR}/compile | | 1023 | ${MAKEOBJDIRPREFIX}${KERNSRCDIR}/${KERNARCHDIR}/compile |
1024 | if it exists or the target 'obj' is being made. | | 1024 | if it exists or the target 'obj' is being made. |
1025 | Otherwise the default is | | 1025 | Otherwise the default is |
1026 | ${KERNSRCDIR}/${KERNARCHDIR}/compile. | | 1026 | ${KERNSRCDIR}/${KERNARCHDIR}/compile. |
1027 | | | 1027 | |
1028 | It is important that Makefiles (such as those under src/distrib) that | | 1028 | It is important that Makefiles (such as those under src/distrib) that |
1029 | wish to find compiled kernels use <bsd.kernobj.mk> and ${KERNOBJDIR} | | 1029 | wish to find compiled kernels use <bsd.kernobj.mk> and ${KERNOBJDIR} |
1030 | rather than make assumptions about the location of the compiled kernel. | | 1030 | rather than make assumptions about the location of the compiled kernel. |
1031 | | | 1031 | |
1032 | | | 1032 | |
1033 | =-=-=-=-= bsd.kinc.mk =-=-=-=-= | | 1033 | =-=-=-=-= bsd.kinc.mk =-=-=-=-= |
1034 | | | 1034 | |
1035 | The include file <bsd.kinc.mk> defines the many targets (includes, | | 1035 | The include file <bsd.kinc.mk> defines the many targets (includes, |
1036 | subdirectories, etc.), and is used by kernel makefiles to handle | | 1036 | subdirectories, etc.), and is used by kernel makefiles to handle |
1037 | include file installation. It is intended to be included alone, by | | 1037 | include file installation. It is intended to be included alone, by |
1038 | kernel Makefiles. It uses similar variables to <bsd.inc.mk>. | | 1038 | kernel Makefiles. It uses similar variables to <bsd.inc.mk>. |
1039 | Please see <bsd.kinc.mk> for more details, and keep the documentation | | 1039 | Please see <bsd.kinc.mk> for more details, and keep the documentation |
1040 | in that file up to date. | | 1040 | in that file up to date. |
1041 | | | 1041 | |
1042 | | | 1042 | |
1043 | =-=-=-=-= bsd.lib.mk =-=-=-=-= | | 1043 | =-=-=-=-= bsd.lib.mk =-=-=-=-= |
1044 | | | 1044 | |
1045 | The include file <bsd.lib.mk> has support for building libraries. It has | | 1045 | The include file <bsd.lib.mk> has support for building libraries. It has |
1046 | the same eight targets as <bsd.prog.mk>: all, clean, cleandir, depend, | | 1046 | the same eight targets as <bsd.prog.mk>: all, clean, cleandir, depend, |
1047 | includes, install, lint, and tags. Additionally, it has a checkver target | | 1047 | includes, install, lint, and tags. Additionally, it has a checkver target |
1048 | which checks for installed shared object libraries whose version is greater | | 1048 | which checks for installed shared object libraries whose version is greater |
1049 | that the version of the source. It has a limited number of suffixes, | | 1049 | that the version of the source. It has a limited number of suffixes, |
1050 | consistent with the current needs of the BSD tree. <bsd.lib.mk> includes | | 1050 | consistent with the current needs of the BSD tree. <bsd.lib.mk> includes |
1051 | <bsd.shlib.mk> to get shared library parameters. | | 1051 | <bsd.shlib.mk> to get shared library parameters. |
1052 | | | 1052 | |
1053 | It sets/uses the following variables: | | 1053 | It sets/uses the following variables: |
1054 | | | 1054 | |
1055 | LIB The name of the library to build. | | 1055 | LIB The name of the library to build. |
1056 | | | 1056 | |
1057 | LIBDIR Target directory for libraries. | | 1057 | LIBDIR Target directory for libraries. |
1058 | | | 1058 | |
1059 | MKARZERO Normally, ar(1) sets the timestamps, uid, gid and | | 1059 | MKARZERO Normally, ar(1) sets the timestamps, uid, gid and |
1060 | permissions in files inside its archives to those of | | 1060 | permissions in files inside its archives to those of |
1061 | the file it was fed. This leads to non-reproduceable | | 1061 | the file it was fed. This leads to non-reproduceable |
1062 | builds. If MKARZERO is set to "yes" (default is "no") | | 1062 | builds. If MKARZERO is set to "yes" (default is "no") |
1063 | then the "D" flag is passed to ar, causing the | | 1063 | then the "D" flag is passed to ar, causing the |
1064 | timestamp, uid and gid to be zeroed and the file | | 1064 | timestamp, uid and gid to be zeroed and the file |
1065 | permissions to be set to 644. This allows .a files | | 1065 | permissions to be set to 644. This allows .a files |
1066 | from different builds to be bit identical. | | 1066 | from different builds to be bit identical. |
1067 | | | 1067 | |
1068 | SHLIBINSTALLDIR Target directory for shared libraries if ${USE_SHLIBDIR} | | 1068 | SHLIBINSTALLDIR Target directory for shared libraries if ${USE_SHLIBDIR} |
1069 | is not "no". | | 1069 | is not "no". |
1070 | | | 1070 | |
1071 | SHLIB_MAJOR | | 1071 | SHLIB_MAJOR |
1072 | SHLIB_MINOR | | 1072 | SHLIB_MINOR |
1073 | SHLIB_TEENY Major, minor, and teeny version numbers of shared library | | 1073 | SHLIB_TEENY Major, minor, and teeny version numbers of shared library |
1074 | | | 1074 | |
1075 | USE_SHLIBDIR If not "no", use ${SHLIBINSTALLDIR} instead of ${LIBDIR} | | 1075 | USE_SHLIBDIR If not "no", use ${SHLIBINSTALLDIR} instead of ${LIBDIR} |
1076 | as the path to install shared libraries to. | | 1076 | as the path to install shared libraries to. |
1077 | USE_SHLIBDIR must be defined before <bsd.own.mk> is included. | | 1077 | USE_SHLIBDIR must be defined before <bsd.own.mk> is included. |
1078 | Default: no | | 1078 | Default: no |
1079 | | | 1079 | |
1080 | LIBISMODULE If not "no", install as ${LIB}.so (without the "lib" prefix), | | 1080 | LIBISMODULE If not "no", install as ${LIB}.so (without the "lib" prefix), |
1081 | and act as "MKDEBUGLIB=no MKLINT=no MKPICINSTALL=no | | 1081 | and act as "MKDEBUGLIB=no MKLINT=no MKPICINSTALL=no |
1082 | MKPROFILE=no MKSTATICLIB=no". | | 1082 | MKPROFILE=no MKSTATICLIB=no". |
1083 | Default: no | | 1083 | Default: no |
1084 | | | 1084 | |
1085 | LIBISPRIVATE If not "no", act as "MKDEBUGLIB=no MKLINT=no MKPIC=no | | 1085 | LIBISPRIVATE If not "no", act as "MKDEBUGLIB=no MKLINT=no MKPIC=no |
1086 | MKPROFILE=no", and don't install the (.a) library. | | 1086 | MKPROFILE=no", and don't install the (.a) library. |
1087 | This is useful for "build only" helper libraries. | | 1087 | This is useful for "build only" helper libraries. |
1088 | Default: no | | 1088 | Default: no |
1089 | | | 1089 | |
1090 | LIBISCXX If not "no", Use ${CXX} instead of ${CC} to link | | 1090 | LIBISCXX If not "no", Use ${CXX} instead of ${CC} to link |
1091 | shared libraries. | | 1091 | shared libraries. |
1092 | This is useful for C++ libraries. | | 1092 | This is useful for C++ libraries. |
1093 | Default: no | | 1093 | Default: no |
1094 | | | 1094 | |
1095 | LINTLIBDIR Target directory for lint libraries. | | 1095 | LINTLIBDIR Target directory for lint libraries. |
1096 | | | 1096 | |
1097 | LIBGRP Library group. | | 1097 | LIBGRP Library group. |
1098 | | | 1098 | |
1099 | LIBOWN Library owner. | | 1099 | LIBOWN Library owner. |
1100 | | | 1100 | |
1101 | LIBMODE Library mode. | | 1101 | LIBMODE Library mode. |
1102 | | | 1102 | |
1103 | LDADD Additional loader objects. | | 1103 | LDADD Additional loader objects. |
1104 | | | 1104 | |
1105 | MAN The manual pages to be installed (use a .1 - .9 suffix). | | 1105 | MAN The manual pages to be installed (use a .1 - .9 suffix). |
1106 | | | 1106 | |
1107 | NOCHECKVER_<library> | | 1107 | NOCHECKVER_<library> |
1108 | NOCHECKVER If set, disables checking for installed shared object | | 1108 | NOCHECKVER If set, disables checking for installed shared object |
1109 | libraries with versions greater than the source. A | | 1109 | libraries with versions greater than the source. A |
1110 | particular library name, without the "lib" prefix, may | | 1110 | particular library name, without the "lib" prefix, may |
1111 | be appended to the variable name to disable the check for | | 1111 | be appended to the variable name to disable the check for |
1112 | only that library. | | 1112 | only that library. |
1113 | | | 1113 | |
1114 | SRCS List of source files to build the library. Suffix types | | 1114 | SRCS List of source files to build the library. Suffix types |
1115 | .s, .c, and .f are supported. Note, .s files are preferred | | 1115 | .s, .c, and .f are supported. Note, .s files are preferred |
1116 | to .c files of the same name. (This is not the default for | | 1116 | to .c files of the same name. (This is not the default for |
1117 | versions of make.) | | 1117 | versions of make.) |
1118 | | | 1118 | |
1119 | LIBDPLIBS A list of the tuples: | | 1119 | LIBDPLIBS A list of the tuples: |
1120 | libname path-to-srcdir-of-libname | | 1120 | libname path-to-srcdir-of-libname |
1121 | | | 1121 | |
1122 | For each tuple; | | 1122 | For each tuple; |
1123 | * LIBDO.libname contains the .OBJDIR of the library | | 1123 | * LIBDO.libname contains the .OBJDIR of the library |
1124 | `libname', and if it is not set it is determined | | 1124 | `libname', and if it is not set it is determined |
1125 | from the srcdir and added to MAKEOVERRIDES (the | | 1125 | from the srcdir and added to MAKEOVERRIDES (the |
1126 | latter is to allow for build time optimization). | | 1126 | latter is to allow for build time optimization). |
1127 | * LDADD gets -L${LIBDO.libname} -llibname added. | | 1127 | * LDADD gets -L${LIBDO.libname} -llibname added. |
1128 | * DPADD gets ${LIBDO.libname}/liblibname.so or | | 1128 | * DPADD gets ${LIBDO.libname}/liblibname.so or |
1129 | ${LIBDO.libname}/liblibname.a added. | | 1129 | ${LIBDO.libname}/liblibname.a added. |
1130 | | | 1130 | |
1131 | This variable may be used for individual libraries, as | | 1131 | This variable may be used for individual libraries, as |
1132 | well as in parent directories to cache common libraries | | 1132 | well as in parent directories to cache common libraries |
1133 | as a build-time optimization. | | 1133 | as a build-time optimization. |
1134 | | | 1134 | |
1135 | The include file <bsd.lib.mk> includes the file named "../Makefile.inc" | | 1135 | The include file <bsd.lib.mk> includes the file named "../Makefile.inc" |
1136 | if it exists, as well as the include file <bsd.man.mk>. | | 1136 | if it exists, as well as the include file <bsd.man.mk>. |
1137 | | | 1137 | |
1138 | It has rules for building profiled objects; profiled libraries are | | 1138 | It has rules for building profiled objects; profiled libraries are |
1139 | built by default. | | 1139 | built by default. |
1140 | | | 1140 | |
1141 | Libraries are ranlib'd when made. | | 1141 | Libraries are ranlib'd when made. |
1142 | | | 1142 | |
1143 | | | 1143 | |
1144 | =-=-=-=-= bsd.links.mk =-=-=-=-= | | 1144 | =-=-=-=-= bsd.links.mk =-=-=-=-= |
1145 | | | 1145 | |
1146 | The include file <bsd.links.mk> handles the LINKS and SYMLINKS variables | | 1146 | The include file <bsd.links.mk> handles the LINKS and SYMLINKS variables |
1147 | and is included from from <bsd.lib.mk> and <bsd.prog.mk>. | | 1147 | and is included from from <bsd.lib.mk> and <bsd.prog.mk>. |
1148 | | | 1148 | |
1149 | LINKSOWN, LINKSGRP, and LINKSMODE, are relevant only if a metadata log | | 1149 | LINKSOWN, LINKSGRP, and LINKSMODE, are relevant only if a metadata log |
1150 | is used. The defaults may be modified by other bsd.*.mk files which | | 1150 | is used. The defaults may be modified by other bsd.*.mk files which |
1151 | include bsd.links.mk. In the future, these variables may be replaced | | 1151 | include bsd.links.mk. In the future, these variables may be replaced |
1152 | by a method for explicitly recording hard links in a metadata log. | | 1152 | by a method for explicitly recording hard links in a metadata log. |
1153 | | | 1153 | |
1154 | LINKS The list of hard links, consisting of pairs of paths: | | 1154 | LINKS The list of hard links, consisting of pairs of paths: |
1155 | source-file target-file | | 1155 | source-file target-file |
1156 | ${DESTDIR} is prepended to both paths before linking. | | 1156 | ${DESTDIR} is prepended to both paths before linking. |
1157 | For example, to link /bin/test and /bin/[, use: | | 1157 | For example, to link /bin/test and /bin/[, use: |
1158 | LINKS=/bin/test /bin/[ | | 1158 | LINKS=/bin/test /bin/[ |
1159 | | | 1159 | |
1160 | CONFIGLINKS Similar semantics to LINKS, except that the links | | 1160 | CONFIGLINKS Similar semantics to LINKS, except that the links |
1161 | are installed by the `configinstall' target, | | 1161 | are installed by the `configinstall' target, |
1162 | not the `install' target. | | 1162 | not the `install' target. |
1163 | | | 1163 | |
1164 | SYMLINKS The list of symbolic links, consisting of pairs of paths: | | 1164 | SYMLINKS The list of symbolic links, consisting of pairs of paths: |
1165 | source-file target-file | | 1165 | source-file target-file |
1166 | ${DESTDIR} is only prepended to target-file before linking. | | 1166 | ${DESTDIR} is only prepended to target-file before linking. |
1167 | For example, to symlink /usr/bin/tar to /bin/tar resulting | | 1167 | For example, to symlink /usr/bin/tar to /bin/tar resulting |
1168 | in ${DESTDIR}/usr/bin/tar -> /bin/tar: | | 1168 | in ${DESTDIR}/usr/bin/tar -> /bin/tar: |
1169 | SYMLINKS=/bin/tar /usr/bin/tar | | 1169 | SYMLINKS=/bin/tar /usr/bin/tar |
1170 | | | 1170 | |
1171 | CONFIGSYMLINKS Similar semantics to SYMLINKS, except that the symbolic links | | 1171 | CONFIGSYMLINKS Similar semantics to SYMLINKS, except that the symbolic links |
1172 | are installed by the `configinstall' target, | | 1172 | are installed by the `configinstall' target, |
1173 | not the `install' target. | | 1173 | not the `install' target. |
1174 | | | 1174 | |
1175 | LINKSOWN Link owner. [${BINOWN}] | | 1175 | LINKSOWN Link owner. [${BINOWN}] |
1176 | | | 1176 | |
1177 | LINKSGRP Link group. [${BINGRP}] | | 1177 | LINKSGRP Link group. [${BINGRP}] |
1178 | | | 1178 | |
1179 | LINKSMODE Link mode. [${NONBINMODE}] | | 1179 | LINKSMODE Link mode. [${NONBINMODE}] |
1180 | | | 1180 | |
1181 | LINKSOWN_<fn> Link owner of the specific file <fn>. | | 1181 | LINKSOWN_<fn> Link owner of the specific file <fn>. |
1182 | | | 1182 | |
1183 | LINKSGRP_<fn> Link group of the specific file <fn>. | | 1183 | LINKSGRP_<fn> Link group of the specific file <fn>. |
1184 | | | 1184 | |
1185 | LINKSMODE_<fn> Link mode of the specific file <fn>. | | 1185 | LINKSMODE_<fn> Link mode of the specific file <fn>. |
1186 | | | 1186 | |
1187 | | | 1187 | |
1188 | =-=-=-=-= bsd.man.mk =-=-=-=-= | | 1188 | =-=-=-=-= bsd.man.mk =-=-=-=-= |
1189 | | | 1189 | |
1190 | The include file <bsd.man.mk> handles installing manual pages and their | | 1190 | The include file <bsd.man.mk> handles installing manual pages and their |
1191 | links. | | 1191 | links. |
1192 | | | 1192 | |
1193 | It has a three targets: | | 1193 | It has a three targets: |
1194 | | | 1194 | |
1195 | catinstall: | | 1195 | catinstall: |
1196 | Install the preformatted manual pages and their links. | | 1196 | Install the preformatted manual pages and their links. |
1197 | htmlinstall: | | 1197 | htmlinstall: |
1198 | Install the HTML manual pages and their links. | | 1198 | Install the HTML manual pages and their links. |
1199 | maninstall: | | 1199 | maninstall: |
1200 | Install the manual page sources and their links. | | 1200 | Install the manual page sources and their links. |
1201 | | | 1201 | |
1202 | It sets/uses the following variables: | | 1202 | It sets/uses the following variables: |
1203 | | | 1203 | |
1204 | MANDIR Base path for manual installation. | | 1204 | MANDIR Base path for manual installation. |
1205 | | | 1205 | |
1206 | MANGRP Manual group. | | 1206 | MANGRP Manual group. |
1207 | | | 1207 | |
1208 | MANOWN Manual owner. | | 1208 | MANOWN Manual owner. |
1209 | | | 1209 | |
1210 | MANMODE Manual mode. | | 1210 | MANMODE Manual mode. |
1211 | | | 1211 | |
1212 | MANSUBDIR Subdirectory under the manual page section, i.e. "/vax" | | 1212 | MANSUBDIR Subdirectory under the manual page section, i.e. "/vax" |
1213 | or "/tahoe" for machine specific manual pages. | | 1213 | or "/tahoe" for machine specific manual pages. |
1214 | | | 1214 | |
1215 | MAN The manual pages to be installed (use a .1 - .9 suffix). | | 1215 | MAN The manual pages to be installed (use a .1 - .9 suffix). |
1216 | | | 1216 | |
1217 | MLINKS List of manual page links (using a .1 - .9 suffix). The | | 1217 | MLINKS List of manual page links (using a .1 - .9 suffix). The |
1218 | linked-to file must come first, the linked file second, | | 1218 | linked-to file must come first, the linked file second, |
1219 | and there may be multiple pairs. | | 1219 | and there may be multiple pairs. |
1220 | | | 1220 | |
1221 | The include file <bsd.man.mk> includes a file named "../Makefile.inc" if | | 1221 | The include file <bsd.man.mk> includes a file named "../Makefile.inc" if |
1222 | it exists. | | 1222 | it exists. |
1223 | | | 1223 | |
1224 | | | 1224 | |
1225 | =-=-=-=-= bsd.obj.mk =-=-=-=-= | | 1225 | =-=-=-=-= bsd.obj.mk =-=-=-=-= |
1226 | | | 1226 | |
1227 | The include file <bsd.obj.mk> defines targets related to the creation | | 1227 | The include file <bsd.obj.mk> defines targets related to the creation |
1228 | and use of separated object and source directories. | | 1228 | and use of separated object and source directories. |
1229 | | | 1229 | |
1230 | If an environment variable named MAKEOBJDIRPREFIX is set, make(1) uses | | 1230 | If an environment variable named MAKEOBJDIRPREFIX is set, make(1) uses |
1231 | ${MAKEOBJDIRPREFIX}${.CURDIR} as the name of the object directory if | | 1231 | ${MAKEOBJDIRPREFIX}${.CURDIR} as the name of the object directory if |
1232 | it exists. Otherwise make(1) looks for the existence of a | | 1232 | it exists. Otherwise make(1) looks for the existence of a |
1233 | subdirectory (or a symlink to a directory) of the source directory | | 1233 | subdirectory (or a symlink to a directory) of the source directory |
1234 | into which built targets should be placed. If an environment variable | | 1234 | into which built targets should be placed. If an environment variable |
1235 | named MAKEOBJDIR is set, make(1) uses its value as the name of the | | 1235 | named MAKEOBJDIR is set, make(1) uses its value as the name of the |
1236 | object directory; failing that, make first looks for a subdirectory | | 1236 | object directory; failing that, make first looks for a subdirectory |
1237 | named "obj.${MACHINE}", and if that doesn't exist, it looks for "obj". | | 1237 | named "obj.${MACHINE}", and if that doesn't exist, it looks for "obj". |
1238 | | | 1238 | |
1239 | Object directories are not created automatically by make(1) if they | | 1239 | Object directories are not created automatically by make(1) if they |
1240 | don't exist; you need to run a separate "make obj". (This will happen | | 1240 | don't exist; you need to run a separate "make obj". (This will happen |
1241 | during a top-level build if "MKOBJDIRS" is set to a value other than | | 1241 | during a top-level build if "MKOBJDIRS" is set to a value other than |
1242 | "no"). When the source directory is a subdirectory of ${BSDSRCDIR} -- | | 1242 | "no"). When the source directory is a subdirectory of ${BSDSRCDIR} -- |
1243 | and this is determined by a simple string prefix comparison -- object | | 1243 | and this is determined by a simple string prefix comparison -- object |
1244 | directories are created in a separate object directory tree, and a | | 1244 | directories are created in a separate object directory tree, and a |
1245 | symlink to the object directory in that tree is created in the source | | 1245 | symlink to the object directory in that tree is created in the source |
1246 | directory; otherwise, "make obj" assumes that you're not in the main | | 1246 | directory; otherwise, "make obj" assumes that you're not in the main |
1247 | source tree and that it's not safe to use a separate object tree. | | 1247 | source tree and that it's not safe to use a separate object tree. |
1248 | | | 1248 | |
1249 | Several variables used by <bsd.obj.mk> control exactly what | | 1249 | Several variables used by <bsd.obj.mk> control exactly what |
1250 | directories and links get created during a "make obj": | | 1250 | directories and links get created during a "make obj": |
1251 | | | 1251 | |
1252 | MAKEOBJDIR If set, this is the component name of the object | | 1252 | MAKEOBJDIR If set, this is the component name of the object |
1253 | directory. | | 1253 | directory. |
1254 | | | 1254 | |
1255 | OBJMACHINE If this is set but MAKEOBJDIR is not set, creates | | 1255 | OBJMACHINE If this is set but MAKEOBJDIR is not set, creates |
1256 | object directories or links named "obj.${MACHINE}"; | | 1256 | object directories or links named "obj.${MACHINE}"; |
1257 | otherwise, just creates ones named "obj". | | 1257 | otherwise, just creates ones named "obj". |
1258 | | | 1258 | |
1259 | USR_OBJMACHINE If set, and the current directory is a subdirectory of | | 1259 | USR_OBJMACHINE If set, and the current directory is a subdirectory of |
1260 | ${BSDSRCDIR}, create object directory in the | | 1260 | ${BSDSRCDIR}, create object directory in the |
1261 | corresponding subdirectory of ${BSDOBJDIR}.${MACHINE}; | | 1261 | corresponding subdirectory of ${BSDOBJDIR}.${MACHINE}; |
1262 | otherwise, create it in the corresponding subdirectory | | 1262 | otherwise, create it in the corresponding subdirectory |
1263 | of ${BSDOBJDIR} | | 1263 | of ${BSDOBJDIR} |
1264 | | | 1264 | |
1265 | BUILDID If set, the contents of this variable are appended | | 1265 | BUILDID If set, the contents of this variable are appended |
1266 | to the object directory name. If OBJMACHINE is also | | 1266 | to the object directory name. If OBJMACHINE is also |
1267 | set, ".${BUILDID}" is added after ".${MACHINE}". | | 1267 | set, ".${BUILDID}" is added after ".${MACHINE}". |
1268 | | | 1268 | |
1269 | | | 1269 | |
1270 | =-=-=-=-= bsd.prog.mk =-=-=-=-= | | 1270 | =-=-=-=-= bsd.prog.mk =-=-=-=-= |
1271 | | | 1271 | |
1272 | The include file <bsd.prog.mk> handles building programs from one or | | 1272 | The include file <bsd.prog.mk> handles building programs from one or |
1273 | more source files, along with their manual pages. It has a limited number | | 1273 | more source files, along with their manual pages. It has a limited number |
1274 | of suffixes, consistent with the current needs of the BSD tree. | | 1274 | of suffixes, consistent with the current needs of the BSD tree. |
1275 | <bsd.prog.mk> includes <bsd.shlib.mk> to get shared library parameters. | | 1275 | <bsd.prog.mk> includes <bsd.shlib.mk> to get shared library parameters. |
1276 | | | 1276 | |
1277 | It has eight targets: | | 1277 | It has eight targets: |
1278 | | | 1278 | |
1279 | all: | | 1279 | all: |
1280 | build the program and its manual page. This also | | 1280 | build the program and its manual page. This also |
1281 | creates a GDB initialization file (.gdbinit) in | | 1281 | creates a GDB initialization file (.gdbinit) in |
1282 | the objdir. The .gdbinit file sets the shared library | | 1282 | the objdir. The .gdbinit file sets the shared library |
1283 | prefix to ${DESTDIR} to facilitate cross-debugging. | | 1283 | prefix to ${DESTDIR} to facilitate cross-debugging. |
1284 | clean: | | 1284 | clean: |
1285 | remove the program, any object files and the files a.out, | | 1285 | remove the program, any object files and the files a.out, |
1286 | Errs, errs, mklog, and ${PROG}.core. | | 1286 | Errs, errs, mklog, and ${PROG}.core. |
1287 | cleandir: | | 1287 | cleandir: |
1288 | remove all of the files removed by the target clean, as | | 1288 | remove all of the files removed by the target clean, as |
1289 | well as .depend, tags, and any manual pages. | | 1289 | well as .depend, tags, and any manual pages. |
1290 | `distclean' is a synonym for `cleandir'. | | 1290 | `distclean' is a synonym for `cleandir'. |
1291 | depend: | | 1291 | depend: |
1292 | make the dependencies for the source files, and store | | 1292 | make the dependencies for the source files, and store |
1293 | them in the file .depend. | | 1293 | them in the file .depend. |
1294 | includes: | | 1294 | includes: |
1295 | install any header files. | | 1295 | install any header files. |
1296 | install: | | 1296 | install: |
1297 | install the program and its manual pages; if the Makefile | | 1297 | install the program and its manual pages; if the Makefile |
1298 | does not itself define the target install, the targets | | 1298 | does not itself define the target install, the targets |
1299 | beforeinstall and afterinstall may also be used to cause | | 1299 | beforeinstall and afterinstall may also be used to cause |
1300 | actions immediately before and after the install target | | 1300 | actions immediately before and after the install target |
1301 | is executed. | | 1301 | is executed. |
1302 | lint: | | 1302 | lint: |
1303 | run lint on the source files | | 1303 | run lint on the source files |
1304 | tags: | | 1304 | tags: |
1305 | create a tags file for the source files. | | 1305 | create a tags file for the source files. |
1306 | | | 1306 | |
1307 | It sets/uses the following variables: | | 1307 | It sets/uses the following variables: |
1308 | | | 1308 | |
1309 | BINGRP Binary group. | | 1309 | BINGRP Binary group. |
1310 | | | 1310 | |
1311 | BINOWN Binary owner. | | 1311 | BINOWN Binary owner. |
1312 | | | 1312 | |
1313 | BINMODE Binary mode. | | 1313 | BINMODE Binary mode. |
1314 | | | 1314 | |
1315 | CLEANDIRFILES Additional files to remove for the cleandir target. | | 1315 | CLEANDIRFILES Additional files to remove for the cleandir target. |
1316 | | | 1316 | |
1317 | CLEANFILES Additional files to remove for the clean and cleandir targets. | | 1317 | CLEANFILES Additional files to remove for the clean and cleandir targets. |
1318 | | | 1318 | |
1319 | COPTS Additional flags to the compiler when creating C objects. | | 1319 | COPTS Additional flags to the compiler when creating C objects. |
1320 | | | 1320 | |
1321 | COPTS.<fn> Additional flags to the compiler when creating the | | 1321 | COPTS.<fn> Additional flags to the compiler when creating the |
1322 | C objects for <fn>. | | 1322 | C objects for <fn>. |
1323 | For <fn>.[ly], "<fn>.c" must be used. | | 1323 | For <fn>.[ly], "<fn>.c" must be used. |
1324 | | | 1324 | |
1325 | CPUFLAGS Additional flags to the compiler/assembler to select | | 1325 | CPUFLAGS Additional flags to the compiler/assembler to select |
1326 | CPU instruction set options, CPU tuning options, etc. | | 1326 | CPU instruction set options, CPU tuning options, etc. |
1327 | | | 1327 | |
1328 | CPUFLAGS.<fn> Additional flags to the compiler/assembler for <fn>. | | 1328 | CPUFLAGS.<fn> Additional flags to the compiler/assembler for <fn>. |
1329 | For <fn>.[ly], "<fn>.c" must be used. | | 1329 | For <fn>.[ly], "<fn>.c" must be used. |
1330 | | | 1330 | |
1331 | CPPFLAGS Additional flags to the C pre-processor. | | 1331 | CPPFLAGS Additional flags to the C pre-processor. |
1332 | | | 1332 | |
1333 | CPPFLAGS.<fn> Additional flags to the C pre-processor for <fn>. | | 1333 | CPPFLAGS.<fn> Additional flags to the C pre-processor for <fn>. |
1334 | For <fn>.[ly], "<fn>.c" must be used. | | 1334 | For <fn>.[ly], "<fn>.c" must be used. |
1335 | | | 1335 | |
1336 | GDBINIT List of GDB initialization files to add to "source" | | 1336 | GDBINIT List of GDB initialization files to add to "source" |
1337 | directives in the .gdbinit file that is created in the | | 1337 | directives in the .gdbinit file that is created in the |
1338 | objdir. | | 1338 | objdir. |
1339 | | | 1339 | |
1340 | LDADD Additional loader objects. Usually used for libraries. | | 1340 | LDADD Additional loader objects. Usually used for libraries. |
1341 | For example, to load with the compatibility and utility | | 1341 | For example, to load with the compatibility and utility |
1342 | libraries, use: | | 1342 | libraries, use: |
1343 | | | 1343 | |
1344 | LDADD+=-lutil -lcompat | | 1344 | LDADD+=-lutil -lcompat |
1345 | | | 1345 | |
1346 | LDFLAGS Additional linker flags (passed to ${CC} during link). | | 1346 | LDFLAGS Additional linker flags (passed to ${CC} during link). |
1347 | | | 1347 | |
1348 | LINKS See <bsd.links.mk> | | 1348 | LINKS See <bsd.links.mk> |
1349 | | | 1349 | |
1350 | OBJCOPTS Additional flags to the compiler when creating ObjC objects. | | 1350 | OBJCOPTS Additional flags to the compiler when creating ObjC objects. |
1351 | | | 1351 | |
1352 | OBJCOPTS.<fn> Additional flags to the compiler when creating the | | 1352 | OBJCOPTS.<fn> Additional flags to the compiler when creating the |
1353 | ObjC objects for <fn>. | | 1353 | ObjC objects for <fn>. |
1354 | For <fn>.[ly], "<fn>.c" must be used. | | 1354 | For <fn>.[ly], "<fn>.c" must be used. |
1355 | | | 1355 | |
1356 | SYMLINKS See <bsd.links.mk> | | 1356 | SYMLINKS See <bsd.links.mk> |
1357 | | | 1357 | |
1358 | MAN Manual pages (should end in .1 - .9). If no MAN variable is | | 1358 | MAN Manual pages (should end in .1 - .9). If no MAN variable is |
1359 | defined, "MAN=${PROG}.1" is assumed. | | 1359 | defined, "MAN=${PROG}.1" is assumed. |
1360 | | | 1360 | |
1361 | PAXCTL_FLAGS If defined, run paxctl(1) on the program binary after link | | 1361 | PAXCTL_FLAGS If defined, run paxctl(1) on the program binary after link |
1362 | time, with the value of this variable as args to paxctl(1). | | 1362 | time, with the value of this variable as args to paxctl(1). |
1363 | | | 1363 | |
1364 | PAXCTL_FLAGS.${PROG} Custom override for PAXCTL_FLAGS. | | 1364 | PAXCTL_FLAGS.${PROG} Custom override for PAXCTL_FLAGS. |
1365 | | | 1365 | |
1366 | PROG The name of the program to build. If not supplied, nothing | | 1366 | PROG The name of the program to build. If not supplied, nothing |
1367 | is built. | | 1367 | is built. |
1368 | | | 1368 | |
1369 | PROG_CXX If defined, the name of the program to build. Also | | 1369 | PROG_CXX If defined, the name of the program to build. Also |
1370 | causes <bsd.prog.mk> to link the program with the C++ | | 1370 | causes <bsd.prog.mk> to link the program with the C++ |
1371 | compiler rather than the C compiler. PROG_CXX overrides | | 1371 | compiler rather than the C compiler. PROG_CXX overrides |
1372 | the value of PROG if PROG is also set. | | 1372 | the value of PROG if PROG is also set. |
1373 | | | 1373 | |
1374 | PROGNAME The name that the above program will be installed as, if | | 1374 | PROGNAME The name that the above program will be installed as, if |
1375 | different from ${PROG}. | | 1375 | different from ${PROG}. |
1376 | | | 1376 | |
1377 | SRCS List of source files to build the program. If SRCS is not | | 1377 | SRCS List of source files to build the program. If SRCS is not |
1378 | defined, it's assumed to be ${PROG}.c. | | 1378 | defined, it's assumed to be ${PROG}.c. |
1379 | | | 1379 | |
1380 | DPSRCS List of source files which are needed for generating | | 1380 | DPSRCS List of source files which are needed for generating |
1381 | dependencies, but are not needed in ${SRCS}. | | 1381 | dependencies, but are not needed in ${SRCS}. |
1382 | | | 1382 | |
1383 | DPADD Additional dependencies for the program. Usually used for | | 1383 | DPADD Additional dependencies for the program. Usually used for |
1384 | libraries. For example, to depend on the compatibility and | | 1384 | libraries. For example, to depend on the compatibility and |
1385 | utility libraries use: | | 1385 | utility libraries use: |
1386 | | | 1386 | |
1387 | DPADD+=${LIBCOMPAT} ${LIBUTIL} | | 1387 | DPADD+=${LIBCOMPAT} ${LIBUTIL} |
1388 | | | 1388 | |
1389 | The following system libraries are predefined for DPADD: | | 1389 | The following system libraries are predefined for DPADD: |
1390 | | | 1390 | |
1391 | LIBARCHIVE?= ${DESTDIR}/usr/lib/libarchive.a | | 1391 | LIBARCHIVE?= ${DESTDIR}/usr/lib/libarchive.a |
1392 | LIBASN1?= ${DESTDIR}/usr/lib/libasn1.a | | 1392 | LIBASN1?= ${DESTDIR}/usr/lib/libasn1.a |
1393 | LIBATF_C?= ${DESTDIR}/usr/lib/libatf-c.a | | 1393 | LIBATF_C?= ${DESTDIR}/usr/lib/libatf-c.a |
1394 | LIBATF_CXX?= ${DESTDIR}/usr/lib/libatf-c++.a | | 1394 | LIBATF_CXX?= ${DESTDIR}/usr/lib/libatf-c++.a |
1395 | LIBBIND9?= ${DESTDIR}/usr/lib/libbind9.a | | 1395 | LIBBIND9?= ${DESTDIR}/usr/lib/libbind9.a |
1396 | LIBBLUETOOTH?= ${DESTDIR}/usr/lib/libbluetooth.a | | 1396 | LIBBLUETOOTH?= ${DESTDIR}/usr/lib/libbluetooth.a |
1397 | LIBBSDMALLOC?= ${DESTDIR}/usr/lib/libbsdmalloc.a | | 1397 | LIBBSDMALLOC?= ${DESTDIR}/usr/lib/libbsdmalloc.a |
1398 | LIBBZ2?= ${DESTDIR}/usr/lib/libbz2.a | | 1398 | LIBBZ2?= ${DESTDIR}/usr/lib/libbz2.a |
1399 | LIBC?= ${DESTDIR}/usr/lib/libc.a | | 1399 | LIBC?= ${DESTDIR}/usr/lib/libc.a |
1400 | LIBCOMPAT?= ${DESTDIR}/usr/lib/libcompat.a | | 1400 | LIBCOMPAT?= ${DESTDIR}/usr/lib/libcompat.a |
1401 | LIBCOM_ERR?= ${DESTDIR}/usr/lib/libcom_err.a | | 1401 | LIBCOM_ERR?= ${DESTDIR}/usr/lib/libcom_err.a |
1402 | LIBCRT0?= ${DESTDIR}/usr/lib/crt0.o | | 1402 | LIBCRT0?= ${DESTDIR}/usr/lib/crt0.o |
1403 | LIBCRYPT?= ${DESTDIR}/usr/lib/libcrypt.a | | 1403 | LIBCRYPT?= ${DESTDIR}/usr/lib/libcrypt.a |
1404 | LIBCRYPTO?= ${DESTDIR}/usr/lib/libcrypto.a | | 1404 | LIBCRYPTO?= ${DESTDIR}/usr/lib/libcrypto.a |
1405 | LIBCRYPTO_IDEA?=${DESTDIR}/usr/lib/libcrypto_idea.a | | 1405 | LIBCRYPTO_IDEA?=${DESTDIR}/usr/lib/libcrypto_idea.a |
1406 | LIBCRYPTO_MDC2?=${DESTDIR}/usr/lib/libcrypto_mdc2.a | | 1406 | LIBCRYPTO_MDC2?=${DESTDIR}/usr/lib/libcrypto_mdc2.a |
1407 | LIBCRYPTO_RC5?= ${DESTDIR}/usr/lib/libcrypto_rc5.a | | 1407 | LIBCRYPTO_RC5?= ${DESTDIR}/usr/lib/libcrypto_rc5.a |
1408 | LIBCURSES?= ${DESTDIR}/usr/lib/libcurses.a | | 1408 | LIBCURSES?= ${DESTDIR}/usr/lib/libcurses.a |
1409 | LIBC_PIC?= ${DESTDIR}/usr/lib/libc_pic.a | | 1409 | LIBC_PIC?= ${DESTDIR}/usr/lib/libc_pic.a |
1410 | LIBDBM?= ${DESTDIR}/usr/lib/libdbm.a | | 1410 | LIBDBM?= ${DESTDIR}/usr/lib/libdbm.a |
1411 | LIBDES?= ${DESTDIR}/usr/lib/libdes.a | | 1411 | LIBDES?= ${DESTDIR}/usr/lib/libdes.a |
1412 | LIBDNS?= ${DESTDIR}/usr/lib/libdns.a | | 1412 | LIBDNS?= ${DESTDIR}/usr/lib/libdns.a |
1413 | LIBEDIT?= ${DESTDIR}/usr/lib/libedit.a | | 1413 | LIBEDIT?= ${DESTDIR}/usr/lib/libedit.a |
1414 | LIBEVENT?= ${DESTDIR}/usr/lib/libevent.a | | 1414 | LIBEVENT?= ${DESTDIR}/usr/lib/libevent.a |
1415 | LIBFETCH?= ${DESTDIR}/usr/lib/libfetch.a | | 1415 | LIBFETCH?= ${DESTDIR}/usr/lib/libfetch.a |
1416 | LIBFORM?= ${DESTDIR}/usr/lib/libform.a | | 1416 | LIBFORM?= ${DESTDIR}/usr/lib/libform.a |
1417 | LIBFL?= ${DESTDIR}/usr/lib/libfl.a | | 1417 | LIBFL?= ${DESTDIR}/usr/lib/libfl.a |
1418 | LIBG2C?= ${DESTDIR}/usr/lib/libg2c.a | | 1418 | LIBG2C?= ${DESTDIR}/usr/lib/libg2c.a |
1419 | LIBGCC?= ${DESTDIR}/usr/lib/libgcc.a | | 1419 | LIBGCC?= ${DESTDIR}/usr/lib/libgcc.a |
1420 | LIBGNUMALLOC?= ${DESTDIR}/usr/lib/libgnumalloc.a | | 1420 | LIBGNUMALLOC?= ${DESTDIR}/usr/lib/libgnumalloc.a |
1421 | LIBGSSAPI?= ${DESTDIR}/usr/lib/libgssapi.a | | 1421 | LIBGSSAPI?= ${DESTDIR}/usr/lib/libgssapi.a |
1422 | LIBHDB?= ${DESTDIR}/usr/lib/libhdb.a | | 1422 | LIBHDB?= ${DESTDIR}/usr/lib/libhdb.a |
1423 | LIBHEIMBASE?= ${DESTDIR}/usr/lib/libheimbase.a | | 1423 | LIBHEIMBASE?= ${DESTDIR}/usr/lib/libheimbase.a |
1424 | LIBHEIMNTLM?= ${DESTDIR}/usr/lib/libheimntlm.a | | 1424 | LIBHEIMNTLM?= ${DESTDIR}/usr/lib/libheimntlm.a |
1425 | LIBHX500?= ${DESTDIR}/usr/lib/libhx500.a | | 1425 | LIBHX500?= ${DESTDIR}/usr/lib/libhx500.a |
1426 | LIBINTL?= ${DESTDIR}/usr/lib/libintl.a | | 1426 | LIBINTL?= ${DESTDIR}/usr/lib/libintl.a |
1427 | LIBIPSEC?= ${DESTDIR}/usr/lib/libipsec.a | | 1427 | LIBIPSEC?= ${DESTDIR}/usr/lib/libipsec.a |
1428 | LIBISC?= ${DESTDIR}/usr/lib/libisc.a | | 1428 | LIBISC?= ${DESTDIR}/usr/lib/libisc.a |
1429 | LIBISCCC?= ${DESTDIR}/usr/lib/libisccc.a | | 1429 | LIBISCCC?= ${DESTDIR}/usr/lib/libisccc.a |
1430 | LIBISCFG?= ${DESTDIR}/usr/lib/libiscfg.a | | 1430 | LIBISCFG?= ${DESTDIR}/usr/lib/libiscfg.a |
1431 | LIBKADM5CLNT?= ${DESTDIR}/usr/lib/libkadm5clnt.a | | 1431 | LIBKADM5CLNT?= ${DESTDIR}/usr/lib/libkadm5clnt.a |
1432 | LIBKADM5SRV?= ${DESTDIR}/usr/lib/libkadm5srv.a | | 1432 | LIBKADM5SRV?= ${DESTDIR}/usr/lib/libkadm5srv.a |
1433 | LIBKAFS?= ${DESTDIR}/usr/lib/libkafs.a | | 1433 | LIBKAFS?= ${DESTDIR}/usr/lib/libkafs.a |
1434 | LIBKRB5?= ${DESTDIR}/usr/lib/libkrb5.a | | 1434 | LIBKRB5?= ${DESTDIR}/usr/lib/libkrb5.a |
1435 | LIBKVM?= ${DESTDIR}/usr/lib/libkvm.a | | 1435 | LIBKVM?= ${DESTDIR}/usr/lib/libkvm.a |
1436 | LIBL?= ${DESTDIR}/usr/lib/libl.a | | 1436 | LIBL?= ${DESTDIR}/usr/lib/libl.a |
1437 | LIBLBER?= ${DESTDIR}/usr/lib/liblber.a | | 1437 | LIBLBER?= ${DESTDIR}/usr/lib/liblber.a |
1438 | LIBLDAP?= ${DESTDIR}/usr/lib/libldap.a | | 1438 | LIBLDAP?= ${DESTDIR}/usr/lib/libldap.a |
1439 | LIBLDAP_R?= ${DESTDIR}/usr/lib/libldap_r.a | | 1439 | LIBLDAP_R?= ${DESTDIR}/usr/lib/libldap_r.a |
1440 | LIBLUA?= ${DESTDIR}/usr/lib/liblua.a | | 1440 | LIBLUA?= ${DESTDIR}/usr/lib/liblua.a |
1441 | LIBLWRES?= ${DESTDIR}/usr/lib/liblwres.a | | 1441 | LIBLWRES?= ${DESTDIR}/usr/lib/liblwres.a |
1442 | LIBM?= ${DESTDIR}/usr/lib/libm.a | | 1442 | LIBM?= ${DESTDIR}/usr/lib/libm.a |
1443 | LIBMAGIC?= ${DESTDIR}/usr/lib/libmagic.a | | 1443 | LIBMAGIC?= ${DESTDIR}/usr/lib/libmagic.a |
1444 | LIBMENU?= ${DESTDIR}/usr/lib/libmenu.a | | 1444 | LIBMENU?= ${DESTDIR}/usr/lib/libmenu.a |
1445 | LIBOBJC?= ${DESTDIR}/usr/lib/libobjc.a | | 1445 | LIBOBJC?= ${DESTDIR}/usr/lib/libobjc.a |
1446 | LIBOSSAUDIO?= ${DESTDIR}/usr/lib/libossaudio.a | | 1446 | LIBOSSAUDIO?= ${DESTDIR}/usr/lib/libossaudio.a |
1447 | LIBPAM?= ${DESTDIR}/usr/lib/libpam.a | | 1447 | LIBPAM?= ${DESTDIR}/usr/lib/libpam.a |
1448 | LIBPCAP?= ${DESTDIR}/usr/lib/libpcap.a | | 1448 | LIBPCAP?= ${DESTDIR}/usr/lib/libpcap.a |
1449 | LIBPCI?= ${DESTDIR}/usr/lib/libpci.a | | 1449 | LIBPCI?= ${DESTDIR}/usr/lib/libpci.a |
1450 | LIBPMC?= ${DESTDIR}/usr/lib/libpmc.a | | 1450 | LIBPMC?= ${DESTDIR}/usr/lib/libpmc.a |
1451 | LIBPOSIX?= ${DESTDIR}/usr/lib/libposix.a | | 1451 | LIBPOSIX?= ${DESTDIR}/usr/lib/libposix.a |
1452 | LIBPTHREAD?= ${DESTDIR}/usr/lib/libpthread.a | | 1452 | LIBPTHREAD?= ${DESTDIR}/usr/lib/libpthread.a |
1453 | LIBPTHREAD_DBG?=${DESTDIR}/usr/lib/libpthread_dbg.a | | 1453 | LIBPTHREAD_DBG?=${DESTDIR}/usr/lib/libpthread_dbg.a |
1454 | LIBPUFFS?= ${DESTDIR}/usr/lib/libpuffs.a | | 1454 | LIBPUFFS?= ${DESTDIR}/usr/lib/libpuffs.a |
1455 | LIBQUOTA?= ${DESTDIR}/usr/lib/libquota.a | | 1455 | LIBQUOTA?= ${DESTDIR}/usr/lib/libquota.a |
1456 | LIBRADIUS?= ${DESTDIR}/usr/lib/libradius.a | | 1456 | LIBRADIUS?= ${DESTDIR}/usr/lib/libradius.a |
1457 | LIBRESOLV?= ${DESTDIR}/usr/lib/libresolv.a | | 1457 | LIBRESOLV?= ${DESTDIR}/usr/lib/libresolv.a |
1458 | LIBRMT?= ${DESTDIR}/usr/lib/librmt.a | | 1458 | LIBRMT?= ${DESTDIR}/usr/lib/librmt.a |
1459 | LIBROKEN?= ${DESTDIR}/usr/lib/libroken.a | | 1459 | LIBROKEN?= ${DESTDIR}/usr/lib/libroken.a |
1460 | LIBRPCSVC?= ${DESTDIR}/usr/lib/librpcsvc.a | | 1460 | LIBRPCSVC?= ${DESTDIR}/usr/lib/librpcsvc.a |
1461 | LIBRT?= ${DESTDIR}/usr/lib/librt.a | | 1461 | LIBRT?= ${DESTDIR}/usr/lib/librt.a |
1462 | LIBRUMP?= ${DESTDIR}/usr/lib/librump.a | | 1462 | LIBRUMP?= ${DESTDIR}/usr/lib/librump.a |
1463 | LIBRUMPFS_CD9660FS?=${DESTDIR}/usr/lib/librumpfs_cd9660fs.a | | 1463 | LIBRUMPFS_CD9660FS?=${DESTDIR}/usr/lib/librumpfs_cd9660fs.a |
1464 | LIBRUMPFS_EFS?= ${DESTDIR}/usr/lib/librumpfs_efs.a | | 1464 | LIBRUMPFS_EFS?= ${DESTDIR}/usr/lib/librumpfs_efs.a |
1465 | LIBRUMPFS_EXT2FS?=${DESTDIR}/usr/lib/librumpfs_ext2fs.a | | 1465 | LIBRUMPFS_EXT2FS?=${DESTDIR}/usr/lib/librumpfs_ext2fs.a |
1466 | LIBRUMPFS_FFS?= ${DESTDIR}/usr/lib/librumpfs_ffs.a | | 1466 | LIBRUMPFS_FFS?= ${DESTDIR}/usr/lib/librumpfs_ffs.a |
1467 | LIBRUMPFS_HFS?= ${DESTDIR}/usr/lib/librumpfs_hfs.a | | 1467 | LIBRUMPFS_HFS?= ${DESTDIR}/usr/lib/librumpfs_hfs.a |
1468 | LIBRUMPFS_LFS?= ${DESTDIR}/usr/lib/librumpfs_lfs.a | | 1468 | LIBRUMPFS_LFS?= ${DESTDIR}/usr/lib/librumpfs_lfs.a |
1469 | LIBRUMPFS_MSDOSFS?=${DESTDIR}/usr/lib/librumpfs_msdosfs.a | | 1469 | LIBRUMPFS_MSDOSFS?=${DESTDIR}/usr/lib/librumpfs_msdosfs.a |
1470 | LIBRUMPFS_NFS?= ${DESTDIR}/usr/lib/librumpfs_nfs.a | | 1470 | LIBRUMPFS_NFS?= ${DESTDIR}/usr/lib/librumpfs_nfs.a |
1471 | LIBRUMPFS_NTFS?=${DESTDIR}/usr/lib/librumpfs_ntfs.a | | 1471 | LIBRUMPFS_NTFS?=${DESTDIR}/usr/lib/librumpfs_ntfs.a |
1472 | LIBRUMPFS_SYSPUFFS?=${DESTDIR}/usr/lib/librumpfs_syspuffs.a | | 1472 | LIBRUMPFS_SYSPUFFS?=${DESTDIR}/usr/lib/librumpfs_syspuffs.a |
1473 | LIBRUMPFS_TMPFS?=${DESTDIR}/usr/lib/librumpfs_tmpfs.a | | 1473 | LIBRUMPFS_TMPFS?=${DESTDIR}/usr/lib/librumpfs_tmpfs.a |
1474 | LIBRUMPFS_UDF?= ${DESTDIR}/usr/lib/librumpfs_udf.a | | 1474 | LIBRUMPFS_UDF?= ${DESTDIR}/usr/lib/librumpfs_udf.a |
1475 | LIBRUMPFS_UFS?= ${DESTDIR}/usr/lib/librumpfs_ufs.a | | 1475 | LIBRUMPFS_UFS?= ${DESTDIR}/usr/lib/librumpfs_ufs.a |
1476 | LIBRUMPUSER?= ${DESTDIR}/usr/lib/librumpuser.a | | 1476 | LIBRUMPUSER?= ${DESTDIR}/usr/lib/librumpuser.a |
1477 | LIBSASLC?= ${DESTDIR}/usr/lib/libsaslc.a | | 1477 | LIBSASLC?= ${DESTDIR}/usr/lib/libsaslc.a |
1478 | LIBSKEY?= ${DESTDIR}/usr/lib/libskey.a | | 1478 | LIBSKEY?= ${DESTDIR}/usr/lib/libskey.a |
1479 | LIBSL?= ${DESTDIR}/usr/lib/libsl.a | | 1479 | LIBSL?= ${DESTDIR}/usr/lib/libsl.a |
1480 | LIBSQLITE3?= ${DESTDIR}/usr/lib/libsqlite3.a | | 1480 | LIBSQLITE3?= ${DESTDIR}/usr/lib/libsqlite3.a |
1481 | LIBSS?= ${DESTDIR}/usr/lib/libss.a | | 1481 | LIBSS?= ${DESTDIR}/usr/lib/libss.a |
1482 | LIBSSH?= ${DESTDIR}/usr/lib/libssh.a | | 1482 | LIBSSH?= ${DESTDIR}/usr/lib/libssh.a |
1483 | LIBSSL?= ${DESTDIR}/usr/lib/libssl.a | | 1483 | LIBSSL?= ${DESTDIR}/usr/lib/libssl.a |
1484 | LIBSSP?= ${DESTDIR}/usr/lib/libssp.a | | 1484 | LIBSSP?= ${DESTDIR}/usr/lib/libssp.a |
1485 | LIBSTDCXX?= ${DESTDIR}/usr/lib/libstdc++.a | | 1485 | LIBSTDCXX?= ${DESTDIR}/usr/lib/libstdc++.a |
1486 | LIBSUPCXX?= ${DESTDIR}/usr/lib/libsupc++.a | | 1486 | LIBSUPCXX?= ${DESTDIR}/usr/lib/libsupc++.a |
1487 | LIBTERMINFO?= ${DESTDIR}/usr/lib/libterminfo.a | | 1487 | LIBTERMINFO?= ${DESTDIR}/usr/lib/libterminfo.a |
1488 | LIBTRE?= ${DESTDIR}/usr/lib/libtre.a | | 1488 | LIBTRE?= ${DESTDIR}/usr/lib/libtre.a |
1489 | LIBUSBHID?= ${DESTDIR}/usr/lib/libusbhid.a | | 1489 | LIBUSBHID?= ${DESTDIR}/usr/lib/libusbhid.a |
1490 | LIBUTIL?= ${DESTDIR}/usr/lib/libutil.a | | 1490 | LIBUTIL?= ${DESTDIR}/usr/lib/libutil.a |
1491 | LIBWIND?= ${DESTDIR}/usr/lib/libwind.a | | 1491 | LIBWIND?= ${DESTDIR}/usr/lib/libwind.a |
1492 | LIBWRAP?= ${DESTDIR}/usr/lib/libwrap.a | | 1492 | LIBWRAP?= ${DESTDIR}/usr/lib/libwrap.a |
1493 | LIBY?= ${DESTDIR}/usr/lib/liby.a | | 1493 | LIBY?= ${DESTDIR}/usr/lib/liby.a |
1494 | LIBZ?= ${DESTDIR}/usr/lib/libz.a | | 1494 | LIBZ?= ${DESTDIR}/usr/lib/libz.a |
1495 | | | 1495 | |
1496 | The following X-Windows libraries are predefined for DPADD: | | 1496 | The following X-Windows libraries are predefined for DPADD: |
1497 | | | 1497 | |
1498 | LIBFS?= ${DESTDIR}/usr/X11R7/lib/libFS.a | | 1498 | LIBFS?= ${DESTDIR}/usr/X11R7/lib/libFS.a |
1499 | LIBGL?= ${DESTDIR}/usr/X11R7/lib/libGL.a | | 1499 | LIBGL?= ${DESTDIR}/usr/X11R7/lib/libGL.a |
1500 | LIBGLU?= ${DESTDIR}/usr/X11R7/lib/libGLU.a | | 1500 | LIBGLU?= ${DESTDIR}/usr/X11R7/lib/libGLU.a |
1501 | LIBICE?= ${DESTDIR}/usr/X11R7/lib/libICE.a | | 1501 | LIBICE?= ${DESTDIR}/usr/X11R7/lib/libICE.a |
1502 | LIBSM?= ${DESTDIR}/usr/X11R7/lib/libSM.a | | 1502 | LIBSM?= ${DESTDIR}/usr/X11R7/lib/libSM.a |
1503 | LIBX11?= ${DESTDIR}/usr/X11R7/lib/libX11.a | | 1503 | LIBX11?= ${DESTDIR}/usr/X11R7/lib/libX11.a |
1504 | LIBXTRAP?= ${DESTDIR}/usr/X11R7/lib/libXTrap.a | | 1504 | LIBXTRAP?= ${DESTDIR}/usr/X11R7/lib/libXTrap.a |
1505 | LIBXAU?= ${DESTDIR}/usr/X11R7/lib/libXau.a | | 1505 | LIBXAU?= ${DESTDIR}/usr/X11R7/lib/libXau.a |
1506 | LIBXAW?= ${DESTDIR}/usr/X11R7/lib/libXaw.a | | 1506 | LIBXAW?= ${DESTDIR}/usr/X11R7/lib/libXaw.a |
1507 | LIBXDMCP?= ${DESTDIR}/usr/X11R7/lib/libXdmcp.a | | 1507 | LIBXDMCP?= ${DESTDIR}/usr/X11R7/lib/libXdmcp.a |
1508 | LIBXEXT?= ${DESTDIR}/usr/X11R7/lib/libXext.a | | 1508 | LIBXEXT?= ${DESTDIR}/usr/X11R7/lib/libXext.a |
1509 | LIBXFONT?= ${DESTDIR}/usr/X11R7/lib/libXfont.a | | 1509 | LIBXFONT?= ${DESTDIR}/usr/X11R7/lib/libXfont.a |
1510 | LIBXFT?= ${DESTDIR}/usr/X11R7/lib/libXft.a | | 1510 | LIBXFT?= ${DESTDIR}/usr/X11R7/lib/libXft.a |
1511 | LIBXI?= ${DESTDIR}/usr/X11R7/lib/libXi.a | | 1511 | LIBXI?= ${DESTDIR}/usr/X11R7/lib/libXi.a |
1512 | LIBXINERAMA?= ${DESTDIR}/usr/X11R7/lib/libXinerama.a | | 1512 | LIBXINERAMA?= ${DESTDIR}/usr/X11R7/lib/libXinerama.a |
1513 | LIBXMU?= ${DESTDIR}/usr/X11R7/lib/libXmu.a | | 1513 | LIBXMU?= ${DESTDIR}/usr/X11R7/lib/libXmu.a |
1514 | LIBXMUU?= ${DESTDIR}/usr/X11R7/lib/libXmuu.a | | 1514 | LIBXMUU?= ${DESTDIR}/usr/X11R7/lib/libXmuu.a |
1515 | LIBXPM?= ${DESTDIR}/usr/X11R7/lib/libXpm.a | | 1515 | LIBXPM?= ${DESTDIR}/usr/X11R7/lib/libXpm.a |
1516 | LIBXRANDR?= ${DESTDIR}/usr/X11R7/lib/libXrandr.a | | 1516 | LIBXRANDR?= ${DESTDIR}/usr/X11R7/lib/libXrandr.a |
1517 | LIBXRENDER?= ${DESTDIR}/usr/X11R7/lib/libXrender.a | | 1517 | LIBXRENDER?= ${DESTDIR}/usr/X11R7/lib/libXrender.a |
1518 | LIBXSS?= ${DESTDIR}/usr/X11R7/lib/libXss.a | | 1518 | LIBXSS?= ${DESTDIR}/usr/X11R7/lib/libXss.a |
1519 | LIBXT?= ${DESTDIR}/usr/X11R7/lib/libXt.a | | 1519 | LIBXT?= ${DESTDIR}/usr/X11R7/lib/libXt.a |
1520 | LIBXTST?= ${DESTDIR}/usr/X11R7/lib/libXtst.a | | 1520 | LIBXTST?= ${DESTDIR}/usr/X11R7/lib/libXtst.a |
1521 | LIBXV?= ${DESTDIR}/usr/X11R7/lib/libXv.a | | 1521 | LIBXV?= ${DESTDIR}/usr/X11R7/lib/libXv.a |
1522 | LIBXXF86DGA?= ${DESTDIR}/usr/X11R7/lib/libXxf86dga.a | | 1522 | LIBXXF86DGA?= ${DESTDIR}/usr/X11R7/lib/libXxf86dga.a |
1523 | LIBXXF86MISC?= ${DESTDIR}/usr/X11R7/lib/libXxf86misc.a | | 1523 | LIBXXF86MISC?= ${DESTDIR}/usr/X11R7/lib/libXxf86misc.a |
1524 | LIBXXF86VM?= ${DESTDIR}/usr/X11R7/lib/libXxf86vm.a | | 1524 | LIBXXF86VM?= ${DESTDIR}/usr/X11R7/lib/libXxf86vm.a |
1525 | LIBDPS?= ${DESTDIR}/usr/X11R7/lib/libdps.a | | 1525 | LIBDPS?= ${DESTDIR}/usr/X11R7/lib/libdps.a |
1526 | LIBEXPAT?= ${DESTDIR}/usr/X11R7/lib/libexpat.a | | 1526 | LIBEXPAT?= ${DESTDIR}/usr/X11R7/lib/libexpat.a |
1527 | LIBFNTSTUBS?= ${DESTDIR}/usr/X11R7/lib/libfntstubs.a | | 1527 | LIBFNTSTUBS?= ${DESTDIR}/usr/X11R7/lib/libfntstubs.a |
1528 | LIBFONTCACHE?= ${DESTDIR}/usr/X11R7/lib/libfontcache.a | | 1528 | LIBFONTCACHE?= ${DESTDIR}/usr/X11R7/lib/libfontcache.a |
1529 | LIBFONTCONFIG?= ${DESTDIR}/usr/X11R7/lib/libfontconfig.a | | 1529 | LIBFONTCONFIG?= ${DESTDIR}/usr/X11R7/lib/libfontconfig.a |
1530 | LIBFONTENC?= ${DESTDIR}/usr/X11R7/lib/libfontenc.a | | 1530 | LIBFONTENC?= ${DESTDIR}/usr/X11R7/lib/libfontenc.a |
1531 | LIBFREETYPE?= ${DESTDIR}/usr/X11R7/lib/libfreetype.a | | 1531 | LIBFREETYPE?= ${DESTDIR}/usr/X11R7/lib/libfreetype.a |
1532 | LIBLBXUTIL?= ${DESTDIR}/usr/X11R7/lib/liblbxutil.a | | 1532 | LIBLBXUTIL?= ${DESTDIR}/usr/X11R7/lib/liblbxutil.a |
1533 | LIBXKBFILE?= ${DESTDIR}/usr/X11R7/lib/libxkbfile.a | | 1533 | LIBXKBFILE?= ${DESTDIR}/usr/X11R7/lib/libxkbfile.a |
1534 | | | 1534 | |
1535 | SHAREDSTRINGS If defined, a new .c.o rule is used that results in shared | | 1535 | SHAREDSTRINGS If defined, a new .c.o rule is used that results in shared |
1536 | strings, using xstr(1). Note that this will not work with | | 1536 | strings, using xstr(1). Note that this will not work with |
1537 | parallel makes. | | 1537 | parallel makes. |
1538 | | | 1538 | |
1539 | STRIPFLAG The flag passed to the install program to cause the binary | | 1539 | STRIPFLAG The flag passed to the install program to cause the binary |
1540 | to be stripped. | | 1540 | to be stripped. |
1541 | | | 1541 | |
1542 | SUBDIR A list of subdirectories that should be built as well. | | 1542 | SUBDIR A list of subdirectories that should be built as well. |
1543 | Each of the targets will execute the same target in the | | 1543 | Each of the targets will execute the same target in the |
1544 | subdirectories. | | 1544 | subdirectories. |
1545 | | | 1545 | |
1546 | SCRIPTS A list of interpreter scripts [file.{sh,csh,pl,awk,...}]. | | 1546 | SCRIPTS A list of interpreter scripts [file.{sh,csh,pl,awk,...}]. |
1547 | These are installed exactly like programs. | | 1547 | These are installed exactly like programs. |
1548 | | | 1548 | |
1549 | SCRIPTSDIR The location to install the scripts. Each script can be | | 1549 | SCRIPTSDIR The location to install the scripts. Each script can be |
1550 | installed to a separate path by setting SCRIPTSDIR_<script>. | | 1550 | installed to a separate path by setting SCRIPTSDIR_<script>. |
1551 | | | 1551 | |
1552 | SCRIPTSNAME The name that the above program will be installed as, if | | 1552 | SCRIPTSNAME The name that the above program will be installed as, if |
1553 | different from ${SCRIPTS}. These can be further specialized | | 1553 | different from ${SCRIPTS}. These can be further specialized |
1554 | by setting SCRIPTSNAME_<script>. | | 1554 | by setting SCRIPTSNAME_<script>. |
1555 | | | 1555 | |
1556 | FILES See description of <bsd.files.mk>. | | 1556 | FILES See description of <bsd.files.mk>. |
1557 | | | 1557 | |
1558 | SHLINKDIR Target directory for shared linker. See description of | | 1558 | SHLINKDIR Target directory for shared linker. See description of |
1559 | <bsd.own.mk> for additional information about this variable. | | 1559 | <bsd.own.mk> for additional information about this variable. |
1560 | | | 1560 | |
1561 | The include file <bsd.prog.mk> includes the file named "../Makefile.inc" | | 1561 | The include file <bsd.prog.mk> includes the file named "../Makefile.inc" |
1562 | if it exists, as well as the include file <bsd.man.mk>. | | 1562 | if it exists, as well as the include file <bsd.man.mk>. |
1563 | | | 1563 | |
1564 | Some simple examples: | | 1564 | Some simple examples: |
1565 | | | 1565 | |
1566 | To build foo from foo.c with a manual page foo.1, use: | | 1566 | To build foo from foo.c with a manual page foo.1, use: |
1567 | | | 1567 | |
1568 | PROG= foo | | 1568 | PROG= foo |
1569 | | | 1569 | |
1570 | .include <bsd.prog.mk> | | 1570 | .include <bsd.prog.mk> |
1571 | | | 1571 | |
1572 | To build foo from foo.c with a manual page foo.2, add the line: | | 1572 | To build foo from foo.c with a manual page foo.2, add the line: |
1573 | | | 1573 | |
1574 | MAN= foo.2 | | 1574 | MAN= foo.2 |
1575 | | | 1575 | |
1576 | If foo does not have a manual page at all, add the line: | | 1576 | If foo does not have a manual page at all, add the line: |
1577 | | | 1577 | |
1578 | MKMAN= no | | 1578 | MKMAN= no |
1579 | | | 1579 | |
1580 | If foo has multiple source files, add the line: | | 1580 | If foo has multiple source files, add the line: |
1581 | | | 1581 | |
1582 | SRCS= a.c b.c c.c d.c | | 1582 | SRCS= a.c b.c c.c d.c |
1583 | | | 1583 | |
1584 | | | 1584 | |
1585 | =-=-=-=-= bsd.rpc.mk =-=-=-=-= | | 1585 | =-=-=-=-= bsd.rpc.mk =-=-=-=-= |
1586 | | | 1586 | |
1587 | The include file <bsd.rpc.mk> contains a makefile fragment used to | | 1587 | The include file <bsd.rpc.mk> contains a makefile fragment used to |
1588 | construct source files built by rpcgen. | | 1588 | construct source files built by rpcgen. |
1589 | | | 1589 | |
1590 | The following macros may be defined in makefiles which include | | 1590 | The following macros may be defined in makefiles which include |
1591 | <bsd.rpc.mk> in order to control which files get built and how they | | 1591 | <bsd.rpc.mk> in order to control which files get built and how they |
1592 | are to be built: | | 1592 | are to be built: |
1593 | | | 1593 | |
1594 | RPC_INCS: construct .h file from .x file | | 1594 | RPC_INCS: construct .h file from .x file |
1595 | RPC_XDRFILES: construct _xdr.c from .x file | | 1595 | RPC_XDRFILES: construct _xdr.c from .x file |
1596 | (for marshalling/unmarshalling data types) | | 1596 | (for marshalling/unmarshalling data types) |
1597 | RPC_SVCFILES: construct _svc.c from .x file | | 1597 | RPC_SVCFILES: construct _svc.c from .x file |
1598 | (server-side stubs) | | 1598 | (server-side stubs) |
1599 | RPC_SVCFLAGS: Additional flags passed to builds of RPC_SVCFILES. | | 1599 | RPC_SVCFLAGS: Additional flags passed to builds of RPC_SVCFILES. |
1600 | | | 1600 | |
1601 | RPC_XDIR: Directory containing .x/.h files | | 1601 | RPC_XDIR: Directory containing .x/.h files |
1602 | | | 1602 | |
1603 | | | 1603 | |
1604 | =-=-=-=-= bsd.shlib.mk =-=-=-=-= | | 1604 | =-=-=-=-= bsd.shlib.mk =-=-=-=-= |
1605 | | | 1605 | |
1606 | The include file <bsd.shlib.mk> computes parameters for shared library | | 1606 | The include file <bsd.shlib.mk> computes parameters for shared library |
1607 | installation and use. It defines no targets. <bsd.own.mk> MUST be | | 1607 | installation and use. It defines no targets. <bsd.own.mk> MUST be |
1608 | included before <bsd.shlib.mk>. | | 1608 | included before <bsd.shlib.mk>. |
1609 | | | 1609 | |
1610 | <bsd.own.mk> sets the following variables, if they are not already defined | | 1610 | <bsd.own.mk> sets the following variables, if they are not already defined |
1611 | (defaults are in brackets): | | 1611 | (defaults are in brackets): |
1612 | | | 1612 | |
1613 | SHLIBINSTALLDIR If ${USE_SHLIBDIR} is not "no", use ${SHLIBINSTALLDIR} | | 1613 | SHLIBINSTALLDIR If ${USE_SHLIBDIR} is not "no", use ${SHLIBINSTALLDIR} |
1614 | instead of ${LIBDIR} as the base path for shared library | | 1614 | instead of ${LIBDIR} as the base path for shared library |
1615 | installation. [/lib] | | 1615 | installation. [/lib] |
1616 | | | 1616 | |
1617 | SHLIBDIR The path to USE_SHLIBDIR shared libraries to use when building | | 1617 | SHLIBDIR The path to USE_SHLIBDIR shared libraries to use when building |
1618 | a program. [/lib for programs in /bin and /sbin, /usr/lib | | 1618 | a program. [/lib for programs in /bin and /sbin, /usr/lib |
1619 | for all others.] | | 1619 | for all others.] |
1620 | | | 1620 | |
1621 | _LIBSODIR Set to ${SHLIBINSTALLDIR} if ${USE_SHLIBDIR} is not "no", | | 1621 | _LIBSODIR Set to ${SHLIBINSTALLDIR} if ${USE_SHLIBDIR} is not "no", |
1622 | otherwise set to ${LIBDIR} | | 1622 | otherwise set to ${LIBDIR} |
1623 | | | 1623 | |
1624 | SHLINKINSTALLDIR Base path for shared linker. [/libexec] | | 1624 | SHLINKINSTALLDIR Base path for shared linker. [/libexec] |
1625 | | | 1625 | |
1626 | SHLINKDIR Path to use for shared linker when building a program. | | 1626 | SHLINKDIR Path to use for shared linker when building a program. |
1627 | [/libexec for programs in /bin and /sbin, /usr/libexec for | | 1627 | [/libexec for programs in /bin and /sbin, /usr/libexec for |
1628 | all others.] | | 1628 | all others.] |
1629 | | | 1629 | |
1630 | | | 1630 | |
1631 | =-=-=-=-= bsd.subdir.mk =-=-=-=-= | | 1631 | =-=-=-=-= bsd.subdir.mk =-=-=-=-= |
1632 | | | 1632 | |
1633 | The include file <bsd.subdir.mk> contains the default targets for building | | 1633 | The include file <bsd.subdir.mk> contains the default targets for building |
1634 | subdirectories. It has the same eight targets as <bsd.prog.mk>: all, | | 1634 | subdirectories. It has the same eight targets as <bsd.prog.mk>: all, |
1635 | clean, cleandir, depend, includes, install, lint, and tags. It uses the | | 1635 | clean, cleandir, depend, includes, install, lint, and tags. It uses the |
1636 | following variables: | | 1636 | following variables: |
1637 | | | 1637 | |
1638 | NOSUBDIR If this variable is defined, then the SUBDIR variable | | 1638 | NOSUBDIR If this variable is defined, then the SUBDIR variable |
1639 | will be ignored and subdirectories will not be processed. | | 1639 | will be ignored and subdirectories will not be processed. |
1640 | | | 1640 | |
1641 | SUBDIR For all of the directories listed in ${SUBDIR}, the | | 1641 | SUBDIR For all of the directories listed in ${SUBDIR}, the |
1642 | specified directory will be visited and the target made. | | 1642 | specified directory will be visited and the target made. |
1643 | | | 1643 | |
1644 | As a special case, the use of a token .WAIT as an | | 1644 | As a special case, the use of a token .WAIT as an |
1645 | entry in SUBDIR acts as a synchronization barrier | | 1645 | entry in SUBDIR acts as a synchronization barrier |
1646 | when multiple make jobs are run; subdirs before the | | 1646 | when multiple make jobs are run; subdirs before the |
1647 | .WAIT must complete before any subdirs after .WAIT are | | 1647 | .WAIT must complete before any subdirs after .WAIT are |
1648 | started. See make(1) for some caveats on use of .WAIT | | 1648 | started. See make(1) for some caveats on use of .WAIT |
1649 | and other special sources. | | 1649 | and other special sources. |
1650 | | | 1650 | |
1651 | | | 1651 | |
1652 | =-=-=-=-= bsd.sys.mk =-=-=-=-= | | 1652 | =-=-=-=-= bsd.sys.mk =-=-=-=-= |
1653 | | | 1653 | |
1654 | The include file <bsd.sys.mk> is used by <bsd.prog.mk> and | | 1654 | The include file <bsd.sys.mk> is used by <bsd.prog.mk> and |
1655 | <bsd.lib.mk>. It contains overrides that are used when building | | 1655 | <bsd.lib.mk>. It contains overrides that are used when building |
1656 | the NetBSD source tree. | | 1656 | the NetBSD source tree. |
1657 | | | 1657 | |
1658 | The following variables control how various files are compiled/built. | | 1658 | The following variables control how various files are compiled/built. |
1659 | (Note that these may be overridden in <bsd.own.mk> if USETOOLS == "yes"): | | 1659 | (Note that these may be overridden in <bsd.own.mk> if USETOOLS == "yes"): |
1660 | | | 1660 | |
1661 | AR Create, modify, and extract from archives. [ar] | | 1661 | AR Create, modify, and extract from archives. [ar] |
1662 | | | 1662 | |
1663 | ARFLAGS Options to ${AR}. [rl] | | 1663 | ARFLAGS Options to ${AR}. [rl] |
1664 | | | 1664 | |
1665 | AS Assembler. [as] | | 1665 | AS Assembler. [as] |
1666 | | | 1666 | |
1667 | AFLAGS Options to ${CC} when compiling or linking .s or .S | | 1667 | AFLAGS Options to ${CC} when compiling or linking .s or .S |
1668 | assembly source files. [] | | 1668 | assembly source files. [] |
1669 | | | 1669 | |
1670 | BUILDSEED GCC uses random numbers when compiling C++ code. | | 1670 | BUILDSEED GCC uses random numbers when compiling C++ code. |
1671 | If this option is present, seed the random number | | 1671 | If this option is present, seed the random number |
1672 | generator based on the value, source file names and | | 1672 | generator based on the value, source file names and |
1673 | the output file name to make builds more deterministic. | | 1673 | the output file name to make builds more deterministic. |
1674 | Additional information is available in the GCC | | 1674 | Additional information is available in the GCC |
1675 | documentation of -frandom-seed. | | 1675 | documentation of -frandom-seed. |
1676 | | | 1676 | |
1677 | CC C compiler. [cc] | | 1677 | CC C compiler. [cc] |
1678 | | | 1678 | |
1679 | CFLAGS Options to ${CC}. [Usually -O or -O2] | | 1679 | CFLAGS Options to ${CC}. [Usually -O or -O2] |
1680 | | | 1680 | |
1681 | CPP C Pre-Processor. [cpp] | | 1681 | CPP C Pre-Processor. [cpp] |
1682 | | | 1682 | |
1683 | CPPFLAGS Options to ${CPP}. [] | | 1683 | CPPFLAGS Options to ${CPP}. [] |
1684 | | | 1684 | |
1685 | CPUFLAGS Optimization flags for ${CC}. [] | | 1685 | CPUFLAGS Optimization flags for ${CC}. [] |
1686 | | | 1686 | |
1687 | CXX C++ compiler. [c++] | | 1687 | CXX C++ compiler. [c++] |
1688 | | | 1688 | |
1689 | CXXFLAGS Options to ${CXX}. [${CFLAGS}] | | 1689 | CXXFLAGS Options to ${CXX}. [${CFLAGS}] |
1690 | | | 1690 | |
1691 | ELF2ECOFF Convert ELF-format executable to ECOFF. [elf2ecoff] | | 1691 | ELF2ECOFF Convert ELF-format executable to ECOFF. [elf2ecoff] |
1692 | | | 1692 | |
1693 | FC Fortran compiler. [f77] | | 1693 | FC Fortran compiler. [f77] |
1694 | | | 1694 | |
1695 | FFLAGS Options to {$FC}. [-O] | | 1695 | FFLAGS Options to {$FC}. [-O] |
1696 | | | 1696 | |
1697 | HOST_SH Shell. This must be an absolute path, because it may be | | 1697 | HOST_SH Shell. This must be an absolute path, because it may be |
1698 | substituted into "#!" lines in scripts. [/bin/sh] | | 1698 | substituted into "#!" lines in scripts. [/bin/sh] |
1699 | | | 1699 | |
1700 | INSTALL install(1) command. [install] | | 1700 | INSTALL install(1) command. [install] |
1701 | | | 1701 | |
1702 | LEX Lexical analyzer. [lex] | | 1702 | LEX Lexical analyzer. [lex] |
1703 | | | 1703 | |
1704 | LFLAGS Options to ${LEX}. [] | | 1704 | LFLAGS Options to ${LEX}. [] |
1705 | | | 1705 | |
1706 | LPREFIX Symbol prefix for ${LEX} (see -P option in lex(1)) [yy] | | 1706 | LPREFIX Symbol prefix for ${LEX} (see -P option in lex(1)) [yy] |
1707 | | | 1707 | |
1708 | LD Linker. [ld] | | 1708 | LD Linker. [ld] |
1709 | | | 1709 | |
1710 | LDFLAGS Options to ${CC} during the link process. [] | | 1710 | LDFLAGS Options to ${CC} during the link process. [] |
1711 | | | 1711 | |
1712 | LINT C program verifier. [lint] | | 1712 | LINT C program verifier. [lint] |
1713 | | | 1713 | |
1714 | LINTFLAGS Options to ${LINT}. [-chapbxzFS] | | 1714 | LINTFLAGS Options to ${LINT}. [-chapbxzFS] |
1715 | | | 1715 | |
1716 | LORDER List dependencies for object files. [lorder] | | 1716 | LORDER List dependencies for object files. [lorder] |
1717 | | | 1717 | |
1718 | MAKE make(1). [make] | | 1718 | MAKE make(1). [make] |
1719 | | | 1719 | |
1720 | MKDEP Construct Makefile dependency list. [mkdep] | | 1720 | MKDEP Construct Makefile dependency list. [mkdep] |
1721 | | | 1721 | |
1722 | NM List symbols from object files. [nm] | | 1722 | NM List symbols from object files. [nm] |
1723 | | | 1723 | |
1724 | PC Pascal compiler. [pc] (Not present) | | 1724 | PC Pascal compiler. [pc] (Not present) |
1725 | | | 1725 | |
1726 | PFLAGS Options to ${PC}. [] | | 1726 | PFLAGS Options to ${PC}. [] |
1727 | | | 1727 | |
1728 | OBJC Objective C compiler. [${CC}] | | 1728 | OBJC Objective C compiler. [${CC}] |
1729 | | | 1729 | |
1730 | OBJCFLAGS Options to ${OBJC}. [${CFLAGS}] | | 1730 | OBJCFLAGS Options to ${OBJC}. [${CFLAGS}] |
1731 | | | 1731 | |
1732 | OBJCOPY Copy and translate object files. [objcopy] | | 1732 | OBJCOPY Copy and translate object files. [objcopy] |
1733 | | | 1733 | |
| | | 1734 | OBJCOPYLIBFLAGS Flags to pass to objcopy when library objects are |
| | | 1735 | being built. [${.TARGET} =~ "*.po" ? -X : -x] |
| | | 1736 | |
1734 | OBJDUMP Display information from object files. [objdump] | | 1737 | OBJDUMP Display information from object files. [objdump] |
1735 | | | 1738 | |
1736 | RANLIB Generate index to archive. [ranlib] | | 1739 | RANLIB Generate index to archive. [ranlib] |
1737 | | | 1740 | |
1738 | SIZE List section sizes and total size. [size] | | 1741 | SIZE List section sizes and total size. [size] |
1739 | | | 1742 | |
1740 | STRIP Discard symbols from object files. [strip] | | 1743 | STRIP Discard symbols from object files. [strip] |
1741 | | | 1744 | |
1742 | TSORT Topological sort of a directed graph. [tsort -q] | | 1745 | TSORT Topological sort of a directed graph. [tsort -q] |
1743 | | | 1746 | |
1744 | YACC LALR(1) parser generator. [yacc] | | 1747 | YACC LALR(1) parser generator. [yacc] |
1745 | | | 1748 | |
1746 | YFLAGS Options to ${YACC}. [] | | 1749 | YFLAGS Options to ${YACC}. [] |
1747 | | | 1750 | |
1748 | YHEADER If defined, add "-d" to YFLAGS, and add dependencies | | 1751 | YHEADER If defined, add "-d" to YFLAGS, and add dependencies |
1749 | from <file>.y to <file>.h and <file>.c, and add | | 1752 | from <file>.y to <file>.h and <file>.c, and add |
1750 | <foo>.h to CLEANFILES. | | 1753 | <foo>.h to CLEANFILES. |
1751 | | | 1754 | |
1752 | YPREFIX If defined, add "-p ${YPREFIX}" to YFLAGS. | | 1755 | YPREFIX If defined, add "-p ${YPREFIX}" to YFLAGS. |
1753 | | | 1756 | |
1754 | | | 1757 | |
1755 | Other variables of note (incomplete list): | | 1758 | Other variables of note (incomplete list): |
1756 | | | 1759 | |
1757 | NOGCCERROR If defined, prevents passing certain ${CFLAGS} to GCC | | 1760 | NOGCCERROR If defined, prevents passing certain ${CFLAGS} to GCC |
1758 | that cause warnings to be fatal, such as: | | 1761 | that cause warnings to be fatal, such as: |
1759 | -Werror -Wa,--fatal-warnings | | 1762 | -Werror -Wa,--fatal-warnings |
1760 | (The latter being for as(1).) | | 1763 | (The latter being for as(1).) |
1761 | | | 1764 | |
1762 | NOCLANGERROR If defined and clang is used as C compiler, -Werror is not | | 1765 | NOCLANGERROR If defined and clang is used as C compiler, -Werror is not |
1763 | passed to it. | | 1766 | passed to it. |
1764 | | | 1767 | |
1765 | WARNS Crank up GCC warning options; the distinct levels are: | | 1768 | WARNS Crank up GCC warning options; the distinct levels are: |
1766 | WARNS=1 | | 1769 | WARNS=1 |
1767 | WARNS=2 | | 1770 | WARNS=2 |
1768 | WARNS=3 | | 1771 | WARNS=3 |
1769 | WARNS=4 | | 1772 | WARNS=4 |
1770 | | | 1773 | |
1771 | =-=-=-=-= bsd.x11.mk =-=-=-=-= | | 1774 | =-=-=-=-= bsd.x11.mk =-=-=-=-= |
1772 | | | 1775 | |
1773 | The include file <bsd.x11.mk> contains parameters and targets for | | 1776 | The include file <bsd.x11.mk> contains parameters and targets for |
1774 | cross-building X11 from ${X11SRCDIR.xc} / ${X11MITSRCDIR.*}. | | 1777 | cross-building X11 from ${X11SRCDIR.xc} / ${X11MITSRCDIR.*}. |
1775 | It should be included after the general Makefile contents but before | | 1778 | It should be included after the general Makefile contents but before |
1776 | the include files such as <bsd.prog.mk> and <bsd.lib.mk>. | | 1779 | the include files such as <bsd.prog.mk> and <bsd.lib.mk>. |
1777 | | | 1780 | |
1778 | It provides the following targets: | | 1781 | It provides the following targets: |
1779 | .man.1 .man.3 .man.4 .man.5 .man.7: | | 1782 | .man.1 .man.3 .man.4 .man.5 .man.7: |
1780 | If ${MAN} or ${PROG} is set and ${MKMAN} != "no", | | 1783 | If ${MAN} or ${PROG} is set and ${MKMAN} != "no", |
1781 | these rules convert from X11's manual page source | | 1784 | these rules convert from X11's manual page source |
1782 | into an mdoc.old source file. | | 1785 | into an mdoc.old source file. |
1783 | | | 1786 | |
1784 | It sets the following variables: | | 1787 | It sets the following variables: |
1785 | | | 1788 | |
1786 | BINDIR Set to ${X11BINDIR}. | | 1789 | BINDIR Set to ${X11BINDIR}. |
1787 | To override, define after including <bsd.x11.mk> | | 1790 | To override, define after including <bsd.x11.mk> |
1788 | | | 1791 | |
1789 | LIBDIR Set to ${X11USRLIBDIR}. | | 1792 | LIBDIR Set to ${X11USRLIBDIR}. |
1790 | To override, define after including <bsd.x11.mk> | | 1793 | To override, define after including <bsd.x11.mk> |
1791 | | | 1794 | |
1792 | MANDIR Set to ${X11MANDIR}. | | 1795 | MANDIR Set to ${X11MANDIR}. |
1793 | To override, define after including <bsd.x11.mk> | | 1796 | To override, define after including <bsd.x11.mk> |
1794 | | | 1797 | |
1795 | CPPFLAGS Appended with definitions to include from | | 1798 | CPPFLAGS Appended with definitions to include from |
1796 | ${DESTDIR}${X11INCDIR} | | 1799 | ${DESTDIR}${X11INCDIR} |
1797 | | | 1800 | |
1798 | LDFLAGS Appended with definitions to link from | | 1801 | LDFLAGS Appended with definitions to link from |
1799 | ${DESTDIR}${X11USRLIBDIR} | | 1802 | ${DESTDIR}${X11USRLIBDIR} |
1800 | | | 1803 | |
1801 | X11FLAGS.CONNECTION Equivalent to X11's CONNECTION_FLAGS. | | 1804 | X11FLAGS.CONNECTION Equivalent to X11's CONNECTION_FLAGS. |
1802 | | | 1805 | |
1803 | X11FLAGS.EXTENSION Equivalent to X11's EXT_DEFINES. | | 1806 | X11FLAGS.EXTENSION Equivalent to X11's EXT_DEFINES. |
1804 | | | 1807 | |
1805 | X11FLAGS.LOADABLE Equivalent to X11's LOADABLE. | | 1808 | X11FLAGS.LOADABLE Equivalent to X11's LOADABLE. |
1806 | | | 1809 | |
1807 | X11FLAGS.OS_DEFINES Equivalent to X11's OS_DEFINES. | | 1810 | X11FLAGS.OS_DEFINES Equivalent to X11's OS_DEFINES. |
1808 | | | 1811 | |
1809 | X11FLAGS.SERVER Equivalent to X11's ServerDefines. | | 1812 | X11FLAGS.SERVER Equivalent to X11's ServerDefines. |
1810 | | | 1813 | |
1811 | X11FLAGS.THREADLIB Equivalent to X11's THREADS_DEFINES for libraries. | | 1814 | X11FLAGS.THREADLIB Equivalent to X11's THREADS_DEFINES for libraries. |
1812 | | | 1815 | |
1813 | X11FLAGS.THREADS Equivalent to X11's THREADS_DEFINES. | | 1816 | X11FLAGS.THREADS Equivalent to X11's THREADS_DEFINES. |
1814 | | | 1817 | |
1815 | X11FLAGS.VERSION cpp(1) definitions of OSMAJORVERSION and OSMINORVERSION. | | 1818 | X11FLAGS.VERSION cpp(1) definitions of OSMAJORVERSION and OSMINORVERSION. |
1816 | | | 1819 | |
1817 | X11FLAGS.DIX Equivalent to X11's DIX_DEFINES. | | 1820 | X11FLAGS.DIX Equivalent to X11's DIX_DEFINES. |
1818 | | | 1821 | |
1819 | X11TOOL_UNXCOMM Commandline to convert `XCOMM' comments to `#' | | 1822 | X11TOOL_UNXCOMM Commandline to convert `XCOMM' comments to `#' |
1820 | | | 1823 | |
1821 | It uses the following variables: | | 1824 | It uses the following variables: |
1822 | | | 1825 | |
1823 | APPDEFS List of app-default files to install. | | 1826 | APPDEFS List of app-default files to install. |
1824 | | | 1827 | |
1825 | CPPSCRIPTS List of files/scripts to run through cpp(1) | | 1828 | CPPSCRIPTS List of files/scripts to run through cpp(1) |
1826 | and then ${X11TOOL_UNXCOMM}. The source files | | 1829 | and then ${X11TOOL_UNXCOMM}. The source files |
1827 | have a `.cpp' suffix, the generated files do not. | | 1830 | have a `.cpp' suffix, the generated files do not. |
1828 | | | 1831 | |
1829 | CPPSCRIPTFLAGS Additional flags to cpp(1) when building CPPSCRIPTS. | | 1832 | CPPSCRIPTFLAGS Additional flags to cpp(1) when building CPPSCRIPTS. |
1830 | | | 1833 | |
1831 | CPPSCRIPTFLAGS_<fn> Additional flags to cpp(1) when building CPPSCRIPT <fn>. | | 1834 | CPPSCRIPTFLAGS_<fn> Additional flags to cpp(1) when building CPPSCRIPT <fn>. |
1832 | | | 1835 | |
1833 | | | 1836 | |
1834 | =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= | | 1837 | =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-= |