release/man3/key_setsecret.3

   1 .\"  Copyright 2002 walter harms (walter.harms@informatik.uni-oldenburg.de)
   2 .\"  Distributed under GPL
   3 .\"  I had no way the check the functions out
   4 .\"  be careful
   5 .\"
   6 .\" Japanese Version Copyright (c) 2003 Akihiro MOTOKI all rights reserved.
   7 .\" Translated Mon Jan 27 2003 by Akihiro MOTOKI <amotoki@dd.iij4u.or.jp>
   8 .\"
   9 .\"WORD:        authentication  認証
  10 .\"WORD:        asymmetric      非対称鍵(暗号)
  11 .\"WORD:        symmetric       対称鍵(暗号)
  12 .\"
  13 .TH KEY_SETSECRET 3 2002-07-18 "" "Linux Programmer's Manual"
  14 .SH 名前
  15 key_decryptsession, key_encryptsession, key_setsecret, key_gendes,
  16 key_secretkey_is_set \- rpc 鍵サーバ・デーモンとのインタフェース
  17 .SH 書式
  18 .B "#include <rpc/rpc.h>"
  19 .sp
  20 .BI "int key_decryptsession(const char *" remotename ,
  21 .BI "des_block *" deskey );
  22 .sp
  23 .BI "int key_encryptsession(const char *" remotename ,
  24 .BI "des_block *" deskey );
  25 .sp
  26 .BI "int key_gendes(des_block *" deskey );
  27 .sp
  28 .BI "int key_setsecret(const char *" key );
  29 .sp
  30 .B "int key_secretkey_is_set(void);"
  31 .SH 説明
  32 これらの関数は RPC の安全な認証機構 (AUTH_DES) で使用される。
  33 ユーザ・プログラムでこれらの関数を使用する必要はない。
  34
  35 関数
  36 .BR key_decryptsession ()
  37 は(リモート)サーバのネット名を用いて、復号用の DES 鍵を取得する。
  38 サーバの公開鍵と、呼び出し元プロセスの実効 UID に対応する秘密鍵が使用される。
  39
  40 関数
  41 .BR key_encryptsession ()
  42 は
  43 .BR key_decryptsession ()
  44 の逆の処理を行う。
  45 サーバの公開鍵と、呼び出し元プロセスの実効 UID に対応する秘密鍵で
  46 DES 鍵を暗号する。
  47
  48 関数
  49 .BR key_gendes ()
  50 は、鍵サーバに安全な通信を行うための鍵を要求するために使用される。
  51
  52 関数
  53 .BR key_setsecret ()
  54 は、呼び出し元プロセスの実効 UID に対して鍵を設定するために使用される。
  55
  56 関数
  57 .BR key_secretkey_is_set ()
  58 は、呼び出し元プロセスの実効 UID に対して鍵が設定されているかどうかを
  59 調べるために使用される。
  60 .SH 返り値
  61 これらの関数は成功した場合 1 を、失敗した場合 0 を返す。
  62 .SH 注意
  63 ここでは 2 種類の暗号方式が登場することに注意すること。
  64 一つは公開鍵と秘密鍵を使用する非対称鍵暗号であり、
  65 もう一つは対称鍵暗号である 64 ビット DES である。
  66 .PP
  67 これらの関数は Linux/Doors-project の成果の一部だったが、
  68 現在までに該当箇所はすべて破棄された。
  69 .SH 関連項目
  70 .BR crypt (3)