setosuuid サブルーチン

目的

オペレーティング・システムの Universal Unique Identifier (UUID) を設定します。

ライブラリー

標準 C ライブラリー (libc.a)

構文

#include <uuid.h>
int setosuuid (uuid)
uuid_t * uuid;

説明

setosuuid サブルーチンは、 uuid パラメーターが指す UUID をオペレーティング・システム UUID として AIX® カーネルに保存します。 このサブルーチンは、root 特権でのみ実行できます。

注:

AIX オペレーティング・システムの UUID は、 chdev コマンドを使用して、新しいシステム生成 UUID にリセットすることができます。 UUID を空ストリングに設定すると、システムは新しい UUID を生成します。

chdev -l sys0 -a os_uuid="" 

chdev コマンドを使用して、 AIX オペレーティング・システムの UUID を特定の UUID にリセットすることができます。

chdev -l sys0 -a os_uuid="<uuid_string>" 

chdev コマンドを使用して UUID を無効な UUID にリセットすると、システムはこの UUID を無視して新しい UUID を生成します。

パラメーター

項目 説明
uuid オペレーティング・システム UUID として保存する UUID を指定します。

戻り値

正常終了すると、 setosuuid サブルーチンは値 0 を戻します。 そうでない場合は-1が返され、エラーを示すerrnoグローバル変数が設定される。

エラー・コード

項目 説明
EPERM プロセスに適切な特権がありません。
EFAULT パラメーター uuid のアドレスが無効です。