ssh2_publickey_add(3) [php man page]

SSH2_PUBLICKEY_ADD(3)							 1						     SSH2_PUBLICKEY_ADD(3)

ssh2_publickey_add - Add an authorized publickey

SYNOPSIS

       bool ssh2_publickey_add (resource  $pkey, string  $algoname, string  $blob, [bool  $overwrite = false], [array  $attributes])

DESCRIPTION

       Note

	      The  public key subsystem is used for managing public keys on a server to which the client is already authenticated. To authenticate
	      to a remote system using public key authentication, use the ssh2_auth_pubkey_file(3) function instead.

PARAMETERS

	      o $pkey
		- Publickey Subsystem resource created by ssh2_publickey_init(3).

	      o $algoname
		- Publickey algorithm (e.g.): ssh-dss, ssh-rsa

	      o $blob
		- Publickey blob as raw binary data

	      o $overwrite
		- If the specified key already exists, should it be overwritten?

	      o $attributes
		- Associative array of attributes to assign to this public key. Refer to ietf-secsh-publickey-subsystem for a  list  of  supported
		attributes.  To mark an attribute as mandatory, precede its name with an asterisk. If the server is unable to support an attribute
		marked mandatory, it will abort the add process.

RETURN VALUES

	Returns TRUE on success or FALSE on failure.

EXAMPLES

       Example #1

	      Adding a publickey with ssh2_publickey_add(3)

	      <?php
	      $ssh2 = ssh2_connect('shell.example.com', 22);
	      ssh2_auth_password($ssh2, 'jdoe', 'password');
	      $pkey = ssh2_publickey_init($ssh2);

	      $keyblob = base64_decode('
	      AAAAB3NzaC1yc2EAAAABIwAAAIEA5HVt6VqSGd5PTrLRdjNONxXH1tVFGn0
	      Bd26BF0aCP9qyJRlvdJ3j4WBeX4ZmrveGrjMgkseSYc4xZ26sDHwfL351xj
	      zaLpipuBGRrw17mWVBhuCExo476ri5tQFzbTc54VEHYckxQ16CjSTibI5X
	      69GmnYC9PNqEYq/1TP+HF10=');

	      ssh2_publickey_add($pkey, 'ssh-rsa', $keyblob, false, array('comment'=>"John's Key"));
	      ?>

SEE ALSO

       ssh2_publickey_init(3), ssh2_publickey_remove(3), ssh2_publickey_list(3).

PHP Documentation Group 												     SSH2_PUBLICKEY_ADD(3)

EVP_PKEY_cmp(3) 						      OpenSSL							   EVP_PKEY_cmp(3)

NAME

       EVP_PKEY_copy_parameters, EVP_PKEY_missing_parameters, EVP_PKEY_cmp_parameters, EVP_PKEY_cmp - public key parameter and comparison
       functions

SYNOPSIS

	#include <openssl/evp.h>

	int EVP_PKEY_missing_parameters(const EVP_PKEY *pkey);
	int EVP_PKEY_copy_parameters(EVP_PKEY *to, const EVP_PKEY *from);

	int EVP_PKEY_cmp_parameters(const EVP_PKEY *a, const EVP_PKEY *b);
	int EVP_PKEY_cmp(const EVP_PKEY *a, const EVP_PKEY *b);

DESCRIPTION

       The function EVP_PKEY_missing_parameters() returns 1 if the public key parameters of pkey are missing and 0 if they are present or the
       algorithm doesn't use parameters.

       The function EVP_PKEY_copy_parameters() copies the parameters from key from to key to.

       The funcion EVP_PKEY_cmp_parameters() compares the parameters of keys a and b.

       The funcion EVP_PKEY_cmp() compares the public key components and paramters (if present) of keys a and b.

NOTES

       The main purpose of the functions EVP_PKEY_missing_parameters() and EVP_PKEY_copy_parameters() is to handle public keys in certificates
       where the parameters are sometimes omitted from a public key if they are inherited from the CA that signed it.

       Since OpenSSL private keys contain public key components too the function EVP_PKEY_cmp() can also be used to determine if a private key
       matches a public key.

RETURN VALUES

       The function EVP_PKEY_missing_parameters() returns 1 if the public key parameters of pkey are missing and 0 if they are present or the
       algorithm doesn't use parameters.

       These functions EVP_PKEY_copy_parameters() returns 1 for success and 0 for failure.

       The function EVP_PKEY_cmp_parameters() and EVP_PKEY_cmp() return 1 if the keys match, 0 if they don't match, -1 if the key types are
       different and -2 if the operation is not supported.

SEE ALSO

       EVP_PKEY_CTX_new(3), EVP_PKEY_keygen(3)

1.0.1e								    2013-02-11							   EVP_PKEY_cmp(3)