hkeyset_add、hkeyset_replace、hkeyset_restore、または hkeyset_get カーネル・サービス

目的

カーネル環境でのコード実行に使用される保護ドメイン (ストレージ・キーによって制御されるページ・アクセス) を操作します。

構文

#include <sys/skeys.h>
hkeyset_t hkeyset_add ( 鍵セット _T キー・セット );
hkeyset_t hkeyset_replace ( 鍵セット _T キー・セット );
void hkeyset_restore ( 鍵セット _T キー・セット );
hkeyset_t hkeyset_get ( 無効 );

パラメーター

項目 説明
キー・セット 活動化するハードウェア・キー・セット。

説明

ストレージ保護キーが有効になっている場合、すべてのメモリー・ページにハードウェア・ストレージ保護キーが関連付けられます。 キー・セットは、ストレージ保護キーのセットに対するアクセス権を表現したものです。 メモリー・ページにアクセスするには、メモリー・ページに関連付けられたストレージ・キーを含むハードウェア・キー・セットがアクティブでなければなりません。

鍵セット追加 カーネル・サービスは、 キー・セット パラメーターで指定されたハードウェア・キーセットを現在アドレス可能なハードウェア・キーセットに追加することによって、プロテクション・ドメインを更新します。 前のハードウェア・キー・セットが戻されます。

鍵セット置換 カーネル・サービスは、 キー・セット パラメーターで指定されたハードウェア・キーセットを現在アドレス可能なストレージ・セットとしてロードすることにより、プロテクション・ドメインを更新します。 前のハードウェア・キー・セットが戻されます。

hkeyset_restore カーネル・サービスは、モジュール・エントリー・ポイントから戻るときに、呼び出し側のハードウェア・キーセットを復元します。 値は返されません。

鍵セット取得 カーネル・サービスは、現行のハードウェア・キー・セットを変更せずに読み取ります。

実行環境

鍵セット追加鍵セット置換hkeyset_restore、または 鍵セット取得 カーネル・サービスは、 処理 環境または 割り込み 環境のいずれかから呼び出すことができます。

戻り値

鍵セット追加鍵セット置換、および 鍵セット取得 カーネル・サービスは、呼び出し前にアクティブであった キー・セット 値を返します。 hkeyset_restore カーネル・サービスは値を返しません。