draft/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 .\"O .SH NAME
  15 .SH 名前
  16 .\"O key_decryptsession, key_encryptsession, key_setsecret, key_gendes,
  17 .\"O key_secretkey_is_set \- interfaces to rpc keyserver daemon
  18 key_decryptsession, key_encryptsession, key_setsecret, key_gendes,
  19 key_secretkey_is_set \- rpc 鍵サーバ・デーモンとのインタフェース
  20 .\"O .SH SYNOPSIS
  21 .SH 書式
  22 .B "#include <rpc/rpc.h>"
  23 .sp
  24 .BI "int key_decryptsession(const char *" remotename ,
  25 .BI "des_block *" deskey );
  26 .sp
  27 .BI "int key_encryptsession(const char *" remotename ,
  28 .BI "des_block *" deskey );
  29 .sp
  30 .BI "int key_gendes(des_block *" deskey );
  31 .sp
  32 .BI "int key_setsecret(const char *" key );
  33 .sp
  34 .B "int key_secretkey_is_set(void);"
  35 .\"O .SH DESCRIPTION
  36 .SH 説明
  37 .\"O The functions here are used within the RPC's secure authentication
  38 .\"O mechanism (AUTH_DES).
  39 .\"O There should be no need for user programs to
  40 .\"O use this functions.
  41 これらの関数は RPC の安全な認証機構 (AUTH_DES) で使用される。
  42 ユーザ・プログラムでこれらの関数を使用する必要はない。
  43
  44 .\"O The function
  45 .\"O .BR key_decryptsession ()
  46 .\"O uses the (remote) server netname and takes the DES key
  47 .\"O for decrypting.
  48 .\"O It uses the public key of the server and the
  49 .\"O secret key associated with the effective UID of the calling process.
  50 関数
  51 .BR key_decryptsession ()
  52 は(リモート)サーバのネット名を用いて、復号用の DES 鍵を取得する。
  53 サーバの公開鍵と、呼び出し元プロセスの実効 UID に対応する秘密鍵が使用される。
  54
  55 .\"O The function
  56 .\"O .BR key_encryptsession ()
  57 .\"O is the inverse of
  58 .\"O .BR key_decryptsession ().
  59 .\"O It encrypts the DES keys with the public key of the server and
  60 .\"O the secret key associated with the effective UID of the calling process.
  61 関数
  62 .BR key_encryptsession ()
  63 は
  64 .BR key_decryptsession ()
  65 の逆の処理を行う。
  66 サーバの公開鍵と、呼び出し元プロセスの実効 UID に対応する秘密鍵で
  67 DES 鍵を暗号する。
  68
  69 .\"O The function
  70 .\"O .BR key_gendes ()
  71 .\"O is used to ask the keyserver for a secure conversation key.
  72 関数
  73 .BR key_gendes ()
  74 は、鍵サーバに安全な通信を行うための鍵を要求するために使用される。
  75
  76 .\"O The function
  77 .\"O .BR key_setsecret ()
  78 .\"O is used to set the key for the effective UID of the calling process.
  79 関数
  80 .BR key_setsecret ()
  81 は、呼び出し元プロセスの実効 UID に対して鍵を設定するために使用される。
  82
  83 .\"O The function
  84 .\"O .BR key_secretkey_is_set ()
  85 .\"O can be used to determine whether a key has been
  86 .\"O set for the effective UID of the calling process.
  87 関数
  88 .BR key_secretkey_is_set ()
  89 は、呼び出し元プロセスの実効 UID に対して鍵が設定されているかどうかを
  90 調べるために使用される。
  91 .\"O .SH "RETURN VALUE"
  92 .SH 返り値
  93 .\"O These functions return 1 on success and 0 on failure.
  94 これらの関数は成功した場合 1 を、失敗した場合 0 を返す。
  95 .\"O .SH NOTES
  96 .SH 注意
  97 .\"O Note that we talk about two types of encryption here.
  98 .\"O One is asymmetric using a public and secret key.
  99 .\"O The other is symmetric, the
 100 .\"O 64-bit DES.
 101 ここでは 2 種類の暗号方式が登場することに注意すること。
 102 一つは公開鍵と秘密鍵を使用する非対称鍵暗号であり、
 103 もう一つは対称鍵暗号である 64 ビット DES である。
 104 .PP
 105 .\"O These routines were part of the Linux/Doors-project, abandoned by now.
 106 これらの関数は Linux/Doors-project の成果の一部だったが、
 107 現在までに該当箇所はすべて破棄された。
 108 .\"O .SH "SEE ALSO"
 109 .SH 関連項目
 110 .BR crypt (3)