URI self-tests. More...

#include <string.h>
#include <byteswap.h>
#include <ipxe/uri.h>
#include <ipxe/tcpip.h>
#include <ipxe/params.h>
#include <ipxe/test.h>

Data Structures
struct	uri_test
	A URI parsing/formatting test. More...

struct	uri_port_test
	A URI port number test. More...

struct	uri_resolve_test
	A URI or path resolution test. More...

struct	uri_pxe_test
	A PXE URI test. More...

struct	uri_churi_test
	A current working URI test. More...

struct	uri_params_test_list
	A request parameter URI test list. More...

struct	uri_params_test
	A request parameter URI test. More...

Macros
#define	uri_ok(uri, expected) uri_okx ( uri, expected, __FILE__, __LINE__ )

#define	uri_parse_ok(test) uri_parse_okx ( test, __FILE__, __LINE__ )

#define	uri_format_ok(test) uri_format_okx ( test, __FILE__, __LINE__ )

#define	uri_dup_ok(test) uri_dup_okx ( test, __FILE__, __LINE__ )

#define	uri_parse_format_dup_ok(test) uri_parse_format_dup_okx ( test, __FILE__, __LINE__ )

#define	uri_port_ok(test) uri_port_okx ( test, __FILE__, __LINE__ )

#define	uri_resolve_ok(test) uri_resolve_okx ( test, __FILE__, __LINE__ )

#define	uri_resolve_path_ok(test) uri_resolve_path_okx ( test, __FILE__, __LINE__ )

#define	uri_pxe_ok(test) uri_pxe_okx ( test, __FILE__, __LINE__ )

#define	uri_churi_ok(test) uri_churi_okx ( test, __FILE__, __LINE__ )

#define	uri_params_list_ok(test) uri_params_list_okx ( test, __FILE__, __LINE__ )

#define	uri_params_ok(test) uri_params_okx ( test, __FILE__, __LINE__ )

Functions
	FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)

static int	uristrcmp (const char first, const char second)
	Compare two URI component strings. More...

static void	uri_okx (struct uri uri, struct uri expected, const char *file, unsigned int line)
	Report URI equality test result. More...

static void	uri_parse_okx (struct uri_test test, const char file, unsigned int line)
	Report URI parsing test result. More...

static void	uri_format_okx (struct uri_test test, const char file, unsigned int line)
	Report URI formatting test result. More...

static void	uri_dup_okx (struct uri uri, const char file, unsigned int line)
	Report URI duplication test result. More...

static void	uri_parse_format_dup_okx (struct uri_test test, const char file, unsigned int line)
	Report URI combined parsing and formatting test result. More...

static void	uri_port_okx (struct uri_port_test test, const char file, unsigned int line)
	Report URI port number test result. More...

static void	uri_resolve_okx (struct uri_resolve_test test, const char file, unsigned int line)
	Report URI resolution test result. More...

static void	uri_resolve_path_okx (struct uri_resolve_test test, const char file, unsigned int line)
	Report path resolution test result. More...

static void	uri_pxe_okx (struct uri_pxe_test test, const char file, unsigned int line)
	Report URI PXE test result. More...

static void	uri_churi_okx (struct uri_churi_test test, const char file, unsigned int line)
	Report current working URI test result. More...

static void	uri_params_list_okx (struct uri_params_test test, struct uri uri, const char *file, unsigned int line)
	Report request parameter URI test list result. More...

static void	uri_params_okx (struct uri_params_test test, const char file, unsigned int line)
	Report request parameter URI test result. More...

static void	uri_test_exec (void)
	Perform URI self-test. More...

Variables
static struct uri_test	uri_empty
	Empty URI. More...

static struct uri_test	uri_boot_ipxe_org
	Basic HTTP URI. More...

static struct uri_test	uri_mailto
	Basic opaque URI. More...

static struct uri_test	uri_host
	Basic host-only URI. More...

static struct uri_test	uri_path
	Basic path-only URI. More...

static struct uri_test	uri_path_escaped
	Path-only URI with escaped characters. More...

static struct uri_test	uri_http_all
	HTTP URI with all the trimmings. More...

static struct uri_test	uri_http_escaped
	HTTP URI with escaped characters. More...

static struct uri_test	uri_http_escaped_improper
	HTTP URI with improperly escaped characters. More...

static struct uri_test	uri_ipv6
	IPv6 URI. More...

static struct uri_test	uri_ipv6_port
	IPv6 URI with port. More...

static struct uri_test	uri_ipv6_local
	IPv6 URI with link-local address. More...

static struct uri_test	uri_ipv6_local_non_conforming
	IPv6 URI with link-local address not conforming to RFC 6874. More...

static struct uri_test	uri_iscsi
	iSCSI URI More...

static struct uri_test	uri_file_relative
	File URI with relative (opaque) path. More...

static struct uri_test	uri_file_absolute
	File URI with absolute path. More...

static struct uri_test	uri_file_volume
	File URI with volume name. More...

static struct uri_test	uri_colons
	Relative URI with colons in path. More...

static struct uri_port_test	uri_explicit_port
	URI with port number. More...

static struct uri_port_test	uri_default_port
	URI without port number. More...

static struct uri_resolve_test	uri_simple_path
	Simple path resolution test. More...

static struct uri_resolve_test	uri_relative_path
	Path resolution test with "." and ".." elements. More...

static struct uri_resolve_test	uri_directory_path
	Path resolution test terminating with directory. More...

static struct uri_resolve_test	uri_excessive_path
	Path resolution test with excessive ".." elements. More...

static struct uri_resolve_test	uri_absolute_path
	Path resolution test with absolute path. More...

static struct uri_resolve_test	uri_relative
	Relative URI resolution test. More...

static struct uri_resolve_test	uri_absolute
	Absolute URI resolution test. More...

static struct uri_resolve_test	uri_absolute_uri_path
	Absolute path URI resolution test. More...

static struct uri_resolve_test	uri_query
	Query URI resolution test. More...

