| .\" -*- nroff -*- |
| .\" Licensed under the OpenIB.org BSD license (FreeBSD Variant) - See COPYING.md |
| .\" |
| .TH UMAD_GET_ISSM_PATH 3 "Oct 18, 2007" "OpenIB" "OpenIB Programmer's Manual" |
| .SH "NAME" |
| umad_get_issm_path \- get path of issm device |
| .SH "SYNOPSIS" |
| .nf |
| .B #include <infiniband/umad.h> |
| .sp |
| .BI "int umad_get_issm_path(char " "*ca_name" ", int " "portnum", char *path, int max); |
| .fi |
| .SH "DESCRIPTION" |
| .B umad_get_issm_path() |
| resolves path to issm device (which used for setting/clearing PortInfo:CapMask IsSM bit) for |
| .I portnum |
| of the IB device |
| .I ca_name |
| , it stores resolved path in |
| .I path |
| array which cannot exceed |
| .I max |
| bytes in length (including NULL terminator). |
| .fi |
| Opening issm device sets PortInfo:CapMask IsSM bit and closing clears it. |
| .fi |
| .SH "RETURN VALUE" |
| .B umad_open_port() |
| returns 0 on success and a negative value on error as follows: |
| -ENODEV IB device can't be resolved |
| -EINVAL port is not valid (bad |
| .I portnum\fR |
| or no umad device) |
| .SH "SEE ALSO" |
| .BR umad_open_port (3), |
| .BR umad_get_port (3) |
| .SH "AUTHOR" |
| .TP |
| Sasha Khapyorsky <sashak@voltaire.com> |
