api.h 4.6 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141
  1. /* -*- mode:c; c-file-style:"k&r"; c-basic-offset: 4; tab-width:4; indent-tabs-mode:nil; mode:auto-fill; fill-column:78; -*- */
  2. /* vim: set ts=4 sw=4 et tw=78 fo=cqt wm=0: */
  3. /* Copyright (C) 2014 Stony Brook University
  4. This file is part of Graphene Library OS.
  5. Graphene Library OS is free software: you can redistribute it and/or
  6. modify it under the terms of the GNU Lesser General Public License
  7. as published by the Free Software Foundation, either version 3 of the
  8. License, or (at your option) any later version.
  9. Graphene Library OS is distributed in the hope that it will be useful,
  10. but WITHOUT ANY WARRANTY; without even the implied warranty of
  11. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  12. GNU Lesser General Public License for more details.
  13. You should have received a copy of the GNU Lesser General Public License
  14. along with this program. If not, see <http://www.gnu.org/licenses/>. */
  15. #ifndef API_H
  16. #define API_H
  17. #include <stddef.h>
  18. #include <stdint.h>
  19. #include <stdarg.h>
  20. /* Macros */
  21. #ifndef likely
  22. # define likely(x) __builtin_expect((!!(x)),1)
  23. #endif
  24. #ifndef unlikely
  25. # define unlikely(x) __builtin_expect((!!(x)),0)
  26. #endif
  27. #define __alloca __builtin_alloca
  28. #define XSTRINGIFY(x) STRINGIFY(x)
  29. #define STRINGIFY(x) #x
  30. #define static_strlen(str) (sizeof(str) - 1)
  31. /* Libc functions */
  32. /* Libc String functions string.h/stdlib.h */
  33. size_t strnlen (const char *str, size_t maxlen);
  34. size_t strlen (const char *str);
  35. long strtol (const char *s, char **endptr, int base);
  36. int atoi (const char *nptr);
  37. long int atol (const char *nptr);
  38. char * strchr (const char *s, int c_in);
  39. void * memcpy (void *dstpp, const void *srcpp, size_t len);
  40. void * memmove (void *dstpp, const void *srcpp, size_t len);
  41. void * memset (void *dstpp, int c, size_t len);
  42. int memcmp (const void *s1, const void *s2, size_t len);
  43. /* Libc memory allocation functions. stdlib.h. */
  44. void *malloc(size_t size);
  45. void free(void *ptr);
  46. void *calloc(size_t nmemb, size_t size);
  47. /* Some useful macro */
  48. /* force failure if str is not a static string */
  49. #define force_static(str) ("" str "")
  50. /* check if the var is exactly the same as the static string */
  51. #define strcmp_static(var, str) \
  52. (!memcmp((var), force_static(str), static_strlen(force_static(str)) + 1))
  53. /* check if the var starts with the static string */
  54. #define strpartcmp_static(var, str) \
  55. (!memcmp((var), force_static(str), static_strlen(force_static(str))))
  56. /* copy static string and return the address of the null end (null if the dest
  57. * is not large enough).*/
  58. #define strcpy_static(var, str, max) \
  59. (static_strlen(force_static(str)) + 1 > max ? NULL : \
  60. memcpy((var), force_static(str), static_strlen(force_static(str)) + 1) + \
  61. static_strlen(force_static(str)))
  62. /* Libc printf functions. stdio.h/stdarg.h. */
  63. void fprintfmt (int (*_fputch)(void *, int, void *), void * f, void * putdat,
  64. const char * fmt, ...);
  65. void vfprintfmt (int (*_fputch)(void *, int, void *), void * f, void * putdat,
  66. const char * fmt, va_list *ap);
  67. int snprintf (char * buf, int n, const char * fmt, ...);
  68. /* Miscelleneous */
  69. int inet_pton4 (const char *src, int len, void *dst);
  70. int inet_pton6 (const char *src, int len, void *dst);
  71. uint32_t __htonl (uint32_t x);
  72. uint32_t __ntohl (uint32_t x);
  73. uint16_t __htons (uint16_t x);
  74. uint16_t __ntohs (uint16_t x);
  75. extern const char * const * sys_errlist_internal;
  76. /* Graphene functions */
  77. int get_norm_path (const char * path, char * buf, int offset, int size);
  78. int get_base_name (const char * path, char * buf, int size);
  79. /* Loading configs / manifests */
  80. #include <list.h>
  81. struct config;
  82. DEFINE_LISTP(config);
  83. struct config_store {
  84. LISTP_TYPE(config) root;
  85. LISTP_TYPE(config) entries;
  86. void * raw_data;
  87. int raw_size;
  88. void * (*malloc) (size_t);
  89. void (*free) (void *);
  90. };
  91. int read_config (struct config_store * store, int (*filter) (const char *, int),
  92. const char ** errstring);
  93. int free_config (struct config_store * store);
  94. int copy_config (struct config_store * store, struct config_store * new_store);
  95. int write_config (void * file, int (*write) (void *, void *, int),
  96. struct config_store * store);
  97. int get_config (struct config_store * cfg, const char * key,
  98. char * val_buf, int size);
  99. int get_config_entries (struct config_store * cfg, const char * key,
  100. char * key_buf);
  101. int get_config_entries_size (struct config_store * cfg, const char * key);
  102. int set_config (struct config_store * cfg, const char * key, const char * val);
  103. #define CONFIG_MAX 4096
  104. #endif /* API_H */