Template:ArticleBasedOnModel Template:ArticleMainWriter
Template:ArticleApprovedVersion
1. Article purpose[edit source]
This article provides the basic information needed to start using the Linux kernel tool: ip [1].
2. Introduction[edit source]
The following table provides a brief description of the tool, as well as its availability depending on the software packages:
Template:Y: this tool is either present (ready to use or to be activated), or can be integrated and activated on the software package.
Template:N: this tool is not present and cannot be integrated, or it is present but cannot be activated on the software package.
| Tool | STM32MPU Embedded Software distribution | STM32MPU Embedded Software distribution for Android™ | ||||||
|---|---|---|---|---|---|---|---|---|
| Name | Category | Purpose | Starter Package | Developer Package | Distribution Package | Starter Package | Developer Package | Distribution Package |
| ip | Monitoring tools | ip[1] shows / manipulates routing, devices, policy routing and tunnels of network interfaces. |
Template:Y | Template:Y | Template:Y | Template:UnderConstruction | ||
3. Installing the trace and debug tool on your target board[edit source]
3.1. Using the STM32MPU Embedded Software distribution[edit source]
ip is installed by default (/sbin/ip) and is ready to be used with all STM32MPU software packages.
Template:Board$ which ip /sbin/ip
It is integrated into the Weston image distribution by using the following meta-st package recipie to enable the iproute2 module: meta-st/meta-st-openstlinux/recipes-st/packagegroups/packagegroup-framework-tools.bb.
RDEPENDS_packagegroup-framework-tools-network-base = "\ ethtool \ Template:Green \ "
3.2. Using the STM32MPU Embedded Software distribution for Android™[edit source]
4. Getting started[edit source]
- To check network interfaces
Template:Board$ ip addr show 1: lo: <LOOPBACK,UP,LOWER_UP> mtu 65536 qdisc noqueue state UNKNOWN group default qlen 1000 link/loopback 00:00:00:00:00:00 brd 00:00:00:00:00:00 inet 127.0.0.1/8 scope host lo valid_lft forever preferred_lft forever inet6 ::1/128 scope host valid_lft forever preferred_lft forever 2: can0: <NOARP,ECHO> mtu 16 qdisc noop state DOWN group default qlen 10 link/can 3: eth0: <BROADCAST,MULTICAST,UP,LOWER_UP> mtu 1500 qdisc mq state UP group default qlen 1000 link/ether 00:80:e1:42:43:65 brd ff:ff:ff:ff:ff:ff inet 10.99.1.237/22 brd 10.99.3.255 scope global dynamic eth0 valid_lft 172057sec preferred_lft 172057sec inet 10.99.0.4/32 scope global eth0 valid_lft forever preferred_lft forever inet6 fe80::280:e1ff:fe42:4365/64 scope link valid_lft forever preferred_lft forever 4: sit0@NONE: <NOARP> mtu 1480 qdisc noop state DOWN group default qlen 1000 link/sit 0.0.0.0 brd 0.0.0.0
- To assign an IP address to an interface
Template:Board$ ip addr add 192.168.1.53 dev eth0
- To remove an IP adress
Template:Board$ ip addr del 192.168.1.53 dev eth0
- To enable an interface
Template:Board$ ip link set eth0 up
- To disable an interface
Template:Board$ ip link set eth0 down
- To check a route table
Template:Board$ ip route show default via 10.99.3.254 dev eth0 proto dhcp src 10.99.1.237 metric 1024 10.99.0.0/22 dev eth0 proto kernel scope link src 10.99.1.237 10.99.3.254 dev eth0 proto dhcp scope link src 10.99.1.237 metric 1024
- To add a static route
Template:Board$ ip route add 10.99.0.0/16 via 192.168.1.1 dev eth0
- To remove a static route
Template:Board$ ip route del 10.99.0.0/16
- To set the default gateway
Template:Board$ ip route add default via 192.168.1.1
5. To go further[edit source]
Some usage examples are available for reference[2].
6. References[edit source]
- Useful external links
| Document link | Document Type | Description |
|---|---|---|
| IP Command example | Standard | Documentation from tecmint |
| ifconfig vs ip | Standard | Documentation |