From nobody Thu Oct 2 11:50:18 2025 Received: from mail-oo1-f45.google.com (mail-oo1-f45.google.com [209.85.161.45]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id D2F7E283FEE for ; Tue, 16 Sep 2025 21:03:53 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.161.45 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1758056635; cv=none; b=jzgmdD2SFU4kIpy9nb1zaiKVzMlq6hgfjpDMLusheNn2I3ALcvR9lPb+5QnX0OHABE6972g24FmCT7QCZaEgtWPNngpqMh0Lw4ZK+gnrgRfenLp4HGodKpJfUbBFRm2eronQrdsX8pMuh0JcAVcqdTi68aeGVvYY+QQyiXAywTo= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1758056635; c=relaxed/simple; bh=pvW5zRcWfeyVBSqoz2YuVw11X5u2Bz4r/sM+Ny8NzaE=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=qNX/40rNGWUqgWLx/a4jBOp42v+WiR6MANm1LDWVup4grObkPL2ySrbRUVkZdBdk5wSVStwpZrFaCEVTGspKFACh13DsMKapBG1vrVxOazbXzoUv4BjtHkFZbdVuHcwvMMOnSkHyRWobsrtINTkdeWYJa/Fqo0sm/t3XQDBkZ/o= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=baylibre.com; spf=pass smtp.mailfrom=baylibre.com; dkim=pass (2048-bit key) header.d=baylibre-com.20230601.gappssmtp.com header.i=@baylibre-com.20230601.gappssmtp.com header.b=nfTGOknD; arc=none smtp.client-ip=209.85.161.45 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=baylibre.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=baylibre.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=baylibre-com.20230601.gappssmtp.com header.i=@baylibre-com.20230601.gappssmtp.com header.b="nfTGOknD" Received: by mail-oo1-f45.google.com with SMTP id 006d021491bc7-62344b7b69cso991086eaf.0 for ; Tue, 16 Sep 2025 14:03:53 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=baylibre-com.20230601.gappssmtp.com; s=20230601; t=1758056633; x=1758661433; darn=vger.kernel.org; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:from:to:cc:subject:date:message-id :reply-to; bh=HL2e/WuXZjgQ+ibL3M/EC4K8mQrgrMrBA77dFAoob1U=; b=nfTGOknD6Z2H8hWDN4zHeKrjz/FbQNgLUfkvadFoRljurYf5LY+Bb67ugx2GL1YUrg 60zBr+vfSqI+3tLeSL1Xt33njNMrSRtPAO9tT7g5gG9GpjKDkW/aj+/JOfippCKuXehl MHW/xtnNAUfhTO9TMHfEbMiadaYMCc3KvDEK6Hhrjf2Qo6DCCjOzreNrYgodvWdBKt/l 9tBWYDn8j3L2qrdfYNBZVVaNjx0vpmaTNCVUDBsxQf4+dIZaxCIRM0GmKifXdVF4q3/P fAZOy9yXnClALn67bC+mJo/reDjl5GPs21pKYMhnXZAGAHxlyYuZ5UBRZ2cjmF7v2bKK BJxA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1758056633; x=1758661433; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=HL2e/WuXZjgQ+ibL3M/EC4K8mQrgrMrBA77dFAoob1U=; b=e3wzpgZ0LjU/D9gw1qsidqertxLEDR7BEYcUqc1uNW+wn04sGdJQPMdfELtXlfBTfF k4O2QnkPUszeCZ7e2klyrMCmdjThzHI4vM7GcIEh0HZLslqp+6DjVF3ANq8ozQXTZz3Z 2uyUWApe3PVjvohfd+wNJfAE786KH511qbZTBQuVV/v0ap6enuBLrhpkDGNParnNMr07 eKV+nc7tSOGc7bSjEy/qnYHZKCcvkLYKsPDx2UxsKXFYamPg7bZfGzaRdh0D6rZei7QK titjUG5upbZo4iKf3MvNEf00DohKKbL2JfACRbJaRTriJbadiI3JgBwysFvZ6yFWcnDn fbyQ== X-Forwarded-Encrypted: i=1; AJvYcCUEVcILabMWI69egz/W0cP1Vp3dPusfzXAE2KWbahnhvJK2+qJBbb5D9yU+5/+VNi9dX3IZnpgCW7zeZ5s=@vger.kernel.org X-Gm-Message-State: AOJu0YytHPES8xtzDtPIe0qEj2yY894y134t0HF/9Ob/n8F0KxvcusUw g14ridQA5x9Ds8AUsUNN8Vr5l5kNwOLpgX5lc7EicUdi/0B4rWEA50fIpzVhZsDv0rk= X-Gm-Gg: ASbGncvTP+fjABrHhYKOEp8BASRTD56TaAN4UDIBifmhmZPkR/OBFfWqAZk6n6sw9cQ 4G295v0enc5/cR4qjj6INVEBTXL692vWzsipTXovn9YDsbuLilW69jBO+ODUh4WkFr6gE7H0n7p btFoPdBnN8TGsSF48c8tHL2psYNu80q7jhG9fo5q0Vs2bXvXpogxtmaov/Ehlert1dHIXDu1Qc5 wy1mQTSBUb6bW2CQ4gP3NgcAU3GzaqT2nWj3Of9lbuX0iF0Meod8xDIyxwBnsb/svOK4ZjcMu56 1GeeN36BXb4GwAopzm3KB7pyQbOYMHxXUaS0bUQ+Rse5K9j52YKVHOCycdaPWA19cgpxXhhoaYw OpUQ6LJG3ejxGuQwyj/zDvtqOXLRc X-Google-Smtp-Source: AGHT+IFCkDG2Wd7hYTlZ9YHQ7MptC+whdynNDap9Jf70c5msRHifOUMwG7G/fxQ283A5VlxFfDvFTw== X-Received: by 2002:a05:6808:4f4b:b0:43d:2454:b694 with SMTP id 5614622812f47-43d2454ba43mr5452806b6e.2.1758056632935; Tue, 16 Sep 2025 14:03:52 -0700 (PDT) Received: from [127.0.1.1] ([2600:8803:e7e4:1d00:70a1:e065:6248:ef8b]) by smtp.gmail.com with ESMTPSA id 5614622812f47-43b8294ac06sm3540044b6e.14.2025.09.16.14.03.50 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 16 Sep 2025 14:03:51 -0700 (PDT) From: David Lechner Date: Tue, 16 Sep 2025 16:02:51 -0500 Subject: [PATCH v2 1/7] iio: buffer: document iio_push_to_buffers_with_ts_unaligned() may sleep Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Message-Id: <20250916-iio-doc-push-to-buffers-context-v2-1-8b17937a6cc7@baylibre.com> References: <20250916-iio-doc-push-to-buffers-context-v2-0-8b17937a6cc7@baylibre.com> In-Reply-To: <20250916-iio-doc-push-to-buffers-context-v2-0-8b17937a6cc7@baylibre.com> To: Jonathan Cameron , =?utf-8?q?Nuno_S=C3=A1?= , Andy Shevchenko Cc: linux-iio@vger.kernel.org, linux-kernel@vger.kernel.org, Daniel Lezcano , Andy Shevchenko , David Lechner X-Mailer: b4 0.14.2 X-Developer-Signature: v=1; a=openpgp-sha256; l=1165; i=dlechner@baylibre.com; h=from:subject:message-id; bh=pvW5zRcWfeyVBSqoz2YuVw11X5u2Bz4r/sM+Ny8NzaE=; b=owEBbQGS/pANAwAKAcLMIAH/AY/AAcsmYgBoydCGz0nb3t98zgUS4Vy0mVSAHDq4Di0yBzGlx Ad7/z0vBWOJATMEAAEKAB0WIQTsGNmeYg6D1pzYaJjCzCAB/wGPwAUCaMnQhgAKCRDCzCAB/wGP wDvRB/9K8/CMqZk+CvwWOwTNLvv+TYQg7ZAkUbXyhvoRnbq1pRVxfx40S1ft1ETBBhsuwkOPuEo TQOXcJsMOIaY53M1OjIG5/Ki/ZcaT0ZG3l8v2BymVa4+mWzK+SDs0XIq9dikRACQmCTPepxzIje WpRaiXmhy1S/8bdEVdX9g9lWAWFViY2vvX1v0R6HaAO83Nyu7xX4YcDxCh5FKt17RAPXiHIcSD8 MBkRm5SyEMogpzHe3NAh+StDDaqkqIrXM5VCXzu4H4lXxBVJeFQXnDBjLB3HClV/hHZPWhswUrR fl5wKxqlZIJjfLO0BIqrdwVzp1HZUTdSzL84wQz1Y4Wo7qyX X-Developer-Key: i=dlechner@baylibre.com; a=openpgp; fpr=8A73D82A6A1F509907F373881F8AF88C82F77C03 Add Context: documentation comment that iio_push_to_buffers_with_ts_unaligned() may sleep because it calls devm_krealloc(). Also document Return: value while here. Suggested-by: Andy Shevchenko Reviewed-by: Andy Shevchenko Signed-off-by: David Lechner --- drivers/iio/industrialio-buffer.c | 3 +++ 1 file changed, 3 insertions(+) diff --git a/drivers/iio/industrialio-buffer.c b/drivers/iio/industrialio-b= uffer.c index a80f7cc25a27109cfe22ce447c4117fc94bc8310..7da43a1f2f75f32dc93b9a5fe90= 3378a79e82fe3 100644 --- a/drivers/iio/industrialio-buffer.c +++ b/drivers/iio/industrialio-buffer.c @@ -2401,6 +2401,9 @@ EXPORT_SYMBOL_GPL(iio_push_to_buffers); * not require space for the timestamp, or 8 byte alignment of data. * It does however require an allocation on first call and additional * copies on all calls, so should be avoided if possible. + * + * Context: May sleep. + * Return: 0 on success, negative error code on failure. */ int iio_push_to_buffers_with_ts_unaligned(struct iio_dev *indio_dev, const void *data, --=20 2.43.0 From nobody Thu Oct 2 11:50:18 2025 Received: from mail-oo1-f54.google.com (mail-oo1-f54.google.com [209.85.161.54]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 9EE82284695 for ; Tue, 16 Sep 2025 21:03:54 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.161.54 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1758056636; cv=none; b=bW4WSx7jwWBFnWkrRSkBSmpWlpj1/+88rPoiWNMOpkPP6EwxLKlc7TxCGr2nuFZ1ryjoHvCsBZG65Bu9NGnizi5dSQPHGVZODkIUTQhbP0RxtDHhRsWSsbUETvN1EJm5agjJS2rO7SZun2HmHp3eQxMQHTD7sdIFv1VQdmp8TPs= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1758056636; c=relaxed/simple; bh=HoTnMUccGdCvWwXyGGvfMxbeyG3DCTAB887pRo015M0=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=baj7dwXSqnlZMQWVVXm8pW1oqimTlVgUAr2pmnxyWv2KybrzAN3MGJyqHkOV8Qc2wCebauNOb0whdHIf7NljUFTTdggG0r4oQWDU1ShYOzBksyTOeQxp18h+PcvPUaq/s4B14v86yGcapv38LYAphiE0q5/xFoj8+Gl4ry3B88M= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=baylibre.com; spf=pass smtp.mailfrom=baylibre.com; dkim=pass (2048-bit key) header.d=baylibre-com.20230601.gappssmtp.com header.i=@baylibre-com.20230601.gappssmtp.com header.b=GgdJ6iPh; arc=none smtp.client-ip=209.85.161.54 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=baylibre.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=baylibre.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=baylibre-com.20230601.gappssmtp.com header.i=@baylibre-com.20230601.gappssmtp.com header.b="GgdJ6iPh" Received: by mail-oo1-f54.google.com with SMTP id 006d021491bc7-62340cf6870so594909eaf.1 for ; Tue, 16 Sep 2025 14:03:54 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=baylibre-com.20230601.gappssmtp.com; s=20230601; t=1758056634; x=1758661434; darn=vger.kernel.org; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:from:to:cc:subject:date:message-id :reply-to; bh=kOVMpRKYtwkqS0W7XsGFd2e24mnObLP4dosBsaN4f+k=; b=GgdJ6iPhgdLsRto22Ct49HrljSfJKLogfvRAFL/NCa76o77OoQLyA4/FIdvA0lY1AM 1LPArmlzFCpo6emdOsWvKg2OsJmaMeF4hLLW2iXb5c4WVEiG9SpJz+tceMTnfnxiwXAG z/IJl5lXvMQeZNxY5+E32YJB9eV7aJQVWPV88lN4mJRFhdVl9iuUuI4rbj7Dm42Z6Cfx Dd0J+Y5MgKt3vqEaPg61X4H88tIlaTY+pX7flIsNHXZdgEhLjxy9TjTkkTHtFLosrgq1 zz+2ZbHUUUseCOdOHSr+XSfiRgHY6JVBi/tuHeBr6BXr75OcaC6X6Fy9cCfBwxuBpRJi 3Zyw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1758056634; x=1758661434; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=kOVMpRKYtwkqS0W7XsGFd2e24mnObLP4dosBsaN4f+k=; b=KfxImxom3i0j3dRVS0DpUaZd1CCvnHHtmYetFLMMpfE9HgoH36eMzsBR+kUcDPb15Z lvgE5AD8GDR4n4EkjynyNjb6rI47zi9Tuiv6Rsvws46F2rPo2hLxntCVnjfeSDn3H9RA kM+6rlrBAL0ub2pg2g34y6Oz610kVck52TI0qJbLHyWVj+Zu3m2Wl1/hyPKYc4W8Ll0u jGxWg3L5KgYk6KHM1mjH6rQtCu+OadJymuZIlcBP6SOpOLaknEkw+S368nAw1LvmIb2p PwxquagC+4A8riMlUaDlNvDNigPocIN8SI38KMlcHGgXBdyamC80ByRFvX/W/qpiC1pw jDGQ== X-Forwarded-Encrypted: i=1; AJvYcCU9wFiJZ4MqjachKBNSWoyvP3bSLfchfH3cTmDWwXQcKDvgfdTopK3f7cC8Ct06io+cUtaS0qHi9WlmViQ=@vger.kernel.org X-Gm-Message-State: AOJu0YxslPbY+Y3PzyFtnolZeyKOXif3CNxRLZsBBlCo4cTuefWLQFK/ KqWub8dkK+76bCF+OQqrWqEQ8c+l4uMMwtxhurPbpr9BGvLs7SNs6j9sDMFZMdTigao= X-Gm-Gg: ASbGncsFscZ0DknfANYqD9zbU+YSZCiVUlhqZuGm9p0uYQ4sKY1NnHltDqCgKFsmu7B Sw7UVCiG/fcGzWtb5pow6xRQXQABYlecGxknNbIhIfwvFaqTdk7FzYbJetArPPYicV0LnHdZK8t LTKegRGm3Yx4PcaMTJJHlNb267tGHxBkYs2NB8fW4HF7l/auj/hfCOiZ54cXSZkM7Xn5v+NTr8V bPVCxUuhl3Zby8babzk94ybJ+5VqiuXN129MMQ66EiSIwUCWGTnWGQUkNionjgRUbPCZnffeW9m mAoiKE/SwKbjNWVt9j28t7qjvjPPRRimdPSRxR0sS2Z/uKZ+3Ldw5+s0MtxydNe9gEQM6XvmdLk IHrQWaqbKqvk2sQIpm+oTLcvmIoE+ X-Google-Smtp-Source: AGHT+IEq2WegxDh+JawxjX24U+s0jfDkaIxMyIzj0ZGVHv917cLK+IqJ3aqvbEKryHr4qPYyMNgNiQ== X-Received: by 2002:a05:6808:180c:b0:439:af0a:dc9e with SMTP id 5614622812f47-43b8d898f0amr8955078b6e.12.1758056633706; Tue, 16 Sep 2025 14:03:53 -0700 (PDT) Received: from [127.0.1.1] ([2600:8803:e7e4:1d00:70a1:e065:6248:ef8b]) by smtp.gmail.com with ESMTPSA id 5614622812f47-43b8294ac06sm3540044b6e.14.2025.09.16.14.03.53 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 16 Sep 2025 14:03:53 -0700 (PDT) From: David Lechner Date: Tue, 16 Sep 2025 16:02:52 -0500 Subject: [PATCH v2 2/7] iio: buffer: iio_push_to_buffers_with_ts_unaligned() might_sleep() Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Message-Id: <20250916-iio-doc-push-to-buffers-context-v2-2-8b17937a6cc7@baylibre.com> References: <20250916-iio-doc-push-to-buffers-context-v2-0-8b17937a6cc7@baylibre.com> In-Reply-To: <20250916-iio-doc-push-to-buffers-context-v2-0-8b17937a6cc7@baylibre.com> To: Jonathan Cameron , =?utf-8?q?Nuno_S=C3=A1?= , Andy Shevchenko Cc: linux-iio@vger.kernel.org, linux-kernel@vger.kernel.org, Daniel Lezcano , Andy Shevchenko , David Lechner X-Mailer: b4 0.14.2 X-Developer-Signature: v=1; a=openpgp-sha256; l=930; i=dlechner@baylibre.com; h=from:subject:message-id; bh=HoTnMUccGdCvWwXyGGvfMxbeyG3DCTAB887pRo015M0=; b=owEBbQGS/pANAwAKAcLMIAH/AY/AAcsmYgBoydCM4/ZBJypY4RqFfOVFr+SIr0EoCjftkSc1a LJQYC1aXDKJATMEAAEKAB0WIQTsGNmeYg6D1pzYaJjCzCAB/wGPwAUCaMnQjAAKCRDCzCAB/wGP wK76CACNp6QD0HROicFUL8liuWxC9iVMce8icL36jCtetWW9CYxuOKducms2hbgn0TL+BWosS2O lWqjuzxWXUyAXe4uik92GGTTaK40OJODEa59txQDqyyBFY5+7+DlMHm53iYZA0CkVSkFn775Yma e5T8s8wCi9UJAVjnHszxbhzvhZKOXZqdGUQWsVnaFcVu1SLPr99Mob5VNiHfdLlVWyZ6dqZCMpE Z2lTPhJ9BEla44ps/f7BJXv4P5Yzgo6CuWvjzqwBcpEIVp4ij6SNsMjXTDFIebeVq5I//UBXo3B p2yyb5mA2gHlkXnZStC/buVF1BMM81+dvnA20p7rEtY33Dbq X-Developer-Key: i=dlechner@baylibre.com; a=openpgp; fpr=8A73D82A6A1F509907F373881F8AF88C82F77C03 Call might_sleep() in iio_push_to_buffers_with_ts_unaligned() since it can allocate memory, which may sleep. Suggested-by: Andy Shevchenko Signed-off-by: David Lechner --- drivers/iio/industrialio-buffer.c | 2 ++ 1 file changed, 2 insertions(+) diff --git a/drivers/iio/industrialio-buffer.c b/drivers/iio/industrialio-b= uffer.c index 7da43a1f2f75f32dc93b9a5fe903378a79e82fe3..5599fa37b698dda6ff126496f62= 939331c12f524 100644 --- a/drivers/iio/industrialio-buffer.c +++ b/drivers/iio/industrialio-buffer.c @@ -2412,6 +2412,8 @@ int iio_push_to_buffers_with_ts_unaligned(struct iio_= dev *indio_dev, { struct iio_dev_opaque *iio_dev_opaque =3D to_iio_dev_opaque(indio_dev); =20 + might_sleep(); + /* * Conservative estimate - we can always safely copy the minimum * of either the data provided or the length of the destination buffer. --=20 2.43.0 From nobody Thu Oct 2 11:50:18 2025 Received: from mail-oi1-f169.google.com (mail-oi1-f169.google.com [209.85.167.169]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 9D96B2C11F4 for ; Tue, 16 Sep 2025 21:03:56 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.167.169 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1758056638; cv=none; b=CMY+dZfe2RWBqf7sE6Qlkn6BbzuUo4Nxe91xMLmxrRMmulKPvhorZKd7cAW5N9ek5aNbjMZqflzRWLNjkIoaT1rnkExToeGnAtl8Zcm+rn0s/bCSAJZP5NTivah9WqKR0xxj+xctOA2+cti6fXxE7BeGLwezy7GYCPWa5D1mUOM= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1758056638; c=relaxed/simple; bh=wrVNbJ1w5ADuZq05WHhPjVQWTKjZ/mM3Cw1wzSvBZ8s=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=NgBpGR97/I1+yq+4+RRbacUmFMePCcTZEtuZfVqz6keIcwvfORdNylbJ2uh10REFYkXRQBhnm0YHTrnbWortGuSpCuwHL+BIaqGZpw3pkPX5m08K0X2NlNy5fsPiv353XVAA9vxIHs3/eZLM0I672CksMKZfT/SLLsKEfMYrFNk= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=baylibre.com; spf=pass smtp.mailfrom=baylibre.com; dkim=pass (2048-bit key) header.d=baylibre-com.20230601.gappssmtp.com header.i=@baylibre-com.20230601.gappssmtp.com header.b=ntkCo8w4; arc=none smtp.client-ip=209.85.167.169 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=baylibre.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=baylibre.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=baylibre-com.20230601.gappssmtp.com header.i=@baylibre-com.20230601.gappssmtp.com header.b="ntkCo8w4" Received: by mail-oi1-f169.google.com with SMTP id 5614622812f47-43d2da52291so132413b6e.1 for ; Tue, 16 Sep 2025 14:03:56 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=baylibre-com.20230601.gappssmtp.com; s=20230601; t=1758056636; x=1758661436; darn=vger.kernel.org; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:from:to:cc:subject:date:message-id :reply-to; bh=oSp5lWtmE8MtdrqYa3CeAStdB6Jrz9HF786RtIfTBDo=; b=ntkCo8w4ow3qldtZu3Anh11Na7QOkWgg7WJme4ydukLf9LpsJpGLzC5NoCP3Z3f80H aW+HhFYZGr6UL3H20cKLra0vLgwg958eTyBYhflAuFTd3MJEqcMhmJf+GtT82x/+ZP76 Dwru3+7n4ry7e12Ph/SOfej77cc/hDaaSUINDfaN4DBht+US0jOqWvG1zNRAEy74f6qg 9QWsRJkG9iY4D1EJG0YXt8HJ5pNK+/FkRttyXG7FgEART5RhkWG65FZibwqwEz+OPugX tItTNHmdf5WEWJMbbPU2CeNWKYEOcoHQbG7C+EInQsImTEsV1xEus7oMOZxRKNXzgQE7 mtSA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1758056636; x=1758661436; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=oSp5lWtmE8MtdrqYa3CeAStdB6Jrz9HF786RtIfTBDo=; b=aQhR4M3U3WjJZEfqw8LoXK0SpKsKppaDLLKc5v0SQlCI0E45oTm5SQm+PrBrp6peA7 lrERvq89y5zs+/poksuQKWS1MRDJoXg/F2w41FfvrXNo5hUoKT/PMnY9chHnP8e8wtd3 vgocJ8NgSYLBrpRldvR56Oeuki7mv6g9ZNmkEei7BqMJYcsQqv0xEZ0Ye9DxD4gElK56 VRwbqh9Yiff5Nk9P0wigt/9Z/+AWeUfqaOXdynLhukklCMsXXdb4oT7W35LcuznamQDb AaEmMEgX8QVbkjBBDw5nSBnVaYDIqc7Dx9Qstcrj5v7Otp1lRK0NP1NQL/raHqr1X5Y8 mn/Q== X-Forwarded-Encrypted: i=1; AJvYcCXUYdXB/O2yjPkeJoOjE/4ovaCc8N6IgwhiMucl8vTz7JoTFom6Tkig7hKgOMC/X0T8/W2VuedYLQl2cz4=@vger.kernel.org X-Gm-Message-State: AOJu0YxKrtA2Fqogx+n07f7AqO1WtJKsQInVHmFrVToF0D9d/fUY+XmS wdx5c+dS+tJCPOYE+RQ+VtddmLCyIRFR9mXnaOZ2PEzHkwHtOLUXosL/nlTACedfod4= X-Gm-Gg: ASbGnctjTWXrPHfDArxuggmyHZz5/ltqYj9dpfAFjEmrS2XYOchifnmIV4W+Kxs3Tuo CJ84nhxXfR1v5efEbhoi48EWmE61uBh5cFOCrEb1t3k67QnH3GvvmKIQqjSNn1sw43MvwdNseZE 2b6G+/Gvk5YR4Uq7qI+7vHaTigM6k6HzFk6gT5s/7VvO+djvy2xyQA7Mk7H+a93YaUNvsdqtmTg AA1ieBLD2s563PXjlMDek7+tTO5Bkb/nhqhY5npbK2OKJ890Xw4CR4SfmdH/MVJn569HLwz2RmF gIHVNvKJVFgiaK6UNAZ6djqbIY0DSKLX4wDn6U4+jqQatugFtvmGghNb6jR99qSfQhPUQSjbFum IBRfFOrQ+I4fN3fwzos0sRrsUrYtz X-Google-Smtp-Source: AGHT+IF+JaCGWDofOoORJQjBx+F4h83HBSDGXEndRlsTtYfZYNGTuP3yXZDOBRZvpzOA+qmrL8vr3g== X-Received: by 2002:a05:6808:640e:b0:438:2278:937 with SMTP id 5614622812f47-43d3f31ca51mr1798292b6e.2.1758056635484; Tue, 16 Sep 2025 14:03:55 -0700 (PDT) Received: from [127.0.1.1] ([2600:8803:e7e4:1d00:70a1:e065:6248:ef8b]) by smtp.gmail.com with ESMTPSA id 5614622812f47-43b8294ac06sm3540044b6e.14.2025.09.16.14.03.53 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 16 Sep 2025 14:03:55 -0700 (PDT) From: David Lechner Date: Tue, 16 Sep 2025 16:02:53 -0500 Subject: [PATCH v2 3/7] iio: buffer: document iio_push_to_buffers_with_ts() Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Message-Id: <20250916-iio-doc-push-to-buffers-context-v2-3-8b17937a6cc7@baylibre.com> References: <20250916-iio-doc-push-to-buffers-context-v2-0-8b17937a6cc7@baylibre.com> In-Reply-To: <20250916-iio-doc-push-to-buffers-context-v2-0-8b17937a6cc7@baylibre.com> To: Jonathan Cameron , =?utf-8?q?Nuno_S=C3=A1?= , Andy Shevchenko Cc: linux-iio@vger.kernel.org, linux-kernel@vger.kernel.org, Daniel Lezcano , David Lechner X-Mailer: b4 0.14.2 X-Developer-Signature: v=1; a=openpgp-sha256; l=1610; i=dlechner@baylibre.com; h=from:subject:message-id; bh=wrVNbJ1w5ADuZq05WHhPjVQWTKjZ/mM3Cw1wzSvBZ8s=; b=owEBbQGS/pANAwAKAcLMIAH/AY/AAcsmYgBoydCTrhrgdvN6kn/QASoGZoLJLV5GCgWirprX9 mLvT+KLZtiJATMEAAEKAB0WIQTsGNmeYg6D1pzYaJjCzCAB/wGPwAUCaMnQkwAKCRDCzCAB/wGP wB4gB/47StMliExN+2QUM+2gkzFSU+K6kLkNBV2sHi4PhyvML+kO/dwLtQmgt5ZraVKK8SunDW4 wyX1Xgc9bWFbLyGtzoMvXCNysyIZRLWQQ2HFy6qBV4js/CA8KJN4aicjIxtN3osg0UvIpsZ9ec8 sJuOo64VSs/O/PxQTt5puTpgaMnPL475s/0BCpQdGLTITqSPaLQkgrIcFBMv8XghlSN184jOKM+ AjcB1NwUtCLJhfdcKdp5B8HoCc7h9rOfQiyF1Q7xg4uZqxUelTGgX+LJxcG/lc2zJ2HjSlKd4M3 9kgwMHnGs/wcqUonN2bsqVPBLazZA0gHudKHVIB3VbC8FBEF X-Developer-Key: i=dlechner@baylibre.com; a=openpgp; fpr=8A73D82A6A1F509907F373881F8AF88C82F77C03 Document the iio_push_to_buffers_with_ts() function. This is copied and slightly cleaned up from iio_push_to_buffers_with_timestamp(). Signed-off-by: David Lechner --- include/linux/iio/buffer.h | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) diff --git a/include/linux/iio/buffer.h b/include/linux/iio/buffer.h index 5c84ec4a981001dfba3b369f811368bab70a3117..e46b818981aaf473539de5adf4a= afa7e7d675de6 100644 --- a/include/linux/iio/buffer.h +++ b/include/linux/iio/buffer.h @@ -45,6 +45,22 @@ static inline int iio_push_to_buffers_with_timestamp(str= uct iio_dev *indio_dev, return iio_push_to_buffers(indio_dev, data); } =20 +/** + * iio_push_to_buffers_with_ts() - push data and timestamp to buffers + * @indio_dev: iio_dev structure for device. + * @data: Pointer to sample data buffer. + * @data_total_len: The size of @data in bytes. + * @timestamp: Timestamp for the sample data. + * + * Pushes data to the IIO device's buffers. If timestamps are enabled for = the + * device the function will store the supplied timestamp as the last eleme= nt in + * the sample data buffer before pushing it to the device buffers. The sam= ple + * data buffer needs to be large enough to hold the additional timestamp + * (usually the buffer should be at least indio->scan_bytes bytes large). + * + * Context: Any context. + * Return: 0 on success, a negative error code otherwise. + */ static inline int iio_push_to_buffers_with_ts(struct iio_dev *indio_dev, void *data, size_t data_total_len, s64 timestamp) --=20 2.43.0 From nobody Thu Oct 2 11:50:18 2025 Received: from mail-oo1-f52.google.com (mail-oo1-f52.google.com [209.85.161.52]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 4C12D2E175C for ; Tue, 16 Sep 2025 21:03:58 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.161.52 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1758056640; cv=none; b=Mcrf1t0LddZPcXIBmLbsCBqSWkC4h696wlI8pOlMRieb9rbw62pfl7ZIOjJCnvVyOR0ildyAHGb01wNPF1eMJ4A/U48rCrX8TCox37OGVwwJ0xjf6+9K1ORp4NQCDpEhB9EA7zuaFbRgZtCsYVD7O8LcPUIn1Ar471Q0wPcbJ9k= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1758056640; c=relaxed/simple; bh=NX9OezBQmGZXkufSRLFKbb/lXUVLMybe7wJNl4d03V8=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=pbrRfUCKFg/ArBtrhnqldkdQ+zwDNabya/mNAkhmcIX56emNZa2mqtRbxgcuc/WeBF+X7VG587jUOGJZjtc1/0WVJUTIw3FamT18k2iXWYLL0KkB1nLxXONhM7h91p/ZOJG3sfhOG4MSP9Gbl+HHPNgYjaG/oTSzeTtGUEwETgQ= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=baylibre.com; spf=pass smtp.mailfrom=baylibre.com; dkim=pass (2048-bit key) header.d=baylibre-com.20230601.gappssmtp.com header.i=@baylibre-com.20230601.gappssmtp.com header.b=Vsl8PvGM; arc=none smtp.client-ip=209.85.161.52 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=baylibre.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=baylibre.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=baylibre-com.20230601.gappssmtp.com header.i=@baylibre-com.20230601.gappssmtp.com header.b="Vsl8PvGM" Received: by mail-oo1-f52.google.com with SMTP id 006d021491bc7-621706e28faso959950eaf.2 for ; Tue, 16 Sep 2025 14:03:58 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=baylibre-com.20230601.gappssmtp.com; s=20230601; t=1758056637; x=1758661437; darn=vger.kernel.org; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:from:to:cc:subject:date:message-id :reply-to; bh=rMoYnKgqGeFb1dGTcjAO1AcVsxDcYWZJZnnQASzLGJU=; b=Vsl8PvGM03Chwtxna6j2qH6RkR23nLnYU+zFx3rKFZ9L3WXGrrQCELNL+4G8H3OuZ8 BJ+ApNMbutBLdSNr+KuvJM0OVAqDeFcr/7uAy+vEmM9bG6Xw0ixhXlzwPQNz49MO3nh8 et7sF4WTMaOABczI057TBKyMY0sytMskyiA/760d3Gd6GG6rdDKhARDxuigjQGbdqfb+ zOxErhIy1chXVRSgh7URD3IxSBeG1wp6oUl4i3YqYB4bjJi/xIBc/gK/JjyNcF/taEyK 9K4WWSS653MpdYBzHtyOBSvStRWzbitbKVgaQ07V98Xi9OCauRfUopVb4b65ANnltNyV MWuQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1758056637; x=1758661437; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=rMoYnKgqGeFb1dGTcjAO1AcVsxDcYWZJZnnQASzLGJU=; b=DCmUZMdBRKWrXr+eV3Z4nivDSwIbUYfs0g2ExHI9T/drMkkbsSlolDN06jkUpYsw9j cPQxbkZxyNbdjk4HuiTuooUG8echoFGUqeXpD2uSPmSLDX+LKWdtdX6sf5B6D5pzc6ov J8t+cVqFB2tpYoji7FOmLA4+HvH1U1IHKRZhUt2tixhiA3JUdgkpT8ymjYG6r0mkdJPK S2cRCq8V+z1x5j9ug2YC9uZ5iVJBFsIspNCl5atcLn4sQO4O5lajrDjsoPIkp8mPwX8y J3gUgI3Wa0eL4VlIBAIU+A3enFeQ5uzt+8l2esfUrooPJDgbRwOHg13CJcZY5r43bOrn qh3Q== X-Forwarded-Encrypted: i=1; AJvYcCXg3WPnpQ+0i/SZMNehDGJvBRHkaU4mTvNA4NbBk70ST3bPw6O29uNWOWJ3w9B8AjSsqn2E3awsRWHSUD4=@vger.kernel.org X-Gm-Message-State: AOJu0YwQyWJgRF1Au4HmpsWt7k7jLbv2SBPAW+DI+PetRiYutNQxz2pj IGLRKOnOtj00jy6dml7sP4NVTdm2UFgn+VxxliZRP0Zp1Kj2sfL6Qjx/w2QfEKyqtK0= X-Gm-Gg: ASbGncsc3CayVKAiNPdJsS/m4C4Rr0EXV75skI9q5frBLA4ZzWWaEmLm2ScOUIXSe4A SzWBBUxoriZ1+wchDmhoIiuSgtr4RLOgrMZRSDHKDnb6pH7XHP9wJ4ZOIUWGmnKblhryG90Qz+P LdBXHFaPy5/Scri7lMToVyIWZZiwUjG/nF5vK9dRkqz+S7uTrySM6ELNvYABjMRbOjsn7KUPZWB /p6/HFQOqJ+iosaccEEHDfNtH4bRtclEKFaD4CBWid9iw+a6EM4/hgO2TNTZ0p+j3UO5Ws60S22 mRedPjNrAJUmFH3S/ksT+KG1ri7ZiKXoAEqmm49nIXL2K4Tzcv+QPG4IxIjW8lEQEEYcVI+6KAU BbM8Vuh0qSpL9IR7qLxHL4FX3d/ey X-Google-Smtp-Source: AGHT+IF2UZuRgCTbOY2EweB2uXPjuhFlPoLc0/0+P1xi9jj3FxxW9uvqBvNoW6txEIxMyfLnPir3BA== X-Received: by 2002:a05:6808:22a2:b0:438:3621:1ba9 with SMTP id 5614622812f47-43b8d8d163emr9448479b6e.14.1758056637294; Tue, 16 Sep 2025 14:03:57 -0700 (PDT) Received: from [127.0.1.1] ([2600:8803:e7e4:1d00:70a1:e065:6248:ef8b]) by smtp.gmail.com with ESMTPSA id 5614622812f47-43b8294ac06sm3540044b6e.14.2025.09.16.14.03.55 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 16 Sep 2025 14:03:55 -0700 (PDT) From: David Lechner Date: Tue, 16 Sep 2025 16:02:54 -0500 Subject: [PATCH v2 4/7] iio: buffer: deprecated iio_push_to_buffers_with_timestamp() Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Message-Id: <20250916-iio-doc-push-to-buffers-context-v2-4-8b17937a6cc7@baylibre.com> References: <20250916-iio-doc-push-to-buffers-context-v2-0-8b17937a6cc7@baylibre.com> In-Reply-To: <20250916-iio-doc-push-to-buffers-context-v2-0-8b17937a6cc7@baylibre.com> To: Jonathan Cameron , =?utf-8?q?Nuno_S=C3=A1?= , Andy Shevchenko Cc: linux-iio@vger.kernel.org, linux-kernel@vger.kernel.org, Daniel Lezcano , David Lechner X-Mailer: b4 0.14.2 X-Developer-Signature: v=1; a=openpgp-sha256; l=1212; i=dlechner@baylibre.com; h=from:subject:message-id; bh=NX9OezBQmGZXkufSRLFKbb/lXUVLMybe7wJNl4d03V8=; b=owEBbQGS/pANAwAKAcLMIAH/AY/AAcsmYgBoydCZe64xKzNtuiNqofBqBUVPbHen9ICcwq8S+ x2aTZJ0UUqJATMEAAEKAB0WIQTsGNmeYg6D1pzYaJjCzCAB/wGPwAUCaMnQmQAKCRDCzCAB/wGP wCGUB/0Z4nAOtm5ZatkVKw76T/gLIiqplOGhAIebbo3rMCu2OqKdYuYsXRsoOuclW/JLJy/cIop 1nNnWKxMXw9GYvHpWxoFVxZ5Qhurur4kn9gaKrwGKKySXnWsIjJgD5GkskYS12ijgs+rlGdUkLl Re1bDZQ654cuneyYHOM7F9DuUdsT9UXJGZoqqeyYBh5fKyajc9FW0A5+5al4/cmSzI5O0U8PQtm KNnu3JlM6DJs1YQ42EpLvhm4vcZf+fCeBEtcKhmQHaYE7cVANCGMtpCjZSXpsvUkU/vwziPjN33 aAWapZb+N8G/MQvRKfMfkMZRk3rkh0UoIbbnH/Z5B7d2bRrZ X-Developer-Key: i=dlechner@baylibre.com; a=openpgp; fpr=8A73D82A6A1F509907F373881F8AF88C82F77C03 Replace the documentation of iio_push_to_buffers_with_timestamp() with a deprecation notice pointing to the preferred alternative. Signed-off-by: David Lechner --- include/linux/iio/buffer.h | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/include/linux/iio/buffer.h b/include/linux/iio/buffer.h index e46b818981aaf473539de5adf4aafa7e7d675de6..d37f82678f716dabfd4eb3b87cd= 7bb00f146046d 100644 --- a/include/linux/iio/buffer.h +++ b/include/linux/iio/buffer.h @@ -26,11 +26,7 @@ int iio_pop_from_buffer(struct iio_buffer *buffer, void = *data); * @data: sample data * @timestamp: timestamp for the sample data * - * Pushes data to the IIO device's buffers. If timestamps are enabled for = the - * device the function will store the supplied timestamp as the last eleme= nt in - * the sample data buffer before pushing it to the device buffers. The sam= ple - * data buffer needs to be large enough to hold the additional timestamp - * (usually the buffer should be indio->scan_bytes bytes large). + * DEPRECATED: Use iio_push_to_buffers_with_ts() instead. * * Returns 0 on success, a negative error code otherwise. */ --=20 2.43.0 From nobody Thu Oct 2 11:50:18 2025 Received: from mail-ot1-f52.google.com (mail-ot1-f52.google.com [209.85.210.52]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id EE1052E613B for ; Tue, 16 Sep 2025 21:03:58 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.210.52 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1758056640; cv=none; b=NU7hIaCQ5YaRDxP5qF47yXcWkcXsjBeId1xLdkFFCj7WilZiiKYkJhLL8flFbWhXdhKTbdS6Vy42wz4ReTl9P/WjgNIvXLNMVDpPXoBLyHscDRbtKZcqK/sqX1VQNxnb1qyCGjqixzBlC/VVQgR1ksVCQKFoaICy2YhtZihGYIw= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1758056640; c=relaxed/simple; bh=KaHoQw0mmyST/U0aIeT4Q9rI2vx9p1nFNJx02h4APhA=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=leEXmpkXGkRdgGHFuAxFNC6DhQ7SdeGxIigMYpwz2Vvf6DL233DNnKrNpx6JCeR3uI0Opvf/JdmpJRWd9a1tYRCUKf1yE8HGf5Ds9oGUdauZdCoX4V36XFg/62JfwjK3FBHf3trOm6mW1862kwe8+XYNbouJa4eMO1liJqXWkw0= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=baylibre.com; spf=pass smtp.mailfrom=baylibre.com; dkim=pass (2048-bit key) header.d=baylibre-com.20230601.gappssmtp.com header.i=@baylibre-com.20230601.gappssmtp.com header.b=t+bv479J; arc=none smtp.client-ip=209.85.210.52 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=baylibre.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=baylibre.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=baylibre-com.20230601.gappssmtp.com header.i=@baylibre-com.20230601.gappssmtp.com header.b="t+bv479J" Received: by mail-ot1-f52.google.com with SMTP id 46e09a7af769-750b77699b4so4616642a34.2 for ; Tue, 16 Sep 2025 14:03:58 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=baylibre-com.20230601.gappssmtp.com; s=20230601; t=1758056638; x=1758661438; darn=vger.kernel.org; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:from:to:cc:subject:date:message-id :reply-to; bh=/JMI9MVOYcVBfLvH8OZk7vA1oBEfGyZCnmiKgJ+DDsE=; b=t+bv479JewxlE8dYVspxeFJz1C35aN97vwuza9gZuR23w7Cm0gokT207ebjlTggbIT XYVvMPViFDzWjB6PtZg9fbOfYaAyx+GyEYD6JPz6+ah6xCQ/MGLtAXQEhxxx6OZkL3U+ qVTlulDAuVCEV2PESYDf8A0JQ6nxvSF9iPaiUBbjRhF+XhscVoBB+OF5GheG46AsaZQ2 RCFcNrRKuMfgvEePgMm0jMa+Z5MS6DHLPSvICQTQfhhBk8vXK2aZ/QQPh5+iTToUCh7u naYbXNcCPQ1nGcY8H3u4va22osrcd6Dm2Pc/phcADvVv2gNp2hDS6HDbUv3pmllpqc5c aoiA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1758056638; x=1758661438; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=/JMI9MVOYcVBfLvH8OZk7vA1oBEfGyZCnmiKgJ+DDsE=; b=X8SpIMJAEsbSdM4XgaxAH+k5adbHPetWgVT6cqE2wdVLy26psEWcs30HT8SEjMVVcw vMs9HXvaz9YqVjHO34BnvgaI1uS6t263ggSp43RDdle8KNsc4oN/EKOIScwYtBYZbCfJ pKzNmfrcOgHwcGX8/r+smTdoLGo8l8ETFzh5Turhn7NA32tWjoluZqYqM8ufCC8tvmG9 6NrR5QcY75nMvuXY2xfcsJvmPnMFQJ2Q5gS/UGVRnlZJG2fU2Yjm83Feq6CV/xSIVxrN yTnr++iRaBXAfeoWAjC0CpicPYO2Q2p5+ZZE6eUatZIqPxftp8SDGGIJ5QxrgW0nlugA /pZg== X-Forwarded-Encrypted: i=1; AJvYcCVOncNLFip3YorlySefvUMMFlcEwgpXLE/MelhGNlt139c4eOMPNPZRcU8hpyRoH+NaLBVymtxrQ5EMV+c=@vger.kernel.org X-Gm-Message-State: AOJu0Yxvgc+Auy/F+cKOGA2K1WNzRDxWZU+DPGZpDPeS/Huh5vy+9u9t /yCDdVY/MHDe/nkzvmTOBB3cMTak+EU4+mNi5rGviXf07ju4YIp6nK1e6kTcEDbVJXY= X-Gm-Gg: ASbGncvL+w+Q5/NDtlZbfw+9qd2p2tJTmeHbnQ26hGG8roc/pg1ygLQ3raARlJGUjcu ViNiTP3xWX1khlzByfLeKdJbWi0fOgv8o7ruczySMS+gdJbyy0BrQO+fDxtzRNQA/7/+F5IOEhZ BeJ5pCWn9rsu6MIJJLtnlghqJzIl69gx3CvNkCcPV0tvCFkKyfDW7DLjjuzQQw8yd+WQv8zO8UW KaOcx2k/vG7BJxzqOmtzkvj3jMmU9vQfKiuI+UAy0hFAho2z5O0nd2VrdAAvvCSOqSK8GMM1GG1 fuczJOaZrxgz9GmjnOhFiRcKwwfXmTTYDDto0JCKi5ZJB0z7otOmDJk8avx4yWJAsDATCQIEXTK zzHAcH370EI7hWYYWNuBazgawsfnN X-Google-Smtp-Source: AGHT+IGfNMNMW59wpHN4IoaXc/ymLE7uDVAYILCANvkVPKEkLuR0d/+yMizh+ypitx3t3N0ruACLYw== X-Received: by 2002:a05:6808:1383:b0:43d:3a08:cdb1 with SMTP id 5614622812f47-43d3a08d14bmr2302437b6e.8.1758056638038; Tue, 16 Sep 2025 14:03:58 -0700 (PDT) Received: from [127.0.1.1] ([2600:8803:e7e4:1d00:70a1:e065:6248:ef8b]) by smtp.gmail.com with ESMTPSA id 5614622812f47-43b8294ac06sm3540044b6e.14.2025.09.16.14.03.57 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 16 Sep 2025 14:03:57 -0700 (PDT) From: David Lechner Date: Tue, 16 Sep 2025 16:02:55 -0500 Subject: [PATCH v2 5/7] iio: buffer: document iio_push_to_buffers() calling context Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Message-Id: <20250916-iio-doc-push-to-buffers-context-v2-5-8b17937a6cc7@baylibre.com> References: <20250916-iio-doc-push-to-buffers-context-v2-0-8b17937a6cc7@baylibre.com> In-Reply-To: <20250916-iio-doc-push-to-buffers-context-v2-0-8b17937a6cc7@baylibre.com> To: Jonathan Cameron , =?utf-8?q?Nuno_S=C3=A1?= , Andy Shevchenko Cc: linux-iio@vger.kernel.org, linux-kernel@vger.kernel.org, Daniel Lezcano , David Lechner X-Mailer: b4 0.14.2 X-Developer-Signature: v=1; a=openpgp-sha256; l=935; i=dlechner@baylibre.com; h=from:subject:message-id; bh=KaHoQw0mmyST/U0aIeT4Q9rI2vx9p1nFNJx02h4APhA=; b=owEBbQGS/pANAwAKAcLMIAH/AY/AAcsmYgBoydCg3jaFLRJJRgd3BvUDQI2kvqM2C2CvcyxqA PlfpJhkfuSJATMEAAEKAB0WIQTsGNmeYg6D1pzYaJjCzCAB/wGPwAUCaMnQoAAKCRDCzCAB/wGP wJlCB/9VAz3ZXDQfl8rv00JSMhrWpf2B27PnUQviEzTrWLlkx6Mf22xXfiUK5ZAjOXjz8Pb26mu 0SeBpziJC+LZHgth2zDCOi1oDBDRG1uHU3M5pA1+rw0zkQ1zM9tY6STrkWIWnib5+kRYDGpQbVe tK3jXpe5ZeC5+clbHTdmS7jixV8PGoexoYTXN3igGri01mcoNppJk9sh3Lc/tsDipx5+3LgpVPB vAkdN5GzPZCg3682YkSj9MhplJyzM3wZYCy+ytMTrUQ0ZjrqUyI4oud/5SsYDJ/oRoAS2a7F0sL HdqDQY+n1ZWN1pYswQ5Fy3PTqTti8r/cz7hMXiaeJIAkDhn+ X-Developer-Key: i=dlechner@baylibre.com; a=openpgp; fpr=8A73D82A6A1F509907F373881F8AF88C82F77C03 Document that iio_push_to_buffers() can be called from any context. Also document the Return: value while here. Signed-off-by: David Lechner --- drivers/iio/industrialio-buffer.c | 3 +++ 1 file changed, 3 insertions(+) diff --git a/drivers/iio/industrialio-buffer.c b/drivers/iio/industrialio-b= uffer.c index 5599fa37b698dda6ff126496f62939331c12f524..f1448ae1b843fc577599fc1b9cf= 6d859bba226f1 100644 --- a/drivers/iio/industrialio-buffer.c +++ b/drivers/iio/industrialio-buffer.c @@ -2372,6 +2372,9 @@ static int iio_push_to_buffer(struct iio_buffer *buff= er, const void *data) * iio_push_to_buffers() - push to a registered buffer. * @indio_dev: iio_dev structure for device. * @data: Full scan. + * + * Context: Any context. + * Return: 0 on success, negative error code on failure. */ int iio_push_to_buffers(struct iio_dev *indio_dev, const void *data) { --=20 2.43.0 From nobody Thu Oct 2 11:50:19 2025 Received: from mail-oo1-f43.google.com (mail-oo1-f43.google.com [209.85.161.43]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id DF2652E8E11 for ; Tue, 16 Sep 2025 21:03:59 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.161.43 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1758056641; cv=none; b=dKDh7FgeTcCPJEd4sbfvqUr209mDalUTVbdUtHSVmc+yFGocL03fKsFo/S+EeQvDWRxRdhGKJptz4jhttFiIp24ecaq4K5EcLged61mFpi/1R9da7Vk3+2rWH5AcIdEkRw7debQEjMn3RmSmqQ4FqpZ4WBZY8gvXfySmUdmRJ88= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1758056641; c=relaxed/simple; bh=1rybI1vv2ITY3eTCg5sjd8Ca20nUymlp6uw8bi3cmFY=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=uQtEE/JROrNVXpNxc/bBw8wDYEF5AJKweVi+qHbIseJ/RPMRbrhptEbDHO6wKvreErd7ZksxMJqIiuCD53X5fy236Oy2X+XwtcI9gGAgPBrn4moHq996rMflg30Bm07oEcj7i/Lt5jK0CH1BAoGkN/T6re7VshCCrt1DGAaWiDM= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=baylibre.com; spf=pass smtp.mailfrom=baylibre.com; dkim=pass (2048-bit key) header.d=baylibre-com.20230601.gappssmtp.com header.i=@baylibre-com.20230601.gappssmtp.com header.b=Z+sQQf2F; arc=none smtp.client-ip=209.85.161.43 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=baylibre.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=baylibre.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=baylibre-com.20230601.gappssmtp.com header.i=@baylibre-com.20230601.gappssmtp.com header.b="Z+sQQf2F" Received: by mail-oo1-f43.google.com with SMTP id 006d021491bc7-621a79a580bso863704eaf.2 for ; Tue, 16 Sep 2025 14:03:59 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=baylibre-com.20230601.gappssmtp.com; s=20230601; t=1758056639; x=1758661439; darn=vger.kernel.org; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:from:to:cc:subject:date:message-id :reply-to; bh=JY9SnjW7f5B0pmsb28wOxPI4e7Ywa7AqmRhphChUkDw=; b=Z+sQQf2F9XmFUuDx+ilnIwAFPJccKV0J6fV8SvBtIZ4AvUedu0Vw7zjhf29R42hQW0 JmQMysyKXlhOSahINib5AmxicWLr1KZdDrOq/D9D5zHQfmgaGOCapl6K0ExH3hOd7QMH DUNohPVIbqnk4cPnW04RHxVGiaXLGu7p1Wdp6YCpF/HUgDxDHYxcVq2aJoyNteXfyryS GhhJUUT8E66S8u/5cZiRWrLv7v5HYxoyhNr5agOuP1Bwl6DnTf6MBaqIjwwZ5oM0a8bh fe1JboM/1vy3whrHCPRIYgoVdoBgQnhmfLoLvu4sWA/2G0Jk7eiUWbmPk7sYmoJq6aEJ bzng== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1758056639; x=1758661439; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=JY9SnjW7f5B0pmsb28wOxPI4e7Ywa7AqmRhphChUkDw=; b=d+3gwp+zBmuY+vUNG+ir9mgQ1vhEjSjrbLldJx1UH0ao6EAEoTEGsR9hXUfnapCoyw v+hqh7yTTm4Z3jBYHGV6/Fr3DNy6D+m1vjAY+jGc7lH62ZmkM9LTgzxbSv4FIgQDad3R ItgeBXjX/ms+qKkGrxEBXeNNKwb0g3bwh7USzpAXYWOJ1illdtz2msiLd0TQqgAte2VX gr0muLFQc7fCxJpRvqbLJVC70+S+5w9mPCSvfANn1dlNKOTrHsOOgMzI99YS9ncEppd5 JhbSMATktsgH2F7EfBNf9OlP4uvX63bhgSvdcY0x3QtK67B2o94LShmJFvwgd3594PZ3 5xPA== X-Forwarded-Encrypted: i=1; AJvYcCUzP8GVYwGu4QsnKTqMxORsZ19M0huz7fhr61fnqOqhimV5Kj86/Ir7iPjBcEoeLk5CJ6Yffk4ii9TaIao=@vger.kernel.org X-Gm-Message-State: AOJu0Yy60rH3nw8rB+IUoId90CEbDATfc4wJbrBCOZb2eZ8S58VOurH3 qmNL5yV95bJV7E5uw8vW+BzapwOvR6UgGzZxLdO9LrIxBNHmBsZ7UF2FIUFI8D0FHwG9/8ygAV2 mjnUVi4U= X-Gm-Gg: ASbGncv80d7yIOn1LP0z4qEQ/8Nd8oma0ePtWLe1sbyg+oICOmNkKh0cGzQdA7A8fkg FLnU7HcSz4cOuZod/TcJQy5rXwYG7MxTpTKXdY+XFxms5V4TdE0Taj6b5kpqSMQbY4pU1RfK8lx +sHxPSiJH3D//6/YDfjkL3Zsprms7+5kB8s8z/iBRiJWg/gCihBswPPgh2Y73WyG4NaqIrigVpa JYqKi1rM4MBHtmkGhRi08tAhZt2fI1e4DGZ6rCEIGe/1bcb2b3lWKYz5dBKBSa5JvlN7yOCn9Iu MHQUrLwrlA/SNEg2rWKi/og/PEYhFY69NdBbPprcJoIWnaXdl7b/kVdTfDiTZQofDwEYnQD6k6o 74VoJ7hURZnxqn+sqpZEucGqPSWeJ X-Google-Smtp-Source: AGHT+IEHk33BZosh1i82c+nkRqYDNa/fiAbvNdbuGZPqdth+nn/NaiG3YhHp0+u05SSLYemTqG3NNg== X-Received: by 2002:a05:6808:2386:b0:43b:252e:f7a4 with SMTP id 5614622812f47-43b8d89ef9bmr9876190b6e.1.1758056638874; Tue, 16 Sep 2025 14:03:58 -0700 (PDT) Received: from [127.0.1.1] ([2600:8803:e7e4:1d00:70a1:e065:6248:ef8b]) by smtp.gmail.com with ESMTPSA id 5614622812f47-43b8294ac06sm3540044b6e.14.2025.09.16.14.03.58 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 16 Sep 2025 14:03:58 -0700 (PDT) From: David Lechner Date: Tue, 16 Sep 2025 16:02:56 -0500 Subject: [PATCH v2 6/7] iio: buffer: document store_to() callback may be called in any context Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Message-Id: <20250916-iio-doc-push-to-buffers-context-v2-6-8b17937a6cc7@baylibre.com> References: <20250916-iio-doc-push-to-buffers-context-v2-0-8b17937a6cc7@baylibre.com> In-Reply-To: <20250916-iio-doc-push-to-buffers-context-v2-0-8b17937a6cc7@baylibre.com> To: Jonathan Cameron , =?utf-8?q?Nuno_S=C3=A1?= , Andy Shevchenko Cc: linux-iio@vger.kernel.org, linux-kernel@vger.kernel.org, Daniel Lezcano , David Lechner X-Mailer: b4 0.14.2 X-Developer-Signature: v=1; a=openpgp-sha256; l=1064; i=dlechner@baylibre.com; h=from:subject:message-id; bh=1rybI1vv2ITY3eTCg5sjd8Ca20nUymlp6uw8bi3cmFY=; b=owEBbQGS/pANAwAKAcLMIAH/AY/AAcsmYgBoydCnCE+nGFzQbaNy47/VytBgYM2YNKa1n8bAW xHGsn+TYj2JATMEAAEKAB0WIQTsGNmeYg6D1pzYaJjCzCAB/wGPwAUCaMnQpwAKCRDCzCAB/wGP wIGuCACEUGondLKwjNccm6CTYxyo1glKuJaW7oK4uWxOu61ouCVMy7zlFXhfjvV4enm4QJtMykD AOQT+HMJaXF2VOHT3F3ohZOc5hDds5ix0DUNi7NjzMm84I4F1xLO8E7/LpFxRzuzoQ0CF5wji4J ti14t8oikpcZVMS7Ez2r43vs+/Lf/nkhjzgoXteZ0kHF0YoPjD2FszS/zAk7IWgSzZQObtxMFqj 6DMflm3Cv9dP5cGC9sKF73WZsHLRLY4ObtnjO+2DczsFMdhHSxnupKXuhXRgSE3FByWVCf5kuv/ O3GsITZstGHDzm4hcU+jyAlfQeae/b8fWg4dWqukIH/K+QlK X-Developer-Key: i=dlechner@baylibre.com; a=openpgp; fpr=8A73D82A6A1F509907F373881F8AF88C82F77C03 Document that the struct iio_buffer_access_funcs.store_to() callback must be safe to call from any context since it is called from iio_push_to_buffer() which may be called from any context. Signed-off-by: David Lechner --- include/linux/iio/buffer_impl.h | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/include/linux/iio/buffer_impl.h b/include/linux/iio/buffer_imp= l.h index e72552e026f3a3c15fca04d26aaa91dbd27e17bc..0daff9ff20ce49de67fa0f2ac61= 91882de2f4a67 100644 --- a/include/linux/iio/buffer_impl.h +++ b/include/linux/iio/buffer_impl.h @@ -24,7 +24,8 @@ struct sg_table; =20 /** * struct iio_buffer_access_funcs - access functions for buffers. - * @store_to: actually store stuff to the buffer + * @store_to: actually store stuff to the buffer - must be safe to + * call from any context (e.g. must not sleep). * @read: try to get a specified number of bytes (must exist) * @data_available: indicates how much data is available for reading from * the buffer. --=20 2.43.0 From nobody Thu Oct 2 11:50:19 2025 Received: from mail-oo1-f41.google.com (mail-oo1-f41.google.com [209.85.161.41]) (using TLSv1.2 with cipher ECDHE-RSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id 2179F2F9DA4 for ; Tue, 16 Sep 2025 21:04:02 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.161.41 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1758056647; cv=none; b=GbAHYRfDlRrMA4jBIMWDowwPwvt3YUroBg+2cVjfH6PU0hNEw65XeOcFClAcWdVbb1u3UDai6gE9Ro1Tho0002aFWYMXNuXtu4SZf8d4BV/ArC81RCBVAnjfrJ8deMa0/yZc/Q8j2lcf6IY0BtYidmkrP1UuH7YX2N/IY4VQaTI= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1758056647; c=relaxed/simple; bh=6mdeYyd3hF07QuqGuLzQcOwjnfUK2lpqXDhP/AFlcKY=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=P/nEbffsP/o4Ag2SccRAWisPsj/YTS84IaknYrKwnP2hFIOhW6Fp5q8ANPuZssqm1t72Iyg5s00F/GwyRnlzV74vqCm1FbrDlB03JDACu/qut53MlvPFy5w+kT2nYcioxRjaURpZTnkMQI47FL80w4H54zipG6/GDffBCVGSeus= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=baylibre.com; spf=pass smtp.mailfrom=baylibre.com; dkim=pass (2048-bit key) header.d=baylibre-com.20230601.gappssmtp.com header.i=@baylibre-com.20230601.gappssmtp.com header.b=h5aOGJfg; arc=none smtp.client-ip=209.85.161.41 Authentication-Results: smtp.subspace.kernel.org; dmarc=none (p=none dis=none) header.from=baylibre.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=baylibre.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=baylibre-com.20230601.gappssmtp.com header.i=@baylibre-com.20230601.gappssmtp.com header.b="h5aOGJfg" Received: by mail-oo1-f41.google.com with SMTP id 006d021491bc7-621132816c8so2818164eaf.2 for ; Tue, 16 Sep 2025 14:04:01 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=baylibre-com.20230601.gappssmtp.com; s=20230601; t=1758056641; x=1758661441; darn=vger.kernel.org; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:from:to:cc:subject:date:message-id :reply-to; bh=zuUiBdYdOzhT/4QysYZeoKXL89SuD8knZroyb1BNveM=; b=h5aOGJfg4OJRznwjIgshyjYLaAF+hMYWs2h8rTC7TaDYdoJLUvFIiPKPDT1FnSk05W k5oScwJEiM7Hhh9DlpaP7oQ60kOBTD/4J5M544qgooZKiuninpTusKYOmodW2jOFFITx 2niLX9GfAwrf+lZisftqj/Lj01B+eO0OtNHssh0dICPNs+N9F+oEZp+P2kV0VeTdUcMh FAvlGHxCy4vqZFfDxegAnAw+6NmM+JYLJ/SIF7LJQ0nQvK1Og57hW5yBFwVdhK0Zm6Z7 hfm2AL7nMGa2qDAOUwYxfzXVtjCdVZUPmSwplDKvIhzPfeIhq3BH/ChRmbfXhCyMMaQv CWFA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1758056641; x=1758661441; h=cc:to:in-reply-to:references:message-id:content-transfer-encoding :mime-version:subject:date:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=zuUiBdYdOzhT/4QysYZeoKXL89SuD8knZroyb1BNveM=; b=qu9Lwayp2HqPD3xux17NLMlLh5QS62gucgbk97BCO83kl3AEKpf+9GMSlBwY6mbEl3 NDiV3TBrtndHc18/6MGJh637oFZzw/+1SimRX9rvRrghFpQM3Ty2OmL1E6mqqHjZdDLj Puqg7HM08yjY+adUW0emUeJLpscha+QE7FCkmUgOazFo+DvWuybW3P/vOQS01a2dHkqO Pu1CQeJitW5+WMoBxNPesQEtKgje/ZIut+wghIx9Sm1IX4rwSWQVKjuUHVi8GPX8dVKw rDMuvvhANVOoqA1kqML92HVfsCCMXKRqDiy1rXHQenFWhe2/3PdNiDLRMD+O4qjIaKRN 7BDw== X-Forwarded-Encrypted: i=1; AJvYcCXasJMLP5NSxwTlvI483fuCv5+oVFU+I1zfy5dTQvkCPExTZ7xQB2Kaw1lifCnRWK71XfRY/qVas371L8g=@vger.kernel.org X-Gm-Message-State: AOJu0YxBP8yz4TuZa36L69HMuOSVvCqzbwesvGsMLXF6//7iZWMzqhFN LXuWwkJwCoJcyWDhbXNeS87GdbHxsYt68WMx8ukxy7SCVVNU659SAQ/iKgs4gajeSPo= X-Gm-Gg: ASbGncvBWuk8XInLnPip0tJgragdeu/zOPZGiXzpyBkd/Oj/gORPgod4a2zkj6TXC9P 1qHwdwW5j3WdRJdzgHfBI6bFQZvdh6cP2S01oInNQTaQJTU4kQOrUd1VV0l2KgEcDV04mOXemiy vkhvRzU14F0nCfL3tMY/Zelwrp2xvd/8BgmByW1ifAXa+VOJTYYOEHx/sPaDGsSJlV1+aJGHRXe wuRnL9nEVI/sD4NGTSHz62E47JDt9OIzd7xkxPVP0T+GxSMhaChs+EDuLBMbgTyxCJORrulS0M4 pQowJEQmBZzlAfRcwP+ghKBwinbTP9NJg5ZVsgt9MU0NUQoxazu7Tmo83JUIPmuPrktDw1sZaQH c2R52efv7cIQWBBpZ1uP+de5xIhUq X-Google-Smtp-Source: AGHT+IEThmTUM++mlzzS2GM17+096Q+59Aps0AMQsj3pnAzcqsCTdD0X+SDwFBXwlrpK1soPiyj0Ug== X-Received: by 2002:a05:6808:1302:b0:438:3b69:ab91 with SMTP id 5614622812f47-43b8da9ed09mr8658219b6e.50.1758056641220; Tue, 16 Sep 2025 14:04:01 -0700 (PDT) Received: from [127.0.1.1] ([2600:8803:e7e4:1d00:70a1:e065:6248:ef8b]) by smtp.gmail.com with ESMTPSA id 5614622812f47-43b8294ac06sm3540044b6e.14.2025.09.16.14.03.58 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 16 Sep 2025 14:03:59 -0700 (PDT) From: David Lechner Date: Tue, 16 Sep 2025 16:02:57 -0500 Subject: [PATCH v2 7/7] iio: buffer: document that buffer callback must be context safe Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Type: text/plain; charset="utf-8" Content-Transfer-Encoding: quoted-printable Message-Id: <20250916-iio-doc-push-to-buffers-context-v2-7-8b17937a6cc7@baylibre.com> References: <20250916-iio-doc-push-to-buffers-context-v2-0-8b17937a6cc7@baylibre.com> In-Reply-To: <20250916-iio-doc-push-to-buffers-context-v2-0-8b17937a6cc7@baylibre.com> To: Jonathan Cameron , =?utf-8?q?Nuno_S=C3=A1?= , Andy Shevchenko Cc: linux-iio@vger.kernel.org, linux-kernel@vger.kernel.org, Daniel Lezcano , David Lechner X-Mailer: b4 0.14.2 X-Developer-Signature: v=1; a=openpgp-sha256; l=1632; i=dlechner@baylibre.com; h=from:subject:message-id; bh=6mdeYyd3hF07QuqGuLzQcOwjnfUK2lpqXDhP/AFlcKY=; b=owEBbQGS/pANAwAKAcLMIAH/AY/AAcsmYgBoydCttq6RvmTZHapP29zuCyinYPpvWDq5o1dGF 29WTFK09xGJATMEAAEKAB0WIQTsGNmeYg6D1pzYaJjCzCAB/wGPwAUCaMnQrQAKCRDCzCAB/wGP wDLUB/92zOe0kO9ppzodI74aYR9FNSaUt/TvOjLFc1GmaR3PblmKWJ4ZOo/YbGDfD9p5xaD08wF mtmHDt5X+NYKOGKRIZa+qUXi3MXdQk2Ji9iu6q5zpAAz3+617cJwOX+ZcF4mN+kTotzHnrLQrQb FPoL6gIXPKfbYR1tYJ5Cg4eslkpn87OC2Er6I/yNsmKBxcN0lapsQhoddTxjRYDL6ljSJNhWThP Foh2qQEJQBHTr1s8Yi9obAjbTXSTwCFXiHRoVQ9DS8lFV8MbIoiGroLYqiDv+/EU6LCEsbVIHU6 j4xDgvtpohHD2migse5WmWL950+x7kN6VmEHOKWtmlAkdujt X-Developer-Key: i=dlechner@baylibre.com; a=openpgp; fpr=8A73D82A6A1F509907F373881F8AF88C82F77C03 Document that the callback registered with iio_channel_get_all_cb() must be safe to call from any context since it is called from by iio_push_to_buffer() which can be called in any context. Signed-off-by: David Lechner --- drivers/iio/buffer/industrialio-buffer-cb.c | 1 + include/linux/iio/consumer.h | 3 ++- 2 files changed, 3 insertions(+), 1 deletion(-) diff --git a/drivers/iio/buffer/industrialio-buffer-cb.c b/drivers/iio/buff= er/industrialio-buffer-cb.c index 3e27385069edb5b717a4c56e72dff2c0a238fa07..f4ebff9684936365ec179489d90= 41d8bdbe58738 100644 --- a/drivers/iio/buffer/industrialio-buffer-cb.c +++ b/drivers/iio/buffer/industrialio-buffer-cb.c @@ -13,6 +13,7 @@ =20 struct iio_cb_buffer { struct iio_buffer buffer; + /* Must be safe to call from any context (e.g. must not sleep). */ int (*cb)(const void *data, void *private); void *private; struct iio_channel *channels; diff --git a/include/linux/iio/consumer.h b/include/linux/iio/consumer.h index a38b277c2c02cb85a766d645a046bdfa534db51a..5039558267e4c17b2e09246036d= 0df352e242d06 100644 --- a/include/linux/iio/consumer.h +++ b/include/linux/iio/consumer.h @@ -131,7 +131,8 @@ struct iio_cb_buffer; /** * iio_channel_get_all_cb() - register callback for triggered capture * @dev: Pointer to client device. - * @cb: Callback function. + * @cb: Callback function. Must be safe to call from any context + * (e.g. must not sleep). * @private: Private data passed to callback. * * NB right now we have no ability to mux data from multiple devices. --=20 2.43.0