Current File : //usr/man/man3/ibv_open_device.3

'\" te
.\" -*- nroff -*-
.\"
.TH IBV_OPEN_DEVICE 3 2006-10-31 libibverbs "Libibverbs Programmer's Manual"
.SH "NAME"
ibv_open_device, ibv_close_device \- open and close an InfiniBand device context
.SH "SYNOPSIS"
.nf
.B #include <infiniband/verbs.h>
.sp
.BI "struct ibv_context *ibv_open_device(struct ibv_device " "*device" ");
.sp
.BI "int ibv_close_device(struct ibv_context " "*context" ");
.fi
.SH "DESCRIPTION"
.B ibv_open_device()
opens the device
.I device
and creates a context for further use.
.PP
.B ibv_close_device()
closes the device context
.I context\fR.
.SH "RETURN VALUE"
.B ibv_open_device()
returns a pointer to the allocated device context, or NULL if the request fails.
.PP
.B ibv_close_device()
returns 0 on success, \-1 on failure.

.\" Oracle has added the ARC stability level to this manual page
.SH ATTRIBUTES
See
.BR attributes (5)
for descriptions of the following attributes:
.sp
.TS
box;
cbp-1 | cbp-1
l | l .
ATTRIBUTE TYPE	ATTRIBUTE VALUE 
=
Availability	network/open-fabrics
=
Stability	Volatile
.TE 
.PP
.SH "NOTES"
.B ibv_close_device()
does not release all the resources allocated using context
.I context\fR.
To avoid resource leaks, the user should release all associated
resources before closing a context.
.SH "SEE ALSO"
.BR ibv_get_device_list (3),
.BR ibv_query_device (3),
.BR ibv_query_port (3),
.BR ibv_query_gid (3),
.BR ibv_query_pkey (3)
.SH "AUTHORS"
.TP
Dotan Barak <dotanb@mellanox.co.il>


.\" Oracle has added source availability information to this manual page
This software was built from source available at https://java.net/projects/solaris-userland.  The original community source was downloaded from  ['http://download.oracle.com/otn-pub/oss/networking/libsif-1.0.tar.gz', 'http://www.openfabrics.org/downloads/ibutils/ibutils-1.5.7.tar.gz', 'http://www.openfabrics.org/downloads/libibverbs/libibverbs-1.1.4-1.22.g7257cd3.tar.gz', 'http://www.openfabrics.org/downloads/libmlx4/libmlx4-1.0.1-1.18.gb810a27.tar.gz', 'http://www.openfabrics.org/downloads/libsdp/libsdp-1.1.108-0.15.gd7fdb72.tar.gz', 'http://www.openfabrics.org/downloads/management/infiniband-diags-1.5.8.tar.gz', 'http://www.openfabrics.org/downloads/management/libibmad-1.3.7.tar.gz', 'http://www.openfabrics.org/downloads/management/libibumad-1.3.7.tar.gz', 'http://www.openfabrics.org/downloads/management/opensm-3.3.9.tar.gz', 'http://www.openfabrics.org/downloads/perftest/perftest-1.3.0-0.42.gf350d3d.tar.gz', 'http://www.openfabrics.org/downloads/qperf/qperf-0.4.6-0.1.gb81434e.tar.gz', 'http://www.openfabrics.org/downloads/rdmacm/librdmacm-1.0.14.1.tar.gz', 'http://www.openfabrics.org/downloads/rds-tools/rds-tools-2.0.4.tar.gz']

Further information about this software can be found on the open source community website at http://www.openfabrics.org/.