xref: /titanic_44/usr/src/man/man3stmf/stmfModifyLu.3stmf (revision 87308b749adb04ab3f564c765b089962af3edb4d)
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)