Man page - ip(8)

Packages contains this manual

Package:  iproute2
apt-get install iproute2

Manuals in package:
• rdma-monitor(8)
• devlink-rate(8)
• dcb-app(8)
• tc-prio(8)
• ip-netconf(8)
• tc-tunnel_key(8)
• tc-ets(8)
• arpd(8)
• tc-mqprio(8)
• ip-mptcp(8)
• ss(8)
• tc(8)
• vdpa(8)
• ip-tcp_metrics(8)
• rdma(8)
• devlink-region(8)
• ip(8)
• bridge(8)
• ip-link(8)
• tc-drr(8)
• genl(8)
• ip-addrlabel(8)
• ip-rule(8)
• dcb-pfc(8)
• ip-stats(8)
• tc-choke(8)
• tc-skbprio(8)
• tc-simple(8)
• tc-stab(8)
• routel(8)
• rtmon(8)
• tc-actions(8)
• ip-l2tp(8)
• tc-cgroup(8)
• tc-basic(8)
• ip-address(8)
• devlink-resource(8)
• tc-flower(8)
• rdma-link(8)
• dcb-apptrust(8)
• devlink-port(8)
• tc-route(8)
• rtstat(8)
• ip-sr(8)
• tc-red(8)
• dcb-ets(8)
• devlink-health(8)
• lnstat(8)
• tc-flow(8)
• tc-tbf(8)
• vdpa-mgmtdev(8)
• tipc-link(8)
• tc-skbedit(8)
• tipc-media(8)
• dcb-maxrate(8)
• tc-mpls(8)
• devlink(8)
• tc-sfb(8)
• ip-maddress(8)
• tc-fq(8)
• tc-pfifo(8)
• rtacct(8)
• tipc(8)
• tc-hfsc(7)
• tc-taprio(8)
• tc-nat(8)
• tc-connmark(8)
• ip-token(8)
• ip-tunnel(8)
• tipc-node(8)
• ip-nexthop(8)
• rdma-resource(8)
• ip-gue(8)
• tc-sfq(8)
• tc-htb(8)
• tc-skbmod(8)
• dcb-buffer(8)
• tipc-bearer(8)
• dcb-rewr(8)
• tc-ematch(8)
• tc-pedit(8)
• tc-police(8)
• ip-mroute(8)
• devlink-sb(8)
• dcb-dcbx(8)
• tipc-nametable(8)
• tc-fq_codel(8)
• devlink-dpipe(8)
• devlink-trap(8)
• rdma-system(8)
• ctstat(8)
• tc-sample(8)
• tc-csum(8)
• libnetlink(3)
• ip-ioam(8)
• ip-neighbour(8)
• tc-netem(8)
• tc-pfifo_fast(8)
• tc-bfifo(8)
• tc-etf(8)
• tc-cake(8)
• devlink-monitor(8)
• tipc-socket(8)
• tc-fq_pie(8)
• tc-pie(8)
• tc-u32(8)
• tc-mirred(8)
• tc-hfsc(8)
• vdpa-dev(8)
• tc-cbs(8)
• tc-codel(8)
• tc-fw(8)
• tc-bpf(8)
• ip-route(8)
• ip-netns(8)
• tc-ctinfo(8)
• ip-fou(8)
• ip-xfrm(8)
• tc-gate(8)
• tc-ct(8)
• tipc-peer(8)
• ip-macsec(8)
• tc-matchall(8)
• nstat(8)
• ip-monitor(8)
• rdma-dev(8)
• tc-gact(8)
• ip-vrf(8)
• ip-ntable(8)
• tc-ife(8)
• tc-vlan(8)
• rdma-statistic(8)
• dcb(8)
• devlink-lc(8)
• devlink-dev(8)
Documentations in package:
• iproute2

Available languages:

en fr ru ro

Manual

IP

НАИМЕНОВАНИЕ
ОБЗОР
ПАРАМЕТРЫ
СИНТАКСИС КОМАНДЫ IP
OBJECT
COMMAND
СРЕДА ОКРУЖЕНИЯ
КОД ЗАВЕРШЕНИЯ
ПРИМЕРЫ
ИСТОРИЯ
СМОТРИТЕ ТАКЖЕ
ИНФОРМАЦИЯ ОБ ОШИБКАХ
АВТОРЫ
ПЕРЕВОД

---

НАИМЕНОВАНИЕ

ip - показывает или управляет маршрутизацией, сетевыми устройствами, интерфейсами и туннелями

ОБЗОР

ip [ OPTIONS ] OBJECT { COMMAND | help }

ip [ -force ] -batch filename

OBJECT := { 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 }

