opensolaris man page for stmfdevidfromwwn

stmfDevidFromWwn(3STMF) 			   SCSI Target Mode Framework Library Functions 			   stmfDevidFromWwn(3STMF)

NAME
       stmfDevidFromWwn - convert a WWN to a stmfDevid structure

SYNOPSIS
       cc [ flag... ] file... -lstmf [ library... ]
       #include <libstmf.h>

       int stmfDevidFromWWN(uchar_t wwn[8], stmfDevid *devid);

PARAMETERS
       wwn	The 8-byte WWN identifier.

       devid	A  pointer  to a stmfDevid structure allocated by the caller. On successful return, this will contain the converted device identi-
		fier. On error, the value of this parameter is undefined.

DESCRIPTION
       The stmfDevidFromWwn function convert a WWN to a stmfDevid structure. It returns the devid as a SCSI name string.

RETURN VALUES
       The following values are returned:

       STMF_ERROR_INVALID_ARGUMENT

	   The value of wwn was not valid WWN identifier.

       STMF_STATUS_SUCCESS

	   The API call was successful.

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Committed 		   |
       +-----------------------------+-----------------------------+
       |MT-Level		     |Safe			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       libstmf(3LIB), attributes(5)

SunOS 5.11							    9 Jun 2008						   stmfDevidFromWwn(3STMF)