device.c File Reference

Device model. More...

#include <string.h>
#include <ipxe/list.h>
#include <ipxe/tables.h>
#include <ipxe/init.h>
#include <ipxe/interface.h>
#include <ipxe/device.h>

Go to the source code of this file.

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
static	LIST_HEAD (devices)
	Registered root devices. More...
static int	rootdev_probe (struct root_device *rootdev)
	Probe a root device. More...
static void	rootdev_remove (struct root_device *rootdev)
	Remove a root device. More...
static void	probe_devices (void)
	Probe all devices. More...
static void	remove_devices (int booting __unused)
	Remove all devices. More...
struct startup_fn startup_devices	__startup_fn (STARTUP_NORMAL)
struct device *	identify_device (struct interface *intf)
	Identify a device behind an interface. More...

Variables
int	device_keep_count = 0
	Device removal inhibition counter. More...

Detailed Description

Device model.

Definition in file device.c.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

LIST_HEAD()

static LIST_HEAD ( devices  )

static

Registered root devices.

rootdev_probe()

static int rootdev_probe ( struct root_device *  rootdev )

static

Probe a root device.

Parameters

rootdev

Root device

Return values

rc	Return status code

Definition at line 52 of file device.c.

                                                         {
        int rc;

        DBG ( "Adding %s root bus\n", rootdev->dev.name );
        if ( ( rc = rootdev->driver->probe ( rootdev ) ) != 0 ) {
                DBG ( "Failed to add %s root bus: %s\n",
                      rootdev->dev.name, strerror ( rc ) );
                return rc;
        }

        return 0;
}

References DBG, root_device::dev, root_device::driver, device::name, root_driver::probe, rc, and strerror().

Referenced by probe_devices().

rootdev_remove()

static void rootdev_remove ( struct root_device *  rootdev )

static

Remove a root device.

Parameters

rootdev

Root device

Definition at line 70 of file device.c.

                                                           {
        rootdev->driver->remove ( rootdev );
        DBG ( "Removed %s root bus\n", rootdev->dev.name );
}

References DBG, root_device::dev, root_device::driver, device::name, and root_driver::remove.

Referenced by remove_devices().

probe_devices()

static void probe_devices ( void  )

static

Probe all devices.

This initiates probing for all devices in the system. After this call, the device hierarchy will be populated, and all hardware should be ready to use.

Definition at line 82 of file device.c.

                                   {
        struct root_device *rootdev;
        int rc;

        for_each_table_entry ( rootdev, ROOT_DEVICES ) {
                list_add ( &rootdev->dev.siblings, &devices );
                INIT_LIST_HEAD ( &rootdev->dev.children );
                if ( ( rc = rootdev_probe ( rootdev ) ) != 0 )
                        list_del ( &rootdev->dev.siblings );
        }
}

References device::children, root_device::dev, for_each_table_entry, INIT_LIST_HEAD, list_add, list_del, rc, ROOT_DEVICES, rootdev_probe(), and device::siblings.

remove_devices()

static void remove_devices ( int booting  __unused )

static

Remove all devices.

Definition at line 98 of file device.c.

                                                    {
        struct root_device *rootdev;
        struct root_device *tmp;

        if ( device_keep_count != 0 ) {
                DBG ( "Refusing to remove devices on shutdown\n" );
                return;
        }

        list_for_each_entry_safe ( rootdev, tmp, &devices, dev.siblings ) {
                rootdev_remove ( rootdev );
                list_del ( &rootdev->dev.siblings );
        }
}

References DBG, root_device::dev, device_keep_count, list_del, list_for_each_entry_safe, rootdev_remove(), device::siblings, and tmp.

__startup_fn()

struct startup_fn startup_devices __startup_fn

(

STARTUP_NORMAL

)

identify_device()

struct device* identify_device

(

struct interface *

intf

)

Identify a device behind an interface.

Parameters

intf

Interface

Return values

device

Device, or NULL

Definition at line 125 of file device.c.

                                                           {
        struct interface *dest;
        identify_device_TYPE ( void * ) *op =
                intf_get_dest_op ( intf, identify_device, &dest );
        void *object = intf_object ( dest );
        void *device;

        if ( op ) {
                device = op ( object );
        } else {
                /* Default is to return NULL */
                device = NULL;
        }

        intf_put ( dest );
        return device;
}

References dest, device, identify_device(), identify_device_TYPE, interface::intf, intf_get_dest_op, intf_object(), intf_put(), NULL, and op.

Referenced by fcpdev_identify_device(), identify_device(), and int13_device_path_info().

Variable Documentation

device_keep_count

int device_keep_count = 0

Device removal inhibition counter.

Definition at line 44 of file device.c.

Referenced by devices_get(), devices_put(), and remove_devices().