Add the capability to write custom HTTP headers
[libav.git] / 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 #ifndef AVFORMAT_HTTP_H
22 #define AVFORMAT_HTTP_H
23
24 /**
25 * Sets custom HTTP headers.
26 * A trailing CRLF ("\r\n") is required for custom headers.
27 * Passing in an empty header string ("\0") will reset to defaults.
28 *
29 * The following headers can be overriden by custom values,
30 * otherwise they will be set to their defaults.
31 * -User-Agent
32 * -Accept
33 * -Range
34 * -Host
35 * -Connection
36 *
37 * @param h URL context for this HTTP connection
38 * @param headers the custom headers to set
39 */
40 void ff_http_set_headers(URLContext *h, const char *headers);
41
42 #endif /* AVFORMAT_HTTP_H */