ifmgmt.c File Reference

Network interface management. More...

#include <string.h>
#include <stdio.h>
#include <unistd.h>
#include <errno.h>
#include <console.h>
#include <gpxe/netdevice.h>
#include <gpxe/device.h>
#include <gpxe/process.h>
#include <gpxe/keys.h>
#include <usr/ifmgmt.h>

Go to the source code of this file.

Functions
	FILE_LICENCE (GPL2_OR_LATER)
int	ifopen (struct net_device *netdev)
	Open network device.
void	ifclose (struct net_device *netdev)
	Close network device.
static void	ifstat_errors (struct net_device_stats *stats, const char *prefix)
	Print network device error breakdown.
void	ifstat (struct net_device *netdev)
	Print status of network device.
int	iflinkwait (struct net_device *netdev, unsigned int max_wait_ms)
	Wait for link-up, with status indication.

---

Detailed Description

Network interface management.

Definition in file ifmgmt.c.

---

Function Documentation

FILE_LICENCE

(

GPL2_OR_LATER

)

int ifopen

(

struct net_device *

netdev

)

Open network device.

Parameters:

netdev

Network device

Return values:

rc

Return status code

Definition at line 44 of file ifmgmt.c.

References net_device::name, netdev_open(), printf(), and strerror().

Referenced by dhcp(), ifopen_payload(), and netboot().

                                         {
        int rc;

        if ( ( rc = netdev_open ( netdev ) ) != 0 ) {
                printf ( "Could not open %s: %s\n",
                         netdev->name, strerror ( rc ) );
                return rc;
        }

        return 0;
}

void ifclose

(

struct net_device *

netdev

)

Close network device.

Parameters:

netdev

Network device

Definition at line 61 of file ifmgmt.c.

References netdev_close().

Referenced by close_all_netdevs(), and ifclose_payload().

                                           {
        netdev_close ( netdev );
}

static void ifstat_errors	(	struct net_device_stats *	stats,
		const char *	prefix
	)			[static]

Print network device error breakdown.

Parameters:

	stats	Network device statistics
	prefix	Message prefix

Definition at line 71 of file ifmgmt.c.

References net_device_error::count, net_device_stats::errors, printf(), net_device_error::rc, and strerror().

Referenced by ifstat().

                                                 {
        unsigned int i;

        for ( i = 0 ; i < ( sizeof ( stats->errors ) /
                            sizeof ( stats->errors[0] ) ) ; i++ ) {
                if ( stats->errors[i].count )
                        printf ( "  [%s: %d x \"%s\"]\n", prefix,
                                 stats->errors[i].count,
                                 strerror ( stats->errors[i].rc ) );
        }
}

void ifstat

(

struct net_device *

netdev

)

Print status of network device.

Parameters:

netdev

Network device

Definition at line 89 of file ifmgmt.c.

References net_device_stats::bad, net_device::dev, net_device_stats::good, ifstat_errors(), net_device::link_rc, device::name, net_device::name, netdev_addr(), netdev_is_open(), netdev_link_ok(), printf(), net_device::rx_stats, strerror(), and net_device::tx_stats.

Referenced by ifstat_payload(), iwstat(), and netboot().

                                          {
        printf ( "%s: %s on %s (%s)\n"
                 "  [Link:%s, TX:%d TXE:%d RX:%d RXE:%d]\n",
                 netdev->name, netdev_addr ( netdev ), netdev->dev->name,
                 ( netdev_is_open ( netdev ) ? "open" : "closed" ),
                 ( netdev_link_ok ( netdev ) ? "up" : "down" ),
                 netdev->tx_stats.good, netdev->tx_stats.bad,
                 netdev->rx_stats.good, netdev->rx_stats.bad );
        if ( ! netdev_link_ok ( netdev ) ) {
                printf ( "  [Link status: %s]\n",
                         strerror ( netdev->link_rc ) );
        }
        ifstat_errors ( &netdev->tx_stats, "TXE" );
        ifstat_errors ( &netdev->rx_stats, "RXE" );
}

int iflinkwait	(	struct net_device *	netdev,
		unsigned int	max_wait_ms
	)

Wait for link-up, with status indication.

Parameters:

	netdev	Network device
	max_wait_ms	Maximum time to wait, in ms

Definition at line 111 of file ifmgmt.c.

References CTRL_C, ECANCELED, getchar(), iskey(), net_device::link_rc, mdelay(), net_device::name, netdev_link_ok(), printf(), step(), and strerror().

Referenced by dhcp().

                                                                       {
        int key;
        int rc;

        if ( netdev_link_ok ( netdev ) )
                return 0;

        printf ( "Waiting for link-up on %s...", netdev->name );

        while ( 1 ) {
                if ( netdev_link_ok ( netdev ) ) {
                        rc = 0;
                        break;
                }
                if ( max_wait_ms-- == 0 ) {
                        rc = netdev->link_rc;
                        break;
                }
                step();
                if ( iskey() ) {
                        key = getchar();
                        if ( key == CTRL_C ) {
                                rc = -ECANCELED;
                                break;
                        }
                }
                mdelay ( 1 );
        }

        if ( rc == 0 ) {
                printf ( " ok\n" );
        } else {
                printf ( " failed: %s\n", strerror ( rc ) );
        }

        return rc;
}