I am sponsoring this fasttrack for Tim Szeto. Requested binding is minor.
Timeout is set for 09/28/2009.
- John
Template Version: @(#)sac_nextcase 1.68 02/23/09 SMI
This information is Copyright 2009 Sun Microsystems
1. Introduction
1.1. Project/Component Working Name:
libstmf validate view interface
1.2. Name of Document Author/Supplier:
Author: Tim Szeto
1.3 Date of This Document:
21 September, 2009
4. Technical Description
This case adds one new interface to libstmf (PSARC 2007/523) for
validation of a logical unit number per view entry, or to find an
available logical unit number per view entry. This function allows the
client to better manage logical unit numbers across multiple STMF
instances in a cluster environment.
The new interface (stmfValidateView(3STMF)) enables the client to check
if the logical unit number is in use based on the view entry parameters
(target group, host group and logical unit number). This interface also
enables the client to query for an available logical unit number based
on the view entry.
4.1 stmfValidateView(3STMF)
NAME
stmfValidateView - validate/get logical unit number per
view entry
SYNOPSIS
cc [ flag... ] file... -lstmf [ library... ]
#include <libstmf.h>
int stmfValidateView(stmfViewEntry *view);
PARAMETERS
view The view entry to validate or get the logical number.
DESCRIPTION
The stmfValidateView() function validates the logical unit
number. This is done by setting view->luNbrValid to B_TRUE and
setting view->luNbr to the logical unit number. A valid logical
unit number is in the range of 0-16383.
The stmfValidateView() function find the next available
logical unit number. The is done by setting view->luNbrValid to
B_FALSE. On success, the available logical unit number is returned in
view->luNbr.
RETURN VALUES
STMF_STATUS_SUCCESS The API call was successful
STMF_ERROR_LUN_IN_USE The specified logical unit number
is already in use for this logical
unit.
ATTRIBUTES
See attributes(5) for descriptions of the following attri-
butes:
_____________________________ _____________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Interface Stability | Committed |
|_____________________________|_____________________________|
| MT-Level | Safe |
|_____________________________|_____________________________|
SEE ALSO
libstmf(3LIB), attributes(5), stmfAddViewEntry(3STMF)
6. Resources and Schedule
6.4. Steering Committee requested information
6.4.1. Consolidation C-team Name:
ON
6.5. ARC review type: FastTrack
6.6. ARC Exposure: open
