Hallo, dies ist ein Test.

PWD: /www/data-lst1/unixsoft/unixsoft/kaempfer/.public_html

Running in File Mode
Relative path: ./../../../../../../usr/man/man3ima/./IMA_SetNodeAlias.3ima
Real path: /usr/share/man/man3ima/IMA_SetNodeAlias.3ima
Zurück

'\" te
.\" Copyright (c) 2016, Oracle and/or its affiliates. All rights reserved.
.TH IMA_SetNodeAlias 3IMA "30 July 2016" "Oracle Solaris 11.4" "iSCSI Management API"
.SH NAME
IMA_SetNodeAlias \- Sets the alias of a specified node
.SH SYNOPSIS

.LP
.nf
cc [ flag... ] file... -lima [ library... ]
#include <ima.h>

IMA_STATUS IMA_SetNodeAlias
      /* in */      IMA_OID nodeOid,
      /* in */      const IMA_NODE_ALIAS newAlias
);
.fi
.SH PARAMETERS

.sp
.ne 2
.mk
.na
\fB\fInodeOid\fR\fR
.ad
.RS 12n
.rt
The object ID of the node whose alias is being set.
.RE

.sp
.ne 2
.mk
.na
\fB\fInewAlias\fR\fR
.ad
.RS 12n
.rt
A pointer to the Unicode string that contains the new node alias. If this parameter is \fBNULL\fR, then the current alias is deleted, and the specified node no longer has an alias.
.RE

.SH DESCRIPTION
.sp
.LP
The \fBIMA_SetNodeAlias()\fR API sets the alias of a specified node.
.SH RETURN VALUES

.sp
.ne 2
.mk
.na
\fB\fBIMA_STATUS_REBOOT_NECESSARY\fR\fR
.ad
.br
.sp .6
.RS 4n
Returned if a reboot is necessary before the setting of the alias takes effect
.RE

.sp
.ne 2
.mk
.na
\fB\fBIMA_ERROR_INVALID_PARAMETER\fR\fR
.ad
.br
.sp .6
.RS 4n
Returned if the \fInewAlias\fR argument is \fBNULL\fR, or specifies a memory area from which data cannot be read
.RE

.sp
.ne 2
.mk
.na
\fB\fBIMA_ERROR_INVALID_OBJECT_TYPE\fR\fR
.ad
.br
.sp .6
.RS 4n
Returned if the \fInodeOid\fR argument does not specify a valid object type
.RE

.sp
.ne 2
.mk
.na
\fB\fBIMA_ERROR_INCORRECT_OBJECT_TYPE\fR\fR
.ad
.br
.sp .6
.RS 4n
Returned if the \fInodeOid\fR argument does not specify a node object
.RE

.sp
.ne 2
.mk
.na
\fB\fBIMA_ERROR_OBJECT_NOT_FOUND\fR\fR
.ad
.br
.sp .6
.RS 4n
Returned if the \fInodeOid\fR argument does not specify a node known to the system
.RE

.sp
.ne 2
.mk
.na
\fB\fBIMA_ERROR_NAME_TOO_LONG\fR\fR
.ad
.br
.sp .6
.RS 4n
Returned if the \fInewAlias\fR argument contains more than 255 bytes when encoded in the UTF-8 format
.RE

.SH ATTRIBUTES
.sp
.LP
See \fBattributes\fR(7) for descriptions of the following attributes:
.sp
.TS
tab(
) box;
cw(2.75i) |cw(2.75i) 
lw(2.75i) |lw(2.75i) 
.
ATTRIBUTE TYPE
ATTRIBUTE VALUE
_
Availability
\fBsystem/library/storage/snia-ima\fR
_
Interface Stability
Volatile
_
MT-Level
Safe
.TE
.sp
.SH SEE ALSO
.sp
.LP
\fBlibima\fR(3LIB), \fBattributes\fR(7), \fBIMA_GetSharedNodeOid\fR(3IMA), \fBIMA_GetNodeProperties\fR(3IMA), \fBIMA_SetNodeName\fR(3IMA)