pci hotplug: kernel-doc fixes
acpiphp.h: not using kernel-doc, so change /** to /* acpiphp_core.c: lots of kernel-doc cleanups acpiphp_glue.c: lots of kernel-doc cleanups acpiphp_ibm.c: lots of kernel-doc cleanups cpqphp_core.c: lots of kernel-doc cleanups cpqphp_ctrl.c: lots of kernel-doc cleanups fakephp.c: correct kernel-doc notation pciehp_ctrl.c: correct kernel-doc notation rpadlpar_core.c: correct function names & kernel-doc notation rpaphp_core.c: correct kernel-doc notation shpchp_ctrl.c: correct kernel-doc notation Signed-off-by: Randy Dunlap <randy.dunlap@oracle.com> Cc: Kristen Accardi <kristen.c.accardi@intel.com> Signed-off-by: Greg Kroah-Hartman <gregkh@suse.de>
This commit is contained in:
committed by
Greg Kroah-Hartman
parent
d885c6b75b
commit
26e6c66e47
@@ -82,7 +82,6 @@ static void handle_hotplug_event_func(acpi_handle handle, u32 type, void *contex
|
||||
* 2. has _PS0 method
|
||||
* 3. has _PS3 method
|
||||
* 4. ..
|
||||
*
|
||||
*/
|
||||
static int is_ejectable(acpi_handle handle)
|
||||
{
|
||||
@@ -986,10 +985,8 @@ static int power_off_slot(struct acpiphp_slot *slot)
|
||||
|
||||
|
||||
/**
|
||||
* acpiphp_max_busnr - return the highest reserved bus number under
|
||||
* the given bus.
|
||||
* acpiphp_max_busnr - return the highest reserved bus number under the given bus.
|
||||
* @bus: bus to start search with
|
||||
*
|
||||
*/
|
||||
static unsigned char acpiphp_max_busnr(struct pci_bus *bus)
|
||||
{
|
||||
@@ -1018,7 +1015,6 @@ static unsigned char acpiphp_max_busnr(struct pci_bus *bus)
|
||||
/**
|
||||
* acpiphp_bus_add - add a new bus to acpi subsystem
|
||||
* @func: acpiphp_func of the bridge
|
||||
*
|
||||
*/
|
||||
static int acpiphp_bus_add(struct acpiphp_func *func)
|
||||
{
|
||||
@@ -1063,7 +1059,6 @@ acpiphp_bus_add_out:
|
||||
/**
|
||||
* acpiphp_bus_trim - trim a bus from acpi subsystem
|
||||
* @handle: handle to acpi namespace
|
||||
*
|
||||
*/
|
||||
static int acpiphp_bus_trim(acpi_handle handle)
|
||||
{
|
||||
@@ -1089,7 +1084,6 @@ static int acpiphp_bus_trim(acpi_handle handle)
|
||||
*
|
||||
* This function should be called per *physical slot*,
|
||||
* not per each slot object in ACPI namespace.
|
||||
*
|
||||
*/
|
||||
static int enable_device(struct acpiphp_slot *slot)
|
||||
{
|
||||
@@ -1185,6 +1179,7 @@ static void disable_bridges(struct pci_bus *bus)
|
||||
|
||||
/**
|
||||
* disable_device - disable a slot
|
||||
* @slot: ACPI PHP slot
|
||||
*/
|
||||
static int disable_device(struct acpiphp_slot *slot)
|
||||
{
|
||||
@@ -1240,14 +1235,15 @@ static int disable_device(struct acpiphp_slot *slot)
|
||||
|
||||
/**
|
||||
* get_slot_status - get ACPI slot status
|
||||
* @slot: ACPI PHP slot
|
||||
*
|
||||
* if a slot has _STA for each function and if any one of them
|
||||
* returned non-zero status, return it
|
||||
* If a slot has _STA for each function and if any one of them
|
||||
* returned non-zero status, return it.
|
||||
*
|
||||
* if a slot doesn't have _STA and if any one of its functions'
|
||||
* configuration space is configured, return 0x0f as a _STA
|
||||
* If a slot doesn't have _STA and if any one of its functions'
|
||||
* configuration space is configured, return 0x0f as a _STA.
|
||||
*
|
||||
* otherwise return 0
|
||||
* Otherwise return 0.
|
||||
*/
|
||||
static unsigned int get_slot_status(struct acpiphp_slot *slot)
|
||||
{
|
||||
@@ -1281,6 +1277,7 @@ static unsigned int get_slot_status(struct acpiphp_slot *slot)
|
||||
|
||||
/**
|
||||
* acpiphp_eject_slot - physically eject the slot
|
||||
* @slot: ACPI PHP slot
|
||||
*/
|
||||
int acpiphp_eject_slot(struct acpiphp_slot *slot)
|
||||
{
|
||||
@@ -1314,6 +1311,7 @@ int acpiphp_eject_slot(struct acpiphp_slot *slot)
|
||||
|
||||
/**
|
||||
* acpiphp_check_bridge - re-enumerate devices
|
||||
* @bridge: where to begin re-enumeration
|
||||
*
|
||||
* Iterate over all slots under this bridge and make sure that if a
|
||||
* card is present they are enabled, and if not they are disabled.
|
||||
@@ -1538,13 +1536,11 @@ check_sub_bridges(acpi_handle handle, u32 lvl, void *context, void **rv)
|
||||
|
||||
/**
|
||||
* handle_hotplug_event_bridge - handle ACPI event on bridges
|
||||
*
|
||||
* @handle: Notify()'ed acpi_handle
|
||||
* @type: Notify code
|
||||
* @context: pointer to acpiphp_bridge structure
|
||||
*
|
||||
* handles ACPI event notification on {host,p2p} bridges
|
||||
*
|
||||
* Handles ACPI event notification on {host,p2p} bridges.
|
||||
*/
|
||||
static void handle_hotplug_event_bridge(acpi_handle handle, u32 type, void *context)
|
||||
{
|
||||
@@ -1634,13 +1630,11 @@ static void handle_hotplug_event_bridge(acpi_handle handle, u32 type, void *cont
|
||||
|
||||
/**
|
||||
* handle_hotplug_event_func - handle ACPI event on functions (i.e. slots)
|
||||
*
|
||||
* @handle: Notify()'ed acpi_handle
|
||||
* @type: Notify code
|
||||
* @context: pointer to acpiphp_func structure
|
||||
*
|
||||
* handles ACPI event notification on slots
|
||||
*
|
||||
* Handles ACPI event notification on slots.
|
||||
*/
|
||||
static void handle_hotplug_event_func(acpi_handle handle, u32 type, void *context)
|
||||
{
|
||||
@@ -1705,7 +1699,6 @@ static struct acpi_pci_driver acpi_pci_hp_driver = {
|
||||
|
||||
/**
|
||||
* acpiphp_glue_init - initializes all PCI hotplug - ACPI glue data structures
|
||||
*
|
||||
*/
|
||||
int __init acpiphp_glue_init(void)
|
||||
{
|
||||
@@ -1726,7 +1719,7 @@ int __init acpiphp_glue_init(void)
|
||||
/**
|
||||
* acpiphp_glue_exit - terminates all PCI hotplug - ACPI glue data structures
|
||||
*
|
||||
* This function frees all data allocated in acpiphp_glue_init()
|
||||
* This function frees all data allocated in acpiphp_glue_init().
|
||||
*/
|
||||
void acpiphp_glue_exit(void)
|
||||
{
|
||||
@@ -1760,7 +1753,6 @@ int __init acpiphp_get_num_slots(void)
|
||||
* acpiphp_for_each_slot - call function for each slot
|
||||
* @fn: callback function
|
||||
* @data: context to be passed to callback function
|
||||
*
|
||||
*/
|
||||
static int acpiphp_for_each_slot(acpiphp_callback fn, void *data)
|
||||
{
|
||||
@@ -1786,6 +1778,7 @@ static int acpiphp_for_each_slot(acpiphp_callback fn, void *data)
|
||||
|
||||
/**
|
||||
* acpiphp_enable_slot - power on slot
|
||||
* @slot: ACPI PHP slot
|
||||
*/
|
||||
int acpiphp_enable_slot(struct acpiphp_slot *slot)
|
||||
{
|
||||
@@ -1815,6 +1808,7 @@ int acpiphp_enable_slot(struct acpiphp_slot *slot)
|
||||
|
||||
/**
|
||||
* acpiphp_disable_slot - power off slot
|
||||
* @slot: ACPI PHP slot
|
||||
*/
|
||||
int acpiphp_disable_slot(struct acpiphp_slot *slot)
|
||||
{
|
||||
|
Reference in New Issue
Block a user