http.h

   1 /*
   2  * Copyright 2004-2005 Timo Hirvonen
   3  *
   4  * This program is free software; you can redistribute it and/or
   5  * modify it under the terms of the GNU General Public License as
   6  * published by the Free Software Foundation; either version 2 of the
   7  * License, or (at your option) any later version.
   8  *
   9  * This program is distributed in the hope that it will be useful, but
  10  * WITHOUT ANY WARRANTY; without even the implied warranty of
  11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  12  * General Public License for more details.
  13  *
  14  * You should have received a copy of the GNU General Public License
  15  * along with this program; if not, write to the Free Software
  16  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA
  17  * 02111-1307, USA.
  18  */
  19
  20 #ifndef _HTTP_H
  21 #define _HTTP_H
  22
  23 #include "keyval.h"
  24
  25 #include <unistd.h>
  26
  27 /*
  28  * 1xx indicates an informational message only
  29  * 2xx indicates success of some kind
  30  * 3xx redirects the client to another URL
  31  * 4xx indicates an error on the client's part
  32  * 5xx indicates an error on the server's part
  33  */
  34
  35 struct http_uri {
  36         char *user;
  37         char *pass;
  38         char *host;
  39         char *path;
  40         int port;
  41 };
  42
  43 struct http_get {
  44         struct http_uri uri;
  45         int fd;
  46         struct keyval *headers;
  47         char *reason;
  48         int code;
  49 };
  50
  51 int http_parse_uri(const char *uri, struct http_uri *u);
  52
  53 /* frees contents of @u, not @u itself */
  54 void http_free_uri(struct http_uri *u);
  55
  56 int http_open(struct http_get *hg, int timeout_ms);
  57
  58 /*
  59  * returns:  0 success
  60  *          -1 check errno
  61  *          -2 parse error
  62  */
  63 int http_get(struct http_get *hg, struct keyval *headers, int timeout_ms);
  64 void http_get_free(struct http_get *hg);
  65
  66 char *http_read_body(int fd, size_t *size, int timeout_ms);
  67 char *base64_encode(const char *str);
  68
  69 #endif