From nobody Thu Oct 2 18:15:48 2025 Received: from mail-ot1-f47.google.com (mail-ot1-f47.google.com [209.85.210.47]) (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 EDB6630EF64 for ; Fri, 12 Sep 2025 16:06:54 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.210.47 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1757693216; cv=none; b=SuKnWftICz2SD2fIeyJPm588K+AzTVk/X/RuRMwPwJfTh3Ng54CT8xnuxHVJh0CXGxDs3EtiTJMZU8VKAj+9ZohzLd687i8AF7VfJ5Jt/DOkIYDhmdcInOPBN4SUj7yG5jOoTeWe3Y1oc7wOZWvwuygPWTuEuZSoptIk1DSVFOE= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1757693216; c=relaxed/simple; bh=HnuQ+TkaU2snLpnK9vKwpR+SRQ6mSUlBuodkaXdQJ0s=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=SaZPaxJ5UVPFUL65B91KUXg/M+/pq/Q87r6gihZIrHZ1H2gtC3aNq+Xn5681K6hElLLiVXeIS87wXdOeH651yArGEVo19gXc4L+qj0UqCOito5Tx8YnA4bbcl11agJb3mKQPSUufgXmhqTQrX4Zm5VmT34DKKON1VjLJvRvl60k= 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=YNmnI7SX; arc=none smtp.client-ip=209.85.210.47 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="YNmnI7SX" Received: by mail-ot1-f47.google.com with SMTP id 46e09a7af769-74d3389cd7eso690505a34.1 for ; Fri, 12 Sep 2025 09:06:54 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=baylibre-com.20230601.gappssmtp.com; s=20230601; t=1757693214; x=1758298014; 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=tVWBEP36MuutXOJ2sHz8OS+ojTXGpyXc0pw+qLA/60g=; b=YNmnI7SXGzNKvi/ISkAv+RSVIhDoc68SfTmzdwDYPF9us960C8IwLuHvcnYSsICB20 lxX/L9NstrOepo1Tz+aAcoVwW1uvGlp38eEYDcahKfEo6J4wo4WiLa68tfLnOWJZ8FJA LRgBvTYuzonlXzDw8+T51uwi8/3mD2NMXaEtaYRmtpL1kCvY5Bz7v2IdQ2i+CpbW4GWW IAembYlP9mcYTVyTgL132eG7EHNe+u5Iaw+JrpxzKMpF/ev+IhhYcKMOD/hClttUxjdZ bnvCPMjoczIWLBUAXjgL0+iBjdyb4V4VXexoY1xhrDejV80vSeEmsO79gQ8FEwIafcip c1oQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1757693214; x=1758298014; 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=tVWBEP36MuutXOJ2sHz8OS+ojTXGpyXc0pw+qLA/60g=; b=Gj1JJuHN4+1NfMPS1uZ4ymLfOuax+zqPgIL0CPV1dnfUwpHL3w6/5LO4QN8X09jR+H nB5FFBi6y2ZZZrSCnoy6JCNoNhy9JhzBdNwJv6mnjpDtBO/j4Hyh0R/B6IpPhXE/def/ 4UHtcHoFgf7uO8f4YvmD3ofdO3KFoffg7aY/TcfOIObuWWU5X6ADsXA5XxgUuTFmpJsI LMh/DiJWNjxf+L4gsrpp/f8Oj/MNEeckecrc4SG5LGsallbFtWSy849Rtuuuuzt93cb8 7kJy9dO3iOCsUfQ/uDsW4hicoi/TrYvwM7K6rZt2+JPhfa+b6jogGKwSKU3erbHR2S6X nrjw== X-Forwarded-Encrypted: i=1; AJvYcCVveM7NgfCt+qaCkWULkXA1+4q/xjcin0zidu7w6Cc+UnWmIElp2e5ycpEv3E2zl9+wYoGv8TcuqLZfLPg=@vger.kernel.org X-Gm-Message-State: AOJu0YyRQyuYB8BYPr6StKuvave96nOIQaM4hTNXtp224Hj9D/mpsUoG gnpkJHV2pGbZmecR+0ywkKSy6boMm9UBIuldiv6TOXkZqzDTUB6OT1w/jBcqg0XDJHg= X-Gm-Gg: ASbGncs9Y4frb+pxA54cjRVao0aIPccT9Jth19nL3OY5LixLo8AQCdHL59SfW9h2uOW ktAzMcmogidTvl7tOm9YjuJrQdPf+nSVKuKcOgfxyzmjRXgUwSpexWd+KZrSbTPsr9IDI7l4nlm NwKQ5MxqOFdZYLNnBLo9tSb84Hvd2Fe9Kvs4/fRvyYJeNQSL6CNtcGvS6SnTesJsmcfZszUsCYq CUSLsj7sk7XKBQ6Mc2bvOAOwkUAbWAIkE+PSnTSXgdwCWjraRU3qPMNYeLKp00LIc3ytOJZ+huV ZX1wZnAmjVuwBlgRr5D+myo6zqR0aLzKfLAQ3w28HTlTXf51TO0ALYp/FR5WHMWf9lG2FCXZDE+ bUwqoUq9Ph7kyaJpCg1f+l18rBZYu X-Google-Smtp-Source: AGHT+IGeM+CYMUpEcZ24r4ZKd4sVaJiF4l6pF+Y+dXMOaA4zkK9SGuAO6TPmM+gZCQqUURx0Ga/Syw== X-Received: by 2002:a05:6830:608c:b0:745:9769:ea51 with SMTP id 46e09a7af769-7535b3535b6mr2051528a34.9.1757693213913; Fri, 12 Sep 2025 09:06:53 -0700 (PDT) Received: from [127.0.1.1] ([2600:8803:e7e4:1d00:fdf1:f11e:e330:d3c1]) by smtp.gmail.com with ESMTPSA id 46e09a7af769-7524b8a39ecsm1073863a34.23.2025.09.12.09.06.51 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 12 Sep 2025 09:06:52 -0700 (PDT) From: David Lechner Date: Fri, 12 Sep 2025 11:05:52 -0500 Subject: [PATCH 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: <20250912-iio-doc-push-to-buffers-context-v1-1-c4aad013d96e@baylibre.com> References: <20250912-iio-doc-push-to-buffers-context-v1-0-c4aad013d96e@baylibre.com> In-Reply-To: <20250912-iio-doc-push-to-buffers-context-v1-0-c4aad013d96e@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=1107; i=dlechner@baylibre.com; h=from:subject:message-id; bh=HnuQ+TkaU2snLpnK9vKwpR+SRQ6mSUlBuodkaXdQJ0s=; b=owEBbQGS/pANAwAKAcLMIAH/AY/AAcsmYgBoxETp+6md8mJWssX1SSdWOWoeoKGUIt3kiNN1W WRFFP+wto2JATMEAAEKAB0WIQTsGNmeYg6D1pzYaJjCzCAB/wGPwAUCaMRE6QAKCRDCzCAB/wGP wHQDCACCdxTb4qkaDzQzvAtqHBw7OqjnneQI+T8fuZqQSpGhl65KizDftuHhsHk6RWLBKe7AGdR av5/QYyoAc4HP/736f0X061nBrCjaIAt01UemyzbgxfSBIwJi1IuyF2IIkhcHhcBEfLFceq6t3K 1HVjSIHECRdldlpsYdtsjFBLlmGC3Ljtaz09ePNfpYB/jVYt+bfhwPx1/lmQKUWOQcJKXCgyZZ6 j0c62LNUvokHnaojUkGIOqNPsqz6EkHk1GGJJHwIjCsiDW9T4q41j1ktlsONwEACNRLq9T9WZaQ zRAJ4l/LRxDZxsmg55rnFbprvUfkRe+dqUcRJ5xwXPA7kSpO 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 Signed-off-by: David Lechner Reviewed-by: Andy Shevchenko --- 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 18:15:48 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 A9C743168EA for ; Fri, 12 Sep 2025 16:06:56 +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=1757693218; cv=none; b=V7tnUP8fMi2EmKFftC7J/B+iMoFqE9WxMNTeEVbOqB4bz/E3jbrQ/hGyyzlSp1xb0jsbf1UWGIqV7P4N0NbgbATj0Tl/CBPZuuweHfi2BiwQjn9pLps5nE+GGDFIUMthSwRQnPr7BS/vGu7zmb2NxBYEI8a2r3RAZjOT6lwfBNs= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1757693218; c=relaxed/simple; bh=HoTnMUccGdCvWwXyGGvfMxbeyG3DCTAB887pRo015M0=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=TYShNaCNC7W0s/n9RbNgKvPnwpeVujfDELNTlB3em0ZwxJFF97jrOAUQnYoX57xyEmeP/vgEBsoFrHr15h/heWPrksSR+ONlPVQ7lETpB4SWAwdrxxOKTKiNKg13qqhz5TkhUdeRltYpkpJ+VFE9W7bctkZFJGrNyk5hGZY9U9Q= 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=Cm8pqs2O; 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="Cm8pqs2O" Received: by mail-ot1-f52.google.com with SMTP id 46e09a7af769-74382048b8cso1763139a34.3 for ; Fri, 12 Sep 2025 09:06:56 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=baylibre-com.20230601.gappssmtp.com; s=20230601; t=1757693216; x=1758298016; 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=Cm8pqs2OvPdH5sF5FR41yCK6IFktodNX0gdYPqukF0rXOPEtXoT1NRQoL68iXlCSbS TiIpVhT2NC4WiOAaJqGtyCPIYfDKQYc9aTp1c5yxbnJKSt/pUWdO9Y0E5fZsq3TLFKvk 4WPjSVmKwOTGSSHzIQzTlHqKZY18yU4Bh3uV7wuXGvnlAtnu06RiRxzgmZWF7i+YKeZQ vTANbLEwYGnj/2Q2f/MxNM/fSL7kmFcaW7jBMf5+T7Ng7lKDG6PnlbIo3LwBKCj3mFha kF7A3zMon5puzA/HnyPRLROM+p+IsdFkO0hInWPUR+8iDUkrCKheZHE1XtI8N674+bAo hGYQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1757693216; x=1758298016; 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=dSLXWd0z8WrT78hPtxtu3vishcUDCaaWcYPZtHhhK/Cwv13I/sY8VX20YPUsAQB/ix /GaYrZF5kYmtkpamFr+rkukNYJhcSrp/uqJ2BZ0grZ1zg5O5m7R53tCfxYFydHYsJTwy Y8bBvUad7Gr3K45sumKTJ2ujfXSWi4zh3RgkJXNM3U2VQJy/jKgHC+OLnElUY8XS1V6L n2HF+F701Wfy0G0GeLIt4CDUtVJNVFM+3v1E4JSzB+tsP9BJ/tnAScoTn+yd5JcN4W0I XmOH+lgf4LeREgP2O+0Bbj8uTci7vqwPJezq+w4WNpycEB4X36iSLyjTisbIAwgUiMPm Zl6A== X-Forwarded-Encrypted: i=1; AJvYcCVLK41gV9Ryt0aSuhZuKHftS0QqwBTQNKVMERicuk8h5CZLVWPBYPDd276WSi6B4bB+u7IOG6gxbIJbAIc=@vger.kernel.org X-Gm-Message-State: AOJu0Yyg6PezHSYky/Zehx6uH/Lk/5otllLSuuM4LUkLJkpvndUsrmBv Dz331dpvFJYZV750He03ez4Z6nUr1k8KjOoiZw71rWwxtXO2DLwLAnnSvq25M5uyAVQ= X-Gm-Gg: ASbGncvWKUtQsXY8F4gD/za+4gYo6VeI5SZ0uG92AgfzTq783NFumVQd+g6IWNH8HRu J7hB3qPXGonk8gtwVqrKsulr61O/xf0TyiZAbSLA/S+lhRU5vG6mw8eGISyw8wtipa8oJQyu2Z9 jMzt1eBsZ+KY15NHfzbNRnVjooKj3Rl13ghz6MbnGS1b/DdTPLJjmTxl9r/lj486G/cLSjZdrP+ 02NQg8odsUYu6iTmNmUUAne8kaivXTakl7XHY8xA8o3qRvncyWYGnGVReyWWAkMk7Roi9E7pU2o Xu5FfBAGPNNQMCD5GxNQefSvCuLb4H1t1oAWHBxj5AUmzZ75K+3u1fM9vx6e123EAB4fzo8328G A/ikI4DuKykmMA4uoNXPjPQe7aHOr4EHSr6hblUE= X-Google-Smtp-Source: AGHT+IEs54PO6N0rI207rx1HplFfPlWuO/pKvW4GXQTqH/1uT1Bd1BRiYYZhzYSgWeVoLnAZGg8V0g== X-Received: by 2002:a05:6830:82db:b0:743:9758:113c with SMTP id 46e09a7af769-753532776c3mr2042722a34.12.1757693215709; Fri, 12 Sep 2025 09:06:55 -0700 (PDT) Received: from [127.0.1.1] ([2600:8803:e7e4:1d00:fdf1:f11e:e330:d3c1]) by smtp.gmail.com with ESMTPSA id 46e09a7af769-7524b8a39ecsm1073863a34.23.2025.09.12.09.06.54 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 12 Sep 2025 09:06:55 -0700 (PDT) From: David Lechner Date: Fri, 12 Sep 2025 11:05:53 -0500 Subject: [PATCH 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: <20250912-iio-doc-push-to-buffers-context-v1-2-c4aad013d96e@baylibre.com> References: <20250912-iio-doc-push-to-buffers-context-v1-0-c4aad013d96e@baylibre.com> In-Reply-To: <20250912-iio-doc-push-to-buffers-context-v1-0-c4aad013d96e@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/AAcsmYgBoxETw258yNRARhwR77D2UgPbrc/zmisGccaZuz rySZbrjeWSJATMEAAEKAB0WIQTsGNmeYg6D1pzYaJjCzCAB/wGPwAUCaMRE8AAKCRDCzCAB/wGP wCvfB/9tnxLNQhNprmYBwwnum801uPCKAeES0y5nk9ybnkP+83kJv4h0o/fgYuUodKFWxPpFkZ2 hbthrxGiW3DFmubTSz2pvIZGkP7J8EfZ0L6TPvxxeMJsvDXtpZLS2rs9DXz1qnj/HoRzpDaYsV7 t0kD3OwzvmOtNTd8EQc0W4B5ztjFV8IZex3vj9H2h23GJZ5c/QZxNkTOzFAjh9xz//PPhWWgeEQ czVvs8aYh3htKfECNbx7abY2Au1xpsd7nD0Mlq+SvWKmDXGvEwYHnlC/Z0XXMyTFby/9hMnk2q5 hxS73CmdN/6DkHWB2/V0ox4j23W+TU/tUAWyirU9hQpXapho 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 18:15:48 2025 Received: from mail-oo1-f48.google.com (mail-oo1-f48.google.com [209.85.161.48]) (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 7990531A57E for ; Fri, 12 Sep 2025 16:06:58 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.161.48 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1757693220; cv=none; b=VvqVjxc9hfKXRzJHCH8rDoBlhpOQqzX8YVec76dr51YHzgMebW3rVCPuPu8q1o+BR2qdiWdVqzyMIyqQmYAD/8qikGFpv4PAnmBxIdQrKyYf7k0AWGuYkyoYBw9S89Ul9yb8eCyvIfOcjmTvEGQ5wwH9l/hmMm/JE+cmUDljmAg= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1757693220; c=relaxed/simple; bh=wgqfUfWF7jEGgoJYsUs54G7JmNvVkPSVGZwCRcZx54o=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=TMvk5AmjxZvxNFELnUz6Ao+Kz36bXEJvtuWvosdZauuRA7HWXsDVTsIix4tQyrQ6ZniXM2pgcjLEQMsU/7Odr6xIWcF8trNicMVi6FVqGtZ155pCX3Fn9PVefQCs+rqenUmh/Pg5nqE5otVX38izcNKaCbslxPfAdvpEWHvGwEA= 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=LvaX/p6i; arc=none smtp.client-ip=209.85.161.48 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="LvaX/p6i" Received: by mail-oo1-f48.google.com with SMTP id 006d021491bc7-61da7b78978so1270944eaf.1 for ; Fri, 12 Sep 2025 09:06:58 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=baylibre-com.20230601.gappssmtp.com; s=20230601; t=1757693217; x=1758298017; 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=1a/egVhw1YA9XEPwEFf5c6wfXJhZB+PsLVwg4louqXc=; b=LvaX/p6imqq3ZDwgPoJHiS+4M29mejUGGJunL73CqYi/25ezuDW4SCC9h/nZWn9SWu /Jp7C9/equ4Rxz76iP0MsAH21qfFsG9TBP21uxEx9hJqSgN0qJyf7fr86hhxFE8bhOAe 4co8yurEqOHeUEKrb1Z9BbIWCxaq/p2/HghM8JvyEDs+V1dtYQydO3D0KRWi4KImG4kB zCBTOTyFgYIPB4zXJkrBUSpZEktDpd17UUDjrV/Ve5kSvJJJg8Tw/nOK2Xd/8MkpOFEe Hbuaj9Qt1Qy9cCcvZ4iAt4Zl2oANFGdwH9YVuGeyF1Rv4WdCFHfydSvGRoU24d0oh6zo XtdQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1757693217; x=1758298017; 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=1a/egVhw1YA9XEPwEFf5c6wfXJhZB+PsLVwg4louqXc=; b=mOuMYZK8/A2UACFPrkxmZxkLnx45oqC4s/2Vh6KMpKsbPj1l++wWI5NcqiE5dDyyPj gOE/0zpIFfraESnvt4HSV30gVgYLUm5fScYr4+XoDoZnTZ5FH9cNyhAsA+64plfE7Ztx F1eyqZiAOjXAXr+6Wx0ap4v3nh8MgB9zu58+QgzmUYaAnnvHyG5yLFxDwNDlJkRoXab4 a+6DffohmwnF3lRZwFAX0b9MlVJovE1BM8HLDUsmX3+g0vBYkSlaap9q0DuBa3LpVezL UgjTZMXzSa8oZzHKiDDBAuML+7uX+8C/iFq2CAvoKS+k7Vz58ppwRMJSICaEM8SFAYCd x9Mg== X-Forwarded-Encrypted: i=1; AJvYcCUqyoQXOzG950OeWTe9cdjwSVT19yE8zvgPeg1Cvyh/BCVdOaDi7QScyUiVcPv/BqJSN1fRMV4paw6aQck=@vger.kernel.org X-Gm-Message-State: AOJu0Yy5ZpFGTE606tb1LP8wp2Wc0l2aWLM6HWM3rsY/mAWo6gWCSpkM s6sujokzruKrvirZXVMKQ4pLjfgSscedC2Y2+d/Y/1wpFJv8DwLq6iPdt7hz955lDY3B3XfDokt 48WEzDQA= X-Gm-Gg: ASbGncvLZxpXarkszGRd1I3dgD3t5YPPcN0czIsSGuB6sALWG6uGgILixpRr3Y0S6Kb 3CuA9zoekEtTAa21GfDhDV5n5wdu4ECSPWnoLcBJLJUBmdPqH3GtLIuz7Z/f6gKatCAIxPETU9Z MMfHdZd6aRRrpbmx/3YDs79yTTacjuyzgycsZOWTR1KMeP5w7XMMkW4HoFnBVG7NXRcy6dhStUC 1Iei5FPf/DPT0JtHZ1vVZfHdMTXVoWB0BSf4yf2Z0kWewqwjLgo/v/tt0z1HasiHyFCFakg8MzU VHhlbG1HxnjSCibEkWDFrPVd9bD/QmyU2GqbhJLCa/aMHOhzobsftKWKI3St011SzXcokgcwAP3 k1x6fVYNITqLjYNJ0lEp++9LcmYwZsm/M6CirfU0= X-Google-Smtp-Source: AGHT+IHigd2jjiy4hIvztLr85kYtqjWmnThzZQBiyBS9hZeg+84NFfEdIUIItNgkQz2LBZS0KYVvTg== X-Received: by 2002:a05:6871:2312:b0:30b:cc6d:bcfc with SMTP id 586e51a60fabf-32e56bc0ab4mr1873512fac.27.1757693217545; Fri, 12 Sep 2025 09:06:57 -0700 (PDT) Received: from [127.0.1.1] ([2600:8803:e7e4:1d00:fdf1:f11e:e330:d3c1]) by smtp.gmail.com with ESMTPSA id 46e09a7af769-7524b8a39ecsm1073863a34.23.2025.09.12.09.06.55 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 12 Sep 2025 09:06:57 -0700 (PDT) From: David Lechner Date: Fri, 12 Sep 2025 11:05:54 -0500 Subject: [PATCH 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: <20250912-iio-doc-push-to-buffers-context-v1-3-c4aad013d96e@baylibre.com> References: <20250912-iio-doc-push-to-buffers-context-v1-0-c4aad013d96e@baylibre.com> In-Reply-To: <20250912-iio-doc-push-to-buffers-context-v1-0-c4aad013d96e@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=1601; i=dlechner@baylibre.com; h=from:subject:message-id; bh=wgqfUfWF7jEGgoJYsUs54G7JmNvVkPSVGZwCRcZx54o=; b=owEBbQGS/pANAwAKAcLMIAH/AY/AAcsmYgBoxET3BjmASvGErf8MKEJBIgySZjWdbsbmXN8y0 Mj+P8CTE+OJATMEAAEKAB0WIQTsGNmeYg6D1pzYaJjCzCAB/wGPwAUCaMRE9wAKCRDCzCAB/wGP wOhVB/9Q/L9T108CUfDCseEhbVd7ZmY7QY9ZmTcGxaeKddl+EVmf5rzJ6EY5rO3mYJNR6gMcRPI G5YXtif7CtnF9VqhLkwsnNEgiOSZxcB6SbQqNF783dlscQVauoNMzk665CVflu+PwagURjShhIh yT0r69u5psFfp3XJbXW6TGzRgXs4FKxW0IH0IAAy+4b3cBZzHLj6kjB9nFzZ4TlywqXpnMveYuY Y70IUMNaZ6UcqlNf+KTYzFg8RAshpcf+65lMHPXmnzgKPHcvrrmGegc07F6FHLlEw+DXFSKcqjO f2iR5DlVjY6EAB5bDY7vrQbdC7baG6EDoarU1NchwnTilqmF 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..47f23bc0470eaf308fc3a739faa= f9b56cac0ef67 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 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 18:15:48 2025 Received: from mail-ot1-f48.google.com (mail-ot1-f48.google.com [209.85.210.48]) (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 608D031CA5A for ; Fri, 12 Sep 2025 16:07:00 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.210.48 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1757693222; cv=none; b=EBIxhGRngCGR7Y//YYavD+8Zbc4jIpKU+n10V4U2DDImNOesy3wx7K5Jgqs4RNbAnJRRKdZ9OalqN0YIf2coa0AiqeuJUvwKPcZEtn9IM9fHvxJrnn90ryRdqwrrDcJoDXRFnDGyNd/A22sBbI4Tfit+UKUOQu+dyiOKVlncTBM= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1757693222; c=relaxed/simple; bh=7TqvcYTMBp51/HUM9YZ5b9Xwf4ZwYLxzxeeJRmV5Wp8=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=U3XyNyUDVcQOu4ED+ZGO0HYebViiTGFwuc0hXdQmVPKWYgsL8xedCRARCUPV9csX83LlYG5F576WheYB987E4aZdlO/R2gGIp2wkY6RcYInG9jupyKXKkXOrnvspqp09C05UmLtfl/1LvleNm1houDe5w1k2Bk2ZAGcJ9VyXR+E= 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=ApXI3buA; arc=none smtp.client-ip=209.85.210.48 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="ApXI3buA" Received: by mail-ot1-f48.google.com with SMTP id 46e09a7af769-7459de59821so1898037a34.1 for ; Fri, 12 Sep 2025 09:07:00 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=baylibre-com.20230601.gappssmtp.com; s=20230601; t=1757693219; x=1758298019; 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=qarimMMaMap40cHQ862INRj1ctQccJze110lxw4H9TE=; b=ApXI3buAH6MS6fB+GlsXaD/0SBig6KoammngD5DbWMgRcz7ntvKXbq1+yx+/Zc9oF5 l6d5IcdwZooKmkUHxCtmeF1qRjxD8OkwthnjVIrjpMXFgitWZ62kMNN0yPhE2AA9Kb7C NpFUSz/Wjq2ojjvOuDDyK40dZDEXigcCtBXcnEsUH/AFnZNE08HksjhCoB0al9IvGm9Q BLptMVRCuatMoPLce4jglYr/BYL3NbFw59vyWzVMkdAxFPkAG8jiXR/DgJB9uWNPhWtU ObYRJO6QkR20VnIL3FSYGOx+lzJmpUB1dJkaBz+a12QZnXzXcgUgK/C/3uCxG1jKEIpp FDMg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1757693219; x=1758298019; 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=qarimMMaMap40cHQ862INRj1ctQccJze110lxw4H9TE=; b=bwe0/JhNVYW0z9UVc0mWaj48ABqVasAQQYvVU3IoIyqKPX8vuOpy84fFkI8Tjp+Wu4 Acg0sMoOXElKX3N73eTNlHcDbkkLlxlczIOMqMri6BKzkq6I8B7nchAx3ymhOyM4m0yD zp9+7gtxBRsmNAzo19mabBfeQhDNibpi9UNOXajZMYfEh1SdC4HTtYBSo76nLksjj9X4 VhwoVazO9fjZpLM/9WeElMKRFoEvCTD9hFY8wD9i4VaNFux9Pt9NBW/F5bAno21tZH1/ 4EUl/iFq89DyzZ3UAS2hPk/GPO9aNwb3sSkP0jtKjo5c3bFi6SqfofzIViYWP0ddi6ik LE/w== X-Forwarded-Encrypted: i=1; AJvYcCUMKnYJQh9rx+TWtx/eTQ4ZTLwnQIfNE+7BldrPYDdJf4JHb7mdaX89uSudPSaB/3ZspHWf/Z87rb5Dljc=@vger.kernel.org X-Gm-Message-State: AOJu0YyhlkARgpA+e/UqdK3KTskjJ/6mdhQwQ8DDbsyh4fJgkzUQlbnl +A3zBUvCxFz0j0yOURYhZs/AAZwTRqWSKELZI6VSSSRxBVWTOKzneO71GYobndXmrwE= X-Gm-Gg: ASbGncslkUTA7pZnhjxaXNxrVcsOGBnG6nybexWnmJYIZrV04cHGVbzqskmUshU9+zM 7QrvHmAJBqSJmktJRsxvbuxaqoT0jdV4ztfvHhE8PtnDB+9rqKLrc30XWWK0B1JY9bYOj/wIqCl wOIDiCYMU4f6evu4uavxYUScAQTb3w6XL5Hyaig6nbyckDZO0CSXI2Ed3pRFJlGQViLOgst0jUo F/fW88Wib6K55lAHdlRD32GfOieLSu9zB8ulsZ/tneXBzWFARPNqs90BYoBmtc0K2CrlqXRYlNt SYZy7vnqkqWw412TuNRTNP8HjvcsqJJnOATzbR8ZgeqjxSFRQaSdgJMU98/7oNo4vzLthLqPO77 i5jkw8D92f6AYVZR5Yvua64/m8W/mn7DoPjaNxWE= X-Google-Smtp-Source: AGHT+IE9e0ybyQKyJ//4kGPLbVl7PIgqS7VfHCK6F815HZBFYxMRTycI2FtsrSV2yYmsxyF6/hyorQ== X-Received: by 2002:a05:6830:2a0e:b0:73e:8c8b:749 with SMTP id 46e09a7af769-7534fb80fdbmr1972971a34.0.1757693219400; Fri, 12 Sep 2025 09:06:59 -0700 (PDT) Received: from [127.0.1.1] ([2600:8803:e7e4:1d00:fdf1:f11e:e330:d3c1]) by smtp.gmail.com with ESMTPSA id 46e09a7af769-7524b8a39ecsm1073863a34.23.2025.09.12.09.06.57 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 12 Sep 2025 09:06:58 -0700 (PDT) From: David Lechner Date: Fri, 12 Sep 2025 11:05:55 -0500 Subject: [PATCH 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: <20250912-iio-doc-push-to-buffers-context-v1-4-c4aad013d96e@baylibre.com> References: <20250912-iio-doc-push-to-buffers-context-v1-0-c4aad013d96e@baylibre.com> In-Reply-To: <20250912-iio-doc-push-to-buffers-context-v1-0-c4aad013d96e@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=1229; i=dlechner@baylibre.com; h=from:subject:message-id; bh=7TqvcYTMBp51/HUM9YZ5b9Xwf4ZwYLxzxeeJRmV5Wp8=; b=owEBbQGS/pANAwAKAcLMIAH/AY/AAcsmYgBoxET+EJWYdQcYzUzsp9PpgPfnKKv+VZ6ATmTtR 8v45AiaQYSJATMEAAEKAB0WIQTsGNmeYg6D1pzYaJjCzCAB/wGPwAUCaMRE/gAKCRDCzCAB/wGP wO2OB/0RD7F8XblbmZb46MSGf0H/G+n0y0/cLLx62zICRmCS+uOEJ20tCR5dztCnXNneYsq7Nbs UpxXnyxZaQ41OmRfleXqJgMQRhJgu0/Chk9rerrmdQNwuHpMd5RcNk+7vutTVwdIVebvTeSP62n s4PeRVnR4XtplcouUtwSl57pk6Xapq479vfPZJ2EaOfBiBEDl/GPa+V3ubfiO1YPfBYxkk21pAD YSbuz9THFWk3fJ5etbtfj7nupMCNBzqsb9br+NSsCfaaEWG/UpU40+VFtXJ5O0lumtIgWOSn1qP tKyfg2noBPxtmzPehzk2px+PWxrH4vBSPZKZ7RBMFt8Hsiei 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 47f23bc0470eaf308fc3a739faaf9b56cac0ef67..f07f6bae0cb25b0f51bd6712061= 77508d1064b79 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). + * This function is 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 18:15:48 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 24E7F31D39B for ; Fri, 12 Sep 2025 16:07:01 +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=1757693222; cv=none; b=RUlmlVMZ4vjfItjq08r1GDgZLSiYh4hU/w26T9cs9rRvqJR9QHZYTQbFXl8k/NMfZ1mDz/mrTW3wV+2POjvZ58gRlXqm0pCZGsnBbgvT+glvVvpGe+4KsAsIOoOvdC+z/ZZjJGiKOVUQp2tRyPfVr36OsYBSEVG1XDFYm2Y4NDM= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1757693222; c=relaxed/simple; bh=KaHoQw0mmyST/U0aIeT4Q9rI2vx9p1nFNJx02h4APhA=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=aP9BjkmJCGMaKwuKvSz57UAZgxgN3bTDWT2OmU/I9Elh8Xp+rxzTg+nd97ET/JJi2vGp0yHP1lHAVWGldBCnAdzgrlfZ1/EdTUSoPt4CIAWP81xkNZ29EFT1Wz6eEdftD1ou3fFxX+dzV3FneX2wQEQJLEbOu2mk/UQL8FPOsAA= 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=y6PZO7nO; 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="y6PZO7nO" Received: by mail-ot1-f52.google.com with SMTP id 46e09a7af769-746c06937c3so1555981a34.0 for ; Fri, 12 Sep 2025 09:07:01 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=baylibre-com.20230601.gappssmtp.com; s=20230601; t=1757693220; x=1758298020; 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=y6PZO7nOUuIZ7APexAnSg9kAPk94gQh1ZaacpkvRvHENlAVU+MlRsqINWkhM1+/4Qm 9x57sz5AjPGObr34fD0TBGfWM7xf5k6g0xMuXPclEwRBB73vhcPe4OGC17wXW5fZ+yBK 22PLkLmxQB0cS7UGg4y/nIFCgWI3KA2zyq6Lmc6Sob5vQ0xw4/uNKgMfZ9mumcBtKSMS UQeHGHXfQe4G7gkUR4TI6FKivcfdyiykJmYFHBf2AzuqNq/ckkjhps8X+vRVMbS9Ra04 jQYSa2mIrxio7N9Kt7Byv0BhddCs8ezKsPyJpF2PfTSkYVIkAhMJtcxOQVzP8X3HCDxI IPqA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1757693220; x=1758298020; 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=aAuiI5Ts3eu7gaYKiEvuumcYpkIzBkZ4a/E9l3obEO3xG2FaFjeCOTOlToyF2nfY83 jdrrx1md5CUX10H9tZYfZaiw9LVLjvLKeRbHwN8tLC7iOucS4A9TaszXSWfHjezpqmoJ zzJYf+PZZmV1rBfdL5SITut+QUrGUXE0aZkrSn7jjmsYeueAaDxjpjD1q9nOEzCNF2Ia eHyMItPQtVlBWSkW5L3FIGg4ln5s6dsVb3zW4lXGJX7UXX7/+7KlEPiW/4OtTYwUBU8y jsklNWSkMY+o1iReaZ7+wdkptSbpVebZhQsrrT4QmwGbxS8s/DEj6HS4pmykBnR9XArF wQPA== X-Forwarded-Encrypted: i=1; AJvYcCXoybbyvE+Asw3yG1i4dSP2gATj412wBW8ZXl23TC5i9s+qaL/mBo6nN0Pk5puH+pM8BNKuDeg9w33wM6M=@vger.kernel.org X-Gm-Message-State: AOJu0YzISLpwa8lLDT9yhn2VX32/uHHvbLk8fju5+IK3OP+VD6zsMzLz crN9aWNVhOHWU4Oe/jtW3BJ/dVR/J1KfF6OpW4p5MlskTUU5U6omoTZtiFuKk+LRtrruK4u3Hqc EbPrWZo8= X-Gm-Gg: ASbGnctltLu3cx9czWIakwpV8NUB/ci88DrPtRGdan6rvxM9BrXhqb5Uvt6ZDjmBOGx DF+x9WZMvtb6eYi9KaCnpXfiA1vWTjVW/GMJKj2oLap+FvME8wta8RqL2UxrxA9RmwtdivGDwG+ EfZzKeJuwV3skHnx4RsrD13geh7gh54Q5rlSiR8RIJascAAmJ2YoqLkp3lxY64jfWfgsw34P+FX PgV6YLaVUnfQ4ovZMXsO27NXmbUs5VcoMOFFrfY53X/qb7pZO6VgBYlTTJ1z4ge1YLweZxCbK+z nPLrJiBAKHxSRbmvtuYDUupSgrCF6Kj9l0biG9KnE0FWAA4KwBFi7vnPZwvO1DJcXj4GvDPY73I PowtKY53F3MkaghpvU7IwDi5Qj5RC X-Google-Smtp-Source: AGHT+IHR83aDf55HmRumLiDPSOEZ9D55gCZKcrIqdECPELy/MTrd8ADPd5s3UvKrROq1Cu1OPbLGRA== X-Received: by 2002:a05:6830:3913:b0:745:9ba6:d33a with SMTP id 46e09a7af769-7535be1b2a8mr2132006a34.16.1757693220185; Fri, 12 Sep 2025 09:07:00 -0700 (PDT) Received: from [127.0.1.1] ([2600:8803:e7e4:1d00:fdf1:f11e:e330:d3c1]) by smtp.gmail.com with ESMTPSA id 46e09a7af769-7524b8a39ecsm1073863a34.23.2025.09.12.09.06.59 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 12 Sep 2025 09:06:59 -0700 (PDT) From: David Lechner Date: Fri, 12 Sep 2025 11:05:56 -0500 Subject: [PATCH 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: <20250912-iio-doc-push-to-buffers-context-v1-5-c4aad013d96e@baylibre.com> References: <20250912-iio-doc-push-to-buffers-context-v1-0-c4aad013d96e@baylibre.com> In-Reply-To: <20250912-iio-doc-push-to-buffers-context-v1-0-c4aad013d96e@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/AAcsmYgBoxEUF/KoNVwqQY4RveF3k/ghdB2BFsSXnRaK4I dsE/i6zhqOJATMEAAEKAB0WIQTsGNmeYg6D1pzYaJjCzCAB/wGPwAUCaMRFBQAKCRDCzCAB/wGP wJtiB/9XfHhUBee9g0ZSA5bl/wLostMyQJW3Qd9xT03YVBLpzQCwQlKZuOxVxvwS2xANeqQ5rp7 DKNUz6wS4sLIQXJ2xAzEDjpbCxs4Wq4PXmnOLN6XNCLlZjmLzOTYAWsaq9Ez2bL/bDt024RqMOL PRCsghwMC2Q0zcQr+dEzCMjaKRo2IjH0XQT4gAgAaybV61lsm2DxQazzsnSuCf3BnnhmY1GQGX5 HsubO2T+8LbLV/BKdYr9YFNLqW2mmyq6ISVJsLWRnB28HKIuMEUCXu3qztRuDceutyLess3jEA5 1FTGELCLDa+CmbMe/PKk8cDag6cNyRe75zO2V4IG1erLTclA 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 18:15:48 2025 Received: from mail-oo1-f50.google.com (mail-oo1-f50.google.com [209.85.161.50]) (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 1B32D320389 for ; Fri, 12 Sep 2025 16:07:03 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.161.50 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1757693225; cv=none; b=UHeNqiI7ubxp/5lBc9+jbqp9vvRg+QhS+42NdYOKhC6Hga4h/lLrbr9FtT2xwuVeA/ff48gzhlX4+L4iUsWe/qIS9Dni+lNwgIk7zLkqUxaAsG6SYMePH4Qqod4mLoa/PzG8ZCH6aPNZK4cq2Hs0lqkgHnNaoAE8lzRsyCWS1OA= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1757693225; c=relaxed/simple; bh=1rybI1vv2ITY3eTCg5sjd8Ca20nUymlp6uw8bi3cmFY=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=KrpJt7VjKBtILzwFOQ5RVR5FHBPOre7okrl+VlFjdDh4PHehscZ3SYbikTTeFYwOnSJKU0T9cnngW6L7MDZgQSBcgCBgJftuBH1JEjqC1xqBgUNalf5LNJV8VnpIgoJpxzKss7ZQaloaxKgEeE4W9iXVuir15aguSPMxPncBXmI= 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=tmvTEtqz; arc=none smtp.client-ip=209.85.161.50 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="tmvTEtqz" Received: by mail-oo1-f50.google.com with SMTP id 006d021491bc7-61e783a1e00so1265171eaf.1 for ; Fri, 12 Sep 2025 09:07:03 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=baylibre-com.20230601.gappssmtp.com; s=20230601; t=1757693223; x=1758298023; 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=tmvTEtqz57PZdjSjBqMRnzRxWHo4pXFhDwIy9sCe7c3QpdSCyOrqoKi1yo0ky2Az3T sO9SvdSqTA0vQb6fOlj9sbktLwW4/wCzMGmssVBzjJ8L1qe46bqbbfzRYMAbH4f4BesZ Uj+VOL4EYOVO9MA54LxQqkaCFNGpcggvKKZS4RMt3gF+jU4F5lck35bYbVaXOYqYfvij x0BC2IOghWY+h3DVqNtSt7382YC18h1YIFRl0mZKp90kNQDYxNGc3Jm9CQu69gnCKiu3 smCg6OlH9yhDwQ2LzQwObkTGYWt4PvTrkcn+Z6YVblDzmDoVCQPXVAhJOf5xkJHktMsh kaMQ== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1757693223; x=1758298023; 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=PDwhlp1sOHprwVgV3WRFS8n3Ul4aXKEjTZuuO228wW67FdevDvQfjp+IwLLIysSnDJ fWt2XlFMNNhDYcxKrqBpKFJdZ64FtBUPANzKTzRTyHrX1fZ5HLKgLt8TfIamic0/BbSp 9EnwnfQPAbUP3FoXaljTlC2SX5oCh7sm+qUEJFZf9KyiSeE/gBS03Gr+NTs37Nvl8rLR uXc5ynCbc6LN1mKGyhl5yCkZ+aRS6ihw6x48KMN399CyogOSsov6YMeVgti23tD3psdq ZwKo9TvtqkuixMfvmq6+QEkNhTuaUbKllD/LMkizhtP/zJtLL9pzUm09YxZrh95d2BZy zulw== X-Forwarded-Encrypted: i=1; AJvYcCU/P14qE+/+b5bSuGZ2LI9UzP2n1B2ZpoMkMphb16CY6khLX9aejNu3CW13C1+r4iONBgG/OqIegbQg20M=@vger.kernel.org X-Gm-Message-State: AOJu0YxL9CLLTsh9dIIB4XPFUeLEWZCou+dpvGwBGY1EX4kO1VTALdQ6 Ge6ZS+BmaxAO9IZmfjM013IZXdzGCbFqaImKSke7GJgCOpUkHrkTMeaqhlV/10bZHJo= X-Gm-Gg: ASbGncs6+1JZ1zVMLTV+cj7JGf9Q4Uo771eCsBMPxrMlw9mipZ43DwS5T0SH3Wn8/YN FygTjJlGYiqDBHIZmFBMKCLUw9bDrPOyLzvrK6YHZDWRi84vEiUjfQPYq6zdPBhDQTvt5zd5tmm n8mtjdIbFZuX4FeqrYbH5uvWmJh0njKniMFEe1fyUZ1yubzw21e8pGxCcGmny9IVhj8l6I7yCpY ldwktwnQ4Rcruz9kESuChDIqd1K23w+ywABmlN7Kq2c4kFFVw9vgA6Eq87h2f52Mk0B6dpwP8h8 gPhpwphkpEGenwmhe8XC+Jw4YKYSKnTQ5N4RZmum3xO5laiaSqqa46iR+xc8TMD9vYb8O6OnPaL 6Lo+GVE8G0y7ws+Vxj6YpnXGUhEKM X-Google-Smtp-Source: AGHT+IHMOztiaVGzRz7rukjpCk5kdql225PnQGUNUIhnzM3TiNlqeaD37c447kUVVSWjrGASmy1PtQ== X-Received: by 2002:a05:6808:1513:b0:439:ae79:5643 with SMTP id 5614622812f47-43b8d8882dfmr1392931b6e.3.1757693222992; Fri, 12 Sep 2025 09:07:02 -0700 (PDT) Received: from [127.0.1.1] ([2600:8803:e7e4:1d00:fdf1:f11e:e330:d3c1]) by smtp.gmail.com with ESMTPSA id 46e09a7af769-7524b8a39ecsm1073863a34.23.2025.09.12.09.07.00 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 12 Sep 2025 09:07:01 -0700 (PDT) From: David Lechner Date: Fri, 12 Sep 2025 11:05:57 -0500 Subject: [PATCH 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: <20250912-iio-doc-push-to-buffers-context-v1-6-c4aad013d96e@baylibre.com> References: <20250912-iio-doc-push-to-buffers-context-v1-0-c4aad013d96e@baylibre.com> In-Reply-To: <20250912-iio-doc-push-to-buffers-context-v1-0-c4aad013d96e@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/AAcsmYgBoxEULj2p4TQ0UmeX9SpiTgGCnq8mSbABAwI/DF +4alrzPtXGJATMEAAEKAB0WIQTsGNmeYg6D1pzYaJjCzCAB/wGPwAUCaMRFCwAKCRDCzCAB/wGP wPleCACPlwbeTkXzOlbhi3MHTAxj9mGZSIjn/7Q8Noe8MyTTIRJ1Gkw388AassYPrl1F3YotbxR R+rLr/Js9KWqAq+1pLLvDbasKSPleElEnaNn97ilKzhtzIWBqHlyWHilm3uziVB7iBy4lqbeZGK +V3GmKcZVvK9ZvX+0eRGhR+AhLp2do5QZC5+79WapO7DwnQrPQ1JH70Egy8GF0ZiN/dm7a59hSk yij+viUESMbNUmsK0FzgZ0dU8Ui9fDVeCx3GzKwvZ/YMSAomsi1eicAaqKeXCUOObXKVHAtZVi+ xRrm/kuXMCirC5yLKqw2ZGWi3NZDVwIZcLIdrp5+yxLlBC3w 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 18:15:48 2025 Received: from mail-oa1-f51.google.com (mail-oa1-f51.google.com [209.85.160.51]) (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 D6B413203A1 for ; Fri, 12 Sep 2025 16:07:04 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.160.51 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1757693226; cv=none; b=ehIqkVjFyq1Vw9GivLOhMfSNGIa35Sitnv1yvnMsoTP21v5mS5GsMmJ7ZUQTg4avfGvg5Cdwm6OijmplVx8nIr6NRTtqpW6vqVzbXFXk/jwvWIhPDRfiC21h9w6WLW1LzkHBF7yTIqK4smHrnUpZkhaW7fwKae8+MJQxy7C8lGY= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1757693226; c=relaxed/simple; bh=6mdeYyd3hF07QuqGuLzQcOwjnfUK2lpqXDhP/AFlcKY=; h=From:Date:Subject:MIME-Version:Content-Type:Message-Id:References: In-Reply-To:To:Cc; b=XtrBM/x9XX3+jtu6GwfJB1UlcUJ161PhbiZ0jZwbWcFKyjLdvGk/BwIMm8ofi7KDk/ntE4jl0/dgSCaLnZReH+bi5XeD0iLqqwDpp5a1/AIDZ6yXuLz5Qqa8R6XEexxFhAuqrXuqB5LHMQ6TZr24JWWaJ5v8WjI6ShAgsjgfo+A= 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=QNWfob5h; arc=none smtp.client-ip=209.85.160.51 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="QNWfob5h" Received: by mail-oa1-f51.google.com with SMTP id 586e51a60fabf-30cce5be7d0so938924fac.0 for ; Fri, 12 Sep 2025 09:07:04 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=baylibre-com.20230601.gappssmtp.com; s=20230601; t=1757693224; x=1758298024; 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=QNWfob5hlgs+iSq2tLGvg8BMd5u7DiHKyG0C1yQK65FRgbGO8j+vqpQB8VAbceB35B byGlej9vPgpJPPN4LtA7uR8GKB/ZOXtl0OYPKHbpRnwYbRYo7WaTLvbbI36rXYVeF72z AhcEFm8xNltkGc8fbv2m8T8sMLRcTeNwJx9WcWPhPC5Q5kdhH+wb1dVNK0EdA5gCJOc1 Jk0zzJBfBz4fpIJa3UrQ+ReCZQ8vTadFcqpUCu1JUiWM1BYdGKy0fZ7WG76FbeVQ94hs NGFdpHcQzgM9pIBrCiI3uRyuyomgpy1X9eKvNWTqHptkidTsg0L9CB1s8hzSbZCPpm0w aQGA== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1757693224; x=1758298024; 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=pRMDSqu7erzQa0jARfmxNB+AZyWWHtnha4PWVa3K77PfZD/Mf7jh4LbTELdHzMFl5v /+s3DMZdAsbus1jJ7Gur3v1ONYxAazb7VLeVmeypTNlapo93JrJn/XSKpxDa8jWX1PxW 23VjjEVfQUe9rZYwhVK8utrw/3/EcNGfFExykfH7eSQH/G1aKaXY+rk8pKWFdqikL4X2 nO+YCYLEWq/Vg4a/9Vn1LNf6B5w1r99ay0lNEz/ItNALEGxmZIATr2kXjMwOqYxoZtLK +tl3DCp8tkvHsU+40oAO9Qf5mPmIwH9ZUbMtXiPalwBwGkbCZ8o86D5G3xdvgp6XXQTn ShuQ== X-Forwarded-Encrypted: i=1; AJvYcCXo52N7YOlJQ56azDpKmhJb8KJmHjBSSypcotEnK5cDycUAo36EmwNlKsueDLJ8QyyGCDZgkKnG2ooOth0=@vger.kernel.org X-Gm-Message-State: AOJu0Yz9Zs11Q1UBlVrJK+YcRj7YXt1Oagtvm6P+kiZwP98Qowr6yBY/ INOv6792slYCxtWlvHAZm6hG/E01NhCj9ZGeoMmsbTYy+o598du/SAOEEwQCtChrVQY= X-Gm-Gg: ASbGncsV8jkk1I/nqTocYedcEEfrnSXlktmGp2a0ODdRJM97X3OL4HZaXmefx7EusZo Y6WHpxexRS1vzkAv9bZ0CFSlRyu4YkSB/sDSieU8ytkdbPRUD8RpyxVaV+Y/SOyKe04W8Bnmpbr oCrpO84SpqyIXOa8QQYu97dv/P6zSfViD3qXr23/1umPrlnWymCmr/Ox/JyA0NNU7V54KCN20Mi fSsiKh5Mic2km/vK94EcMgCY1AIeI7VsnY20PdGDHtuY3Sn6pIqtxAEQzDgQvOBQbz3Wkf5/2u/ PLo74+XT3PMfh2gXlVqOd9tGVLb15/e4nv5gvjjyrbZ6T7vniJ3jNjCGKZ+SrMv9tFs8KFhcjFc DG53hUBfYPUjv7dZ4TWtgRhRD019fmI0VBDt2kws= X-Google-Smtp-Source: AGHT+IEece21/Wf69nhlOq5vMROWm4ROwTKSNf9dUQSOL8WXvaC/Qb5i7szMjnhXT8f3xk0bFvp93A== X-Received: by 2002:a05:6870:2c85:b0:321:2521:5a5 with SMTP id 586e51a60fabf-32e54e819e4mr1773625fac.3.1757693223831; Fri, 12 Sep 2025 09:07:03 -0700 (PDT) Received: from [127.0.1.1] ([2600:8803:e7e4:1d00:fdf1:f11e:e330:d3c1]) by smtp.gmail.com with ESMTPSA id 46e09a7af769-7524b8a39ecsm1073863a34.23.2025.09.12.09.07.03 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Fri, 12 Sep 2025 09:07:03 -0700 (PDT) From: David Lechner Date: Fri, 12 Sep 2025 11:05:58 -0500 Subject: [PATCH 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: <20250912-iio-doc-push-to-buffers-context-v1-7-c4aad013d96e@baylibre.com> References: <20250912-iio-doc-push-to-buffers-context-v1-0-c4aad013d96e@baylibre.com> In-Reply-To: <20250912-iio-doc-push-to-buffers-context-v1-0-c4aad013d96e@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/AAcsmYgBoxEUR8jVNgAKhSyBxjAa9rQh/UHfJqz4WQGOwp ZIh/TBlDxGJATMEAAEKAB0WIQTsGNmeYg6D1pzYaJjCzCAB/wGPwAUCaMRFEQAKCRDCzCAB/wGP wOXcCACTtCM3r5X/VEpmrprum2PMSTKqs3GgI14iesumjCXuij/5jAx9itvCr3iVjiQBB2baOLr n3TMcn6Ul7FkEzmhaVJ1bhuxLSHoBudhpegwiPfKCO2dElYRpX4MT09wJnGDsFStDhw9rt1JpnJ QWyfbeZsRf1mV1ypVNBPyMiWvRzfMLOqDeEhltTry/9FhODX7O97GUSv7VqjFIB45S2u0PqflYX WZbLoe+8bHou1Y/EBJQ6yYmzQY6YVI0vGsm5StKl4AKIik2MkCPtUA/HQSBhmO/nT3BXsKWgism wR4iFNm6YJWfQrUOjhmN0f0ttZ9/alP3C+Xq2Bi6zcznM+hW 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