OPTIONS := { -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 <FILENAME>

Считывать команды из предоставленного файла или со стандартного ввода и вызывать их. Первая ошибка приведет к завершению работы ip.

-force

Не завершать работу ip при ошибках в пакетном режиме. Если во время выполнения команд возникли какие-либо ошибки, то код возврата приложения будет ненулевым.

-s , -stats , -statistics

Выводить больше информации. Если параметр появляется два раза и более,то количество информации увеличивается. Как правило, информация представляет собой статистику или некоторые временные значения.

-d , -details

Выводить подробную информацию.

-l , -loops <COUNT>

Определить максимальное количество циклов, которые будет выполнять логика "очистки ip-адресов", прежде чем прекратить работу. Значение по умолчанию равно 10. Ноль (0) означает выполнять циклы до тех пор, пока не будут удалены все адреса.

-f , -family <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 (1) или grep (1) в качестве выходных данных.

-r , -resolve

Использовать для вывода системный преобразователь имен DNS-имен вместо адресов хостов.

-n , -netns <NETNS>

Переключать ip на указанное сетевое пространство имен NETNS . На самом деле это просто упрощает выполнение:

ip netns exec NETNS ip [ OPTIONS ] OBJECT { COMMAND | help }

to

ip -n[etns] NETNS [ OPTIONS ] OBJECT { COMMAND | help }

-N , -Numeric

Выводить номер протокола, область, поле ds и т.д. напрямую, вместо того чтобы преобразовывать его в удобочитаемое имя.

-a , -all

Выполнить указанную команду для всех объектов; это зависит от того, поддерживает ли команда этот параметр.

-c [ color ][ = { always | auto | never }

Настроить вывод цвета. Если параметр не указан или always , то вывод цвета включен независимо от состояния стандартного вывода. Если параметр равен auto , то перед включением вывода цвета проверяется, является ли стандартный вывод терминальным. Если параметр равен never , то вывод цвета отключен. Если параметр указан несколько раз, то приоритет имеет последний параметр. Этот флаг игнорируется, если указан параметр -json .

На используемую цветовую палитру может влиять переменная окружения COLORFGBG (смотрите раздел ПЕРЕМЕННЫЕ ОКРУЖЕНИЯ ).

-t , -timestamp

Отображать текущее времени при использовании параметра "monitor".

-ts , -tshort

Тоже, что и -timestamp , но используется более короткий формат.

-rc , -rcvbuf <SIZE>

Установить размер буфера сокета приема netlink (по умолчанию равен 1 МБ).

-iec

Скорость вывода, считываемая человеком, выражена в единицах IEC (например, 1Ki = 1024).

-br , -brief

Выводить, для удобства чтения, только основную информацию в табличном формате. В настоящее время этот параметр поддерживается только командами ip addr show , ip link show & ip neigh show .

-j , -json

Выводить результаты в виде объектной нотации JavaScript (JSON).

-p , -pretty

Формат JSON по умолчанию компактен и более эффективен для анализа, но сложен для чтения большинством пользователей. Этот флажок добавляет отступы для удобства чтения.

-echo

Запросить ядро отправить обратно примененную конфигурацию.

СИНТАКСИС КОМАНДЫ IP

OBJECT

address

- Адрес протокола (IP или IPv6) на устройстве.

addrlabel

- Настройка метки для выбора адреса протокола.

	fou		- Конфигурация порта приема Foo-over-UDP.
	ila		- Управление адресами локатора идентификаторов (ILA).
	ioam		- Управление пространствами имен IOAM и схемами IOAM.
	l2tp		- Туннель ethernet через IP (L2TPv3).
	link		- Сетевое устройство.
	macsec		- Настройка устройства MACsec.

maddress

- Адрес многоадресной рассылки.

monitor

- Наблюдать за сообщениями сетевых соединений.

	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.

COMMAND

Команда определяет действие, которое необходимо выполнить с объектом. Набор возможных действий зависит от типа объекта. Как правило, для объектов возможны действия add , delete и show (или list ), но некоторые объекты не позволяют выполнять все эти операции или содержат некоторые дополнительные команды. Команда 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 была разработана Алексеем Н. Кузнецовым (Alexey N. Kuznetsov) и добавлена в Linux 2.2.

СМОТРИТЕ ТАКЖЕ

ip-address (8), ip-addrlabel (8), ip-fou (8), ip-ioam (8), ip-l2tp (8), ip-link (8), ip-macsec (8), ip-maddress (8), ip-monitor (8), ip-mptcp (8), ip-mroute (8), ip-neighbour (8), ip-netconf (8), ip-netns (8), ip-nexthop (8), ip-ntable (8), ip-route (8), ip-rule (8), ip-sr (8), ip-stats (8), ip-tcp_metrics (8), ip-token (8), ip-tunnel (8), ip-vrf (8), ip-xfrm (8)
IP - ссылка на команду ip-cref.ps

ИНФОРМАЦИЯ ОБ ОШИБКАХ

Сообщайте о любых ошибках в список рассылки для разработчиков <netdev@vger.kernel.org> , где в первую очередь ведется разработка и техническое обслуживание. Вам не обязательно быть подписанным на этот список, чтобы отправить туда сообщение.

АВТОРЫ

Настоящая страница руководства разработана Михаилом Литваком (Michail Litvak) <mci@owl.openwall.com>

ПЕРЕВОД

Русский перевод этой страницы руководства разработал(и) Aleksandr Felda <isk8da@gmail.com> и Kirill Rekhov <krekhov.dev@gmail.com>

Этот перевод является свободной программной документацией; он распространяется на условиях общедоступной лицензии GNU (GNU General Public License - GPL, https://www.gnu.org/licenses/gpl-3.0.html версии 3 или более поздней) в отношении авторского права, но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ.

Если вы обнаружите какие-либо ошибки в переводе этой страницы руководства, пожалуйста, сообщите об этом разработчику(ам) по его(их) адресу(ам) электронной почты или по адресу списка рассылки русских переводчиков .

---