pssh-keygen generates and manages SSH authentication keys.
pssh-keygen is part of the Net::SSH::Perl suite; it could be used as a replacement for ssh-keygen,
but is provided more in the spirit of an example of the Net::SSH::Perl key management libraries.

pssh-keygen defaults to generating/managing an RSA key for use by protocols 1.3 and 1.5; specifying the -t option allows you to create/manage a key for use by the SSH2 protocol.

Without any options--in other words,
in the first command example in the SYNOPSIS--pssh-keygen generates a new key,
then prompts the user for a filename where that key will be saved.
The user is also prompted for a passphrase to encrypt the private key file.
These prompts can be overriden by providing the values as command line options.

With any of the other options--ie.
any of the other command examples in the SYNOPSIS--an existing keyfile will be "managed" in some way: users can change the passphrases,
convert to SSH2-format key files,
display key fingerprints,
etc.

Requests changing the comment in the private and public key files.
The program will prompt for the file containing the private keys,
for passphrase if the key has one,
and for the new comment.
Each of these prompts can be overriden be the appropriate command line option.

Requests changing the passphrase of a private key file instead of generating a new private key.
The program will prompt for the file containing the private key,
for the old passphrase,
and twice for the new passphrase (each of these prompts can be overridden by command line options).

Specifies the type of the key to create/manage.
The possible values are 'rsa1' for protocol version 1,
'dsa' for protocol version 2 DSA files,
and 'rsa' for protocol version 2 RSA files.
The default is 'rsa1'.