lib/url.h

   1 /*
   2  *      Sherlock Library -- URL Functions
   3  *
   4  *      (c) 1997 Martin Mares, <mj@atrey.karlin.mff.cuni.cz>
   5  */
   6
   7 #define MAX_URL_SIZE 1024
   8
   9 /* Non-control meanings of control characters */
  10
  11 #define NCC_SEMICOLON 1
  12 #define NCC_SLASH 2
  13 #define NCC_QUEST 3
  14 #define NCC_COLON 4
  15 #define NCC_AT 5
  16 #define NCC_EQUAL 6
  17 #define NCC_AND 7
  18 #define NCC_MAX 8
  19
  20 /* Remove/Introduce '%' escapes */
  21
  22 int url_deescape(byte *, byte *);
  23 int url_enescape(byte *, byte *);
  24
  25 /* URL splitting and normalization */
  26
  27 struct url {
  28   byte *protocol;
  29   uns protoid;
  30   byte *user;
  31   byte *host;
  32   uns port;                             /* ~0 if unspec */
  33   byte *rest;
  34   byte *buf, *bufend;
  35 };
  36
  37 int url_split(byte *, struct url *, byte *);
  38 int url_normalize(struct url *, struct url *);
  39 int url_canonicalize(struct url *);
  40 int url_pack(struct url *, byte *);
  41 int url_canon_split(byte *, byte *, byte *, struct url *);
  42 uns identify_protocol(byte *);
  43
  44 /* Error codes */
  45
  46 char *url_error(uns);
  47
  48 #define URL_ERR_TOO_LONG 1
  49 #define URL_ERR_INVALID_CHAR 2
  50 #define URL_ERR_INVALID_ESCAPE 3
  51 #define URL_ERR_INVALID_ESCAPED_CHAR 4
  52 #define URL_ERR_INVALID_PORT 5
  53 #define URL_ERR_REL_NOTHING 6
  54 #define URL_ERR_UNKNOWN_PROTOCOL 7
  55 #define URL_SYNTAX_ERROR 8
  56 #define URL_PATH_UNDERFLOW 9
  57
  58 #define URL_PROTO_UNKNOWN 0
  59 #define URL_PROTO_HTTP 1
  60 #define URL_PROTO_FTP 2
  61 #define URL_PROTO_MAX 3
  62
  63 #define URL_PNAMES { "unknown", "http", "ftp" }