Difference between revisions of "Ifconfig"

[unchecked revision] [quality revision]
(Using the STM32MPU Embedded Software distribution for Android™)
(Introduction)
 

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™
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.
Warning.png 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:

Board $> 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:

Board $> 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:
PC $> adb root
PC $> adb shell
Board $> ...
  • Using uart console shell:
Board $> su
Board $> ...

4.1 List the available network interfaces[edit]

Board $> 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.png 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
Board $> ifconfig eth0 down

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

  • For example, proceed as follows for eth0
Board $> 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
Board $> 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]



== Article purpose ==
This article provides the basic information needed to start using the Linux<sup>&reg;</sup> kernel tool: '''ifconfig'''<ref name=ifconfigref/>.

== Introduction ==
{{:Trace_and_debug_tools_assignment_table_template}}<onlyinclude>

 | [[Ifconfig|ifconfig]]
 | [[:Category:Monitoring tools|Monitoring tools]]
 | style="text-align:left;" | '''ifconfig'''<ref name=ifconfigref>https://linux.die.net/man/8/ifconfig</ref> is a system administration utility for network interface configuration.<br><br>{{highlight{{Warning|'''ifconfig''' is deprecated and has been replaced by [[IP Linux command line|''ip'']]}} (.<br>
A web page provides a comparison between ifconfig and ip <ref>https://tty1.net/blog/2010/ifconfig-ip-comparison_en.html</ref>)}}

 || {{Y}} || {{Y}} || {{Y}}
 || {{Y}} || {{Y}} || {{Y}}
 |-</onlyinclude>

 |}

== Installing the trace and debug tool on your target board ==
=== Using the STM32MPU Embedded Software distribution ===
'''ifconfig''' is installed by default and ready to be used with all STM32MPU Embedded Software Packages.

It comes with the '''busybox''':
 {{Board$}} which ifconfig | xargs ls -la
 /sbin/ifconfig -> /bin/busybox.nosuid

=== Using the STM32MPU Embedded Software distribution for Android&trade; ===
'''ifconfig''' is installed by default and ready to be used with all STM32MPU Embedded Software Packages for Android&trade;.

It comes with the '''toybox''':
 {{Board$}} which ifconfig | xargs ls -la
 /system/bin/ifconfig -> toybox

== Getting started ==
Follow the sequence described below to get started with the ifconfig tool.
{{Android | Need to enable root access rights for any changes
*Using ADB shell is ADB link available:
 {{PC$}} adb root
 {{PC$}} adb shell
 {{Board$}} ...
*Using uart console shell:
 {{Board$}} su
 {{Board$}} ...
}}

=== List the available network interfaces ===
 {{Board$}} ifconfig
<pre>

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)</pre>


=== Disable the network interface ===
{{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
 {{Board$}} ifconfig eth0 down

=== Enable the network interface if it is not already available ===
* For example, proceed as follows for eth0
 {{Board$}} ifconfig eth0 up

=== Assign a given IP address to a network interface ===
* Proceed as follows to assign 10.48.1.324 address to eth0
 {{Board$}} ifconfig eth0 10.48.1.324

== To go further ==
Refer to the man page<ref name=ifconfigref/> for more details on command options.

== References ==<references />


{{ ArticleBasedOnModel | Trace and debug tools article model }}
{{ PublicationRequestId | 9037 | 10Oct'18 }}

[[Category:Linux monitoring tools]]</noinclude>
Line 7: Line 7:
 
  | [[Ifconfig|ifconfig]]
 
  | [[Ifconfig|ifconfig]]
 
  | [[:Category:Monitoring tools|Monitoring tools]]
 
  | [[:Category:Monitoring tools|Monitoring tools]]
  | style="text-align:left;" | '''ifconfig'''<ref name=ifconfigref>https://linux.die.net/man/8/ifconfig</ref> is a system administration utility for network interface configuration.<br>{{Warning|'''ifconfig''' is deprecated and has been replaced by [[IP Linux command line|''ip'']].<br>
+
  | style="text-align:left;" | '''ifconfig'''<ref name=ifconfigref>https://linux.die.net/man/8/ifconfig</ref> is a system administration utility for network interface configuration.<br><br>{{highlight|'''ifconfig''' is deprecated and has been replaced by [[IP Linux command line|''ip'']]}} (A web page provides a comparison between ifconfig and ip <ref>https://tty1.net/blog/2010/ifconfig-ip-comparison_en.html</ref>)
A web page provides a comparison between ifconfig and ip <ref>https://tty1.net/blog/2010/ifconfig-ip-comparison_en.html</ref>}}
 
 
  || {{Y}} || {{Y}} || {{Y}}
 
  || {{Y}} || {{Y}} || {{Y}}
 
  || {{Y}} || {{Y}} || {{Y}}
 
  || {{Y}} || {{Y}} || {{Y}}

Attachments

Discussions