WG-USERSPACE(8)

WG-USERSPACE(8) | System Manager's Manual | WG-USERSPACE(8)

# NAME

`wg-userspace` — manipulate wg userspace instances (EXPERIMENTAL)

# SYNOPSIS

`wg-userspace` | id command [arguments]

# DESCRIPTION

`wg-userspace` is used to create, destroy and configure wg(4) userspace instances.

WARNING: `wg-userspace` is experimental.

The following commands are supported:

`create`
  Create an interface. The interface will appear as `tun`id to the rest of the system, and will be served by a rump server in whose context the interface appears as `wg`id.
`destroy`
  Destroy an interface and stop the rump server behind it.
`ifconfig` wgN args...
  Run ifconfig(8) in the context of the interface's rump server. For example,

      	# wg-userspace 0 ifconfig wg0 10.0.1.0/24

  will set the interface's IP address.
`wgconfig` wgN args...
  Run wgconfig(8) in the context of the interface's rump server. For example,

      	# wg-userspace 0 wgconfig wg0 set listen-port 1234

  will set the interface's listening port.
`debug` command [args...]
  Run an arbitrary command in the context of the interface's rump server, using rumphijack(3).

# SEE ALSO

wg(4), wg-keygen(8), wgconfig(8)

# HISTORY

The `wg-userspace` command first appeared in NetBSD 10.0.

# AUTHORS

The `wg-userspace` command is written by Ryota Ozaki ⟨ozaki.ryota@gmail.com⟩.

August 20, 2020 | NetBSD 11.0