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

.SH NAME
ib_sa_path_rec_get \- Start a Path get query
.SH SYNOPSIS
"SYNOPSIS"
.sp
\fB
.sp
int ib_sa_path_rec_get  (struct ib_device * \fIdevice\fB, u8 \fIport_num\fB, struct ib_sa_path_rec * \fIrec\fB, ib_sa_comp_mask \fIcomp_mask\fB, int \fItimeout_ms\fB, unsigned int __nocast \fIgfp_mask\fB, void (*\fIcallback\fB)
int status,      struct ib_sa_path_rec *resp,      void *context, void * \fIcontext\fB, struct ib_sa_query ** \fIsa_query\fB);
\fR
.SH "ARGUMENTS"
.TP
\fB\fIdevice\fB\fR
device to send query on
.TP
\fB\fIport_num\fB\fR
port number to send query on
.TP
\fB\fIrec\fB\fR
Path Record to send in query
.TP
\fB\fIcomp_mask\fB\fR
component mask to send in query
.TP
\fB\fItimeout_ms\fB\fR
time to wait for response
.TP
\fB\fIgfp_mask\fB\fR
GFP mask to use for internal allocations
.TP
\fB\fIcallback\fB\fR
function called when query completes, times out or is
canceled
.TP
\fB\fIcontext\fB\fR
opaque user context passed to callback
.TP
\fB\fIsa_query\fB\fR
query context, used to cancel query
.SH "DESCRIPTION"
.PP
Send a Path Record Get query to the SA to look up a path.  The
callback function will be called when the query completes (or
fails); status is 0 for a successful response, -EINTR if the query
is canceled, -ETIMEDOUT is the query timed out, or -EIO if an error
occurred sending the query.  The resp parameter of the callback is
only valid if status is 0.
.PP
If the return value of \fBib_sa_path_rec_get\fR is negative, it is an
error code.  Otherwise it is a query ID that can be used to cancel
the query.