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

.SH NAME
idr_get_new \- allocate new idr entry
.SH SYNOPSIS
"SYNOPSIS"
.sp
\fB
.sp
int idr_get_new  (struct idr * \fIidp\fB, void * \fIptr\fB, int * \fIid\fB);
\fR
.SH "ARGUMENTS"
.TP
\fB\fIidp\fB\fR
idr handle
.TP
\fB\fIptr\fB\fR
pointer you want associated with the ide
.TP
\fB\fIid\fB\fR
pointer to the allocated handle
.SH "DESCRIPTION"
.PP
This is the allocate id function.  It should be called with any
required locks.
.PP
If memory is required, it will return -EAGAIN, you should unlock
and go back to the \fBidr_pre_get\fR call.  If the idr is full, it will
return -ENOSPC.
.PP
\fIid\fR returns a value in the range 0 ... 0x7fffffff