PXENV_UNDI_TRANSMIT
[PXE UNDI API]

UNDI TRANSMIT PACKET. More...

Data Structures
struct	s_PXENV_UNDI_TBD
	A transmit buffer descriptor, as pointed to by s_PXENV_UNDI_TRANSMIT::TBD. More...
struct	s_PXENV_UNDI_TRANSMIT
	Parameter block for pxenv_undi_transmit(). More...
Defines
#define	PXENV_UNDI_TRANSMIT   0x0008
	PXE API function code for pxenv_undi_transmit().
#define	P_UNKNOWN   0
	Media header already filled in.
#define	P_IP   1
	IP protocol.
#define	P_ARP   2
	ARP protocol.
#define	P_RARP   3
	RARP protocol.
#define	P_OTHER   4
	Other protocol.
#define	XMT_DESTADDR   0x0000
	Unicast packet.
#define	XMT_BROADCAST   0x0001
	Broadcast packet.
#define	MAX_DATA_BLKS   8
	Maximum number of data blocks in a transmit buffer descriptor.
Typedefs
typedef struct s_PXENV_UNDI_TBD	PXENV_UNDI_TBD_t
typedef struct s_PXENV_UNDI_TRANSMIT	PXENV_UNDI_TRANSMIT_t
Functions
PXENV_EXIT_t	pxenv_undi_transmit (struct s_PXENV_UNDI_TRANSMIT *undi_transmit)

---

Detailed Description

UNDI TRANSMIT PACKET.

---

Define Documentation

#define PXENV_UNDI_TRANSMIT   0x0008

PXE API function code for pxenv_undi_transmit().

Definition at line 1060 of file pxe_api.h.

Referenced by pxe_api_call(), pxeparent_function_name(), and undinet_transmit().

#define P_UNKNOWN   0

Media header already filled in.

Definition at line 1062 of file pxe_api.h.

Referenced by pxenv_undi_isr(), and pxenv_undi_transmit().

#define P_IP   1

IP protocol.

Definition at line 1063 of file pxe_api.h.

Referenced by pxenv_undi_isr(), and pxenv_undi_transmit().

#define P_ARP   2

ARP protocol.

Definition at line 1064 of file pxe_api.h.

Referenced by pxenv_undi_isr(), and pxenv_undi_transmit().

#define P_RARP   3

RARP protocol.

Definition at line 1065 of file pxe_api.h.

Referenced by pxenv_undi_isr(), and pxenv_undi_transmit().

#define P_OTHER   4

Other protocol.

Definition at line 1066 of file pxe_api.h.

#define XMT_DESTADDR   0x0000

Unicast packet.

Definition at line 1068 of file pxe_api.h.

Referenced by pxenv_undi_isr(), and pxenv_undi_transmit().

#define XMT_BROADCAST   0x0001

Broadcast packet.

Definition at line 1069 of file pxe_api.h.

#define MAX_DATA_BLKS   8

Maximum number of data blocks in a transmit buffer descriptor.

Definition at line 1072 of file pxe_api.h.

---

Typedef Documentation

typedef struct s_PXENV_UNDI_TBD PXENV_UNDI_TBD_t

Definition at line 1097 of file pxe_api.h.

typedef struct s_PXENV_UNDI_TRANSMIT PXENV_UNDI_TRANSMIT_t

Definition at line 1123 of file pxe_api.h.

---

Function Documentation

PXENV_EXIT_t pxenv_undi_transmit

(

struct s_PXENV_UNDI_TRANSMIT *

undi_transmit

)

Definition at line 222 of file pxe_undi.c.

References alloc_iob(), arp_protocol, copy_from_real, s_PXENV_UNDI_TBD::DataBlkCount, s_PXENV_UNDI_TBD::DataBlock, DBG2, s_PXENV_UNDI_TRANSMIT::DestAddr, free_iob(), s_PXENV_UNDI_TBD::ImmedLength, iob_put, iob_reserve, ipv4_protocol, net_device::ll_addr, ll_protocol::ll_addr_len, net_device::ll_broadcast, ll_protocol::ll_header_len, net_device::ll_protocol, MAX_LL_ADDR_LEN, net_protocol::name, net_protocol::net_proto, netdev_irq(), netdev_tx(), ll_protocol::ntoa, NULL, s_SEGOFF16::offset, P_ARP, P_IP, P_RARP, P_UNKNOWN, s_PXENV_UNDI_TRANSMIT::Protocol, ll_protocol::push, PXENV_EXIT_FAILURE, PXENV_EXIT_SUCCESS, PXENV_STATUS, PXENV_STATUS_OUT_OF_RESOURCES, PXENV_STATUS_SUCCESS, PXENV_STATUS_UNDI_INVALID_PARAMETER, rarp_protocol, s_SEGOFF16::segment, s_PXENV_UNDI_TRANSMIT::Status, strerror(), s_PXENV_UNDI_TRANSMIT::TBD, s_PXENV_UNDI_TBD::DataBlk::TDDataLen, undi_tx_count, s_PXENV_UNDI_TBD::Xmit, s_PXENV_UNDI_TRANSMIT::XmitFlag, and XMT_DESTADDR.

