ssh2_publickey_init(3) [php man page]

SSH2_PUBLICKEY_INIT(3)							 1						    SSH2_PUBLICKEY_INIT(3)

ssh2_publickey_init - Initialize Publickey subsystem

SYNOPSIS

       resource ssh2_publickey_init (resource  $session)

DESCRIPTION

	Request the Publickey subsystem from an already connected SSH2 server.

	The  publickey	subsystem  allows an already connected and authenticated client to manage the list of authorized public keys stored on the
       target server in an implementation agnostic manner. If  the  remote  server  does  not  support	the  publickey	subsystem,  the  ssh2_pub-
       lickey_init(3) function will return FALSE.

PARAMETERS

	      o $session
		-

RETURN VALUES

	Returns an SSH2 Publickey Subsystem resource for use with all other ssh2_publickey_*() methods or FALSE on failure.

NOTES

       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.

SEE ALSO

       ssh2_publickey_add(3), ssh2_publickey_remove(3), ssh2_publickey_list(3).

PHP Documentation Group 												    SSH2_PUBLICKEY_INIT(3)

libssh2_userauth_publickey_fromfile(3)				  libssh2 manual			    libssh2_userauth_publickey_fromfile(3)

NAME

       libssh2_userauth_publickey_fromfile - authenticate a session with a public key, read from a file

SYNOPSIS

       #include <libssh2.h>

       int libssh2_userauth_publickey_fromfile_ex(LIBSSH2_SESSION *session,
						  const char *username,
						  const char *publickey,
						  const char *privatekey,
						  const char *passphrase);

DESCRIPTION

       session - Session instance as returned by libssh2_session_init_ex(3)

       username - Pointer to user name to authenticate as.

       username_len - Length of username.

       publickey  - Path name of the public key file.  (e.g. /etc/ssh/hostkey.pub). If libssh2 is built against OpenSSL, this option can be set to
       NULL.

       privatekey - Path name of the private key file. (e.g. /etc/ssh/hostkey)

       passphrase - Passphrase to use when decoding privatekey.

       Attempt public key authentication using a PEM encoded private key file stored on disk

RETURN VALUE

       Return 0 on success or negative on failure.  It returns LIBSSH2_ERROR_EAGAIN when it would otherwise block. While LIBSSH2_ERROR_EAGAIN is a
       negative number, it isn't really a failure per se.

ERRORS

       LIBSSH2_ERROR_ALLOC -  An internal memory allocation call failed.

       LIBSSH2_ERROR_SOCKET_SEND - Unable to send data on socket.

       LIBSSH2_ERROR_SOCKET_TIMEOUT -

       LIBSSH2_ERROR_PUBLICKEY_UNVERIFIED - The username/public key combination was invalid.

       LIBSSH2_ERROR_AUTHENTICATION_FAILED - Authentication using the supplied public key was not accepted.

SEE ALSO

       libssh2_session_init_ex(3)

libssh2 0.15							    1 Jun 2007				    libssh2_userauth_publickey_fromfile(3)