ip - mostrar / manipular el enrutamiento, dispositivos de red, interfaces y túneles
SINOPSIS
ip [ OPCIONES ] OBJETO { COMANDO | ayuda }
ip [ -force ] -batch nombrearchivo
OBJETO := { 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 }
OPCIONES := { -V[ersion] | -h[uman-readable] | -s[tatistics] | -d[etails] | -r[esolve] | -iec |
-f[family] { 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] }
OPCIONES
-V, -Version
Imprime la versión de la utilidad ip y sale.
-h, -human, -human-readable
muestra las estadísticas con valores legibles para humanos seguidos de un sufijo.
-b, -batch <NOMBREARCHIVO>
Lee los comandos del archivo proporcionado o de la entrada estándar e invócalos. El primer error provocará la terminación de ip.
-force No termina ip en caso de errores en modo por lotes. Si hubo algún error durante la ejecución de los comandos, el código de retorno de la aplicación será distinto de cero.
-s, -stats, -statistics
Muestra más información. Si la opción aparece dos o más veces, la cantidad de información aumenta. Por lo general, la información son estadísticas o algunos valores de tiempo.
-d, -details
Muestra información más detallada.
-l, -loops <CONTADOR>
Especifica el número máximo de iteraciones que la lógica de "ip address flush" intentará antes de rendirse. El valor predeterminado es 10. Cero (0) significa iterar hasta que se eliminen todas las direcciones.
-f, -family <FAMILIA>
Especifica la familia de protocolos que se utilizará. El identificador de la familia de protocolos puede ser uno de inet, inet6, bridge, mpls o link. Si no se especifica esta opción, la familia de protocolos se deduce de otros argumentos. Si el resto de la línea de comandos no proporciona suficiente información para deducir la familia, ip recurre a la predeterminada, que suele ser inet o any. link es un identificador de familia especial que significa que no hay ningún protocolo de red involucrado.
-4 atajo para -family inet.
-6 atajo para -family inet6.
-B atajo para -family bridge.
-M atajo para -family mpls.
-0 atajo para -family link.
-o, -oneline
muestra cada registro en una sola línea, reemplazando los saltos de línea con el carácter '\'. Esto es conveniente si desea contar los registros con [wc]({filename}../../wc)(1) o para [grep]({filename}../../grep)(1) la salida.
-r, -resolve
utiliza el resolvedor de nombres del sistema para imprimir los nombres DNS en lugar de las direcciones de host.
-n, -netns <NETNS>
cambia ip al espacio de nombres de red especificado NETNS. En realidad, solo simplifica la ejecución de:
ip netns exec NETNS ip [ OPCIONES ] OBJETO { COMANDO | ayuda }
a
ip -n[etns] NETNS [ OPCIONES ] OBJETO { COMANDO | ayuda }
-N, -Numeric
Muestra el número del protocolo, el ámbito, el campo DS, etc., directamente en lugar de convertirlo a un nombre legible para humanos.
-a, -all
ejecuta el comando especificado en todos los objetos, dependiendo de si el comando admite esta opción.
-c[color][={always|auto|never}
Configura la salida en color. Si no se especifica el parámetro o es always, la salida en color se habilita independientemente del estado de stdout. Si el parámetro es auto, se comprueba stdout para asegurarse de que es una terminal antes de habilitar la salida en color. Si el parámetro es never, la salida en color se deshabilita. Si se especifica varias veces, la última opción tiene prioridad. Esta opción se ignora si también se especifica -json.
La paleta de colores utilizada puede verse influenciada por la variable de entorno COLORFGBG (consulte ENTORNO).
-t, -timestamp
muestra la hora actual cuando se utiliza la opción monitor.
-ts, -tshort
similar a -timestamp, pero utiliza un formato más corto.
-rc, -rcvbuf<TAM>
Establece el tamaño del búfer de recepción del socket netlink, el valor predeterminado es 1 MB.
-iec imprime las velocidades legibles para humanos en unidades IEC (por ejemplo, 1Ki = 1024).
-br, -brief
Muestra solo información básica en formato tabular para mejorar la legibilidad. Esta opción solo es compatible con los comandos ip addr show, ip link show e ip neigh show.
-j, -json
Muestra los resultados en formato de notación de objetos de JavaScript (JSON).
-p, -pretty
El formato JSON predeterminado es compacto y más eficiente para el análisis, pero es difícil de leer para la mayoría de los usuarios. Esta opción agrega sangría para facilitar la lectura.
-echo Solicita al kernel que envíe la configuración aplicada.
IP - SINTAXIS DE COMANDOS
OBJETO
address
- dirección de protocolo (IP o IPv6) en un dispositivo.
addrlabel
- configuración de etiqueta para la selección de la dirección de protocolo.
fou - configuración del puerto de recepción Foo-over-UDP.
ila - gestionar direcciones de identificador y ubicación (ILA).
ioam - gestionar espacios de nombres IOAM y esquemas IOAM.
l2tp - tunelización de Ethernet sobre IP (L2TPv3).
link - dispositivo de red.
macsec - configuración del dispositivo MACsec.
maddress
- dirección multicast.
monitor
- vigilar los mensajes de netlink.
mptcp - gestionar el administrador de rutas MPTCP.
mroute - entrada de caché de enrutamiento multicast.
mrule - regla en la base de datos de políticas de enrutamiento multicast.
neighbour
- gestionar las entradas de la caché ARP o NDISC.
netconf
- monitorización de la configuración de la red.
netns - gestionar los espacios de nombres de red.
nexthop
- gestionar objetos nexthop.
ntable - gestionar el funcionamiento de la caché de vecinos.
route - entrada de la tabla de enrutamiento.
rule - regla en la base de datos de políticas de enrutamiento.
sr - gestionar el enrutamiento de segmentos IPv6.
stats - gestionar y mostrar estadísticas de la interfaz.
tcp_metrics/tcpmetrics
- gestionar las métricas TCP.
token - gestionar los identificadores de interfaz tokenizados.
tunnel - tunelización sobre IP.
tuntap - gestionar los dispositivos TUN/TAP.
vrf - gestionar los dispositivos de enrutamiento y reenvío virtual.
xfrm - gestionar las políticas IPSec.
Los nombres de todos los objetos se pueden escribir en forma completa o abreviada, por ejemplo, address se puede abreviar como addr o simplemente a.
COMANDO
Especifica la acción que se va a realizar en el objeto. El conjunto de acciones posibles depende del tipo de objeto. Por lo general, es posible añadir, eliminar y mostrar (o listar) objetos, pero algunos objetos no permiten todas estas operaciones o tienen algunos comandos adicionales. El comando de ayuda está disponible para todos los objetos. Imprime una lista de comandos disponibles y convenciones de sintaxis de argumentos.
Si no se proporciona ningún comando, se asume un comando predeterminado. Por lo general, es listar o, si los objetos de esta clase no se pueden listar, ayuda.
ENTORNO
COLORFGBG
Si está configurado, su valor se utiliza para detectar si el fondo es oscuro o claro y utilizar colores de contraste para ello.
La variable de entorno COLORFGBG suele contener dos o tres valores separados por
puntos y comas; queremos el último valor en ambos casos. Si este valor es 0-6 u 8, elija colores adecuados para un fondo oscuro:
COLORFGBG=";0" ip -c a
ESTADO DE SALIDA
El estado de salida es 0 si el comando se ejecutó correctamente y 1 si hay un error de sintaxis. Si el kernel informa de un error, el estado de salida es 2.
EJEMPLOS
ip addr
Muestra las direcciones asignadas a todas las interfaces de red.
ip neigh
Muestra la tabla de vecinos actual en el kernel.
ip link set x up
Activa la interfaz x.
ip link set x down
Desactiva la interfaz x.
ip route
Muestra las rutas de la tabla.
HISTORIA
ip fue escrito por Alexey N. Kuznetsov y se agregó en Linux 2.2.
VER TAMBIÉN
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) Referencia de comandos IP ip-cref.ps
INFORMES DE ERRORES
Informe cualquier error a la lista de correo de desarrolladores de red <_> donde se realiza principalmente el desarrollo y el mantenimiento. No es necesario que esté suscrito a la lista para enviar un mensaje allí.
AUTOR
Manpage original de Michail Litvak <_>