/mandos/trunk

To get this branch, use:
bzr branch http://bzr.recompile.se/loggerhead/mandos/trunk

« back to all changes in this revision

Viewing changes to Makefile

  • Committer: Teddy Hogeborn
  • Date: 2008-09-30 03:19:39 UTC
  • Revision ID: teddy@fukt.bsnet.se-20080930031939-t72se4dhr632o9ct
* Makefile: Add HTML rules for manual pages.
  (DOCBOOKTOHTML, HTMLPOST): New commands.
  (htmldocs): New file list.
  (html, install-html): New targets.
  (.PHONY, clean): Added "html".

* README (The Plugin System): New section; describe plugin system.

* debian/control (Uploaders): New field.

* mandos-options.xml (servicename): Improve wording.

* plugins.d/mandos-client.xml (SECURITY): Improve wording.

Show diffs side-by-side

added added

removed removed

Lines of Context:
Makefile
1
 
CFLAGS=-Wall -g -std=gnu99
2
 
 
3
 
PROGS=plugbasedclient plugins.d/mandosclient plugins.d/passprompt
4
 
 
5
 
objects=$(shell for p in $(PROGS); do echo $${p}.o; done)
 
1
WARN=-O -Wall -Wformat=2 -Winit-self -Wmissing-include-dirs \
 
2
        -Wswitch-default -Wswitch-enum -Wunused-parameter \
 
3
        -Wstrict-aliasing=2 -Wextra -Wfloat-equal -Wundef -Wshadow \
 
4
        -Wunsafe-loop-optimizations -Wpointer-arith \
 
5
        -Wbad-function-cast -Wcast-qual -Wcast-align -Wwrite-strings \
 
6
        -Wconversion -Wstrict-prototypes -Wold-style-definition \
 
7
        -Wpacked -Wnested-externs -Winline -Wvolatile-register-var
 
8
#       -Wunreachable-code 
 
9
#DEBUG=-ggdb3
 
10
# For info about _FORTIFY_SOURCE, see
 
11
# <http://gcc.gnu.org/ml/gcc-patches/2004-09/msg02055.html>
 
12
FORTIFY=-D_FORTIFY_SOURCE=2 # -fstack-protector-all
 
13
#COVERAGE=--coverage
 
14
OPTIMIZE=-Os
 
15
LANGUAGE=-std=gnu99
 
16
 
 
17
## Use these settings for a traditional /usr/local install
 
18
# PREFIX=$(DESTDIR)/usr/local
 
19
# CONFDIR=$(DESTDIR)/etc/mandos
 
20
# KEYDIR=$(DESTDIR)/etc/mandos/keys
 
21
# MANDIR=$(PREFIX)/man
 
22
# INITRAMFSTOOLS=$(DESTDIR)/etc/initramfs-tools
 
23
##
 
24
 
 
25
## These settings are for a package-type install
 
26
PREFIX=$(DESTDIR)/usr
 
27
CONFDIR=$(DESTDIR)/etc/mandos
 
28
KEYDIR=$(DESTDIR)/etc/keys/mandos
 
29
MANDIR=$(PREFIX)/share/man
 
30
INITRAMFSTOOLS=$(DESTDIR)/usr/share/initramfs-tools
 
31
##
 
32
 
 
33
GNUTLS_CFLAGS=$(shell libgnutls-config --cflags)
 
34
GNUTLS_LIBS=$(shell libgnutls-config --libs)
 
35
AVAHI_CFLAGS=$(shell pkg-config --cflags-only-I avahi-core)
 
36
AVAHI_LIBS=$(shell pkg-config --libs avahi-core)
 
37
GPGME_CFLAGS=$(shell gpgme-config --cflags)
 
38
GPGME_LIBS=$(shell gpgme-config --libs)
 
39
 
 
40
# Do not change these two
 
41
CFLAGS=$(WARN) $(DEBUG) $(FORTIFY) $(COVERAGE) $(OPTIMIZE) \
 
