datauri.h File Reference

Data URIs. More...

#include <stdint.h>
#include <string.h>
#include <ipxe/uri.h>

Go to the source code of this file.

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
	FILE_SECBOOT (PERMITTED)
static size_t	datauri_max_len (struct uri *uri)
	Get maximum length of parsed data URI.
int	datauri_parse (struct uri *uri, void *buf)
	Parse data URI.

Detailed Description

Data URIs.

Definition in file datauri.h.

Function Documentation

FILE_LICENCE()

FILE_LICENCE

(

GPL2_OR_LATER_OR_UBDL

)

FILE_SECBOOT()

FILE_SECBOOT

(

PERMITTED

)

datauri_max_len()

size_t datauri_max_len ( struct uri * uri )

inlinestatic

Get maximum length of parsed data URI.

Parameters

uri

Data URI

Return values

max_len

Maximum length

Definition at line 23 of file datauri.h.

                                                         {
 
        /* Neither URI decoding nor base64 decoding can ever expand data */
        return ( uri->opaque ? strlen ( uri->opaque ) : 0 );
}

References uri::opaque, and strlen().

Referenced by datauri_fail_okx(), datauri_okx(), and datauri_open().

datauri_parse()

int datauri_parse ( struct uri * uri, void * buf )

extern

Parse data URI.

Parameters

uri	Data URI
buf	Buffer to fill in

Return values

len	Length of data, or negative error

The buffer length must be at least the size reported by datauri_max_len().

Definition at line 62 of file datauri.c.

                                                 {
        static const char b64marker[7] = ";base64";
        const char *comma;
        const char *encoded;
        size_t prefix_len;
        int len;
        int rc;
 
        /* Sanity check */
        if ( ! uri->opaque ) {
                DBGC ( uri, "DATA %p has no opaque part\n", uri );
                return -EINVAL;
        }
 
        /* Locate encoded string */
        comma = strchr ( uri->opaque, ',' );
        if ( ! comma ) {
                DBGC ( uri, "DATA %p has no comma separator\n", uri );
                return -EINVAL;
        }
        prefix_len = ( comma - uri->opaque );
        encoded = ( comma + 1 );
        len = strlen ( encoded );
 
        /* Decode string */
        if ( ( prefix_len >= sizeof ( b64marker ) ) &&
             ( strncasecmp ( ( comma - sizeof ( b64marker ) ), b64marker,
                             sizeof ( b64marker ) ) == 0 ) ) {
 
                /* Decode Base64 string */
                len = base64_decode ( encoded, buf, len );
                if ( len < 0 ) {
                        rc = len;
                        DBGC ( uri, "DATA %p could not decode Base64: %s\n",
                               uri, strerror ( rc ) );
                        return rc;
                }
 
        } else {
 
                /* Copy raw string */
                strcpy ( buf, encoded );
        }
 
        DBGC ( uri, "DATA %p decoded \"%s\":\n", uri, uri->opaque );
        DBGC_HDA ( uri, 0, buf, len );
        return len;
}

References base64_decode(), DBGC, DBGC_HDA, EINVAL, len, uri::opaque, rc, strchr(), strcpy(), strerror(), strlen(), and strncasecmp().

Referenced by datauri_fail_okx(), datauri_okx(), and datauri_open().