<!DOCTYPE REFENTRY PUBLIC "-//Sun Microsystems//DTD DocBook V3.0-Based SolBook Subset V2.0//EN" [

<!--ArborText, Inc., 1988-1999, v.4002-->

<!ENTITY envr-tt "ENVIRONMENT VARIABLES">

<!ENTITY cmd "gftp">

<!ENTITY % commonents SYSTEM "smancommon.ent">

%commonents;

<!ENTITY % booktitles SYSTEM "booktitles.ent">

%booktitles;

<!ENTITY suncopy "Copyright (c) 2009, Sun Microsystems, Inc. All Rights Reserved.">

]>

<?Pub UDT _bookmark _target>

<?Pub Inc>

<refentry id="gftp-1">

<refmeta><refentrytitle>&cmd;</refentrytitle><manvolnum>1</manvolnum>

<refmiscinfo class="date">19 Feb 2009</refmiscinfo>

<refmiscinfo class="sectdesc">&man1;</refmiscinfo>

<refmiscinfo class="software">&release;</refmiscinfo>

<refmiscinfo class="arch">generic</refmiscinfo>

<refmiscinfo class="copyright">&suncopy;</refmiscinfo>

</refmeta>

<indexterm><primary>&cmd;</primary></indexterm>

<refnamediv id="gftp-1-name"><refname>&cmd;</refname>

<refpurpose>file transfer client</refpurpose></refnamediv>

<refsynopsisdiv id="gftp-1-synp"><title>&synp-tt;</title>

<cmdsynopsis><command>&cmd;</command>

<arg choice="opt"><option>-help</option></arg>

<arg choice="opt"><option>-info</option></arg>

<arg choice="opt"><option>-version</option></arg>

<arg choice="opt"><option role="nodash"><arg choice="opt"><option role="nodash">proto://</option></arg>

<arg choice="opt"><option role="nodash"> <replaceable>user</replaceable> :<arg choice="opt"><option role="nodash"><replaceable>pass</replaceable></option></arg> @</option></arg> <replaceable>server</replaceable> <arg choice="opt"><option role="nodash">: <replaceable>port</replaceable> </option></arg> <arg choice="opt"><option role="nodash">/ <replaceable>directory</replaceable> </option></arg>

</option></arg>

</cmdsynopsis></refsynopsisdiv>

<refsect1 id="gftp-1-desc"><title>&desc-tt;</title>

<para>

<command>&cmd;</command> is a file transfer client. It currently has a text

interface and a GTK+ 2.x graphical interface. It supports the FTP, FTPS

(control connection only), HTTP, HTTPS, SSH and FSP protocols.

</para>

</refsect1>

<refsect1 id="gftp-1-opts"><title>&opts-tt;</title>

<para>

You may enter a url on the command line that <command>&cmd;</command> will

automatically connect to when it starts up.

</para>

<variablelist termlength="medium">

<varlistentry><term><option>-help, -h</option></term>

<listitem><para>Display program usage.</para>

</listitem></varlistentry>

<varlistentry><term><option>-info</option></term>

<listitem><para>

Display some information about how <command>&cmd;</command> was built. Please

send the output of this command when submitting a bug report.

</para>

</listitem></varlistentry>

<varlistentry><term><option>-version, -v</option></term>

<listitem><para>

Display the current version of <command>&cmd;</command>.

</para>

</listitem></varlistentry>

</variablelist></refsect1>

<refsect1 id="gexif-1-oper"><title>&oper-tt;</title>

<para>The following operands are supported:</para>

<variablelist termlength="narrow">

<varlistentry><term><option role="nodash"><replaceable>proto</replaceable></option></term>

<listitem><para>

This specifies the protocol that should be used. It can currently be one of the

following options: ftp, ftps, http, https, ssh, fsp, local and bookmark. If

omitted, the protocol specified by the default_protocol option will be used.

</para>

</listitem></varlistentry>

