mnpnet.h File Reference

MNP NIC driver. More...

Go to the source code of this file.

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
	FILE_SECBOOT (PERMITTED)
int	mnpnet_start (struct efi_device *efidev)
	Attach driver to device.
void	mnpnet_stop (struct efi_device *efidev)
	Detach driver from device.
int	mnptemp_create (EFI_HANDLE handle, struct net_device **netdev)
	Create temporary MNP network device.
void	mnptemp_destroy (struct net_device *netdev)
	Destroy temporary MNP network device.

Detailed Description

MNP NIC driver.

Definition in file mnpnet.h.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

FILE_SECBOOT()

FILE_SECBOOT

(

PERMITTED

)

References EFI_HANDLE, handle, and netdev.

mnpnet_start()

int mnpnet_start ( struct efi_device * efidev )

extern

Attach driver to device.

Parameters

efidev

EFI device

Return values

rc	Return status code

Definition at line 370 of file mnpnet.c.

                                               {
        EFI_HANDLE device = efidev->device;
        EFI_GUID *binding = &efi_managed_network_service_binding_protocol_guid;
        EFI_SIMPLE_NETWORK_MODE mode;
        struct net_device *netdev;
        struct mnp_nic *mnp;
        EFI_STATUS efirc;
        int rc;
 
        /* Allocate and initalise structure */
        netdev = alloc_etherdev ( sizeof ( *mnp ) );
        if ( ! netdev ) {
                rc = -ENOMEM;
                goto err_alloc;
        }
        netdev_init ( netdev, &mnpnet_operations );
        mnp = netdev->priv;
        mnp->efidev = efidev;
        efidev_set_drvdata ( efidev, netdev );
 
        /* Populate underlying device information */
        efi_device_info ( device, "MNP", &mnp->dev );
        mnp->dev.driver_name = "MNP";
        mnp->dev.parent = &efidev->dev;
        list_add ( &mnp->dev.siblings, &efidev->dev.children );
        INIT_LIST_HEAD ( &mnp->dev.children );
        netdev->dev = &mnp->dev;
 
        /* Create MNP child */
        if ( ( rc = efi_service_add ( device, binding,
                                      &efidev->child ) ) != 0 ) {
                DBGC ( mnp, "MNP %s could not create child: %s\n",
                       efi_handle_name ( device ), strerror ( rc ) );
                goto err_service;
        }
 
        /* Open MNP protocol */
        if ( ( rc = efi_open_by_driver ( efidev->child,
                                         &efi_managed_network_protocol_guid,
                                         &mnp->mnp ) ) != 0 ) {
                DBGC ( mnp, "MNP %s could not open MNP protocol: %s\n",
                       efi_handle_name ( device ), strerror ( rc ) );
                goto err_open;
        }
 
        /* Get configuration */
        efirc = mnp->mnp->GetModeData ( mnp->mnp, NULL, &mode );
        if ( ( efirc != 0 ) && ( efirc != EFI_NOT_STARTED ) ) {
                rc = -EEFI ( efirc );
                DBGC ( mnp, "MNP %s could not get mode data: %s\n",
                       efi_handle_name ( device ), strerror ( rc ) );
                goto err_mode;
        }
 
        /* Populate network device parameters */
        if ( mode.HwAddressSize != netdev->ll_protocol->hw_addr_len ) {
                DBGC ( device, "MNP %s has invalid hardware address length "
                       "%d\n", efi_handle_name ( device ), mode.HwAddressSize );
                rc = -ENOTSUP;
                goto err_hw_addr_len;
        }
        memcpy ( netdev->hw_addr, &mode.PermanentAddress,
                 netdev->ll_protocol->hw_addr_len );
        if ( mode.HwAddressSize != netdev->ll_protocol->ll_addr_len ) {
                DBGC ( device, "MNP %s has invalid link-layer address length "
                       "%d\n", efi_handle_name ( device ), mode.HwAddressSize );
                rc = -ENOTSUP;
                goto err_ll_addr_len;
        }
        memcpy ( netdev->ll_addr, &mode.CurrentAddress,
                 netdev->ll_protocol->ll_addr_len );
 
        /* Register network device */
        if ( ( rc = register_netdev ( netdev ) ) != 0 )
                goto err_register;
        DBGC ( mnp, "MNP %s registered as %s\n",
               efi_handle_name ( device ), netdev->name );
 
        /* Mark as link up: we don't handle link state */
        netdev_link_up ( netdev );
 
        return 0;
 
        unregister_netdev ( netdev );
 err_register:
 err_ll_addr_len:
 err_hw_addr_len:
 err_mode:
        efi_close_by_driver ( efidev->child,
                              &efi_managed_network_protocol_guid );
 err_open:
        efi_service_del ( device, binding, efidev->child );
 err_service:
        list_del ( &mnp->dev.siblings );
        netdev_nullify ( netdev );
        netdev_put ( netdev );
 err_alloc:
        return rc;
}

