USERS-GUIDE
上传用户:tjfeida
上传日期:2013-03-10
资源大小:1917k
文件大小:58k
源码类别:

Ftp客户端

开发平台:

Visual C++

  1.                                gFTP Users Guide
  2. version 2.0.13 (06/10/2002)
  3. Copyright (C) 1998-2002 Brian Masney <masneyb@gftp.org>
  4.    gFTP is a multiprotocol file transfer program for both X Window and the
  5. console.  Some of the gFTP features are:
  6.     * Downloading files
  7.     * Uploading files
  8.     * Transfering files between 2 remote servers
  9.     * Downloading multiple files in one run
  10.     * Downloading entire directories and subdirectories
  11.     * Simultaneous downloads using multithreading
  12.     * Supports resuming interrupted file transfers
  13.     * Bookmarks menu to allow you to quickly connect to remote sites
  14.     * FTP and HTTP proxy host support
  15.     * Supports the FTP, FXP, HTTP and SSH protocols
  16.     * Supports both passive and non-passive file transfers
  17.     * Supports UNIX, EPLF, Novell, MacOS, and NT (DOS) style directory listings
  18.     * Fully Internationalized. gFTP is currently available in Bulgarian (bg),
  19.       Chinese (zh_TW.Big5, zh_CN.GB2312), Czech (cs), Danish (da), Dutch (nl),
  20.       Finnish (fi), French (fr), German (de), Italian (it), Korean (ko),
  21.       Japanese (ja), Norwegian (no), Polish (pl), Portuguese (pt_BR, br),
  22.       Russian (ru), Spanish (es), Swedish (sv) and Turkish (tr)
  23.    gFTP is distributed under the terms of the GNU General Public License.  You
  24. can read the GPL by clicking on Help->About->License Agreement.
  25.    This document is a tutorial on how to use gFTP and describes some of its
  26. functionality.  I welcome any changes or additions to this document to make it
  27. better, and easier to read.
  28.                                     CONTENTS
  29. 1. Connecting to a remote site
  30.    1.1. Connecting using the Open URL button
  31.    1.2. Connecting using bookmarks
  32.    1.3. Connecting using the toolbar
  33.    1.4. Connecting using command line parameters
  34. 2. Downloading files
  35.    2.1. Traversing remote directory trees
  36.    2.2. Downloading a single file
  37.    2.3. Downloading multiple files
  38.    2.4. Downloading from multiple sites
  39.    2.5. Simultaneous downloads from multiple sites
  40.    2.6. Differences between downloading in ASCII and BINARY mode
  41. 3. Uploading files
  42.    3.1. Selecting the remote directory
  43.    3.2. Working with the remote file tree
  44.    3.3. Uploading a single file
  45.    3.4. Uploading multiple files
  46.    3.5. Passive and non passive file transfers
  47. 4. Transfering files between remote sites (FXP)
  48.    4.1. Connecting to the receiving site
  49.    4.2. Selecting the receiving directory
  50.    4.3. Working with the receiving file tree
  51.    4.4. Connecting to the sending site
  52.    4.5. Traversing the sending site directory tree
  53.    4.6. Selecting files from the sending site
  54. 5. Resuming transfers
  55.    5.1. Manual resumes
  56.    5.2. Automatic resumes
  57. 6. FTP password and user id
  58.    6.1. Anonymous FTP
  59.    6.2. Secure FTP password and user id
  60.    6.3. FTP security concerns
  61. 7. Local directory
  62.    7.1. Specifying the local directory
  63.    7.2. Working in the local directory
  64.    7.3. Formating the local directory window
  65. 8. Remote directory
  66.    8.1. Specifying the remote directory
  67.    8.2. Formating the remote directory window
  68. 9. Transfer window
  69.    9.1. Queue
  70.    9.2. Progress
  71.    9.3. Formating the transfer window
  72. 10. Log and log window
  73.    10.1. Log commands
  74.    10.2. Formating the log window
  75. 11. Bookmarks
  76.    11.1. Using a bookmark entry
  77.    11.2. Adding a bookmark
  78.    11.3. Editing bookmarks
  79.    11.4. Bookmark passwords
  80.    11.5. Bookmark security concerns
  81. 12. FTP protocol
  82.    12.1 Invoking FTP
  83. 13. HTTP protocol
  84.    13.1. Invoking HTTP
  85. 14. SSH protocol
  86.    14.1. Configuring SSH
  87.    14.2. Invoking SSH
  88.    14.3. SSH and SSH2
  89.    14.4 Invoking SSH
  90. 15. Miscellaneous commands
  91.    15.1. Window
  92.    15.2. SITE commands
  93.    15.3. Bidirectional transfers
  94.    15.4. Clear cache
  95.    15.5. Compare Windows
  96.    15.6. Disconnect
  97. 16. Using gftp-text (the command line version of gFTP)
  98.    16.1. Downloading entire directories and subdirectories
  99.    16.2. Documentation for gftp-text
  100. 17. Using gftp-gtk (the GUI version of gFTP)
  101. 18. Configuring gFTP
  102.    18.1. Proxy host setup
  103.    18.2. Proxy security concerns
  104.    18.3. Configuring file extensions
  105.    18.4. Desktop icon
  106. 19. Staying in touch
  107.    19.1. gFTP bugs
  108.    19.2. gFTP mailing list
  109.    19.3. gFTP home page and FAQ
  110. 20. Legal section
  111.    20.1. Copying gFTP
  112.    20.2. Warrenty
  113.    20.3. Source code
  114. 1. Connecting to a remote site
  115. This section describes the various ways that you can connect to a remote
  116. site using gFTP.
  117. 1.1. Connecting using the Open URL button
  118.    On the top line of gFTP you will see the word "Remote".  Click on Remote
  119. and you will get a pop down menu.  Click on "Open URL" and you will get a
  120. command line which has several uses.  You can enter a URL name in this
  121. command line in a manner very similar to the way it works in most web
  122. browsers.  You can type in the URL, paste the URL from the clipboard, or Drag
  123. and Drop a URL from another application (say Mozilla).  gFTP will automatically
  124. disconnect from the site that you are connected to, if any, and connect to the
  125. site you specified in the Open URL window.
  126. When you click on the Open URL button, several things are checked
  127. (in the following order):
  128.         - If you are already connected to a site and you click the Open URL
  129.           button, you will be disconnected from the site that you are
  130.           connected to.
  131.         - If you have a hostname entered on the toolbar, it will connect to
  132.           that host.
  133.         - If the above 2 conditions are false, then it will bring up the
  134.           Open URL dialog window where you can enter a FTP URL to connect to.
  135.           FTP URL's can look like some of the following:
  136.           ftp://ftp.myhostname.com/pub (this will log in as anonymous)
  137.           ftp://user@ftp.myhostname.com/pub (log in as user. You will be
  138.                                                prompted for a password)
  139.           ftp://user:password@ftp.myhostname.com/pub (log in as user/password)
  140. 1.2. Connecting using bookmarks
  141.    Bookmarks are the easiest way to connect to a remote site. Click on
  142. Bookmarks and select which site you want to connect to from the pop down menu.
  143. If gFTP doesn't have a password for the site you are trying to connect to, it
  144. will prompt you for one.  Due to security reasons, gFTP will not save a password
  145. in your bookmark file when gFTP obtains the password from a prompt.
  146. 1.3. Connecting using the toolbar
  147.    You can use the toolbar at the top of the window to connect to a remote
  148. site.  The only mandatory field to fill in is the hostname.  You can type in
  149. the hostname or you can copy it from the clipboard.  When entering a hostname in
  150. the toolbar do not include a directory name and file name.  If you do
  151. enter a complete URL gFTP will eventually give you an error message:  "Cannot
  152. look up hostname (hostname): Name or service not known".  If you have a complete
  153. URL to enter or paste, a better method would be to go to section 1.1 and
  154. use the Open URL button.  The way to handle a complete URL name on the toolbar
  155. is to split up the URL with the hostname in the Host field and the directory
  156. and/or file name in the directory name field on the right side of the screen
  157. just above the message that says "Not connected*".
  158. All of the other fields in the toolbar are optional:
  159.    If you don't fill in the port, it will default to the ftp port in your
  160. /etc/services file (usually port 21).
  161.    If you don't fill in a username, it will default to logging you in as
  162. anonymous.
  163.    Once you have all your information filled in, you can either
  164. hit enter in any of the host, port, user or password fields and gFTP will
  165. connect you to the remote site.
  166. 1.4. Connecting using command line parameters
  167.     You can start the GUI version of gFTP by using a KDE desktop application link
  168. or a Gnome desktop application link.  If you want to go to a specific site
  169. immediately on startup you can tell gFTP to connect to that site by typing in
  170. that site's URL after the gftp command.  For example:
  171. gftp  ftp://ftp.myhostname.com/pub
  172.    gftp-gtk is a the name of the GUI version of gFTP.  The command gftp is
  173. actually a script which decides whether, under the circumstances, to launch
  174. gftp-text or gftp-gtk.  If gftp does not launch the version that you want you
  175. can use gftp-text or gftp-gtk.
  176. 2. Downloading files
  177.    Once you have successfully connected to a remote site you can then
  178. select the files that you want and download them.  This section describes
  179. several ways that you can select and download files in gFTP.
  180. 2.1. Traversing remote directory trees
  181.    In the center of the right half of the gFTP screen you will find two windows.
  182. The upper window shows what remote directory you are currently connected to.
  183. The lower window is a listing of that directory's contents.  To open a
  184. directory, double click on the directory name.  To go back up to a parent
  185. directory double click on the .. at the top of the direcory listing.
  186. Be careful that you are not double clicking on a file name unless you intend to
  187. download that file.  You can also change directories by clicking on
  188. Remote->Change Directory.
  189.    You can control which files are shown in the remote directory window by
  190. clicking on Remote->Change Filespec.  Then enter the filespec that you would
  191. like to see.  For example you could enter *.rpm to eliminate everything but rpm
  192. files in the directory listing.
  193.    You can also control which files are shown in the remote directory window by
  194. clicking on Remote->Show Selected.  Then the remote directory will only show
  195. the file names of files that are also on the transfer queue.
  196.    Almost every FTP site limits the portion of their directory tree that you
  197. can access.  When you double click on the .. at the top of the directory
  198. listing and nothing happens that means that you are as low in the directory
  199. tree as you are allowed to go.
  200. 2.2. Downloading a Single File
  201.    To download a file double click on the file name.
  202. Or
  203.    Drag and Drop a file name from the remote directory window to the local
  204.    directory window.
  205. Or
  206.    Drag and Drop a file name from a web browser (such as Opera) to the
  207.    gFTP local directory window.
  208. Or
  209.    Click on the file name and click on the left arrow near the center of the
  210.    screen.
  211. 2.3. Downloading multiple files
  212.    If you want to specify several files to download one after the other then you
  213. must first throw the "Start file transfer" toggle off.  What this means is that
  214. when the toggle is on, gFTP starts downloading immediately when you select a
  215. file.  When the toggle is off you can stack up as many selections as you want
  216. on the transfer queue without gFTP starting to download.  You can use any of the
  217. selection methods described in the previous section on downloading single files.
  218. You can also select several files at once by using some of the commands on the
  219. Remote menu.  Click on Remote.  Click on the appropriate command(s) and then
  220. click on left arrow.  The commands are:
  221.     Select All Files - select every file in the current directory
  222.     Select All - select every file in the current directory and every file in
  223.                    every subdirectory of the current directory
  224.     Deselect All - erase your selections and start over
  225.    Then when you have finished selecting files you turn on the "Start file
  226. transfer" toggle on and gFTP will begin working its way through all of the
  227. downloads, one by one. To turn the toggle on click on
  228. FTP->Options->Start file transfers->Apply->OK.
  229. 2.4. Downloading from multiple sites
  230.     One of the features of gFTP is that you can queue download files from
  231. different remote sites.  Once you have a file(s) download started, you can
  232. safely disconnect from the remote site by clicking on Remote->Disconnect, and
  233. it will not harm the download in progress.  You can then connect to another
  234. remote site, and select another file(s) to download.  gFTP will add the new
  235. selections to the transfer queue and download all of the files in the queue
  236. sequentially.
  237. 2.5. Simultaneous downloads from multiple sites
  238.    In the previous section I described how to queue up downloads from multiple
  239. remote sites.  gFTP also has the ability to download from multiple sites
  240. simultaneously.  Whether gFTP does the downloads sequentially or in parallel
  241. is controlled by the "Do one transfer at a time" button.  To find this button:
  242. click on FTP->Options.  When the "Do one transfer at a time" button
  243. is on then gFTP will download files sequentially.  When the "Do one transfer at
  244. a time" button is off then gFTP will open up a connection to each remote site
  245. listed in the transfer queue and do as many downloads simultaneously as there
  246. are remote sites in the transfer queue.
  247.    Whether simultaneous downloading is an advantage to you or simply a confusion
  248. factor depends on how you are connected to the Internet.  If you are connected
  249. to an ISP with a dial-up modem then simultaneous downloading buys you nothing,
  250. you should leave the "Do one transfer at a time" button on.  If you are on a
  251. high speed local network connected to a proxy host which is attached to
  252. multiple trunk lines then simultaneous downloads could save you a lot of
  253. download time.  If you are not on a dial-up modem and haven't a clue about your
  254. network line configuration I suggest that you turn off the "Do one transfer at a
  255. time" button and give gFTP a real workout as a speed test.  If you get any
  256. interesting results let me know.
  257. 2.6. Differences between downloading in ASCII and BINARY mode
  258.    If you download a file in binary mode, gFTP will transfer the file as is,
  259. making no modifications to it.  But, if you are downloading text files, you
  260. should consider downloading them as ascii (unless you're downloading them from
  261. another unix machine, in which case either ascii or binary works fine).  The
  262. problem is that DOS and Unix use different methods to show end of line.
  263. In DOS, the lines in text files will have a carriage return and line feed
  264. after them:
  265. This is a line in a DOS text filern
  266. But, in unix the file will just be stored with a line feed at the end:
  267. This is a line in a UNIX text filen
  268. If you download a text file from a DOS machine as binary, and open it up in
  269. an Unix program like vi, you will see some weird Ms at the end of each
  270. line.  These are the carriage returns.  To get around this, download the file in
  271. ascii mode, and gFTP will do the proper conversion for you.  You can change
  272. between ascii and binary in the ftp menu.
  273. 3. Uploading files
  274.    Uploading is a lot simpler if you collect all of the files that you want to
  275. upload in the local directory before you connect to a remote site.  The local
  276. directory is the directory you specified in FTP->Options->Startup Directory.
  277.    Once you have successfully connected to a remote site you can then
  278. select the files that you want and upload them to a specific place on the
  279. remote site.  This section describes several ways that you can select and upload
  280. files in gFTP.
  281. 3.1. Selecting the remote directory
  282.    In the center of the right half of the gFTP screen you will find two windows.
  283. The upper window shows what remote directory you are currently connected to.
  284. The lower window is a listing of that directory's contents.  To open a
  285. directory, double click on the directory name.  To go back up to a parent
  286. directory double click on the .. at the top of the direcory listing.
  287. Be careful that you are not double clicking on a file name unless you intend to
  288. download that file.
  289.       You can control which files are shown in the remote directory window by
  290. clicking on Remote->Change Filespec.  Then enter the filespec that you would
  291. like to see.  For example you could enter *.rpm to eliminate everything but rpm
  292. files in the directory listing.
  293.    You can also control which files are shown in the remote directory window by
  294. clicking on Remote->Show Selected.  Then the remote directory will only show
  295. the file names of files that are also on the transfer queue.
  296.    Almost every FTP site limits the portion of their directory tree that you
  297. can access.  When you double click on the .. at the top of the directory
  298. listing and nothing happens that means that you are as low in the directory
  299. tree as you are allowed to go.
  300. 3.2. Working with the remote file tree
  301.    Uploading often consists of more than simply copying a file to a remote site.
  302. You may have to create or rearrange portions of the file tree on the remote
  303. site.  Right click on a blank spot in the directory window for the remote site
  304. and you will get a pop up menu which contains some commands for manipulating the
  305. remote site file tree.  These commands include:
  306.    Delete - delete a remote file or directory
  307.    Make Directory - create a directory on the remote site
  308.    Rename - rename a remote file or directory
  309.    Edit - edit a remote file using the editor specified in FTP->Options->Edit
  310.             program
  311.    View - view a remote file using the editor specified in FTP->Options->View
  312.             program
  313.    Chmod - change the attributes of a remote file or directory
  314. 3.3. Uploading a single file
  315.    To upload a file double click on the file name in the local directory window.
  316. Or
  317.    Drag and Drop a file name from the local directory window to the remote
  318.    directory window.
  319. Or
  320.    Click on the file name in the local directory and click on the right arrow
  321.    near the center of the screen.
  322. Or
  323.    Drag and Drop a file name from a file manager such as Midnight Commander to
  324.    the gFTP remote directory window.
  325. 3.4. Uploading multiple files
  326.    If you want to specify several files to upload one after the other then you
  327. must first throw the "Start file transfer" toggle off.  What this means is that
  328. when the toggle is on, gFTP starts uploading immediately when you select a
  329. file.  When the toggle is off you can stack up as many selections as you want
  330. on the transfer queue without gFTP starting to upload.  You can use any of the
  331. methods described in the previous section to select files to upload.  You can
  332. also select several files at once by using some of the commands on the Local
  333. menu. Click on Local. Click on the appropriate command and then click on right
  334. arrow.  The commands are:
  335.     Select All Files - select every file in the current directory
  336.     Select All - select every file in the current directory and every file in
  337.                    every subdirectory of the current directory
  338.     Deselect All - erase your selections and start over
  339.    Then when you have finished selecting files you turn the "Start file
  340. transfer" toggle on and gFTP will begin working its way through all of the
  341. uploads, one by one. To turn the toggle on click on FTP->Options->Start file
  342. transfers->Apply->OK.
  343. 3.5. Passive and non passive file transfers
  344.    When uploading files to a server you will find that some servers support
  345. passive file transfers and others do not.  Those sites which do not support
  346. passive file transfers usually block them because they consider passive file
  347. transfers too insecure.  When you run into a site that does not support
  348. passive file transfers you can try toggling passive file transfers off.  You can
  349. find the passive file transfers toggle by clicking on File->Options.  Click on
  350. the Passive file transfers button to toggle passive file transfers on and off.
  351.    The most common error message given out by a site that does not support
  352. passive transfers is:  Cannot create a data connection: Connection refused
  353. 4. Transfering files between remote sites (FXP)
  354.    The File Transfer Protocol has a subsection called File eXchange Protocol.
  355. gFTP can use FXP to transfer files between two remote sites.  gFTP will set up a
  356. direct connection between the two remote sites so that the transfer proceeds
  357. from one remote site to the other without your machine acting as an
  358. intermediary.  In order for gFTP to do a FXP transfer both remote sites must
  359. support FXP transfers.  Also the receiving site must support passive transfers
  360. and the sending site must allow gFTP to open a port to the receiving site.  If
  361. you cannot get the two remote sites to do a FXP transfer then the fall back
  362. method is to download the file(s) from the source remote site to your machine
  363. and then upload the file(s) to the receiving remote site.  The fall back method
  364. will take at least twice as long as a FXP transfer and perhaps as much as an
  365. order of magnitude longer.
  366.    The next several sections describe the sequence of actions that you must
  367. do in order to start a FXP transfer.  This explanation of FXP will assume that
  368. you know how to use gFTP to download and upload files.  Check the sections on
  369. downloads and uploads to fill in the details missing in the FXP explanation.
  370. 4.1. Connecting to the receiving site
  371.    You connect to the receiving remote site the same as if you are doing an
  372. upload to that site.
  373. 4.2. Selecting the receiving directory
  374.    You select the receiving remote directory the same as if you are doing an
  375. upload to that directory.
  376. 4.3. Working with the receiving file tree
  377.    You manipulate the receiving remote file tree the same as if you are doing
  378. an upload to that site.
  379. 4.4. Connecting to the sending site
  380.    On the top line of gFTP you will see the word "Local".  Click on Local
  381. and you will get a pop down menu.  Click on "Open URL" and you will get a
  382. command line window.  You can enter an URL name in this command line in a manner
  383. very similar to the way it works in most web browsers.  You can type in the
  384. URL, paste the URL from the clipboard, or Drag and Drop an URL from another
  385. application (say Konqueror).  gFTP will connect to the site you specify in the
  386. Open URL window.
  387. 4.5. Traversing the sending site directory tree
  388.    In the center of the left half of the gFTP screen you will find two windows.
  389. The upper window shows what remote sending site directory you are currently
  390. connected to.  The lower window is a listing of that directory's contents.  To
  391. open a directory, double click on the directory name.  To go back up to a parent
  392. directory double click on the .. at the top of the direcory listing.  Be
  393. careful that you are not double clicking on a file name unless you intend to
  394. transfer that file to the receiving remote site.  You can also change
  395. directories by clicking on Local->Change Directory.
  396.       You can control which files are shown in the left directory window by
  397. clicking on Local->Change Filespec.  Then enter the filespec that you would
  398. like to see.  For example you could enter *.deb to eliminate everything but
  399. Debian files in the directory listing.
  400.    You can also control which files are shown in the remote directory window by
  401. clicking on Local->Show Selected.  Then the local directory will only show
  402. the file names of files that are also on the transfer queue.
  403.    Almost every FTP site limits the portion of their directory tree that you
  404. can access.  When you double click on the .. at the top of the directory
  405. listing and nothing happens that means that you are as low in the directory
  406. tree as you are allowed to go.
  407. 4.6. Selecting files from the sending site
  408.    If you want to specify several files to transfer one after the other then you
  409. must first throw the "Start file transfer" toggle off by clicking on
  410. FTP->Options->Start file transfers->Apply->OK.  If you are only transfering a
  411. single file then you can ignore the "Start file transfer" toggle.
  412.    To transfer a file double click on the file name in the left directory
  413.    window.
  414. Or
  415.    Drag and Drop a file name from the left directory window to the right
  416.    directory window.
  417. Or
  418.    Click on the file name in the left directory window and click on the right
  419.    arrow near the center of the screen.
  420.    Select as many files as you want from the left directory window and gFTP will
  421. place them on the queue.  You can traverse the left directory window while you
  422. are selecting files.  You can also select several files at once by using some
  423. of the commands in the Local menu.  Click on Local.  Click on the appropriate
  424. command and then click on right arrow.  The commands are:
  425.     Select All Files - select every file in the current directory
  426.     Select All - select every file in the current directory and every file in
  427.                    every subdirectory of the current directory
  428.     Deselect All - erase your selections and start over
  429.    When you are finished selecting files then toggle "Start file transfer" on
  430. and gFTP will start transferring the files in the queue.
  431. 5. Resuming transfers
  432.    The File Transfer Protocol has the ability to restart an interrupted transfer
  433. at the point where it left off.  gFTP supports the resume function.  If the
  434. remote site you are dealing with also supports resume (most FTP sites do, HTTP
  435. sites do not) then you can resume an interrupted transfer.
  436. 5.1. Manual resumes
  437.    You can interrupt a transfer in the middle by exiting from gFTP and later
  438. resume the transfer at the point where it left off.  To resume a download start
  439. up the download just like any other download.  gFTP will find the partially
  440. downloaded file in the local download directory and then ask you whether to
  441. resume the download or to start all over.  Choose resume.  Then gFTP will
  442. connect to the remote site and negotiate with the remote site to resume the
  443. download at the point where it was interrupted.
  444.    Uploads and FXP transfers can be resumed in a manner analogous to resuming a
  445. download.
  446.    The only sticking point with exiting gFTP and then starting it up again is
  447. that you will lose the queue.  gFTP erases the queue when you exit and when you
  448. start up again you will have to rebuild the queue.  If you are doing a single
  449. file transfer then erasing the queue is unimportant.
  450.    Resume is a well defined Internet protocol which requires the cooperation of
  451. both gFTP and the server software.  Occasionally you will run into a server
  452. which does not support the Resume protocol.  In the case of downloads all is
  453. not necessarily lost.  gFTP will try to resume any download when it finds the
  454. file name in the local download directory.  You might be able to salvage the
  455. download by finding another remote site to download that same filename from, a
  456. site that supports the FTP Resume protocol.
  457. 5.2. Automatic resumes
  458.   If gFTP is in the process of transferring some files and the connection closes
  459. for some reason, gFTP will try to reconnect again and continue with the file
  460. transfer where it left off.  You can set how many times to reconnect and how
  461. long to wait in the options dialog.  In order to specify reasonable reconnect
  462. options you need to understand some of the things that can go wrong with a
  463. transfer.
  464.    The most common cause of transfer problems is an overloaded FTP server.  When
  465. a server becomes overloaded there will be times when the server just can't get
  466. around to passing gFTP the next block of data (or receiving the data in the
  467. case of an upload).  In the gFTP progress window you will get a message that the
  468. transfer is stalled.  If the transfer is stalled for over 30 seconds gFTP will
  469. time out the transfer and disconnect. (Don't mess with the Read timeout Option
  470. unless you know what you are doing. You can get timeouts for a lot of other
  471. reasons that an overloaded server.) gFTP then waits the time interval specified
  472. in FTP-Option and then reconnects.
  473.    Some servers recognize when they are overloaded and begin deliberately
  474. disconnecting clients until they get back down to the maximum number of
  475. transfers that they can reasonably serve.  If gFTP gets disconnected it waits
  476. the time interval specified in FTP->Options and then reconnects.  These servers
  477. sometimes remember who they have just bounced off and if you try to reconnect
  478. immediately they may tell gFTP to stop trying to automatically reconnect.  So in
  479. the Options (Ftp->Options->Network->Retry sleep time) you want to wait just long
  480. enough that the busy server will have forgotten you and then reconnect.  The
  481. gFTP default is 15 seconds.
  482.    The other reconnect Option that you are interested in is Connect retries
  483. (Ftp->Options->Network->Connect retries).  Connect retries is the number of
  484. times that gFTP will reconnect before giving up altogather.  There two ways to
  485. approach this option:
  486.    If gFTP has to keep reconnecting to a remote server then the transfer can be
  487. very slow.  You might want to switch another remote server which is faster.
  488. If the file name on the new server is exactly the same as the file name on the
  489. previous server then you can resume a download at whatever point you got to on
  490. the first server.  In this case set FTP->Options->Connect retries to 3, which is
  491. the gFTP default.
  492.    If you want to keep chugging away at the transfer until it finishes, no
  493. matter what, then set FTP->Options->Connect retries to 0.
  494. 6. FTP password and user id
  495.    The standard File Transfer Protocol requires the use of a user id and a
  496. password.  gFTP will always use a user id and a password for each FTP
  497. connection.
  498. 6.1. Anonymous FTP
  499.    Many FTP server sites are public sites which make their files freely
  500. available to anyone who wants to download them.  To get around the nuisance of
  501. user ids and passwords public sites use the standard anonymous FTP protocol.
  502. gFTP uses an user id of anonymous and a password that looks like a valid email
  503. address (internet@linux.local).  You can change the anonymous email
  504. address/password by clicking on FTP->Options->General and changing the Email
  505. address field.
  506. 6.2. Secure FTP password and user id
  507.    Some FTP server sites are private sites which are very selective about who
  508. can download files from that site.  Almost all upload sites are selective.
  509. Private sites insist that you obtain a user id and a password, perhaps even
  510. pay money for them.  Then you have to use that particular user id and password
  511. to access the private FTP site.
  512.    If you want to save your password for a bookmarked site in the bookmark file,
  513. you should read the section on security concerns first.  Then if you still
  514. want gFTP to remember your bookmark entry passwords there are two ways to do it.
  515. The easier way is to add the password manually to the bookmark file
  516. (/home/user/.gftp/bookmarks) using a text editor.  Or you can have gFTP add
  517. the bookmark password by: click on Edit bookmarks, right click on the
  518. appropriate bookmark entry, click on Properties, and turn off "Log in as
  519. ANONYMOUS".  Then gFTP will make the Username and Password fields available
  520. for editing.
  521.   You can tell gFTP not to use anonymous FTP by entering the user name in the
  522. URL.  For example:
  523.    ftp://user@ftp.myhostname.com/pub (log in as user. gFTP will prompt you
  524.                                       for a password)
  525.    You can give gFTP both the user name and password in the URL.  For example:
  526.    ftp://user:password@ftp.myhostname.com/pub (log in as user/password)
  527. 6.3. FTP security concerns
  528.    Some private FTP sites require you to use a valid email address as either the
  529. user id or the password.  An organization with a reputable name to protect will
  530. not spam your email address.  With other people or organizations you are
  531. vunerable to spamming.  You might consider opening a free email account
  532. somewhere and use it for spam bait only.
  533. 7. Local directory
  534.    The local directory is the directory on your computer from which you will
  535. upload files or which you will use to receive downloaded files.  A window
  536. showing the local directory is located in the middle left of the gFTP screen.
  537. 7.1. Specifying the local directory
  538.    You can set the default local directory by clicking on FTP->Options and then
  539.    typing in the local directory path into Startup Directory.
  540. Or
  541.    You can change the local directory by entering the new name into the small
  542.    window just above the local directory window.  Your new name will be entered
  543.    into the local directory history but the new name will not replace the
  544.    default name in Options.
  545. Or
  546.    You can select a name from the local directory history list.  Click on the
  547.    down arrow to the right of the local directory name and then click on the
  548.    history entry you want to use.  Your new name will be entered into the local
  549.    directory history but the new name will not replace the
  550.    default name in Options.
  551. Or
  552.    You can traverse the local directory tree by clicking on the directory names
  553.    in the local directory window.  To open a directory, double click on the
  554.    directory name.  To go back up to a parent directory double click on the ..
  555.    at the top of the file listing.  Be careful that you are not double clicking
  556.    on a file name unless you intend to upload that file.
  557. 7.2. Working in the local directory
  558.    There are several operations that gFTP can perform in the local directory.
  559. You can perform the following operations regardless of whether you are connected
  560. to a remote site or not:
  561.    Make a directory - Right click on a blank area in the local directory window.
  562.       Then left click on Make Directory.  Enter the new directory name in the
  563.       pop up window and click on Create.
  564.    Delete a directory or filename - Right click on the directory or filename.
  565.       Then left click on Delete.
  566.    Rename a directory or filename - Right click on the directory or filename.
  567.       Then left click on Rename.  Enter the new name in the pop up window and
  568.       click on Rename.
  569.    Change the attributes of a directory or filename - Right click on the
  570.       directory or filename.  Then left click on Chmod.  Set the attributes in
  571.       the pop up menu and click on Change.
  572.    Edit a file - Right click on the filename.  Then left click on Edit.  The
  573.       file will be opened in the editor that you specified FTP->Options->Edit
  574.       program.
  575.    View a file - Right click on the filename.  Then left click on View.  The
  576.       file will be opened in the program that you specified FTP->Options->View
  577.       program.
  578.    Refresh the listing - Right click on a blank area in the local directory
  579.       window.  Then left click on Refresh.  gFTP will refresh the local
  580.       directory listing.
  581.    Change the filespec - Click on Local->Change Filespec.  Then enter the
  582.      filespec that you would like to see.  For example you could enter *.html to
  583.      eliminate everything but html files in the directory listing.
  584. 7.3. Formating the local directory window
  585.    You can arrange the format of the local directory window by sliding the
  586. Filename, Size, User, Group, Date, and Attribs labels to wherever you want them.
  587.    You can change the overall size of the local directory window by using a text
  588. editor to change the config file (/home/user/.gftp/gftrc).  The parameters which
  589. control the local directory window size are listbox_local_width and
  590. listbox_file_height.
  591. 8. Remote directory
  592.      The remote directory is the directory on a remote site from which you will
  593. download files or which you will use to receive uploaded files.  A window
  594. showing the remote directory is located in the middle right of the gFTP screen.
  595. 8.1. Specifying the remote directory
  596.    When you enter a URL in the Remote->Open URL window, gFTP shows that portion
  597. of the URL which designates a remote site directory name in the small window
  598. just above the remote directory window.
  599. 8.2. Formating the remote directory window
  600.    You can arrange the format of the remote directory window by sliding the
  601. Filename, Size, User, Group, Date, and Attribs labels to wherever you want them.
  602.    You can change the overall size of the remote directory window by using a
  603. text editor to change the config file (/home/user/.gftp/gftrc).  The parameters
  604. which control the remote directory window size are listbox_remote_width and
  605. listbox_file_height.
  606. 9. Transfer window
  607.    The transfer window is the second window from the bottom.  It shows the queue
  608. and the progress of the current file transfer(s).
  609. 9.1. Queue
  610.    The left hand side of the transfer window shows the queue of transfers to be
  611. done.  You can stack several transfers in the queue and gFTP will work its way
  612. through the queue transferring the files in the order that they were entered in
  613. the queue.  Whether gFTP does the transfers sequentially or in parallel is
  614. controlled by the "Do one transfer at a time" button.  To find this button:
  615. click on FTP->Options.  When the "Do one transfer at a time" button is on then
  616. gFTP will transfer files sequentially.  When the "Do one transfer at a time"
  617. button is off then gFTP will open up a connection to each remote site listed
  618. in the transfer queue and do as many transfers in parallel as there are remote
  619. sites in the transfer queue.
  620.    You can manipulate the entries on the transfers queue by first clicking on
  621. the entry to highlight it and then clicking on Transfers.  The Transfers pop up
  622. menu makes these commands available:
  623.     Stop Transfer - highlight the queue entry for the file currently being
  624.                       transferred and then click on Transfers->Stop Transfer
  625.     Start Transfer - highlight the queue entry for the file you want to
  626.                        transfer next and then click on Transfers->Start
  627.                        Transfer
  628.     Move File Up - move the file up one position in the queue
  629.     Move File Down - move the file down one position in the queue
  630.     Remove File - delete the file from the queue
  631.     Skip Current File - leave the file name on the queue but do not transfer the
  632.                           file
  633.    gFTP does not save the transfer queue when gFTP exits.  If you exit gFTP and
  634. then start it again you will have an empty queue.
  635. 9.2. Progress
  636.    The right hand side of the transfer window shows the status of the
  637. transfer(s) in progress.  gFTP shows the % completion of the entire queue, the
  638. size of the file currently being transfered, how many bytes of the current file
  639. have already been transferred, which files are finished transfering, and which
  640. files are waiting to begin transfering.  The progress report also shows the
  641. current transfer rate and gives an estimated length of time until the entire
  642. queue is transferred.  Your milage may vary.
  643. 9.3. Formating the transfer window
  644.    You can arrange the format of the transfer window by sliding the Filename and
  645. Progress labels to wherever you want them.
  646.    You can change the height of the remote directory window by using a text
  647. editor to change the config file (/home/user/.gftp/gftrc).  The parameter
  648. which controls the transfer window height is transfer_height.
  649. 10. Log and log window
  650.    gFTP keeps a log (/home/user/.gftp/gftp.log) which records what gFTP has
  651. done.  The log is erased and begun anew at each startup of gFTP.  The log
  652. entries are displayed in the window at the bottom of the gFTP screen.  You can
  653. specify a different location for your log file by clicking on FTP->Options and
  654. entering the now location in Log file.
  655. 10.1. Log commands
  656.    If you right click anywhere on the log window then a pop up menu will appear
  657. with three commands:
  658.    Clear - double clicking on Clear erases all of the log entries.
  659.    View log - double clicking on View log launches the program you specified in
  660.               FTP->Options->View program to display the log.
  661.    Save log - double clicking on Save log opens a file tree display window which
  662.               you can use to save the gFTP log anywhere that you want to put it.
  663.    The Clear, View log, and Save log commands can also be accessed by clicking
  664. on the Logging button at the top of the gFTP screen.
  665. 10.2. Formating the log window
  666.    You can change the overall size of the log window by using a text editor to
  667. change the config file (/home/user/.gftp/gftrc).  The parameters which control
  668. the remote directory window size are log_height= and max_log_window_size=.
  669.    You can change the colors of the various message types in the log window by
  670. using a text editor to change the config file (/home/user/.gftp/gftrc).  The
  671. parameters which control the log window message colors are
  672. send_color=rrii:ggii:bbii, recv_color=rrii:ggii:bbii,
  673. error_color=rrii:ggii:bbii, and misc_color=rrii:ggii:bbii.
  674.    rrii:ggii:bbii is the color code where each letter stands for a hexidecimal
  675. digit from o through f.
  676.    rr - amount of red in the color
  677.    gg - amount of green in the color
  678.    bb - amount of blue in the color
  679.    ii - intensity of the color
  680.    examples:  bright red rrii:ggii:bbii = ffff:0000:0000
  681.               dull brown rrii:ggii:bbii = a000:8d80:4600
  682. 11. Bookmarks
  683.    gFTP has a bookmarks file which looks and acts very similar to the bookmarks
  684. file in a web browser.  gFTP comes with several popular download sites listed in
  685. the bookmarks file.
  686. 11.1. Using a bookmark entry
  687.    To connect to a remote site, click on Bookmarks and a drop down menu appears.
  688. Navigate the tree until you find the site you want to connect to.  Click on that
  689. entry and gFTP will connect to that site.  If gFTP doesn't have a password for
  690. the site you are trying to connect to, it will prompt you for one.  For
  691. security reasons, gFTP will not save this password in your bookmark file when it
  692. prompts you for it.
  693. 11.2. Adding a bookmark
  694.    There are two ways to add a bookmark entry to the gFTP bookmark file:
  695.    When you are connected to a site you can click on Bookmarks->Add bookmark.
  696. gFTP will open a window in which you enter the entire path name for the new
  697. entry.  For example:  If you find a Czech mirror site for SuSE downloads you
  698. could file the bookmark as SuSE Sites/Czech mirror and gFTP will add Czech
  699. mirror to the existing SuSE Sites folder.
  700.    At any time, connected or not, you can add a bookmark entry by clicking on
  701. Bookmarks->Edit bookmarks.  Then right click on a blank area of the bookmarks
  702. window.  A menu will pop up.  Click on New item.  Then enter the entire path
  703. name of the new entry in the pop up window.  (For example:  To create the first
  704. site in a new Mandrake folder enter Mandrake Sites/USA mirror.)  Click on
  705. create.  At this point you have created a bookmark entry that does not point
  706. anywhere. Now right click on the new entry, click on Properties, and fill out
  707. the information requested in the pop up form.  Click on Apply and click on OK.
  708. You are now finished adding the new bookmark entry.
  709. 11.3. Editing bookmarks
  710.    You can change the details in a bookmark entry by clicking on Bookmarks->Edit
  711. bookmarks, right click on the bookmark entry, and click on Properties.  A form
  712. will pop up which you can use to edit the entry.  Then click on Apply and OK.
  713.    You can delete a bookmark or an entire folder of bookmarks by clicking on
  714. Bookmarks->Edit bookmarks, right click on the bookmark entry, and click on
  715. Delete.
  716.    You can rearrange bookmarks with drag and drop.  Rearrangement of the
  717. bookmark entries in gFTP works very similar to the way that it works in most web
  718. browsers.  You drag the entry to the appropriate spot in the directory tree and
  719. drop it.  With a little practice you can get the entries to go where you want
  720. them to go.
  721. 11.4. Bookmark passwords
  722.   If gFTP doesn't have a password for the bookmarked site you are trying to
  723. connect to, gFPT will prompt you for one.  Due to security concerns, gFTP will
  724. not save this password in your bookmark file.  If you want to save your
  725. password for a bookmarked site in the bookmark file, you should read the section
  726. on security concerns first.  Then if you still want gFTP to remember your
  727. bookmark entry passwords there are two ways to do it.
  728.    The easier way is to add the password manually to the bookmark file
  729.    (/home/user/.gftp/bookmarks) using a text editor.  An example of a bookmark
  730.    entry containing a password is:  ftp://user:password@ftp.myhostname.com/pub
  731. Or
  732.    You can have gFTP add the bookmark password by: click on Edit bookmarks,
  733.    right click on the appropriate bookmark entry, click on Properties, and turn
  734.    off "Log in as ANONYMOUS".  Then gFTP will make the Username and Password
  735.    fields available for editing.  Enter the Username and Password fields.  Click
  736.    on Apply and click on OK.
  737. 11.5. Bookmark security concerns
  738.    When you save a password in the gFTP bookmark file you are creating a
  739. potential security vulnerabilty because gFTP does not encrypt stored passwords.
  740. Any cracker could write a program to extract passwords from the gFTP bookmarks
  741. file.  You should weigh the chances of a malicious attack on your machine and
  742. the value of the password protected data versus the convenience of storing the
  743. passwords before deciding whether or not to store passwords in the bookmark
  744. file.
  745. 12. FTP protocol
  746.    File Transfer Protocol is a hardware and software independent Internet
  747. protocol which is used to transfer information between servers and clients.
  748. Servers are computers which give out information and clients are computers that
  749. receive information.  It is possible for a computer to be both an FTP client and
  750. server.  gFTP allows your computer to act as a FTP client.
  751.    When gFTP contacts a FTP server it establishes two connections, a control
  752. connection and a transfer connection.  gFTP first establishes a control
  753. connection by sending an user id and a password to the server.  Then gFTP
  754. requests that a particular file(s) be transferred.  Once gFTP has started a FTP
  755. transfer gFTP can drop the control connection without interrupting the transfer.
  756. 12.1 Invoking FTP
  757.    gFTP knows to use FTP by the first three letters of the URL.  An URL for a
  758.    FTP transfer begins with ftp://.
  759. Or
  760.    Click on the button immediately to the left of the red light and click on FTP
  761. 13. HTTP protocol
  762.    HyperText Transfer Protocol is a hardware and software independent Internet
  763. protocol which is used to transfer information between servers and clients.  It
  764. is probably the most used protocol on the Internet.  gFTP can act as a HTTP
  765. client.
  766.    From the client standpoint the HTTP protocol is far simpler than the FTP
  767. protocol.  Among other things, HTTP has no user ids and passwords.  This
  768. simplicity makes file transfers using HTTP somewhat more simple minded.
  769. 13.1. Invoking HTTP
  770.    gFTP knows to use HTTP by the first four letters of the URL.  An URL for a
  771.    HTTP transfer begins with HTTP://.
  772. Or
  773.    Click on the button immediately to the left of the red light and click on
  774.    HTTP.
  775. 14. SSH protocol
  776.    SSH (Secure SHell) is a protocol which provides a high level of security
  777. for transfering files from one computer to another across the Internet.  gFTP
  778. implements the SSH protocol by calling upon an SSH program to wrap a layer of
  779. security around what would otherwise be an ordinary FTP tansfer.  In effect
  780. FTP "tunnels" through a secure SSH connection.
  781. 14.1. Configuring SSH
  782.    In order to configure your SSH transfers click on FTP->Options->SSH and fill
  783. out the form.  The required entries are:
  784.     SSH Prog Name - This is the name of the program which provides the SSH
  785.                       wrapper.
  786.     SSH Extra Params - These are the parameters that the SSH wrapper program
  787.                          needs to build an encryption key.
  788. 14.2. Invoking SSH
  789.    gFTP knows to use SSH by the first three or four letters of the URL.  An URL
  790.    for a SSH transfer begins with ssh:// or ssh2://.
  791. Or
  792.    Click on the button immediately to the left of the red light and click on
  793.    either SSH or SSH2
  794. 14.3. SSH and SSH2
  795.    SSH recently went through a major revision to plug known security holes.  The
  796. latest version of SSH is called SSH2.  SSH and SSH2 are not compatible with each
  797. other.  gFTP supports both SSH and SSH2.
  798. 15. Miscellaneous commands
  799. 15.1. Window
  800.    You can reverse the roles of the local window and the remote window.  Click
  801. on FTP.  The Window 1 and Window 2 buttons can be used to switch the roles of
  802. the local and remote windows.  Window 2 is the default and this user's guide
  803. describes everything as set up by Window 2.  Clicking on Window 1 switches the
  804. roles of the two windows to the mirror image of that described in this document.
  805. 15.2. SITE commands
  806.    One of the features of the File Transfer Protocol is the ability to create
  807. SITE commands.  A FTP server administrator can create customized commands for a
  808. FTP client program, such as gFTP, to use.  These customized commands are called
  809. SITE commands.
  810.    If you want to use a SITE command while you are connected to a FTP server
  811. then click on either Remote or Local, whichever is connected to the remote site
  812. in question.  Then click on Send SITE Command and a pop up window will open.
  813. You can enter the SITE command in the window.  Then click on OK and gFTP will
  814. send the SITE command to the FTP server.
  815. 15.3. Bidirectional transfers
  816.    It is possible that you may want to open a connection to a remote site and
  817. transfer files in both directions.  Click on Transfers and you will find some
  818. commands to help you change the direction of the transfers without having to
  819. drop the connection and restart it in the other direction.  These commands are:
  820.     Put Files - send the files on the transfer queue to the remote site
  821.     Retrieve Files - copy the files on the transfer queue from the remote site
  822.                        to the local site
  823. 15.4. Clear cache
  824.    gFTP keeps a cache of data from remote sites.  It is possible that while you
  825. are working with a remote site other people are making changes to that site.  To
  826. get rid of stale copies of the remote directory tree in the cache click on
  827. Tools->Clear Cache.
  828. 15.5. Compare Windows
  829.    An easy way to check which files have been transferred and which files have
  830. not is to click on Tools->Compare Windows.  gFTP will highlight any file names
  831. which appear in either the local directory or the remote directory but not both.
  832. 15.6. Disconnect
  833.    You can disconnect from a remote site at any time.  Disconnecting does not
  834. stop any transfers already in prograss.  You can disconnect by:
  835.   clicking on the red button when it is lit up
  836. Or
  837.   clicking on Remote->Disconnect
  838. Or
  839.   clicking on Local->Disconnect
  840. 16. Using gftp-text (the command line version of gftp)
  841.    The gFTP package includes a completely functional command line version of
  842. gFTP.  You can launch the command line version by typing in the command,
  843. gftp-text, at your console prompt.  The command gftp is actually a script which
  844. decides whether, under the circumstances, to launch gftp-text or gftp-gtk.  If
  845. gftp does not start the version that you want you can finesse that problem by
  846. using gftp-text or gftp-gtk instead of gftp.
  847. 16.1. Downloading entire directories and subdirectories
  848.    If you want to download entire directories including subdirectories you
  849. should look at using gftp-text.  Some downloads are simpler to invoke using
  850. gftp-text.  For example:
  851.    gftp-text -d ftp://ftp.somesite.com/someplace
  852.    If someplace is a directory, it'll automatically download all its
  853. subdirectories as well. If you want to transfer a file through SSH instead of
  854. FTP then change the ftp:// to ssh://
  855. 16.2. Documentation for gftp-text
  856.    gftp-text will give you a prompt: ftp>
  857. You can learn more about gftp-text by typing in help at the ftp> prompt.  You
  858. can also get instructions in how to use gftp-text by typing in "man gftp" or
  859. "info gftp" at the console prompt.
  860. 17. Using gftp-gtk
  861.    gftp-gtk is the name of the GUI version of gFTP.  The gftp command is
  862. actually a script which decides whether, under the circumstances, to launch
  863. gftp-text or gftp-gtk.
  864. 18. Configuring gFTP
  865.    All of the gFTP configuration options are specified in the file
  866. /home/user/.gftp/gftprc.
  867. 18.1. Proxy host setup
  868.    If your computer is on a local network then you are probably connected to the
  869. internet through a proxy host.  A proxy host can connect several users to the
  870. internet.  A proxy host often also acts as a firewall, possibly filtering
  871. messages in both directions.  If you are connected to the internet through a
  872. proxy host then gFTP needs passwords and other configuration information to
  873. make a connection through the proxy host to the internet.
  874.    To set up your proxy host and/or firewall configuration, click on
  875. FTP->Options.  You can click on HTTP Proxy and FTP Proxy to set up your
  876. proxy hosts, user names, and passwords.  In the FTP Proxy form, you can set up
  877. how you want gFTP to log into the proxy host.  I have many of the common types
  878. of proxy hosts that you will encounter already descried in gFTP.  If you are
  879. using a very complex proxy host configuration then you may have to use a text
  880. editor to edit the config file (/home/user/.gftp/gftprc).  The fields in the
  881. config file that pertain to proxy host and/or firewall configuration are:
  882.     # Firewall hostname
  883.     firewall_host=
  884.     # Port to connect to on the firewall
  885.     firewall_port=21
  886.     # Your firewall username
  887.     firewall_username=
  888.     # Your firewall password
  889.     firewall_password=
  890.     # Your firewall account (optional)
  891.     firewall_account=
  892.     # This specifies how your proxy server expects us to log in
  893.     proxy_config=
  894.     # Firewall hostname
  895.     http_proxy_host=
  896.     # Port to connect to on the firewall
  897.     http_proxy_port=80
  898.     # Your firewall username
  899.     http_proxy_username=
  900.     # Your firewall password
  901.     http_proxy_password=
  902. 18.2. Proxy security concerns
  903.    When you have gFTP save a proxy password you are creating a potential
  904. security vulnerabilty.  gFTP does not encrypt stored passwords.  They are kept
  905. in plain text in the file, /home/user/.gftp/gftprc.  Any cracker could write
  906. a program to extract passwords from the gftprc file.  You should weigh the
  907. chances of a malicious attack on your machine and the value of the proxy
  908. passwords versus the convenience of storing the passwords before deciding
  909. whether or not have gFTP store proxy passwords.  Also if you are on a local
  910. network then you are probably a member of a beaurocracy, lucky you.  In that
  911. case you should give a passing thought to your organization's security rules.
  912. 18.3. Configuring file extensions
  913.    gFTP has the ability to use mime types.  Some mime types come pre-configured
  914. with gFTP and you have complete control to configure the gFTP mime types any way
  915. that you want.
  916.    Towards the bottom of the config file (/home/user/.gftp/gftprc), there is a
  917. section that has some ext= lines.  Here you can control via a file extension,
  918. the icon in the listbox for it, the default transfer method (ascii or binary),
  919. and a default view/edit program.  For example, let's take the line:
  920. ext=.xcf:gimp.xpm:B:gimp
  921. The first token, .xcf, is the file extension.  The next token, gimp.xpm, is
  922. the default icon to use in the listboxes.  You don't have to specify one if
  923. you don't want to.  By default, gFTP will search ~/.gftp, $(PREFIX)/share/gftp
  924. (where prefix is your installation prefix), and then /usr/share/icons in that
  925. order.  The files must be valid xpm files.  The next token, B, specifies
  926. whether or not to transfer a file as Binary or Ascii.  If you want to have
  927. something transfer as Ascii, put an A there.  If you omit this field, then gFTP
  928. will transfer the file according to whether ascii or binary is selected in
  929. the FTP menu.  The final token, gimp, specifies the name of the program to run
  930. to view or edit a file with that extension.  You can omit this as well if you
  931. like.
  932. 18.4. Desktop icon
  933.    You can set up gFTP to be started from your Gnome or KDE desktop.  The
  934. program name can be either gftp or gftp-gtk.  Some suitable gFTP icons are
  935. available in /usr/share/gftp:  gftp.xpm  down.xpm  world.xpm
  936. 19.  Staying in touch
  937. 19.1. gFTP bugs
  938.    gFTP is released under the GNU General Public License.  As such there is
  939. ABSOLUTELY NO WARRENTY with gFTP.  That said, if you run into ANY bugs in gFTP
  940. please let me know.  I take pride in making gFTP as bug free as possible.  Since
  941. gFTP is used on a wide variety of hardware and software configurations bugs will
  942. sometimes crop up that I never could have anticipated on the configuration I use
  943. to develop gFTP.  Please include as much information as possible in your bug
  944. description.  It is better to report too much detail than to report too little
  945. detail in your bug report.  Basically, I need enough information to be able to
  946. recreate the bug on my machine.  The information that might be useful to me
  947. could include:
  948. The  gFTP version number you are using and what installation method (tarball
  949. or rpm).  For example:
  950.    I am using gFTP-2.0.13.tar.gz.
  951. Please tell me your hardware and software configuration.  For example:
  952. Configuration:
  953.    AMD 1.2G CPU with 256M ram
  954.    Mandrake 8.1 distribution
  955.    KDE 2.2 desktop
  956.    KWvDial 0.10 -> dial up modem
  957.    kernel 2.2.10
  958.    Please tell me enough about the problem so that I can try to recreate it.
  959. For example:
  960.   I was connected to jungle.metalab.unc.edu, which is a Mandrake mirror, to do
  961. some downloads.  I connected OK using the Remote->Open URL window.  I went to
  962. a directory called /pub/Linux/distributions/mandrake/Mandrake/8.1/SRPMS/ and
  963. double clicked on the file alien-7.27-1mdk.src.rpm.  gFTP entered this file
  964. name in the queue twice and downloaded it twice.  I think gFTP should have
  965. only downloaded it once.  This happens intermittently.  Sometimes gFTP downloads
  966. files once and sometimes it downloads files twice.  gFTP always downloads
  967. alien-7.27-1mdk.src.rpm twice.
  968. Please attach the gFTP log file (/home/user/.gftp/gftp.log) to your report.
  969. If you are having trouble with gFTP bookmarks please attach the gFTP bookmark
  970. file (/home/user/.gftp/bookmarks) to your report.
  971. If you are having trouble with the gFTP configuration please attach the gFTP
  972. configuration file (/home/user/.gftp/gftprc) to your report.
  973. If you keep passwords in your bookmark file or your configuration file you might
  974. want to x out the passwords before you send the file to me.
  975. Please send your bug report to:
  976. Brian Masney   masneyb@gftp.org
  977. Elkview, WV USA
  978. If you find a bug in an older version of gFTP, that bug might already be fixed
  979. in the latest version of gFTP.  You can find the latest version at the gFTP
  980. download site by clicking on Bookmarks->General Sites->gFTP.
  981. 19.2. gFTP mailing list
  982.    There is a mailing list available where you can receive announcements about
  983. new versions of gFTP.  It is an extremely quiet mailing list and I promise not
  984. to spam you.  To subscribe to the gFTP mailing list, send a message to
  985. majordomo@seul.org with the words subscribe gftp-announce in the body.
  986. 19.3. gFTP home page and FAQ
  987.    You can find the latest information about gFTP at the gFTP home page or on
  988. the gFTP Frequently Asked Questions.
  989. gFTP home page:  http://www.gftp.org/
  990. gFTP FAQ:  http://www.gftp.org/faq.html
  991. 20. Legal section
  992.    Click on Help->About->License Agreement to find a copy of the GNU General
  993.    Public License
  994. 20.1. Copying gFTP
  995.    This program is free software; you can redistribute it and/or modify
  996.    it under the terms of the GNU General Public License as published by
  997.    the Free Software Foundation; either version 2 of the License, or
  998.    (at your option) any later version.
  999.    You should have received a copy of the GNU General Public License
  1000.    along with this program; if not, write to:
  1001.       Free Software Foundation, Inc.
  1002.       59 Temple Place - Suite 330
  1003.       Boston, MA 02111
  1004.       USA
  1005. 20.2. Warrenty
  1006.    This program is distributed in the hope that it will be useful,
  1007.    but WITHOUT ANY WARRANTY; without even the implied warranty of
  1008.    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  1009.    GNU General Public License for more details.
  1010. 20.3. Source code
  1011.    gFTP is open source software under the terms of the GNU General Public
  1012. License.  You can find the gFTP source code by clicking on
  1013. Bookmarks->General Sites->gFTP.  The tarballs on the gFTP web site contain both
  1014. source and binary.  The rpm packages are split into binary rpms and source
  1015. rpms.  The Debian packages contain both binary and source.  You may use the
  1016. gFTP source code in any way that you wish as long as you conform to the terms
  1017. of the GNU General Public License.  If you fix any bugs or add any useful
  1018. features to gFTP you might consider sending your changes to me to be
  1019. incorporated into a future release of gFTP.  I welcome any help you might give
  1020. me in improving gFTP.