getppriv(2)

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

名前

getppriv, setppriv- 呼び出し元プロセスに関連する特権セットの取得と割り当て

形式

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


#include <tsol/priv.h>

int getppriv(priv_ptype_ttype, priv_set_t*pset);
int setppriv(priv_op_top, priv_ptype_ttype, priv_set_t*pset);

機能説明

getppriv() は、呼び出し元プロセスの特権セット type をアドレス pset にコピーします。type には、<tsol/priv.h> で定義されている次の ４ つの値のいずれかを指定します。

PRIV_EFFECTIVE

有効な特権セット

PRIV_INHERITABLE

継承可能な特権セット

PRIV_PERMITTED

許可された特権セット

PRIV_SAVED

保存された特権セット

setppriv() は、呼び出し元プロセスの特権セット (ターゲットセット) type の割り当てや変更を行います。変更は、op の値と特権セット (ソースセット) pset の値に基づいて行われます。op 値は <tsol/priv.h> にて次のように定義されています。

PRIV_ON

ソースセットに割り当てられている各特権がターゲットセットに割り当てられます。

PRIV_OFF

ソースセットに割り当てられている各特権がターゲットセットから消去されます。

PRIV_SET

ターゲットセットはソースセットとまったく同じになります。

type の値は、PRIV_SAVED を除き、getppriv() の type と同じです。

ターゲットセットが許可されたセットの場合は、ターゲットセットから消去されるすべての特権が有効なセットからも消去されます。許可されたセットから消去された特権を割り当てようとすると、エラーになります。消去済みの特権を消去しようとしても、エラーにはなりません。

戻り値

getppriv() と setppriv() からは、次の終了ステータスが返されます。

0

正常終了

-1

エラーが発生。エラーを示す errno が設定される

エラー

次の条件のいずれかに該当する場合、getppriv() は異常終了します。

EINVAL

不正な値や未定義の値が type に指定されている場合。

EFAULT

pset が無効なアドレスを参照している場合。

次の条件のいずれかに該当する場合、setppriv() は異常終了します。ターゲットセットは変更されません。

EINVAL

不正な値や未定義の値が type か op に指定されている場合。

EFAULT

set が無効なアドレスを参照している場合。

EINVAL

プロセスの特権セットに対し、許可されたセットから消去されている特権を割り当てようとしている場合。

関連項目

Trusted Solaris 7 リファレンスマニュアル

getfpriv(2), setfpriv(2), priv_to_str(3), priv_set_to_str(3), str_to_priv(3), str_to_priv_set(3), priv_macros(5)

Trusted Solaris 7  最終更新日 1999 年 12 月 31 日

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