stmfGetViewLuNumberList(3STMF)

Name

stmfGetViewLuNumberList - retrieve the list of logical-unit-numbers

Synopsis

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

int stmfGetViewLuNumberList(viewResource resource,
      stmfLuNbrEntryList **luNbrList);

Parameters

resource

A view resource previously allocated using stmfGetViewResourceList(3STMF) call.

luNbrList

A pointer to a pointer to structure stmfLuNbrEntryList. On successful return, this will contain information of list of mapped logical-unit-numbers and the corresponding initiator for the given logical unit.

Description

The stmfGetViewLuNumberList() function retrieves the list of logical-unit-numbers mapped at that time for a specified logical unit for all initiators associated with the host group in a view entry. A view entry can be added to a logical unit either by requesting a system assigned automatic logical-unit-number or by specifying a fixed logical-unit-number. If a logical-unit-number was specified while adding the view entry, all the mapped logical-unit-numbers will be same for all initiators associated to the host group in the view entry throughout the existence of that view. If an assigned automatic logical-unit-number was requested, the system may remap the number for any initiator associated to the view to avoid any possible conflict, in which case logical-unit-numbers may vary across the initiators associated with the host group of the view.

The caller should call stmfFreeMemory(3STMF) when luNbrList data is no longer needed.

Return Values

The following values are returned:

STMF_STATUS_SUCCESS

The API call was successful.

STMF_ERROR_INVALID_ARG

Invalid arguments passed

Attributes

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

ATTRIBUTE TYPE ATTRIBUTE VALUE Interface Stability Committed MT-Level Safe

See also

libstmf(3LIB), stmfFreeMemory(3STMF), stmfGetViewResourceList(3STMF), attributes (5)