static struct uri_resolve_test	uri_fragment
	Fragment URI resolution test. More...

static struct uri_resolve_test	uri_self
	Empty relative URI resolution test. More...

static struct uri_resolve_test	uri_cwd
	Current directory URI resolution test. More...

static struct uri_pxe_test	uri_pxe_absolute
	PXE URI with absolute URI. More...

static struct uri_pxe_test	uri_pxe_absolute_path
	PXE URI with absolute path. More...

static struct uri_pxe_test	uri_pxe_relative_path
	PXE URI with relative path. More...

static struct uri_pxe_test	uri_pxe_icky
	PXE URI with path containing special characters. More...

static struct uri_pxe_test	uri_pxe_port
	PXE URI with custom port. More...

static struct uri_churi_test	uri_churi []
	Current working URI test. More...

static struct uri_params_test_list	uri_params_list []
	Request parameter URI test list. More...

static struct uri_params_test	uri_params
	Request parameter URI test. More...

static struct uri_params_test_list	uri_named_params_list []
	Named request parameter URI test list. More...

static struct uri_params_test	uri_named_params
	Named request parameter URI test. More...

struct self_test uri_test	__self_test
	URI self-test. More...

Detailed Description

URI self-tests.

Definition in file uri_test.c.

Macro Definition Documentation

◆ uri_ok

#define uri_ok	(	uri,
		expected
	)	uri_okx ( uri, expected, __FILE__, __LINE__ )

Definition at line 160 of file uri_test.c.

◆ uri_parse_ok

#define uri_parse_ok ( test ) uri_parse_okx ( test, __FILE__, __LINE__ )

Definition at line 180 of file uri_test.c.

◆ uri_format_ok

#define uri_format_ok ( test ) uri_format_okx ( test, __FILE__, __LINE__ )

Definition at line 207 of file uri_test.c.

◆ uri_dup_ok

#define uri_dup_ok ( test ) uri_dup_okx ( test, __FILE__, __LINE__ )

Definition at line 226 of file uri_test.c.

◆ uri_parse_format_dup_ok

#define uri_parse_format_dup_ok ( test ) uri_parse_format_dup_okx ( test, __FILE__, __LINE__ )

Definition at line 242 of file uri_test.c.

◆ uri_port_ok

#define uri_port_ok ( test ) uri_port_okx ( test, __FILE__, __LINE__ )

Definition at line 266 of file uri_test.c.

◆ uri_resolve_ok

#define uri_resolve_ok ( test ) uri_resolve_okx ( test, __FILE__, __LINE__ )

Definition at line 307 of file uri_test.c.

◆ uri_resolve_path_ok

#define uri_resolve_path_ok ( test ) uri_resolve_path_okx ( test, __FILE__, __LINE__ )

Definition at line 330 of file uri_test.c.

◆ uri_pxe_ok

#define uri_pxe_ok ( test ) uri_pxe_okx ( test, __FILE__, __LINE__ )

Definition at line 357 of file uri_test.c.

◆ uri_churi_ok

#define uri_churi_ok ( test ) uri_churi_okx ( test, __FILE__, __LINE__ )

Definition at line 405 of file uri_test.c.

◆ uri_params_list_ok

#define uri_params_list_ok ( test ) uri_params_list_okx ( test, __FILE__, __LINE__ )

Definition at line 439 of file uri_test.c.

◆ uri_params_ok

#define uri_params_ok ( test ) uri_params_okx ( test, __FILE__, __LINE__ )

Definition at line 489 of file uri_test.c.

Function Documentation

◆ FILE_LICENCE()

FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL )

◆ uristrcmp()

static int uristrcmp	(	const char *	first,
		const char *	second
	)

static

Compare two URI component strings.

Parameters

first	First string, or NULL
second	Second string, or NULL
difference	Difference

Definition at line 124 of file uri_test.c.

                                                                {
 
         /* Compare strings, allowing for either to be NULL */
         if ( first == second ) {
                 return 0;
         } else if ( ( first == NULL ) || ( second == NULL ) ) {
                 return -1;
         } else {
                 return strcmp ( first, second );
         }
 }

References first, NULL, second, and strcmp().

Referenced by uri_okx().

◆ uri_okx()

static void uri_okx	(	struct uri *	uri,
		struct uri *	expected,
		const char *	file,
		unsigned int	line
	)

static

Report URI equality test result.

Parameters

uri	URI
expected	Expected URI
file	Test code file
line	Test code line

Definition at line 144 of file uri_test.c.

                                           {
 
         okx ( uristrcmp ( uri->scheme, expected->scheme ) == 0, file, line );
         okx ( uristrcmp ( uri->opaque, expected->opaque ) == 0, file, line );
         okx ( uristrcmp ( uri->user, expected->user ) == 0, file, line );
         okx ( uristrcmp ( uri->password, expected->password ) == 0, file, line);
         okx ( uristrcmp ( uri->host, expected->host ) == 0, file, line );
         okx ( uristrcmp ( uri->port, expected->port ) == 0, file, line );
         okx ( uristrcmp ( uri->path, expected->path ) == 0, file, line );
         okx ( uristrcmp ( uri->epath, expected->epath ) == 0, file, line );
         okx ( uristrcmp ( uri->equery, expected->equery ) == 0, file, line );
         okx ( uristrcmp ( uri->efragment, expected->efragment ) == 0,
               file, line);
         okx ( uri->params == expected->params, file, line );
 }

References uri::efragment, uri::epath, uri::equery, uri::host, okx, uri::opaque, uri::params, uri::password, uri::path, uri::port, uri::scheme, uristrcmp(), and uri::user.

Referenced by uri_dup_okx(), uri_params_list_okx(), uri_parse_okx(), and uri_pxe_okx().

◆ uri_parse_okx()

static void uri_parse_okx	(	struct uri_test *	test,
		const char *	file,
		unsigned int	line
	)

static

Report URI parsing test result.

Parameters

test	URI test
file	Test code file
line	Test code line

