Commit 0aa34b37 authored by Sebastian Ott's avatar Sebastian Ott Committed by Oliver Upton
Browse files

KVM: arm64: fix kdoc warnings in W=1 builds 



Fix kdoc warnings by adding missing function parameter
descriptions or by conversion to a normal comment.

Signed-off-by: default avatarSebastian Ott <sebott@redhat.com>
Reviewed-by: default avatarMarc Zyngier <maz@kernel.org>
Link: https://lore.kernel.org/r/20240723101204.7356-3-sebott@redhat.com


Signed-off-by: default avatarOliver Upton <oliver.upton@linux.dev>
parent 963a08e5

arch/arm64/kvm/arm.c

+1 −0
Original line number Diff line number Diff line
@@ -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)

{

arch/arm64/kvm/vgic/vgic-irqfd.c

+4 −3
Original line number Diff line number Diff line
@@ -9,7 +9,7 @@ 
#include <kvm/arm_vgic.h>

#include "vgic.h"



/**

/*

 * 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_routing_entry *e, 
	msi->flags = e->msi.flags;

	msi->devid = 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);

}



/**

/*

 * kvm_arch_set_irq_inatomic: fast-path for irqfd injection

 */

int kvm_arch_set_irq_inatomic(struct kvm_kernel_irq_routing_entry *e,

arch/arm64/kvm/vgic/vgic-its.c

+11 −7
Original line number Diff line number Diff line
@@ -2040,6 +2040,7 @@ typedef int (*entry_fn_t)(struct vgic_its *its, u32 id, 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;

}



/**

/*

 * 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, struct its_device *dev, 


/**

 * 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 struct list_head *a, 
		return 1;

}



/**

/*

 * 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;

}



/**

/*

 * 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;

}



/**

/*

 * 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;

}



/**

/*

 * 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 vgic_its *its) 
	return ret;

}



/**

/*

 * 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 *its) 
	return vgic_its_save_collection_table(its);

}



/**

/*

 * vgic_its_restore_tables_v0 - Restore the ITS tables from guest RAM

 * to internal data structs according to V0 ABI

 *

arch/arm64/kvm/vgic/vgic-v3.c

+1 −1
Original line number Diff line number Diff line
@@ -370,7 +370,7 @@ static void map_all_vpes(struct kvm *kvm) 
						dist->its_vm.vpes[i]->irq));

}



/**

/*

 * vgic_v3_save_pending_tables - Save the pending tables into guest RAM

 * kvm lock and all vcpu lock must be held

 */