'\" te
'\" te
.TH IBV_ASYNCWATCH 1 "August 8, 2012" "libibverbs" "USER COMMANDS"

.SH NAME
ibv_asyncwatch \- display asynchronous events

.SH SYNOPSIS
.sp
.nf
\fIibv_asyncwatch\fR [\-G | \-M] [\-s[<guid>]] [\-p port]
\fIibv_asyncwactch\fR \-s
\fIibv_asyncwatch\fR \-G \-s
\fIibv_asyncwatch\fR \-M \-s
\fIibv_asyncwatch\fR \-G [\-p port] \-s<guid1>,<guid2>,...
\fIibv_asyncwatch\fR \-M [\-p port] \-s<mgid1>,<mgid2>,...
.fi
.sp
.SH DESCRIPTION
.PP
Display asynchronous events forwarded to userspace for an InfiniBand device.
SM events can be monitored using the '-s' option, which optionally
takes a remote port GUID, or list of remote port GUIDS separated by ','.
If '-s' is specified with no argument then all remote nodes reachable
form device 0 are monitored, otherwise only the specified remote
nodes are monitored. The following SM events are monitored using
the '-s' option: 

    IBV_SM_EVENT_MCG_CREATED
         An MCG specified by the "mgid" has been created
         on this subnet.

    IBV_SM_EVENT_MCG_DELETED
         The MCG specified by the "mgid" has been deleted
         on this subnet.

    IBV_SM_EVENT_GID_AVAIL
         The GID specified by the "guid" is available
         on this subnet.

    IBV_SM_EVENT_GID_UNAVAIL
         The GID specified by the "guid" is no longer
         available on this subnet.

.SH OPTIONS
.pp
\-G               Monitor SM event for Unicast GIDs
.sp
.pp
\-M               Monitor SM event for Multicast GIDs
.pp
\-s<GUID>         Takes as an optional argument a comma separated list of remote port GUIDs if \-G is specified or Multicast GIDs if \-M is specified.
.sp
.PP
\-p <port>        use the specified ca_port.
.sp
.pp
.SH EXAMPLES
.PP
To monitor event=IBV_SM_EVENT_ALL
.sp
ibv_asyncwatch -s
.sp
To monitor event=IBV_SM_EVENT_UGID_ALL
.sp
ibv_asyncwatch -G -s
.sp
To monitor event=IBV_SM_EVENT_MGID_ALL
.sp
ibv_asyncwatch -M -s
.sp
To monitor event=IBV_SM_EVENT_UGID
.sp
ibv_asyncwatch -G -s0x0021280001a0e4d9,0x0021280001a0e4da
.sp
To monitor event=IBV_SM_EVENT_MGID
.sp
ibv_asyncwatch -M -s0xff12:4001:ffff::c:2238
.sp


.\" 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

.\" 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/.