Skip to content

feat: support secondary IP address configuration #7

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
jfut merged 1 commit into from
Jun 21, 2026
Merged

feat: support secondary IP address configuration #7

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
68 changes: 58 additions & 10 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -83,10 +83,16 @@ Usage:
-n No interface check (Default: check interface)
-x Run command (Default: echo only)

Note:
static replaces all IPv4 addresses.
Use comma-separated IP_SUBNET values to set secondary IP addresses.
The first IP_SUBNET is the primary IP address.

Examples:
nmcli-cli-ipv4 eno1 dhcp
nmcli-cli-ipv4 eno1 static 192.168.1.101/24 192.168.1.1 "192.168.1.1,10.0.0.2"
nmcli-cli-ipv4 eno1 static 192.168.1.101/24 192.168.1.1 192.168.1.1,10.0.0.2
nmcli-cli-ipv4 eno1 static 192.168.1.101/24
nmcli-cli-ipv4 eno1 static 192.168.1.101/24,10.0.0.201/23
nmcli-cli-ipv4 eno1 disable
```

Expand All @@ -112,6 +118,23 @@ nmcli connection modify eno1 ipv4.addresses "" ipv4.method auto
# -> Create a bridge interface:
# nmcli-cli-bridge-add br1 "eno1"

# [static with secondary address: echo only]
# ==========================================
# nmcli-cli-ipv4 eno1 static 192.168.1.101/24,10.0.0.201/23
# echo only.
nmcli connection modify eno1 ipv4.addresses 192.168.1.101/24,10.0.0.201/23 ipv4.method manual

# Next steps:
# -> Restart the interface:
# nmcli-cli-restart "eno1"
#
# -> Create a bond interface:
# nmcli-cli-bond-add bond1 mode=... "eno1" "ens2f0"
# -> Create a vlan interface:
# nmcli-cli-vlan-add "eno1.100" 100 "eno1"
# -> Create a bridge interface:
# nmcli-cli-bridge-add br1 "eno1"

# [disable: dummy interface + echo only]
# ======================================
# nmcli-cli-ipv4 -n eno1 disable
Expand All @@ -133,7 +156,7 @@ nmcli connection modify eno1 ipv4.addresses "" ipv4.method disabled

# [static: run it]
# ================
# nmcli-cli-ipv4 -x eno1 static 192.168.1.101/24 192.168.1.1 "192.168.1.1,10.0.0.2"
# nmcli-cli-ipv4 -x eno1 static 192.168.1.101/24 192.168.1.1 192.168.1.1,10.0.0.2
Applying: nmcli connection modify "eno1" ipv4.addresses "192.168.1.101/24" ipv4.method manual
Applying: nmcli connection modify "eno1" ipv4.gateway "192.168.1.1"
Applying: nmcli connection modify "eno1" ipv4.dns "192.168.1.1,10.0.0.2"
Expand Down Expand Up @@ -164,6 +187,7 @@ Usage:
Examples:
nmcli-cli-ipv4-copy eno1 bond1
nmcli-cli-ipv4-copy bond1 br1
nmcli-cli-ipv4-copy eno1 bond1 (copy primary and secondary addresses)
nmcli-cli-ipv4-copy eno1 (show current configuration)
```

Expand All @@ -174,7 +198,7 @@ Run examples:
# ======================
# nmcli-cli-ipv4-copy eno1 bond1
# echo only.
nmcli connection modify "bond1" ipv4.addresses "192.168.1.101/24" ipv4.method manual
nmcli connection modify bond1 ipv4.addresses 192.168.1.101/24,192.168.1.102/24 ipv4.method manual
nmcli connection modify bond1 ipv4.gateway 192.168.1.1
nmcli connection modify bond1 ipv4.dns "192.168.1.1,10.0.0.2"

Expand All @@ -194,7 +218,7 @@ nmcli connection modify bond1 ipv4.dns "192.168.1.1,10.0.0.2"
# [copy ipv4: run it]
# ===================
# nmcli-cli-ipv4-copy -x bond1 br1
Applying: nmcli connection modify "br1" ipv4.addresses "192.168.1.101/24" ipv4.method manual
Applying: nmcli connection modify br1 ipv4.addresses 192.168.1.101/24,192.168.1.102/24 ipv4.method manual
Applying: nmcli connection modify br1 ipv4.gateway 192.168.1.1
Applying: nmcli connection modify br1 ipv4.dns "192.168.1.1,10.0.0.2"

Expand Down Expand Up @@ -225,11 +249,17 @@ Usage:
-n No interface check (Default: check interface)
-x Run command (Default: echo only)

Note:
static replaces all IPv6 addresses.
Use comma-separated IP_SUBNET values to set secondary IP addresses.
The first IP_SUBNET is the primary IP address.