42
        $(LANGUAGE) $(GNUTLS_CFLAGS) $(AVAHI_CFLAGS) $(GPGME_CFLAGS)
 
43
LDFLAGS=$(COVERAGE)
 
44
 
 
45
# Commands to format a DocBook <refentry> document into a manual page
 
46
DOCBOOKTOMAN=cd $(dir $<); xsltproc --nonet --xinclude \
 
47
        --param man.charmap.use.subset          0 \
 
48
        --param make.year.ranges                1 \
 
49
        --param make.single.year.ranges         1 \
 
50
        --param man.output.quietly              1 \
 
51
        --param man.authors.section.enabled     0 \
 
52
         /usr/share/xml/docbook/stylesheet/nwalsh/manpages/docbook.xsl \
 
53
        $(notdir $<); \
 
54
        $(MANPOST) $(notdir $@)
 
55
# DocBook-to-man post-processing to fix a '\n' escape bug
 
56
MANPOST=sed --in-place --expression='s,\\\\en,\\en,g;s,\\n,\\en,g'
 
57
 
 
58
DOCBOOKTOHTML=xsltproc --nonet --xinclude \
 
59
        --param make.year.ranges                1 \
 
60
        --param make.single.year.ranges         1 \
 
61
        --param man.output.quietly              1 \
 
62
        --param man.authors.section.enabled     0 \
 
63
        --param citerefentry.link               1 \
 
64
        --output $@ \
 
65
        /usr/share/xml/docbook/stylesheet/nwalsh/xhtml/docbook.xsl \
 
66
        $<; $(HTMLPOST) $@
 
67
# Fix citerefentry links
 
68
HTMLPOST=sed --in-place --expression='s/\(<a class="citerefentry" href="\)\("><span class="citerefentry"><span class="refentrytitle">\)\([^<]*\)\(<\/span>(\)\([^)]*\)\()<\/span><\/a>\)/\1\3.\5\2\3\4\5\6/g'
 
69
 
 
70
PLUGINS=plugins.d/password-prompt plugins.d/mandos-client \
 
71
        plugins.d/usplash plugins.d/splashy plugins.d/askpass-fifo
 
72
PROGS=plugin-runner $(PLUGINS)
 
73
DOCS=mandos.8 plugin-runner.8mandos mandos-keygen.8 \
 
74
        plugins.d/mandos-client.8mandos \
 
75
        plugins.d/password-prompt.8mandos mandos.conf.5 \
 
76
        mandos-clients.conf.5
 
77
 
 
78
htmldocs=$(addsuffix .xhtml,$(DOCS))
 
79
 
 
80
objects=$(addsuffix .o,$(PROGS))
6
81
 
7
82
all: $(PROGS)
8
83
 
9
 
plugbasedclient: plugbasedclient.o
10
 
        $(LINK.o) -lgnutls $(COMMON) $^ $(LOADLIBES) $(LDLIBS) -o $@
11
 
 
12
 
plugins.d/mandosclient: plugins.d/mandosclient.o
13
 
        $(LINK.o) -lgnutls -lavahi-core -lgpgme $(COMMON) $^ $(LOADLIBES) $(LDLIBS) -o $@
14
 
 
15
 
plugins.d/passprompt: plugins.d/passprompt.o
16
 
        $(LINK.o) $(COMMON) $^ $(LOADLIBES) $(LDLIBS) -o $@
17
 
 
18
 
.PHONY : clean
 
84
doc: $(DOCS)
 
85
 
 
86
html: $(htmldocs)
 
87
 
 
88
%.5: %.xml legalnotice.xml
 
89
        $(DOCBOOKTOMAN)
 
90
%.5.xhtml: %.xml legalnotice.xml
 
91
        $(DOCBOOKTOHTML)
 
92
 
 
93
%.8: %.xml legalnotice.xml
 
94
        $(DOCBOOKTOMAN)
 
95
%.8.xhtml: %.xml legalnotice.xml
 
96
        $(DOCBOOKTOHTML)
 
97
 
 
98
%.8mandos: %.xml legalnotice.xml
 
99
        $(DOCBOOKTOMAN)
 
