util.h

   1 /*
   2 Copyright (c) 2003-2006 by Juliusz Chroboczek
   3
   4 Permission is hereby granted, free of charge, to any person obtaining a copy
   5 of this software and associated documentation files (the "Software"), to deal
   6 in the Software without restriction, including without limitation the rights
   7 to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
   8 copies of the Software, and to permit persons to whom the Software is
   9 furnished to do so, subject to the following conditions:
  10
  11 The above copyright notice and this permission notice shall be included in
  12 all copies or substantial portions of the Software.
  13
  14 THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  15 IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  16 FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL THE
  17 AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
  18 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
  19 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
  20 THE SOFTWARE.
  21 */
  22
  23 /* These are Polipo's error codes.  They need to be positive integers,
  24    and must not collide with possible errno values.
  25    Starting at 2^16 should be safe enough. */
  26
  27 #define E0 (1 << 16)
  28 #define E1 (2 << 16)
  29 #define E2 (3 << 16)
  30 #define E3 (4 << 16)
  31 #define EUNKNOWN (E0)
  32 #define EDOSHUTDOWN (E0 + 1)
  33 #define EDOGRACEFUL (E0 + 2)
  34 #define EDOTIMEOUT (E0 + 3)
  35 #define ECLIENTRESET (E0 + 4)
  36 #define ESYNTAX (E0 + 5)
  37 #define EREDIRECTOR (E0 + 6)
  38 #define EDNS_HOST_NOT_FOUND (E1)
  39 #define EDNS_NO_ADDRESS (E1 + 1)
  40 #define EDNS_NO_RECOVERY (E1 + 2)
  41 #define EDNS_TRY_AGAIN (E1 + 3)
  42 #define EDNS_INVALID (E1 + 4)
  43 #define EDNS_UNSUPPORTED (E1 + 5)
  44 #define EDNS_FORMAT (E1 + 6)
  45 #define EDNS_REFUSED (E1 + 7)
  46 #define EDNS_CNAME_LOOP (E1 + 8)
  47 #define ESOCKS_PROTOCOL (E2)
  48 /* These correspond to SOCKS status codes 91 through 93 */
  49 #define ESOCKS_REJECT_FAIL (E2 + 1)
  50 #define ESOCKS_REJECT_IDENTD (E2 + 2)
  51 #define ESOCKS_REJECT_UID_MISMATCH (E2 + 3)
  52 /* (ESOCKS5_BASE + n) corresponds to SOCKS5 status code n (0 to 8) */
  53 #define ESOCKS5_BASE (E3)
  54
  55 typedef struct _IntRange {
  56     int from;
  57     int to;
  58 } IntRangeRec, *IntRangePtr;
  59
  60 typedef struct _IntList {
  61     int length;
  62     int size;
  63     IntRangePtr ranges;
  64 } IntListRec, *IntListPtr;
  65
  66 char *strdup_n(const char *restrict buf, int n) ATTRIBUTE ((malloc));
  67 int snnprintf(char *restrict buf, int n, int len, const char *format, ...)
  68      ATTRIBUTE ((format (printf, 4, 5)));
  69 int snnvprintf(char *restrict buf, int n, int len, const char *format, va_list args)
  70      ATTRIBUTE ((format (printf, 4, 0)));
  71 int snnprint_n(char *restrict buf, int n, int len, const char *s, int slen);
  72 int strcmp_n(const char *string, const char *buf, int n) ATTRIBUTE ((pure));
  73 int digit(char) ATTRIBUTE ((const));
  74 int letter(char) ATTRIBUTE ((const));
  75 char lwr(char) ATTRIBUTE ((const));
  76 char* lwrcpy(char *restrict dst, const char *restrict src, int n);
  77 int lwrcmp(const char *as, const char *bs, int n) ATTRIBUTE ((pure));
  78 int strcasecmp_n(const char *string, const char *buf, int n)
  79      ATTRIBUTE ((pure));
  80 int isWhitespace(const char *string) ATTRIBUTE((pure));
  81 #ifndef HAVE_MEMRCHR
  82 void *memrchr(const void *s, int c, size_t n) ATTRIBUTE ((pure));
  83 #endif
  84 int h2i(char h) ATTRIBUTE ((const));
  85 char i2h(int i) ATTRIBUTE ((const));
  86 int log2_floor(int x) ATTRIBUTE ((const));
  87 int log2_ceil(int x) ATTRIBUTE ((const));
  88 char* vsprintf_a(const char *f, va_list args)
  89     ATTRIBUTE ((malloc, format (printf, 1, 0)));
  90 char* sprintf_a(const char *f, ...)
  91     ATTRIBUTE ((malloc, format (printf, 1, 2)));
  92 unsigned int hash(unsigned seed, const void *restrict key, int key_size,
  93                   unsigned int hash_size)
  94      ATTRIBUTE ((pure));
  95 char *pstrerror(int e);
  96 time_t mktime_gmt(struct tm *tm) ATTRIBUTE ((pure));
  97 AtomPtr expandTilde(AtomPtr filename);
  98 void do_daemonise(int noclose);
  99 void writePid(char *pidfile);
 100 int b64cpy(char *restrict dst, const char *restrict src, int n, int fss);
 101 int b64cmp(const char *restrict a, int an, const char *restrict b, int bn)
 102     ATTRIBUTE ((pure));
 103 IntListPtr makeIntList(int size) ATTRIBUTE ((malloc));
 104 void destroyIntList(IntListPtr list);
 105 int intListMember(int n, IntListPtr list) ATTRIBUTE ((pure));
 106 int intListCons(int from, int to, IntListPtr list);
 107 int physicalMemory(void);
 108 int parseIntN(const char *restrict str, int m, int n,
 109               int min, int max, int base, int *value_return);
 110 int parseInt(const char *restrict str, int m,
 111              int min, int max, int base, int *value_return);
 112