RTEMS 4.9.6 On-Line Library

Network Commands ifconfig - configure a network interface

RTEMS Shell User's Guide

6.2.2: ifconfig - configure a network interface

SYNOPSYS:

ifconfig
ifconfig interface
ifconfig interface [up|down]
ifconfig interface [netmask|pointtopoint|broadcast] IP

DESCRIPTION:

This command may be used to display information about the network interfaces in the system or configure them.

EXIT STATUS:

This command returns 0 on success and non-zero if an error is encountered.

NOTES:

Just like its counterpart on GNU/Linux and BSD systems, this command is complicated. More example usages would be a welcome submission.

EXAMPLES:

The following is an example of how to use ifconfig:

 ************ INTERFACE STATISTICS ************
***** eth1 *****
Ethernet Address: 00:04:9F:00:5B:21
Address:192.168.1.244   Broadcast Address:192.168.1.255   Net mask:255.255.255.0
Flags: Up Broadcast Running Active Multicast
Send queue limit:50   length:1    Dropped:0
      Rx Interrupts:5391           Not First:0               Not Last:0
              Giant:0              Non-octet:0
            Bad CRC:0                Overrun:0              Collision:0
      Tx Interrupts:5256            Deferred:0         Late Collision:0
   Retransmit Limit:0               Underrun:0             Misaligned:0

CONFIGURATION:

This command is included in the default shell command set. When building a custom command set, define CONFIGURE_SHELL_COMMAND_IFCONFIG to have this command included.

This command can be excluded from the shell command set by defining CONFIGURE_SHELL_NO_COMMAND_IFCONFIG when all shell commands have been configured.

PROGRAMMING INFORMATION:

The ifconfig is implemented by a C language function which has the following prototype:

int rtems_shell_rtems_main_ifconfig(
  int    argc,
  char **argv
);

The configuration structure for the ifconfig has the following prototype:

extern rtems_shell_cmd_t rtems_shell_IFCONFIG_Command;

RTEMS Shell User's Guide