NAME¶

"gvpectrl" - GNU Virtual Private Ethernet Control Program

SYNOPSIS¶

gvpectrl [-ckgs] [--config=DIR] [--generate-keys] [--help] [--kill[=SIGNAL]] [--show-config] [--version]

DESCRIPTION¶

This is the control program for the gvpe, the virtual private ethernet daemon.

OPTIONS¶

-c, --config=DIR

Read configuration options from DIR.

-g, --generate-key=path

Generates a single RSA key-pair. The public key will be stored in path while the private key will be stored in path .privkey. Neither file must be non-empty for this to succeed.

The public key file path is normally copied to pubkey/nodename in the config directory on all nodes, while the private key path.privkey should be copied to the file hostkey on the node the key is for.

It's recommended to generate the keypair on the node where it will be used, so that the private key file does not have to travel over the network.

-G, --generate-keys

Generate public/private RSA key-pairs for all nodes not having a key and exit.

Note that in normal configurations this will fail, as there cna only be one private key per host. To make this configuration work you need to specify separate keyfiles for hostkeys in your config file, e.g.:

   private-key = hostkeys/%s
    

Such a configuration makes it easier to distribute a configuration centrally but requires private keys to be transported securely over the network.

-q, --quiet

Suppresses messages the author finds nonessential for scripting purposes.

--help

Display short list of options.

--kill[=SIGNAL]

Attempt to kill a running gvpectrl (optionally with the specified SIGNAL instead of SIGTERM) and exit.

--show-config

Show a summary of the configuration, and how gvpe interprets it. Can also be very useful when designing firewall scripts.

--version

Output version information and exit.

BUGS¶

If you find any bugs, report them to gvpe@schmorp.de.

SEE ALSO¶

gvpe(5), gvpe.conf(5), gvpe(8).

GVPE comes with ABSOLUTELY NO WARRANTY. This is free software, and you are welcome to redistribute it under certain conditions; see the file COPYING for details.

AUTHOR¶

Marc Lehmann <gvpe@schmorp.de>.