Definition at line 169 of file uri_test.c.

                                                 {
         struct uri *uri;
 
         /* Parse URI */
         uri = parse_uri ( test->string );
         okx ( uri != NULL, file, line );
         if ( uri )
                 uri_okx ( uri, &test->uri, file, line );
         uri_put ( uri );
 }

References NULL, okx, parse_uri(), test, uri_okx(), and uri_put().

Referenced by uri_parse_format_dup_okx().

◆ uri_format_okx()

static void uri_format_okx	(	struct uri_test *	test,
		const char *	file,
		unsigned int	line
	)

static

Report URI formatting test result.

Parameters

test	URI test
file	Test code file
line	Test code line

Definition at line 189 of file uri_test.c.

                                                  {
         char buf[ strlen ( test->string ) + 1 /* NUL */ ];
         char *tmp;
         size_t len;
 
         /* Format into fixed-size buffer */
         len = format_uri ( &test->uri, buf, sizeof ( buf ) );
         okx ( len == ( sizeof ( buf ) - 1 /* NUL */ ), file, line );
         okx ( strcmp ( buf, test->string ) == 0, file, line );
 
         /* Format into temporarily allocated buffer */
         tmp = format_uri_alloc ( &test->uri );
         okx ( tmp != NULL, file, line );
         if ( tmp )
                 okx ( strcmp ( tmp, test->string ) == 0, file, line );
         free ( tmp );
 }

References format_uri(), format_uri_alloc(), free, len, NULL, okx, strcmp(), strlen(), test, and tmp.

Referenced by uri_parse_format_dup_okx().

◆ uri_dup_okx()

static void uri_dup_okx	(	struct uri *	uri,
		const char *	file,
		unsigned int	line
	)

static

Report URI duplication test result.

Parameters

test	URI
file	Test code file
line	Test code line

Definition at line 216 of file uri_test.c.

                                               {
         struct uri *dup;
 
         dup = uri_dup ( uri );
         okx ( dup != NULL, file, line );
         if ( dup )
                 uri_okx ( dup, uri, file, line );
         uri_put ( dup );
 }

References NULL, okx, uri_dup(), uri_okx(), and uri_put().

Referenced by uri_parse_format_dup_okx().

◆ uri_parse_format_dup_okx()

static void uri_parse_format_dup_okx	(	struct uri_test *	test,
		const char *	file,
		unsigned int	line
	)

static

Report URI combined parsing and formatting test result.

Parameters

test	URI test
file	Test code file
line	Test code line

Definition at line 235 of file uri_test.c.

                                                            {
 
         uri_parse_okx ( test, file, line );
         uri_format_okx ( test, file, line );
         uri_dup_okx ( &test->uri, file, line );
 }

References test, uri_dup_okx(), uri_format_okx(), and uri_parse_okx().

◆ uri_port_okx()

static void uri_port_okx	(	struct uri_port_test *	test,
		const char *	file,
		unsigned int	line
	)

static

Report URI port number test result.

Parameters

test	URI port number test
file	Test code file
line	Test code line

Definition at line 252 of file uri_test.c.

                                                {
         struct uri *uri;
         unsigned int port;
 
         /* Parse URI */
         uri = parse_uri ( test->string );
         okx ( uri != NULL, file, line );
         if ( uri ) {
                 port = uri_port ( uri, test->default_port );
                 okx ( port == test->port, file, line );
         }
         uri_put ( uri );
 }

References NULL, okx, parse_uri(), port, test, uri_port(), and uri_put().

◆ uri_resolve_okx()

static void uri_resolve_okx	(	struct uri_resolve_test *	test,
		const char *	file,
		unsigned int	line
	)

static

Report URI resolution test result.

Parameters

test	Path resolution test
file	Test code file
line	Test code line

Definition at line 275 of file uri_test.c.

                                                                     {
         struct uri *base;
         struct uri *relative;
         struct uri *resolved = NULL;
         char *formatted;
 
         /* Parse URIs */
         base = parse_uri ( test->base );
         okx ( base != NULL, file, line );
         relative = parse_uri ( test->relative );
         okx ( relative != NULL, file, line );
 
         /* Resolve URI  */
         if ( base && relative ) {
                 resolved = resolve_uri ( base, relative );
                 okx ( resolved != NULL, file, line );
         }
 
         /* Format resolved URI */
         formatted = format_uri_alloc ( resolved );
         okx ( formatted != NULL, file, line );
 
         /* Check resolved URI */
         if ( formatted )
                 okx ( strcmp ( formatted, test->resolved ) == 0, file, line );
 
         free ( formatted );
         uri_put ( resolved );
         uri_put ( relative );
         uri_put ( base );
 }

References base, format_uri_alloc(), formatted, free, NULL, okx, parse_uri(), resolve_uri(), strcmp(), test, and uri_put().

Referenced by uri_resolve_path_okx().

◆ uri_resolve_path_okx()

static void uri_resolve_path_okx	(	struct uri_resolve_test *	test,
		const char *	file,
		unsigned int	line
	)

static

Report path resolution test result.

Parameters

test	Path resolution test
file	Test code file
line	Test code line

Definition at line 316 of file uri_test.c.

                                                                          {
         char *resolved;
 
         /* Resolve paths using resolve_path() directly */
         resolved = resolve_path ( test->base, test->relative );
         okx ( resolved != NULL, file, line );
         if ( resolved )
                 okx ( strcmp ( resolved, test->resolved ) == 0, file, line );
         free ( resolved );
 
         /* Resolve paths as URIs (since all paths are valid URIs) */
         uri_resolve_okx ( test, file, line );
 }

References free, NULL, okx, resolve_path(), strcmp(), test, and uri_resolve_okx().

◆ uri_pxe_okx()

static void uri_pxe_okx	(	struct uri_pxe_test *	test,
		const char *	file,
		unsigned int	line
	)

static

Report URI PXE test result.

Parameters

test	URI PXE test
file	Test code file
line	Test code line

