httpblock.c File Reference

Hyper Text Transfer Protocol (HTTP) block device. More...

#include <stdint.h>
#include <string.h>
#include <ipxe/blocktrans.h>
#include <ipxe/blockdev.h>
#include <ipxe/acpi.h>
#include <ipxe/http.h>

Go to the source code of this file.

Macros
#define	HTTP_BLKSIZE   512
	Block size used for HTTP block device requests. More...

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
	FILE_SECBOOT (PERMITTED)
int	http_block_read (struct http_transaction *http, struct interface *data, uint64_t lba, unsigned int count, void *buffer, size_t len)
	Read from block device. More...
int	http_block_read_capacity (struct http_transaction *http, struct interface *data)
	Read block device capacity. More...

Detailed Description

Hyper Text Transfer Protocol (HTTP) block device.

Definition in file httpblock.c.

Macro Definition Documentation

HTTP_BLKSIZE

#define HTTP_BLKSIZE   512

Block size used for HTTP block device requests.

Definition at line 42 of file httpblock.c.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

FILE_SECBOOT()

FILE_SECBOOT

(

PERMITTED

)

http_block_read()

int http_block_read	(	struct http_transaction *	http,
		struct interface *	data,
		uint64_t	lba,
		unsigned int	count,
		void *	buffer,
		size_t	len
	)

Read from block device.

Parameters

http	HTTP transaction
data	Data interface
lba	Starting logical block address
count	Number of logical blocks
buffer	Data buffer
len	Length of data buffer

Return values

rc	Return status code

Definition at line 55 of file httpblock.c.

                                   {
        struct http_request_range range;
        int rc;

        /* Sanity check */
        assert ( len == ( count * HTTP_BLKSIZE ) );

        /* Construct request range descriptor */
        range.start = ( lba * HTTP_BLKSIZE );
        range.len = len;

        /* Start a range request to retrieve the block(s) */
        if ( ( rc = http_open ( data, &http_get, http->uri, &range,
                                NULL ) ) != 0 )
                goto err_open;

        /* Insert block device translator */
        if ( ( rc = block_translate ( data, buffer, len ) ) != 0 ) {
                DBGC ( http, "HTTP %p could not insert block translator: %s\n",
                       http, strerror ( rc ) );
                goto err_translate;
        }

        return 0;

 err_translate:
        intf_restart ( data, rc );
 err_open:
        return rc;
}

References assert(), block_translate(), buffer, count, data, DBGC, HTTP_BLKSIZE, http_get, http_open(), intf_restart(), lba, len, NULL, range, rc, pci_range::start, strerror(), and http_transaction::uri.

http_block_read_capacity()

int http_block_read_capacity	(	struct http_transaction *	http,
		struct interface *	data
	)

Read block device capacity.

Parameters

control	Control interface
data	Data interface

Return values

rc	Return status code

Definition at line 95 of file httpblock.c.

                                                        {
        int rc;

        /* Start a HEAD request to retrieve the capacity */
        if ( ( rc = http_open ( data, &http_head, http->uri, NULL,
                                NULL ) ) != 0 )
                goto err_open;

        /* Insert block device translator */
        if ( ( rc = block_translate ( data, NULL, HTTP_BLKSIZE ) ) != 0 ) {
                DBGC ( http, "HTTP %p could not insert block translator: %s\n",
                       http, strerror ( rc ) );
                goto err_translate;
        }

        return 0;

 err_translate:
        intf_restart ( data, rc );
 err_open:
        return rc;
}

References block_translate(), data, DBGC, HTTP_BLKSIZE, http_head, http_open(), intf_restart(), NULL, rc, strerror(), and http_transaction::uri.