1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
|
#ifndef _GPXE_URI_H
#define _GPXE_URI_H
/** @file
*
* Uniform Resource Identifiers
*
*/
FILE_LICENCE ( GPL2_OR_LATER );
#include <stddef.h>
#include <stdlib.h>
#include <gpxe/refcnt.h>
/** A Uniform Resource Identifier
*
* Terminology for this data structure is as per uri(7), except that
* "path" is defined to include the leading '/' for an absolute path.
*
* Note that all fields within a URI are optional and may be NULL.
*
* Some examples are probably helpful:
*
* http://www.etherboot.org/wiki :
*
* scheme = "http", host = "www.etherboot.org", path = "/wiki"
*
* /var/lib/tftpboot :
*
* path = "/var/lib/tftpboot"
*
* mailto:bob@nowhere.com :
*
* scheme = "mailto", opaque = "bob@nowhere.com"
*
* ftp://joe:secret@insecure.org:8081/hidden/path/to?what=is#this
*
* scheme = "ftp", user = "joe", password = "secret",
* host = "insecure.org", port = "8081", path = "/hidden/path/to",
* query = "what=is", fragment = "this"
*/
struct uri {
/** Reference count */
struct refcnt refcnt;
/** Scheme */
const char *scheme;
/** Opaque part */
const char *opaque;
/** User name */
const char *user;
/** Password */
const char *password;
/** Host name */
const char *host;
/** Port number */
const char *port;
/** Path */
const char *path;
/** Query */
const char *query;
/** Fragment */
const char *fragment;
};
/**
* URI is an absolute URI
*
* @v uri URI
* @ret is_absolute URI is absolute
*
* An absolute URI begins with a scheme, e.g. "http:" or "mailto:".
* Note that this is a separate concept from a URI with an absolute
* path.
*/
static inline int uri_is_absolute ( struct uri *uri ) {
return ( uri->scheme != NULL );
}
/**
* URI has an absolute path
*
* @v uri URI
* @ret has_absolute_path URI has an absolute path
*
* An absolute path begins with a '/'. Note that this is a separate
* concept from an absolute URI. Note also that a URI may not have a
* path at all.
*/
static inline int uri_has_absolute_path ( struct uri *uri ) {
return ( uri->path && ( uri->path[0] == '/' ) );
}
/**
* URI has a relative path
*
* @v uri URI
* @ret has_relative_path URI has a relative path
*
* A relative path begins with something other than a '/'. Note that
* this is a separate concept from a relative URI. Note also that a
* URI may not have a path at all.
*/
static inline int uri_has_relative_path ( struct uri *uri ) {
return ( uri->path && ( uri->path[0] != '/' ) );
}
/**
* Increment URI reference count
*
* @v uri URI, or NULL
* @ret uri URI as passed in
*/
static inline __attribute__ (( always_inline )) struct uri *
uri_get ( struct uri *uri ) {
ref_get ( &uri->refcnt );
return uri;
}
/**
* Decrement URI reference count
*
* @v uri URI, or NULL
*/
static inline __attribute__ (( always_inline )) void
uri_put ( struct uri *uri ) {
ref_put ( &uri->refcnt );
}
extern struct uri *cwuri;
extern struct uri * parse_uri ( const char *uri_string );
extern unsigned int uri_port ( struct uri *uri, unsigned int default_port );
extern int unparse_uri ( char *buf, size_t size, struct uri *uri );
extern struct uri * uri_dup ( struct uri *uri );
extern char * resolve_path ( const char *base_path,
const char *relative_path );
extern struct uri * resolve_uri ( struct uri *base_uri,
struct uri *relative_uri );
extern void churi ( struct uri *uri );
extern size_t uri_encode ( const char *raw_string, char *buf, size_t len );
extern size_t uri_decode ( const char *encoded_string, char *buf, size_t len );
#endif /* _GPXE_URI_H */
|
