1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
|
# libguestfs
# Copyright (C) 2010 Red Hat Inc.
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
include $(top_srcdir)/subdir-rules.mk
generator_built = \
guestfs_protocol.x \
guestfs-structs.h \
guestfs-actions.h \
guestfs-internal-actions.h \
actions.c \
bindtests.c \
errnostring_gperf.gperf \
errnostring.c \
errnostring.h \
guestfs-actions.pod \
guestfs-availability.pod \
guestfs-structs.pod \
libguestfs.syms
BUILT_SOURCES = \
$(generator_built) \
guestfs_protocol.c \
guestfs_protocol.h \
errnostring_gperf.c
EXTRA_DIST = \
$(BUILT_SOURCES) \
MAX_PROC_NR \
libguestfs.3 \
guestfs.pod \
api-support/added \
api-support/README \
api-support/update-from-tarballs.sh
include_HEADERS = guestfs.h guestfs-actions.h guestfs-structs.h
lib_LTLIBRARIES = libguestfs.la
# This convenience library is solely to avoid compiler warnings
# in its generated sources.
libprotocol_la_SOURCES = \
guestfs_protocol.c \
guestfs_protocol.h
libprotocol_la_CFLAGS =
# Build the errnostring perfect hash code. The generated code has lots
# of warnings so we must compile it in a separate mini-library.
liberrnostring_la_SOURCES = \
errnostring_gperf.c \
errnostring.h \
errnostring.c
liberrnostring_la_CFLAGS =
errnostring_gperf.c: errnostring_gperf.gperf
rm -f $@
$(GPERF) -t $< > $@-t
mv $@-t $@
# From the libtool info file, with comments:
#
# | 1. Start with version information of `0:0:0' for each libtool library.
# |
# | 2. Update the version information only immediately before a public
# | release of your software. More frequent updates are unnecessary,
# | and only guarantee that the current interface number gets larger
# | faster.
# |
# | 3. If the library source code has changed at all since the last
# | update, then increment REVISION (`C:R:A' becomes `C:r+1:A').
#
# [So it seems like we should always update the middle 'R' field
# for any release.]
#
# | 4. If any interfaces have been added, removed, or changed since the
# | last update, increment CURRENT, and set REVISION to 0.
# |
# | 5. If any interfaces have been added since the last public release,
# | then increment AGE.
#
# [These two rules seem to mean that if any change is made to the
# generator, we should increment C and A, and set R to 0, so:
# C+1:0:A+1.]
#
# | 6. If any interfaces have been removed since the last public release,
# | then set AGE to 0.
#
# [Our ABI guarantee means we won't remove interfaces except in
# very exceptional circumstances.]
#
# The maximum proc number (see guestfs_protocol.x:guestfs_procedure) is
# a mostly accurate stand-in for C & A in rules 5 & 6, so we use that. It
# is always incremented when we add a new appliance interface, and easy to
# calculate.
#
# The middle number is hard to increment-and-reset as described in rules
# 4 & 5, so for the moment it is always set to 0.
#
# Note that this scheme means the real library version will always be
# 'libguestfs.so.0.$(MAX_PROC_NR).0'.
libguestfs_la_LDFLAGS = -version-info $(MAX_PROC_NR):0:$(MAX_PROC_NR)
libguestfs_la_LDFLAGS += $(VERSION_SCRIPT_FLAGS)libguestfs.syms
libguestfs_la_SOURCES = \
guestfs.c \
guestfs.h \
guestfs-actions.h \
guestfs-internal.h \
guestfs-structs.h \
guestfs_protocol.h \
gettext.h \
actions.c \
appliance.c \
bindtests.c \
filearch.c \
inspect.c \
launch.c \
listfs.c \
proto.c \
virt.c \
libguestfs.syms
libguestfs_la_LIBADD = \
$(HIVEX_LIBS) $(AUGEAS_LIBS) $(PCRE_LIBS) $(MAGIC_LIBS) \
$(LIBVIRT_LIBS) $(LIBXML2_LIBS) \
$(LTLIBTHREAD) ../gnulib/lib/libgnu.la
# Make libguestfs include the convenience libraries.
noinst_LTLIBRARIES = liberrnostring.la libprotocol.la
libguestfs_la_LIBADD += liberrnostring.la libprotocol.la
libguestfs_la_CFLAGS = \
-DGUESTFS_DEFAULT_PATH='"$(libdir)/guestfs"' \
$(HIVEX_CFLAGS) $(AUGEAS_CFLAGS) $(PCRE_CFLAGS) \
$(LIBVIRT_CFLAGS) $(LIBXML2_CFLAGS) \
$(WARN_CFLAGS) $(WERROR_CFLAGS)
libguestfs_la_CPPFLAGS = -I$(top_srcdir)/gnulib/lib
if HAVE_RPCGEN
guestfs_protocol.c: guestfs_protocol.x
rm -f $@-t $@-t2
$(RPCGEN) -c -o $@-t $<
sed 's,\.\./\.\./src/,,' < $@-t > $@-t2
rm $@-t
mv $@-t2 $@
guestfs_protocol.h: guestfs_protocol.x
rm -f $@-t
$(RPCGEN) -h -o $@-t $<
mv $@-t $@
endif
# Manual page.
# guestfs-actions.pod, guestfs-availability.pod and guestfs-structs.pod
# are autogenerated. There is no include mechanism for POD, so we
# have to do it by hand.
man_MANS = guestfs.3 libguestfs.3
guestfs.3: guestfs.pod \
guestfs-actions.pod \
guestfs-availability.pod \
guestfs-structs.pod
sed \
-e '/@ACTIONS@/rguestfs-actions.pod' \
-e 's/@ACTIONS@//' \
-e '/@AVAILABILITY@/rguestfs-availability.pod' \
-e 's/@AVAILABILITY@//' \
-e '/@STRUCTS@/rguestfs-structs.pod' \
-e 's/@STRUCTS@//' \
< $< | \
$(POD2MAN) \
--section 3 \
-c "Virtualization Support" \
--name "guestfs" \
--release "$(PACKAGE_NAME)-$(PACKAGE_VERSION)" \
> $@
# Check user doesn't try to do 'make all' or 'make check' as root.
# https://www.redhat.com/archives/libguestfs/2010-April/msg00098.html
all-local: checkroot
check-local: checkroot
checkroot:
@if [ "`id -u`" = 0 ]; then \
echo "*** Error: Don't run 'make' or 'make check' as root."; \
exit 1; \
fi
|