man page bug in sftp

classic Classic list List threaded Threaded
2 messages Options
Reply | Threaded
Open this post in threaded view
|

man page bug in sftp

John L. Scarfone
It appears that as of version 1.62 of sftp.c password authentication
with the -b option is no longer possible.  Diff against -current of man
page follows.


Index: sftp.1
===================================================================
RCS file: /cvs/src/usr.bin/ssh/sftp.1,v
retrieving revision 1.61
diff -u -r1.61 sftp.1
--- sftp.1 1 Mar 2005 17:19:35 -0000 1.61
+++ sftp.1 24 Dec 2005 14:58:47 -0000
@@ -78,7 +78,7 @@
 The final usage format allows for automated sessions using the
 .Fl b
 option.
-In such cases, it is usually necessary to configure public key authentication
+In such cases, it is necessary to configure public key authentication
 to obviate the need to enter a password at connection time (see
 .Xr sshd 8
 and
@@ -100,7 +100,7 @@
 .Ar batchfile
 instead of
 .Em stdin .
-Since it lacks user interaction it should be used in conjunction with
+Since it lacks user interaction it must be used in conjunction with
 non-interactive authentication.
 A
 .Ar batchfile


--
ajBAY294Lm5ldA==

Reply | Threaded
Open this post in threaded view
|

Re: man page bug in sftp

Jason McIntyre-2
On Sat, Dec 24, 2005 at 10:03:13AM -0500, John L. Scarfone wrote:

> It appears that as of version 1.62 of sftp.c password authentication
> with the -b option is no longer possible.  Diff against -current of man
> page follows.
>
>
> Index: sftp.1
> ===================================================================
> RCS file: /cvs/src/usr.bin/ssh/sftp.1,v
> retrieving revision 1.61
> diff -u -r1.61 sftp.1
> --- sftp.1 1 Mar 2005 17:19:35 -0000 1.61
> +++ sftp.1 24 Dec 2005 14:58:47 -0000
> @@ -78,7 +78,7 @@
>  The final usage format allows for automated sessions using the
>  .Fl b
>  option.
> -In such cases, it is usually necessary to configure public key authentication
> +In such cases, it is necessary to configure public key authentication
>  to obviate the need to enter a password at connection time (see
>  .Xr sshd 8
>  and

i committed this hunk, but also changed "public key" to
"non-interactive" after some feedback from one of the ssh developers,
djm.

> @@ -100,7 +100,7 @@
>  .Ar batchfile
>  instead of
>  .Em stdin .
> -Since it lacks user interaction it should be used in conjunction with
> +Since it lacks user interaction it must be used in conjunction with
>  non-interactive authentication.
>  A
>  .Ar batchfile
>

i did not take this part. it is arguable, but i believe the wording is
correct as is. the only real interpretation of this sentence is that you
have to use non-interactive authentication. additionally i do not think
"must" is a particularly useful structure in technical documents - my
wife gets to scold me, man pages do not ;)

thanks for the mail,
jmc