Definition at line 340 of file uri_test.c.

                                               {
         char buf[ strlen ( test->string ) + 1 /* NUL */ ];
         struct uri *uri;
         size_t len;
 
         /* Construct URI */
         uri = pxe_uri ( &test->server.sa, test->filename );
         okx ( uri != NULL, file, line );
         if ( uri ) {
                 uri_okx ( uri, &test->uri, file, line );
                 len = format_uri ( uri, buf, sizeof ( buf ) );
                 okx ( len == ( sizeof ( buf ) - 1 /* NUL */ ), file, line );
                 okx ( strcmp ( buf, test->string ) == 0, file, line );
         }
         uri_put ( uri );
 }

References format_uri(), len, NULL, okx, pxe_uri(), strcmp(), strlen(), test, uri_okx(), and uri_put().

◆ uri_churi_okx()

static void uri_churi_okx	(	struct uri_churi_test *	test,
		const char *	file,
		unsigned int	line
	)

static

Report current working URI test result.

Parameters

tests	List of current working URI tests
file	Test code file
line	Test code line

Definition at line 366 of file uri_test.c.

                                                 {
         struct uri *old_cwuri;
         struct uri *uri;
         char *formatted;
 
         /* Preserve original current working URI */
         old_cwuri = uri_get ( cwuri );
 
         /* Perform sequence of current working URI changes */
         do {
                 /* Parse relative URI */
                 uri = parse_uri ( test->relative );
                 okx ( uri != NULL, file, line );
 
                 /* Move to this URI */
                 churi ( uri );
 
                 /* Format new current working URI */
                 formatted = format_uri_alloc ( cwuri );
                 okx ( formatted != NULL, file, line );
                 if ( formatted ) {
                         okx ( strcmp ( formatted, test->expected ) == 0,
                               file, line );
                 }
 
                 /* Free temporary storage */
                 free ( formatted );
                 uri_put ( uri );
 
                 /* Move to next current working URI test */
                 test++;
 
         } while ( test->relative != NULL );
 
         /* Restore original current working URI */
         churi ( old_cwuri );
         uri_put ( old_cwuri );
 }

References churi(), cwuri, format_uri_alloc(), formatted, free, NULL, okx, parse_uri(), strcmp(), test, uri_get(), and uri_put().

◆ uri_params_list_okx()

static void uri_params_list_okx	(	struct uri_params_test *	test,
		struct uri *	uri,
		const char *	file,
		unsigned int	line
	)

static

Report request parameter URI test list result.

Parameters

test	Request parameter URI test
uri	URI
file	Test code file
line	Test code line

Definition at line 415 of file uri_test.c.

                                                       {
         struct uri_params_test_list *list;
         struct parameter *param;
 
         /* Check URI */
         uri_okx ( uri, &test->uri, file, line );
 
         /* Check URI parameters */
         okx ( uri->params != NULL, file, line );
         if ( uri->params ) {
                 list = test->list;
                 for_each_param ( param, uri->params ) {
                         okx ( strcmp ( param->key, list->key ) == 0,
                               file, line );
                         okx ( strcmp ( param->value, list->value ) == 0,
                               file, line );
                         okx ( param->flags == list->flags, file, line );
                         list++;
                 }
                 okx ( list->key == NULL, file, line );
         }
 }

References for_each_param, parameter::list, NULL, okx, param, uri::params, strcmp(), test, and uri_okx().

Referenced by uri_params_okx().

◆ uri_params_okx()

static void uri_params_okx	(	struct uri_params_test *	test,
		const char *	file,
		unsigned int	line
	)

static

Report request parameter URI test result.

Parameters

test	Request parameter URI test
file	Test code file
line	Test code line

Definition at line 449 of file uri_test.c.

                                                  {
         struct uri_params_test_list *list;
         struct parameters *params;
         struct parameter *param;
         struct uri *uri;
         struct uri *dup;
 
         /* Create parameter list */
         params = create_parameters ( test->name );
         okx ( params != NULL, file, line );
         if ( params ) {
                 for ( list = test->list ; list->key ; list++ ) {
                         param = add_parameter ( params, list->key, list->value,
                                                 list->flags );
                         okx ( param != NULL, file, line );
                 }
         }
 
         /* Record parameter list as part of expected URI */
         test->uri.params = params;
 
         /* Parse URI */
         uri = parse_uri ( test->string );
         okx ( uri != NULL, file, line );
         if ( uri )
                 uri_params_list_okx ( test, uri, file, line );
 
         /* Duplicate URI */
         dup = uri_dup ( uri );
         okx ( dup != NULL, file, line );
         if ( dup )
                 uri_params_list_okx ( test, dup, file, line );
 
         /* Clear parameter list in expected URI */
         test->uri.params = NULL;
 
         uri_put ( uri );
         uri_put ( dup );
 }

References add_parameter(), create_parameters(), uri_params_test_list::flags, uri_params_test_list::key, NULL, okx, param, uri::params, parse_uri(), test, uri_dup(), uri_params_list_okx(), uri_put(), and uri_params_test_list::value.

◆ uri_test_exec()

static void uri_test_exec ( void )

static

Perform URI self-test.

URI port number tests

Path resolution tests

URI resolution tests

