1 | .\" Automatically generated by Pod::Man 2.16 (Pod::Simple 3.05) |
1 | .\" Automatically generated by Pod::Man 2.23 (Pod::Simple 3.14) |
2 | .\" |
2 | .\" |
3 | .\" Standard preamble: |
3 | .\" Standard preamble: |
4 | .\" ======================================================================== |
4 | .\" ======================================================================== |
5 | .de Sh \" Subsection heading |
|
|
6 | .br |
|
|
7 | .if t .Sp |
|
|
8 | .ne 5 |
|
|
9 | .PP |
|
|
10 | \fB\\$1\fR |
|
|
11 | .PP |
|
|
12 | .. |
|
|
13 | .de Sp \" Vertical space (when we can't use .PP) |
5 | .de Sp \" Vertical space (when we can't use .PP) |
14 | .if t .sp .5v |
6 | .if t .sp .5v |
15 | .if n .sp |
7 | .if n .sp |
16 | .. |
8 | .. |
17 | .de Vb \" Begin verbatim text |
9 | .de Vb \" Begin verbatim text |
… | |
… | |
51 | .\" Escape single quotes in literal strings from groff's Unicode transform. |
43 | .\" Escape single quotes in literal strings from groff's Unicode transform. |
52 | .ie \n(.g .ds Aq \(aq |
44 | .ie \n(.g .ds Aq \(aq |
53 | .el .ds Aq ' |
45 | .el .ds Aq ' |
54 | .\" |
46 | .\" |
55 | .\" If the F register is turned on, we'll generate index entries on stderr for |
47 | .\" If the F register is turned on, we'll generate index entries on stderr for |
56 | .\" titles (.TH), headers (.SH), subsections (.Sh), items (.Ip), and index |
48 | .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index |
57 | .\" entries marked with X<> in POD. Of course, you'll have to process the |
49 | .\" entries marked with X<> in POD. Of course, you'll have to process the |
58 | .\" output yourself in some meaningful fashion. |
50 | .\" output yourself in some meaningful fashion. |
59 | .ie \nF \{\ |
51 | .ie \nF \{\ |
60 | . de IX |
52 | . de IX |
61 | . tm Index:\\$1\t\\n%\t"\\$2" |
53 | . tm Index:\\$1\t\\n%\t"\\$2" |
… | |
… | |
130 | .\} |
122 | .\} |
131 | .rm #[ #] #H #V #F C |
123 | .rm #[ #] #H #V #F C |
132 | .\" ======================================================================== |
124 | .\" ======================================================================== |
133 | .\" |
125 | .\" |
134 | .IX Title "GVPE.CONF 5" |
126 | .IX Title "GVPE.CONF 5" |
135 | .TH GVPE.CONF 5 "2009-03-23" "2.22" "GNU Virtual Private Ethernet" |
127 | .TH GVPE.CONF 5 "2012-07-06" "2.24" "GNU Virtual Private Ethernet" |
136 | .\" For nroff, turn off justification. Always turn off hyphenation; it makes |
128 | .\" For nroff, turn off justification. Always turn off hyphenation; it makes |
137 | .\" way too many mistakes in technical documents. |
129 | .\" way too many mistakes in technical documents. |
138 | .if n .ad l |
130 | .if n .ad l |
139 | .nh |
131 | .nh |
140 | .SH "NAME" |
132 | .SH "NAME" |
… | |
… | |
166 | = value\*(C'\fR pairs. Empty lines are ignored. Comments start with a \f(CW\*(C`#\*(C'\fR and |
158 | = value\*(C'\fR pairs. Empty lines are ignored. Comments start with a \f(CW\*(C`#\*(C'\fR and |
167 | extend to the end of the line. They can be used on their own lines, or |
159 | extend to the end of the line. They can be used on their own lines, or |
168 | after any directives. Whitespace is allowed around the \f(CW\*(C`=\*(C'\fR sign or after |
160 | after any directives. Whitespace is allowed around the \f(CW\*(C`=\*(C'\fR sign or after |
169 | values, but not within the variable names or values themselves. |
161 | values, but not within the variable names or values themselves. |
170 | .PP |
162 | .PP |
171 | The only exception to the above is the \*(L"on\*(R" directive that can prefix any |
163 | All settings are applied \*(L"in order\*(R", that is, later settings of the same |
172 | \&\f(CW\*(C`name = value\*(C'\fR setting and will only \*(L"execute\*(R" it on the named node, or |
164 | variable overwrite earlier ones. |
173 | (if the nodename starts with \*(L"!\*(R") on all nodes except the named one. |
|
|
174 | .PP |
165 | .PP |
|
|
166 | The only exceptions to the above are the \*(L"on\*(R" and \*(L"include\*(R" directives: |
|
|
167 | .IP "on nodename ..." 4 |
|
|
168 | .IX Item "on nodename ..." |
|
|
169 | .PD 0 |
|
|
170 | .IP "on !nodename ..." 4 |
|
|
171 | .IX Item "on !nodename ..." |
|
|
172 | .PD |
|
|
173 | You can prefix any configuration directive with \f(CW\*(C`on\*(C'\fR and a nodename. \s-1GVPE\s0 |
|
|
174 | will will only \*(L"execute\*(R" it on the named node, or (if the nodename starts |
|
|
175 | with \f(CW\*(C`!\*(C'\fR) on all nodes except the named one. |
|
|
176 | .Sp |
175 | For example, set the \s-1MTU\s0 to \f(CW1450\fR everywhere, loglevel to \f(CW\*(C`noise\*(C'\fR on |
177 | Example: set the \s-1MTU\s0 to \f(CW1450\fR everywhere, \f(CW\*(C`loglevel\*(C'\fR to \f(CW\*(C`noise\*(C'\fR on |
176 | branch1, and connect to \f(CW\*(C`ondemand\*(C'\fR everywhere but on branch2: |
178 | \&\f(CW\*(C`branch1\*(C'\fR, and \f(CW\*(C`connect\*(C'\fR to \f(CW\*(C`ondemand\*(C'\fR everywhere but on branch2. |
177 | .PP |
179 | .Sp |
178 | .Vb 3 |
180 | .Vb 3 |
179 | \& mtu = 1450 |
181 | \& mtu = 1450 |
180 | \& on branch1 loglevel = noise |
182 | \& on branch1 loglevel = noise |
181 | \& on !branch2 connect = ondemand |
183 | \& on !branch2 connect = ondemand |
182 | .Ve |
184 | .Ve |
183 | .PP |
185 | .IP "include relative-or-absolute-path" 4 |
184 | All settings are applied \*(L"in order\*(R", that is, later settings of the same |
186 | .IX Item "include relative-or-absolute-path" |
185 | variable overwrite earlier ones. |
187 | Reads the specified file (the path must not contain whitespace or \f(CW\*(C`=\*(C'\fR |
|
|
188 | characters) and evaluate all config directives in it as if they were |
|
|
189 | spelled out in place of the \f(CW\*(C`include\*(C'\fR directive. |
|
|
190 | .Sp |
|
|
191 | The path is a printf format string, that is, you must escape any \f(CW\*(C`%\*(C'\fR |
|
|
192 | by doubling it, and you can have a single \f(CW%s\fR inside, which will be |
|
|
193 | replaced by the current nodename. |
|
|
194 | .Sp |
|
|
195 | Relative paths are interpreted relative to the \s-1GVPE\s0 config directory. |
|
|
196 | .Sp |
|
|
197 | Example: include the file \fIlocal.conf\fR in the config directory on every |
|
|
198 | node. |
|
|
199 | .Sp |
|
|
200 | .Vb 1 |
|
|
201 | \& include local.conf |
|
|
202 | .Ve |
|
|
203 | .Sp |
|
|
204 | Example: include a file \fIconf/\fRnodename\fI.conf\fR |
|
|
205 | .Sp |
|
|
206 | .Vb 1 |
|
|
207 | \& include conf/%s.conf |
|
|
208 | .Ve |
186 | .SH "ANATOMY OF A CONFIG FILE" |
209 | .SH "ANATOMY OF A CONFIG FILE" |
187 | .IX Header "ANATOMY OF A CONFIG FILE" |
210 | .IX Header "ANATOMY OF A CONFIG FILE" |
188 | Usually, a config file starts with a few global settings (like the \s-1UDP\s0 |
211 | Usually, a config file starts with a few global settings (like the \s-1UDP\s0 |
189 | port to listen on), followed by node-specific sections that begin with a |
212 | port to listen on), followed by node-specific sections that begin with a |
190 | \&\f(CW\*(C`node = nickname\*(C'\fR line. |
213 | \&\f(CW\*(C`node = nickname\*(C'\fR line. |
… | |
… | |
196 | .PP |
219 | .PP |
197 | Node-specific settings can be used at any time. If used before the first |
220 | Node-specific settings can be used at any time. If used before the first |
198 | node section they will set the default values for all following nodes. |
221 | node section they will set the default values for all following nodes. |
199 | .SH "CONFIG VARIABLES" |
222 | .SH "CONFIG VARIABLES" |
200 | .IX Header "CONFIG VARIABLES" |
223 | .IX Header "CONFIG VARIABLES" |
201 | .Sh "\s-1GLOBAL\s0 \s-1SETTINGS\s0" |
224 | .SS "\s-1GLOBAL\s0 \s-1SETTINGS\s0" |
202 | .IX Subsection "GLOBAL SETTINGS" |
225 | .IX Subsection "GLOBAL SETTINGS" |
203 | Global settings will affect the behaviour of the running gvpe daemon, that |
226 | Global settings will affect the behaviour of the running gvpe daemon, that |
204 | is, they are in some sense node-specific (config files can set different |
227 | is, they are in some sense node-specific (config files can set different |
205 | values on different nodes using \f(CW\*(C`on\*(C'\fR), but will affect the behaviour of |
228 | values on different nodes using \f(CW\*(C`on\*(C'\fR), but will affect the behaviour of |
206 | the gvpe daemon and all connections it creates. |
229 | the gvpe daemon and all connections it creates. |
… | |
… | |
210 | (default: \f(CW127.0.0.1\fR, changing it is highly recommended). |
233 | (default: \f(CW127.0.0.1\fR, changing it is highly recommended). |
211 | .IP "dns-forw-port = port-number" 4 |
234 | .IP "dns-forw-port = port-number" 4 |
212 | .IX Item "dns-forw-port = port-number" |
235 | .IX Item "dns-forw-port = port-number" |
213 | The port where the \f(CW\*(C`dns\-forw\-host\*(C'\fR is to be contacted (default: \f(CW53\fR, |
236 | The port where the \f(CW\*(C`dns\-forw\-host\*(C'\fR is to be contacted (default: \f(CW53\fR, |
214 | which is fine in most cases). |
237 | which is fine in most cases). |
|
|
238 | .IP "dns-case-preserving = yes|true|on | no|false|off" 4 |
|
|
239 | .IX Item "dns-case-preserving = yes|true|on | no|false|off" |
|
|
240 | Sets whether the \s-1DNS\s0 transport forwarding server preserves case (\s-1DNS\s0 |
|
|
241 | servers have to, but some access systems are even more broken than others) |
|
|
242 | (default: true). |
|
|
243 | .Sp |
|
|
244 | Normally, when the forwarding server changes the case of domain names then |
|
|
245 | \&\s-1GVPE\s0 will automatically set this to false. |
215 | .IP "dns-max-outstanding = integer-number-of-requests" 4 |
246 | .IP "dns-max-outstanding = integer-number-of-requests" 4 |
216 | .IX Item "dns-max-outstanding = integer-number-of-requests" |
247 | .IX Item "dns-max-outstanding = integer-number-of-requests" |
217 | The maximum number of outstanding \s-1DNS\s0 transport requests |
248 | The maximum number of outstanding \s-1DNS\s0 transport requests |
218 | (default: \f(CW100\fR). \s-1GVPE\s0 will never issue more requests then the given |
249 | (default: \f(CW100\fR). \s-1GVPE\s0 will never issue more requests then the given |
219 | limit without receiving replies. In heavily overloaded situations it might |
250 | limit without receiving replies. In heavily overloaded situations it might |
… | |
… | |
356 | other programs. |
387 | other programs. |
357 | .Sp |
388 | .Sp |
358 | The default is 47 (\s-1GRE\s0), which has a good chance of tunneling |
389 | The default is 47 (\s-1GRE\s0), which has a good chance of tunneling |
359 | through firewalls (but note that gvpe's rawip protocol is not \s-1GRE\s0 |
390 | through firewalls (but note that gvpe's rawip protocol is not \s-1GRE\s0 |
360 | compatible). Other common choices are 50 (\s-1IPSEC\s0, \s-1ESP\s0), 51 (\s-1IPSEC\s0, \s-1AH\s0), 4 |
391 | compatible). Other common choices are 50 (\s-1IPSEC\s0, \s-1ESP\s0), 51 (\s-1IPSEC\s0, \s-1AH\s0), 4 |
361 | (\s-1IPIP\s0 tunnels) or 98 (\s-1ENCAP\s0, rfc1241) |
392 | (\s-1IPIP\s0 tunnels) or 98 (\s-1ENCAP\s0, rfc1241). |
|
|
393 | .Sp |
|
|
394 | Many versions of Linux seem to have a bug that causes them to reorder |
|
|
395 | packets for some ip protocols (\s-1GRE\s0, \s-1ESP\s0) but not for others (\s-1AH\s0), so |
|
|
396 | choose wisely (that is, use 51, \s-1AH\s0). |
362 | .IP "http-proxy-host = hostname/ip" 4 |
397 | .IP "http-proxy-host = hostname/ip" 4 |
363 | .IX Item "http-proxy-host = hostname/ip" |
398 | .IX Item "http-proxy-host = hostname/ip" |
364 | The \f(CW\*(C`http\-proxy\-*\*(C'\fR family of options are only available if gvpe was |
399 | The \f(CW\*(C`http\-proxy\-*\*(C'\fR family of options are only available if gvpe was |
365 | compiled with the \f(CW\*(C`\-\-enable\-http\-proxy\*(C'\fR option and enable tunneling of |
400 | compiled with the \f(CW\*(C`\-\-enable\-http\-proxy\*(C'\fR option and enable tunneling of |
366 | tcp connections through a http proxy server. |
401 | tcp connections through a http proxy server. |
… | |
… | |
397 | currently supported. |
432 | currently supported. |
398 | .IP "keepalive = seconds" 4 |
433 | .IP "keepalive = seconds" 4 |
399 | .IX Item "keepalive = seconds" |
434 | .IX Item "keepalive = seconds" |
400 | Sets the keepalive probe interval in seconds (default: \f(CW60\fR). After this |
435 | Sets the keepalive probe interval in seconds (default: \f(CW60\fR). After this |
401 | many seconds of inactivity the daemon will start to send keepalive probe |
436 | many seconds of inactivity the daemon will start to send keepalive probe |
402 | every 3 seconds until it receives a reply from the other end. If no reply |
437 | every 3 seconds until it receives a reply from the other end. If no reply |
403 | is received within 15 seconds, the peer is considered unreachable and the |
438 | is received within 15 seconds, the peer is considered unreachable and the |
404 | connection is closed. |
439 | connection is closed. |
405 | .IP "loglevel = noise|trace|debug|info|notice|warn|error|critical" 4 |
440 | .IP "loglevel = noise|trace|debug|info|notice|warn|error|critical" 4 |
406 | .IX Item "loglevel = noise|trace|debug|info|notice|warn|error|critical" |
441 | .IX Item "loglevel = noise|trace|debug|info|notice|warn|error|critical" |
407 | Set the logging level. Connection established messages are logged at level |
442 | Set the logging level. Connection established messages are logged at level |
… | |
… | |
427 | is established (even on rekeying operations). Note that node\-up/down |
462 | is established (even on rekeying operations). Note that node\-up/down |
428 | scripts will be run asynchronously, but execution is serialised, so there |
463 | scripts will be run asynchronously, but execution is serialised, so there |
429 | will only ever be one such script running. |
464 | will only ever be one such script running. |
430 | .Sp |
465 | .Sp |
431 | In addition to all the variables passed to \f(CW\*(C`if\-up\*(C'\fR scripts, the following |
466 | In addition to all the variables passed to \f(CW\*(C`if\-up\*(C'\fR scripts, the following |
432 | environment variables will be set: |
467 | environment variables will be set (values are just examples): |
433 | .RS 4 |
468 | .RS 4 |
434 | .IP "DESTNODE=branch2" 4 |
469 | .IP "DESTNODE=branch2" 4 |
435 | .IX Item "DESTNODE=branch2" |
470 | .IX Item "DESTNODE=branch2" |
436 | The name of the remote node. |
471 | The name of the remote node. |
437 | .IP "DESTID=2" 4 |
472 | .IP "DESTID=2" 4 |
438 | .IX Item "DESTID=2" |
473 | .IX Item "DESTID=2" |
439 | The node id of the remote node. |
474 | The node id of the remote node. |
|
|
475 | .IP "DESTSI=rawip/88.99.77.55:0" 4 |
|
|
476 | .IX Item "DESTSI=rawip/88.99.77.55:0" |
|
|
477 | The \*(L"socket info\*(R" of the target node, protocol dependent but usually in |
|
|
478 | the format protocol/ip:port. |
440 | .IP "DESTIP=188.13.66.8" 4 |
479 | .IP "DESTIP=188.13.66.8" 4 |
441 | .IX Item "DESTIP=188.13.66.8" |
480 | .IX Item "DESTIP=188.13.66.8" |
442 | The numerical \s-1IP\s0 address of the remote node (gvpe accepts connections from |
481 | The numerical \s-1IP\s0 address of the remote node (gvpe accepts connections from |
443 | everywhere, as long as the other node can authenticate itself). |
482 | everywhere, as long as the other node can authenticate itself). |
444 | .IP "DESTPORT=655 # deprecated" 4 |
483 | .IP "DESTPORT=655 # deprecated" 4 |
445 | .IX Item "DESTPORT=655 # deprecated" |
484 | .IX Item "DESTPORT=655 # deprecated" |
446 | The \s-1UDP\s0 port used by the other side. |
485 | The protocol port used by the other side, if applicable. |
447 | .IP "STATE=UP" 4 |
486 | .IP "STATE=up" 4 |
448 | .IX Item "STATE=UP" |
487 | .IX Item "STATE=up" |
449 | Node-up scripts get called with STATE=UP, node-down scripts get called |
488 | Node-up scripts get called with STATE=up, node-change scripts get called |
450 | with STATE=DOWN. |
489 | with STATE=change and node-down scripts get called with STATE=down. |
451 | .RE |
490 | .RE |
452 | .RS 4 |
491 | .RS 4 |
453 | .Sp |
492 | .Sp |
454 | Here is a nontrivial example that uses nsupdate to update the name => ip |
493 | Here is a nontrivial example that uses nsupdate to update the name => ip |
455 | mapping in some \s-1DNS\s0 zone: |
494 | mapping in some \s-1DNS\s0 zone: |
… | |
… | |
461 | \& echo update add $DESTNODE.lowttl.example.net. 1 in a $DESTIP |
500 | \& echo update add $DESTNODE.lowttl.example.net. 1 in a $DESTIP |
462 | \& echo |
501 | \& echo |
463 | \& } | nsupdate \-d \-k $CONFBASE:key.example.net. |
502 | \& } | nsupdate \-d \-k $CONFBASE:key.example.net. |
464 | .Ve |
503 | .Ve |
465 | .RE |
504 | .RE |
|
|
505 | .IP "node-change = relative-or-absolute-path" 4 |
|
|
506 | .IX Item "node-change = relative-or-absolute-path" |
|
|
507 | Same as \f(CW\*(C`node\-change\*(C'\fR, but gets called whenever something about a |
|
|
508 | connection changes (such as the source \s-1IP\s0 address). |
466 | .IP "node-down = relative-or-absolute-path" 4 |
509 | .IP "node-down = relative-or-absolute-path" 4 |
467 | .IX Item "node-down = relative-or-absolute-path" |
510 | .IX Item "node-down = relative-or-absolute-path" |
468 | Same as \f(CW\*(C`node\-up\*(C'\fR, but gets called whenever a connection is lost. |
511 | Same as \f(CW\*(C`node\-up\*(C'\fR, but gets called whenever a connection is lost. |
469 | .IP "pid-file = path" 4 |
512 | .IP "pid-file = path" 4 |
470 | .IX Item "pid-file = path" |
513 | .IX Item "pid-file = path" |
… | |
… | |
499 | via gvpe and gvpe traffic via the normal system routing tables: |
542 | via gvpe and gvpe traffic via the normal system routing tables: |
500 | .Sp |
543 | .Sp |
501 | .Vb 1 |
544 | .Vb 1 |
502 | \& ip rule add not fwmark 1000 lookup 99 |
545 | \& ip rule add not fwmark 1000 lookup 99 |
503 | .Ve |
546 | .Ve |
504 | .Sh "\s-1NODE\s0 \s-1SPECIFIC\s0 \s-1SETTINGS\s0" |
547 | .SS "\s-1NODE\s0 \s-1SPECIFIC\s0 \s-1SETTINGS\s0" |
505 | .IX Subsection "NODE SPECIFIC SETTINGS" |
548 | .IX Subsection "NODE SPECIFIC SETTINGS" |
506 | The following settings are node-specific, that is, every node can have |
549 | The following settings are node-specific, that is, every node can have |
507 | different settings, even within the same gvpe instance. Settings that are |
550 | different settings, even within the same gvpe instance. Settings that are |
508 | set before the first node section set the defaults, settings that are |
551 | set before the first node section set the defaults, settings that are |
509 | set within a node section only apply to the given node. |
552 | set within a node section only apply to the given node. |
510 | .IP "allow-direct = nodename" 4 |
553 | .IP "allow-direct = nodename" 4 |
511 | .IX Item "allow-direct = nodename" |
554 | .IX Item "allow-direct = nodename" |
512 | Allow direct connections to this node. See \f(CW\*(C`deny\-direct\*(C'\fR for more info. |
555 | Allow direct connections to this node. See \f(CW\*(C`deny\-direct\*(C'\fR for more info. |
513 | .IP "compress = yes|true|on | no|false|off" 4 |
556 | .IP "compress = yes|true|on | no|false|off" 4 |
514 | .IX Item "compress = yes|true|on | no|false|off" |
557 | .IX Item "compress = yes|true|on | no|false|off" |
|
|
558 | For the current node, this specified whether it will accept compressed |
|
|
559 | packets, and for all other nodes, this specifies whether to try to |
515 | Wether to compress data packets sent to this node (default: \f(CW\*(C`yes\*(C'\fR). |
560 | compress data packets sent to this node (default: \f(CW\*(C`yes\*(C'\fR). Compression is |
516 | Compression is really cheap even on slow computers and has no size |
561 | really cheap even on slow computers, has no size overhead at all and will |
517 | overhead at all, so enabling this is often a good idea. |
562 | only be used when the other side supports compression, so enabling this is |
|
|
563 | often a good idea. |
518 | .IP "connect = ondemand | never | always | disabled" 4 |
564 | .IP "connect = ondemand | never | always | disabled" 4 |
519 | .IX Item "connect = ondemand | never | always | disabled" |
565 | .IX Item "connect = ondemand | never | always | disabled" |
520 | Sets the connect mode (default: \f(CW\*(C`always\*(C'\fR). It can be \f(CW\*(C`always\*(C'\fR (always |
566 | Sets the connect mode (default: \f(CW\*(C`always\*(C'\fR). It can be \f(CW\*(C`always\*(C'\fR (always |
521 | try to establish and keep a connection to the given node), \f(CW\*(C`never\*(C'\fR |
567 | try to establish and keep a connection to the given node), \f(CW\*(C`never\*(C'\fR |
522 | (never initiate a connection to the given host, but accept connections), |
568 | (never initiate a connection to the given host, but accept connections), |
… | |
… | |
607 | when gvpe was compiled using the \f(CW\*(C`\-\-enable\-tcp\*(C'\fR option. |
653 | when gvpe was compiled using the \f(CW\*(C`\-\-enable\-tcp\*(C'\fR option. |
608 | .IP "enable-udp = yes|true|on | no|false|off" 4 |
654 | .IP "enable-udp = yes|true|on | no|false|off" 4 |
609 | .IX Item "enable-udp = yes|true|on | no|false|off" |
655 | .IX Item "enable-udp = yes|true|on | no|false|off" |
610 | See \fIgvpe.protocol\fR\|(7) for a description of the \s-1UDP\s0 transport protocol. |
656 | See \fIgvpe.protocol\fR\|(7) for a description of the \s-1UDP\s0 transport protocol. |
611 | .Sp |
657 | .Sp |
612 | Enable the UDPv4 transport using the \f(CW\*(C`udp\-port\*(C'\fR port (default: \f(CW\*(C`no\*(C'\fR, |
658 | Enable the UDPv4 transport using the \f(CW\*(C`udp\-port\*(C'\fR port (default: \f(CW\*(C`no\*(C'\fR). |
613 | unless no other protocol is enabled for a node, in which case this |
|
|
614 | protocol is enabled automatically). |
|
|
615 | .Sp |
|
|
616 | \&\s-1NOTE:\s0 Please specify \f(CW\*(C`enable\-udp = yes\*(C'\fR if you want to use it even though |
|
|
617 | it might get switched on automatically, as some future version might |
|
|
618 | default to another default protocol. |
|
|
619 | .IP "hostname = hostname | ip [can not be defaulted]" 4 |
659 | .IP "hostname = hostname | ip [can not be defaulted]" 4 |
620 | .IX Item "hostname = hostname | ip [can not be defaulted]" |
660 | .IX Item "hostname = hostname | ip [can not be defaulted]" |
621 | Forces the address of this node to be set to the given \s-1DNS\s0 hostname or \s-1IP\s0 |
661 | Forces the address of this node to be set to the given \s-1DNS\s0 hostname or \s-1IP\s0 |
622 | address. It will be resolved before each connect request, so dyndns should |
662 | address. It will be resolved before each connect request, so dyndns should |
623 | work fine. If this setting is not specified and a router is available, |
663 | work fine. If this setting is not specified and a router is available, |
… | |
… | |
638 | .IX Item "if-up-data = value" |
678 | .IX Item "if-up-data = value" |
639 | The value specified using this directive will be passed to the \f(CW\*(C`if\-up\*(C'\fR |
679 | The value specified using this directive will be passed to the \f(CW\*(C`if\-up\*(C'\fR |
640 | script in the environment variable \f(CW\*(C`IFUPDATA\*(C'\fR. |
680 | script in the environment variable \f(CW\*(C`IFUPDATA\*(C'\fR. |
641 | .IP "inherit-tos = yes|true|on | no|false|off" 4 |
681 | .IP "inherit-tos = yes|true|on | no|false|off" 4 |
642 | .IX Item "inherit-tos = yes|true|on | no|false|off" |
682 | .IX Item "inherit-tos = yes|true|on | no|false|off" |
643 | Wether to inherit the \s-1TOS\s0 settings of packets sent to the tunnel when |
683 | Whether to inherit the \s-1TOS\s0 settings of packets sent to the tunnel when |
644 | sending packets to this node (default: \f(CW\*(C`yes\*(C'\fR). If set to \f(CW\*(C`yes\*(C'\fR then |
684 | sending packets to this node (default: \f(CW\*(C`yes\*(C'\fR). If set to \f(CW\*(C`yes\*(C'\fR then |
645 | outgoing tunnel packets will have the same \s-1TOS\s0 setting as the packets sent |
685 | outgoing tunnel packets will have the same \s-1TOS\s0 setting as the packets sent |
646 | to the tunnel device, which is usually what you want. |
686 | to the tunnel device, which is usually what you want. |
647 | .IP "max-retry = positive-number" 4 |
687 | .IP "max-retry = positive-number" 4 |
648 | .IX Item "max-retry = positive-number" |
688 | .IX Item "max-retry = positive-number" |