blob: 728de2213885355353c8acada629a9ac19844acb (
plain)
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
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
|
.Dd December 13, 2024
.Dt LIBHTTPC_HEADER 3
.Os
.
.Sh NAME
.Nm LibHTTPC_Header
.Nd HTTP header
.
.Sh SYNOPSIS
.In libhttpc/libhttpc.h
.Ft "const char *"
.Fn LibHTTPC_dumpHeader "enum LibHTTPC_HeaderType header"
.Ft "enum LibHTTPC_HeaderType"
.Fn LibHTTPC_loadHeader "const char *header"
.
.Sh DESCRIPTION
HTTP/1.1
comes with
some headers.
.Xr libhttpc 3
provides
QoL functions
for converting them
between
user-readable strings
and machine-readable enum.
.
.Sh HEADERS
Headers are declared
as follows:
.Bd -literal -offset indent
struct LibHTTPC_Header
{
const char *name;
const char *value;
};
.Ed
.
.Sh HEADER TYPE
In addition
to the structure,
.Xr libhttpc 3
provides
a list
of HTTP/1.1 headers
as enum.
.
.Ss General headers
.Bl -tag
.It Dv LibHTTPC_Header_CACHE_CONTROL
Cache-Control
.It Dv LibHTTPC_Header_CONNECTION
Connection
.It Dv LibHTTPC_Header_DATE
Date
.It Dv LibHTTPC_Header_PRAGMA
Pragma
.It Dv LibHTTPC_Header_TRAILER
Trailer
.It Dv LibHTTPC_Header_TRANSFER_ENCODING
Transfer-Encoding
.It Dv LibHTTPC_Header_UPGRADE
Upgrade
.It Dv LibHTTPC_Header_VIA
Via
.It Dv LibHTTPC_Header_WARNING
Warning
.El
.
.Ss Request headers
.Bl -tag
.It Dv LibHTTPC_Header_ACCEPT
Accept
.It Dv LibHTTPC_Header_ACCEPT_CHARSET
Accept-Charset
.It Dv LibHTTPC_Header_ACCEPT_ENCODING
Accept-Encoding
.It Dv LibHTTPC_Header_ACCEPT_LANGUAGE
Accept-Language
.It Dv LibHTTPC_Header_AUTHORIZATION
Authorization
.It Dv LibHTTPC_Header_EXPECT
Expect
.It Dv LibHTTPC_Header_FROM
From
.It Dv LibHTTPC_Header_HOST
Host
.It Dv LibHTTPC_Header_IF_MATCH
If-Match
.It Dv LibHTTPC_Header_IF_MODIFIED_SINCE
If-Modified-Since
.It Dv LibHTTPC_Header_IF_NONE_MATCH
If-None-Match
.It Dv LibHTTPC_Header_IF_RANGE
If-Range
.It Dv LibHTTPC_Header_IF_UNMODIFIED_SINCE
If-Unmodified-Since
.It Dv LibHTTPC_Header_MAX_FORWARDS
Max-Forwards
.It Dv LibHTTPC_Header_PROXY_AUTHORIZATION
Proxy-Authorization
.It Dv LibHTTPC_Header_RANGE
Range
.It Dv LibHTTPC_Header_REFERER
Referer
.It Dv LibHTTPC_Header_TE
TE
.It Dv LibHTTPC_Header_USER_AGENT
User-Agent
.El
.Ss Response headers
.Bl -tag
.It Dv LibHTTPC_Header_ACCEPT_RANGES
Accept-Ranges
.It Dv LibHTTPC_Header_AGE
Age
.It Dv LibHTTPC_Header_ETAG
ETag
.It Dv LibHTTPC_Header_LOCATION
Location
.It Dv LibHTTPC_Header_PROXY_AUTHENTICATE
Proxy-Authorization
.It Dv LibHTTPC_Header_RETRY_AFTER
Retry-After
.It Dv ibHTTPC_Header_SERVER
Server
.It Dv ibHTTPC_Header_VARY
Vary
.It Dv ibHTTPC_Header_WWW_AUTHENTICATE
WWW-Authenticate
.El
.
.Ss Entity headers
.Bl -tag
.It Dv LibHTTPC_Header_ALLOW
Allow
.It Dv LibHTTPC_Header_CONTENT_ENCODING
Content-Encoding
.It Dv LibHTTPC_Header_CONTENT_LANGUAGE
Content-Language
.It Dv LibHTTPC_Header_CONTENT_LENGTH
Content-Length
.It Dv LibHTTPC_Header_CONTENT_LOCATION
Content-Location
.It Dv LibHTTPC_Header_CONTENT_MD5
Content-MD5
.It Dv LibHTTPC_Header_CONTENT_RANGE
Content-Range
.It Dv LibHTTPC_Header_CONTENT_TYPE
Content-Type
.It Dv LibHTTPC_Header_EXPIRES
Expires
.It Dv LibHTTPC_Header_LAST_MODIFIED
Last-Modified
.El
.Ss Other headers
Also,
there's
a special
.Dv LibHTTPC_Header_EXTENSION_HEADER
header type
that means
user-defined
header
(as of HTTP/1.1).
.
.Sh SEE ALSO
.Xr libhttpc 3
.
.Sh AUTHORS
.An Nakidai Perumenei Aq Mt nakidai@disroot.org
|