.\" Copyright (C) 2006 Red Hat, Inc. All Rights Reserved. .\" Written by David Howells (dhowells@redhat.com) .\" .\" %%%LICENSE_START(GPLv2+_SW_ONEPARA) .\" This program is free software; you can redistribute it and/or .\" modify it under the terms of the GNU General Public License .\" as published by the Free Software Foundation; either version .\" 2 of the License, or (at your option) any later version. .\" %%%LICENSE_END .\" .\" FIXME Document KEYCTL_REJECT (new in 2.6.39) .\" commit fdd1b94581782a2ddf9124414e5b7a5f48ce2f9c .\" Author: David Howells .\" Documentation/security/keys.txt .\" FIXME Document KEYCTL_INSTANTIATE_IOV (new in 2.6.39) .\" commit ee009e4a0d4555ed522a631bae9896399674f064 .\" Author: David Howells .\" Documentation/security/keys.txt .\" FIXME Document KEYCTL_INVALIDATE (new in 3.5) .\" commit fd75815f727f157a05f4c96b5294a4617c0557da .\" Author: David Howells .\" Documentation/security/keys.txt .\" FIXME Document KEYCTL_GET_PERSISTENT (new in 3.13) .\" commit f36f8c75ae2e7d4da34f4c908cebdb4aa42c977e .\" Author: David Howells .\" .\"******************************************************************* .\" .\" This file was generated with po4a. Translate the source file. .\" .\"******************************************************************* .TH KEYCTL 2 2014\-01\-22 Linux "Linux Key Management Calls" .SH 名前 keyctl \- カーネルの鍵管理機能を操作する .SH 書式 .nf \fB#include \fP .sp \fBlong keyctl(int \fP\fIcmd\fP\fB, ...);\fP .fi .SH 説明 \fBkeyctl\fP() has a number of functions available: .TP \fBKEYCTL_GET_KEYRING_ID\fP 鍵リングの ID を取得する。 .TP \fBKEYCTL_JOIN_SESSION_KEYRING\fP Join or start named session keyring. .TP \fBKEYCTL_UPDATE\fP 鍵を更新する。 .TP \fBKEYCTL_REVOKE\fP 鍵を廃止する。 .TP \fBKEYCTL_CHOWN\fP 鍵の所有者を設定する。 .TP \fBKEYCTL_SETPERM\fP 鍵のアクセス許可を設定する。 .TP \fBKEYCTL_DESCRIBE\fP Describe a key. .TP \fBKEYCTL_CLEAR\fP 鍵リングの内容をクリアする。 .TP \fBKEYCTL_LINK\fP 鍵を鍵リングに結びつける。 .TP \fBKEYCTL_UNLINK\fP 鍵の鍵リングへの結びつけを取り消す。 .TP \fBKEYCTL_SEARCH\fP 鍵リングから鍵を検索する。 .TP \fBKEYCTL_READ\fP 鍵や鍵リングの内容を読み出す。 .TP \fBKEYCTL_INSTANTIATE\fP Instantiate a partially constructed key. .TP \fBKEYCTL_NEGATE\fP Negate a partially constructed key. .TP \fBKEYCTL_SET_REQKEY_KEYRING\fP Set default request\-key keyring. .TP \fBKEYCTL_SET_TIMEOUT\fP 鍵にタイムアウトを設定する。 .TP \fBKEYCTL_ASSUME_AUTHORITY\fP Assume authority to instantiate key. .P These are wrapped by \fBlibkeyutils\fP into individual functions to permit compiler the compiler to check types. See the \fBSee Also\fP section at the bottom. .SH 返り値 成功すると \fBkeyctl\fP() は見つかった鍵のシリアル番号を返す。 エラーの場合、 値 \-1 が返され、 \fIerrno\fP にエラーを示す値が設定される。 .SH エラー .TP \fBEACCES\fP 鍵の操作が許可されていなかった。 .TP \fBEDQUOT\fP 鍵を作成するか、 鍵を鍵リングに結びつけると、 呼び出し元ユーザーの鍵のクォータを超過してしまう。 .TP \fBEKEYEXPIRED\fP 期限切れの鍵が見つかったか指定された。 .TP \fBEKEYREJECTED\fP 除外 (rejected) された鍵が見つかったか指定された。 .TP \fBEKEYREVOKED\fP 廃止された鍵が見つかったか指定された。 .TP \fBENOKEY\fP 一致する鍵が見つからなかったか、 無効な鍵が指定された。 .SH LINKING これは Linux のシステムコールだが、 \fIlibc\fP には存在せず、 代わりに \fIlibkeyutils\fP に存在する。 リンクする際には、 リンカーに \fB\-lkeyutils\fP を指定する必要がある。 .SH 関連項目 .ad l .nh \fBkeyctl\fP(1), \fBadd_key\fP(2), \fBrequest_key\fP(2), \fBkeyctl_set_timeout\fP(3), \fBkeyctl_chown\fP(3), \fBkeyctl_clear\fP(3), \fBkeyctl_describe\fP(3), \fBkeyctl_describe_alloc\fP(3), \fBkeyctl_get_keyring_ID\fP(3), \fBkeyctl_instantiate\fP(3), \fBkeyctl_join_session_keyring\fP(3), \fBkeyctl_link\fP(3), \fBkeyctl_negate\fP(3), \fBkeyctl_revoke\fP(3), \fBkeyctl_search\fP(3), \fBkeyctl_setperm\fP(3), \fBkeyctl_set_reqkey_keyring\fP(3), \fBkeyctl_set_timeout\fP(3), \fBkeyctl_read\fP(3), \fBkeyctl_read_alloc\fP(3), \fBkeyctl_unlink\fP(3), \fBkeyctl_update\fP(3), \fBrequest\-key\fP(8) カーネルのソースファイル \fIDocumentation/security/keys.txt\fP .SH この文書について この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.78 の一部 である。プロジェクトの説明とバグ報告に関する情報は http://www.kernel.org/doc/man\-pages/ に書かれている。