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

.SH NAME
idr_get_new_above \- allocate new idr entry above or equal to a start id
.SH SYNOPSIS
"SYNOPSIS"
.sp
\fB
.sp
int idr_get_new_above  (struct idr * \fIidp\fB, void * \fIptr\fB, int \fIstarting_id\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\fIstarting_id\fB\fR
-- undescribed --
.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