From nobody Thu Sep 19 02:06:34 2024 Received: from us-smtp-delivery-124.mimecast.com (us-smtp-delivery-124.mimecast.com [170.10.129.124]) (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 3242814F10F for ; Tue, 23 Jul 2024 10:12:20 +0000 (UTC) Authentication-Results: smtp.subspace.kernel.org; arc=none smtp.client-ip=170.10.129.124 ARC-Seal: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1721729541; cv=none; b=efWXUyGa1Ub4gGRbBro6O6ZFZvt38tndbzDbcYVt5oIEeNZ7DSNrAc8S7XxfMqO4bS6pBSa6Ut/p7toayHoqlhrH60ZhISOKOBBrnyQBkoyH7lDF3cmvr9Z+emzMU66JbTJRzN4JlybtqUeXvteGfQ3zZUXtqEbaO/wYwf3C8dQ= ARC-Message-Signature: i=1; a=rsa-sha256; d=subspace.kernel.org; s=arc-20240116; t=1721729541; c=relaxed/simple; bh=AYfOsTim18mKk3f/6TIR5xq65kd3Yt1GDi3RAW/TNkk=; h=From:To:Cc:Subject:Date:Message-ID:In-Reply-To:References: MIME-Version; b=ftwQnjkI4QSl+gQ4FoviKkxPuk5oDAfTva5kETxbBJmLrSDLu8gZzSd4yE9RFrWZAw2Ii0jaNFeQMSyvxUFL8Iy6Wohvk272yZVoQyTiG/RS9sfL/alIelJcHJgUD0M5Gc+fjfrwD/4xlQT9FSJiItbvQwBdheVxH6q4lSkynbs= ARC-Authentication-Results: i=1; smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=redhat.com; spf=pass smtp.mailfrom=redhat.com; dkim=pass (1024-bit key) header.d=redhat.com header.i=@redhat.com header.b=NYM+/mKn; arc=none smtp.client-ip=170.10.129.124 Authentication-Results: smtp.subspace.kernel.org; dmarc=pass (p=none dis=none) header.from=redhat.com Authentication-Results: smtp.subspace.kernel.org; spf=pass smtp.mailfrom=redhat.com Authentication-Results: smtp.subspace.kernel.org; dkim=pass (1024-bit key) header.d=redhat.com header.i=@redhat.com header.b="NYM+/mKn" DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=redhat.com; s=mimecast20190719; t=1721729538; h=from:from:reply-to:subject:subject: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=eYU79afplONI6yVx+AGbEJT6iE6q/eJtdNUT3lyaw3g=; b=NYM+/mKnAVMbCst4zNR/2roh/QNawZJ9gr3gKg3G49LdnVw/5lFy9WjAwNLfBhqIba71zL SV7FzphQ0TRVH1pEJXf/0rxYmRgdsrCBpU9nLCu3OaVduGfxDB9Q1QxEbaJK7LybHKGoXN zuOyReUJHmlmarHpJhpFALz0tnigyKo= Received: from mail-qk1-f200.google.com (mail-qk1-f200.google.com [209.85.222.200]) by relay.mimecast.com with ESMTP with STARTTLS (version=TLSv1.3, cipher=TLS_AES_256_GCM_SHA384) id us-mta-339-yH6tlV8SOaaOoAOqvg555A-1; Tue, 23 Jul 2024 06:12:17 -0400 X-MC-Unique: yH6tlV8SOaaOoAOqvg555A-1 Received: by mail-qk1-f200.google.com with SMTP id af79cd13be357-79ef9c44d3eso729950085a.0 for ; Tue, 23 Jul 2024 03:12:17 -0700 (PDT) X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20230601; t=1721729536; x=1722334336; h=content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:subject:cc:to:from:x-gm-message-state:from:to:cc :subject:date:message-id:reply-to; bh=eYU79afplONI6yVx+AGbEJT6iE6q/eJtdNUT3lyaw3g=; b=kS6NS7qcxL8ScSH1eyJfhSXba41SRsykajYNaLdMq0ONYnk+QngJL3hlYdpKb3ysXZ gCrRR6B0YtJcyBtUig+iXp9TbKUUV0Zsxd059aSNWASbcnG91vwr0I+TxUBj8EF2gflv Q4ic4njWMsSTiM46KgS6QNK70HJzx3lK6Emr7mRB935dlBDVxeaUQjP27qQK62byNFow naHng3SxhFtaGZOK6PNEkIJvRAL9aL5SMdvIPnEXblLpSB7nx4YLo7UFBEMKCrd467nq CY4PYF9z90LYlgnxx6mQv+InYrwFsCf/57z8x8oQ9pyWhXt8jp1Xrf0t7FW8j1xAhdBE jKsA== X-Forwarded-Encrypted: i=1; AJvYcCUuSpZ8enDa5yrLtfJ1habA4d5XcTBA/G++QrmhCeAghClwoG80Zzzh7lpcZK6fw0Ssa+cDHd3H28V2464VppIUjJSaS0Md2ONQszgm X-Gm-Message-State: AOJu0YyLBaYWn7skgp7ztzJ97/1LJu8X9cHp7ziqzDQc1Ds6dBzHmNBe ynMayRA9Vp6eu+OSCfd8XcZf3SZOdVdNBKIVOxpLWcLzdTtWiLxnAYB6a90iMsn8JxYmThLjbZx UFYOYfyiMaYzwfhCVxtpzWJzVc20yE8jLZ89YCHN6gxIRCZeR7ZKnmO7DQ+dtkg== X-Received: by 2002:a05:620a:2889:b0:79f:186e:40ae with SMTP id af79cd13be357-7a1a66656edmr1162831185a.53.1721729536477; Tue, 23 Jul 2024 03:12:16 -0700 (PDT) X-Google-Smtp-Source: AGHT+IFLHZv1++yvDs2k3NZSaNv8PP8WkhYN1uecWcb93Utq4aaTWS6WbOltpz2JXXEdPG07aFrkHg== X-Received: by 2002:a05:620a:2889:b0:79f:186e:40ae with SMTP id af79cd13be357-7a1a66656edmr1162829385a.53.1721729536084; Tue, 23 Jul 2024 03:12:16 -0700 (PDT) Received: from rh.redhat.com (p200300c93f45e50062e5f8c654844c9a.dip0.t-ipconnect.de. [2003:c9:3f45:e500:62e5:f8c6:5484:4c9a]) by smtp.gmail.com with ESMTPSA id af79cd13be357-7a1990063f2sm463780085a.64.2024.07.23.03.12.13 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Tue, 23 Jul 2024 03:12:15 -0700 (PDT) From: Sebastian Ott To: linux-arm-kernel@lists.infradead.org, kvmarm@lists.linux.dev, linux-kernel@vger.kernel.org Cc: Marc Zyngier , Oliver Upton , James Morse , Suzuki K Poulose , Catalin Marinas , Will Deacon , Zenghui Yu , Mark Rutland Subject: [PATCH v2 2/3] KVM: arm64: fix kdoc warnings in W=1 builds Date: Tue, 23 Jul 2024 12:12:03 +0200 Message-ID: <20240723101204.7356-3-sebott@redhat.com> X-Mailer: git-send-email 2.45.2 In-Reply-To: <20240723101204.7356-1-sebott@redhat.com> References: <20240723101204.7356-1-sebott@redhat.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" Fix kdoc warnings by adding missing function parameter descriptions or by conversion to a normal comment. Signed-off-by: Sebastian Ott --- arch/arm64/kvm/arm.c | 1 + arch/arm64/kvm/vgic/vgic-irqfd.c | 7 ++++--- arch/arm64/kvm/vgic/vgic-its.c | 18 +++++++++++------- arch/arm64/kvm/vgic/vgic-v3.c | 2 +- 4 files changed, 17 insertions(+), 11 deletions(-) diff --git a/arch/arm64/kvm/arm.c b/arch/arm64/kvm/arm.c index a7ca776b51ec..23e1fa56c02d 100644 --- a/arch/arm64/kvm/arm.c +++ b/arch/arm64/kvm/arm.c @@ -164,6 +164,7 @@ static int kvm_arm_default_max_vcpus(void) /** * kvm_arch_init_vm - initializes a VM data structure * @kvm: pointer to the KVM struct + * @type: kvm device type */ int kvm_arch_init_vm(struct kvm *kvm, unsigned long type) { diff --git a/arch/arm64/kvm/vgic/vgic-irqfd.c b/arch/arm64/kvm/vgic/vgic-ir= qfd.c index 8c711deb25aa..c314c016659a 100644 --- a/arch/arm64/kvm/vgic/vgic-irqfd.c +++ b/arch/arm64/kvm/vgic/vgic-irqfd.c @@ -9,7 +9,7 @@ #include #include "vgic.h" =20 -/** +/* * vgic_irqfd_set_irq: inject the IRQ corresponding to the * irqchip routing entry * @@ -75,7 +75,8 @@ static void kvm_populate_msi(struct kvm_kernel_irq_routin= g_entry *e, msi->flags =3D e->msi.flags; msi->devid =3D e->msi.devid; } -/** + +/* * kvm_set_msi: inject the MSI corresponding to the * MSI routing entry * @@ -98,7 +99,7 @@ int kvm_set_msi(struct kvm_kernel_irq_routing_entry *e, return vgic_its_inject_msi(kvm, &msi); } =20 -/** +/* * kvm_arch_set_irq_inatomic: fast-path for irqfd injection */ int kvm_arch_set_irq_inatomic(struct kvm_kernel_irq_routing_entry *e, diff --git a/arch/arm64/kvm/vgic/vgic-its.c b/arch/arm64/kvm/vgic/vgic-its.c index 40bb43f20bf3..ba945ba78cc7 100644 --- a/arch/arm64/kvm/vgic/vgic-its.c +++ b/arch/arm64/kvm/vgic/vgic-its.c @@ -2040,6 +2040,7 @@ typedef int (*entry_fn_t)(struct vgic_its *its, u32 i= d, void *entry, * @start_id: the ID of the first entry in the table * (non zero for 2d level tables) * @fn: function to apply on each entry + * @opaque: pointer to opaque data * * Return: < 0 on error, 0 if last element was identified, 1 otherwise * (the last element may not be found on second level tables) @@ -2079,7 +2080,7 @@ static int scan_its_table(struct vgic_its *its, gpa_t= base, int size, u32 esz, return 1; } =20 -/** +/* * vgic_its_save_ite - Save an interrupt translation entry at @gpa */ static int vgic_its_save_ite(struct vgic_its *its, struct its_device *dev, @@ -2099,6 +2100,8 @@ static int vgic_its_save_ite(struct vgic_its *its, st= ruct its_device *dev, =20 /** * vgic_its_restore_ite - restore an interrupt translation entry + * + * @its: its handle * @event_id: id used for indexing * @ptr: pointer to the ITE entry * @opaque: pointer to the its_device @@ -2231,6 +2234,7 @@ static int vgic_its_restore_itt(struct vgic_its *its,= struct its_device *dev) * @its: ITS handle * @dev: ITS device * @ptr: GPA + * @dte_esz: device table entry size */ static int vgic_its_save_dte(struct vgic_its *its, struct its_device *dev, gpa_t ptr, int dte_esz) @@ -2313,7 +2317,7 @@ static int vgic_its_device_cmp(void *priv, const stru= ct list_head *a, return 1; } =20 -/** +/* * vgic_its_save_device_tables - Save the device table and all ITT * into guest RAM * @@ -2386,7 +2390,7 @@ static int handle_l1_dte(struct vgic_its *its, u32 id= , void *addr, return ret; } =20 -/** +/* * vgic_its_restore_device_tables - Restore the device table and all ITT * from guest RAM to internal data structs */ @@ -2478,7 +2482,7 @@ static int vgic_its_restore_cte(struct vgic_its *its,= gpa_t gpa, int esz) return 1; } =20 -/** +/* * vgic_its_save_collection_table - Save the collection table into * guest RAM */ @@ -2518,7 +2522,7 @@ static int vgic_its_save_collection_table(struct vgic= _its *its) return ret; } =20 -/** +/* * vgic_its_restore_collection_table - reads the collection table * in guest memory and restores the ITS internal state. Requires the * BASER registers to be restored before. @@ -2556,7 +2560,7 @@ static int vgic_its_restore_collection_table(struct v= gic_its *its) return ret; } =20 -/** +/* * vgic_its_save_tables_v0 - Save the ITS tables into guest ARM * according to v0 ABI */ @@ -2571,7 +2575,7 @@ static int vgic_its_save_tables_v0(struct vgic_its *i= ts) return vgic_its_save_collection_table(its); } =20 -/** +/* * vgic_its_restore_tables_v0 - Restore the ITS tables from guest RAM * to internal data structs according to V0 ABI * diff --git a/arch/arm64/kvm/vgic/vgic-v3.c b/arch/arm64/kvm/vgic/vgic-v3.c index ed6e412cd74b..3eecdd2f4b8f 100644 --- a/arch/arm64/kvm/vgic/vgic-v3.c +++ b/arch/arm64/kvm/vgic/vgic-v3.c @@ -370,7 +370,7 @@ static void map_all_vpes(struct kvm *kvm) dist->its_vm.vpes[i]->irq)); } =20 -/** +/* * vgic_v3_save_pending_tables - Save the pending tables into guest RAM * kvm lock and all vcpu lock must be held */ --=20 2.42.0