ip - mostrar / manipular roteamento, dispositivos de rede, interfaces e túneis
SINTAXE
ip [ OPÇÕES ] OBJETO { COMANDO | ajuda }
ip [ -force ] -batch nome_do_arquivo
OBJETO := { address | addrlabel | fou | ajuda | 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 }
OPÇÕES := { -V[ersão] | -h[umano-legível] | -s[tatísticas] | -d[etalhes] | -r[esolver] | -iec |
-f[amília] { inet | inet6 | link } | -4 | -6 | -B | -0 | -l[aços] { máximo-tentativas-limpeza-endereços } | -o[neline] | -rc[vbuf] [tamanho] | -t[imestamp] | -ts[hort] | -n[etns] nome |
-N[umérico] | -a[ll] | -c[olor] | -br[ief] | -j[son] | -p[retty] }
OPÇÕES
-V, -Versão
Imprime a versão do utilitário ip e sai.
-h, -humano, -humano-legível
exibe as estatísticas com valores legíveis para humanos seguidos por um sufixo.
-b, -batch <NOME_DO_ARQUIVO>
Lê comandos do arquivo fornecido ou da entrada padrão e os executa. A primeira falha fará com que o ip seja encerrado.
-force Não encerra o ip em caso de erros no modo de lote. Se houver algum erro durante a execução dos comandos, o código de retorno do aplicativo será diferente de zero.
-s, -estatísticas, -estatísticas
Exibe mais informações. Se a opção aparecer duas ou mais vezes, a quantidade de informações aumenta. Em geral, as informações são estatísticas ou alguns valores de tempo.
-d, -detalhes
Exibe informações mais detalhadas.
-l, -laços <CONTADOR>
Especifica o número máximo de iterações que a lógica de 'ip address flush' tentará antes de desistir. O padrão é 10. Zero (0) significa iterar até que todos os endereços sejam removidos.
-f, -família <FAMÍLIA>
Especifica a família de protocolo a ser usada. O identificador da família de protocolo pode ser um de inet, inet6, bridge, mpls ou link. Se esta opção não estiver presente, a família de protocolo é inferida a partir de outros argumentos. Se o restante da linha de comando não fornecer informações suficientes para inferir a família, o ip recorrerá ao padrão, geralmente inet ou qualquer. link é um identificador de família especial que significa que nenhum protocolo de rede está envolvido.
-4 atalho para -família inet.
-6 atalho para -família inet6.
-B atalho para -família bridge.
-M atalho para -família mpls.
-0 atalho para -família link.
-o, -oneline
exibe cada registro em uma única linha, substituindo quebras de linha pelo caractere '\'. Isso é conveniente quando você deseja contar registros com [wc]({filename}../../wc)(1) ou para [grep]({filename}../../grep)(1) a saída.
-r, -resolve
use o resolvedor de nomes do sistema para exibir nomes DNS em vez de endereços de host.
-n, -netns <NETNS>
alterna para o namespace de rede especificado NETNS. Na verdade, ele simplesmente simplifica a execução de:
ip netns exec NETNS ip [ OPÇÕES ] OBJETO { COMANDO | ajuda }
para
ip -n[etns] NETNS [ OPÇÕES ] OBJETO { COMANDO | ajuda }
-N, -Numeric
Imprime o número do protocolo, escopo, dsfield, etc. diretamente, em vez de convertê-lo para um nome legível por humanos.
-a, -all
executa o comando especificado em todos os objetos, dependendo se o comando suporta essa opção.
-c[color][={always|auto|never}
Configura a saída colorida. Se o parâmetro for omitido ou sempre, a saída colorida é habilitada, independentemente do estado do stdout. Se for auto, o stdout é verificado para ver se é um terminal antes de habilitar a saída colorida. Se for nunca, a saída colorida é desabilitada. Se especificado várias vezes, o último prevalece. Esta flag é ignorada se -json também for fornecida.
A paleta de cores usada pode ser influenciada pela variável de ambiente COLORFGBG (veja AMBIENTE).
-t, -timestamp
exibe a hora atual ao usar a opção de monitoramento.
-ts, -tshort
Semelhante a -timestamp, mas usa um formato mais curto.
-rc, -rcvbuf<SIZE>
Define o tamanho do buffer de recebimento do socket netlink, o padrão é 1MB.
-iec imprime taxas legíveis por humanos em unidades IEC (por exemplo, 1Ki = 1024).
-br, -brief
Imprime apenas informações básicas em um formato tabular para melhor legibilidade. Esta opção é atualmente suportada apenas pelos comandos ip addr show, ip link show e ip neigh show.
-j, -json
Saída dos resultados em Notação de Objeto JavaScript (JSON).
-p, -pretty
O formato JSON padrão é compacto e mais eficiente para análise, mas difícil para a maioria dos usuários ler. Esta flag adiciona indentação para facilitar a leitura.
-echo Solicita que o kernel envie a configuração aplicada de volta.
SINTAXE DE COMANDO IP
OBJETO
address
- endereço de protocolo (IP ou IPv6) em um dispositivo.
addrlabel
- configuração de rótulo para seleção de endereço de protocolo.
fou - configuração da porta de recebimento Foo-over-UDP.
ila - gerencia endereços de localizador de identificador (ILA).
ioam - gerencia namespaces IOAM e esquemas IOAM.
l2tp - tunela Ethernet sobre IP (L2TPv3).
link - dispositivo de rede.
macsec - configuração do dispositivo MACsec.
maddress
- endereço multicast.
monitor
- observa as mensagens netlink.
mptcp - gerencia o gerenciador de caminho MPTCP.
mroute - entrada de cache de roteamento multicast.
mrule - regra no banco de dados de política de roteamento multicast.
neighbour
- gerencia entradas de cache ARP ou NDISC.
netconf
- monitoramento de configuração de rede.
netns - gerencia namespaces de rede.
nexthop
- gerencia objetos nexthop.
ntable - gerencia a operação do cache de vizinhos.
route - entrada da tabela de roteamento.
rule - regra no banco de dados de política de roteamento.
sr - gerencia o roteamento de segmento IPv6.
stats - gerencia e exibe as estatísticas da interface.
tcp_metrics/tcpmetrics
- gerencia as métricas TCP.
token - gerencia identificadores de interface tokenizados.
tunnel - túnel sobre IP.
tuntap - gerenciar dispositivos TUN/TAP.
vrf - gerenciar dispositivos de roteamento e encaminhamento virtual.
xfrm - gerenciar políticas IPSec.
Os nomes de todos os objetos podem ser escritos na forma completa ou abreviada, por exemplo, address pode ser abreviado para addr ou apenas a.
COMANDO
Especifica a ação a ser executada no objeto. O conjunto de ações possíveis depende do tipo de objeto. Como regra, é possível adicionar, excluir e mostrar (ou listar) objetos, mas alguns objetos não permitem todas essas operações ou têm alguns comandos adicionais. O comando de ajuda está disponível para todos os objetos. Ele imprime uma lista de comandos disponíveis e convenções de sintaxe de argumentos.
Se nenhum comando for fornecido, algum comando padrão é assumido. Geralmente, é listar ou, se os objetos desta classe não puderem ser listados, ajuda.
AMBIENTE
COLORFGBG
Se definido, seu valor é usado para detectar se o fundo é escuro ou claro e usar cores contrastantes para ele.
A variável de ambiente COLORFGBG geralmente contém dois ou três valores separados por
ponto e vírgula; queremos o último valor em ambos os casos. Se este valor for 0-6 ou 8, escolha cores adequadas para um fundo escuro:
COLORFGBG=";0" ip -c a
STATUS DE SAÍDA
O status de saída é 0 se o comando for bem-sucedido e 1 se houver um erro de sintaxe. Se um erro foi reportado pelo kernel, o status de saída é 2.
EXEMPLOS
ip addr
Mostra os endereços atribuídos a todas as interfaces de rede.
ip neigh
Mostra a tabela de vizinhos atual no kernel.
ip link set x up
Ativa a interface x.
ip link set x down
Desativa a interface x.
ip route
Mostra as rotas da tabela.
HISTÓRICO
ip foi escrito por Alexey N. Kuznetsov e adicionado no Linux 2.2.
VEJA TAMBÉM
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) Referência de comandos IP ip-cref.ps
RELATANDO BUGS
Relate quaisquer bugs para a lista de discussão de desenvolvedores de rede <_> onde o desenvolvimento e manutenção são realizados principalmente. Você não precisa estar inscrito na lista para enviar uma mensagem lá.
AUTOR
Manpage original por Michail Litvak <_>