From nobody Tue Apr 7 17:15:02 2026 Received: from bombadil.infradead.org (bombadil.infradead.org [198.137.202.133]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.subspace.kernel.org (Postfix) with ESMTPS id D7E1A38B7BB for ; Thu, 26 Feb 2026 22:11:15 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=198.137.202.133 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1772143876; cv=none; b=WTFTbe9L5SNJRYMxh+k0BFleKEMyBGjme10Ccwu7H+PXIt/+LTZu4K4IDa10cHPOFNavupDYtU9B2mEY+9dazSoqGMG9g8+Z+nj9cObaEBVXk68/yDUzawXlczEKqp5HRPX8SvQfjCE5AwOg6uOfHHMx3RhvONjnG09FuvQUieM= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1772143876; c=relaxed/simple; bh=d/9Wy0f6QkerQDBFznItvCeaOA3i3rmfu+UZvN/RFOM=; h=From:To:Cc:Subject:Date:Message-ID:MIME-Version; b=QxImE4rAMkqAB/zMSiZlXXDvxbNub1lNCGdg5cD6nEuvB/mpqfktov6OKHnKmrhCPnq4OxkSxrVtDJ47yKJlWpvzWesJh0vdsOtEN+OlD2PjjC2d9JUgdBxqR0rFcB29i8w6AsnayI7ole2m5SliD1FyoaoPTydv9MuhJSyLIpM= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=infradead.org; spf=none smtp.mailfrom=infradead.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b=BgLLCi9z; arc=none smtp.client-ip=198.137.202.133 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=infradead.org Authentication-Results: smtp.subspace.kernel.org; spf=none smtp.mailfrom=infradead.org Authentication-Results: smtp.subspace.kernel.org; dkim=pass (2048-bit key) header.d=infradead.org header.i=@infradead.org header.b="BgLLCi9z" DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=infradead.org; s=bombadil.20210309; h=Content-Transfer-Encoding: MIME-Version:Message-ID:Date:Subject:Cc:To:From:Sender:Reply-To:Content-Type: Content-ID:Content-Description:In-Reply-To:References; bh=E2VTeQ3C2cQkljrZGq8S36jL6ptQw/xTjrmx61gZgJI=; b=BgLLCi9zInhTH68O1K9upDfs2Z Wk2SoVWywtqzs9K8ZzTOZMoUKtFnL1wLMswmfBnuPapormS3gPp4gS7iNiYiWZBJ0Z7gi1TTOSXLo YPT416qpFVRE+KUOzuG5+NXdk+6pWdQaL63J8A9feEUsWNdywMjfQQSdjr+DeA4I/It3ilNOWx/ic WyvcNj98njwxNHNAteZLNypgzqvxcmUWSWDM2+gQ5jtB2BD1X98aY+IODL8fUHKQMP23mRYhUJiZv alITiqOjbMXkLbdljF3yIfbU2dHH5LEOI1QOQOwhgq/zpVpOWRaTaLvzCZCx6NwT0dnKBmZShrNFv eLeuGlFw==; Received: from [50.53.43.113] (helo=bombadil.infradead.org) by bombadil.infradead.org with esmtpsa (Exim 4.98.2 #2 (Red Hat Linux)) id 1vvjZh-00000007Hmm-1SH2; Thu, 26 Feb 2026 22:11:13 +0000 From: Randy Dunlap To: linux-kernel@vger.kernel.org Cc: Randy Dunlap , Richard Weinberger , Anton Ivanov , Johannes Berg , linux-um@lists.infradead.org Subject: [PATCH] um: time-travel: clean up kernel-doc warnings Date: Thu, 26 Feb 2026 14:11:12 -0800 Message-ID: <20260226221112.1042008-1-rdunlap@infradead.org> 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" Repair all kernel-doc warnings in um_timetravel.h: - add one enum description - mark "reserve" as private - use a leading '@' on current_time Warning: include/uapi/linux/um_timetravel.h:59 Enum value 'UM_TIMETRAVEL_SHARED_MAX_FDS' not described in enum 'um_timetravel_shared_mem_fds' Warning: include/uapi/linux/um_timetravel.h:245 union member 'reserve' not described in 'um_timetravel_schedshm_client' Warning: include/uapi/linux/um_timetravel.h:288 struct member 'current_time' not described in 'um_timetravel_schedshm' Signed-off-by: Randy Dunlap --- Cc: Richard Weinberger Cc: Anton Ivanov Cc: Johannes Berg Cc: linux-um@lists.infradead.org include/uapi/linux/um_timetravel.h | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) --- linux-next-20260226.orig/include/uapi/linux/um_timetravel.h +++ linux-next-20260226/include/uapi/linux/um_timetravel.h @@ -56,6 +56,9 @@ enum um_timetravel_shared_mem_fds { * in the control message */ UM_TIMETRAVEL_SHARED_LOGFD, + /** + * @UM_TIMETRAVEL_SHARED_MAX_FDS: number of fds listed here + */ UM_TIMETRAVEL_SHARED_MAX_FDS, }; =20 @@ -242,6 +245,7 @@ union um_timetravel_schedshm_client { __u64 req_time; __u64 name; }; + /* private: */ char reserve[128]; /* reserved for future usage */ }; =20 @@ -264,7 +268,7 @@ union um_timetravel_schedshm_client { * is made by any client. Clients also must update this value when they * insert/update an own request into the shared memory while not running * themselves, and the new request is before than the current value. - * current_time: Current time, can only be set by the client in running st= ate + * @current_time: Current time, can only be set by the client in running s= tate * (indicated by @running_id), though that client may only run until @free= _until, * so it must remain smaller than @free_until. * @running_id: The current client in state running, set before a client is