keyctl() - Unix、Linux 系統呼叫

名稱

keyctl - 操作核心的關鍵管理功能

語法

#include <keyutils.h> 

long keyctl(int cmd, ...);

描述

keyctl() 提供了許多功能

標籤	描述
KEYCTL_GET_KEYRING_ID
	請求金鑰環的 ID。
KEYCTL_JOIN_SESSION_KEYRING
	加入或啟動命名的會話金鑰環。
KEYCTL_UPDATE
	更新金鑰。
KEYCTL_REVOKE
	撤銷金鑰。
KEYCTL_CHOWN
	設定金鑰的所有者。
KEYCTL_SETPERM
	設定金鑰的許可權。
KEYCTL_DESCRIBE
	描述金鑰。
KEYCTL_CLEAR
	清除金鑰環的內容。
KEYCTL_LINK
	將金鑰連結到金鑰環。
KEYCTL_UNLINK
	從金鑰環中取消連結金鑰。
KEYCTL_SEARCH
	在金鑰環中搜索金鑰。
KEYCTL_READ
	讀取金鑰或金鑰環的內容。
KEYCTL_INSTANTIATE
	例項化部分構建的金鑰。
KEYCTL_NEGATE
	否定部分構建的金鑰。
KEYCTL_SET_REQKEY_KEYRING
	設定預設請求金鑰金鑰環。
KEYCTL_SET_TIMEOUT
	設定金鑰的超時。
KEYCTL_ASSUME_AUTHORITY
	假定例項化金鑰的許可權。

這些都被libkeyutils封裝到各個函式中，以允許編譯器檢查型別。請參閱底部的另請參見部分。

返回值

成功時，keyctl() 返回找到的金鑰的序列號。如果發生錯誤，則返回-1，並且 errno 將被設定為相應的錯誤。

錯誤

標籤	描述
ENOKEY	未找到匹配的金鑰或指定了無效的金鑰。
EKEYEXPIRED
	找到或指定了已過期的金鑰。
EKEYREVOKED
	找到或指定了已撤銷的金鑰。
EKEYREJECTED
	找到或指定了被拒絕的金鑰。
EDQUOT	建立金鑰或將其連結到金鑰環將超過呼叫者的使用者的金鑰配額。
EACCES	金鑰操作不被允許。

連結

雖然這是一個 Linux 系統呼叫，但它不存在於libc中，而是在libkeyutils中。連結時，應向連結器指定-lkeyutils。

另請參見

keyctl (1)

add_key(2),
request_key(2),
keyctl_get_keyring_ID(3),
keyctl_join_session_keyring(3),
keyctl_update(3),
keyctl_revoke(3),
keyctl_chown(3),
keyctl_setperm(3),
keyctl_describe(3),
keyctl_clear(3),
keyctl_link(3),
keyctl_unlink(3),
keyctl_search(3),
keyctl_read(3),
keyctl_instantiate(3),
keyctl_negate(3),
keyctl_set_reqkey_keyring(3),
keyctl_set_timeout(3),
keyctl_assume_authority(3),
keyctl_describe_alloc(3),
keyctl_read_alloc(3),
request-key(8)

列印頁面