ip - afficher / manipuler les routes, les périphériques réseau, les interfaces et les tunnels
SYNTAXE
ip [ OPTIONS ] OBJECT { COMMANDE | aide }
ip [ -force ] -batch fichier
OBJECT := { address | addrlabel | fou | aide | 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] }
OPTIONS
-V, -Version
Afficher la version de l'utilitaire ip et quitter.
-h, -human, -human-readable
afficher les statistiques avec des valeurs lisibles par l'homme suivies d'un suffixe.
-b, -batch <FICHIER>
Lire les commandes à partir du fichier ou de l'entrée standard et les exécuter. Le premier échec entraînera l'arrêt de ip.
-force Ne pas arrêter ip en cas d'erreurs en mode batch. Si des erreurs se sont produites pendant l'exécution des commandes, le code de retour de l'application sera différent de zéro.
-s, -stats, -statistics
Afficher plus d'informations. Si l'option apparaît deux fois ou plus, la quantité d'informations augmente. En règle générale, les informations sont des statistiques ou certaines valeurs de temps.
-d, -details
Afficher plus d'informations détaillées.
-l, -loops <NOMBRE>
Spécifier le nombre maximum de boucles que la logique « ip address flush » tentera avant d'abandonner. La valeur par défaut est 10. Zéro (0) signifie effectuer une boucle jusqu'à ce que toutes les adresses soient supprimées.
-f, -family <FAMILLE>
Spécifie la famille de protocoles à utiliser. L'identifiant de la famille de protocoles peut être l'un des suivants : inet, inet6, bridge, mpls ou link. Si cette option n'est pas présente, la famille de protocoles est déduite des autres arguments. Si le reste de la ligne de commande ne fournit pas suffisamment d'informations pour déduire la famille, ip revient à la valeur par défaut, généralement inet ou any. link est un identifiant de famille spécial signifiant qu'aucun protocole réseau n'est impliqué.
-4 raccourci pour -family inet.
-6 raccourci pour -family inet6.
-B raccourci pour -family bridge.
-M raccourci pour -family mpls.
-0 raccourci pour -family link.
-o, -oneline
afficher chaque enregistrement sur une seule ligne, en remplaçant les sauts de ligne par le caractère '\'. Ceci est pratique lorsque vous souhaitez compter les enregistrements avec [wc]({filename}../../wc)(1) ou pour [grep]({filename}../../grep)(1) la sortie.
-r, -resolve
utilise le résolveur de noms du système pour afficher les noms DNS au lieu des adresses d'hôte.
-n, -netns <NETNS>
bascule vers l'espace de noms réseau spécifié NETNS. En réalité, cela simplifie l'exécution de :
ip netns exec NETNS ip [ OPTIONS ] OBJECT { COMMAND | help }
en
ip -n[etns] NETNS [ OPTIONS ] OBJECT { COMMAND | help }
-N, -Numeric
affiche le numéro du protocole, de la portée, du champ DS, etc., directement au lieu de le convertir en un nom lisible par l'homme.
-a, -all
exécute la commande spécifiée sur tous les objets, en fonction de si la commande prend en charge cette option.
-c[color][={always|auto|never}
configure la sortie en couleur. Si le paramètre est omis ou est « always », la sortie en couleur est activée, quel que soit l'état de stdout. Si le paramètre est « auto », stdout est vérifié pour s'assurer qu'il s'agit d'un terminal avant d'activer la sortie en couleur. Si le paramètre est « never », la sortie en couleur est désactivée. Si spécifié plusieurs fois, le dernier prend le pas. Cet indicateur est ignoré si -json est également spécifié.
La palette de couleurs utilisée peut être influencée par la variable d'environnement COLORFGBG (voir ENVIRONNEMENT).
-t, -timestamp
affiche l'heure actuelle lors de l'utilisation de l'option de surveillance.
-ts, -tshort
comme -timestamp, mais utilise un format plus court.
-rc, -rcvbuf<SIZE>
définit la taille du tampon de réception de la socket Netlink, par défaut à 1 Mo.
-iec affiche les débits lisibles par l'homme dans des unités CEI (par exemple, 1 Ki = 1024).
-br, -brief
affiche uniquement les informations de base dans un format tabulaire pour une meilleure lisibilité. Cette option est actuellement prise en charge par les commandes ip addr show, ip link show et ip neigh show.
-j, -json
affiche les résultats au format JavaScript Object Notation (JSON).
-p, -pretty
le format JSON par défaut est compact et plus efficace à analyser, mais difficile à lire pour la plupart des utilisateurs. Cet indicateur ajoute une indentation pour une meilleure lisibilité.
-echo demande au noyau de renvoyer la configuration appliquée.
SYNTAXE DE LA COMMANDE IP
OBJECT
address
- adresse de protocole (IP ou IPv6) sur un périphérique.
addrlabel
- configuration d'étiquette pour la sélection d'adresses de protocole.
fou - configuration du port de réception Foo-over-UDP.
ila - gestion des adresses d'identification et de localisation (ILA).
ioam - gestion des espaces de noms IOAM et des schémas IOAM.
l2tp - tunnel Ethernet sur IP (L2TPv3).
link - périphérique réseau.
macsec - configuration du périphérique MACsec.
maddress
- adresse multicast.
monitor
- surveiller les messages Netlink.
mptcp - gestion du gestionnaire de chemins MPTCP.
mroute - entrée de la mémoire cache de routage multicast.
mrule - règle dans la base de données de règles de routage multicast.
neighbour
- gestion des entrées de la mémoire cache ARP ou NDISC.
netconf
- surveillance de la configuration réseau.
netns - gestion des espaces de noms réseau.
nexthop
- gestion des objets nexthop.
ntable - gestion du fonctionnement de la mémoire cache des voisins.
route - entrée de la table de routage.
rule - règle dans la base de données de règles de routage.
sr - gestion du routage de segment IPv6.
stats - gestion et affichage des statistiques d'interface.
tcp_metrics/tcpmetrics
- gestion des métriques TCP.
token - gestion des identificateurs d'interface symbolisés.
tunnel - tunnel sur IP.
tuntap - gérer les périphériques TUN/TAP.
vrf - gérer les périphériques de routage et de transfert virtuel.
xfrm - gérer les politiques IPSec.
Les noms de tous les objets peuvent être écrits sous leur forme complète ou abrégée, par exemple address peut être abrégé en addr ou simplement a.
COMMANDE
Spécifie l'action à effectuer sur l'objet. L'ensemble des actions possibles dépend du type d'objet. En règle générale, il est possible d'ajouter, de supprimer et d'afficher (ou de lister) des objets, mais certains objets ne permettent pas toutes ces opérations ou ont des commandes supplémentaires. La commande help est disponible pour tous les objets. Elle affiche une liste des commandes disponibles et des conventions de syntaxe des arguments.
Si aucune commande n'est donnée, une commande par défaut est supposée. Habituellement, il s'agit de list ou, si les objets de cette classe ne peuvent pas être listés, de help.
ENVIRONNEMENT
COLORFGBG
Si défini, sa valeur est utilisée pour détecter si l'arrière-plan est sombre ou clair et pour utiliser des couleurs contrastées pour celui-ci.
La variable d'environnement COLORFGBG contient généralement deux ou trois valeurs séparées par
des points-virgules ; nous voulons la dernière valeur dans les deux cas. Si cette valeur est 0-6 ou 8, choisissez des couleurs adaptées à un arrière-plan sombre :
COLORFGBG=";0" ip -c a
STATUT DE SORTIE
Le statut de sortie est 0 si la commande a réussi, et 1 en cas d'erreur de syntaxe. Si une erreur a été signalée par le noyau, le statut de sortie est 2.
EXEMPLES
ip addr
Affiche les adresses attribuées à toutes les interfaces réseau.
ip neigh
Affiche la table de voisinage actuelle dans le noyau.
ip link set x up
Active l'interface x.
ip link set x down
Désactive l'interface x.
ip route
Affiche les routes de la table.
HISTORIQUE
ip a été écrit par Alexey N. Kuznetsov et ajouté à Linux 2.2.
CONSULTER AUSSI
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) Référence de la commande IP ip-cref.ps
SIGNALER LES BUGS
Signalez tout bug à la liste de diffusion des développeurs réseau <_> où le développement et la maintenance sont principalement effectués. Vous n'êtes pas obligé de vous abonner à la liste pour y envoyer un message.
AUTEUR
Page de manuel originale par Michail Litvak <_>