51Degrees Device Detection C/C++  4.4

A device detection library that is used natively or by 51Degrees products


1 /* *********************************************************************
2  * This Original Work is copyright of 51 Degrees Mobile Experts Limited.
3  * Copyright 2022 51 Degrees Mobile Experts Limited, Davidson House,
4  * Forbury Square, Reading, Berkshire, United Kingdom RG1 3EU.
5  *
6  * This Original Work is licensed under the European Union Public Licence
7  * (EUPL) 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  * ********************************************************************* */
147 /* Define NDEBUG if needed, to ensure asserts are disabled in release builds */
148 #if !defined(DEBUG) && !defined(_DEBUG) && !defined(NDEBUG)
149 #define NDEBUG
150 #endif
152 #include <limits.h>
153 #include <stdio.h>
154 #include <errno.h>
155 #include <stdint.h>
156 #include <stdbool.h>
157 #ifdef _MSC_VER
158 #pragma warning (push)
159 #pragma warning (disable: 5105)
160 #include <windows.h>
161 #pragma warning (default: 5105)
162 #pragma warning (pop)
163 #include <direct.h>
164 #include <tchar.h>
165 #else
166 #include <dirent.h>
167 #include <sys/stat.h>
168 #endif
169 #include <time.h>
170 #include <assert.h>
171 #include <limits.h>
172 #include <time.h>
173 #include "data.h"
174 #include "exceptions.h"
175 #include "status.h"
176 #include "memory.h"
177 #include "pool.h"
178 #include "threading.h"
179 #include "common.h"
184 #ifdef _MSC_FULL_VER
185 #define GET_CURRENT_DIR _getcwd
186 #pragma warning (push)
187 #pragma warning (disable: 5105)
188 #include <windows.h>
189 #pragma warning (default: 5105)
190 #pragma warning (pop)
191 #include <direct.h>
192 #include <tchar.h>
193 #else
194 #define GET_CURRENT_DIR getcwd
195 #include <unistd.h>
196 #include <dirent.h>
197 #include <sys/stat.h>
198 #endif
210 #ifdef _MSC_FULL_VER
212 #else
214 #endif
219 typedef union fiftyone_degrees_file_handle_t {
220  FILE *file;
227  typedef struct fiftyone_degrees_file_pool_t {
229  long length;
247  const char* fileName,
248  FILE** handle);
258  const char* fileName,
259  const void *data,
260  const size_t length);
272  const char *source,
273  const char *destination);
282  const char *fileName);
291  const char *pathName);
309  const char *dataFolderName,
310  const char *fileName,
311  char *destination,
312  size_t size);
331  const char *masterFile,
332  const char **paths,
333  int count,
334  long bytesToCompare,
335  const char *destination);
355  const char *masterFileName,
356  const char **paths,
357  int count,
358  long bytesToCompare);
369  const char* masterFileName,
370  char* destination,
371  size_t nameStart,
372  size_t length);
388  const char* masterFile,
389  const char** paths,
390  int count,
391  char* destination,
392  size_t length);
408  const char *masterFile,
409  const char **paths,
410  int count,
411  const char *destination);
425  fiftyoneDegreesFilePool *filePool,
426  const char *fileName,
427  uint16_t concurrency,
428  fiftyoneDegreesException *exception);
441  fiftyoneDegreesFilePool *filePool,
442  fiftyoneDegreesException *exception);
450  fiftyoneDegreesFileHandle* handle);
458 EXTERNAL long fiftyoneDegreesFileGetSize(const char *fileName);
469  const char *fileName,
483 EXTERNAL const char* fiftyoneDegreesFileGetFileName(const char *filePath);
488 #endif
const char * fiftyoneDegreesFileGetFileName(const char *filePath)
Gets the last, file name, segment of the full file path.
bool fiftyoneDegreesFileGetExistingTempFile(const char *masterFile, const char **paths, int count, long bytesToCompare, const char *destination)
Gets the path to a temporary file which is an exact copy of the master file if one exists.
fiftyoneDegreesStatusCode fiftyoneDegreesFilePoolInit(fiftyoneDegreesFilePool *filePool, const char *fileName, uint16_t concurrency, fiftyoneDegreesException *exception)
Initialises the pool with a stack of open read only file handles all associated with the file name.
Status returned from the initialisation of a resource.
Definition: status.h:77
Pool item node in the stack of items.
Definition: pool.h:178
fiftyoneDegreesStatusCode fiftyoneDegreesFileAddTempFileName(const char *masterFileName, char *destination, size_t nameStart, size_t length)
Create a temporary file name and add it to the destination.
fiftyoneDegreesStatusCode fiftyoneDegreesFileGetPath(const char *dataFolderName, const char *fileName, char *destination, size_t size)
Iterates up the folders from the current working directory until a file in the sub folder dataFolderN...
long fiftyoneDegreesFileGetSize(const char *fileName)
Returns the size of a file in bytes, or -1 if the file does not exist or cannot be accessed.
void fiftyoneDegreesFileHandleRelease(fiftyoneDegreesFileHandle *handle)
Returns a handle previously retrieved via fiftyoneDegreesFileHandleGet back to the pool.
Used to read data from memory in a similar manner to a file handle.
Definition: memory.h:53
FILE * file
Open read handle to the source data file.
Definition: file.h:220
fiftyoneDegreesPoolItem item
The pool item with the resource.
Definition: file.h:221
void fiftyoneDegreesFilePoolReset(fiftyoneDegreesFilePool *filePool)
Resets the pool without releasing any resources.
fiftyoneDegreesStatusCode fiftyoneDegreesFileOpen(const char *fileName, FILE **handle)
Opens the file path provided placing the file handle in the handle parameter.
fiftyoneDegreesPool pool
The pool of file handles.
Definition: file.h:228
fiftyoneDegreesFileHandle * fiftyoneDegreesFileHandleGet(fiftyoneDegreesFilePool *filePool, fiftyoneDegreesException *exception)
Retrieves a read only open file handle from the pool.
Pool of resources stored as items in a stack.
Definition: pool.h:198
fiftyoneDegreesStatusCode fiftyoneDegreesFileNewTempFile(const char *masterFile, const char **paths, int count, char *destination, size_t length)
Create a temporary file containing a copy of the master file using the first writable path in the lis...
fiftyoneDegreesStatusCode fiftyoneDegreesFileWrite(const char *fileName, const void *data, const size_t length)
Writes binary data to the file path provided, closing the file once finished.
void fiftyoneDegreesFilePoolRelease(fiftyoneDegreesFilePool *pool)
Releases the file handles contained in the pool and frees any internal memory used by the pool.
File handle node in the stack of handles.
Definition: file.h:219
fiftyoneDegreesStatusCode fiftyoneDegreesFileReadToByteArray(const char *fileName, fiftyoneDegreesMemoryReader *reader)
Reads the contents of a file into memory.
fiftyoneDegreesStatusCode fiftyoneDegreesFileCreateDirectory(const char *pathName)
Creates a directory with the specified path, and returns the result of the operation.
long length
Length of the file in bytes.
Definition: file.h:229
Structure used to represent a 51Degrees exception and passed into methods that might generate excepti...
Definition: exceptions.h:111
fiftyoneDegreesStatusCode fiftyoneDegreesFileDelete(const char *fileName)
Delete a file from the file system.
Stack of handles used to read data from a single source file.
Definition: file.h:227
fiftyoneDegreesStatusCode fiftyoneDegreesFileCopy(const char *source, const char *destination)
Copy a file from one location to another.
DEPRECATED fiftyoneDegreesStatusCode fiftyoneDegreesFileCreateTempFile(const char *masterFile, const char **paths, int count, const char *destination)
[DEPRECATED - Use fiftyoneDegreesFileNewTempFile instead] Create a temporary file containing a copy o...
int fiftyoneDegreesFileDeleteUnusedTempFiles(const char *masterFileName, const char **paths, int count, long bytesToCompare)
Finds all the temporary files which is an exact copy of the master file if any exist.