'\" t .\" Title: pci_dev_get .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author] .\" Generator: DocBook XSL Stylesheets v1.79.1 .\" Date: July 2017 .\" Manual: Hardware Interfaces .\" Source: Kernel Hackers Manual 4.11.6 .\" Language: English .\" .TH "PCI_DEV_GET" "9" "July 2017" "Kernel Hackers Manual 4\&.11\&" "Hardware Interfaces" .\" ----------------------------------------------------------------- .\" * Define some portability stuff .\" ----------------------------------------------------------------- .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .\" http://bugs.debian.org/507673 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" ----------------------------------------------------------------- .\" * set default formatting .\" ----------------------------------------------------------------- .\" disable hyphenation .nh .\" disable justification (adjust text to left margin only) .ad l .\" ----------------------------------------------------------------- .\" * MAIN CONTENT STARTS HERE * .\" ----------------------------------------------------------------- .SH "NAME" pci_dev_get \- increments the reference count of the pci device structure .SH "SYNOPSIS" .HP \w'struct\ pci_dev\ *\ pci_dev_get('u .BI "struct pci_dev * pci_dev_get(struct\ pci_dev\ *\ " "dev" ");" .SH "ARGUMENTS" .PP \fIstruct pci_dev * dev\fR .RS 4 the device being referenced .RE .SH "DESCRIPTION" .PP Each live reference to a device should be refcounted\&. .PP Drivers for PCI devices should normally record such references in their \fBprobe\fR methods, when they bind to a device, and release them by calling \fBpci_dev_put\fR, in their \fBdisconnect\fR methods\&. .PP A pointer to the device with the incremented reference counter is returned\&. .SH "COPYRIGHT" .br