summaryrefslogtreecommitdiff
path: root/docs/source
diff options
context:
space:
mode:
authorOpenShift Merge Robot <openshift-merge-robot@users.noreply.github.com>2019-12-09 07:53:55 -0800
committerGitHub <noreply@github.com>2019-12-09 07:53:55 -0800
commitc2dab75f0ec1502e075cf5174d1b308267648fda (patch)
tree4c000064fd0f3a660446ce6cdf2bd1bc97992bf5 /docs/source
parent7287f69b52e5bcb59f9977b261ee488942465ecb (diff)
parentef872dcd21c60af70ab1848a7e0c873f142f6f44 (diff)
downloadpodman-c2dab75f0ec1502e075cf5174d1b308267648fda.tar.gz
podman-c2dab75f0ec1502e075cf5174d1b308267648fda.tar.bz2
podman-c2dab75f0ec1502e075cf5174d1b308267648fda.zip
Merge pull request #4517 from baude/macvlan
macvlan networks
Diffstat (limited to 'docs/source')
-rw-r--r--docs/source/markdown/podman-network-create.1.md17
1 files changed, 15 insertions, 2 deletions
diff --git a/docs/source/markdown/podman-network-create.1.md b/docs/source/markdown/podman-network-create.1.md
index c281d50d9..2eca93adb 100644
--- a/docs/source/markdown/podman-network-create.1.md
+++ b/docs/source/markdown/podman-network-create.1.md
@@ -7,8 +7,10 @@ podman\-network-create - Create a Podman CNI network
**podman network create** [*options*] name
## DESCRIPTION
-Create a CNI-network configuration for use with Podman. At the time of this writing, the only network
-type that can be created is a *bridge* network.
+Create a CNI-network configuration for use with Podman. By default, Podman creates a bridge connection. A
+*Macvlan* connection can be created with the *macvlan* option. In the case of *Macvlan* connections, the
+CNI *dhcp* plugin needs to be activated or the container image must have a DHCP client to interact
+with the host network's DHCP server.
If no options are provided, Podman will assign a free subnet and name for your network.
@@ -38,6 +40,11 @@ Restrict external access of this network
Allocate container IP from a range. The range must be a complete subnet and in CIDR notation. The *ip-range* option
must be used with a *subnet* option.
+**--macvlan**
+
+Create a *Macvlan* based connection rather than a classic bridge. You must pass an interface name from the host for the
+Macvlan connection.
+
**--subnet**
The subnet in CIDR notation.
@@ -68,6 +75,12 @@ Create a network that uses a *192.168.55.0/24** subnet and has an IP address ran
/etc/cni/net.d/cni-podman-5.conflist
```
+Create a Macvlan based network using the host interface eth0
+```
+# podman network create --macvlan eth0 newnet
+/etc/cni/net.d/newnet.conflist
+```
+
## SEE ALSO
podman(1), podman-network(1), podman-network-inspect(1)