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