From patchwork Mon Aug 29 14:07:16 2022 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Anton Khirnov X-Patchwork-Id: 37559 Delivered-To: ffmpegpatchwork2@gmail.com Received: by 2002:a05:6a20:139a:b0:8f:1db5:eae2 with SMTP id w26csp1967241pzh; Mon, 29 Aug 2022 07:08:01 -0700 (PDT) X-Google-Smtp-Source: AA6agR5QT58ixp+/+t4GUcIHugHxvk55yUcV7eYtxUTMdJlT8VMbT4eGydbikltMGMFSHQwJlYUf X-Received: by 2002:a17:906:ef8b:b0:730:e14f:d762 with SMTP id ze11-20020a170906ef8b00b00730e14fd762mr13856673ejb.519.1661782081363; Mon, 29 Aug 2022 07:08:01 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1661782081; cv=none; d=google.com; s=arc-20160816; b=FjCxfG+QSqoW1n8E07hTQoDCPoANRTzQFEj6+Qr4IlsSBgBaXTGEnaThwdFozS6VkW a5gBpDpzeBFUd5u5NIWucr29iVENdK0CfKVe5I0z+xOFV9Lj+T/GtXow7m6/bqe+Rcz0 fCzAWceecWsFjcobcbA97P1FMnSYF7PffwkgMAwDi035YcLX/Y9H5kGW7310Y+QSvMUU A48xq1/YyN1edqQwLywy6ufHFiobQM2B+dwIMSUfd6+iYNdSQBvDUx7nu66nEDP3LKnp yC8ppAglti4lZGfT6Ra5WZySiv8Peih7rURtjHlZSMEM5b8tVLsQDhClgPg3NfN97ZrM easg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:content-transfer-encoding:reply-to:list-subscribe :list-help:list-post:list-archive:list-unsubscribe:list-id :precedence:subject:mime-version:references:in-reply-to:message-id :date:to:from:delivered-to; bh=6UCqvnt3oIEIqRr7Cd+ozarE/Vn1Ax8qdAF3ze2h3nk=; b=khpEpcish4/XA02Awmo6DzhkWVTGyebECsGNEvxtw2yUufUWBvb1QTLcA7CxJw8whY +PSZB+t+fLp9b9YxfKhNCUsZi4wuX5zBVuwcpgE1xTPBkEDhKYwuE3IYTidbL7dKdtkf pdU6SFxiBdXvpOr2+S7ioDu6zxAZQ/rEOBsJVUUXOrD0QLITDVlHoes14pP03jWFGj28 VOeG5Z4SeD0PKwxpU7qQ3/wsAtOQe7kkyyF5vpP44qtbRy9CzS4f6kDE0IKjYxJVX+Qj zRa+nP23DGMjQb0e0k6uFlcgFgrxqzNtUJTDQBFxAR92LKBCfoFXIwGpeXrRDWqXledT fRBQ== ARC-Authentication-Results: i=1; mx.google.com; spf=pass (google.com: domain of ffmpeg-devel-bounces@ffmpeg.org designates 79.124.17.100 as permitted sender) smtp.mailfrom=ffmpeg-devel-bounces@ffmpeg.org Return-Path: Received: from ffbox0-bg.mplayerhq.hu (ffbox0-bg.ffmpeg.org. [79.124.17.100]) by mx.google.com with ESMTP id n24-20020a170906689800b0073160e42274si5862897ejr.718.2022.08.29.07.07.56; Mon, 29 Aug 2022 07:08:01 -0700 (PDT) Received-SPF: pass (google.com: domain of ffmpeg-devel-bounces@ffmpeg.org designates 79.124.17.100 as permitted sender) client-ip=79.124.17.100; Authentication-Results: mx.google.com; spf=pass (google.com: domain of ffmpeg-devel-bounces@ffmpeg.org designates 79.124.17.100 as permitted sender) smtp.mailfrom=ffmpeg-devel-bounces@ffmpeg.org Received: from [127.0.1.1] (localhost [127.0.0.1]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTP id DE6A668BA9D; Mon, 29 Aug 2022 17:07:35 +0300 (EEST) X-Original-To: ffmpeg-devel@ffmpeg.org Delivered-To: ffmpeg-devel@ffmpeg.org Received: from mail0.khirnov.net (red.khirnov.net [176.97.15.12]) by ffbox0-bg.mplayerhq.hu (Postfix) with ESMTPS id 7418168BA8C for ; Mon, 29 Aug 2022 17:07:27 +0300 (EEST) Received: from localhost (localhost [IPv6:::1]) by mail0.khirnov.net (Postfix) with ESMTP id 245D6240D0E for ; Mon, 29 Aug 2022 16:07:27 +0200 (CEST) Received: from mail0.khirnov.net ([IPv6:::1]) by localhost (mail0.khirnov.net [IPv6:::1]) (amavisd-new, port 10024) with ESMTP id UcjxoXzl9qOU for ; Mon, 29 Aug 2022 16:07:25 +0200 (CEST) Received: from libav.khirnov.net (libav.khirnov.net [IPv6:2a00:c500:561:201::7]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (2048 bits) server-digest SHA256 client-signature RSA-PSS (2048 bits) client-digest SHA256) (Client CN "libav.khirnov.net", Issuer "smtp.khirnov.net SMTP CA" (verified OK)) by mail0.khirnov.net (Postfix) with ESMTPS id 01332240D03 for ; Mon, 29 Aug 2022 16:07:24 +0200 (CEST) Received: by libav.khirnov.net (Postfix, from userid 1000) id D141E3A014F; Mon, 29 Aug 2022 16:07:18 +0200 (CEST) From: Anton Khirnov To: ffmpeg-devel@ffmpeg.org Date: Mon, 29 Aug 2022 16:07:16 +0200 Message-Id: <20220829140717.26557-2-anton@khirnov.net> X-Mailer: git-send-email 2.35.1 In-Reply-To: <20220829140717.26557-1-anton@khirnov.net> References: <20220829140717.26557-1-anton@khirnov.net> MIME-Version: 1.0 Subject: [FFmpeg-devel] [PATCH 2/3] lavu/fifo: clarify interaction of AV_FIFO_FLAG_AUTO_GROW with av_fifo_can_write() X-BeenThere: ffmpeg-devel@ffmpeg.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: FFmpeg development discussions and patches List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Reply-To: FFmpeg development discussions and patches Errors-To: ffmpeg-devel-bounces@ffmpeg.org Sender: "ffmpeg-devel" X-TUID: XTj8BlZcz3N4 --- libavutil/fifo.h | 8 +++++++- 1 file changed, 7 insertions(+), 1 deletion(-) diff --git a/libavutil/fifo.h b/libavutil/fifo.h index 6c6bd78842..89872d0972 100644 --- a/libavutil/fifo.h +++ b/libavutil/fifo.h @@ -97,7 +97,13 @@ void av_fifo_auto_grow_limit(AVFifo *f, size_t max_elems); size_t av_fifo_can_read(const AVFifo *f); /** - * @return number of elements that can be written into the given FIFO. + * @return Number of elements that can be written into the given FIFO without + * growing it. + * + * In other words, this number of elements or less is guaranteed to fit + * into the FIFO. More data may be written when the + * AV_FIFO_FLAG_AUTO_GROW flag was specified at FIFO creation, but this + * may involve memory allocation, which can fail. */ size_t av_fifo_can_write(const AVFifo *f);