.
[kopensolaris-gnu/glibc.git] / mach / Machrules
1 # Rules for MiG interfaces that want to go into the C library.
2
3 # Copyright (C) 1991, 1992, 1993, 1994, 1995 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
18 # not, write to the Free Software Foundation, Inc., 675 Mass Ave,
19 # Cambridge, MA 02139, 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 ifndef MIG
48 MIG = mig
49 endif
50 MIGFLAGS = -DMACH_IPC_COMPAT=0 -DSTANDALONE -DTypeCheck=0 \
51            $(+includes) $(migdefines) -subrprefix __
52
53 .SUFFIXES: .defs        # Just to set specified_rule_matched.
54
55 define nl       # This is needed by *.ir.
56
57
58 endef
59 ifdef user-interfaces
60 *.ir := $(addprefix $(objpfx),$(foreach if,$(user-interfaces),$(if).ir))
61 ifndef inhibit_interface_rules
62 include $(*.ir)
63 endif
64 ifneq "$(*.ir)" "$(wildcard $(*.ir))"
65 # If any .ir file is missing, we will be unable to make all the deps.
66 no_deps=t
67 endif
68 generated += $(*.ir:$(objpfx)%=%)
69 endif
70
71
72 # %.ir defines a variable `%-calls', which lists the RPCs defined by
73 # %.defs, and a rule to build $(%-calls:%=RPC_$(%-userprefix)%.c) from
74 # %.defs, where $(%-userprefix) is the user prefix given in %.defs.  We use
75 # the kludgificacious method of defining a pattern rule to build files
76 # matching patterns we are pretty damn sure will only match the particular
77 # files we have in mind.  To be so damn sure, we use the silly names
78 # RPC_*.c and the pattern R%C_*.c because using __*.c and _%*.c (or any
79 # other useful pattern) causes the rule for `host_info' to also match
80 # `xxx_host_info', and analogous lossage.
81 #
82 # While we're at it, we figure out the imports used by %.defs and give them
83 # as dependencies of the object files for the generated RPC_*.c files.
84 #
85 # Depend on %.h just so they will be built from %.uh in the
86 # makefile-rebuilding run which builds %.ir; otherwise, %.uh is built as an
87 # intermediate in order to make %.ir and then removed before re-exec, when
88 # %.uh is built all over again to build %.h.
89 $(objpfx)%.ir: $(objpfx)%.uh $(objpfx)%.h
90         (awk "NF == 4 && (\$$2 == \"Routine\" || \$$2 == \"SimpleRoutine\")\
91                 { printf \"$*-calls += %s\\n\", \$$3 }  \
92               /^#include/ { printf \"$*-imports += %s\\n\", \$$2 }" $<  ;\
93          echo '$$($*-calls:%=$$(objpfx)R\%C_%.c): $$(objpfx)$*.ustamp ;';\
94          echo '$$($*-calls:%=$$(objpfx)RPC_%.o): $$($*-imports:<%>=%)'  ;\
95         ) > $@-new
96         mv $@-new $@
97 vpath Machrules ../mach # Find ourselves.
98
99 ifndef transform-user-stub-output
100 transform-user-stub-output = tmp
101 define transform-user-stub
102 echo "weak_alias (__$$call, $$call)" >> $(objpfx)tmp_$${call}.c;
103 endef
104 endif
105
106 # Not an implicit rule so the stamps are never removed as intermediates!
107 $(patsubst %,$(objpfx)%.ustamp,$(user-interfaces)): $(objpfx)%.ustamp: %.defs
108         $(MIG) $< $(MIGFLAGS) $(user-MIGFLAGS) \
109                -prefix __ -i $(objpfx)tmp_ \
110                -server /dev/null -user /dev/null -header /dev/null
111         for call in $($*-calls); do \
112           $(transform-user-stub) \
113           ../move-if-change $(objpfx)$(transform-user-stub-output)_$${call}.c \
114                             $(objpfx)RPC_$${call}.c; \
115         done
116         touch $@
117
118 # Look for the server stub files where they will be written.
119 vpath %_server.c $(addprefix $(objpfx),$(sort $(dir $(server-interfaces))))
120
121 # Build the server stubs in $(objdir).
122 $(objpfx)%_server.c $(objpfx)%_server.h: %.defs
123         $(MIG) $< $(MIGFLAGS) $(server-MIGFLAGS) \
124                -prefix _S_ \
125                -user /dev/null -header /dev/null \
126                -server $(@:.h=.c) -sheader $(@:.c=.h)
127
128 # To get header files that declare both the straight and __ functions,
129 # we generate two files and paste them together.
130 $(objpfx)%.uh: %.defs; $(mig.uh)
131 define mig.uh
132 $(make-target-directory)
133 $(MIG) $< $(MIGFLAGS) \
134        -header $@ -server /dev/null -user /dev/null
135 endef
136 $(objpfx)%.__h: %.defs; $(mig.__h)
137 define mig.__h
138 $(make-target-directory)
139 $(MIG) $< $(MIGFLAGS) -prefix __ \
140        -header $@ -server /dev/null -user /dev/null
141 endef
142
143 $(objpfx)%.h: $(objpfx)%.__h $(objpfx)%.uh
144 # The last line of foo.__h is "#endif _foo_user_".
145 # The first two lines of foo.uh are "#ifndef _foo_user_"/"#define _foo_user_".
146         (sed -e '$$d' $<; sed -e '1,2d' $(word 2,$^)) > $@-new
147         mv $@-new $@
148
149 interface-routines := $(foreach if,$(user-interfaces),                  \
150                                 $(addprefix RPC_,$($(if)-calls)))       \
151                       $(server-interfaces:%=%_server)
152 interface-headers := $(user-interfaces:%=%.h) \
153                      $(server-interfaces:%=%_server.h)
154
155 # Remove the generated user stub source and header files,
156 # and don't distribute them.
157 mach-generated = $(interface-routines:%=%.c) \
158                  $(foreach h,$(interface-headers:%.h=%),$h.h $h.uh $h.__h)
159 generated += $(mach-generated)
160
161 # These are needed to generate the dependencies.
162 before-compile += $(interface-headers:%=$(objpfx)%)
163
164 # Don't let these be intermediate files and get removed.
165 $(foreach h,$(interface-headers:%.h=$(objpfx)%),$h.h $h.__h $h.uh) :
166 $(interface-routines:%=$(objpfx)%.c) :
167
168 # Convenient target to generate all the headers.
169 .PHONY: interface-headers
170 interface-headers: $(interface-headers)
171
172 # Don't automatically generate dependencies for the sources we generate.
173 # There are likely to be a whole lot of them, and we know their
174 # dependencies ahead of time anyway because they're boilerplate.
175 omit-deps += $(interface-routines)
176
177 # Specify the static dependencies of the generated files.
178 $(foreach o,$(object-suffixes),\
179 $(foreach if,$(user-interfaces),$($(if)-calls:%=$(objpfx)RPC_%$o))): \
180     mach/boolean.h mach/kern_return.h mach/message.h mach/notify.h \
181     mach/mach_types.h mach/mig_errors.h mach/mig_support.h mach/msg_type.h \
182     $(..)libc-symbols.h $(objpfx)config.h
183 $(foreach o,$(object-suffixes),\
184 $(server-interfaces:%=$(objpfx)%$o)): \
185     mach/boolean.h mach/kern_return.h mach/message.h mach/mig_errors.h \
186     mach/mig_support.h mach/std_types.h
187 # The MiG-generated sources also depend on the imports in their .defs files.
188 # These dependencies are generated into the .ir files above.
189 \f
190 # If defined, $(interface-library) is `libNAME'.  It is to be a library
191 # containing all the MiG-generated functions for the specified interfaces.
192
193 ifdef interface-library
194
195 $(interface-library)-routines = $(interface-routines)
196 extra-libs += $(interface-library)
197
198 endif