References alloc_etherdev(), efi_device::child, device::children, DBGC, efi_device::dev, efi_device::device, EEFI, efi_close_by_driver(), efi_device_info(), EFI_HANDLE, efi_handle_name(), efi_managed_network_protocol_guid, efi_managed_network_service_binding_protocol_guid, EFI_NOT_STARTED, efi_open_by_driver, efi_service_add(), efi_service_del(), mnp_nic::efidev, efidev_set_drvdata(), ENOMEM, ENOTSUP, _EFI_MANAGED_NETWORK_PROTOCOL::GetModeData, INIT_LIST_HEAD, list_add, list_del, memcpy(), mnp_nic::mnp, mnpnet_operations, mode, netdev, netdev_init(), netdev_link_up(), netdev_nullify(), netdev_put(), NULL, rc, register_netdev(), strerror(), and unregister_netdev().

Referenced by __efi_driver(), and mnptemp_create().

mnpnet_stop()

void mnpnet_stop ( struct efi_device * efidev )

extern

Detach driver from device.

Parameters

efidev

EFI device

Definition at line 475 of file mnpnet.c.

                                               {
        EFI_GUID *binding = &efi_managed_network_service_binding_protocol_guid;
        struct net_device *netdev = efidev_get_drvdata ( efidev );
        struct mnp_nic *mnp = netdev->priv;
 
        /* Unregister network device */
        unregister_netdev ( netdev );
 
        /* Close MNP protocol */
        efi_close_by_driver ( efidev->child,
                              &efi_managed_network_protocol_guid );
 
        /* Remove MNP child (unless whole system shutdown is in progress) */
        if ( ! efi_shutdown_in_progress )
                efi_service_del ( efidev->device, binding, efidev->child );
 
        /* Free network device */
        list_del ( &mnp->dev.siblings );
        netdev_nullify ( netdev );
        netdev_put ( netdev );
}

References efi_device::child, efi_device::device, efi_close_by_driver(), efi_managed_network_protocol_guid, efi_managed_network_service_binding_protocol_guid, efi_service_del(), efi_shutdown_in_progress, mnp_nic::efidev, efidev_get_drvdata(), list_del, mnp_nic::mnp, netdev, netdev_nullify(), netdev_put(), and unregister_netdev().

Referenced by __efi_driver(), mnptemp_create(), and mnptemp_destroy().

mnptemp_create()

int mnptemp_create ( EFI_HANDLE handle, struct net_device ** netdev )

extern

Create temporary MNP network device.

Parameters

handle	MNP service binding handle
netdev	Network device to fill in

Return values

rc	Return status code

Definition at line 504 of file mnpnet.c.

                                                                     {
        struct efi_device *efidev;
        int rc;
 
        /* Create temporary EFI device */
        efidev = efidev_alloc ( handle );
        if ( ! efidev ) {
                DBGC ( handle, "MNP %s could not create temporary device\n",
                       efi_handle_name ( handle ) );
                rc = -ENOMEM;
                goto err_alloc;
        }
 
        /* Start temporary network device */
        if ( ( rc = mnpnet_start ( efidev ) ) != 0 ) {
                DBGC ( handle, "MNP %s could not start MNP: %s\n",
                       efi_handle_name ( handle ), strerror ( rc ) );
                goto err_start;
        }
 
        /* Fill in network device */
        *netdev = efidev_get_drvdata ( efidev );
 
        return 0;
 
        mnpnet_stop ( efidev );
 err_start:
        efidev_free ( efidev );
 err_alloc:
        return rc;
}

References DBGC, EFI_HANDLE, efi_handle_name(), efidev_alloc(), efidev_free(), efidev_get_drvdata(), ENOMEM, handle, mnpnet_start(), mnpnet_stop(), netdev, rc, and strerror().

Referenced by efi_autoexec_network().

mnptemp_destroy()

void mnptemp_destroy ( struct net_device * netdev )

extern

Destroy temporary MNP network device.

Parameters

netdev

Network device

Definition at line 541 of file mnpnet.c.

                                                   {
        struct mnp_nic *mnp = netdev->priv;
        struct efi_device *efidev = mnp->efidev;
 
        /* Recycle any cached DHCP packet */
        cachedhcp_recycle ( netdev );
 
        /* Stop temporary network device */
        mnpnet_stop ( efidev );
 
        /* Free temporary EFI device */
        efidev_free ( efidev );
}

References cachedhcp_recycle(), mnp_nic::efidev, efidev_free(), mnp_nic::mnp, mnpnet_stop(), and netdev.

Referenced by efi_autoexec_network().