|
 |
a9ce23 |
.nh
|
|
|
a9ce23 |
.TH netavark(1)
|
|
|
a9ce23 |
.SH NAME
|
|
|
a9ce23 |
.PP
|
|
|
a9ce23 |
netavark - Configure a given network namespace for use by a container
|
|
|
a9ce23 |
|
|
|
a9ce23 |
.SH SYNOPSIS
|
|
|
a9ce23 |
.PP
|
|
|
a9ce23 |
\fBnetavark\fP [\fIoptions\fP] \fIcommand\fP \fInetwork namespace path\fP
|
|
|
a9ce23 |
|
|
|
a9ce23 |
.SH DESCRIPTION
|
|
|
a9ce23 |
.PP
|
|
|
a9ce23 |
Netavark configures a network namespace according to a configuration read from STDIN. The configuration is JSON formatted.
|
|
|
a9ce23 |
|
|
|
a9ce23 |
.SH GLOBAL OPTIONS
|
|
|
a9ce23 |
.SS \fB--file\fP, \fB-f\fP
|
|
|
a9ce23 |
.PP
|
|
|
a9ce23 |
Instead of reading from STDIN, read the configuration to be applied from the given file. \fB-f -\fP may also be used to flag reading from STDIN.
|
|
|
a9ce23 |
|
|
|
a9ce23 |
.SH COMMANDS
|
|
|
a9ce23 |
.SS netavark setup
|
|
|
a9ce23 |
.PP
|
|
|
a9ce23 |
The setup command configures the given network namespace with the given configuration, creating any interfaces and firewall rules necessary.
|
|
|
a9ce23 |
|
|
|
a9ce23 |
.SS netavark teardown
|
|
|
a9ce23 |
.PP
|
|
|
a9ce23 |
The teardown command is the inverse of the setup command, undoing any configuration applied. Some interfaces may not be deleted (bridge interfaces, for example, will not be removed).
|
|
|
a9ce23 |
|
|
|
a9ce23 |
.SS CONFIGURATION FORMAT
|
|
|
a9ce23 |
.PP
|
|
|
a9ce23 |
The configuration accepted is the same for both setup and teardown. It is JSON formatted.
|
|
|
a9ce23 |
|
|
|
a9ce23 |
.PP
|
|
|
a9ce23 |
Format is https://github.com/containers/podman/blob/cd7b48198c38c5028540e85dc72dd3406f4318f0/libpod/network/types/network.go#L164-L173 but we will also send a Networks array including all the network definitions (https://github.com/containers/podman/blob/cd7b48198c38c5028540e85dc72dd3406f4318f0/libpod/network/types/network.go#L32-L62)
|
|
|
a9ce23 |
TODO: Transcribe configuration into here in a nice tabular format
|
|
|
a9ce23 |
|
|
|
a9ce23 |
.SH EXAMPLE
|
|
|
a9ce23 |
.PP
|
|
|
a9ce23 |
netavark setup /run/user/1000/podman/netns/d11d1f9c499d
|
|
|
a9ce23 |
|
|
|
a9ce23 |
.PP
|
|
|
a9ce23 |
netavark -f /run/podman/828b0508ae64.conf teardown /run/podman/netns/828b0508ae64
|
|
|
a9ce23 |
|
|
|
a9ce23 |
.SH SEE ALSO
|
|
|
a9ce23 |
.PP
|
|
|
a9ce23 |
podman(1)
|
|
|
a9ce23 |
|
|
|
a9ce23 |
.SH HISTORY
|
|
|
a9ce23 |
.PP
|
|
|
a9ce23 |
September 2021, Originally compiled by Matt Heon mheon@redhat.com
|
|
|
a9ce23 |
\[la]mailto:mheon@redhat.com\[ra]
|