chiark / gitweb /
init/tripe.conf: Reformat, and make comments more useful (and truthful).
[tripe] / init / tripe.conf
1 ### -*-sh-*-
2 ###
3 ### This file is sourced as a Bourne shell script by tripe's startup script.
4 ### There are vaguely sane defaults.
5
6 ## The directory you want tripe to work in.  This is where it will search for
7 ## keyrings, and where its admin socket and logfile are kept.  The default is
8 ## the CONFIGDIR established at `configure' time, via the `--with-configdir'
9 ## option.
10 ##
11 #TRIPEDIR=/etc/tripe
12
13 ## The tag or type of the private key to use.  This is usually `tripe'; the
14 ## default is to try both `tripe' or `tripe-dh', in that order.
15 ##
16 #keytag=tripe
17
18 ## The address you want tripe to bind to.  By default, tripe will accept
19 ## packets to any address acceptable to the host, and send packets from the
20 ## most appropriate address for the destination; setting this means it will
21 ## (a) only accept packets destined for the named address, and (b) send
22 ## packets from the named address.  The latter is probably more useful.
23 ##
24 #addr=MYHOST
25
26 ## The UDP port you want tripe to use.  The default is 4070, which is
27 ## officially allocated by the IANA.  If you explicitly specify port 0 then
28 ## tripe gets the kernel to choose a port it's not using right now, and you
29 ## have to dig it out by saying `tripectl port'.
30 ##
31 #port=4070
32
33 ## The tunnel device you want tripe to use.  The default is to use a system-
34 ## specific device, if there's one compiled in, or SLIP if not.
35 ##
36 #tunnel=slip
37
38 ## The user to run as once tripe has initialized.  TrIPE keeps a separate
39 ## process running as `root' specifically to open new tunnel devices, but
40 ## this doesn't work for SLIP devices; in this case, you must ensure that the
41 ## user (and/or group) you choose has sufficient privileges to request new
42 ## SLIP tunnels -- or acquires sufficient tunnels at startup time.  The
43 ## default is not to change user.
44 ##
45 #user=tripe
46
47 ## The group to run as once tripe has initialized.  See caveats for `user'
48 ## above.  The default is not to change group.
49 ##
50 #group=tripe
51
52 ## Trace options to pass to tripe.  The default is no tracing.  The setting
53 ## `A-cp' gives maxmimum possible verbosity without leaking important
54 ## secrets.
55 ##
56 #trace=A-cp
57
58 ## Any other options to pass on to tripectl.  (If you want to pass options on
59 ## to the tripe server itself, you'll need to put -SARG,ARG,... in here.)
60 ## The default is not to pass additional options.
61 ##
62 #miscopts=
63
64 ## Logfile to write to.  The default is determined by the `--with-logfile'
65 ## configure option, which defaults to `./tripe.log' (relative to $TRIPEDIR).
66 ##
67 #logfile=/var/log/tripe
68
69 ## Where to put tripectl's pidfile when it starts up.  The default is
70 ## determined by the `--with-pidfile' configure option, which defaults to
71 ## `./tripectl.pid' (relative to $TRIPEDIR).
72 ##
73 #pidfile=/var/run/tripectl.pid