100
%.8mandos.xhtml: %.xml legalnotice.xml
 
101
        $(DOCBOOKTOHTML)
 
102
 
 
103
mandos.8: mandos.xml mandos-options.xml overview.xml legalnotice.xml
 
104
        $(DOCBOOKTOMAN)
 
105
mandos.8.xhtml: mandos.xml mandos-options.xml overview.xml \
 
106
                legalnotice.xml
 
107
        $(DOCBOOKTOHTML)
 
108
 
 
109
mandos-keygen.8: mandos-keygen.xml overview.xml legalnotice.xml
 
110
        $(DOCBOOKTOMAN)
 
111
mandos-keygen.8.xhtml: mandos-keygen.xml overview.xml legalnotice.xml
 
112
        $(DOCBOOKTOHTML)
 
113
 
 
114
mandos.conf.5: mandos.conf.xml mandos-options.xml legalnotice.xml
 
115
        $(DOCBOOKTOMAN)
 
116
mandos.conf.5.xhtml: mandos.conf.xml mandos-options.xml legalnotice.xml
 
117
        $(DOCBOOKTOHTML)
 
118
 
 
119
plugin-runner.8mandos: plugin-runner.xml overview.xml legalnotice.xml
 
120
        $(DOCBOOKTOMAN)
 
121
plugin-runner.8mandos.xhtml: plugin-runner.xml overview.xml \
 
122
                legalnotice.xml
 
123
        $(DOCBOOKTOHTML)
 
124
 
 
125
plugins.d/mandos-client.8mandos: plugins.d/mandos-client.xml \
 
126
                                        mandos-options.xml \
 
127
                                        overview.xml legalnotice.xml
 
128
        $(DOCBOOKTOMAN)
 
129
plugins.d/mandos-client.8mandos.xhtml: plugins.d/mandos-client.xml \
 
130
                                        mandos-options.xml \
 
131
                                        overview.xml legalnotice.xml
 
132
        $(DOCBOOKTOHTML)
 
133
 
 
134
plugins.d/mandos-client: plugins.d/mandos-client.o
 
135
        $(LINK.o) $(GNUTLS_LIBS) $(AVAHI_LIBS) $(GPGME_LIBS) \
 
136
                $(COMMON) $^ $(LOADLIBES) $(LDLIBS) -o $@
 
137
 
 
138
.PHONY : all doc html clean distclean run-client run-server install \
 
139
        install-server install-client uninstall uninstall-server \
 
140
        uninstall-client purge purge-server purge-client
 
141
 
19
142
clean:
20
 
        -rm -f $(PROGS) $(objects) core
 
143
        -rm --force $(PROGS) $(objects) $(htmldocs) $(DOCS) core
 
144
 
 
145
distclean: clean
 
146
mostlyclean: clean
 
147
maintainer-clean: clean
 
148
        -rm --force --recursive keydir confdir
 
149
 
 
150
check:
 
151
        ./mandos --check
 
152
 
 
153
# Run the client with a local config and key
 
154
run-client: all keydir/seckey.txt keydir/pubkey.txt
 
155
        ./plugin-runner --plugin-dir=plugins.d \
 
156
                --config-file=plugin-runner.conf \
 
157
                --options-for=mandos-client:--seckey=keydir/seckey.txt,--pubkey=keydir/pubkey.txt
 
158
 
 
159
# Used by run-client
 
160
keydir/seckey.txt keydir/pubkey.txt: mandos-keygen
 
161
        install --directory keydir
 
162
        ./mandos-keygen --dir keydir --force
 
163
 
 
164
# Run the server with a local config
 
165
run-server: confdir/mandos.conf confdir/clients.conf
 
166
        ./mandos --debug --configdir=confdir
 
167
 
 
168
# Used by run-server
 
169
confdir/mandos.conf: mandos.conf
 
170
        install --directory confdir
 
171
        install --mode=u=rw,go=r $^ $@
 
172
confdir/clients.conf: clients.conf keydir/seckey.txt
 
