Ifconfig

Applicable for STM32MP13x lines, STM32MP15x lines

1 Article purpose[edit]

This article provides the basic information needed to start using the Linux® kernel tool: ifconfig[1].

2 Introduction[edit]

The following table provides a brief description of the tool, as well as its availability depending on the software packages:

Yes: this tool is either present (ready to use or to be activated), or can be integrated and activated on the software package.

No: 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™
Warning white.png Warning
STM32MPU Embedded Software distribution for Android™ is no more supported by ST. You can contact our ST partner, Witekio, who can help you to port and maintain it on STM32MP15 platform.
Name Category Purpose Starter Package Developer Package Distribution Package Starter Package Developer Package Distribution Package
ifconfig Monitoring tools ifconfig[1] is a system administration utility for network interface configuration.

ifconfig is deprecated and has been replaced by ip (A web page provides a comparison between ifconfig and ip [2])
Yes Yes Yes Yes Yes Yes

3 Installing the trace and debug tool on your target board[edit]

3.1 Using the STM32MPU Embedded Software distribution[edit]

ifconfig is installed by default and ready to be used with all STM32MPU Embedded Software Packages.

It comes with the busybox:

 which ifconfig | xargs ls -la
/sbin/ifconfig -> /bin/busybox.nosuid

3.2 Using the STM32MPU Embedded Software distribution for Android™[edit]

ifconfig is installed by default and ready to be used with all STM32MPU Embedded Software Packages for Android™.

It comes with the toybox:

 which ifconfig | xargs ls -la
/system/bin/ifconfig -> toybox

4 Getting started[edit]

Follow the sequence described below to get started with the ifconfig tool.

Android logo.png Below information is related to the Android™ distribution
Need to enable root access rights for any changes
  • Using ADB shell is ADB link available:
 adb root
 adb shell
 ...
  • Using uart console shell:
 su
 ...

4.1 List the available network interfaces[edit]

 ifconfig
eth0      Link encap:Ethernet  HWaddr 00:80:E1:42:43:65  
          inet addr:10.48.1.144  Bcast:10.48.3.255  Mask:255.255.252.0
          inet6 addr: fe80::280:e1ff:fe42:4365%lo/64 Scope:Link
          UP BROADCAST RUNNING MULTICAST  MTU:1500  Metric:1
          RX packets:181274 errors:0 dropped:14553 overruns:0 frame:0
          TX packets:28583 errors:0 dropped:0 overruns:0 carrier:0
          collisions:0 txqueuelen:1000 
          RX bytes:23082127 (22.0 MiB)  TX bytes:6438412 (6.1 MiB)
          Interrupt:66 Base address:0x4000 

lo        Link encap:Local Loopback  
          inet addr:127.0.0.1  Mask:255.0.0.0
          inet6 addr: ::1%1/128 Scope:Host
          UP LOOPBACK RUNNING  MTU:65536  Metric:1
          RX packets:202 errors:0 dropped:0 overruns:0 frame:0
          TX packets:202 errors:0 dropped:0 overruns:0 carrier:0
          collisions:0 txqueuelen:1000 
          RX bytes:13454 (13.1 KiB)  TX bytes:13454 (13.1 KiB)

4.2 Disable the network interface[edit]

Warning white.png Warning
Please make sure that no remote terminal is connected through this network (ssh), otherwise you will lost your shell connection.
  • For example, proceed as follows for eth0
 ifconfig eth0 down

4.3 Enable the network interface if it is not already available[edit]

  • For example, proceed as follows for eth0
 ifconfig eth0 up

4.4 Assign a given IP address to a network interface[edit]

  • Proceed as follows to assign 10.48.1.324 address to eth0
 ifconfig eth0 10.48.1.324

5 To go further[edit]

Refer to the man page[1] for more details on command options.

6 References[edit]