{
    "mode": "man",
    "parameter": "ifenslave",
    "section": "8",
    "url": "https://www.chedong.com/phpMan.php/man/ifenslave/8/json",
    "generated": "2026-06-14T06:08:50Z",
    "synopsis": "ifenslave [-acdfhuvV] [--all-interfaces] [--change-active] [--detach] [--force] [--help]\n[--usage] [--verbose] [--version] master slave ...",
    "sections": {
        "NAME": {
            "content": "ifenslave — Attach and detach slave network devices to a bonding device.\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "ifenslave [-acdfhuvV] [--all-interfaces] [--change-active] [--detach] [--force] [--help]\n[--usage] [--verbose] [--version] master slave ...\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "ifenslave is a tool to attach and detach slave network devices to a bonding device.  A bonding\ndevice will act like a normal Ethernet network device to the kernel, but will send out the\npackets via the slave devices using a simple round-robin scheduler.  This allows for simple\nload-balancing, identical to \"channel bonding\" or \"trunking\" techniques used in switches.\n\nThe kernel must have support for bonding devices for ifenslave to be useful.\n",
            "subsections": []
        },
        "OPTIONS": {
            "content": "",
            "subsections": [
                {
                    "name": "-a, --all-interfaces",
                    "content": "Show information about all interfaces.\n",
                    "flag": "-a",
                    "long": "--all-interfaces"
                },
                {
                    "name": "-c, --change-active",
                    "content": "Change active slave.\n",
                    "flag": "-c",
                    "long": "--change-active"
                },
                {
                    "name": "-d, --detach",
                    "content": "Removes slave interfaces from the bonding device.\n",
                    "flag": "-d",
                    "long": "--detach"
                },
                {
                    "name": "-f, --force",
                    "content": "Force actions to be taken if one of the specified interfaces appears not to belong to\nan Ethernet device.\n",
                    "flag": "-f",
                    "long": "--force"
                },
                {
                    "name": "-h, --help",
                    "content": "Display a help message and exit.\n",
                    "flag": "-h",
                    "long": "--help"
                },
                {
                    "name": "-u, --usage",
                    "content": "Show usage information and exit.\n",
                    "flag": "-u",
                    "long": "--usage"
                },
                {
                    "name": "-v, --verbose",
                    "content": "Print warning and debug messages.\n",
                    "flag": "-v",
                    "long": "--verbose"
                },
                {
                    "name": "-V, --version",
                    "content": "Show version information and exit.\n\nIf no options are given, the default action will be to enslave interfaces.\n",
                    "flag": "-V",
                    "long": "--version"
                }
            ]
        },
        "EXAMPLE": {
            "content": "The following example shows how to setup a bonding device and enslave two real Ethernet devices\nto it:\n\n# modprobe bonding\n# ifconfig bond0 192.168.0.1 netmask 255.255.0.0\n# ifenslave bond0 eth0 eth1\n",
            "subsections": []
        },
        "AUTHOR": {
            "content": "Guus Sliepen <guus@debian.org>\n",
            "subsections": []
        },
        "Debian GNU/Linux                 June 14, 2026                Debian GNU/Linux": {
            "content": "",
            "subsections": []
        }
    },
    "summary": "ifenslave — Attach and detach slave network devices to a bonding device.",
    "flags": [
        {
            "flag": "-a",
            "long": "--all-interfaces",
            "arg": null,
            "description": "Show information about all interfaces."
        },
        {
            "flag": "-c",
            "long": "--change-active",
            "arg": null,
            "description": "Change active slave."
        },
        {
            "flag": "-d",
            "long": "--detach",
            "arg": null,
            "description": "Removes slave interfaces from the bonding device."
        },
        {
            "flag": "-f",
            "long": "--force",
            "arg": null,
            "description": "Force actions to be taken if one of the specified interfaces appears not to belong to an Ethernet device."
        },
        {
            "flag": "-h",
            "long": "--help",
            "arg": null,
            "description": "Display a help message and exit."
        },
        {
            "flag": "-u",
            "long": "--usage",
            "arg": null,
            "description": "Show usage information and exit."
        },
        {
            "flag": "-v",
            "long": "--verbose",
            "arg": null,
            "description": "Print warning and debug messages."
        },
        {
            "flag": "-V",
            "long": "--version",
            "arg": null,
            "description": "Show version information and exit. If no options are given, the default action will be to enslave interfaces."
        }
    ],
    "examples": [
        "The following example shows how to setup a bonding device and enslave two real Ethernet devices",
        "to it:",
        "# modprobe bonding",
        "# ifconfig bond0 192.168.0.1 netmask 255.255.0.0",
        "# ifenslave bond0 eth0 eth1"
    ],
    "see_also": []
}