tinc-vpn.org Git - tinc/blob - doc/tincctl.8.in

   1 .Dd 2007-07-20
   2 .Dt TINCCTL 8
   3 .\" Manual page created by:
   4 .\" Scott Lamb
   5 .Sh NAME
   6 .Nm tincctl
   7 .Nd tinc VPN control
   8 .Sh SYNOPSIS
   9 .Nm
  10 .Op Fl cn
  11 .Op Fl -config Ns = Ns Ar DIR
  12 .Op Fl -net Ns = Ns Ar NETNAME
  13 .Op Fl -controlsocket Ns = Ns Ar FILENAME
  14 .Op Fl -help
  15 .Op Fl -version
  16 .Ar COMMAND
  17 .Sh DESCRIPTION
  18 This is the control program of tinc, a secure virtual private network (VPN)
  19 project.
  20 .Nm
  21 communicates with
  22 .Xr tincd 8
  23 to alter and inspect the running VPN's state.
  24 .Sh OPTIONS
  25 .Bl -tag -width indent
  26 .It Fl n, -net Ns = Ns Ar NETNAME
  27 Communicate with tincd(8) connected with
  28 .Ar NETNAME .
  29 .It Fl -controlsocket Ns = Ns Ar FILENAME
  30 Open control socket at
  31 .Ar FILENAME .
  32 If unspecified, the default is
  33 .Pa @localstatedir@/run/tinc. Ns Ar NETNAME Ns Pa .control.
  34 .It Fl -help
  35 Display short list of options.
  36 .It Fl -version
  37 Output version information and exit.
  38 .El
  39 .Sh COMMANDS
  40 .zZ
  41 .Bl -tag -width indent
  42 .It start
  43 Start
  44 .Xr tincd 8 .
  45 .It stop
  46 Stop
  47 .Xr tincd 8 .
  48 .It restart
  49 Restart
  50 .Xr tincd 8 .
  51 .It reload
  52 Partially rereads configuration files. Connections to hosts whose host
  53 config files are removed are closed. New outgoing connections specified
  54 in
  55 .Xr tinc.conf 5
  56 will be made.
  57 .It pid
  58 Shows the PID of the currently running
  59 .Xr tincd 8 .
  60 .It generate-keys Op bits
  61 Generate public/private RSA keypair and exit.
  62 If
  63 .Ar bits
  64 is omitted, the default length will be 1024 bits.
  65 When saving keys to existing files, tinc will not delete the old keys;
  66 you have to remove them manually.
  67 .It dump nodes
  68 Dump a list of all known nodes in the VPN.
  69 .It dump edges
  70 Dump a list of all known connections in the VPN.
  71 .It dump subnets
  72 Dump a list of all known subnets in the VPN.
  73 .It dump connections
  74 Dump a list of all meta connections with ourself.
  75 .It dump graph
  76 Dump a graph of the VPN in
  77 .Xr dotty 1
  78 format.
  79 .It purge
  80 Purges all information remembered about unreachable nodes.
  81 .El
  82 .Sh BUGS
  83 The "start", "restart", and "reload" commands are not yet implemented.
  84 .Pp
  85 If you find any bugs, report them to tinc@tinc-vpn.org.
  86 .Sh SEE ALSO
  87 .Xr tincd 8 ,
  88 .Xr tinc.conf 5 ,
  89 .Xr dotty 1 ,
  90 .Pa http://www.tinc-vpn.org/ ,
  91 .Pa http://www.cabal.org/ .
  92 .Pp
  93 The full documentation for tinc is maintained as a Texinfo manual.
  94 If the info and tinc programs are properly installed at your site,
  95 the command
  96 .Ic info tinc
  97 should give you access to the complete manual.
  98 .Pp
  99 tinc comes with ABSOLUTELY NO WARRANTY.
 100 This is free software, and you are welcome to redistribute it under certain conditions;
 101 see the file COPYING for details.
 102 .Sh AUTHORS
 103 .An "Ivo Timmermans"
 104 .An "Guus Sliepen" Aq guus@tinc-vpn.org
 105 .Pp
 106 And thanks to many others for their contributions to tinc!