snponly.c File Reference

EFI chainloaded-device-only driver. More...

#include <string.h>
#include <errno.h>
#include <ipxe/init.h>
#include <ipxe/efi/efi.h>
#include <ipxe/efi/efi_driver.h>
#include <ipxe/efi/efi_utils.h>
#include <ipxe/efi/mnpnet.h>
#include <ipxe/efi/Protocol/SimpleNetwork.h>
#include <ipxe/efi/Protocol/NetworkInterfaceIdentifier.h>
#include "snpnet.h"
#include "nii.h"

Go to the source code of this file.

Data Structures
struct	chained_protocol
	A chainloaded protocol. More...

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
	FILE_SECBOOT (PERMITTED)
static void	chained_locate (struct chained_protocol *chained)
	Locate chainloaded protocol. More...
static int	chained_supported (EFI_HANDLE device, struct chained_protocol *chained)
	Check to see if driver supports a device. More...
static int	snponly_supported (EFI_HANDLE device)
	Check to see if driver supports a device. More...
static int	niionly_supported (EFI_HANDLE device)
	Check to see if driver supports a device. More...
static int	mnponly_supported (EFI_HANDLE device)
	Check to see if driver supports a device. More...
struct efi_driver snponly_driver	__efi_driver (EFI_DRIVER_SNP)
	EFI SNP chainloading-device-only driver. More...
struct efi_driver niionly_driver	__efi_driver (EFI_DRIVER_NII)
	EFI NII chainloading-device-only driver. More...
struct efi_driver mnponly_driver	__efi_driver (EFI_DRIVER_MNP)
	EFI MNP chainloading-device-only driver. More...
static void	chained_init (void)
	Initialise EFI chainloaded-device-only driver. More...
struct init_fn chained_init_fn	__init_fn (INIT_LATE)
	EFI chainloaded-device-only initialisation function. More...

Variables
static struct chained_protocol	chained_snp
	Chainloaded SNP protocol. More...
static struct chained_protocol	chained_nii
	Chainloaded NII protocol. More...
static struct chained_protocol	chained_mnp
	Chainloaded MNP protocol. More...

Detailed Description

EFI chainloaded-device-only driver.

Definition in file snponly.c.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

FILE_SECBOOT()

FILE_SECBOOT

(

PERMITTED

)

chained_locate()

static void chained_locate ( struct chained_protocol *  chained )

static

Locate chainloaded protocol.

Parameters

chained

Chainloaded protocol

Definition at line 93 of file snponly.c.

                                                                {
        EFI_HANDLE device = efi_loaded_image->DeviceHandle;
        EFI_HANDLE handle;
        void *match = NULL;
        void *interface;
        unsigned int skip;
        int rc;

        /* Identify target device handle */
        for ( skip = 0 ; ; skip++ ) {

                /* Locate handle supporting this protocol */
                if ( ( rc = efi_locate_device ( device, chained->protocol,
                                                &handle, skip ) ) != 0 ) {
                        if ( skip == 0 ) {
                                DBGC ( device, "CHAINED %s does not support "
                                       "%s: %s\n", efi_handle_name ( device ),
                                       efi_guid_ntoa ( chained->protocol ),
                                       strerror ( rc ) );
                        }
                        break;
                }

                /* Get protocol instance */
                if ( ( rc = efi_open ( handle, chained->protocol,
                                       &interface ) ) != 0 ) {
                        DBGC ( device, "CHAINED %s could not open %s on ",
                               efi_handle_name ( device ),
                               efi_guid_ntoa ( chained->protocol ) );
                        DBGC ( device, "%s: %s\n",
                               efi_handle_name ( handle ), strerror ( rc ) );
                        break;
                }

                /* Stop if we reach a non-matching protocol instance */
                if ( match && ( match != interface ) ) {
                        DBGC ( device, "CHAINED %s found non-matching %s on ",
                               efi_handle_name ( device ),
                               efi_guid_ntoa ( chained->protocol ) );
                        DBGC ( device, "%s\n", efi_handle_name ( handle ) );
                        break;
                }

                /* Record this handle */
                chained->device = handle;
                match = interface;
                DBGC ( device, "CHAINED %s found %s on ",
                       efi_handle_name ( device ),
                       efi_guid_ntoa ( chained->protocol ) );
                DBGC ( device, "%s\n", efi_handle_name ( chained->device ) );
        }
}

References DBGC, chained_protocol::device, EFI_LOADED_IMAGE_PROTOCOL::DeviceHandle, efi_guid_ntoa(), efi_handle_name(), efi_loaded_image, efi_locate_device(), efi_open, handle, NULL, chained_protocol::protocol, rc, and strerror().

Referenced by chained_init().

chained_supported()

static int chained_supported ( EFI_HANDLE  device, struct chained_protocol *  chained  )

