wireguard-tools v1.0.20191226
-----BEGIN PGP SIGNATURE-----

iQIzBAABCAAdFiEEq5lC5tSkz8NBJiCnSfxwEqXeA64FAl4Erp8ACgkQSfxwEqXe
A67c0g/+O1RBXFekGE6aqht0XtUKos/B9vMOci8OIbcSBrEvTg+bzZo6t9KfZ8n4
vOtSFQMj0oKhTuYD3PcNFMtW598ljzEPoTwGFDx2gIhavFxCY0mAOHZcofNznpvn
/uA/t43WWeV3QE20x/EbqaV98chtX4GQ0BjoHEshfTyG6PY6OwxWuy9SpK3mix6U
x6PrNBuwhAaNqE9b8sgkdoVP5IF0PEsJxbBD0lzHqpaOeBDD8VgCaaSBAMr2ByU6
HTqAokP3FiJQfJHU+Kxe027GtNOSREirTNziycDn7MzCJZhdRx7WLCufc29DwE9T
eVeuxfErf0MzuqaQbWoEJ8swia8yhPe5scF6GVVHJ2yiuyJzb6dslkfTiamB30uO
bURg5iljZ6+pC3fhh0oqNMBVismiCd63fNtZgqx+R3PkjBiY4lAE4kUMPVqOCgrs
5/Tz8HTEEeRgVS3chE4RkJRFdW7d0vGNpckMj8o78HOBWsc3Qrvsjw032DXOsQtz
SJqkE1jFmMDFwXJYXUxzIdn5+2AyyZ9A5a4TVxLHw/w+vDYsbmnSqCsvtk7JcDGW
J5U7PPA3yysl2wfQTDaLIdjlgR5G+CAvs3bZAKnNsTesZmCFtQVMqMFUeEnQlBrW
UuGTuIAf+G03292Zl+8FziXuYYYsyXiQNsJUs1UvzcW2hYLza3Y=
=wikq
-----END PGP SIGNATURE-----
version: bump

Signed-off-by: Jason A. Donenfeld <Jason@zx2c4.com>
1 file changed
tree: d50e274b93cf0f51d5ddbd205e93eb9c846376ae
  1. .gitignore
  2. COPYING
  3. README.md
  4. contrib/
  5. src/
README.md

wireguard-tools — tools for configuring WireGuard

This supplies the main userspace tooling for using and configuring WireGuard tunnels, including the wg(8) and wg-quick(8) utilities. This project supports Linux, OpenBSD, FreeBSD, macOS, Windows, and Android.

More information may be found at WireGuard.com.

Building

$ cd src
$ make

On Linux, libmnl is required. On Windows, the MinGW compiler is required. On other platforms, only a sane libc is required.

Installing

# make install

This command takes into account several environment variables:

  • PREFIX default: /usr

  • DESTDIR default:

  • BINDIR default: $(PREFIX)/bin

  • LIBDIR default: $(PREFIX)/lib

  • MANDIR default: $(PREFIX)/share/man

  • BASHCOMPDIR default: $(PREFIX)/share/bash-completion/completions

  • RUNSTATEDIR default: /var/run

  • PKG_CONFIG default: pkg-config

  • WITH_BASHCOMPLETION default: [auto-detect]

  • WITH_WGQUICK default: [auto-detect]

  • WITH_SYSTEMDUNITS default: [auto-detect]

The first section is rather standard. The second section is not:

  • WITH_BASHCOMPLETION decides whether or not bash completion files for the tools are installed. This is just a nice thing for people who have bash. If you don‘t have bash, or don’t want this, set the environment variable to no. If you‘d like to force its use, even if bash-completion isn’t detected in DESTDIR, then set it to yes.

  • WITH_WGQUICK decides whether or not the wg-quick(8) script is installed. This is a very quick and dirty bash script for reading a few extra variables from wg(8)-style configuration files, and automatically configures the interface. If you don‘t have bash, you probably don’t want this at all. Likewise, if you already have a working network management tool or configuration, you probably want to integrate wg(8) or the direct WireGuard API into your network manager, rather than using wg-quick(8). But for folks who like simple quick and dirty scripts, this is nice. If you‘d like to force its use, even if bash isn’t detected in DESTDIR, then set it to yes.

  • WITH_SYSTEMDUNITS decides whether or not systemd units are installed for wg-quick(8). If you don‘t use systemd, you certainly don’t want this, and should set it to no. If systemd isn't auto-detected, but you still would like to install it, set this to yes.

If you‘re a simple make && make install kind of user, you can get away with not setting these variables and relying on the auto-detection. However, if you’re writing a package for a distro, you'll want to explicitly set these, depending on what you want.

contrib/

The contrib/ subdirectory contains various scripts and examples. Most of these are not immediately useful for production use, but should provide inspiration for creating fully-featured tools. See the README in each directory.

License

This project is released under the GPLv2.