173
        install --directory confdir
 
174
        install --mode=u=rw $< $@
 
175
# Add a client password
 
176
        ./mandos-keygen --dir keydir --password >> $@
 
177
 
 
178
install: install-server install-client-nokey
 
179
 
 
180
install-html: $(htmldocs)
 
181
        install --directory man
 
182
        install --mode=u=rw,go=r --target-directory=man $(htmldocs)
 
183
 
 
184
install-server: doc
 
185
        install --directory $(CONFDIR)
 
186
        install --mode=u=rwx,go=rx mandos $(PREFIX)/sbin/mandos
 
187
        install --mode=u=rw,go=r --target-directory=$(CONFDIR) \
 
188
                mandos.conf
 
189
        install --mode=u=rw --target-directory=$(CONFDIR) \
 
190
                clients.conf
 
191
        install --mode=u=rwx,go=rx init.d-mandos \
 
192
                $(DESTDIR)/etc/init.d/mandos
 
193
        install --mode=u=rw,go=r default-mandos \
 
194
                $(DESTDIR)/etc/default/mandos
 
195
        if [ -z $(DESTDIR) ]; then \
 
196
                update-rc.d mandos defaults 25 15;\
 
197
        fi
 
198
        gzip --best --to-stdout mandos.8 \
 
199
                > $(MANDIR)/man8/mandos.8.gz
 
200
        gzip --best --to-stdout mandos.conf.5 \
 
201
                > $(MANDIR)/man5/mandos.conf.5.gz
 
202
        gzip --best --to-stdout mandos-clients.conf.5 \
 
203
                > $(MANDIR)/man5/mandos-clients.conf.5.gz
 
204
 
 
205
install-client-nokey: all doc
 
206
        install --directory $(PREFIX)/lib/mandos $(CONFDIR)
 
207
        install --directory --mode=u=rwx $(KEYDIR) \
 
208
                $(PREFIX)/lib/mandos/plugins.d
 
209
        if [ "$(CONFDIR)" != "$(PREFIX)/lib/mandos" ]; then \
 
210
                install --mode=u=rwx \
 
211
                        --directory "$(CONFDIR)/plugins.d"; \
 
212
        fi
 
213
        install --mode=u=rwx,go=rx \
 
214
                --target-directory=$(PREFIX)/lib/mandos plugin-runner
 
215
        install --mode=u=rwx,go=rx --target-directory=$(PREFIX)/sbin \
 
216
                mandos-keygen
 
217
        install --mode=u=rwx,go=rx \
 
218
                --target-directory=$(PREFIX)/lib/mandos/plugins.d \
 
219
                plugins.d/password-prompt
 
220
        install --mode=u=rwxs,go=rx \
 
221
                --target-directory=$(PREFIX)/lib/mandos/plugins.d \
 
222
                plugins.d/mandos-client
 
223
        install --mode=u=rwxs,go=rx \
 
224
                --target-directory=$(PREFIX)/lib/mandos/plugins.d \
 
225
                plugins.d/usplash
 
226
        install --mode=u=rwxs,go=rx \
 
227
                --target-directory=$(PREFIX)/lib/mandos/plugins.d \
 
228
                plugins.d/splashy
 
229
        install --mode=u=rwxs,go=rx \
 
230
                --target-directory=$(PREFIX)/lib/mandos/plugins.d \
 
231
                plugins.d/askpass-fifo
 
232
        install initramfs-tools-hook \
 
233
                $(INITRAMFSTOOLS)/hooks/mandos
 
234
        install --mode=u=rw,go=r initramfs-tools-hook-conf \
 
235
                $(INITRAMFSTOOLS)/conf-hooks.d/mandos
 
236
        install initramfs-tools-script \
 
237
                $(INITRAMFSTOOLS)/scripts/local-top/mandos
 
238
        install --mode=u=rw,go=r plugin-runner.conf $(CONFDIR)
 
239
        gzip --best --to-stdout mandos-keygen.8 \
 
240
                > $(MANDIR)/man8/mandos-keygen.8.gz
 
