From patchwork Wed Feb 19 14:18:18 2025 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Juergen Gross X-Patchwork-Id: 13982359 Return-Path: X-Spam-Checker-Version: SpamAssassin 3.4.0 (2014-02-07) on aws-us-west-2-korg-lkml-1.web.codeaurora.org Received: from lists.xenproject.org (lists.xenproject.org [192.237.175.120]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by smtp.lore.kernel.org (Postfix) with ESMTPS id 58960C021B0 for ; Wed, 19 Feb 2025 14:18:45 +0000 (UTC) Received: from list by lists.xenproject.org with outflank-mailman.893002.1301952 (Exim 4.92) (envelope-from ) id 1tkkuL-0007Rd-Ad; Wed, 19 Feb 2025 14:18:37 +0000 X-Outflank-Mailman: Message body and most headers restored to incoming version Received: by outflank-mailman (output) from mailman id 893002.1301952; Wed, 19 Feb 2025 14:18:37 +0000 Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1tkkuL-0007RU-6w; Wed, 19 Feb 2025 14:18:37 +0000 Received: by outflank-mailman (input) for mailman id 893002; Wed, 19 Feb 2025 14:18:35 +0000 Received: from se1-gles-sth1-in.inumbo.com ([159.253.27.254] helo=se1-gles-sth1.inumbo.com) by lists.xenproject.org with esmtp (Exim 4.92) (envelope-from ) id 1tkkuJ-00079l-IP for xen-devel@lists.xenproject.org; Wed, 19 Feb 2025 14:18:35 +0000 Received: from smtp-out1.suse.de (smtp-out1.suse.de [2a07:de40:b251:101:10:150:64:1]) by se1-gles-sth1.inumbo.com (Halon) with ESMTPS id 6765a18b-eecc-11ef-9aa8-95dc52dad729; Wed, 19 Feb 2025 15:18:34 +0100 (CET) Received: from imap1.dmz-prg2.suse.org (unknown [10.150.64.97]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by smtp-out1.suse.de (Postfix) with ESMTPS id C1B84216E7; Wed, 19 Feb 2025 14:18:32 +0000 (UTC) Received: from imap1.dmz-prg2.suse.org (localhost [127.0.0.1]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature RSA-PSS (4096 bits) server-digest SHA256) (No client certificate requested) by imap1.dmz-prg2.suse.org (Postfix) with ESMTPS id 741F0137DB; Wed, 19 Feb 2025 14:18:32 +0000 (UTC) Received: from dovecot-director2.suse.de ([2a07:de40:b281:106:10:150:64:167]) by imap1.dmz-prg2.suse.org with ESMTPSA id oQj/GjjotWdVGgAAD6G6ig (envelope-from ); Wed, 19 Feb 2025 14:18:32 +0000 X-BeenThere: xen-devel@lists.xenproject.org List-Id: Xen developer discussion List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Errors-To: xen-devel-bounces@lists.xenproject.org Precedence: list Sender: "Xen-devel" X-Inumbo-ID: 6765a18b-eecc-11ef-9aa8-95dc52dad729 DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.com; s=susede1; t=1739974712; h=from:from:reply-to:date:date:message-id:message-id:to:to:cc:cc: mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=qP7ShgO2jeel6eX2yKvZzzNgRb7XqsWusTfznm79wT4=; b=A36YEoehtXfVSkwev0XD0iassjfUjXJpQCvLDv+39eo7GwCkqavUmucLNuBnN8dcJgig5U NMsnG1CpEgmADXYWnq2EI3YAEq9pFtsPW/1wMllztJF6RNOq6/sa+kRHHPtrGvGtK0HpK7 Jry9xtH4s11+ucLsCgK5rvVaFrGHGcE= Authentication-Results: smtp-out1.suse.de; none DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.com; s=susede1; t=1739974712; h=from:from:reply-to:date:date:message-id:message-id:to:to:cc:cc: mime-version:mime-version: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=qP7ShgO2jeel6eX2yKvZzzNgRb7XqsWusTfznm79wT4=; b=A36YEoehtXfVSkwev0XD0iassjfUjXJpQCvLDv+39eo7GwCkqavUmucLNuBnN8dcJgig5U NMsnG1CpEgmADXYWnq2EI3YAEq9pFtsPW/1wMllztJF6RNOq6/sa+kRHHPtrGvGtK0HpK7 Jry9xtH4s11+ucLsCgK5rvVaFrGHGcE= From: Juergen Gross To: xen-devel@lists.xenproject.org Cc: oleksii.kurochko@gmail.com, Juergen Gross , Andrew Cooper , Anthony PERARD , Michal Orzel , Jan Beulich , Julien Grall , =?utf-8?q?Roger_Pau_Monn=C3=A9?= , Stefano Stabellini Subject: [PATCH v2 2/2] xen/list: fix comments in include/xen/list.h Date: Wed, 19 Feb 2025 15:18:18 +0100 Message-ID: <20250219141818.8789-3-jgross@suse.com> X-Mailer: git-send-email 2.43.0 In-Reply-To: <20250219141818.8789-1-jgross@suse.com> References: <20250219141818.8789-1-jgross@suse.com> MIME-Version: 1.0 X-Spamd-Result: default: False [-1.30 / 50.00]; BAYES_HAM(-3.00)[100.00%]; SUSPICIOUS_RECIPS(1.50)[]; MID_CONTAINS_FROM(1.00)[]; NEURAL_HAM_LONG(-1.00)[-1.000]; R_MISSING_CHARSET(0.50)[]; NEURAL_HAM_SHORT(-0.20)[-1.000]; MIME_GOOD(-0.10)[text/plain]; DBL_BLOCKED_OPENRESOLVER(0.00)[suse.com:email,suse.com:mid,imap1.dmz-prg2.suse.org:helo]; FREEMAIL_CC(0.00)[gmail.com,suse.com,citrix.com,vates.tech,amd.com,xen.org,kernel.org]; TAGGED_RCPT(0.00)[]; RCVD_VIA_SMTP_AUTH(0.00)[]; MIME_TRACE(0.00)[0:+]; ARC_NA(0.00)[]; FROM_HAS_DN(0.00)[]; RCVD_TLS_ALL(0.00)[]; RCPT_COUNT_SEVEN(0.00)[10]; RCVD_COUNT_TWO(0.00)[2]; TO_MATCH_ENVRCPT_ALL(0.00)[]; FROM_EQ_ENVFROM(0.00)[]; FUZZY_BLOCKED(0.00)[rspamd.com]; TO_DN_SOME(0.00)[]; DKIM_SIGNED(0.00)[suse.com:s=susede1]; FREEMAIL_ENVRCPT(0.00)[gmail.com] There are several places in list.h where "list_struct" is used instead of "struct list_head". Fix that. Signed-off-by: Juergen Gross Acked-by: Jan Beulich Release-Acked-by: Oleksii Kurochko --- xen/include/xen/list.h | 34 +++++++++++++++++----------------- 1 file changed, 17 insertions(+), 17 deletions(-) diff --git a/xen/include/xen/list.h b/xen/include/xen/list.h index d90b3f6f0d..10e6d10522 100644 --- a/xen/include/xen/list.h +++ b/xen/include/xen/list.h @@ -395,7 +395,7 @@ static inline void list_splice_init(struct list_head *list, * list_entry - get the struct for this entry * @ptr: the &struct list_head pointer. * @type: the type of the struct this is embedded in. - * @member: the name of the list_struct within the struct. + * @member: the name of the struct list_head within the struct. */ #define list_entry(ptr, type, member) \ container_of(ptr, type, member) @@ -404,7 +404,7 @@ static inline void list_splice_init(struct list_head *list, * list_first_entry - get the first element from a list * @ptr: the list head to take the element from. * @type: the type of the struct this is embedded in. - * @member: the name of the list_struct within the struct. + * @member: the name of the struct list_head within the struct. * * Note, that list is expected to be not empty. */ @@ -415,7 +415,7 @@ static inline void list_splice_init(struct list_head *list, * list_last_entry - get the last element from a list * @ptr: the list head to take the element from. * @type: the type of the struct this is embedded in. - * @member: the name of the list_struct within the struct. + * @member: the name of the struct list_head within the struct. * * Note, that list is expected to be not empty. */ @@ -426,7 +426,7 @@ static inline void list_splice_init(struct list_head *list, * list_first_entry_or_null - get the first element from a list * @ptr: the list head to take the element from. * @type: the type of the struct this is embedded in. - * @member: the name of the list_struct within the struct. + * @member: the name of the struct list_head within the struct. * * Note that if the list is empty, it returns NULL. */ @@ -437,7 +437,7 @@ static inline void list_splice_init(struct list_head *list, * list_last_entry_or_null - get the last element from a list * @ptr: the list head to take the element from. * @type: the type of the struct this is embedded in. - * @member: the name of the list_struct within the struct. + * @member: the name of the struct list_head within the struct. * * Note that if the list is empty, it returns NULL. */ @@ -447,7 +447,7 @@ static inline void list_splice_init(struct list_head *list, /** * list_next_entry - get the next element in list * @pos: the type * to cursor - * @member: the name of the list_struct within the struct. + * @member: the name of the struct list_head within the struct. */ #define list_next_entry(pos, member) \ list_entry((pos)->member.next, typeof(*(pos)), member) @@ -467,7 +467,7 @@ static inline void list_splice_init(struct list_head *list, /** * list_prev_entry - get the prev element in list * @pos: the type * to cursor - * @member: the name of the list_struct within the struct. + * @member: the name of the struct list_head within the struct. */ #define list_prev_entry(pos, member) \ list_entry((pos)->member.prev, typeof(*(pos)), member) @@ -525,7 +525,7 @@ static inline void list_splice_init(struct list_head *list, * list_for_each_entry - iterate over list of given type * @pos: the type * to use as a loop cursor. * @head: the head for your list. - * @member: the name of the list_struct within the struct. + * @member: the name of the struct list_head within the struct. */ #define list_for_each_entry(pos, head, member) \ for ( (pos) = list_first_entry_or_null(head, typeof(*(pos)), member); \ @@ -536,7 +536,7 @@ static inline void list_splice_init(struct list_head *list, * list_for_each_entry_reverse - iterate backwards over list of given type. * @pos: the type * to use as a loop cursor. * @head: the head for your list. - * @member: the name of the list_struct within the struct. + * @member: the name of the struct list_head within the struct. */ #define list_for_each_entry_reverse(pos, head, member) \ for ( (pos) = list_last_entry_or_null(head, typeof(*(pos)), member); \ @@ -548,7 +548,7 @@ static inline void list_splice_init(struct list_head *list, * list_for_each_entry_continue * @pos: the type * to use as a start point * @head: the head of the list - * @member: the name of the list_struct within the struct. + * @member: the name of the struct list_head within the struct. * * Prepares a pos entry for use as a start point in * list_for_each_entry_continue. @@ -560,7 +560,7 @@ static inline void list_splice_init(struct list_head *list, * list_for_each_entry_continue - continue iteration over list of given type * @pos: the type * to use as a loop cursor. * @head: the head for your list. - * @member: the name of the list_struct within the struct. + * @member: the name of the struct list_head within the struct. * * Continue to iterate over list of given type, continuing after * the current position. @@ -575,7 +575,7 @@ static inline void list_splice_init(struct list_head *list, * current point * @pos: the type * to use as a loop cursor. * @head: the head for your list. - * @member: the name of the list_struct within the struct. + * @member: the name of the struct list_head within the struct. * * Iterate over list of given type, continuing from current position. */ @@ -588,7 +588,7 @@ static inline void list_splice_init(struct list_head *list, * @pos: the type * to use as a loop cursor. * @n: another type * to use as temporary storage * @head: the head for your list. - * @member: the name of the list_struct within the struct. + * @member: the name of the struct list_head within the struct. */ #define list_for_each_entry_safe(pos, n, head, member) \ for ( (pos) = list_first_entry_or_null(head, typeof(*(pos)), member), \ @@ -601,7 +601,7 @@ static inline void list_splice_init(struct list_head *list, * @pos: the type * to use as a loop cursor. * @n: another type * to use as temporary storage * @head: the head for your list. - * @member: the name of the list_struct within the struct. + * @member: the name of the struct list_head within the struct. * * Iterate over list of given type, continuing after current point, * safe against removal of list entry. @@ -617,7 +617,7 @@ static inline void list_splice_init(struct list_head *list, * @pos: the type * to use as a loop cursor. * @n: another type * to use as temporary storage * @head: the head for your list. - * @member: the name of the list_struct within the struct. + * @member: the name of the struct list_head within the struct. * * Iterate over list of given type from current point, safe against * removal of list entry. @@ -632,7 +632,7 @@ static inline void list_splice_init(struct list_head *list, * @pos: the type * to use as a loop cursor. * @n: another type * to use as temporary storage * @head: the head for your list. - * @member: the name of the list_struct within the struct. + * @member: the name of the struct list_head within the struct. * * Iterate backwards over list of given type, safe against removal * of list entry. @@ -683,7 +683,7 @@ static inline void list_splice_init(struct list_head *list, * list_for_each_entry_rcu - iterate over rcu list of given type * @pos: the type * to use as a loop cursor. * @head: the head for your list. - * @member: the name of the list_struct within the struct. + * @member: the name of the struct list_head within the struct. * * This list-traversal primitive may safely run concurrently with * the _rcu list-mutation primitives such as list_add_rcu()