carapace-sh/carapace-bin / skills/iproute2
iproute2
VerifiedUse when working with the Linux iproute2 networking commands — ip, ss, bridge, tc, and related tools. Covers the ip command argument structure, object types (address, link, route, rule, neighbour, tunnel, xfrm, netns, mptcp, ioam, l2tp, etc.), subcommands, selectors, and value types. Triggers on: "iproute2", "ip command", "ip address", "ip link", "ip route", "ip rule", "ip neighbour", "ip neigh", "ip tunnel", "ip xfrm", "ip netns", "ip mptcp", "ip ioam", "ip l2tp", "ip vrf", "ip token", "ip ntable", "ip tcp_metrics", "ip maddress", "ip mroute", "ip mrule", "ip addrlabel", "ip tuntap", "ip monitor", "ip stats", "ip nexthop", "ip netconf", "ip fou", "ip macsec", "ip sr", "ss command", "bridge command", "tc command", "IFADDR", "CONFFLAG", "SELECTOR", "ROUTE", "NUD state", "addrlabel", "ipproto".
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.7 KB |
| references/address.md | markdown | 3.7 KB |
| references/link.md | markdown | 4.6 KB |
| references/misc.md | markdown | 10.1 KB |
| references/neighbour.md | markdown | 2.3 KB |
| references/netns.md | markdown | 1.4 KB |
| references/overview.md | markdown | 4.7 KB |
| references/route.md | markdown | 5.4 KB |
| references/rule.md | markdown | 4.3 KB |
| references/tunnel.md | markdown | 2.8 KB |
| references/xfrm.md | markdown | 2.7 KB |
references/overview.md
View on GitHub# ip Command Overview
The top-level structure, global options, and object types of the `ip` command from iproute2.
## Top-Level Syntax
```
ip [ OPTIONS ] OBJECT { COMMAND | help }
ip [ -force ] -batch filename
```
When no COMMAND is given, the default is usually `list` (or `show`), or `help` if listing is not applicable.
## Global Options
| Short | Long / Variant | Value | Description |
|-------|----------------|-------|-------------|
| `-V` | `-Version` | — | Print version and exit |
| `-h` | `-human`, `-human-readable` | — | Human-readable stats with suffixes |
| `-b` | `-batch` | `<FILENAME>` | Read commands from file or stdin |
| — | `-force` | — | Don't terminate on batch errors |
| `-s` | `-stats`, `-statistics` | — | More info (repeatable) |
| `-d` | `-details` | — | More detailed info |
| `-l` | `-loops` | `<COUNT>` | Max flush loops (default 10, 0 = infinite) |
| `-f` | `-family` | `inet`/`inet6`/`bridge`/`mpls`/`link` | Protocol family |
| `-4` | — | — | Shortcut for `-family inet` |
| `-6` | — | — | Shortcut for `-family inet6` |
| `-B` | — | — | Shortcut for `-family bridge` |
| `-M` | — | — | Shortcut for `-family mpls` |
| `-0` | — | — | Shortcut for `-family link` |
| `-o` | `-oneline` | — | One record per line, LF → `\` |
| `-r` | `-resolve` | — | Use DNS to resolve hostnames |
| `-n` | `-netns` | `<NETNS>` | Switch to network namespace |
| `-N` | `-Numeric` | — | Print numeric values, no name conversion |
| `-a` | `-all` | — | Execute over all objects |
| `-c` | `-color` | `always`/`auto`/`never` | Color output (optional value) |
| `-t` | `-timestamp` | — | Timestamp with monitor |
| `-ts` | `-tshort` | — | Short timestamp with monitor |
| `-rc` | `-rcvbuf` | `<SIZE>` | Netlink socket receive buffer size (default 1MB) |
| — | `-iec` | — | Print rates in IEC units (1Ki = 1024) |
| `-br` | `-brief` | — | Tabular basic output |
| `-j` | `-json` | — | JSON output |
| `-p` | `-pretty` | — | Pretty-printed JSON |
| — | `-echo` | — | Request kernel to echo back applied config |
### Option Aliases
| Canonical | Aliases |
|-----------|---------|
| `-human-readable` | `-h`, `-human` |
| `-statistics` | `-s`, `-stats` |
| `-family` | `-f` |
| `-oneline` | `-o` |
| `-resolve` | `-r` |
| `-netns` | `-n` |
| `-Numeric` | `-N` |
| `-all` | `-a` |
| `-color` | `-c` |
| `-timestamp` | `-t` |
| `-tshort` | `-ts` |
| `-rcvbuf` | `-rc` |
| `-brief` | `-br` |
| `-json` | `-j` |
| `-pretty` | `-p` |
| `-details` | `-d` |
| `-loops` | `-l` |
| `-batch` | `-b` |
### Mutually Exclusive Groups
- `-human-readable` / `-human` — same option
- `-statistics` / `-stats` — same option
## Object Types
| Object | Aliases | Description |
|--------|---------|-------------|
| `address` | `addr`, `a` | Protocol (IP/IPv6) address on a device |
| `addrlabel` | — | Label configuration for protocol address selection |
| `fou` | — | Foo-over-UDP receive port configuration |
| `ila` | — | Identifier locator addresses |
| `ioam` | — | IOAM namespaces and schemas |
| `l2tp` | — | Tunnel ethernet over IP (L2TPv3) |
| `link` | `l` | Network device |
| `macsec` | — | MACsec device configuration |
| `maddress` | `maddr` | Multicast address |
| `monitor` | — | Watch for netlink messages |
| `mptcp` | — | Manage MPTCP path manager |
| `mroute` | — | Multicast routing cache entry |
| `mrule` | — | Rule in multicast routing policy database |
| `neighbour` | `neigh`, `n`, `neighbor` | ARP or NDISC cache entries |
| `netconf` | — | Network configuration monitoring |
| `netns` | — | Manage network namespaces |
| `nexthop` | — | Manage nexthop objects |
| `ntable` | `ntbl` | Manage the neighbor cache's operation |
| `route` | `r`, `ro` | Routing table entry |
| `rule` | — | Rule in routing policy database |
| `sr` | — | IPv6 segment routing |
| `stats` | — | Manage and show interface statistics |
| `tcp_metrics` | `tcpmetrics` | Manage TCP Metrics |
| `token` | — | Manage tokenized interface identifiers |
| `tunnel` | `tunl` | Tunnel over IP |
| `tuntap` | — | Manage TUN/TAP devices |
| `vrf` | — | Manage virtual routing and forwarding devices |
| `xfrm` | — | Manage IPSec policies |
## Default Commands
When no COMMAND is specified, the default behavior depends on the object:
| Object | Default Command |
|--------|----------------|
| `address` | `show` |
| `addrlabel` | `list` |
| `link` | `show` |
| `maddress` | `show` |
| `mroute` | `show` |
| `neighbour` | `show` |
| `netconf` | `show` |
| `nexthop` | `show` |
| `ntable` | `show` |
| `route` | `show` |
| `rule` | `show` |
| `tcp_metrics` | `show` |
| `token` | `list` |
| `tunnel` | `show` |
| `tuntap` | `show` |
| `vrf` | `show` |
## References
- [ip(8) man page](https://man7.org/linux/man-pages/man8/ip.8.html)
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |