.\" 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 "DECLARE_MUTEX" "9" "09 October 2005" "" ""

.SH NAME
DECLARE_MUTEX \- allocate a new host controller.
.SH SYNOPSIS
"SYNOPSIS"
.sp
\fB
.sp
DECLARE_MUTEX  ( \fIhost_num_alloc\fB);
\fR
.SH "ARGUMENTS"
.TP
\fB\fIhost_num_alloc\fB\fR
.SH "DESCRIPTION"
.PP
Allocate a &hpsb_host and initialize the general subsystem specific
fields.  If the driver needs to store per host data, as drivers
usually do, the amount of memory required can be specified by the
\fIextra\fR parameter.  Once allocated, the driver should initialize the
driver specific parts, enable the controller and make it available
to the general subsystem using \fBhpsb_add_host\fR\&.
.SH "RETURN VALUE"
.PP
a pointer to the &hpsb_host if succesful, NULL if
no memory was available.