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 のアドレスが無効です。 |