blocktrans.c File Reference

Block device translator. More...

#include <stdlib.h>
#include <string.h>
#include <errno.h>
#include <assert.h>
#include <ipxe/iobuf.h>
#include <ipxe/xfer.h>
#include <ipxe/blockdev.h>
#include <ipxe/blocktrans.h>

Go to the source code of this file.

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
	FILE_SECBOOT (PERMITTED)
static void	blktrans_close (struct block_translator *blktrans, int rc)
	Close block device translator. More...
static int	blktrans_deliver (struct block_translator *blktrans, struct io_buffer *iobuf, struct xfer_metadata *meta)
	Deliver data. More...
static struct xfer_buffer *	blktrans_buffer (struct block_translator *blktrans)
	Get underlying data transfer buffer. More...
int	block_translate (struct interface *block, void *buffer, size_t size)
	Insert block device translator. More...

Variables
static struct interface_operation	blktrans_block_operations []
	Block device translator block device interface operations. More...
static struct interface_descriptor	blktrans_block_desc
	Block device translator block device interface descriptor. More...
static struct interface_operation	blktrans_xfer_operations []
	Block device translator data transfer interface operations. More...
static struct interface_descriptor	blktrans_xfer_desc
	Block device translator data transfer interface descriptor. More...

Detailed Description

Block device translator.

Definition in file blocktrans.c.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

FILE_SECBOOT()

FILE_SECBOOT

(

PERMITTED

)

blktrans_close()

static void blktrans_close ( struct block_translator *  blktrans, int  rc  )

static

Close block device translator.

Parameters

blktrans	Block device translator
rc	Reason for close

Definition at line 49 of file blocktrans.c.

                                                                         {
        struct block_device_capacity capacity;

        /* Report block device capacity, if applicable */
        if ( ( rc == 0 ) && ( blktrans->blksize ) ) {

                /* Construct block device capacity */
                capacity.blocks =
                        ( blktrans->xferbuf.len / blktrans->blksize );
                capacity.blksize = blktrans->blksize;
                capacity.max_count = -1U;

                /* Report block device capacity */
                block_capacity ( &blktrans->block, &capacity );
        }

        /* Shut down interfaces */
        intf_shutdown ( &blktrans->xfer, rc );
        intf_shutdown ( &blktrans->block, rc );
}

References block_device_capacity::blksize, block_translator::blksize, block_translator::block, block_capacity(), block_device_capacity::blocks, intf_shutdown(), xfer_buffer::len, block_device_capacity::max_count, rc, block_translator::xfer, and block_translator::xferbuf.

Referenced by blktrans_deliver().

blktrans_deliver()

static int blktrans_deliver ( struct block_translator *  blktrans, struct io_buffer *  iobuf, struct xfer_metadata *  meta  )

static

Deliver data.

Parameters

blktrans	Block device translator
iobuf	I/O buffer
meta	Data transfer metadata

Return values

rc	Return status code

Definition at line 78 of file blocktrans.c.

                                                           {
        int rc;

        /* Deliver to buffer */
        if ( ( rc = xferbuf_deliver ( &blktrans->xferbuf, iob_disown ( iobuf ),
                                      meta ) ) != 0 ) {
                DBGC ( blktrans, "BLKTRANS %p could not deliver: %s\n",
                       blktrans, strerror ( rc ) );
                goto err;
        }

        return 0;

 err:
        blktrans_close ( blktrans, rc );
        return rc;
}

References blktrans_close(), DBGC, iob_disown, meta, rc, strerror(), block_translator::xferbuf, and xferbuf_deliver().

blktrans_buffer()

static struct xfer_buffer* blktrans_buffer ( struct block_translator *  blktrans )

static

Get underlying data transfer buffer.

Parameters

blktrans

Block device translator

Return values

xferbuf

Data transfer buffer

Definition at line 105 of file blocktrans.c.

                                                      {

        return &blktrans->xferbuf;
}

References block_translator::xferbuf.

block_translate()

int block_translate	(	struct interface *	block,
		void *	buffer,
		size_t	size
	)

Insert block device translator.

Parameters

block	Block device interface
buffer	Data buffer (or NULL)
size	Length of data buffer, or block size

Return values

rc	Return status code

Definition at line 140 of file blocktrans.c.

                                                                           {
        struct block_translator *blktrans;
        int rc;

        /* Allocate and initialise structure */
        blktrans = zalloc ( sizeof ( *blktrans ) );
        if ( ! blktrans ) {
                rc = -ENOMEM;
                goto err_alloc;
        }
        ref_init ( &blktrans->refcnt, NULL );
        intf_init ( &blktrans->block, &blktrans_block_desc, &blktrans->refcnt );
        intf_init ( &blktrans->xfer, &blktrans_xfer_desc, &blktrans->refcnt );
        if ( buffer ) {
                xferbuf_fixed_init ( &blktrans->xferbuf, buffer, size );
        } else {
                xferbuf_void_init ( &blktrans->xferbuf );
                blktrans->blksize = size;
        }

        /* Attach to interfaces, mortalise self, and return */
        intf_insert ( block, &blktrans->block, &blktrans->xfer );
        ref_put ( &blktrans->refcnt );

        DBGC2 ( blktrans, "BLKTRANS %p created", blktrans );
        if ( buffer ) {
                DBGC2 ( blktrans, " for %#lx+%#zx",
                        virt_to_phys ( buffer ), size );
        }
        DBGC2 ( blktrans, "\n" );
        return 0;

        ref_put ( &blktrans->refcnt );
 err_alloc:
        return rc;
}

References block_translator::blksize, blktrans_block_desc, blktrans_xfer_desc, block, block_translator::block, buffer, DBGC2, ENOMEM, intf_init(), intf_insert(), NULL, rc, ref_init, ref_put, block_translator::refcnt, size, block_translator::xfer, block_translator::xferbuf, xferbuf_fixed_init(), xferbuf_void_init(), and zalloc().

Referenced by http_block_read(), and http_block_read_capacity().

Variable Documentation

blktrans_block_operations

struct interface_operation blktrans_block_operations[]

static

Initial value:

= {
        INTF_OP ( intf_close, struct block_translator *, blktrans_close ),
}

Block device translator block device interface operations.

Definition at line 111 of file blocktrans.c.

blktrans_block_desc

struct interface_descriptor blktrans_block_desc

static

Initial value:

=
        INTF_DESC_PASSTHRU ( struct block_translator, block,
                             blktrans_block_operations, xfer )

Block device translator block device interface descriptor.

Definition at line 116 of file blocktrans.c.

Referenced by block_translate().

blktrans_xfer_operations

struct interface_operation blktrans_xfer_operations[]

static

Initial value:

= {
        INTF_OP ( xfer_deliver, struct block_translator *, blktrans_deliver ),
        INTF_OP ( xfer_buffer, struct block_translator *, blktrans_buffer ),
        INTF_OP ( intf_close, struct block_translator *, blktrans_close ),
}

Block device translator data transfer interface operations.

Definition at line 121 of file blocktrans.c.

blktrans_xfer_desc

struct interface_descriptor blktrans_xfer_desc

static

Initial value:

=
        INTF_DESC_PASSTHRU ( struct block_translator, xfer,
                             blktrans_xfer_operations, block )

Block device translator data transfer interface descriptor.

Definition at line 128 of file blocktrans.c.

Referenced by block_translate().