Definition at line 974 of file uri_test.c.

                                    {
 
         /* URI parsing, formatting, and duplication tests */
         uri_parse_format_dup_ok ( &uri_empty );
         uri_parse_format_dup_ok ( &uri_boot_ipxe_org );
         uri_parse_format_dup_ok ( &uri_mailto );
         uri_parse_format_dup_ok ( &uri_host );
         uri_parse_format_dup_ok ( &uri_path );
         uri_parse_format_dup_ok ( &uri_path_escaped );
         uri_parse_format_dup_ok ( &uri_http_all );
         uri_parse_format_dup_ok ( &uri_http_escaped );
         uri_parse_ok ( &uri_http_escaped_improper ); /* Parse only */
         uri_parse_format_dup_ok ( &uri_ipv6 );
         uri_parse_format_dup_ok ( &uri_ipv6_port );
         uri_parse_format_dup_ok ( &uri_ipv6_local );
         uri_parse_ok ( &uri_ipv6_local_non_conforming ); /* Parse only */
         uri_parse_format_dup_ok ( &uri_iscsi );
         uri_parse_format_dup_ok ( &uri_file_relative );
         uri_parse_format_dup_ok ( &uri_file_absolute );
         uri_parse_format_dup_ok ( &uri_file_volume );
         uri_parse_format_dup_ok ( &uri_colons );
 
         /** URI port number tests */
         uri_port_ok ( &uri_explicit_port );
         uri_port_ok ( &uri_default_port );
 
         /** Path resolution tests */
         uri_resolve_path_ok ( &uri_simple_path );
         uri_resolve_path_ok ( &uri_relative_path );
         uri_resolve_path_ok ( &uri_directory_path );
         uri_resolve_path_ok ( &uri_excessive_path );
         uri_resolve_path_ok ( &uri_absolute_path );
 
         /** URI resolution tests */
         uri_resolve_ok ( &uri_relative );
         uri_resolve_ok ( &uri_absolute );
         uri_resolve_ok ( &uri_absolute_uri_path );
         uri_resolve_ok ( &uri_query );
         uri_resolve_ok ( &uri_fragment );
         uri_resolve_ok ( &uri_self );
         uri_resolve_ok ( &uri_cwd );
 
         /* PXE URI construction tests */
         uri_pxe_ok ( &uri_pxe_absolute );
         uri_pxe_ok ( &uri_pxe_absolute_path );
         uri_pxe_ok ( &uri_pxe_relative_path );
         uri_pxe_ok ( &uri_pxe_icky );
         uri_pxe_ok ( &uri_pxe_port );
 
         /* Current working URI tests */
         uri_churi_ok ( uri_churi );
 
         /* Request parameter URI tests */
         uri_params_ok ( &uri_params );
         uri_params_ok ( &uri_named_params );
 }

References uri_absolute, uri_absolute_path, uri_absolute_uri_path, uri_boot_ipxe_org, uri_churi, uri_churi_ok, uri_colons, uri_cwd, uri_default_port, uri_directory_path, uri_empty, uri_excessive_path, uri_explicit_port, uri_file_absolute, uri_file_relative, uri_file_volume, uri_fragment, uri_host, uri_http_all, uri_http_escaped, uri_http_escaped_improper, uri_ipv6, uri_ipv6_local, uri_ipv6_local_non_conforming, uri_ipv6_port, uri_iscsi, uri_mailto, uri_named_params, uri_params, uri_params_ok, uri_parse_format_dup_ok, uri_parse_ok, uri_path, uri_path_escaped, uri_port_ok, uri_pxe_absolute, uri_pxe_absolute_path, uri_pxe_icky, uri_pxe_ok, uri_pxe_port, uri_pxe_relative_path, uri_query, uri_relative, uri_relative_path, uri_resolve_ok, uri_resolve_path_ok, uri_self, and uri_simple_path.

Variable Documentation

◆ uri_empty

struct uri_test uri_empty

static

Initial value:

= {
        .string = "",
}

Empty URI.

Definition at line 492 of file uri_test.c.

Referenced by uri_test_exec().

◆ uri_boot_ipxe_org

struct uri_test uri_boot_ipxe_org

static

Initial value:

= {
        "http://boot.ipxe.org/demo/boot.php",
        { .scheme = "http", .host = "boot.ipxe.org",
          .path = "/demo/boot.php", .epath = "/demo/boot.php" },
}

Basic HTTP URI.

Definition at line 497 of file uri_test.c.

Referenced by uri_test_exec().

◆ uri_mailto

struct uri_test uri_mailto

static

Initial value:

= {
        "mailto:ipxe-devel@lists.ipxe.org",
        { .scheme = "mailto", .opaque = "ipxe-devel@lists.ipxe.org" },
}

Basic opaque URI.

Definition at line 504 of file uri_test.c.

Referenced by uri_test_exec().

◆ uri_host

struct uri_test uri_host

static

Initial value:

= {
        "http://boot.ipxe.org",
        { .scheme = "http", .host = "boot.ipxe.org" },
}

Basic host-only URI.

Definition at line 510 of file uri_test.c.

Referenced by uri_test_exec().

◆ uri_path

struct uri_test uri_path

static

Initial value:

= {
        "/var/lib/tftpboot/pxelinux.0",
        { .path = "/var/lib/tftpboot/pxelinux.0",
          .epath ="/var/lib/tftpboot/pxelinux.0" },
}

Basic path-only URI.

Definition at line 516 of file uri_test.c.

Referenced by uri_test_exec().

◆ uri_path_escaped

struct uri_test uri_path_escaped

static

Initial value:

= {
        "/hello%20world%3F",
        { .path = "/hello world?", .epath = "/hello%20world%3F" },
}

Path-only URI with escaped characters.

Definition at line 523 of file uri_test.c.

Referenced by uri_test_exec().

◆ uri_http_all

struct uri_test uri_http_all

static

Initial value:

= {
        "http://anon:password@example.com:3001/~foo/cgi-bin/foo.pl?a=b&c=d#bit",
        {
                .scheme = "http",
                .user = "anon",
                .password = "password",
                .host = "example.com",
                .port = "3001",
                .path = "/~foo/cgi-bin/foo.pl",
                .epath = "/~foo/cgi-bin/foo.pl",
                .equery = "a=b&c=d",
                .efragment = "bit",
        },
}

HTTP URI with all the trimmings.

Definition at line 529 of file uri_test.c.

Referenced by uri_test_exec().

◆ uri_http_escaped

struct uri_test uri_http_escaped

static

Initial value:

= {
        "https://test.ipxe.org/wtf%3F%0A?kind%23of/uri%20is#this%3F",
        {
                .scheme = "https",
                .host = "test.ipxe.org",
                .path = "/wtf?\n",
                .epath = "/wtf%3F%0A",
                .equery = "kind%23of/uri%20is",
                .efragment = "this%3F",
        },
}