static

Check to see if driver supports a device.

Parameters

device	EFI device handle
chained	Chainloaded protocol

Return values

rc	Return status code

Definition at line 153 of file snponly.c.

                                                                  {
        void *interface;
        int rc;

        /* Get protocol */
        if ( ( rc = efi_open ( device, chained->protocol,
                               &interface ) ) != 0 ) {
                DBGCP ( device, "CHAINED %s is not a %s device\n",
                        efi_handle_name ( device ),
                        efi_guid_ntoa ( chained->protocol ) );
                return rc;
        }

        /* Ignore non-matching handles */
        if ( device != chained->device ) {
                DBGC2 ( device, "CHAINED %s is not the chainloaded %s\n",
                        efi_handle_name ( device ),
                        efi_guid_ntoa ( chained->protocol ) );
                return -ENOTTY;
        }
        DBGC ( device, "CHAINED %s is the chainloaded %s\n",
               efi_handle_name ( device ),
               efi_guid_ntoa ( chained->protocol ) );

        /* Check for wireless devices, if applicable */
        if ( chained->inhibit_wifi &&
             ( ( efi_test ( device, &efi_wifi2_protocol_guid ) ) == 0 ) ) {
                DBGC ( device, "CHAINED %s is wireless: assuming vendor %s "
                       "driver is too unreliable to use\n",
                       efi_handle_name ( device ),
                       efi_guid_ntoa ( chained->protocol ) );
                return -ENOTTY;
        }

        return 0;
}

References DBGC, DBGC2, DBGCP, chained_protocol::device, efi_guid_ntoa(), efi_handle_name(), efi_open, efi_test, efi_wifi2_protocol_guid, ENOTTY, chained_protocol::inhibit_wifi, chained_protocol::protocol, and rc.

Referenced by mnponly_supported(), niionly_supported(), and snponly_supported().

snponly_supported()

static int snponly_supported ( EFI_HANDLE  device )

static

Check to see if driver supports a device.

Parameters

device

EFI device handle

Return values

rc	Return status code

Definition at line 197 of file snponly.c.

                                                   {

        return chained_supported ( device, &chained_snp );
}

References chained_snp, and chained_supported().

niionly_supported()

static int niionly_supported ( EFI_HANDLE  device )

static

Check to see if driver supports a device.

Parameters

device

EFI device handle

Return values

rc	Return status code

Definition at line 208 of file snponly.c.

                                                   {

        return chained_supported ( device, &chained_nii );
}

References chained_nii, and chained_supported().

mnponly_supported()

static int mnponly_supported ( EFI_HANDLE  device )

static

Check to see if driver supports a device.

Parameters

device

EFI device handle

Return values

rc	Return status code

Definition at line 219 of file snponly.c.

                                                   {

        return chained_supported ( device, &chained_mnp );
}

References chained_mnp, and chained_supported().

__efi_driver() [1/3]

struct efi_driver snponly_driver __efi_driver

(

EFI_DRIVER_SNP

)

EFI SNP chainloading-device-only driver.

__efi_driver() [2/3]

struct efi_driver niionly_driver __efi_driver

(

EFI_DRIVER_NII

)

EFI NII chainloading-device-only driver.

__efi_driver() [3/3]

struct efi_driver mnponly_driver __efi_driver

(

EFI_DRIVER_MNP

)

EFI MNP chainloading-device-only driver.

chained_init()

static void chained_init ( void  )

static

Initialise EFI chainloaded-device-only driver.

Definition at line 254 of file snponly.c.

                                  {

        chained_locate ( &chained_snp );
        chained_locate ( &chained_nii );
        chained_locate ( &chained_mnp );
}

References chained_locate(), chained_mnp, chained_nii, and chained_snp.

__init_fn()

struct init_fn chained_init_fn __init_fn

(

INIT_LATE

)

EFI chainloaded-device-only initialisation function.

Variable Documentation

chained_snp

struct chained_protocol chained_snp

static

Initial value:

= {
        .protocol = &efi_simple_network_protocol_guid,
        .inhibit_wifi = 1,
}

Chainloaded SNP protocol.

Definition at line 72 of file snponly.c.

Referenced by chained_init(), and snponly_supported().

chained_nii

struct chained_protocol chained_nii

static

Initial value:

= {
        .protocol = &efi_nii31_protocol_guid,
        .inhibit_wifi = 1,
}

Chainloaded NII protocol.

Definition at line 78 of file snponly.c.

Referenced by chained_init(), and niionly_supported().

chained_mnp

struct chained_protocol chained_mnp

static

Initial value:

= {
        .protocol = &efi_managed_network_service_binding_protocol_guid,
}

Chainloaded MNP protocol.

Definition at line 84 of file snponly.c.

Referenced by chained_init(), and mnponly_supported().