• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
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 */
75