Updated.
[kopensolaris-gnu/glibc.git] / mach / Machrules
1 # Rules for MiG interfaces that want to go into the C library.
2
3 # Copyright (C) 1991,92,93,94,95,96,98,99 Free Software Foundation, Inc.
4 # This file is part of the GNU C Library.
5
6 # The GNU C Library is free software; you can redistribute it and/or
7 # modify it under the terms of the GNU Library General Public License
8 # as published by the Free Software Foundation; either version 2 of
9 # the License, or (at your option) any later version.
10
11 # The GNU C Library is distributed in the hope that it will be useful,
12 # but WITHOUT ANY WARRANTY; without even the implied warranty of
13 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
14 # Library General Public License for more details.
15
16 # You should have received a copy of the GNU Library General Public
17 # License along with the GNU C Library; see the file COPYING.LIB.  If not,
18 # write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330,
19 # Boston, MA 02111-1307, USA.
20
21 # Makefiles may define these variable before including this file:
22 #       user-interfaces         Names of interfaces to put user stubs in for.
23 #       server-interfaces       Names of interfaces to put server stubs in for.
24 #       interface-library       Name of interface library to build and install.
25 # This file sets:
26 #       interface-headers       Names of generated interface header files.
27 #       interface-routines      Names of generated interface routines.
28 # All user stubs are put in individual files, prefixed with RPC_; header
29 # for both __ and non-__ names is put in foo.h.  Server interfaces are
30 # written to foo_server.c and foo_server.h; the server functions are called
31 # _S_rpcname.
32
33 # Includers can also add to or modify `migdefines' to set MiG flags.
34
35 all:
36
37 # Make sure no value comes from the environment, since we append to it.
38 # This is done also in ../Rules, but we append to the value before
39 # including Rules, which changes the origin.
40 ifneq   "$(findstring env,$(origin generated))" ""
41 generated :=
42 endif
43
44
45 include ../Makeconfig
46
47 # This makefile contains a lot of implicit rules that get optimized
48 # away if the target directory does not exist.
49 ifndef no_deps
50 -include $(objpfx)dummy.mk
51 endif
52 $(objpfx)dummy.mk:
53         $(make-target-directory)
54         echo '# Empty' > $@
55
56 MIGFLAGS = -DMACH_IPC_COMPAT=0 -DSTANDALONE -DTypeCheck=0 \
57            $(+includes) $(migdefines) -subrprefix __
58
59 .SUFFIXES: .defs        # Just to set specified_rule_matched.
60
61 define nl       # This is needed by *.ir.
62
63
64 endef
65 ifdef user-interfaces
66 *.ir := $(addprefix $(objpfx),$(foreach if,$(user-interfaces),$(if).ir))
67 ifndef no_deps
68 ifndef inhibit_interface_rules
69 -include $(*.ir)
70 endif
71 endif
72 ifneq "$(*.ir)" "$(wildcard $(*.ir))"
73 # If any .ir file is missing, we will be unable to make all the deps.
74 no_deps=t
75 endif
76 generated += $(*.ir:$(objpfx)%=%)
77 endif
78
79
80 # %.ir defines a variable `%-calls', which lists the RPCs defined by
81 # %.defs, and a rule to build $(%-calls:%=RPC_$(%-userprefix)%.c) from
82 # %.defs, where $(%-userprefix) is the user prefix given in %.defs.  We use
83 # the kludgificacious method of defining a pattern rule to build files
84 # matching patterns we are pretty damn sure will only match the particular
85 # files we have in mind.  To be so damn sure, we use the silly names
86 # RPC_*.c and the pattern R%C_*.c because using __*.c and _%*.c (or any
87 # other useful pattern) causes the rule for `host_info' to also match
88 # `xxx_host_info', and analogous lossage.
89 #
90 # Depend on %.h just so they will be built from %.uh in the
91 # makefile-rebuilding run which builds %.ir; otherwise, %.uh is built as an
92 # intermediate in order to make %.ir and then removed before re-exec, when
93 # %.uh is built all over again to build %.h.
94 $(objpfx)%.ir: $(objpfx)%.uh $(objpfx)%.h
95         ($(AWK) "NF == 4 && (\$$2 == \"Routine\" || \$$2 == \"SimpleRoutine\")\
96                 { printf \"$*-calls += %s\\n\", \$$3 }" $<      ;\
97          echo '$$($*-calls:%=$$(objpfx)R\%C_%.c): $$(objpfx)$*.ustamp ;';\
98         ) > $@-new
99         mv -f $@-new $@
100 vpath Machrules ../mach # Find ourselves.
101
102 ifndef transform-user-stub-output
103 transform-user-stub-output = tmp
104 define transform-user-stub
105 echo "weak_alias (__$$call, $$call)" >> $(objpfx)tmp_$${call}.c;
106 endef
107 endif
108
109
110 # Generate `#include <NAME.defs>', taking $* for NAME.
111 # If $(NAME.defs) is defined use its value in place of `NAME.defs'.
112 define include-%.defs
113 echo '#include <$(firstword $($*.defs) $*.defs)>'
114 endef
115
116 ifndef no_deps
117 # Not an implicit rule so the stamps are never removed as intermediates!
118 $(patsubst %,$(objpfx)%.ustamp,$(user-interfaces)): $(objpfx)%.ustamp:
119         rm -f $@
120         $(include-%.defs) | \
121         $(MIG) - /dev/null -prefix __ \
122                $(MIGFLAGS) $(user-MIGFLAGS) $(MIGFLAGS-$*) \
123                -i $(objpfx)tmp_ \
124                -server /dev/null -user /dev/null -header /dev/null
125         for call in $($*-calls); do \
126           $(transform-user-stub) \
127           $(move-if-change) $(objpfx)$(transform-user-stub-output)_$${call}.c \
128                             $(objpfx)RPC_$${call}.c; \
129         done
130         touch $@
131 -include $(patsubst %,$(objpfx)%.udeps,$(user-interfaces))
132 $(patsubst %,$(objpfx)%.udeps,$(user-interfaces)):
133   $(objpfx)%.udeps: $(..)mach/Machrules
134         $(make-target-directory)
135         $(include-%.defs) | \
136         $(CC) $(CPPFLAGS) -M -x c - | \
137         sed -e 's,- *:,$@ $(@:.udeps=.ustamp) $(@:.udeps=.uh) $(@:.udeps=.__h)\
138                           $(@:.udeps=_server.c) $(@:.udeps=_server.h):,' \
139             $(sed-remove-objpfx) > $@.new
140         mv -f $@.new $@
141 endif
142
143 # Look for the server stub files where they will be written.
144 vpath %_server.c $(addprefix $(objpfx),$(sort $(dir $(server-interfaces))))
145
146 # Build the server stubs in $(objdir).
147 $(objpfx)%_server.c $(objpfx)%_server.h:
148         $(make-target-directory)
149         $(include-%.defs) | \
150         $(MIG) - /dev/null -prefix _S_ \
151                $(MIGFLAGS) $(server-MIGFLAGS) $(MIGFLAGS-$*) \
152                -user /dev/null -header /dev/null \
153                -server $(@:.h=.c) -sheader $(@:.c=.h)
154
155 # To get header files that declare both the straight and __ functions,
156 # we generate two files and paste them together.
157 $(objpfx)%.uh:; $(mig.uh)
158 define mig.uh
159 $(make-target-directory)
160 $(include-%.defs) | \
161 $(MIG) - /dev/null $(MIGFLAGS) $(MIGFLAGS-$*) \
162        -header $@ -server /dev/null -user /dev/null
163 endef
164 $(objpfx)%.__h:; $(mig.__h)
165 define mig.__h
166 $(make-target-directory)
167 $(include-%.defs) | \
168 $(MIG) - /dev/null $(MIGFLAGS) $(MIGFLAGS-$*) -prefix __ \
169        -header $@ -server /dev/null -user /dev/null
170 endef
171
172 $(objpfx)%.h: $(objpfx)%.__h $(objpfx)%.uh
173 # The last line of foo.__h is "#endif _foo_user_".
174 # The first two lines of foo.uh are "#ifndef _foo_user_"/"#define _foo_user_".
175         (sed -e '$$d' $<; sed -e '1,2d' $(word 2,$^)) > $@-new
176         mv -f $@-new $@
177
178 interface-routines := $(foreach if,$(user-interfaces),                  \
179                                 $(addprefix RPC_,$($(if)-calls)))       \
180                       $(server-interfaces:%=%_server)
181 interface-headers := $(user-interfaces:%=%.h) \
182                      $(server-interfaces:%=%_server.h)
183
184 # Remove the generated user stub source and header files,
185 # and don't distribute them.
186 mach-generated = $(interface-routines:%=%.c) $(interface-headers) \
187                  $(foreach h,$(user-interfaces),$h.uh $h.__h)
188 generated += $(mach-generated)
189
190 # These are needed to generate the dependencies.
191 before-compile += $(interface-headers:%=$(objpfx)%)
192
193 # Don't let these be intermediate files and get removed.
194 $(foreach h,$(interface-headers:%.h=$(objpfx)%),$h.h $h.__h $h.uh) :
195 $(interface-routines:%=$(objpfx)%.c) :
196
197 # Convenient target to generate all the headers.
198 .PHONY: interface-headers
199 interface-headers: $(interface-headers)
200
201 # Don't automatically generate dependencies for the sources we generate.
202 # There are likely to be a whole lot of them, and we know their
203 # dependencies ahead of time anyway because they're boilerplate.
204 omit-deps += $(interface-routines)
205
206 # Choose any single module generated by MiG.  We will compute this module's
207 # dependencies and then assume all other MiG-generated modules depend on the
208 # same headers.
209 some-if-rtn := $(firstword $(interface-routines))
210 ifdef some-if-rtn
211 $(foreach o,$(object-suffixes),$(interfaces-routines:%=%$o)): $(some-if-rtn).d
212 generated += $(some-if-rtn).d
213 endif
214 \f
215 # If defined, $(interface-library) is `libNAME'.  It is to be a library
216 # containing all the MiG-generated functions for the specified interfaces.
217
218 ifdef interface-library
219
220 $(interface-library)-routines = $(interface-routines)
221 extra-libs += $(interface-library)
222 extra-libs-others += $(interface-library)
223
224 ifeq (yes,$(build-shared))
225 interface.so = $(interface-library:=.so)
226
227 # Depend on libc.so so a DT_NEEDED is generated in the shared objects.
228 $(objpfx)$(interface.so): $(common-objpfx)libc.so
229 endif
230
231 endif