rpk -- Retrieve Public Key

WHAT IS THIS?
=============

This is a retrieve public key tool from openpksd.org site.

When you wanted to get public keys by e-mail address, you had to use
web browser because OpenPKSD was not supported to retrieve public key
by userID.

OpenPKSD behaver is a little bit different from traditional public
keyserver because the first priority of OpenPKSD is performance.
Performance depends on database key indexing configuration and its
design. So, OpenPKSD prevents a sort of "verbatim grep from userID" or
"retrieve all match keys".

OpenPKSD supports to make keyID list by email address that is included
in userID. It can be seen by Web browser via http (port 80).  User can
select target keyID and can retrieve it by link anchor.

You can't get a public key(s) from OpenPKSD using e-mail address by
only one action.  Thus, I wrote a this program for retrieving by
e-mail address.

Only one e-mail address can be specified. If e-mail address matched
multiple public keys, all public keys are retrieved and concatenated.
It will be as like "cat key1.asc key2.asc ....".

USAGE
======

Usage: rpk [option] e-mail@address or KeyID

Example: 

% ruby rpk.rb openpksd@openpksd.org

% rpk openpksd@openpksd.org 

% rpk 0x67B56DC1

% rpk -o=key.asc openpksd@openpksd.org

% rpk --keyserver=openpksd.org openpksd@openpksd.org

% rpk openpksd@openpksd.org  | gpg -v 

 Show the list of signature by public key that you have.


---

INSTALL
========

$ ./configure 
checking for ruby... /usr/local/bin/ruby
configure: creating ./config.status
config.status: creating Makefile
config.status: creating install.sh
$ sudo make install
Version: 2.0
install rpk /usr/local/bin
install rpk.rb /usr/local/lib/ruby/site_ruby/1.8
$

Note:

File "rpk" is a command for user.  File "rpk.rb" is a class library of
RetrievePublicKey for Ruby developer.

For Mew Users
==============

Mew is a user interface for text messages under Emacs. Mew can get a
PGP public key from keyserver.  But OpenPKSD is not exactly behavior
of pksd that is Marc Horowitz version keyserver and traditional
one. So, Mew can't use OpenPKSD.

Now, rpk has --mew option and you can use rpk as mew-pro-pgpkey.

Example: .emacs 
---
(load "mew")
(setq mew-prog-pgpkey      "rpk")
(setq mew-prog-pgpkey-args '("--mew"))
---



COPYING
=======

 Copyright (C) 2004 Hironobu SUZUKI
     
 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 any later version.
     
 This program is distributed in the hope that it will be useful,
 but WITHOUT ANY WARRANTY; without even the implied warranty of
 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 GNU General Public License for more details.
    
 You should have received a copy of the GNU General Public License
 along with this program; if not, write to the Free Software
 Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
---

More info: http://openpksd.org
Hironobu SUZUKI  < hironobu @ h2np . net >

$Id: 00README,v 1.8 2004/04/06 05:10:22 hironobu Exp $