241
        gzip --best --to-stdout plugin-runner.8mandos \
 
242
                > $(MANDIR)/man8/plugin-runner.8mandos.gz
 
243
        gzip --best --to-stdout plugins.d/password-prompt.8mandos \
 
244
                > $(MANDIR)/man8/password-prompt.8mandos.gz
 
245
        gzip --best --to-stdout plugins.d/mandos-client.8mandos \
 
246
                > $(MANDIR)/man8/mandos-client.8mandos.gz
 
247
 
 
248
install-client: install-client-nokey
 
249
# Post-installation stuff
 
250
        -$(PREFIX)/sbin/mandos-keygen --dir "$(KEYDIR)"
 
251
        update-initramfs -k all -u
 
252
        echo "Now run mandos-keygen --password --dir $(KEYDIR)"
 
253
 
 
254
uninstall: uninstall-server uninstall-client
 
255
 
 
256
uninstall-server:
 
257
        -rm --force $(PREFIX)/sbin/mandos \
 
258
                $(MANDIR)/man8/mandos.8.gz \
 
259
                $(MANDIR)/man5/mandos.conf.5.gz \
 
260
                $(MANDIR)/man5/mandos-clients.conf.5.gz
 
261
        update-rc.d -f mandos remove
 
262
        -rmdir $(CONFDIR)
 
263
 
 
264
uninstall-client:
 
265
# Refuse to uninstall client if /etc/crypttab is explicitly configured
 
266
# to use it.
 
267
        ! grep --regexp='^ *[^ #].*keyscript=[^,=]*/mandos/' \
 
268
                $(DESTDIR)/etc/crypttab
 
269
        -rm --force $(PREFIX)/sbin/mandos-keygen \
 
270
                $(PREFIX)/lib/mandos/plugin-runner \
 
271
                $(PREFIX)/lib/mandos/plugins.d/password-prompt \
 
272
                $(PREFIX)/lib/mandos/plugins.d/mandos-client \
 
273
                $(PREFIX)/lib/mandos/plugins.d/usplash \
 
274
                $(PREFIX)/lib/mandos/plugins.d/splashy \
 
275
                $(INITRAMFSTOOLS)/hooks/mandos \
 
276
                $(INITRAMFSTOOLS)/conf-hooks.d/mandos \
 
277
                $(INITRAMFSTOOLS)/scripts/local-top/mandos \
 
278
                $(MANDIR)/man8/plugin-runner.8mandos.gz \
 
279
                $(MANDIR)/man8/mandos-keygen.8.gz \
 
280
                $(MANDIR)/man8/password-prompt.8mandos.gz \
 
281
                $(MANDIR)/man8/mandos-client.8mandos.gz
 
282
        if [ "$(CONFDIR)" != "$(PREFIX)/lib/mandos" ]; then \
 
283
                rm --force $(CONFDIR)/plugins.d/README; \
 
284
        fi
 
285
        -rmdir $(PREFIX)/lib/mandos/plugins.d $(CONFDIR)/plugins.d \
 
286
                 $(PREFIX)/lib/mandos $(CONFDIR) $(KEYDIR)
 
287
        update-initramfs -k all -u
 
288
 
 
289
purge: purge-server purge-client
 
290
 
 
291
purge-server: uninstall-server
 
292
        -rm --force $(CONFDIR)/mandos.conf $(CONFDIR)/clients.conf \
 
293
                $(DESTDIR)/etc/default/mandos \
 
294
                $(DESTDIR)/etc/init.d/mandos \
 
295
                $(DESTDIR)/var/run/mandos.pid
 
296
        -rmdir $(CONFDIR)
 
297
 
 
298
purge-client: uninstall-client
 
299
        -shred --remove $(KEYDIR)/seckey.txt
 
300
        -rm --force $(CONFDIR)/plugin-runner.conf \
 
301
                $(KEYDIR)/pubkey.txt $(KEYDIR)/seckey.txt
 
302
        -rmdir $(KEYDIR) $(CONFDIR)/plugins.d $(CONFDIR)