1 /* *********************************************************************

2 * This Original Work is copyright of 51 Degrees Mobile Experts Limited.

4 * Caversham, Reading, Berkshire, United Kingdom RG4 7BY.

5 *

6 * This Original Work is licensed under the European Union Public Licence (EUPL)

7 * v.1.2 and is subject to its terms as set out below.

8 *

9 * If a copy of the EUPL was not distributed with this file, You can obtain

10 * one at https://opensource.org/licenses/EUPL-1.2.

11 *

12 * The 'Compatible Licences' set out in the Appendix to the EUPL (as may be

13 * amended by the European Commission) shall be deemed incompatible for

14 * the purposes of the Work and the provisions of the compatibility

15 * clause in Article 5 of the EUPL shall not apply.

16 *

17 * If using the Work as, or as part of, a network application, by

18 * including the attribution notice(s) required under Article 5 of the EUPL

19 * in the end user terms of the application under an appropriate heading,

20 * such notice(s) shall fulfill the requirements of that article.

21 * ********************************************************************* */

22

23 #ifndef FIFTYONE_DEGREES_HEADERS_H_INCLUDED

24 #define FIFTYONE_DEGREES_HEADERS_H_INCLUDED

25

91 #include <stdbool.h>

92 #include <stdint.h>

93 #include <stdlib.h>

94 #ifdef _MSC_FULL_VER

95 #include <string.h>

96 #else

97 #include <strings.h>

98 #define _stricmp strcasecmp

99 #define _strnicmp strncasecmp

100 #endif

101 #include "list.h"

102 #include "evidence.h"

103 #include "array.h"

104

105 #ifdef __cplusplus

106 #define EXTERNAL extern "C"

107 #else

108 #define EXTERNAL

109 #endif

110

114 typedef struct fiftyone_degrees_header_t {

115 fiftyoneDegreesCollectionItem name;

118 uint32_t* requestHeaders;

120 uint32_t requestHeaderCount;

122 uint32_t uniqueId;

124 } fiftyoneDegreesHeader;

125

126 #define FIFTYONE_DEGREES_HEADERS_MEMBERS \

127 bool expectUpperPrefixedHeaders; \

130 uint32_t* pseudoHeaders; \

131 uint32_t pseudoHeadersCount;

133 FIFTYONE_DEGREES_ARRAY_TYPE(

134 fiftyoneDegreesHeader,

135 FIFTYONE_DEGREES_HEADERS_MEMBERS);

136

140 typedef fiftyoneDegreesHeaderArray fiftyoneDegreesHeaders;

141

150 typedef long(*fiftyoneDegreesHeadersGetMethod)(

151 void *state,

152 uint32_t index,

153 fiftyoneDegreesCollectionItem *nameItem);

154

161 EXTERNAL size_t fiftyoneDegreesHeadersSize(int count);

162

168 EXTERNAL bool fiftyoneDegreesHeadersIsPseudo(const char *headerName);

169

183 EXTERNAL fiftyoneDegreesHeaders* fiftyoneDegreesHeadersCreate(

184 bool useUpperPrefixedHeaders,

185 void *state,

186 fiftyoneDegreesHeadersGetMethod get);

187

195 EXTERNAL int fiftyoneDegreesHeaderGetIndex(

196 fiftyoneDegreesHeaders *headers,

197 const char* httpHeaderName,

198 size_t length);

199

210 EXTERNAL fiftyoneDegreesHeader* fiftyoneDegreesHeadersGetHeaderFromUniqueId(

211 fiftyoneDegreesHeaders *headers,

212 uint32_t uniqueId);

213

219 EXTERNAL void fiftyoneDegreesHeadersFree(fiftyoneDegreesHeaders *headers);

220

227 EXTERNAL bool fiftyoneDegreesHeadersIsHttp(

228 void *state,

229 fiftyoneDegreesEvidenceKeyValuePair *pair);

230

235 #endif

fiftyoneDegreesHeadersCreate

fiftyoneDegreesHeaders * fiftyoneDegreesHeadersCreate(bool useUpperPrefixedHeaders, void *state, fiftyoneDegreesHeadersGetMethod get)

Creates a new headers instance configured with the unique HTTP names needed from evidence.

fiftyoneDegreesHeadersSize

size_t fiftyoneDegreesHeadersSize(int count)

Returns the number of bytes that will be allocated for a headers structure created using the fiftyone...

FIFTYONE_DEGREES_HEADERS_MEMBERS

#define FIFTYONE_DEGREES_HEADERS_MEMBERS

Count number of pseudo headers.

Definition: headers.h:126

fiftyoneDegreesHeadersFree

void fiftyoneDegreesHeadersFree(fiftyoneDegreesHeaders *headers)

Frees the memory allocated by the fiftyoneDegreesHeadersCreate method.

fiftyoneDegreesCollectionItem

Used to store a handle to the underlying item that could be used to release the item when it's finish...

Definition: collection.h:309

fiftyoneDegreesHeader::requestHeaders

uint32_t * requestHeaders

Indices for unique headers that form this pseudo-header.

Definition: headers.h:118

fiftyoneDegreesHeadersGetHeaderFromUniqueId

fiftyoneDegreesHeader * fiftyoneDegreesHeadersGetHeaderFromUniqueId(fiftyoneDegreesHeaders *headers, uint32_t uniqueId)

Gets a pointer to the header in the headers structure with a unique id matching the one provided.

fiftyoneDegreesEvidenceKeyValuePair

Evidence key value pair structure which combines the prefix, key and value.

Definition: evidence.h:165

fiftyoneDegreesHeader::requestHeaderCount

uint32_t requestHeaderCount

Number of request headers.

Definition: headers.h:120

fiftyoneDegreesHeaderArray

Array of items of type fiftyoneDegreesHeader used to easily access and track the size of the array.

Definition: headers.h:135

fiftyoneDegreesHeader

Header structure containing the name and unique id.

Definition: headers.h:114

fiftyoneDegreesHeadersIsHttp

bool fiftyoneDegreesHeadersIsHttp(void *state, fiftyoneDegreesEvidenceKeyValuePair *pair)

Determines if the key of an evidence pair is an HTTP header.

fiftyoneDegreesHeaders

fiftyoneDegreesHeaderArray fiftyoneDegreesHeaders

Array of headers used to easily access and track the size of the array.

Definition: headers.h:135

fiftyoneDegreesHeaderGetIndex

int fiftyoneDegreesHeaderGetIndex(fiftyoneDegreesHeaders *headers, const char *httpHeaderName, size_t length)

Provides the integer index of the HTTP header name.

fiftyoneDegreesHeader::uniqueId

uint32_t uniqueId

Id which uniquely identifies the header within the data set.

Definition: headers.h:122

fiftyoneDegreesHeadersGetMethod

long(* fiftyoneDegreesHeadersGetMethod)(void *state, uint32_t index, fiftyoneDegreesCollectionItem *nameItem)

Gets the unique id and name of the header at the requested index.

Definition: headers.h:150

fiftyoneDegreesHeader::name

fiftyoneDegreesCollectionItem name

Collection item containing the name of the header as a fiftyoneDegreesString.

Definition: headers.h:115

fiftyoneDegreesHeadersIsPseudo

bool fiftyoneDegreesHeadersIsPseudo(const char *headerName)

Check if a header is a pseudo header.

51Degrees Device Detection C/C++ 4.2Newer Version 4.4

headers.h