From nobody Tue Apr 7 05:42:09 2026 Received: from mail-wm1-f43.google.com (mail-wm1-f43.google.com [209.85.128.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 732BB222582 for ; Sun, 15 Mar 2026 19:06:45 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=209.85.128.43 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1773601606; cv=none; b=aq5QJaZmLA44ubsZznNEy3X9oSjnZSqb3dyIbQ+soK+YoaQcNmhLizWopGvxU8vqSr07mHSDNP5IrYLJn4WQ0uZa2U0z+OePPBQNNo6sdKM3IrB5hmB6odnnQHYDFpCX0SdlAFdFAuC922ogWerc0AWIebuAmAqvc7/xRo8M3rs= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1773601606; c=relaxed/simple; bh=DI+700CtYNosaPkYL2rt6SybCGhWALRSycFS4GbWLB8=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=BVgMQke2/EIqTycmOUBqjfFQjMtNdLlkSHFnNteUmCh7GXOQ0tz/U8ACGnjzN1B+P9NANdRYtBL3V+1PRtO2esrH7YICkOo32wVmNljOPDpf1Ut/KIbz/IO1Y93oKMv45UuTEXaDi5QwKyO/lZ6qU94I7+goNQv1BrKooiEXbE0= 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=kctp4axy; arc=none smtp.client-ip=209.85.128.43 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="kctp4axy" Received: by mail-wm1-f43.google.com with SMTP id 5b1f17b1804b1-48538c5956bso35769275e9.0 for ; Sun, 15 Mar 2026 12:06:45 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=gmail.com; s=20230601; t=1773601604; x=1774206404; darn=vger.kernel.org; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:from:to:cc:subject:date :message-id:reply-to; bh=FsWcMYH2O8uTc+mZLEWVEGacKr10jMp8JDXFXbefbs0=; b=kctp4axykdp+XXpfhW+lF+yTrn8zddH+4ocxh5VYt5zQj4CqghCLuFDP5Dfl7PvKV2 xyZw/Xg+adaULbEQ6rZsf7+zikaIiQoi8UJlJH+41UkuqlBGFakizPs3y3ryYvf5MEPo WJ5bey4+P04gT5Nnf8OaY6XTk3hmaxpv0dRJI4upQwLikliq8LotXCLi6amzlZqWHLO4 vuxVj6SwI7zQvQFtwfzIVev6SgZntpqNpVd97Tg00w++FczqzIzvG4nWOjoLb3zTc4A4 8dvPgVfYsLHKKGeAt6sIJJxiBxUBuoyFUSyw5A9q2OXNduXJNO2PZkhXx9X6/JEASisc j21g== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20251104; t=1773601604; x=1774206404; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-gg:x-gm-message-state:from :to:cc:subject:date:message-id:reply-to; bh=FsWcMYH2O8uTc+mZLEWVEGacKr10jMp8JDXFXbefbs0=; b=OutgIk+rmbR/mxAvJ5XpUYRoQVAlJpd0kb6+bKY9SYqK2XZk3rYfc4Se3iYdyRmcXG xOvFHW7umr3xEfk+xmOUClqa/EvsFM7Ui9tAu65uYH/tS7mMl8aqARwrKGEkyKPKl0XQ Skwl4OaA3I4uTqvCXO6GvQzmcc4xmw1JxanmHiOw6Ex3SM+2/O68sVp649AIKZEwCMij 4qNnlmrMh9k+yc8VJGQyBens6MZ5Za4mNXkes8y66mTwkQ8e4eKvTUXtdanrIuKdSKdg unOwyRzw2IGnMm7juFvbccFqFSR+1KaGpCgSSGGH5YvmIwmga+hQphEK+CTTYFh0BXj2 pqaQ== X-Forwarded-Encrypted: i=1; AJvYcCW5O0K6lboSOjXceASvQIga3tMkUD8oHq+XAKpf8gmIMBFsHctEzU8N1B/REktw9egvbDgyqIQ/aCst4vo=@vger.kernel.org X-Gm-Message-State: AOJu0Yzks2mQ3Bzq8KVXWQMX2TqbyBxW7rIOv5VJBGse4Lm+Vf5qym8J YFBkmjrJzclKBJV1i3WCBTA+RMIzGy0QqwIU5G6gO5Tzo/sku2SBvOv/ X-Gm-Gg: ATEYQzyC+dA0tU+5LErMLWUtP02TpM8vOwxg1DhYcwzjnvg+Xk9/vJG6qmKaZqQA/mk lqRq8s/wYKKOWsIND3hxkbgPGeFpQQVBaGzL8xjh4CR2i3J36wGLzwuX2D9rkXBCh6DLK4xmCbl l31DXItH0JAamw5bPBlJ4ZXZcbzwTlS2OkT2awtbGK4r1Z1ar6yg5l/IHVmyitEURXdAf70p2qk VG1gegjYuGKGBNns+phKYeyr92uuAgjilHZ+WJKs9oy/jDZ2a8278wbrspEIW87kn92ZhLaD3TR cq8Ut+BkT9WhNjv0DyWuQFFhaa3/cD3uQzaQlG1YNG2piYlFPaMnSfyU6CcOfI2f0B3RosFOT+w adojXvuHjBAWAJVZ+7V28+kgPhDt99o9rnGqowKYd5KyYQY5BVbnUueJrCBuQD1CX/leF9SDyOU yd9oxIjEweqZEW6ZlCNKSuAT3zOV0hGPpmbMIm8S776N6Nklckr3Ed4Eo9mEKUyi6fe1MGshmW9 PuTnpfIUCbaUlSX7jeSLVBpoTyBUA== X-Received: by 2002:a05:600c:4fd5:b0:46e:59bd:f7e2 with SMTP id 5b1f17b1804b1-48555b2c8fbmr175177175e9.11.1773601603594; Sun, 15 Mar 2026 12:06:43 -0700 (PDT) Received: from DESKTOP-TILNSD1.localdomain ([139.47.104.103]) by smtp.gmail.com with ESMTPSA id 5b1f17b1804b1-4854e2537c3sm384063425e9.15.2026.03.15.12.06.42 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Sun, 15 Mar 2026 12:06:43 -0700 (PDT) From: Kit Dallege To: linux_oss@crudebyte.com, ericvh@kernel.org, lucho@ionkov.net, asmadeus@codewreck.org Cc: v9fs@lists.linux.dev, linux-kernel@vger.kernel.org, Kit Dallege Subject: [PATCH v3] 9p: document missing enum values in kernel-doc comments Date: Sun, 15 Mar 2026 20:06:33 +0100 Message-ID: <20260315190633.73536-1-xaum.io@gmail.com> X-Mailer: git-send-email 2.53.0 In-Reply-To: <20260315170702.65160-1-xaum.io@gmail.com> References: <20260315170702.65160-1-xaum.io@gmail.com> 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 Reviewed-by: Christian Schoenebeck --- V2 -> V3: Address review from Christian Schoenebeck: - Fix descriptions to match 9P2000.L protocol spec - RLOPEN: returns qid and iounit, not generic "file access information" - TREADLINK/RREADLINK: read/return symbolic link target - TXATTRWALK: prepare to read/list, not "walk to" - TXATTRCREATE: prepare to set, not "create" - TFSYNC: flush *cached* file data - TLOCK: acquire or *release*, not "test" - TGETLOCK: test for existence of POSIX record lock - TRENAMEAT: safer variant of TRENAME, not "using directory fids" - TUNLINKAT: unlink a file or directory - TVERSION: negotiate protocol version and message size - Add missing (9P2000.L) tags to all 9P2000.L-specific entries - Add (9P2000.L) to pre-existing TMKDIR/RMKDIR entries include/net/9p/9p.h | 38 +++++++++++++++++++++++++++++++++++--- 1 file changed, 35 insertions(+), 3 deletions(-) diff --git a/include/net/9p/9p.h b/include/net/9p/9p.h index 60cad0d200a4..fd7a034b8278 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,13 +70,39 @@ 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 qid and iounit (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_TMKDIR: create a directory request - * @P9_RMKDIR: create a directory response - * @P9_TVERSION: version handshake request + * @P9_TREADLINK: read symbolic link target (9P2000.L) + * @P9_RREADLINK: response with symbolic link target (9P2000.L) + * @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: prepare to read/list extended attributes (9P2000.L) + * @P9_RXATTRWALK: response with extended attribute size (9P2000.L) + * @P9_TXATTRCREATE: prepare to set extended attribute (9P2000.L) + * @P9_RXATTRCREATE: set extended attribute response (9P2000.L) + * @P9_TREADDIR: read directory entries request (9P2000.L) + * @P9_RREADDIR: read directory entries response (9P2000.L) + * @P9_TFSYNC: flush cached file data to storage request (9P2000.L) + * @P9_RFSYNC: flush cached file data to storage response (9P2000.L) + * @P9_TLOCK: acquire or release a POSIX record lock (9P2000.L) + * @P9_RLOCK: POSIX record lock response (9P2000.L) + * @P9_TGETLOCK: test for existence of POSIX record lock (9P2000.L) + * @P9_RGETLOCK: POSIX record lock test response (9P2000.L) + * @P9_TLINK: create a hard link (9P2000.L) + * @P9_RLINK: hard link response (9P2000.L) + * @P9_TRENAMEAT: safely rename across directories (9P2000.L) + * @P9_RRENAMEAT: rename response (9P2000.L) + * @P9_TUNLINKAT: unlink a file or directory (9P2000.L) + * @P9_RUNLINKAT: unlink response (9P2000.L) + * @P9_TMKDIR: create a directory request (9P2000.L) + * @P9_RMKDIR: create a directory response (9P2000.L) + * @P9_TVERSION: negotiate protocol version and message size * @P9_RVERSION: version handshake response * @P9_TAUTH: request to establish authentication channel * @P9_RAUTH: response with authentication information @@ -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