Referenced by pxe_api_call().

                                                    {
        struct s_PXENV_UNDI_TBD tbd;
        struct DataBlk *datablk;
        struct io_buffer *iobuf;
        struct net_protocol *net_protocol;
        struct ll_protocol *ll_protocol = pxe_netdev->ll_protocol;
        char destaddr[MAX_LL_ADDR_LEN];
        const void *ll_dest;
        size_t ll_hlen = ll_protocol->ll_header_len;
        size_t len;
        unsigned int i;
        int rc;

        DBG2 ( "PXENV_UNDI_TRANSMIT" );

        /* Forcibly enable interrupts at this point, to work around
         * callers that never call PXENV_UNDI_OPEN before attempting
         * to use the UNDI API.
         */
        netdev_irq ( pxe_netdev, 1 );

        /* Identify network-layer protocol */
        switch ( undi_transmit->Protocol ) {
        case P_IP:      net_protocol = &ipv4_protocol;  break;
        case P_ARP:     net_protocol = &arp_protocol;   break;
        case P_RARP:    net_protocol = &rarp_protocol;  break;
        case P_UNKNOWN:
                net_protocol = NULL;
                ll_hlen = 0;
                break;
        default:
                DBG2 ( " %02x invalid protocol\n", undi_transmit->Protocol );
                undi_transmit->Status = PXENV_STATUS_UNDI_INVALID_PARAMETER;
                return PXENV_EXIT_FAILURE;
        }
        DBG2 ( " %s", ( net_protocol ? net_protocol->name : "RAW" ) );

        /* Calculate total packet length */
        copy_from_real ( &tbd, undi_transmit->TBD.segment,
                         undi_transmit->TBD.offset, sizeof ( tbd ) );
        len = tbd.ImmedLength;
        DBG2 ( " %04x:%04x+%x", tbd.Xmit.segment, tbd.Xmit.offset,
               tbd.ImmedLength );
        for ( i = 0 ; i < tbd.DataBlkCount ; i++ ) {
                datablk = &tbd.DataBlock[i];
                len += datablk->TDDataLen;
                DBG2 ( " %04x:%04x+%x", datablk->TDDataPtr.segment,
                       datablk->TDDataPtr.offset, datablk->TDDataLen );
        }

        /* Allocate and fill I/O buffer */
        iobuf = alloc_iob ( ll_hlen + len );
        if ( ! iobuf ) {
                DBG2 ( " could not allocate iobuf\n" );
                undi_transmit->Status = PXENV_STATUS_OUT_OF_RESOURCES;
                return PXENV_EXIT_FAILURE;
        }
        iob_reserve ( iobuf, ll_hlen );
        copy_from_real ( iob_put ( iobuf, tbd.ImmedLength ), tbd.Xmit.segment,
                         tbd.Xmit.offset, tbd.ImmedLength );
        for ( i = 0 ; i < tbd.DataBlkCount ; i++ ) {
                datablk = &tbd.DataBlock[i];
                copy_from_real ( iob_put ( iobuf, datablk->TDDataLen ),
                                 datablk->TDDataPtr.segment,
                                 datablk->TDDataPtr.offset,
                                 datablk->TDDataLen );
        }

        /* Add link-layer header, if required to do so */
        if ( net_protocol != NULL ) {

                /* Calculate destination address */
                if ( undi_transmit->XmitFlag == XMT_DESTADDR ) {
                        copy_from_real ( destaddr,
                                         undi_transmit->DestAddr.segment,
                                         undi_transmit->DestAddr.offset,
                                         ll_protocol->ll_addr_len );
                        ll_dest = destaddr;
                        DBG2 ( " DEST %s", ll_protocol->ntoa ( ll_dest ) );
                } else {
                        ll_dest = pxe_netdev->ll_broadcast;
                        DBG2 ( " BCAST" );
                }

                /* Add link-layer header */
                if ( ( rc = ll_protocol->push ( pxe_netdev, iobuf, ll_dest,
                                                pxe_netdev->ll_addr,
                                                net_protocol->net_proto ))!=0){
                        DBG2 ( " could not add link-layer header: %s\n",
                               strerror ( rc ) );
                        free_iob ( iobuf );
                        undi_transmit->Status = PXENV_STATUS ( rc );
                        return PXENV_EXIT_FAILURE;
                }
        }

        /* Flag transmission as in-progress.  Do this before starting
         * to transmit the packet, because the ISR may trigger before
         * we return from netdev_tx().
         */
        undi_tx_count++;

        /* Transmit packet */
        DBG2 ( "\n" );
        if ( ( rc = netdev_tx ( pxe_netdev, iobuf ) ) != 0 ) {
                DBG2 ( "PXENV_UNDI_TRANSMIT could not transmit: %s\n",
                       strerror ( rc ) );
                undi_tx_count--;
                undi_transmit->Status = PXENV_STATUS ( rc );
                return PXENV_EXIT_FAILURE;
        }

        undi_transmit->Status = PXENV_STATUS_SUCCESS;
        return PXENV_EXIT_SUCCESS;
}