From nobody Tue Apr 7 05:41:10 2026 Received: from mail-wm1-f52.google.com (mail-wm1-f52.google.com [209.85.128.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 6729E371CFA for ; Sun, 15 Mar 2026 17:07:14 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.128.52 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1773594435; cv=none; b=heLaooNFSMoIVak25TAcYt8phPhr2IxRMlYlqjkXVFXGXEMf0Cxc8KXgkkojDcliPmiLb3RtoBXyM0qUz0NYsVR3Gqm8G6GISMhOVFmRRFYgcN804MD2FboeRgyARtzAIKLt2pbgF8Bx2Oxtv+fUheto542pLwQpAh/i1HCJCRw= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1773594435; c=relaxed/simple; bh=d/R4+TuBHELKkpXTQmZVyBd4sGccYCnSg+xWcrV6+VA=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=EGKcwrPuwCls383zj8sXKfevzCsVAMQ8WZtpBRrSHjN8yh/towQWg/j781cuPpoV3T4mzSlMOxFtuF95ukaedv69kUzZM6qOpM7GEdefd/Wus5GdCcVyVzk1PNxqQ+8dNdv3yNZf0xM8WmhV3JRc9xWDtiCznOCaW4ujCj+AObM= 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=bdAn1zxW; arc=none smtp.client-ip=209.85.128.52 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="bdAn1zxW" Received: by mail-wm1-f52.google.com with SMTP id 5b1f17b1804b1-48538c5956bso35182595e9.0 for ; Sun, 15 Mar 2026 10:07:14 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1773594433; x=1774199233; 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=t9CtlmBlx+I8Ll0yQI7Nk9bmvuVR4UyWp0VZA4+45g4=; b=bdAn1zxWovyPpFM3uBwXhTf7GVtIq5Su6eo65WbB8spfpu0miCP6QEmB23toZfrVM+ QeOWRlGQql7cio40I6kA0wy3Y0bL4SXLrYLVX7VQrBmT0fcbi/tfsYnkE5mWuoAeebtl s4fvShl/v3MBTGv6EbDMFODPc/GHOttAivHiIoTgxE+vNiZ1TrtYARZC4gVP1137jo7F CZtqRRTQEQxTwLLBzs/K6ofQUfQCWK+1LnWfoU+oXQFEprnClGJlHHJ5YQJxDzT+u4K+ r8VuZpUSIbSIUEO7HbdrEx3UD6sY/o+/j7V8jwaVz4Ez/0EfHzjV6qZlNr40UA7RfKZQ O3zw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1773594433; x=1774199233; 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=t9CtlmBlx+I8Ll0yQI7Nk9bmvuVR4UyWp0VZA4+45g4=; b=Apy+YIyaispxgGMq/h3catPCE+t+FwkjbgHXhdz0g6s/ZPQzBihGiZQQulI5azfepU okKh+hhYSTvEz0mg/9yyvA31PkUiA66Y64bS+GADC5rfuzQ2bA3VnJ9pS/ik26e1cyk+ +NxB6QTvvwjXSrb+bPtYZR7ak8rTpy7hPNuk816LSmJ30oLK2Ufa2gRJDC5rQnuBul0I FMCre4a9evUVrnwHOo0shqCD5Neb0m7jfWFjpKqNqesbx41UXdcFzNjamfVX8fAx4Mgs +akoEIrYiHJbRolRg96gpfTsATb+zTNX08EJUx2FFX1r6+9zoOJZADktvu6LP7QYj4Sk mlpA== X-Forwarded-Encrypted: i=1; AJvYcCWPwZ3+C3zis+q3Tz2EY+h4EtcDZJwSCXUMfkUe7EXITegmi4Sg2tdaF4UFSmgU5MP0T++W6/xOKPEl3cQ=@vger.kernel.org X-Gm-Message-State: AOJu0YzI/BBjTuhHLgRkCu0yVN2PTTxH8bc0UYJuNPB1swrGFXgcSwae XRDTzGz4P71frhQtaI5FMKiEOMRVBbAaGiy5g/ev8FHwjU15qVWABqwe X-Gm-Gg: ATEYQzwXzAZdV3yA/PMiL8qEsczQkGTb9VKNhcUVRX/S0As+jXLxT4apcwYQhA7lHDt xhpgYvbeQAjRY4HvlXbRWR4Z+xmtpr7L8DRzRaRT9mX/47/Ju/+kqaV4LYo+a2y68dO2koaU/WR EHDwD+mWsX3eQZixbo8q07CXAT+quuyCs5bgDX0AAOyTA3gTiSGOrY1QsP11BaL1kgVDUzo19oH opwftI/kecwImK6V6C2qtdhOq/3FmjxLSXXu8JQhvqOfnsJZLUzVKrSSRCw0HTWvRivZeOgxl7A PMrSRK94IYmMA5E5xF9DoSBwvOT66VXA1aUkIx4XDLnFFwfBv2E3YSRAIQp/hXINzN8iivLZJTH 033gMnFpq4GuoYOdrthErjrMjl82/7lRLR07i5jKQsyt93p+sh+z9podHKoCD6luHXHIpUHAdFX fAyoCmNplx/0wFIiHjc7tyQChcQQ+I8fm1EiSj4BY/cHRftddMiFi396xS1ohRQBF5AuXxUhTNg dA+4MaAdOc/ySLjMusjYJ/St6EfFQ== X-Received: by 2002:a05:600c:1907:b0:485:50ac:b8cf with SMTP id 5b1f17b1804b1-48555a5689amr168059915e9.0.1773594432200; Sun, 15 Mar 2026 10:07:12 -0700 (PDT) Received: from DESKTOP-TILNSD1.localdomain ([139.47.104.103]) by smtp.gmail.com with ESMTPSA id 5b1f17b1804b1-4854b5e912fsm940069515e9.2.2026.03.15.10.07.11 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 15 Mar 2026 10:07:11 -0700 (PDT) From: Kit Dallege To: Eric Van Hensbergen , Latchesar Ionkov , Dominique Martinet Cc: Christian Schoenebeck , v9fs@lists.linux.dev, linux-kernel@vger.kernel.org Subject: [PATCH v2] 9p: document missing enum values in kernel-doc comments Date: Sun, 15 Mar 2026 18:07:02 +0100 Message-ID: <20260315170702.65160-1-xaum.io@gmail.com> X-Mailer: git-send-email 2.53.0 Precedence: bulk X-Mailing-List: linux-kernel@vger.kernel.org List-Id: List-Subscribe: List-Unsubscribe: MIME-Version: 1.0 Content-Transfer-Encoding: quoted-printable Content-Type: text/plain; charset="utf-8" Add kernel-doc entries for all undocumented enum values: - p9_debug_flags: P9_DEBUG_CACHE, P9_DEBUG_MMAP - p9_msg_t: all 9P2000.L message types (TLOPEN/RLOPEN through TUNLINKAT/RUNLINKAT) - p9_open_mode_t: P9L_MODE_MASK, P9L_DIRECT, P9L_NOWRITECACHE, P9L_LOOSE Assisted-by: Claude:claude-opus-4-6 Signed-off-by: Kit Dallege --- include/net/9p/9p.h | 32 ++++++++++++++++++++++++++++++++ 1 file changed, 32 insertions(+) diff --git a/include/net/9p/9p.h b/include/net/9p/9p.h index 60cad0d200a4..6b645a0d3487 100644 --- a/include/net/9p/9p.h +++ b/include/net/9p/9p.h @@ -24,6 +24,8 @@ * @P9_DEBUG_PKT: packet marshalling/unmarshalling * @P9_DEBUG_FSC: FS-cache tracing * @P9_DEBUG_VPKT: Verbose packet debugging (full packet dump) + * @P9_DEBUG_CACHE: cache operations tracing + * @P9_DEBUG_MMAP: memory-mapped I/O tracing * * These flags are passed at mount time to turn on various levels of * verbosity and tracing which will be output to the system logs. @@ -68,10 +70,36 @@ void _p9_debug(enum p9_debug_flags level, const char *f= unc, * @P9_RSYMLINK: make symlink response * @P9_TMKNOD: create a special file object request * @P9_RMKNOD: create a special file object response + * @P9_TLOPEN: open a file for I/O (9P2000.L) + * @P9_RLOPEN: response with file access information (9P2000.L) * @P9_TLCREATE: prepare a handle for I/O on an new file for 9P2000.L * @P9_RLCREATE: response with file access information for 9P2000.L * @P9_TRENAME: rename request * @P9_RRENAME: rename response + * @P9_TREADLINK: read symbolic link request + * @P9_RREADLINK: read symbolic link response + * @P9_TGETATTR: get file attributes request (9P2000.L) + * @P9_RGETATTR: get file attributes response (9P2000.L) + * @P9_TSETATTR: set file attributes request (9P2000.L) + * @P9_RSETATTR: set file attributes response (9P2000.L) + * @P9_TXATTRWALK: walk to an extended attribute + * @P9_RXATTRWALK: response with extended attribute handle + * @P9_TXATTRCREATE: create an extended attribute + * @P9_RXATTRCREATE: response for extended attribute creation + * @P9_TREADDIR: read directory entries request + * @P9_RREADDIR: read directory entries response + * @P9_TFSYNC: flush file data to storage request + * @P9_RFSYNC: flush file data to storage response + * @P9_TLOCK: acquire or test a POSIX lock + * @P9_RLOCK: lock acquisition response + * @P9_TGETLOCK: get lock information + * @P9_RGETLOCK: lock information response + * @P9_TLINK: create a hard link + * @P9_RLINK: hard link response + * @P9_TRENAMEAT: rename using directory fids + * @P9_RRENAMEAT: rename response + * @P9_TUNLINKAT: unlink using directory fid + * @P9_RUNLINKAT: unlink response * @P9_TMKDIR: create a directory request * @P9_RMKDIR: create a directory response * @P9_TVERSION: version handshake request @@ -194,6 +222,10 @@ enum p9_msg_t { * @P9_ORCLOSE: remove the file when the file is closed * @P9_OAPPEND: open the file and seek to the end * @P9_OEXCL: only create a file, do not open it + * @P9L_MODE_MASK: mask for protocol mode bits (client-side only) + * @P9L_DIRECT: disable client-side caching for this file + * @P9L_NOWRITECACHE: disable write caching for this file + * @P9L_LOOSE: enable loose cache consistency * * 9P open modes differ slightly from Posix standard modes. * In particular, there are extra modes which specify different --=20 2.53.0