man/man3stmf/stmfModifyLu.3stmf

         te
 Copyright (c) 2009, Sun Microsystems Inc. All Rights Reserved.
 The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.
 See the License for the specific language governing permissions and limitations under the License. When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with
 the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
 STMFMODIFYLU 3STMF "May 8, 2009"
 NAME
stmfModifyLu, stmfModifyLuByFname - modify a logical uni
 SYNOPSIS

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

int stmfModifyLu(stmfGuid *luGuid, uint32_t prop, const char *propVal)


int stmfModifyLu(uint16_t dType, const char *fname, uint32_t prop,
 const char *propVal)


 PARAMETERS
luGuid

The guid of logical unit to modify.


fname

The filename of logical unit to modify.


dType

Type of logical unit. See stmfCreateLuResource(3STMF).


prop

A property type value. See DESCRIPTION for valid values.


propVal

A property value.


 DESCRIPTION

The stmfModifyLu() and stmfModifyLuByFname() functions modify the
properties of a logical unit device.

Valid properties for modify STMF_DISK:
STMF_LU_PROP_ALIAS

Up to 255 characters representing a user defined name for the device.
Default: Set to file name of backing store.


STMF_LU_PROP_SIZE

Numeric value with optional suffix (for example, 100G, 1T) to specify unit of
size.
Default: Size of device specified in the STMF_LU_PROP_DATA_FILENAME
property value.


STMF_LU_PROP_WRITE_CACHE_DISABLE

Write back cache disable. When specified as "true" or "false", specifies write
back cache disable behavior.
Default: Writeback cache setting of the backing store device specified by
STMF_LU_PROP_DATA_FILENAME.


STMF_LU_PROP_WRITE_PROTECT

Write protect bit. When specified as "true" or "false", specifies whether the
device behaves as a write protected device.
Default: "false"


 RETURN VALUES

The following values are returned:
STMF_STATUS_SUCCESS

The API call was successful.


STMF_ERROR_INVALID_ARG

Either prop or propVal is unrecognized.


STMF_ERROR_INVALID_PROPSIZE

The size of propVal is invalid.


STMF_ERROR_NO_PROP

The value of prop is unknown for this resource type.


 ATTRIBUTES

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


ATTRIBUTE TYPE ATTRIBUTE VALUE
Interface Stability Committed
MT-Level Safe


 SEE ALSO

libstmf(3LIB), stmfCreateLuResource(3STMF), attributes(5)