nmcli-cli-bond-add

#!/bin/bash
#
# nmcli-cli-bond-add
#
# Copyright (c) 2019-2026 Jun Futagawa (jfut)
#
# This software is released under the MIT License.
# http://opensource.org/licenses/mit-license.php

VERSION="1.2.1"
ECHO_OR_EXECUTE="echo"

print_command() {
    # Print the nmcli command in a reusable shell-quoted form.
    printf '%q' "$1"
    shift
    printf ' %q' "$@"
    printf '\n'
}

echo_or_execute() {
    local RET

    if [[ -z "${ECHO_OR_EXECUTE}" ]]; then
        printf 'Applying: '
        print_command "$@"
        "$@"
        RET=$?
        if [[ ${RET} -ne 0 ]]; then
            echo "Error: command failed (${RET})." >&2
            exit "${RET}"
        fi
    else
        print_command "$@"
    fi
}

usage() {
    local COMMAND_NAME
    COMMAND_NAME="$(basename "${0}")"

    cat << _EOF_
${COMMAND_NAME} ${VERSION}

Usage:

    ${COMMAND_NAME} [-n] [-x] NEW_BOND_IF_NAME BOND_OPTIONS IF_SLAVE1 IF_SLAVE2 [IF_SLAVE3...]

    Options:
        -n No interface check (Default: check interface)
        -x Run command (Default: echo only)

    Examples:
        ${COMMAND_NAME} bond1 mode=active-backup eno1 ens2f0
        ${COMMAND_NAME} bond1 mode=802.3ad,miimon=100,updelay=500,xmit_hash_policy=layer2+3 eno1 eno3 ens2f0
_EOF_
}

check() {
    local BOND_IF_NAME=${1:-}

    # Check new bond interface
    nmcli connection show "${BOND_IF_NAME}" > /dev/null 2>&1
    RET=$?
    if [[ ${RET} -eq 0 ]]; then
        echo "Error: Target bond interface \"${BOND_IF_NAME}\" already exists."
        exit 1
    fi

    # Check slave interfaces
    shift 2
    for IF_SLAVE in "${@}"; do
        nmcli connection show "${IF_SLAVE}" > /dev/null 2>&1
        RET=$?
        if [[ ${RET} -ne 0 ]]; then
            echo "Error: Slave interface \"${IF_SLAVE}\" not found."
            exit 1
        fi
    done
}

bond_add() {
    local BOND_IF_NAME=${1:-}
    local BOND_OPTIONS=${2:-}

    # Bonding
    echo_or_execute nmcli connection add type bond \
        bond.options "${BOND_OPTIONS}" \
        autoconnect yes ipv4.method disabled ipv6.method ignore \
        con-name "${BOND_IF_NAME}" ifname "${BOND_IF_NAME}"

    # Add slave interfaces
    shift 2
    for IF_SLAVE in "${@}"; do
        echo_or_execute nmcli connection modify "${IF_SLAVE}" connection.autoconnect no
        echo_or_execute nmcli connection add type bond-slave autoconnect yes ifname "${IF_SLAVE}" master "${BOND_IF_NAME}"
    done

    cat << _EOF_

# Next steps:
# -> Check bond status
#    cat /proc/net/bonding/${BOND_IF_NAME}
#
# -> Set IP address
#    nmcli-cli-ipv4 "${BOND_IF_NAME}" ...
#    nmcli-cli-ipv6 "${BOND_IF_NAME}" ...
#
# -> Create a vlan interface:
#    nmcli-cli-vlan-add "${BOND_IF_NAME}.100" 100 "${BOND_IF_NAME}"
# -> Create a bridge interface:
#    nmcli-cli-bridge-add br1 "${BOND_IF_NAME}"
_EOF_
}

# Main
main() {
    local NO_CHECK="no"
    while getopts nxh OPT; do
        case "${OPT}" in
            "n" )
                NO_CHECK="yes" ;;
            "x" )
                ECHO_OR_EXECUTE="" ;;
            "h" )
                usage
                exit 0
                ;;
            * )
                usage
                exit 1
                ;;
        esac
    done
    shift $((OPTIND - 1))

    [[ $# -lt 4 ]] && usage && exit 1

    if [[ "${NO_CHECK}" = "no" ]]; then
        check "${@}"
    fi

    if [[ "${ECHO_OR_EXECUTE}" = "echo" ]]; then
        echo "# ${ECHO_OR_EXECUTE} only."
    fi

    bond_add "${@}"
}

[[ "${BASH_SOURCE[0]}" == "$0" ]] && main "$@"