.\" This manpage has been automatically generated by docbook2man 
.\" from a DocBook document.  This tool can be found at:
.\" <http://shell.ipoline.com/~elmert/comp/docbook2X/> 
.\" Please send any bug reports, improvements, comments, patches, 
.\" etc. to Steve Cheng <steve@ggi-project.org>.
.TH "AMBA_FIND_DEVICE" "9" "09 October 2005" "" ""

.SH NAME
amba_find_device \- locate an AMBA device given a bus id
.SH SYNOPSIS
"SYNOPSIS"
.sp
\fB
.sp
struct amba_device * amba_find_device  (const char * \fIbusid\fB, struct device * \fIparent\fB, unsigned int \fIid\fB, unsigned int \fImask\fB);
\fR
.SH "ARGUMENTS"
.TP
\fB\fIbusid\fB\fR
bus id for device (or NULL)
.TP
\fB\fIparent\fB\fR
parent device (or NULL)
.TP
\fB\fIid\fB\fR
peripheral ID (or 0)
.TP
\fB\fImask\fB\fR
peripheral ID mask (or 0)
.SH "DESCRIPTION"
.PP
Return the AMBA device corresponding to the supplied parameters.
If no device matches, returns NULL.
.SH "NOTE"
.PP
When a valid device is found, its refcount is
incremented, and must be decremented before the returned
reference.