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)