Examples:
nmcli-cli-ipv6 eno1 auto
nmcli-cli-ipv6 eno1 dhcp
nmcli-cli-ipv6 eno1 static 2001:db8:1::101/48 2001:db8:1::1 "2001:db8:1::1,2001:db8:1::2"
nmcli-cli-ipv6 eno1 static 2001:db8:1::101/48 2001:db8:1::1 2001:db8:1::1,2001:db8:1::2
nmcli-cli-ipv6 eno1 static 2001:db8:1::101/48
nmcli-cli-ipv6 eno1 static 2001:db8:1::101/48,2001:db8:2::201/64
nmcli-cli-ipv6 eno1 link-local
nmcli-cli-ipv6 eno1 disable
```
Expand All @@ -255,6 +285,23 @@ nmcli connection modify "eno1" ipv6.addresses "" ipv6.method dhcp
# -> Create a bridge interface:
# nmcli-cli-bridge-add br1 "eno1"

# [static with secondary address: echo only]
# ==========================================
# nmcli-cli-ipv6 eno1 static 2001:db8:1::101/48,2001:db8:2::201/64
# echo only.
nmcli connection modify eno1 ipv6.addresses 2001:db8:1::101/48,2001:db8:2::201/64 ipv6.method manual

# Next steps:
# -> Restart the interface:
# nmcli-cli-restart "eno1"
#
# -> Create a bond interface:
# nmcli-cli-bond-add bond1 mode=... "eno1" "ens2f0"
# -> Create a vlan interface:
# nmcli-cli-vlan-add "eno1.100" 100 "eno1"
# -> Create a bridge interface:
# nmcli-cli-bridge-add br1 "eno1"

# [disable: dummy interface + echo only]
# ======================================
# nmcli-cli-ipv6 -n eno1 disable
Expand All @@ -276,7 +323,7 @@ nmcli connection modify "eno1" ipv6.addresses "" ipv6.method ignore

# [static: run it]
# ================
# nmcli-cli-ipv6 -x eno1 static 2001:db8:1::101/48 2001:db8:1::1 "2001:db8:1::1,2001:db8:1::2"
# nmcli-cli-ipv6 -x eno1 static 2001:db8:1::101/48 2001:db8:1::1 2001:db8:1::1,2001:db8:1::2
Applying: nmcli connection modify "eno1" ipv6.addresses "2001:db8:1::101/48" ipv6.method manual
Applying: nmcli connection modify "eno1" ipv6.gateway "2001:db8:1::1"
Applying: nmcli connection modify "eno1" ipv6.dns "2001:db8:1::1,2001:db8:1::2"
Expand Down Expand Up @@ -307,6 +354,7 @@ Usage:
Examples:
nmcli-cli-ipv6-copy eno1 bond1
nmcli-cli-ipv6-copy bond1 br1
nmcli-cli-ipv6-copy eno1 bond1 (copy primary and secondary addresses)
nmcli-cli-ipv6-copy eno1 (show current configuration)
```

Expand All @@ -317,7 +365,7 @@ Run examples:
# ======================
# nmcli-cli-ipv6-copy eno1 bond1
# echo only.
nmcli connection modify bond1 ipv6.addresses 2001:db8:1::101/48 ipv6.method manual
nmcli connection modify bond1 ipv6.addresses 2001:db8:1::101/48,2001:db8:1::102/48 ipv6.method manual
nmcli connection modify "bond1" ipv6.gateway "2001:db8:1::1"
nmcli connection modify "bond1" ipv6.dns "2001:db8:1::1,2001:db8:1::2"

Expand All @@ -337,7 +385,7 @@ nmcli connection modify "bond1" ipv6.dns "2001:db8:1::1,2001:db8:1::2"
# [copy ipv6: run it]
# ===================
# nmcli-cli-ipv6-copy -x bond1 br1
Applying: nmcli connection modify br1 ipv6.addresses 2001:db8:1::101/48 ipv6.method manual
Applying: nmcli connection modify br1 ipv6.addresses 2001:db8:1::101/48,2001:db8:1::102/48 ipv6.method manual
Applying: nmcli connection modify br1 ipv6.gateway 2001:db8:1::1
Applying: nmcli connection modify br1 ipv6.dns "2001:db8:1::1,2001:db8:1::2"

Expand Down Expand Up @@ -865,13 +913,13 @@ nmcli connection add type vlan ipv4.method disabled ipv6.method ignore con-name
nmcli connection add type bridge autoconnect yes ipv4.method disabled ipv6.method ignore bridge.stp no bridge.forward-delay 0 con-name "br1.100" ifname "br1.100"
nmcli connection modify "bond1.100" connection.slave-type bridge connection.master "br1.100"

# nmcli-cli-ipv4 -n br1.100 static 192.168.1.101/24 192.168.1.1 "192.168.1.1,10.0.0.2"
# nmcli-cli-ipv4 -n br1.100 static 192.168.1.101/24 192.168.1.1 192.168.1.1,10.0.0.2
# echo only.
nmcli connection modify "br1.100" ipv4.addresses "192.168.1.101/24" ipv4.method manual
nmcli connection modify "br1.100" ipv4.gateway "192.168.1.1"
nmcli connection modify "br1.100" ipv4.dns "192.168.1.1,10.0.0.2"

