api.h 4.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146
  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. /* WARNING: this declaration may conflict with some header files */
  21. #ifndef ssize_t
  22. typedef ptrdiff_t ssize_t;
  23. #endif
  24. /* Macros */
  25. #ifndef likely
  26. # define likely(x) __builtin_expect((!!(x)),1)
  27. #endif
  28. #ifndef unlikely
  29. # define unlikely(x) __builtin_expect((!!(x)),0)
  30. #endif
  31. #define __alloca __builtin_alloca
  32. #define XSTRINGIFY(x) STRINGIFY(x)
  33. #define STRINGIFY(x) #x
  34. #define static_strlen(str) (sizeof(str) - 1)
  35. /* Libc functions */
  36. /* Libc String functions string.h/stdlib.h */
  37. size_t strnlen (const char *str, size_t maxlen);
  38. size_t strlen (const char *str);
  39. long strtol (const char *s, char **endptr, int base);
  40. int atoi (const char *nptr);
  41. long int atol (const char *nptr);
  42. char * strchr (const char *s, int c_in);
  43. void * memcpy (void *dstpp, const void *srcpp, size_t len);
  44. void * memmove (void *dstpp, const void *srcpp, size_t len);
  45. void * memset (void *dstpp, int c, size_t len);
  46. int memcmp (const void *s1, const void *s2, size_t len);
  47. /* Libc memory allocation functions. stdlib.h. */
  48. void *malloc(size_t size);
  49. void free(void *ptr);
  50. void *calloc(size_t nmemb, size_t size);
  51. /* Some useful macro */
  52. /* force failure if str is not a static string */
  53. #define force_static(str) ("" str "")
  54. /* check if the var is exactly the same as the static string */
  55. #define strcmp_static(var, str) \
  56. (!memcmp((var), force_static(str), static_strlen(force_static(str)) + 1))
  57. /* check if the var starts with the static string */
  58. #define strpartcmp_static(var, str) \
  59. (!memcmp((var), force_static(str), static_strlen(force_static(str))))
  60. /* copy static string and return the address of the null end (null if the dest
  61. * is not large enough).*/
  62. #define strcpy_static(var, str, max) \
  63. (static_strlen(force_static(str)) + 1 > max ? NULL : \
  64. memcpy((var), force_static(str), static_strlen(force_static(str)) + 1) + \
  65. static_strlen(force_static(str)))
  66. /* Libc printf functions. stdio.h/stdarg.h. */
  67. void fprintfmt (int (*_fputch)(void *, int, void *), void * f, void * putdat,
  68. const char * fmt, ...);
  69. void vfprintfmt (int (*_fputch)(void *, int, void *), void * f, void * putdat,
  70. const char * fmt, va_list *ap);
  71. int snprintf (char * buf, int n, const char * fmt, ...);
  72. /* Miscelleneous */
  73. int inet_pton4 (const char *src, int len, void *dst);
  74. int inet_pton6 (const char *src, int len, void *dst);
  75. uint32_t __htonl (uint32_t x);
  76. uint32_t __ntohl (uint32_t x);
  77. uint16_t __htons (uint16_t x);
  78. uint16_t __ntohs (uint16_t x);
  79. extern const char * const * sys_errlist_internal;
  80. /* Graphene functions */
  81. int get_norm_path (const char * path, char * buf, int offset, int size);
  82. int get_base_name (const char * path, char * buf, int size);
  83. /* Loading configs / manifests */
  84. #include <list.h>
  85. struct config;
  86. DEFINE_LISTP(config);
  87. struct config_store {
  88. LISTP_TYPE(config) root;
  89. LISTP_TYPE(config) entries;
  90. void * raw_data;
  91. int raw_size;
  92. void * (*malloc) (size_t);
  93. void (*free) (void *);
  94. };
  95. int read_config (struct config_store * store, int (*filter) (const char *, int),
  96. const char ** errstring);
  97. int free_config (struct config_store * store);
  98. int copy_config (struct config_store * store, struct config_store * new_store);
  99. int write_config (void * file, int (*write) (void *, void *, int),
  100. struct config_store * store);
  101. ssize_t get_config (struct config_store * cfg, const char * key,
  102. char * val_buf, size_t size);
  103. int get_config_entries (struct config_store * cfg, const char * key,
  104. char * key_buf, size_t key_bufsize);
  105. ssize_t get_config_entries_size (struct config_store * cfg, const char * key);
  106. int set_config (struct config_store * cfg, const char * key, const char * val);
  107. #define CONFIG_MAX 4096
  108. #endif /* API_H */