===================================================================
RCS file: /cvsrepo/anoncvs/cvs/src/usr.bin/ssh/sftp.1,v
retrieving revision 1.7.2.2
retrieving revision 1.7.2.3
diff -u -r1.7.2.2 -r1.7.2.3
--- src/usr.bin/ssh/sftp.1	2001/02/19 17:19:25	1.7.2.2
+++ src/usr.bin/ssh/sftp.1	2001/03/21 19:46:29	1.7.2.3
@@ -1,6 +1,6 @@
-.\" $OpenBSD: sftp.1,v 1.7.2.2 2001/02/19 17:19:25 jason Exp $
+.\" $OpenBSD: sftp.1,v 1.7.2.3 2001/03/21 19:46:29 jason Exp $
 .\"
-.\" Copyright (c) 2001 Damien Miller. All rights reserved.
+.\" Copyright (c) 2001 Damien Miller.  All rights reserved.
 .\"
 .\" Redistribution and use in source and binary forms, with or without
 .\" modification, are permitted provided that the following conditions
@@ -31,6 +31,7 @@
 .Sh SYNOPSIS
 .Nm sftp
 .Op Fl vC
+.Op Fl b Ar batchfile
 .Op Fl o Ar ssh_option
 .Op Ar hostname | user@hostname
 .Sh DESCRIPTION
@@ -49,8 +50,19 @@
 .Pp
 The options are as follows:
 .Bl -tag -width Ds
-.It Fl v
-Raise logging level. This option is also passed to ssh.
+.It Fl b Ar batchfile
+Batch mode reads a series of commands from an input
+.Ar batchfile
+instead of
+.Em stdin .
+Since it lacks user interaction it should be used in conjunction with
+non-interactive authentication.
+.Nm
+will abort if any of the following 
+commands fail: 
+.Ic get , put , rename , ln , rm , mkdir , chdir , lchdir
+and
+.Ic lmkdir .
 .It Fl C
 Enables compression (via ssh's 
 .Fl C
@@ -58,6 +70,8 @@
 .It Fl o Ar ssh_option
 Specify an option to be directly passed to
 .Xr ssh 1 .
+.It Fl v
+Raise logging level. This option is also passed to ssh.
 .El
 .Sh INTERACTIVE COMMANDS
 Once in interactive mode,
@@ -92,8 +106,8 @@
 .Ar own .
 .Ar own
 must be a numeric UID.
-.It Ic help
-Display help text.
+.It Ic exit
+Quit sftp.
 .It Xo Ic get
 .Op Ar flags
 .Ar remote-path
@@ -108,6 +122,8 @@
 .Fl P
 flag is specified, then the file's full permission and access time are
 copied too.
+.It Ic help
+Display help text.
 .It Ic lls Op Ar ls-options Op Ar path
 Display local directory listing of either 
 .Ar path
@@ -117,6 +133,11 @@
 .It Ic lmkdir Ar path
 Create local directory specified by
 .Ar path .
+.It Ic ln Ar oldpath Ar newpath
+Create a symbolic link from 
+.Ar oldpath
+to
+.Ar newpath .
 .It Ic lpwd
 Print local working directory.
 .It Ic ls Op Ar path
@@ -138,15 +159,13 @@
 .Xc
 Upload
 .Ar local-path
-and store it on the remote machine. If the remote path name is not specified, 
-it is given the same name it has on the local machine. If the 
+and store it on the remote machine. If the remote path name is not 
+specified, it is given the same name it has on the local machine. If the 
 .Fl P
 flag is specified, then the file's full permission and access time are
 copied too.
 .It Ic pwd
 Display remote working directory.
-.It Ic exit
-Quit sftp.
 .It Ic quit
 Quit sftp.
 .It Ic rename Ar oldpath Ar newpath
@@ -160,6 +179,11 @@
 .It Ic rm Ar path
 Delete remote file specified by
 .Ar path .
+.It Ic symlink Ar oldpath Ar newpath
+Create a symbolic link from 
+.Ar oldpath
+to
+.Ar newpath .
 .It Ic ! Ar command
 Execute 
 .Ar command
@@ -173,6 +197,7 @@
 Damien Miller <djm@mindrot.org>
 .Sh SEE ALSO
 .Xr ssh 1 ,
+.Xr sftp-server 8 ,
 .Xr ssh-add 1 ,
 .Xr ssh-keygen 1 ,
 .Xr sshd 8 ,