ip - просмотр / управление маршрутизацией, сетевыми устройствами, интерфейсами и туннелями
СИНТАКСИС
ip [ ОПЦИИ ] ОБЪЕКТ { КОМАНДА | help }
ip [ -force ] -batch имя_файла
ОБЪЕКТ := { address | addrlabel | fou | help | ila | ioam | l2tp | link | macsec | maddress |
monitor | mptcp | mroute | mrule | neighbor | neighbour | netconf | netns | nexthop |
ntable | ntbl | route | rule | sr | tap | tcpmetrics | token | tunnel | tuntap | vrf |
xfrm }
ОПЦИИ := { -V[ersion] | -h[uman-readable] | -s[tatistics] | -d[etails] | -r[esolve] | -iec |
-f[amily] { inet | inet6 | link } | -4 | -6 | -B | -0 | -l[oops] { maximum-addr-flush-attempts } | -o[neline] | -rc[vbuf] [size] | -t[imestamp] | -ts[hort] | -n[etns] name |
-N[umeric] | -a[ll] | -c[olor] | -br[ief] | -j[son] | -p[retty] }
ОПЦИИ
-V, -Version
Вывести версию утилиты ip и завершить работу.
-h, -human, -human-readable
выводить статистику в удобочитаемом формате с добавлением суффикса.
-b, -batch <ИМЯ_ФАЙЛА>
Считывать команды из указанного файла или стандартного ввода и выполнять их. Первая ошибка приведет к завершению работы ip.
-force Не завершать работу ip при ошибках в пакетном режиме. Если во время выполнения команд произошли какие-либо ошибки, код возврата приложения будет ненулевым.
-s, -stats, -statistics
Выводить больше информации. Если опция указана два или более раз, объем информации увеличивается. Как правило, это статистика или временные значения.
-d, -details
Выводить более подробную информацию.
-l, -loops <КОЛИЧЕСТВО>
Указать максимальное количество циклов, которое логика 'ip address flush' будет пытаться выполнить, прежде чем прекратить работу. По умолчанию — 10. Значение 0 означает, что цикл будет продолжаться до тех пор, пока все адреса не будут удалены.
-f, -family <СЕМЬЯ>
Указывает протокол семейства, который следует использовать. Идентификатор протокола семейства может быть одним из inet, inet6, bridge, mpls или link. Если эта опция не указана, протокол семейства определяется по другим аргументам. Если остальной части команды недостаточно информации для определения семейства, ip переходит к семейству по умолчанию, обычно inet или any. link — это специальный идентификатор семейства, означающий, что сетевой протокол не используется.
-4 сокращение для -family inet.
-6 сокращение для -family inet6.
-B сокращение для -family bridge.
-M сокращение для -family mpls.
-0 сокращение для -family link.
-o, -oneline
выводить каждую запись в одну строку, заменяя символы новой строки на '\'. Это удобно, когда вы хотите подсчитать записи с помощью [wc]({filename}../../wc)(1) или выполнить [grep]({filename}../../grep)(1) выходных данных.
-r, -resolve
использовать системный DNS-сервер для вывода DNS-имен вместо IP-адресов.
-n, -netns <СЕТЕВОЕ_ПРОСТРАНСТВО>
переключает ip в указанное сетевое пространство NETNS. На самом деле это просто упрощает выполнение:
ip netns exec NETNS ip [ ОПЦИИ ] ОБЪЕКТ { КОМАНДА | help }
в
ip -n[etns] NETNS [ ОПЦИИ ] ОБЪЕКТ { КОМАНДА | help }
-N, -Numeric
Выводить номер протокола, область, поле DS и т. д. непосредственно, а не преобразовывать его в удобочитаемое имя.
-a, -all
выполняет указанную команду по всем объектам, в зависимости от того, поддерживает ли команда эту опцию.
-c[color][={always|auto|never}]
Настроить цветной вывод. Если параметр не указан или имеет значение always, цветной вывод включен независимо от состояния stdout. Если параметр имеет значение auto, перед включением цветного вывода проверяется, является ли stdout терминалом. Если параметр имеет значение never, цветной вывод отключен. Если указано несколько раз, последнее значение имеет приоритет. Этот флаг игнорируется, если также указан -json.
На используемую цветовую палитру можно влиять с помощью переменной среды COLORFGBG (см. СРЕДА).
-t, -timestamp
отображать текущее время при использовании опции monitor.
-ts, -tshort
Как и -timestamp, но использовать более короткий формат.
-rc, -rcvbuf<РАЗМЕР>
Задать размер буфера приема сокета netlink, по умолчанию 1 МБ.
-iec выводить удобочитаемые скорости в единицах IEC (например, 1Ki = 1024).
-br, -brief
Выводить только базовую информацию в табличном формате для повышения читаемости. Эта опция в настоящее время поддерживается только командами ip addr show, ip link show и ip neigh show.
-j, -json
Выводить результаты в формате JavaScript Object Notation (JSON).
-p, -pretty
Формат JSON по умолчанию является компактным и более эффективным для разбора, но сложным для большинства пользователей. Этот флаг добавляет отступы для удобства чтения.
-echo Запросить у ядра отправку примененной конфигурации обратно.
IP - СИНТАКСИС КОМАНД
ОБЪЕКТ
address
- IP-адрес или IPv6-адрес на устройстве.
addrlabel
- конфигурация метки для выбора протокола адреса.
fou
- конфигурация порта приема Foo-over-UDP.
ila
- управление идентификаторными локаторными адресами (ILA).
ioam
- управление пространствами имен IOAM и схемами IOAM.
l2tp
- туннелирование Ethernet через IP (L2TPv3).
link
- сетевое устройство.
macsec
- конфигурация устройства MACsec.
maddress
- многоадресный адрес.
monitor
- отслеживание сообщений Netlink.
mptcp
- управление менеджером путей MPTCP.
mroute
- запись кэша маршрутизации многоадресной передачи.
mrule
- правило в базе данных политик маршрутизации многоадресной передачи.
neighbour
- управление записями кэша ARP или NDISC.
netconf
- мониторинг сетевой конфигурации.
netns
- управление сетевыми пространствами имен.
nexthop
- управление объектами nexthop.
ntable
- управление работой кэша соседних узлов.
route
- запись в таблице маршрутизации.
rule
- правило в базе данных политик маршрутизации.
sr
- управление сегментной маршрутизацией IPv6.
stats
- управление и отображение статистики интерфейса.
tcp_metrics/tcpmetrics
- управление метриками TCP.
token
- управление токенизированными идентификаторами интерфейса.
tunnel
- туннелирование через IP.
tuntap
- управление устройствами TUN/TAP.
vrf
- управление устройствами виртуальной маршрутизации и пересылки.
xfrm
- управление политиками IPSec.
Имена всех объектов можно записывать в полной или сокращенной форме, например, address можно сократить до addr или просто a.
КОМАНДА
Указывает действие, которое необходимо выполнить над объектом. Набор возможных действий зависит от типа объекта. Как правило, можно добавлять, удалять и отображать (или перечислять) объекты, но для некоторых объектов не все эти операции разрешены или у них есть дополнительные команды. Команда help доступна для всех объектов. Она выводит список доступных команд и соглашений о синтаксисе аргументов.
Если команда не указана, предполагается команда по умолчанию. Обычно это list или, если объекты этого класса нельзя перечислить, help.
ОКРУЖАЮЩАЯ СРЕДА
COLORFGBG
Если установлено, его значение используется для определения, темный или светлый фон, и для выбора контрастных цветов.
Переменная среды COLORFGBG обычно содержит два или три значения, разделенных точками с запятой; нам нужно последнее значение в любом случае. Если это значение равно 0–6 или 8, выберите цвета, подходящие для темного фона:
COLORFGBG=";0" ip -c a
СТАТУС ВЫХОДА
Статус выхода равен 0, если команда выполнена успешно, и 1, если произошла синтаксическая ошибка. Если ядро сообщило об ошибке, статус выхода равен 2.
ПРИМЕРЫ
ip addr
Показывает адреса, назначенные всем сетевым интерфейсам.
ip neigh
Показывает текущую таблицу соседей в ядре.
ip link set x up
Активирует интерфейс x.
ip link set x down
Деактивирует интерфейс x.
ip route
Показывает таблицу маршрутов.
ИСТОРИЯ
ip был написан Алексеем Н. Кузнецовым и добавлен в Linux 2.2.
ССЫЛКИ
ip-address(8), ip-addrlabel(8), ip-fou(8), ip-ioam(8), ip-l2tp(8), ip-link(8), ip-macsec(8), ipmaddress(8), ip-monitor(8), ip-mptcp(8), ip-mroute(8), ip-neighbour(8), ip-netconf(8), ipnetns(8), ip-nexthop(8), ip-ntable(8), ip-route(8), ip-rule(8), ip-sr(8), ip-stats(8), iptcp_metrics(8), ip-token(8), ip-tunnel(8), ip-vrf(8), ip-xfrm(8) Справочник по команде IP ip-cref.ps
СООБЩЕНИЕ ОБ ОШИБКАХ
Сообщайте обо всех ошибках в списке рассылки Network Developers <_>, где в основном ведется разработка и поддержка. Вам не обязательно быть подписанным на список, чтобы отправить сообщение.
АВТОР
Оригинальная страница руководства, написанная Михаилом Литваком <_>.