release/man2/keyctl.2

   1 .\" Copyright (C) 2006 Red Hat, Inc. All Rights Reserved.
   2 .\" Written by David Howells (dhowells@redhat.com)
   3 .\"
   4 .\" %%%LICENSE_START(GPLv2+_SW_ONEPARA)
   5 .\" This program is free software; you can redistribute it and/or
   6 .\" modify it under the terms of the GNU General Public License
   7 .\" as published by the Free Software Foundation; either version
   8 .\" 2 of the License, or (at your option) any later version.
   9 .\" %%%LICENSE_END
  10 .\"
  11 .\" FIXME Document KEYCTL_REJECT (new in 2.6.39)
  12 .\"             commit fdd1b94581782a2ddf9124414e5b7a5f48ce2f9c
  13 .\"             Author: David Howells <dhowells@redhat.com>
  14 .\"             Documentation/security/keys.txt
  15 .\" FIXME Document KEYCTL_INSTANTIATE_IOV (new in 2.6.39)
  16 .\"             commit ee009e4a0d4555ed522a631bae9896399674f064
  17 .\"             Author: David Howells <dhowells@redhat.com>
  18 .\"             Documentation/security/keys.txt
  19 .\" FIXME Document KEYCTL_INVALIDATE (new in 3.5)
  20 .\"             commit fd75815f727f157a05f4c96b5294a4617c0557da
  21 .\"             Author: David Howells <dhowells@redhat.com>
  22 .\"             Documentation/security/keys.txt
  23 .\" FIXME Document KEYCTL_GET_PERSISTENT (new in 3.13)
  24 .\"             commit f36f8c75ae2e7d4da34f4c908cebdb4aa42c977e
  25 .\"             Author: David Howells <dhowells@redhat.com>
  26 .\"
  27 .\"*******************************************************************
  28 .\"
  29 .\" This file was generated with po4a. Translate the source file.
  30 .\"
  31 .\"*******************************************************************
  32 .TH KEYCTL 2 2014\-01\-22 Linux "Linux Key Management Calls"
  33 .SH 名前
  34 keyctl \- カーネルの鍵管理機能を操作する
  35 .SH 書式
  36 .nf
  37 \fB#include <keyutils.h>\fP
  38 .sp
  39 \fBlong keyctl(int \fP\fIcmd\fP\fB, ...);\fP
  40 .fi
  41 .SH 説明
  42 \fBkeyctl\fP()  has a number of functions available:
  43 .TP
  44 \fBKEYCTL_GET_KEYRING_ID\fP
  45 鍵リングの ID を取得する。
  46 .TP
  47 \fBKEYCTL_JOIN_SESSION_KEYRING\fP
  48 Join or start named session keyring.
  49 .TP
  50 \fBKEYCTL_UPDATE\fP
  51 鍵を更新する。
  52 .TP
  53 \fBKEYCTL_REVOKE\fP
  54 鍵を廃止する。
  55 .TP
  56 \fBKEYCTL_CHOWN\fP
  57 鍵の所有者を設定する。
  58 .TP
  59 \fBKEYCTL_SETPERM\fP
  60 鍵のアクセス許可を設定する。
  61 .TP
  62 \fBKEYCTL_DESCRIBE\fP
  63 Describe a key.
  64 .TP
  65 \fBKEYCTL_CLEAR\fP
  66 鍵リングの内容をクリアする。
  67 .TP
  68 \fBKEYCTL_LINK\fP
  69 鍵を鍵リングに結びつける。
  70 .TP
  71 \fBKEYCTL_UNLINK\fP
  72 鍵の鍵リングへの結びつけを取り消す。
  73 .TP
  74 \fBKEYCTL_SEARCH\fP
  75 鍵リングから鍵を検索する。
  76 .TP
  77 \fBKEYCTL_READ\fP
  78 鍵や鍵リングの内容を読み出す。
  79 .TP
  80 \fBKEYCTL_INSTANTIATE\fP
  81 Instantiate a partially constructed key.
  82 .TP
  83 \fBKEYCTL_NEGATE\fP
  84 Negate a partially constructed key.
  85 .TP
  86 \fBKEYCTL_SET_REQKEY_KEYRING\fP
  87 Set default request\-key keyring.
  88 .TP
  89 \fBKEYCTL_SET_TIMEOUT\fP
  90 鍵にタイムアウトを設定する。
  91 .TP
  92 \fBKEYCTL_ASSUME_AUTHORITY\fP
  93 Assume authority to instantiate key.
  94 .P
  95 These are wrapped by \fBlibkeyutils\fP into individual functions to permit
  96 compiler the compiler to check types.  See the \fBSee Also\fP section at the
  97 bottom.
  98 .SH 返り値
  99 成功すると \fBkeyctl\fP() は見つかった鍵のシリアル番号を返す。 エラーの場合、 値 \-1 が返され、 \fIerrno\fP
 100 にエラーを示す値が設定される。
 101 .SH エラー
 102 .TP
 103 \fBEACCES\fP
 104 鍵の操作が許可されていなかった。
 105 .TP
 106 \fBEDQUOT\fP
 107 鍵を作成するか、 鍵を鍵リングに結びつけると、 呼び出し元ユーザーの鍵のクォータを超過してしまう。
 108 .TP
 109 \fBEKEYEXPIRED\fP
 110 期限切れの鍵が見つかったか指定された。
 111 .TP
 112 \fBEKEYREJECTED\fP
 113 除外 (rejected) された鍵が見つかったか指定された。
 114 .TP
 115 \fBEKEYREVOKED\fP
 116 廃止された鍵が見つかったか指定された。
 117 .TP
 118 \fBENOKEY\fP
 119 一致する鍵が見つからなかったか、 無効な鍵が指定された。
 120 .SH LINKING
 121 これは Linux のシステムコールだが、 \fIlibc\fP には存在せず、 代わりに \fIlibkeyutils\fP に存在する。 リンクする際には、
 122 リンカーに \fB\-lkeyutils\fP を指定する必要がある。
 123 .SH 関連項目
 124 .ad l
 125 .nh
 126 \fBkeyctl\fP(1), \fBadd_key\fP(2), \fBrequest_key\fP(2), \fBkeyctl_set_timeout\fP(3),
 127 \fBkeyctl_chown\fP(3), \fBkeyctl_clear\fP(3), \fBkeyctl_describe\fP(3),
 128 \fBkeyctl_describe_alloc\fP(3), \fBkeyctl_get_keyring_ID\fP(3),
 129 \fBkeyctl_instantiate\fP(3), \fBkeyctl_join_session_keyring\fP(3),
 130 \fBkeyctl_link\fP(3), \fBkeyctl_negate\fP(3), \fBkeyctl_revoke\fP(3),
 131 \fBkeyctl_search\fP(3), \fBkeyctl_setperm\fP(3), \fBkeyctl_set_reqkey_keyring\fP(3),
 132 \fBkeyctl_set_timeout\fP(3), \fBkeyctl_read\fP(3), \fBkeyctl_read_alloc\fP(3),
 133 \fBkeyctl_unlink\fP(3), \fBkeyctl_update\fP(3), \fBrequest\-key\fP(8)
 134
 135 カーネルのソースファイル \fIDocumentation/security/keys.txt\fP
 136 .SH この文書について
 137 この man ページは Linux \fIman\-pages\fP プロジェクトのリリース 3.79 の一部
 138 である。プロジェクトの説明とバグ報告に関する情報は
 139 http://www.kernel.org/doc/man\-pages/ に書かれている。