ssh/auth.c: Rename some procedures

* ssh/auth.c (guile_ssh_userauth_pubkey): Rename to
  `guile_ssh_userauth_public_key_x'.  All callers updated.
  (guile_ssh_userauth_pubkey_auto_x): Rename to
  `guile_ssh_userauth_public_key_auto_x'.  All callers updated.
  (guile_ssh_userauth_password): Rename to
  `guile_ssh_userauth_password_x'.  All callers updated.
  (guile_ssh_userauth_public_key_try): New procedure.
* ssh/auth.h, ssh/auth.scm: Update.
* examples/echo/client.scm.in (main): Update.
* examples/sssh.scm.in (main): Update.
* tests/client-server.scm ("userauth-pubkey!, success"): Rename to
  "userauth-public-key!, success".  Update.
* doc/api-auth.texi (Auth): Update.  Add description of
  `userauth-public-key/try' and `userauth-agent!' procedures.
* NEWS: Update.

1 files changed, 46 insertions, 3 deletions

diff --git a/doc/api-auth.texi b/doc/api-auth.texi
index 459543e..9ad8f24 100644
--- a/doc/api-auth.texi
+++ b/doc/api-auth.texi
@@ -15,8 +15,8 @@ Please note that you must specify a username either on creation of a
 session or by @code{session-set!} call (@pxref{Sessions}) before
 calling of procedures from this section.
 
-@deffn {Scheme Procedure} userauth-pubkey! session public-key private-key
-Try to authenticate with a @var{public-key}.
+@deffn {Scheme Procedure} userauth-public-key! session private-key
+Try to authenticate with a public/private key.
 
 Return one of the following symbols:
 
@@ -34,7 +34,7 @@ A serious error happened.
 
 @end deffn
 
-@deffn {Scheme Procedure} userauth-autopubkey! session
+@deffn {Scheme Procedure} userauth-public-key/auto! session
 @cindex authentication with a SSH agent
 Try to automatically authenticate with @code{none} method first and
 then with public keys.  The procedure will try to get a cached private
@@ -58,6 +58,49 @@ A serious error happened.
 
 @end deffn
 
+@deffn {Scheme Procedure} userauth-public-key/try session public-key
+Try to authenticate with the given @var{public-key}.
+
+To avoid unnecessary processing and user interaction, the following
+method is provided for querying whether authentication using the
+@var{public-key} would be possible.
+
+Return one of the following symbols:
+
+@table @samp
+@item success
+The public key is accepted, you want now to use
+@code{userauth-public-key!}.
+@item partial
+You've been partially authenticated, you still have to use another
+method.
+@item denied
+Authentication failed: use another method.
+@item error
+A serious error happened.
+@end table
+
+@end deffn
+
+@deffn {Scheme Procedure} userauth-agent! session
+Try to do public key authentication with ssh agent.
+
+Return one of the following symbols:
+
+@table @samp
+@item success
+Authentication success.
+@item partial
+You've been partially authenticated, you still have to use another
+method.
+@item denied
+Authentication failed: use another method.
+@item error
+A serious error happened.
+@end table
+
+@end deffn
+
 @deffn {Scheme Procedure} userauth-password! session password
 Try to authenticate by @var{password}.