From 007df1d49491d2372ae670f71301eeafeb0bee2b Mon Sep 17 00:00:00 2001 From: Zhang Wei Date: Fri, 30 Oct 2015 00:10:20 +0800 Subject: [PATCH] Enhance `docker network rm` to delete multi net This commit enhance `docker network rm` command to allow user to delete multi networks at the same time. Signed-off-by: Zhang Wei --- docs/reference/commandline/network_rm.md | 21 +++++++++++++++--- man/docker-network-rm.1.md | 27 ++++++++++++++++++------ 2 files changed, 39 insertions(+), 9 deletions(-) diff --git a/docs/reference/commandline/network_rm.md b/docs/reference/commandline/network_rm.md index ef79fcac84..14e74717e0 100644 --- a/docs/reference/commandline/network_rm.md +++ b/docs/reference/commandline/network_rm.md @@ -10,18 +10,33 @@ parent = "smn_cli" # network rm - Usage: docker network rm [OPTIONS] NAME | ID + Usage: docker network rm [OPTIONS] NETWORK [NETWORK...] - Deletes a network + Deletes one or more networks --help=false Print usage -Removes a network by name or identifier. To remove a network, you must first disconnect any containers connected to it. +Removes one or more networks by name or identifier. To remove a network, +you must first disconnect any containers connected to it. +To remove the network named 'my-network': ```bash $ docker network rm my-network ``` +To delete multiple networks in a single `docker network rm` command, provide +multiple network names or id's. The following example deletes a network with id +`3695c422697f` and a network named `my-network`: + +```bash + $ docker network rm 3695c422697f my-network +``` + +When you specify multiple networks, the command attempts to delete each in turn. +If the deletion of one network fails, the command continues to the next on the +list and tries to delete that. The command reports success or failure for each +deletion. + ## Related information * [network disconnect ](network_disconnect.md) diff --git a/man/docker-network-rm.1.md b/man/docker-network-rm.1.md index 149503104a..7f8e3dae53 100644 --- a/man/docker-network-rm.1.md +++ b/man/docker-network-rm.1.md @@ -2,24 +2,39 @@ % Docker Community % OCT 2015 # NAME -docker-network-rm - remove a new network +docker-network-rm - remove one or more networks # SYNOPSIS -**docker network rm** +**docker network rm** [**--help**] -NETWORK +NETWORK [NETWORK...] # DESCRIPTION -Removes a network by name or identifier. To remove a network, you must first disconnect any containers connected to it. +Removes one or more networks by name or identifier. To remove a network, +you must first disconnect any containers connected to it. +To remove the network named 'my-network': -``` +```bash $ docker network rm my-network ``` +To delete multiple networks in a single `docker network rm` command, provide +multiple network names or id's. The following example deletes a network with id +`3695c422697f` and a network named `my-network`: + +```bash + $ docker network rm 3695c422697f my-network +``` + +When you specify multiple networks, the command attempts to delete each in turn. +If the deletion of one network fails, the command continues to the next on the +list and tries to delete that. The command reports success or failure for each +deletion. + # OPTIONS **NETWORK** - Specify network name + Specify network name or id **--help** Print usage statement