STMFDEVIDFROMWWN(3STMF) SCSI Target Mode Framework Library Functions

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
identifier. 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(7) for descriptions of the following attributes:


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

SEE ALSO

libstmf(3LIB), attributes(7)

June 9, 2008 STMFDEVIDFROMWWN(3STMF)