[FFmpeg-devel] [PATCH 1/2] url: document url_read exact behaviour.

[Michael Niedermayer]

On Thu, Mar 15, 2012 at 12:26:59PM +0100, Nicolas George wrote:
> 
> Signed-off-by: Nicolas George <nicolas.george at normalesup.org>
> ---
>  libavformat/url.h |   13 +++++++++++++
>  1 files changed, 13 insertions(+), 0 deletions(-)
> 
> diff --git a/libavformat/url.h b/libavformat/url.h
> index b459a59..c957ba9 100644
> --- a/libavformat/url.h
> +++ b/libavformat/url.h
> @@ -59,6 +59,19 @@ typedef struct URLProtocol {
>       * for those nested protocols.
>       */
>      int     (*url_open2)(URLContext *h, const char *url, int flags, AVDictionary **options);
> +
> +    /**
> +     * Read data from the protocol.
> +     * If data is immediately available (even less than size), EOF is
> +     * reached or an error occurs (including EINTR), return immediately, 
> +     * Otherwise:
> +     * In non-blocking mode, return AVERROR(EAGAIN) immediately.

> +     * In blocking mode, wait for data for a short amount of time (0.1s),
> +     * and return AVERROR(EAGAIN) otherwise.

maybe "wait for data/EOF/error with a short timeout (0.1s)"

otherwise LGTM


[...]

--
Michael     GnuPG fingerprint: 9FF2128B147EF6730BADF133611EC787040B0FAB

No snowflake in an avalanche ever feels responsible. -- Voltaire
-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 198 bytes
Desc: Digital signature
URL: <http://ffmpeg.org/pipermail/ffmpeg-devel/attachments/20120315/6ed0e838/attachment.asc>