xref: /dflybsd-src/share/man/man5/compilers.conf.5 (revision c97b914161d0cd26b116bfaff8f6238a8a222d09)
1*c97b9141SSascha Wildner.\"
2*c97b9141SSascha Wildner.\" Copyright (c) 2009
3*c97b9141SSascha Wildner.\"	The DragonFly Project.  All rights reserved.
4*c97b9141SSascha Wildner.\"
5*c97b9141SSascha Wildner.\" Redistribution and use in source and binary forms, with or without
6*c97b9141SSascha Wildner.\" modification, are permitted provided that the following conditions
7*c97b9141SSascha Wildner.\" are met:
8*c97b9141SSascha Wildner.\"
9*c97b9141SSascha Wildner.\" 1. Redistributions of source code must retain the above copyright
10*c97b9141SSascha Wildner.\"    notice, this list of conditions and the following disclaimer.
11*c97b9141SSascha Wildner.\" 2. Redistributions in binary form must reproduce the above copyright
12*c97b9141SSascha Wildner.\"    notice, this list of conditions and the following disclaimer in
13*c97b9141SSascha Wildner.\"    the documentation and/or other materials provided with the
14*c97b9141SSascha Wildner.\"    distribution.
15*c97b9141SSascha Wildner.\" 3. Neither the name of The DragonFly Project nor the names of its
16*c97b9141SSascha Wildner.\"    contributors may be used to endorse or promote products derived
17*c97b9141SSascha Wildner.\"    from this software without specific, prior written permission.
18*c97b9141SSascha Wildner.\"
19*c97b9141SSascha Wildner.\" THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
20*c97b9141SSascha Wildner.\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
21*c97b9141SSascha Wildner.\" LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
22*c97b9141SSascha Wildner.\" FOR A PARTICULAR PURPOSE ARE DISCLAIMED.  IN NO EVENT SHALL THE
23*c97b9141SSascha Wildner.\" COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
24*c97b9141SSascha Wildner.\" INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING,
25*c97b9141SSascha Wildner.\" BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
26*c97b9141SSascha Wildner.\" LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
27*c97b9141SSascha Wildner.\" AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
28*c97b9141SSascha Wildner.\" OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
29*c97b9141SSascha Wildner.\" OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
30*c97b9141SSascha Wildner.\" SUCH DAMAGE.
31*c97b9141SSascha Wildner.\"
32*c97b9141SSascha Wildner.Dd July 3, 2009
33*c97b9141SSascha Wildner.Os
34*c97b9141SSascha Wildner.Dt COMPILERS.CONF 5
35*c97b9141SSascha Wildner.Sh NAME
36*c97b9141SSascha Wildner.Nm compilers.conf
37*c97b9141SSascha Wildner.Nd configuration file for external compilers
38*c97b9141SSascha Wildner.Sh SYNOPSIS
39*c97b9141SSascha Wildner.Pa /etc/compilers.conf
40*c97b9141SSascha Wildner.Sh DESCRIPTION
41*c97b9141SSascha WildnerThe
42*c97b9141SSascha Wildner.Nm
43*c97b9141SSascha Wildnerfile allows to configure
44*c97b9141SSascha Wildner.Dq external
45*c97b9141SSascha Wildnercompilers for usage with the
46*c97b9141SSascha Wildner.Dx
47*c97b9141SSascha Wildner.Xr build 7
48*c97b9141SSascha Wildnersystem.
49*c97b9141SSascha Wildner.Pp
50*c97b9141SSascha WildnerThe
51*c97b9141SSascha Wildner.Pa /etc/defaults/compilers.conf
52*c97b9141SSascha Wildnerfile specifies the default settings for all variables, the
53*c97b9141SSascha Wildner.Pa /etc/compilers.conf
54*c97b9141SSascha Wildnerfile specifies override settings.
55*c97b9141SSascha Wildner.Pp
56*c97b9141SSascha WildnerThe following variables are available:
57*c97b9141SSascha Wildner.Bl -tag -width ".Va <version>_CPPFLAGS"
58*c97b9141SSascha Wildner.It Va <version>_CC
59*c97b9141SSascha WildnerThe pathname of the
60*c97b9141SSascha Wildner.Nm cc
61*c97b9141SSascha Wildnerprogram of the compiler.
62*c97b9141SSascha Wildner.It Va <version>_CFLAGS
63*c97b9141SSascha WildnerAny additional flags to pass to
64*c97b9141SSascha Wildner.Va <version>_CC .
65*c97b9141SSascha Wildner.It Va <version>_CPP
66*c97b9141SSascha WildnerThe pathname of the
67*c97b9141SSascha Wildner.Nm cpp
68*c97b9141SSascha Wildnerprogram of the compiler.
69*c97b9141SSascha Wildner.It Va <version>_CPPFLAGS
70*c97b9141SSascha WildnerAny additional flags to pass to
71*c97b9141SSascha Wildner.Va <version>_CPP .
72*c97b9141SSascha Wildner.It Va <version>_CXX
73*c97b9141SSascha WildnerThe pathname of the
74*c97b9141SSascha Wildner.Nm c++
75*c97b9141SSascha Wildnerprogram of the compiler.
76*c97b9141SSascha Wildner.It Va <version>_CXXFLAGS
77*c97b9141SSascha WildnerAny additional flags to pass to
78*c97b9141SSascha Wildner.Va <version>_CXX .
79*c97b9141SSascha Wildner.It Va <version>_VERSION
80*c97b9141SSascha WildnerWhat to output when the
81*c97b9141SSascha Wildner.Fl dumpversion
82*c97b9141SSascha Wildneroption is used.
83*c97b9141SSascha WildnerThis helps
84*c97b9141SSascha Wildner.Nm clang
85*c97b9141SSascha Wildnerwith
86*c97b9141SSascha Wildner.Xr pkgsrc 7 .
87*c97b9141SSascha Wildner.El
88*c97b9141SSascha Wildner.Pp
89*c97b9141SSascha WildnerOnce configured the compiler can then be used like this:
90*c97b9141SSascha Wildner.Bd -literal -offset indent
91*c97b9141SSascha Wildnercd /usr/pkgsrc/wip/gcc44
92*c97b9141SSascha Wildner[build and install gcc44]
93*c97b9141SSascha Wildnercd /usr/src
94*c97b9141SSascha Wildnerenv WORLD_CCVER=gcc44 make buildworld
95*c97b9141SSascha Wildner.Ed
96*c97b9141SSascha Wildner.Pp
97*c97b9141SSascha WildnerDefaults are provided for
98*c97b9141SSascha Wildner.Nm clang
99*c97b9141SSascha Wildner(installed from SVN trunk)
100*c97b9141SSascha Wildnerand
101*c97b9141SSascha Wildner.Nm gcc44
102*c97b9141SSascha Wildner(installed from
103*c97b9141SSascha Wildner.Pa pkgsrc/wip ) .
104*c97b9141SSascha Wildner.Sh FILES
105*c97b9141SSascha Wildner.Bl -tag -width ".Pa /etc/compilers.conf" -compact
106*c97b9141SSascha Wildner.It Pa /etc/compilers.conf
107*c97b9141SSascha Wildnerexternal compiler configuration file
108*c97b9141SSascha Wildner.El
109*c97b9141SSascha Wildner.Sh SEE ALSO
110*c97b9141SSascha Wildner.Xr objformat 1 ,
111*c97b9141SSascha Wildner.Xr build 7
112*c97b9141SSascha Wildner.Sh HISTORY
113*c97b9141SSascha WildnerThe
114*c97b9141SSascha Wildner.Nm
115*c97b9141SSascha Wildnerfile first appeared in
116*c97b9141SSascha Wildner.Dx 2.3 .
117