Describe subnet-up/down scripts in documentation.
This commit is contained in:
parent
bded1b74cc
commit
54a30e30ad
2 changed files with 21 additions and 0 deletions
|
@ -351,6 +351,11 @@ becomes reachable.
|
|||
This script is started when the tinc daemon with name
|
||||
.Ar HOST
|
||||
becomes unreachable.
|
||||
.It Pa @sysconfdir@/tinc/ Ns Ar NETNAME Ns Pa /subnet-up
|
||||
This script is started when a Subnet becomes reachable.
|
||||
The Subnet and the node it belongs to are passed in environment variables.
|
||||
.It Pa @sysconfdir@/tinc/ Ns Ar NETNAME Ns Pa /subnet-down
|
||||
This script is started when a Subnet becomes unreachable.
|
||||
.El
|
||||
.Pp
|
||||
The scripts are started without command line arguments, but can make use of certain environment variables.
|
||||
|
@ -375,10 +380,13 @@ This should be used for commands like
|
|||
.Pa ifconfig .
|
||||
.It Ev NODE
|
||||
When a host becomes (un)reachable, this is set to its name.
|
||||
If a subnet becomes (un)reachable, this is set to the owner of that subnet.
|
||||
.It Ev REMOTEADDRESS
|
||||
When a host becomes (un)reachable, this is set to its real address.
|
||||
.It Ev REMOTEPORT
|
||||
When a host becomes (un)reachable, this is set to the port number it uses for communication with other tinc daemons.
|
||||
.It Ev SUBNET
|
||||
When a subnet becomes (un)reachable, this is set to the subnet.
|
||||
.El
|
||||
.Sh FILES
|
||||
The most important files are:
|
||||
|
|
|
@ -1100,6 +1100,13 @@ This script is started when the tinc daemon with name @var{host} becomes reachab
|
|||
|
||||
@item @value{sysconfdir}/tinc/@var{netname}/hosts/@var{host}-down
|
||||
This script is started when the tinc daemon with name @var{host} becomes unreachable.
|
||||
|
||||
@item @value{sysconfdir}/tinc/@var{netname}/subnet-up
|
||||
This script is started when a Subnet becomes reachable.
|
||||
The Subnet and the node it belongs to are passed in environment variables.
|
||||
|
||||
@item @value{sysconfdir}/tinc/@var{netname}/subnet-down
|
||||
This script is started when a Subnet becomes unreachable.
|
||||
@end table
|
||||
|
||||
@cindex environment variables
|
||||
|
@ -1129,6 +1136,7 @@ This should be used for commands like ifconfig.
|
|||
@cindex NODE
|
||||
@item NODE
|
||||
When a host becomes (un)reachable, this is set to its name.
|
||||
If a subnet becomes (un)reachable, this is set to the owner of that subnet.
|
||||
|
||||
@cindex REMOTEADDRESS
|
||||
@item REMOTEADDRESS
|
||||
|
@ -1138,6 +1146,11 @@ When a host becomes (un)reachable, this is set to its real address.
|
|||
@item REMOTEPORT
|
||||
When a host becomes (un)reachable,
|
||||
this is set to the port number it uses for communication with other tinc daemons.
|
||||
|
||||
@cindex SUBNET
|
||||
@item SUBNET
|
||||
When a subnet becomes (un)reachable, this is set to the subnet.
|
||||
|
||||
@end table
|
||||
|
||||
|
||||
|
|
Loading…
Reference in a new issue