From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-9.8 required=3.0 tests=DKIM_SIGNED,DKIM_VALID, HEADER_FROM_DIFFERENT_DOMAINS,INCLUDES_PATCH,MAILING_LIST_MULTI,SIGNED_OFF_BY, SPF_HELO_NONE,SPF_PASS,USER_AGENT_GIT autolearn=ham autolearn_force=no version=3.4.0 Received: from mail.kernel.org (mail.kernel.org [198.145.29.99]) by smtp.lore.kernel.org (Postfix) with ESMTP id B63D4C433DF for ; Fri, 29 May 2020 12:30:22 +0000 (UTC) Received: from alsa0.perex.cz (alsa0.perex.cz [77.48.224.243]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id 38FE8206E2 for ; Fri, 29 May 2020 12:30:22 +0000 (UTC) Authentication-Results: mail.kernel.org; dkim=pass (1024-bit key) header.d=alsa-project.org header.i=@alsa-project.org header.b="tkvg/aiT" DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 38FE8206E2 Authentication-Results: mail.kernel.org; dmarc=fail (p=none dis=none) header.from=linux.intel.com Authentication-Results: mail.kernel.org; spf=pass smtp.mailfrom=alsa-devel-bounces@alsa-project.org Received: from alsa1.perex.cz (alsa1.perex.cz [207.180.221.201]) (using TLSv1.2 with cipher AECDH-AES256-SHA (256/256 bits)) (No client certificate requested) by alsa0.perex.cz (Postfix) with ESMTPS id 3AA5017BC; Fri, 29 May 2020 14:29:30 +0200 (CEST) DKIM-Filter: OpenDKIM Filter v2.11.0 alsa0.perex.cz 3AA5017BC DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=alsa-project.org; s=default; t=1590755420; bh=hvXaZNvRJQsI05Ra9VADtEJ/lylwxLwJtH1niglP6+c=; h=From:To:Subject:Date:In-Reply-To:References:Cc:List-Id: List-Unsubscribe:List-Archive:List-Post:List-Help:List-Subscribe: From; b=tkvg/aiTe7rU8olj3HkQ6BuDFPXwOBqMn8iQ0I2bAxvwpyb0I38SZgCCrD0heKs+S v3+Cn3UXOMX2Ot+f/7s0wiQ3R+gtmQYY/GnlJ2aRClSOAx9gVugokZt7B4IJN0TqQ+ y9G8l1JpBRTGkQjovCSvE2nuTHwiz4xGyR8oQE58= Received: from alsa1.perex.cz (localhost.localdomain [127.0.0.1]) by alsa1.perex.cz (Postfix) with ESMTP id 1C0F4F80227; Fri, 29 May 2020 14:28:39 +0200 (CEST) Received: by alsa1.perex.cz (Postfix, from userid 50401) id 1370CF8016F; Fri, 29 May 2020 14:28:34 +0200 (CEST) Received: from mga12.intel.com (mga12.intel.com [192.55.52.136]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by alsa1.perex.cz (Postfix) with ESMTPS id 59C19F80149 for ; Fri, 29 May 2020 14:28:27 +0200 (CEST) DKIM-Filter: OpenDKIM Filter v2.11.0 alsa1.perex.cz 59C19F80149 IronPort-SDR: 9HYyHkhQJ2B1RjlcCXal6zLAIcwVH4PXjR4iprN7Ij/bBkfyb7XAFlpWuChqnshpK9zmQDJkfU JD8aZ/jw3zsw== X-Amp-Result: SKIPPED(no attachment in message) X-Amp-File-Uploaded: False Received: from fmsmga006.fm.intel.com ([10.253.24.20]) by fmsmga106.fm.intel.com with ESMTP/TLS/ECDHE-RSA-AES256-GCM-SHA384; 29 May 2020 05:28:22 -0700 IronPort-SDR: zMtV7l3rT/ygSqlG/FCEiuY5GM0YKGy0lDqVHNpDBRMNOZ8ORD3TQeT0IF5mn3rwzT+2kK6td4 3pJZc7yC6zeA== X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="5.73,448,1583222400"; d="scan'208";a="469491465" Received: from eliteleevi.tm.intel.com ([10.237.54.20]) by fmsmga006.fm.intel.com with ESMTP; 29 May 2020 05:28:21 -0700 From: Kai Vehmanen To: alsa-devel@alsa-project.org, perex@perex.cz Subject: [PATCH 1/2] pcm: add documentation for -ENODATA error code Date: Fri, 29 May 2020 15:28:16 +0300 Message-Id: <20200529122817.1198-2-kai.vehmanen@linux.intel.com> X-Mailer: git-send-email 2.26.2 In-Reply-To: <20200529122817.1198-1-kai.vehmanen@linux.intel.com> References: <20200529122817.1198-1-kai.vehmanen@linux.intel.com> MIME-Version: 1.0 Content-Transfer-Encoding: 8bit Cc: kai.vehmanen@linux.intel.com X-BeenThere: alsa-devel@alsa-project.org X-Mailman-Version: 2.1.15 Precedence: list List-Id: "Alsa-devel mailing list for ALSA developers - http://www.alsa-project.org" List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Errors-To: alsa-devel-bounces@alsa-project.org Sender: "Alsa-devel" This error code can be used e.g. with echo reference PCM devices (the SND_USE_CASE_MOD_ECHO_REF UCM token). Signed-off-by: Kai Vehmanen --- src/pcm/pcm.c | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/src/pcm/pcm.c b/src/pcm/pcm.c index 1064044c9812..488a8dd0493d 100644 --- a/src/pcm/pcm.c +++ b/src/pcm/pcm.c @@ -292,6 +292,14 @@ This error can happen when device is physically removed (for example some hotplug devices like USB or PCMCIA, CardBus or ExpressCard can be removed on the fly). +\par -ENODATA + +This error can happen if the device data transfer is dependent on +an external condition and that condition is not met. For example, +PCM device for echo reference as described by SND_USE_CASE_MOD_ECHO_REF +UCM token, may return -ENODATA if the linked playback stream has not been +started. + \section pcm_params Managing parameters The ALSA PCM device uses two groups of PCM related parameters. The hardware -- 2.26.2