From mboxrd@z Thu Jan 1 00:00:00 1970 Received: from mail-wm1-f44.google.com (mail-wm1-f44.google.com [209.85.128.44]) (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 0E26633EAF9 for ; Mon, 22 Jun 2026 18:19:16 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.128.44 ARC-Seal:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1782152358; cv=none; b=RAGxdMWTjK5lhEbVNnjzy8186Juft1wN9XI57fsZVMODNTRerlqsIOzhIyWA8Tfhxc76tJvsHQ4bTdCeObGG3+d4gOPOFEb61XkHDleJ0bPY3LqdwS/BDp0FAAnEV4sQOdtLHUwBd5NrF6rTnvoKT0ByzsjAbmwmY0NdNqSPrWs= ARC-Message-Signature:i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1782152358; c=relaxed/simple; bh=vzQPa+wRfjDhzjoiFxTZzjP0OA6x7DAFKuq4lhacSEg=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=Cwbcyt6I4Cq+7zcL/EzN1IQ2FMu/P3N0u6vNTOMkoyfoUNmyiQ6S/UoHCNB8WdggafiHpds0uj6SH0wYQnnwlw3Juqp6vWQO078y571pIHoY/eyr6nOL42QoCbC7MJPvm+dIMIvqMOpFRizbyx1Jx4+8qAJh6SdL0mMVOakBkaA= ARC-Authentication-Results:i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com; spf=pass smtp.mailfrom=gmail.com; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b=WMRXQClH; arc=none smtp.client-ip=209.85.128.44 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=gmail.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=gmail.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=gmail.com header.i=@gmail.com header.b="WMRXQClH" Received: by mail-wm1-f44.google.com with SMTP id 5b1f17b1804b1-49252c974c3so1691685e9.3 for ; Mon, 22 Jun 2026 11:19:16 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20251104; t=1782152355; x=1782757155; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:from:to:cc:subject:date:message-id:reply-to; bh=OgXvi1kX5xT8KIfuJ99Kw8ogFdqkTxgMXnV5IEfIfG0=; b=WMRXQClH4NcC44GqDZUSbpmyl03Mq4FMZ2Ia5xti5r3eKOSd3sN68DMGq+hw0QCU9V M19BFmm96oDEST1aFK72rgB1m/t7n/zcjKZn2dKxDQtiGyZEp2vOy7WjLZzlRcDICZR8 u5IeFWsxq7tGVX4Q6aAwdBBJY/UWPguujTUiiRImr/R1EbknG13qJdzvIYmbJ7XKjT1e cXRYZfbVR0HANNnhXfmCLsktKn+EmEWnaRTp9fbFN7oAku6HmQjtdsq8rYll+aTQ1caH MSVhnQSmPMiLvcbVFVV39+rWSXRfLvTLLpbf9KS2oeBB/pkyqxvSq1rckcXestRkyGg5 nHtg== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1782152355; x=1782757155; h=content-transfer-encoding:mime-version:message-id:date:subject:cc :to:from:x-gm-gg:x-gm-message-state:from:to:cc:subject:date :message-id:reply-to; bh=OgXvi1kX5xT8KIfuJ99Kw8ogFdqkTxgMXnV5IEfIfG0=; b=tAD26STm8YbqO8HeYiiq2zDYXafk82OZMop5CDwWlFXVAYwYdejcWtF/3ve7PRbyLc 9AthZej29HSbKDEvfXuXw6KfeGHsLqHNtm1GEwQXIudaDYsmHx2C2yWgVlBmCXCMhMCv ZCRuFgPN2wUnwDrP1xmPVOYkFjaXJXNLZ3VrIFsAED8Rc3JvSAibyiVA8DqMdNlpJTqg +iT7C8Zdf3t6QED+wkVzf7JT8hlvXx+4kU77kMol2auVaDD8GnfVEhK+k4e13mAb11a+ 8ouZIbnrmj/nmvXOK90z6mra1tuz8FMqFpbztEURHexOGzTxiS7syKcKiYoIN904O9MR nEtw== X-Forwarded-Encrypted: i=1; AHgh+Rpdl/tUgIztivhrsFmrnLw5EA1j71PuD8gd2DQQhuqF5aFEjvmsUycm/E4cELCcGKwUByE1TfzOXZRPjvk=@vger.kernel.org X-Gm-Message-State: AOJu0YwykXCTRmoUu8FOZnu8lESHnF7fjNt7xDJ8xc4VysPFMFqEelmu xHkCnsC9Hvt/ouUluGqEiVHGj6MYY2FpN5sPQy/xl3IYRctAkTmxHu3v X-Gm-Gg: AfdE7clZbzUfUYsvdnHR6EeEoDTUPW84Rs2QZX5PfDPHKX/nfZWCVmMSYhrTuXykFk2 8VGKSzEKLQJrmMP2rQXzWKLIbyc3+tHxnsVB7zFODF8nBW8rFKeeuC2cGZLVzMWVCEjZNIcb+FM fSAIuxnyR7itOUExKNvlAgb8pJ1AKvwxHAFJEuIA+DXLdnJUHnxFT9AL5KwNuOIbfuTE8oCTP+g ETR4tWT458FXQMv8Sb9V7oK1uGhbB8Q5Q/Cif4ulhAjt5yCPBab0P0CtQlfr49xxDcopfsJhmCs 3G3IXyHykqxll22aTJBZolmMcO9xZAplzr2hCmKp2XnAJNrLNRR5s2vATakr9yeJDCVUhGBLslS dUkdxknUMvl/LLtW3Hcstbbz4jOyzOmHiQJHab98Z8vRHyU1F1aYwkBUAwcYARkgoXlKq3GNf7i qNj/wNdAX7ybtx5S4xTtulcneesGLahXZz/OKvQq4WA4zw7mSR7tOzkVbOXbQIJE1NAMIw5+UAm grdY8IyqxCzkLQe X-Received: by 2002:a05:6000:4808:b0:45e:894b:49eb with SMTP id ffacd0b85a97d-46a50422468mr1068627f8f.7.1782152355276; Mon, 22 Jun 2026 11:19:15 -0700 (PDT) Received: from doehyun-dev.pradel.rg.cispa.de (x06.xlate.fw.cispa.de. [195.37.157.6]) by smtp.gmail.com with ESMTPSA id ffacd0b85a97d-46666788226sm28288079f8f.23.2026.06.22.11.19.14 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 22 Jun 2026 11:19:14 -0700 (PDT) From: Doehyun Baek To: Greg Kroah-Hartman , Jonathan Corbet , Shuah Khan Cc: Andrew Morton , Vlastimil Babka , Lorenzo Stoakes , linux-doc@vger.kernel.org, linux-kernel@vger.kernel.org, Doehyun Baek Subject: [PATCH] Docs/driver-api/uio-howto: document mmap_prepare callback Date: Mon, 22 Jun 2026 18:18:21 +0000 Message-ID: <20260622181821.1195257-1-doehyunbaek@gmail.com> X-Mailer: git-send-email 2.43.0 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: 8bit The UIO howto still documents an mmap callback in struct uio_info. That field was replaced by mmap_prepare, which takes a struct vm_area_desc. A UIO driver following the current howto no longer builds because struct uio_info has no mmap member. Update the documented callback signature and matching text to match the current API. Fixes: 933f05f58ac6 ("uio: replace deprecated mmap hook with mmap_prepare in uio_info") Signed-off-by: Doehyun Baek --- Documentation/driver-api/uio-howto.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/Documentation/driver-api/uio-howto.rst b/Documentation/driver-api/uio-howto.rst index 907ffa3b38f5..c08472dfbcfe 100644 --- a/Documentation/driver-api/uio-howto.rst +++ b/Documentation/driver-api/uio-howto.rst @@ -246,10 +246,10 @@ the members are required, others are optional. hardware interrupt number. The flags given here will be used in the call to :c:func:`request_irq()`. -- ``int (*mmap)(struct uio_info *info, struct vm_area_struct *vma)``: +- ``int (*mmap_prepare)(struct uio_info *info, struct vm_area_desc *desc)``: Optional. If you need a special :c:func:`mmap()` function, you can set it here. If this pointer is not NULL, your - :c:func:`mmap()` will be called instead of the built-in one. + ``mmap_prepare`` will be called instead of the built-in one. - ``int (*open)(struct uio_info *info, struct inode *inode)``: Optional. You might want to have your own :c:func:`open()`, base-commit: 1dc18801be29bc54709aa355b8acd80e183b03cd -- 2.43.0