18d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/* 28d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * OS specific functions 38d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Copyright (c) 2005-2009, Jouni Malinen <j@w1.fi> 48d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 5c5ec7f57ead87efa365800228aa0b09a12d9e6c4Dmitry Shmidt * This software may be distributed under the terms of the BSD license. 6c5ec7f57ead87efa365800228aa0b09a12d9e6c4Dmitry Shmidt * See README for more details. 78d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 88d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 98d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#ifndef OS_H 108d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define OS_H 118d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 128d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidttypedef long os_time_t; 138d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 148d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 158d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * os_sleep - Sleep (sec, usec) 168d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @sec: Number of seconds to sleep 178d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @usec: Number of microseconds to sleep 188d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 198d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtvoid os_sleep(os_time_t sec, os_time_t usec); 208d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 218d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtstruct os_time { 228d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt os_time_t sec; 238d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt os_time_t usec; 248d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt}; 258d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 268d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 278d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * os_get_time - Get current time (sec, usec) 288d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @t: Pointer to buffer for the time 298d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 308d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 318d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtint os_get_time(struct os_time *t); 328d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 338d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 348d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/* Helper macros for handling struct os_time */ 358d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 368d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define os_time_before(a, b) \ 378d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt ((a)->sec < (b)->sec || \ 388d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt ((a)->sec == (b)->sec && (a)->usec < (b)->usec)) 398d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 408d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define os_time_sub(a, b, res) do { \ 418d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt (res)->sec = (a)->sec - (b)->sec; \ 428d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt (res)->usec = (a)->usec - (b)->usec; \ 438d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt if ((res)->usec < 0) { \ 448d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt (res)->sec--; \ 458d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt (res)->usec += 1000000; \ 468d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt } \ 478d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt} while (0) 488d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 498d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 508d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * os_mktime - Convert broken-down time into seconds since 1970-01-01 518d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @year: Four digit year 528d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @month: Month (1 .. 12) 538d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @day: Day of month (1 .. 31) 548d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @hour: Hour (0 .. 23) 558d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @min: Minute (0 .. 59) 568d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @sec: Second (0 .. 60) 578d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @t: Buffer for returning calendar time representation (seconds since 588d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 1970-01-01 00:00:00) 598d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 608d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 618d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Note: The result is in seconds from Epoch, i.e., in UTC, not in local time 628d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * which is used by POSIX mktime(). 638d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 648d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtint os_mktime(int year, int month, int day, int hour, int min, int sec, 658d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt os_time_t *t); 668d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 671f69aa52ea2e0a73ac502565df8c666ee49cab6aDmitry Shmidtstruct os_tm { 681f69aa52ea2e0a73ac502565df8c666ee49cab6aDmitry Shmidt int sec; /* 0..59 or 60 for leap seconds */ 691f69aa52ea2e0a73ac502565df8c666ee49cab6aDmitry Shmidt int min; /* 0..59 */ 701f69aa52ea2e0a73ac502565df8c666ee49cab6aDmitry Shmidt int hour; /* 0..23 */ 711f69aa52ea2e0a73ac502565df8c666ee49cab6aDmitry Shmidt int day; /* 1..31 */ 721f69aa52ea2e0a73ac502565df8c666ee49cab6aDmitry Shmidt int month; /* 1..12 */ 731f69aa52ea2e0a73ac502565df8c666ee49cab6aDmitry Shmidt int year; /* Four digit year */ 741f69aa52ea2e0a73ac502565df8c666ee49cab6aDmitry Shmidt}; 751f69aa52ea2e0a73ac502565df8c666ee49cab6aDmitry Shmidt 761f69aa52ea2e0a73ac502565df8c666ee49cab6aDmitry Shmidtint os_gmtime(os_time_t t, struct os_tm *tm); 778d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 788d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 798d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * os_daemonize - Run in the background (detach from the controlling terminal) 808d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @pid_file: File name to write the process ID to or %NULL to skip this 818d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 828d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 838d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtint os_daemonize(const char *pid_file); 848d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 858d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 868d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * os_daemonize_terminate - Stop running in the background (remove pid file) 878d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @pid_file: File name to write the process ID to or %NULL to skip this 888d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 898d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtvoid os_daemonize_terminate(const char *pid_file); 908d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 918d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 928d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * os_get_random - Get cryptographically strong pseudo random data 938d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @buf: Buffer for pseudo random data 948d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @len: Length of the buffer 958d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 968d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 978d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtint os_get_random(unsigned char *buf, size_t len); 988d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 998d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 1008d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * os_random - Get pseudo random value (not necessarily very strong) 1018d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: Pseudo random value 1028d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 1038d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtunsigned long os_random(void); 1048d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 1058d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 1068d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * os_rel2abs_path - Get an absolute path for a file 1078d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @rel_path: Relative path to a file 1088d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: Absolute path for the file or %NULL on failure 1098d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 1108d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function tries to convert a relative path of a file to an absolute path 1118d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * in order for the file to be found even if current working directory has 1128d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * changed. The returned value is allocated and caller is responsible for 1138d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * freeing it. It is acceptable to just return the same path in an allocated 1148d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * buffer, e.g., return strdup(rel_path). This function is only used to find 1158d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * configuration files when os_daemonize() may have changed the current working 1168d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * directory and relative path would be pointing to a different location. 1178d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 1188d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtchar * os_rel2abs_path(const char *rel_path); 1198d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 1208d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 1218d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * os_program_init - Program initialization (called at start) 1228d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on failure 1238d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 1248d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function is called when a programs starts. If there are any OS specific 1258d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * processing that is needed, it can be placed here. It is also acceptable to 1268d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * just return 0 if not special processing is needed. 1278d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 1288d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtint os_program_init(void); 1298d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 1308d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 1318d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * os_program_deinit - Program deinitialization (called just before exit) 1328d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 1338d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function is called just before a program exists. If there are any OS 1348d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * specific processing, e.g., freeing resourced allocated in os_program_init(), 1358d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * it should be done here. It is also acceptable for this function to do 1368d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * nothing. 1378d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 1388d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtvoid os_program_deinit(void); 1398d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 1408d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 1418d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * os_setenv - Set environment variable 1428d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @name: Name of the variable 1438d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @value: Value to set to the variable 1448d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @overwrite: Whether existing variable should be overwritten 1458d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on error 1468d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 1478d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function is only used for wpa_cli action scripts. OS wrapper does not 1488d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * need to implement this if such functionality is not needed. 1498d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 1508d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtint os_setenv(const char *name, const char *value, int overwrite); 1518d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 1528d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 1538d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * os_unsetenv - Delete environent variable 1548d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @name: Name of the variable 1558d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: 0 on success, -1 on error 1568d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 1578d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function is only used for wpa_cli action scripts. OS wrapper does not 1588d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * need to implement this if such functionality is not needed. 1598d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 1608d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtint os_unsetenv(const char *name); 1618d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 1628d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 1638d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * os_readfile - Read a file to an allocated memory buffer 1648d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @name: Name of the file to read 1658d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @len: For returning the length of the allocated buffer 1668d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: Pointer to the allocated buffer or %NULL on failure 1678d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 1688d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function allocates memory and reads the given file to this buffer. Both 1698d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * binary and text files can be read with this function. The caller is 1708d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * responsible for freeing the returned buffer with os_free(). 1718d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 1728d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtchar * os_readfile(const char *name, size_t *len); 1738d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 1748d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 1758d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * os_zalloc - Allocate and zero memory 1768d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @size: Number of bytes to allocate 1778d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: Pointer to allocated and zeroed memory or %NULL on failure 1788d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 1798d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Caller is responsible for freeing the returned buffer with os_free(). 1808d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 1818d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtvoid * os_zalloc(size_t size); 1828d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 18361d9df3e62aaa0e87ad05452fcb95142159a17b6Dmitry Shmidt/** 18461d9df3e62aaa0e87ad05452fcb95142159a17b6Dmitry Shmidt * os_calloc - Allocate and zero memory for an array 18561d9df3e62aaa0e87ad05452fcb95142159a17b6Dmitry Shmidt * @nmemb: Number of members in the array 18661d9df3e62aaa0e87ad05452fcb95142159a17b6Dmitry Shmidt * @size: Number of bytes in each member 18761d9df3e62aaa0e87ad05452fcb95142159a17b6Dmitry Shmidt * Returns: Pointer to allocated and zeroed memory or %NULL on failure 18861d9df3e62aaa0e87ad05452fcb95142159a17b6Dmitry Shmidt * 18961d9df3e62aaa0e87ad05452fcb95142159a17b6Dmitry Shmidt * This function can be used as a wrapper for os_zalloc(nmemb * size) when an 19061d9df3e62aaa0e87ad05452fcb95142159a17b6Dmitry Shmidt * allocation is used for an array. The main benefit over os_zalloc() is in 19161d9df3e62aaa0e87ad05452fcb95142159a17b6Dmitry Shmidt * having an extra check to catch integer overflows in multiplication. 19261d9df3e62aaa0e87ad05452fcb95142159a17b6Dmitry Shmidt * 19361d9df3e62aaa0e87ad05452fcb95142159a17b6Dmitry Shmidt * Caller is responsible for freeing the returned buffer with os_free(). 19461d9df3e62aaa0e87ad05452fcb95142159a17b6Dmitry Shmidt */ 19561d9df3e62aaa0e87ad05452fcb95142159a17b6Dmitry Shmidtstatic inline void * os_calloc(size_t nmemb, size_t size) 19661d9df3e62aaa0e87ad05452fcb95142159a17b6Dmitry Shmidt{ 19761d9df3e62aaa0e87ad05452fcb95142159a17b6Dmitry Shmidt if (size && nmemb > (~(size_t) 0) / size) 19861d9df3e62aaa0e87ad05452fcb95142159a17b6Dmitry Shmidt return NULL; 19961d9df3e62aaa0e87ad05452fcb95142159a17b6Dmitry Shmidt return os_zalloc(nmemb * size); 20061d9df3e62aaa0e87ad05452fcb95142159a17b6Dmitry Shmidt} 20161d9df3e62aaa0e87ad05452fcb95142159a17b6Dmitry Shmidt 2028d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 2038d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/* 2048d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * The following functions are wrapper for standard ANSI C or POSIX functions. 2058d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * By default, they are just defined to use the standard function name and no 2068d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * os_*.c implementation is needed for them. This avoids extra function calls 2078d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * by allowing the C pre-processor take care of the function name mapping. 2088d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 2098d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * If the target system uses a C library that does not provide these functions, 2108d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * build_config.h can be used to define the wrappers to use a different 2118d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * function name. This can be done on function-by-function basis since the 2128d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * defines here are only used if build_config.h does not define the os_* name. 2138d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * If needed, os_*.c file can be used to implement the functions that are not 2148d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * included in the C library on the target system. Alternatively, 2158d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * OS_NO_C_LIB_DEFINES can be defined to skip all defines here in which case 2168d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * these functions need to be implemented in os_*.c file for the target system. 2178d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 2188d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 2198d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#ifdef OS_NO_C_LIB_DEFINES 2208d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 2218d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 2228d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * os_malloc - Allocate dynamic memory 2238d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @size: Size of the buffer to allocate 2248d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: Allocated buffer or %NULL on failure 2258d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 2268d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Caller is responsible for freeing the returned buffer with os_free(). 2278d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 2288d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtvoid * os_malloc(size_t size); 2298d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 2308d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 2318d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * os_realloc - Re-allocate dynamic memory 2328d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @ptr: Old buffer from os_malloc() or os_realloc() 2338d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @size: Size of the new buffer 2348d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: Allocated buffer or %NULL on failure 2358d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 2368d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Caller is responsible for freeing the returned buffer with os_free(). 2378d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * If re-allocation fails, %NULL is returned and the original buffer (ptr) is 2388d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * not freed and caller is still responsible for freeing it. 2398d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 2408d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtvoid * os_realloc(void *ptr, size_t size); 2418d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 2428d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 2438d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * os_free - Free dynamic memory 2448d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @ptr: Old buffer from os_malloc() or os_realloc(); can be %NULL 2458d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 2468d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtvoid os_free(void *ptr); 2478d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 2488d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 2498d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * os_memcpy - Copy memory area 2508d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @dest: Destination 2518d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @src: Source 2528d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @n: Number of bytes to copy 2538d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: dest 2548d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 2558d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * The memory areas src and dst must not overlap. os_memmove() can be used with 2568d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * overlapping memory. 2578d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 2588d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtvoid * os_memcpy(void *dest, const void *src, size_t n); 2598d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 2608d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 2618d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * os_memmove - Copy memory area 2628d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @dest: Destination 2638d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @src: Source 2648d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @n: Number of bytes to copy 2658d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: dest 2668d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 2678d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * The memory areas src and dst may overlap. 2688d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 2698d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtvoid * os_memmove(void *dest, const void *src, size_t n); 2708d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 2718d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 2728d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * os_memset - Fill memory with a constant byte 2738d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @s: Memory area to be filled 2748d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @c: Constant byte 2758d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @n: Number of bytes started from s to fill with c 2768d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: s 2778d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 2788d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtvoid * os_memset(void *s, int c, size_t n); 2798d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 2808d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 2818d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * os_memcmp - Compare memory areas 2828d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @s1: First buffer 2838d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @s2: Second buffer 2848d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @n: Maximum numbers of octets to compare 2858d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: An integer less than, equal to, or greater than zero if s1 is 2868d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * found to be less than, to match, or be greater than s2. Only first n 2878d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * characters will be compared. 2888d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 2898d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtint os_memcmp(const void *s1, const void *s2, size_t n); 2908d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 2918d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 2928d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * os_strdup - Duplicate a string 2938d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @s: Source string 2948d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: Allocated buffer with the string copied into it or %NULL on failure 2958d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 2968d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Caller is responsible for freeing the returned buffer with os_free(). 2978d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 2988d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtchar * os_strdup(const char *s); 2998d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 3008d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 3018d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * os_strlen - Calculate the length of a string 3028d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @s: '\0' terminated string 3038d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: Number of characters in s (not counting the '\0' terminator) 3048d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 3058d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtsize_t os_strlen(const char *s); 3068d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 3078d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 3088d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * os_strcasecmp - Compare two strings ignoring case 3098d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @s1: First string 3108d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @s2: Second string 3118d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: An integer less than, equal to, or greater than zero if s1 is 3128d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * found to be less than, to match, or be greatred than s2 3138d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 3148d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtint os_strcasecmp(const char *s1, const char *s2); 3158d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 3168d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 3178d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * os_strncasecmp - Compare two strings ignoring case 3188d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @s1: First string 3198d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @s2: Second string 3208d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @n: Maximum numbers of characters to compare 3218d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: An integer less than, equal to, or greater than zero if s1 is 3228d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * found to be less than, to match, or be greater than s2. Only first n 3238d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * characters will be compared. 3248d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 3258d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtint os_strncasecmp(const char *s1, const char *s2, size_t n); 3268d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 3278d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 3288d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * os_strchr - Locate the first occurrence of a character in string 3298d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @s: String 3308d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @c: Character to search for 3318d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: Pointer to the matched character or %NULL if not found 3328d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 3338d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtchar * os_strchr(const char *s, int c); 3348d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 3358d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 3368d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * os_strrchr - Locate the last occurrence of a character in string 3378d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @s: String 3388d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @c: Character to search for 3398d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: Pointer to the matched character or %NULL if not found 3408d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 3418d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtchar * os_strrchr(const char *s, int c); 3428d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 3438d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 3448d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * os_strcmp - Compare two strings 3458d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @s1: First string 3468d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @s2: Second string 3478d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: An integer less than, equal to, or greater than zero if s1 is 3488d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * found to be less than, to match, or be greatred than s2 3498d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 3508d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtint os_strcmp(const char *s1, const char *s2); 3518d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 3528d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 3538d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * os_strncmp - Compare two strings 3548d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @s1: First string 3558d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @s2: Second string 3568d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @n: Maximum numbers of characters to compare 3578d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: An integer less than, equal to, or greater than zero if s1 is 3588d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * found to be less than, to match, or be greater than s2. Only first n 3598d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * characters will be compared. 3608d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 3618d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtint os_strncmp(const char *s1, const char *s2, size_t n); 3628d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 3638d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 3648d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * os_strncpy - Copy a string 3658d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @dest: Destination 3668d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @src: Source 3678d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @n: Maximum number of characters to copy 3688d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: dest 3698d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 3708d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtchar * os_strncpy(char *dest, const char *src, size_t n); 3718d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 3728d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 3738d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * os_strstr - Locate a substring 3748d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @haystack: String (haystack) to search from 3758d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @needle: Needle to search from haystack 3768d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: Pointer to the beginning of the substring or %NULL if not found 3778d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 3788d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtchar * os_strstr(const char *haystack, const char *needle); 3798d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 3808d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 3818d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * os_snprintf - Print to a memory buffer 3828d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @str: Memory buffer to print into 3838d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @size: Maximum length of the str buffer 3848d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @format: printf format 3858d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: Number of characters printed (not including trailing '\0'). 3868d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 3878d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * If the output buffer is truncated, number of characters which would have 3888d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * been written is returned. Since some C libraries return -1 in such a case, 3898d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * the caller must be prepared on that value, too, to indicate truncation. 3908d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 3918d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Note: Some C library implementations of snprintf() may not guarantee null 3928d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * termination in case the output is truncated. The OS wrapper function of 3938d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * os_snprintf() should provide this guarantee, i.e., to null terminate the 3948d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * output buffer if a C library version of the function is used and if that 3958d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * function does not guarantee null termination. 3968d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 3978d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * If the target system does not include snprintf(), see, e.g., 3988d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * http://www.ijs.si/software/snprintf/ for an example of a portable 3998d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * implementation of snprintf. 4008d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 4018d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtint os_snprintf(char *str, size_t size, const char *format, ...); 4028d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 4038d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#else /* OS_NO_C_LIB_DEFINES */ 4048d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 4058d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#ifdef WPA_TRACE 4068d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtvoid * os_malloc(size_t size); 4078d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtvoid * os_realloc(void *ptr, size_t size); 4088d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtvoid os_free(void *ptr); 4098d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtchar * os_strdup(const char *s); 4108d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#else /* WPA_TRACE */ 4118d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#ifndef os_malloc 4128d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define os_malloc(s) malloc((s)) 4138d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#endif 4148d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#ifndef os_realloc 4158d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define os_realloc(p, s) realloc((p), (s)) 4168d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#endif 4178d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#ifndef os_free 4188d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define os_free(p) free((p)) 4198d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#endif 4208d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#ifndef os_strdup 4218d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#ifdef _MSC_VER 4228d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define os_strdup(s) _strdup(s) 4238d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#else 4248d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define os_strdup(s) strdup(s) 4258d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#endif 4268d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#endif 4278d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#endif /* WPA_TRACE */ 4288d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 4298d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#ifndef os_memcpy 4308d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define os_memcpy(d, s, n) memcpy((d), (s), (n)) 4318d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#endif 4328d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#ifndef os_memmove 4338d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define os_memmove(d, s, n) memmove((d), (s), (n)) 4348d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#endif 4358d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#ifndef os_memset 4368d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define os_memset(s, c, n) memset(s, c, n) 4378d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#endif 4388d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#ifndef os_memcmp 4398d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define os_memcmp(s1, s2, n) memcmp((s1), (s2), (n)) 4408d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#endif 4418d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 4428d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#ifndef os_strlen 4438d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define os_strlen(s) strlen(s) 4448d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#endif 4458d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#ifndef os_strcasecmp 4468d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#ifdef _MSC_VER 4478d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define os_strcasecmp(s1, s2) _stricmp((s1), (s2)) 4488d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#else 4498d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define os_strcasecmp(s1, s2) strcasecmp((s1), (s2)) 4508d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#endif 4518d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#endif 4528d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#ifndef os_strncasecmp 4538d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#ifdef _MSC_VER 4548d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define os_strncasecmp(s1, s2, n) _strnicmp((s1), (s2), (n)) 4558d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#else 4568d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define os_strncasecmp(s1, s2, n) strncasecmp((s1), (s2), (n)) 4578d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#endif 4588d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#endif 4598d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#ifndef os_strchr 4608d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define os_strchr(s, c) strchr((s), (c)) 4618d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#endif 4628d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#ifndef os_strcmp 4638d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define os_strcmp(s1, s2) strcmp((s1), (s2)) 4648d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#endif 4658d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#ifndef os_strncmp 4668d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define os_strncmp(s1, s2, n) strncmp((s1), (s2), (n)) 4678d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#endif 4688d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#ifndef os_strncpy 4698d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define os_strncpy(d, s, n) strncpy((d), (s), (n)) 4708d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#endif 4718d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#ifndef os_strrchr 4728d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define os_strrchr(s, c) strrchr((s), (c)) 4738d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#endif 4748d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#ifndef os_strstr 4758d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define os_strstr(h, n) strstr((h), (n)) 4768d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#endif 4778d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 4788d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#ifndef os_snprintf 4798d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#ifdef _MSC_VER 4808d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define os_snprintf _snprintf 4818d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#else 4828d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define os_snprintf snprintf 4838d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#endif 4848d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#endif 4858d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 4868d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#endif /* OS_NO_C_LIB_DEFINES */ 4878d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 4888d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 48961d9df3e62aaa0e87ad05452fcb95142159a17b6Dmitry Shmidtstatic inline void * os_realloc_array(void *ptr, size_t nmemb, size_t size) 49061d9df3e62aaa0e87ad05452fcb95142159a17b6Dmitry Shmidt{ 49161d9df3e62aaa0e87ad05452fcb95142159a17b6Dmitry Shmidt if (size && nmemb > (~(size_t) 0) / size) 49261d9df3e62aaa0e87ad05452fcb95142159a17b6Dmitry Shmidt return NULL; 49361d9df3e62aaa0e87ad05452fcb95142159a17b6Dmitry Shmidt return os_realloc(ptr, nmemb * size); 49461d9df3e62aaa0e87ad05452fcb95142159a17b6Dmitry Shmidt} 49561d9df3e62aaa0e87ad05452fcb95142159a17b6Dmitry Shmidt 49661d9df3e62aaa0e87ad05452fcb95142159a17b6Dmitry Shmidt 4978d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt/** 4988d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * os_strlcpy - Copy a string with size bound and NUL-termination 4998d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @dest: Destination 5008d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @src: Source 5018d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * @siz: Size of the target buffer 5028d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * Returns: Total length of the target string (length of src) (not including 5038d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * NUL-termination) 5048d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * 5058d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt * This function matches in behavior with the strlcpy(3) function in OpenBSD. 5068d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt */ 5078d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidtsize_t os_strlcpy(char *dest, const char *src, size_t siz); 5088d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 5098d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 5108d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#ifdef OS_REJECT_C_LIB_FUNCTIONS 5118d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define malloc OS_DO_NOT_USE_malloc 5128d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define realloc OS_DO_NOT_USE_realloc 5138d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define free OS_DO_NOT_USE_free 5148d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define memcpy OS_DO_NOT_USE_memcpy 5158d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define memmove OS_DO_NOT_USE_memmove 5168d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define memset OS_DO_NOT_USE_memset 5178d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define memcmp OS_DO_NOT_USE_memcmp 5188d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#undef strdup 5198d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define strdup OS_DO_NOT_USE_strdup 5208d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define strlen OS_DO_NOT_USE_strlen 5218d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define strcasecmp OS_DO_NOT_USE_strcasecmp 5228d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define strncasecmp OS_DO_NOT_USE_strncasecmp 5238d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#undef strchr 5248d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define strchr OS_DO_NOT_USE_strchr 5258d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#undef strcmp 5268d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define strcmp OS_DO_NOT_USE_strcmp 5278d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#undef strncmp 5288d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define strncmp OS_DO_NOT_USE_strncmp 5298d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#undef strncpy 5308d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define strncpy OS_DO_NOT_USE_strncpy 5318d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define strrchr OS_DO_NOT_USE_strrchr 5328d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define strstr OS_DO_NOT_USE_strstr 5338d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#undef snprintf 5348d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define snprintf OS_DO_NOT_USE_snprintf 5358d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 5368d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#define strcpy OS_DO_NOT_USE_strcpy 5378d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#endif /* OS_REJECT_C_LIB_FUNCTIONS */ 5388d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt 5398d520ff1dc2da35cdca849e982051b86468016d8Dmitry Shmidt#endif /* OS_H */ 540