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

.SH NAME
ib_sa_service_rec_query \- Start Service Record operation
.SH SYNOPSIS
"SYNOPSIS"
.sp
\fB
.sp
int ib_sa_service_rec_query  (struct ib_device * \fIdevice\fB, u8 \fIport_num\fB, u8 \fImethod\fB, struct ib_sa_service_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_service_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 request on
.TP
\fB\fIport_num\fB\fR
port number to send request on
.TP
\fB\fImethod\fB\fR
SA method - should be get, set, or delete
.TP
\fB\fIrec\fB\fR
Service Record to send in request
.TP
\fB\fIcomp_mask\fB\fR
component mask to send in request
.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 request completes, times out or is
canceled
.TP
\fB\fIcontext\fB\fR
opaque user context passed to callback
.TP
\fB\fIsa_query\fB\fR
request context, used to cancel request
.SH "DESCRIPTION"
.PP
Send a Service Record set/get/delete to the SA to register,
unregister or query a service record.
The callback function will be called when the request 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_service_rec_query\fR is negative, it is an
error code.  Otherwise it is a request ID that can be used to cancel
the query.