[deployment-guide/comm-rel: 28/41] Updated the Using the sftp Utility section.

[dsilas]

commit d564f528025f9e058f2cd1a570a0d88e992c6162
Author: Jaromir Hradilek <jhradile at redhat.com>
Date:   Wed Jul 14 15:39:16 2010 +0200

    Updated the Using the sftp Utility section.

 en-US/OpenSSH.xml |   86 +++++++++++++++++++++++++++++++++++++++++++++++++++--
 1 files changed, 83 insertions(+), 3 deletions(-)
---
diff --git a/en-US/OpenSSH.xml b/en-US/OpenSSH.xml
index 252b593..c314429 100644
--- a/en-US/OpenSSH.xml
+++ b/en-US/OpenSSH.xml
@@ -655,8 +655,8 @@ taglist.vim                                   100%  144KB 144.5KB/s   00:00</scr
 john at penguin.example.com's password:
 .vimrc                                        100% 2233     2.2KB/s   00:00</screen>
     </section>
-    <section id="s2-openssh-using-sftp">
-      <title>Using the <command>sftp</command> Command</title>
+    <section id="s2-ssh-clients-sftp">
+      <title>Using the <command>sftp</command> Utility</title>
       <indexterm>
         <primary>
           <command>sftp</command>
@@ -671,7 +671,87 @@ john at penguin.example.com's password:
         </tertiary>
       </indexterm>
       <para>
-        The <command>sftp</command> utility can be used to open a secure, interactive FTP session. It is similar to <command>ftp</command> except that it uses a secure, encrypted connection. The general syntax is <command>sftp<replaceable> username at hostname.com</replaceable></command>. Once authenticated, you can use a set of commands similar to those used by FTP. Refer to the <command>sftp</command> man page for a list of these commands. To read the man page, execute the command <command>man sftp</command> at a shell prompt. The <command>sftp</command> utility is only available in OpenSSH version 2.5.0p1 and higher.
+        The <command>sftp</command> utility can be used to open a secure, interactive FTP session. In its design, it is similar to <command>ftp</command> except that it uses a secure, encrypted connection.
+      </para>
+      <para>
+        To connect to a remote system, use the command in the following form:
+      </para>
+      <screen><command>sftp <replaceable>username</replaceable>@<replaceable>hostname</replaceable></command></screen>
+      <para>
+        For example, to log in to a remote machine named <systemitem class="domainname">penguin.example.com</systemitem> with <systemitem class="username">john</systemitem> as a username, type:
+      </para>
+      <screen>~]$ <command>sftp john at penguin.example.com</command>
+john at penguin.example.com's password:
+Connected to penguin.example.com.
+sftp></screen>
+      <para>
+        After you enter the correct password, you will be presented with a prompt. The <command>sftp</command> utility accepts a set of commands similar to those used by <command>ftp</command> (see <xref linkend="table-ssh-clients-sftp" />).
+      </para>
+      <table id="table-ssh-clients-sftp">
+        <title>A selection of available <command>sftp</command> commands</title>
+        <tgroup cols="2">
+          <colspec colname="command" colnum="1" colwidth="30*" />
+          <colspec colname="description" colnum="2" colwidth="50*" />
+          <thead>
+            <row>
+              <entry>Command</entry>
+              <entry>Description</entry>
+            </row>
+          </thead>
+          <tbody>
+            <row>
+              <entry>
+                <command>ls</command> [<replaceable>directory</replaceable>]
+              </entry>
+              <entry>
+                List the content of a remote <replaceable>directory</replaceable>. If none is supplied, a current working directory is used by default.
+              </entry>
+            </row>
+            <row>
+              <entry>
+                <command>cd</command> <replaceable>directory</replaceable>
+              </entry>
+              <entry>
+                Change the remote working directory to <replaceable>directory</replaceable>.
+              </entry>
+            </row>
+            <row>
+              <entry>
+                <command>mkdir</command> <replaceable>directory</replaceable>
+              </entry>
+              <entry>
+                Create a remote <replaceable>directory</replaceable>.
+              </entry>
+            </row>
+            <row>
+              <entry>
+                <command>rmdir</command> <replaceable>path</replaceable>
+              </entry>
+              <entry>
+                Remove a remote <replaceable>directory</replaceable>.
+              </entry>
+            </row>
+            <row>
+              <entry>
+                <command>put</command> <replaceable>localfile</replaceable> [<replaceable>remotefile</replaceable>]
+              </entry>
+              <entry>
+                Transfer <replaceable>localfile</replaceable> to a remote machine.
+              </entry>
+            </row>
+            <row>
+              <entry>
+                <command>get</command> <replaceable>remotefile</replaceable> [<replaceable>localfile</replaceable>]
+              </entry>
+              <entry>
+                Transfer <replaceable>remotefile</replaceable> from a remote machine.
+              </entry>
+            </row>
+          </tbody>
+        </tgroup>
+      </table>
+      <para>
+        For a complete list of available commands, refer to the <command>sftp</command> man page.
       </para>
     </section>
   </section>