getzonerootbyid(3TSOL)

名前 | 形式 | 機能説明 | 戻り値 | エラー | 属性 | 関連項目

名前

getzonerootbyid, getzonerootbylabel, getzonerootbyname – ゾーンのルートパス名とラベル間のマッピング

形式

cc [flags...] file... -ltsol

#include <tsol/label.h>

char *getzonerootbyid(zoneid_t zoneid);

char *getzonerootbylabel(const m_label_t *label);

char *getzonerootbyname(const char *zonename);

機能説明

getzonerootbyid() 関数は、zoneid のルートパス名を返します。

getzonerootbylabel() 関数は、ラベルが label であるゾーンのルートパス名を返します。

getzonerootbyname() 関数は、zonename のルートパス名を返します。

これらのどの関数の場合でも、指定されたゾーンの状態が ZONE_IS_READY であることが最低限必要です。呼び出し元プロセスのゾーンが指定されたゾーンのラベルに対して優位にあるか、呼び出し元プロセスが大域ゾーン内に存在する必要があります。返されるパス名は、呼び出し元のゾーンのルートパスとの相対位置を示します。

戻り値

成功時に、getzonerootbyid()、getzonerootbylabel()、および getzonerootbyname() 関数は、これらの関数内部で割り当てられているパス名へのポインタを返します。記憶領域の解放には、free(3C) を使用します。失敗時に、これらの関数は NULL を返して、エラーを示す errno を設定します。

エラー

EINVAL

zoneid が無効であるか、ゾーンが見つからないか、またはゾーンの準備ができていません。

EFAULT

無効な引数。ポインタの位置が無効です。

ENOMEM

パス名を割り当てることができません。

ENOENT

ゾーンが存在しません。

属性

次の属性については、attributes(5) を参照してください。

属性タイプ	属性値
使用条件	SUNWcslr
MT レベル	安全
インタフェースの安定性	安定

関連項目

Intro(2), free(3C), getzonenamebyid(3C), attributes(5), labels(5)

SunOS 5.10  最終更新日 2006 年 6 月 26 日

名前 | 形式 | 機能説明 | 戻り値 | エラー | 属性 | 関連項目