# nmcli-cli-ipv6 -n br1.100 static 2001:db8:1::101/48 2001:db8:1::1 "2001:db8:1::1,2001:db8:1::2"
# nmcli-cli-ipv6 -n br1.100 static 2001:db8:1::101/48 2001:db8:1::1 2001:db8:1::1,2001:db8:1::2
# echo only.
nmcli connection modify "br1.100" ipv6.addresses "2001:db8:1::101/48" ipv6.method manual
nmcli connection modify "br1.100" ipv6.gateway "2001:db8:1::1"
Expand Down
8 changes: 7 additions & 1 deletion nmcli-cli-ipv4
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -44,10 +44,16 @@ Usage:
-n No interface check (Default: check interface)
-x Run command (Default: echo only)

Note:
static replaces all IPv4 addresses.
Use comma-separated IP_SUBNET values to set secondary IP addresses.
The first IP_SUBNET is the primary IP address.

Examples:
$0 eno1 dhcp
$0 eno1 static 192.168.1.101/24 192.168.1.1 "192.168.1.1,10.0.0.2"
$0 eno1 static 192.168.1.101/24 192.168.1.1 192.168.1.1,10.0.0.2
$0 eno1 static 192.168.1.101/24
$0 eno1 static 192.168.1.101/24,10.0.0.201/23
$0 eno1 disable

_EOF_
Expand Down
6 changes: 4 additions & 2 deletions nmcli-cli-ipv4-copy
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -35,9 +35,10 @@ echo_or_execute() {
}

nmcli_value() {
# Convert only nmcli's unset marker to an empty string.
# Convert nmcli's unset marker and multi-line values for reuse.
local value=${1:-}
[[ "${value}" == "--" ]] && value=""
value=${value//$'\n'/,}
printf '%s' "${value}"
}

Expand All @@ -54,6 +55,7 @@ Usage:
Examples:
$0 eno1 bond1
$0 bond1 br1
$0 eno1 bond1 (copy primary and secondary addresses)
$0 eno1 (show current configuration)

_EOF_
Expand Down Expand Up @@ -84,7 +86,7 @@ ipv4_copy() {
local SRC_IF_NAME=${1:-}
local DEST_IF_NAME=${2:-${SRC_IF_NAME}}

# IP + Method
# IP + Method. ipv4.addresses may contain primary and secondary addresses.
SRC_IP_SUBNET=$(nmcli_value "$(nmcli -g ipv4.addresses connection show "${SRC_IF_NAME}")")
SRC_METHOD=$(nmcli_value "$(nmcli -g ipv4.method connection show "${SRC_IF_NAME}")")
echo_or_execute nmcli connection modify "${DEST_IF_NAME}" ipv4.addresses "${SRC_IP_SUBNET}" ipv4.method "${SRC_METHOD}"
Expand Down
8 changes: 7 additions & 1 deletion nmcli-cli-ipv6
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -44,11 +44,17 @@ Usage:
-n No interface check (Default: check interface)
-x Run command (Default: echo only)

Note:
static replaces all IPv6 addresses.
Use comma-separated IP_SUBNET values to set secondary IP addresses.
The first IP_SUBNET is the primary IP address.

Examples:
$0 eno1 auto
$0 eno1 dhcp
$0 eno1 static 2001:db8:1::101/48 2001:db8:1::1 "2001:db8:1::1,2001:db8:1::2"
$0 eno1 static 2001:db8:1::101/48 2001:db8:1::1 2001:db8:1::1,2001:db8:1::2
$0 eno1 static 2001:db8:1::101/48
$0 eno1 static 2001:db8:1::101/48,2001:db8:2::201/64
$0 eno1 link-local
$0 eno1 disable

Expand Down
6 changes: 4 additions & 2 deletions nmcli-cli-ipv6-copy
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -35,9 +35,10 @@ echo_or_execute() {
}

nmcli_value() {
# Convert only nmcli's unset marker to an empty string.
# Convert nmcli's unset marker and multi-line values for reuse.
local value=${1:-}
[[ "${value}" == "--" ]] && value=""
value=${value//$'\n'/,}
printf '%s' "${value}"
}

Expand All @@ -54,6 +55,7 @@ Usage:
Examples:
$0 eno1 bond1
$0 bond1 br1
$0 eno1 bond1 (copy primary and secondary addresses)
$0 eno1 (show current configuration)

_EOF_
Expand Down Expand Up @@ -84,7 +86,7 @@ ipv6_copy() {
local SRC_IF_NAME=${1:-}
local DEST_IF_NAME=${2:-${SRC_IF_NAME}}

# IP
# IP. ipv6.addresses may contain primary and secondary addresses.
SRC_IP_SUBNET=$(nmcli_value "$(nmcli -g ipv6.addresses connection show "${SRC_IF_NAME}")")
SRC_METHOD=$(nmcli_value "$(nmcli -g ipv6.method connection show "${SRC_IF_NAME}")")
echo_or_execute nmcli connection modify "${DEST_IF_NAME}" ipv6.addresses "${SRC_IP_SUBNET}" ipv6.method "${SRC_METHOD}"
Expand Down