<varlistentry><term><option role="nodash"><replaceable>user</replaceable></option></term>

<listitem><para>

The username that will be used to log into the remote server. If omitted, your

current username will be used for most protocols. For the FTP protocol, the

anonymous username will be used.

</para>

</listitem></varlistentry>

<varlistentry><term><option role="nodash"><replaceable>pass</replaceable></option></term>

<listitem><para>

The password that will be used to log into the remote server. If omitted, you

will be prompted for the password. If you are using the FTP protocol, and the

username is anonymous, then your email address will be used as the password.

</para>

</listitem></varlistentry>

<varlistentry><term><option role="nodash"><replaceable>server</replaceable></option></term>

<listitem><para>

The remote server to connect.

</para>

</listitem></varlistentry>

<varlistentry><term><option role="nodash"><replaceable>port</replaceable></option></term>

<listitem><para>

The remote port on the server to connect. If omitted, the default port for the

protocol will be used. The port will be looked up in the services(5) file.

</para>

</listitem></varlistentry>

<varlistentry><term><option role="nodash"><replaceable>directory</replaceable></option></term>

<listitem><para>

The directory to change to once you are connected to the remote server.

</para>

</listitem></varlistentry>

</variablelist></refsect1>

<refsect1 id="gftp-1-file"><title>&file-tt;</title>

<variablelist termlength="wide">

<varlistentry><term><filename>~/.<replaceable>gnome2</replaceable>/<replaceable>gftp</replaceable>/<replaceable>gftprc</replaceable></filename></term><listitem>

<para>

Per user configuration file. Most of these options can be edited inside

<command>&cmd;</command>. This file is also commented very well.

</para>

</listitem></varlistentry>

<varlistentry><term><filename>~/.<replaceable>gnome2</replaceable>/<replaceable>gftp</replaceable>/<replaceable>bookmarks</replaceable></filename></term><listitem>

<para>

Per user bookmarks file.

</para>

</listitem></varlistentry>

</variablelist></refsect1>

<refsect1 id="gftp-1-attr"><title>&attr-tt;</title>

<para>See <olink targetdocent="REFMAN5" localinfo="attributes-5"><citerefentry>

<refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry></olink>

for descriptions of the following attributes:

</para>

<informaltable frame="all">

<tgroup cols="2" colsep="1" rowsep="1"><colspec colname="COLSPEC0" colwidth="1*">

<colspec colname="COLSPEC1" colwidth="1*">

<thead>

<row><entry align="center" valign="middle">ATTRIBUTE TYPE</entry><entry align="center"

valign="middle">ATTRIBUTE VALUE</entry></row>

</thead>

<tbody>

<row>

<entry><para>Availability</para></entry>

<entry><para>SUNWgftp</para></entry>

</row>

<row><entry colname="COLSPEC0"><para>Interface stability</para></entry><entry

colname="COLSPEC1"><para>Volatile</para></entry></row>

</tbody>

</tgroup>

</informaltable>

</refsect1>

<refsect1 id="gftp-1-also"><title>&also-tt;</title>

<para>

<citerefentry><refentrytitle>ftp</refentrytitle><manvolnum>1</manvolnum></citerefentry>,

<citerefentry><refentrytitle>sftp</refentrytitle><manvolnum>1</manvolnum></citerefentry>,

<citerefentry><refentrytitle>attributes</refentrytitle><manvolnum>5</manvolnum></citerefentry>

</para>

<para>

For more information about <command>&cmd;</command>, please refer to

<literal>http://www.gftp.org/</literal>.

</para>

<para>

If you find any bugs in <command>&cmd;</command>, please report them to GNOME's

Bugzilla at <literal>http://bugzilla.gnome.org/</literal>.</para>

</refsect1>

<refsect1 id="gftp-1-note"><title>&note-tt;</title>

<para>Written by Alfred Peng, Sun Microsystems Inc., 2009. </para>

</refsect1>

</refentry>