HTTP URI with escaped characters.

Definition at line 545 of file uri_test.c.

Referenced by uri_test_exec().

◆ uri_http_escaped_improper

struct uri_test uri_http_escaped_improper

static

Initial value:

= {
        
        "https://test%2eipxe.org/wt%66%3f\n?kind%23of/uri is#this?",
        {
                .scheme = "https",
                .host = "test.ipxe.org",
                .path = "/wtf?\n",
                .epath = "/wt%66%3f\n",
                .equery = "kind%23of/uri is",
                .efragment = "this?",
        },
}

HTTP URI with improperly escaped characters.

Definition at line 558 of file uri_test.c.

Referenced by uri_test_exec().

◆ uri_ipv6

struct uri_test uri_ipv6

static

Initial value:

= {
        "http://[2001:ba8:0:1d4::6950:5845]/",
        {
                .scheme = "http",
                .host = "[2001:ba8:0:1d4::6950:5845]",
                .path = "/",
                .epath = "/",
        },
}

IPv6 URI.

Definition at line 576 of file uri_test.c.

Referenced by uri_test_exec().

◆ uri_ipv6_port

struct uri_test uri_ipv6_port

static

Initial value:

= {
        "http://[2001:ba8:0:1d4::6950:5845]:8001/boot",
        {
                .scheme = "http",
                .host = "[2001:ba8:0:1d4::6950:5845]",
                .port = "8001",
                .path = "/boot",
                .epath = "/boot",
        },
}

IPv6 URI with port.

Definition at line 587 of file uri_test.c.

Referenced by uri_test_exec().

◆ uri_ipv6_local

struct uri_test uri_ipv6_local

static

Initial value:

= {
        "http://[fe80::69ff:fe50:5845%25net0]/ipxe",
        {
                .scheme = "http",
                .host = "[fe80::69ff:fe50:5845%net0]",
                .path = "/ipxe",
                .epath = "/ipxe",
        },
}

IPv6 URI with link-local address.

Definition at line 599 of file uri_test.c.

Referenced by uri_test_exec().

◆ uri_ipv6_local_non_conforming

struct uri_test uri_ipv6_local_non_conforming

static

Initial value:

= {
        
        "http://[fe80::69ff:fe50:5845%net0]/ipxe",
        {
                .scheme = "http",
                .host = "[fe80::69ff:fe50:5845%net0]",
                .path = "/ipxe",
                .epath = "/ipxe",
        },
}

IPv6 URI with link-local address not conforming to RFC 6874.

Definition at line 610 of file uri_test.c.

Referenced by uri_test_exec().

◆ uri_iscsi

struct uri_test uri_iscsi

static

Initial value:

= {
        "iscsi:10.253.253.1::::iqn.2010-04.org.ipxe:rabbit",
        {
                .scheme = "iscsi",
                .opaque = "10.253.253.1::::iqn.2010-04.org.ipxe:rabbit",
        },
}

iSCSI URI

Definition at line 626 of file uri_test.c.

Referenced by uri_test_exec().

◆ uri_file_relative

struct uri_test uri_file_relative

static

Initial value:

= {
        "file:boot/script.ipxe",
        {
                .scheme = "file",
                .opaque = "boot/script.ipxe",
        },
}

File URI with relative (opaque) path.

Definition at line 635 of file uri_test.c.

Referenced by uri_test_exec().

◆ uri_file_absolute

struct uri_test uri_file_absolute

static

Initial value:

= {
        "file:/boot/script.ipxe",
        {
                .scheme = "file",
                .path = "/boot/script.ipxe",
                .epath = "/boot/script.ipxe",
        },
}

File URI with absolute path.

Definition at line 644 of file uri_test.c.

Referenced by uri_test_exec().

◆ uri_file_volume

struct uri_test uri_file_volume

static

Initial value:

= {
        "file://hpilo/boot/script.ipxe",
        {
                .scheme = "file",
                .host = "hpilo",
                .path = "/boot/script.ipxe",
                .epath = "/boot/script.ipxe",
        },
}

File URI with volume name.

Definition at line 654 of file uri_test.c.

Referenced by uri_test_exec().

◆ uri_colons

struct uri_test uri_colons

static

Initial value:

= {
        "/boot/52:54:00:12:34:56/boot.ipxe",
        {
                .path = "/boot/52:54:00:12:34:56/boot.ipxe",
                .epath = "/boot/52:54:00:12:34:56/boot.ipxe",
        },
}

Relative URI with colons in path.

Definition at line 665 of file uri_test.c.

Referenced by uri_test_exec().

◆ uri_explicit_port

struct uri_port_test uri_explicit_port

static

Initial value:

= {
        "http://192.168.0.1:8080/boot.php",
        80,
        8080,
}

URI with port number.

Definition at line 674 of file uri_test.c.

Referenced by uri_test_exec().

◆ uri_default_port

struct uri_port_test uri_default_port

static

Initial value:

= {
        "http://192.168.0.1/boot.php",
        80,
        80,
}

URI without port number.

Definition at line 681 of file uri_test.c.

Referenced by uri_test_exec().

◆ uri_simple_path

struct uri_resolve_test uri_simple_path

static

Initial value:

= {
        "/etc/passwd",
        "group",
        "/etc/group",
}

Simple path resolution test.

Definition at line 688 of file uri_test.c.

Referenced by uri_test_exec().

◆ uri_relative_path

struct uri_resolve_test uri_relative_path

static

Initial value:

= {
        "/var/lib/tftpboot/pxe/pxelinux.0",
        "./../ipxe/undionly.kpxe",
        "/var/lib/tftpboot/ipxe/undionly.kpxe",
}

Path resolution test with "." and ".." elements.

Definition at line 695 of file uri_test.c.

Referenced by uri_test_exec().

◆ uri_directory_path

struct uri_resolve_test uri_directory_path

