contrib/ofed/management/libibumad/man/umad_get_issm_path.3

   1 .\" -*- nroff -*-
   2 .\"
   3 .TH UMAD_GET_ISSM_PATH 3  "Oct 18, 2007" "OpenIB" "OpenIB Programmer\'s Manual"
   4 .SH "NAME"
   5 umad_get_issm_path \- get path of issm device
   6 .SH "SYNOPSIS"
   7 .nf
   8 .B #include <infiniband/umad.h>
   9 .sp
  10 .BI "int umad_get_issm_path(char " "*ca_name" ", int " "portnum", char *path, int max);
  11 .fi
  12 .SH "DESCRIPTION"
  13 .B umad_get_issm_path()
  14 resolves path to issm device (which used for setting/clearing PortInfo:CapMask IsSM bit) for
  15 .I portnum
  16 of the IB device
  17 .I ca_name
  18 , it stores resolved path in
  19 .I path
  20 array which cannot exceed
  21 .I max
  22 bytes in length (including NULL terminator).
  23 .fi
  24 Opening issm device sets PortInfo:CapMask IsSM bit and closing clears it.
  25 .fi
  26 .SH "RETURN VALUE"
  27 .B umad_open_port()
  28 returns 0 on success and a negative value on error as follows:
  29  -ENODEV IB device can\'t be resolved
  30  -EINVAL port is not valid (bad
  31 .I portnum\fR
  32 or no umad device)
  33 .SH "SEE ALSO"
  34 .BR umad_open_port (3),
  35 .BR umad_get_port (3)
  36 .SH "AUTHOR"
  37 .TP
  38 Sasha Khapyorsky <sashak@voltaire.com>