Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

PCI: PCIe portdrv: Add kerneldoc comments to remining core funtions

Add kerneldoc comments to the reamining functions in
drivers/pci/pcie/portdrv_core.c .

Signed-off-by: Rafael J. Wysocki <rjw@sisk.pl>
Signed-off-by: Jesse Barnes <jbarnes@virtuousgeek.org>

authored by

Rafael J. Wysocki and committed by
Jesse Barnes
d9347371 fa6c9937

+34
+34
drivers/pci/pcie/portdrv_core.c
··· 370 370 pci_disable_msi(dev); 371 371 } 372 372 373 + /** 374 + * pcie_port_probe_service - probe driver for given PCI Express port service 375 + * @dev: PCI Express port service device to probe against 376 + * 377 + * If PCI Express port service driver is registered with 378 + * pcie_port_service_register(), this function will be called by the driver core 379 + * whenever match is found between the driver and a port service device. 380 + */ 373 381 static int pcie_port_probe_service(struct device *dev) 374 382 { 375 383 struct pcie_device *pciedev; ··· 401 393 return status; 402 394 } 403 395 396 + /** 397 + * pcie_port_remove_service - detach driver from given PCI Express port service 398 + * @dev: PCI Express port service device to handle 399 + * 400 + * If PCI Express port service driver is registered with 401 + * pcie_port_service_register(), this function will be called by the driver core 402 + * when device_unregister() is called for the port service device associated 403 + * with the driver. 404 + */ 404 405 static int pcie_port_remove_service(struct device *dev) 405 406 { 406 407 struct pcie_device *pciedev; ··· 429 412 return 0; 430 413 } 431 414 415 + /** 416 + * pcie_port_shutdown_service - shut down given PCI Express port service 417 + * @dev: PCI Express port service device to handle 418 + * 419 + * If PCI Express port service driver is registered with 420 + * pcie_port_service_register(), this function will be called by the driver core 421 + * when device_shutdown() is called for the port service device associated 422 + * with the driver. 423 + */ 432 424 static void pcie_port_shutdown_service(struct device *dev) {} 433 425 426 + /** 427 + * pcie_port_service_register - register PCI Express port service driver 428 + * @new: PCI Express port service driver to register 429 + */ 434 430 int pcie_port_service_register(struct pcie_port_service_driver *new) 435 431 { 436 432 new->driver.name = (char *)new->name; ··· 455 425 return driver_register(&new->driver); 456 426 } 457 427 428 + /** 429 + * pcie_port_service_unregister - unregister PCI Express port service driver 430 + * @drv: PCI Express port service driver to unregister 431 + */ 458 432 void pcie_port_service_unregister(struct pcie_port_service_driver *drv) 459 433 { 460 434 driver_unregister(&drv->driver);