static

Initial value:

= {
        "/test/cgi-bin.pl/boot.ipxe",
        "..",
        "/test/",
}

Path resolution test terminating with directory.

Definition at line 702 of file uri_test.c.

Referenced by uri_test_exec().

◆ uri_excessive_path

struct uri_resolve_test uri_excessive_path

static

Initial value:

= {
        "/var/lib/tftpboot/ipxe.pxe",
        "../../../../../../../foo",
        "/foo",
}

Path resolution test with excessive ".." elements.

Definition at line 709 of file uri_test.c.

Referenced by uri_test_exec().

◆ uri_absolute_path

struct uri_resolve_test uri_absolute_path

static

Initial value:

= {
        "/var/lib/tftpboot",
        "/etc/hostname",
        "/etc/hostname",
}

Path resolution test with absolute path.

Definition at line 716 of file uri_test.c.

Referenced by uri_test_exec().

◆ uri_relative

struct uri_resolve_test uri_relative

static

Initial value:

= {
        "http://boot.ipxe.org/demo/boot.php?vendor=10ec&device=8139",
        "initrd.img",
        "http://boot.ipxe.org/demo/initrd.img",
}

Relative URI resolution test.

Definition at line 723 of file uri_test.c.

Referenced by uri_test_exec().

◆ uri_absolute

struct uri_resolve_test uri_absolute

static

Initial value:

= {
        "http://boot.ipxe.org/demo/boot.php",
        "ftp://192.168.0.1/boot.ipxe",
        "ftp://192.168.0.1/boot.ipxe",
}

Absolute URI resolution test.

Definition at line 730 of file uri_test.c.

Referenced by uri_test_exec().

◆ uri_absolute_uri_path

struct uri_resolve_test uri_absolute_uri_path

static

Initial value:

= {
        "http://boot.ipxe.org/demo/boot.php#test",
        "/demo/vmlinuz",
        "http://boot.ipxe.org/demo/vmlinuz",
}

Absolute path URI resolution test.

Definition at line 737 of file uri_test.c.

Referenced by uri_test_exec().

◆ uri_query

struct uri_resolve_test uri_query

static

Initial value:

= {
        "http://10.253.253.1/test.pl?mac=02-00-69-50-58-45",
        "?mac=00-1f-16-bc-fe-2f",
        "http://10.253.253.1/test.pl?mac=00-1f-16-bc-fe-2f",
}

Query URI resolution test.

Definition at line 744 of file uri_test.c.

Referenced by uri_test_exec().

◆ uri_fragment

struct uri_resolve_test uri_fragment

static

Initial value:

= {
        "http://192.168.0.254/test#foo",
        "#bar",
        "http://192.168.0.254/test#bar",
}

Fragment URI resolution test.

Definition at line 751 of file uri_test.c.

Referenced by uri_test_exec().

◆ uri_self

struct uri_resolve_test uri_self

static

Initial value:

= {
        "http://192.168.0.1/path/to/me",
        "",
        "http://192.168.0.1/path/to/me",
}

Empty relative URI resolution test.

Definition at line 758 of file uri_test.c.

Referenced by uri_test_exec().

◆ uri_cwd

struct uri_resolve_test uri_cwd

static

Initial value:

= {
        "http://192.168.0.1/path/to/me",
        ".",
        "http://192.168.0.1/path/to/",
}

Current directory URI resolution test.

Definition at line 765 of file uri_test.c.

Referenced by uri_test_exec().

◆ uri_pxe_absolute

struct uri_pxe_test uri_pxe_absolute

static

Initial value:

= {
        {
                
                .sin = {
                        .sin_family = AF_INET,
                        .sin_addr = { .s_addr = htonl ( 0xc0a80003 ) },
                },
        },
        "http://not.a.tftp/uri",
        {
                .scheme = "http",
                .host = "not.a.tftp",
                .path = "/uri",
                .epath = "/uri",
        },
        "http://not.a.tftp/uri",
}

PXE URI with absolute URI.

Definition at line 772 of file uri_test.c.

Referenced by uri_test_exec().

◆ uri_pxe_absolute_path

struct uri_pxe_test uri_pxe_absolute_path

static

Initial value:

= {
        {
                
                .sin = {
                        .sin_family = AF_INET,
                        .sin_addr = { .s_addr = htonl ( 0xc0a80002 ) },
                },
        },
        "/absolute/path",
        {
                .scheme = "tftp",
                .host = "192.168.0.2",
                .path = "//absolute/path",
                .epath = "//absolute/path",
        },
        "tftp://192.168.0.2//absolute/path",
}

PXE URI with absolute path.

Definition at line 791 of file uri_test.c.

Referenced by uri_test_exec().

◆ uri_pxe_relative_path

struct uri_pxe_test uri_pxe_relative_path

static

Initial value:

= {
        {
                
                .sin = {
                        .sin_family = AF_INET,
                        .sin_addr = { .s_addr = htonl ( 0xc0a80003 ) },
                },
        },
        "relative/path",
        {
                .scheme = "tftp",
                .host = "192.168.0.3",
                .path = "/relative/path",
                .epath = "/relative/path",
        },
        "tftp://192.168.0.3/relative/path",
}

PXE URI with relative path.

Definition at line 810 of file uri_test.c.

Referenced by uri_test_exec().

◆ uri_pxe_icky

struct uri_pxe_test uri_pxe_icky

static

Initial value:

= {
        {
                
                .sin = {
                        .sin_family = AF_INET,
                        .sin_addr = { .s_addr = htonl ( 0x0a000006 ) },
                },
        },
        "C:\\tftpboot\\icky#path",
        {
                .scheme = "tftp",
                .host = "10.0.0.6",
                .path = "/C:\\tftpboot\\icky#path",
                .epath = "/C:\\tftpboot\\icky#path",
        },
        "tftp://10.0.0.6/C:\\tftpboot\\icky#path",
}

PXE URI with path containing special characters.

Definition at line 829 of file uri_test.c.

