git.sesse.net Git - ffmpeg/blob - libavformat/http.h

   1 /*
   2  * HTTP definitions
   3  * Copyright (c) 2010 Josh Allmann
   4  *
   5  * This file is part of FFmpeg.
   6  *
   7  * FFmpeg is free software; you can redistribute it and/or
   8  * modify it under the terms of the GNU Lesser General Public
   9  * License as published by the Free Software Foundation; either
  10  * version 2.1 of the License, or (at your option) any later version.
  11  *
  12  * FFmpeg is distributed in the hope that it will be useful,
  13  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  14  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  15  * Lesser General Public License for more details.
  16  *
  17  * You should have received a copy of the GNU Lesser General Public
  18  * License along with FFmpeg; if not, write to the Free Software
  19  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
  20  */
  21
  22 #ifndef AVFORMAT_HTTP_H
  23 #define AVFORMAT_HTTP_H
  24
  25 #include "url.h"
  26
  27 #define HTTP_HEADERS_SIZE 4096
  28
  29 /**
  30  * Initialize the authentication state based on another HTTP URLContext.
  31  * This can be used to pre-initialize the authentication parameters if
  32  * they are known beforehand, to avoid having to do an initial failing
  33  * request just to get the parameters.
  34  *
  35  * @param dest URL context whose authentication state gets updated
  36  * @param src URL context whose authentication state gets copied
  37  */
  38 void ff_http_init_auth_state(URLContext *dest, const URLContext *src);
  39
  40 /**
  41  * Get the HTTP shutdown response status, be used after http_shutdown.
  42  *
  43  * @param h pointer to the resource
  44  * @return a negative value if an error condition occurred, 0
  45  * otherwise
  46  */
  47 int ff_http_get_shutdown_status(URLContext *h);
  48
  49 /**
  50  * Send a new HTTP request, reusing the old connection.
  51  *
  52  * @param h pointer to the resource
  53  * @param uri uri used to perform the request
  54  * @return a negative value if an error condition occurred, 0
  55  * otherwise
  56  */
  57 int ff_http_do_new_request(URLContext *h, const char *uri);
  58
  59 /**
  60  * Send a new HTTP request, reusing the old connection.
  61  *
  62  * @param h pointer to the resource
  63  * @param uri uri used to perform the request
  64  * @param options  A dictionary filled with HTTP options. On return
  65  * this parameter will be destroyed and replaced with a dict containing options
  66  * that were not found. May be NULL.
  67  * @return a negative value if an error condition occurred, 0
  68  * otherwise
  69  */
  70 int ff_http_do_new_request2(URLContext *h, const char *uri, AVDictionary **options);
  71
  72 int ff_http_averror(int status_code, int default_averror);
  73
  74 #endif /* AVFORMAT_HTTP_H */