aboutsummaryrefslogtreecommitdiff
path: root/doc/wrapperparamstrick.mdwn
blob: d55629a794905bda2e6b961ff6bd238c2be8f261 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
ikiwiki --wrapper can be used to generate a wrapper
program that runs ikiwiki with the specified parameters. This is used for
[[post-commit]] hooks, [[CGI]], etc, both for convenience and because these
things often need suid wrapper scripts to make ikiwiki run as the right
user.

The generated wrapper is a binary program. What if you want to regenerate
it with different parameters, or just run ikiwiki like it would but with
some parameter changed? To easily accomomplish this, the wrappers all
support being run with --params, which causes them to print out the
parameters they run ikiwiki with. 

You can use this trick to regenerate a wrapper, adding or changing a
parameter:

	ikiwiki $(./ikiwiki-wrap --params) --wikiname="newname" --wrapper

Or just to run ikiwiki like the wrapper would, and add a parameter:

	ikiwiki $(./ikiwiki-wrap --params) --rebuild