Referenced by uri_test_exec().

◆ uri_pxe_port

struct uri_pxe_test uri_pxe_port

static

Initial value:

= {
        {
                
                .sin = {
                        .sin_family = AF_INET,
                        .sin_addr = { .s_addr = htonl ( 0xc0a80001 ) },
                        .sin_port = htons ( 4069 ),
                },
        },
        "/another/path",
        {
                .scheme = "tftp",
                .host = "192.168.0.1",
                .port = "4069",
                .path = "//another/path",
                .epath = "//another/path",
        },
        "tftp://192.168.0.1:4069//another/path",
}

PXE URI with custom port.

Definition at line 848 of file uri_test.c.

Referenced by uri_test_exec().

◆ uri_churi

struct uri_churi_test uri_churi[]

static

Initial value:

= {
        {
                "http://boot.ipxe.org/demo/boot.php",
                "http://boot.ipxe.org/demo/boot.php",
        },
        {
                "?vendor=10ec&device=8139",
                "http://boot.ipxe.org/demo/boot.php?vendor=10ec&device=8139",
        },
        {
                "fedora/fedora.ipxe",
                "http://boot.ipxe.org/demo/fedora/fedora.ipxe",
        },
        {
                "vmlinuz",
                "http://boot.ipxe.org/demo/fedora/vmlinuz",
        },
        {
                "http://local/boot/initrd.img",
                "http://local/boot/initrd.img",
        },
        {
                "modules/8139too.ko",
                "http://local/boot/modules/8139too.ko",
        },
        {
                NULL,
                NULL,
        }
}

Current working URI test.

Definition at line 869 of file uri_test.c.

Referenced by uri_test_exec().

◆ uri_params_list

struct uri_params_test_list uri_params_list[]

static

Initial value:

= {
        {
                "vendor",
                "10ec",
                PARAMETER_FORM,
        },
        {
                "device",
                "8139",
                PARAMETER_FORM,
        },
        {
                "uuid",
                "f59fac00-758f-498f-9fe5-87d790045d94",
                PARAMETER_HEADER,
        },
        {
                NULL,
                NULL,
                0,
        }
}

Request parameter URI test list.

Definition at line 901 of file uri_test.c.

◆ uri_params

struct uri_params_test uri_params

static

Initial value:

= {
        "http://boot.ipxe.org/demo/boot.php##params",
        {
                .scheme = "http",
                .host = "boot.ipxe.org",
                .path = "/demo/boot.php",
                .epath = "/demo/boot.php",
        },
        NULL,
        uri_params_list,
}

Request parameter URI test.

Definition at line 925 of file uri_test.c.

Referenced by uri_test_exec().

◆ uri_named_params_list

struct uri_params_test_list uri_named_params_list[]

static

Initial value:

= {
        {
                "mac",
                "00:1e:65:80:d3:b6",
                PARAMETER_FORM,
        },
        {
                "serial",
                "LXTQ20Z1139322762F2000",
                PARAMETER_FORM,
        },
        {
                NULL,
                NULL,
                0,
        }
}

Named request parameter URI test list.

Definition at line 938 of file uri_test.c.

◆ uri_named_params

struct uri_params_test uri_named_params

static

Initial value:

= {
        "http://192.168.100.4:3001/register##params=foo",
        {
                .scheme = "http",
                .host = "192.168.100.4",
                .port = "3001",
                .path = "/register",
                .epath = "/register",
        },
        "foo",
        uri_named_params_list,
}

Named request parameter URI test.

Definition at line 957 of file uri_test.c.

Referenced by uri_test_exec().

◆ __self_test

struct self_test uri_test __self_test

Initial value:

= {
        .name = "uri",
        .exec = uri_test_exec,
}

URI self-test.

Definition at line 1032 of file uri_test.c.

Data Structures

Macros

Functions

Variables

Detailed Description

Macro Definition Documentation

◆ uri_ok

◆ uri_parse_ok

◆ uri_format_ok

◆ uri_dup_ok

◆ uri_parse_format_dup_ok

◆ uri_port_ok

◆ uri_resolve_ok

◆ uri_resolve_path_ok

◆ uri_pxe_ok

◆ uri_churi_ok

◆ uri_params_list_ok

◆ uri_params_ok

Function Documentation

◆ FILE_LICENCE()

◆ uristrcmp()

◆ uri_okx()

◆ uri_parse_okx()

◆ uri_format_okx()

◆ uri_dup_okx()

◆ uri_parse_format_dup_okx()

◆ uri_port_okx()

◆ uri_resolve_okx()

◆ uri_resolve_path_okx()

◆ uri_pxe_okx()

◆ uri_churi_okx()

◆ uri_params_list_okx()

◆ uri_params_okx()

◆ uri_test_exec()

Variable Documentation

◆ uri_empty

◆ uri_boot_ipxe_org

◆ uri_mailto

◆ uri_host

◆ uri_path

◆ uri_path_escaped

◆ uri_http_all

◆ uri_http_escaped

◆ uri_http_escaped_improper

◆ uri_ipv6

◆ uri_ipv6_port

◆ uri_ipv6_local

◆ uri_ipv6_local_non_conforming

◆ uri_iscsi

◆ uri_file_relative

◆ uri_file_absolute

◆ uri_file_volume

◆ uri_colons

◆ uri_explicit_port

◆ uri_default_port

◆ uri_simple_path

◆ uri_relative_path

◆ uri_directory_path

◆ uri_excessive_path

◆ uri_absolute_path

◆ uri_relative

◆ uri_absolute

◆ uri_absolute_uri_path

◆ uri_query

◆ uri_fragment

◆ uri_self

◆ uri_cwd

◆ uri_pxe_absolute

◆ uri_pxe_absolute_path

◆ uri_pxe_relative_path

◆ uri_pxe_icky

◆ uri_pxe_port

◆ uri_churi

◆ uri_params_list

◆ uri_params

◆ uri_named_params_list

◆ uri_named_params

◆ __self_test