"Fossies" - the Fresh Open Source Software Archive

Member "gftp-2.0.19/README" (30 Nov 2008, 15906 Bytes) of archive /linux/misc/gftp-2.0.19.tar.gz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 
    2 
    3 gFTP FAQ
    4 
    5 
    6 Brian Masney
    7 
    8 This document is intended to answer questions that are likely to be frequently
    9 asked by users of gFTP.
   10 -------------------------------------------------------------------------------
   11 
   12 
   13   Table of Contents
   14 
   15   1. General_Information
   16 
   17 
   18         1.1. What_are_the_requirements_to_run_gFTP?
   19 
   20         1.2. How_do_I_install_gFTP?
   21 
   22         1.3. What_systems_is_gFTP_known_to_run_on?
   23 
   24         1.4. Does_gFTP_have_a_SVN_repository?
   25 
   26         1.5. How_do_I_report_bugs_in_gFTP?
   27 
   28         1.6. How_do_I_force_running_the_text_or_gtk+_version_of_gFTP?
   29 
   30         1.7. Is_there_a_way_for_gFTP_to_download_a_bunch_of_files/directories
   31         and_then_exit_when_it's_completed?
   32 
   33         1.8. In_the_GTK+_version_of_gFTP,_do_I_have_to_enter_a_port,_username
   34         and_password_to_connect_to_a_ftp_server?
   35 
   36         1.9. Where_does_gFTP_store_it's_options?
   37 
   38         1.10. Why_aren't_the_file_sizes_comma_separated?
   39 
   40         1.11. When_using_an_external_editor,_gFTP_does_not_detect_changes_that
   41         are_being_made_to_the_file.
   42 
   43         1.12. How_can_I_increase_the_size_of_the_fonts_in_gFTP?
   44 
   45         1.13. I_can't_transfer_certain_file_types_in_binary_mode_using_the_FTP
   46         protocol.
   47 
   48 
   49   2. FTP_Protocol
   50 
   51 
   52         2.1. When_gFTP_tries_to_get_the_remote_directory_listing,_the_remote
   53         server_complains_about_either_the_-a_or_-L_argument_to_LIST.
   54 
   55         2.2. When_gFTP_tries_to_get_the_remote_directory_listing,_I_receive_the
   56         error:_Cannot_create_a_data_connection:_Connection_refused
   57 
   58 
   59   3. HTTP_Protocol
   60 
   61 
   62         3.1. How_do_I_set_up_my_HTTP_Proxy_server?
   63 
   64 
   65   4. SSH_Protocol
   66 
   67 
   68         4.1. gFTP_will_not_log_into_the_remote_SSH_server_when_using_a_non-
   69         English_locale.
   70 
   71         4.2. I'm_having_problems_getting_SSH2_transfers_to_work._I_keep_getting
   72         the_error:_Error:_Message_size_XXXXXXXX_too_big_from_server
   73 
   74         4.3. What_is_the_difference_between_the_SSH_and_SSH2_protocols?
   75 
   76 
   77   5. SSL_Issues
   78 
   79 
   80         5.1. When_using_the_FTPS_or_HTTPS_protocol,_gFTP_cannot_connect_if_the
   81         remote_server_uses_a_self_signed_certificate.
   82 
   83 
   84   6. Compiling_Problems
   85 
   86 
   87         6.1. When_I_try_to_compile_gFTP,_I_see_undefined_symbol
   88         libintl_gettext._Or,_another_error_is_undefined_symbol_LC_ALL.
   89 
   90 
   91 -------------------------------------------------------------------------------
   92 
   93 
   94 Chapter 1. General Information
   95 
   96 
   97 1.1. What are the requirements to run gFTP?
   98 
   99 
  100 * GTK+ 1.2.3 or higher. GTK+/Glib is included with most systems now. If you
  101   don't have it installed, you may want to check to see if your vendor has a
  102   package available. If not, you can download the latest version of GTK+ and
  103   Glib from ftp://ftp.gtk.org/pub/gtk. gFTP will work with either version 1.2
  104   or 2.x of GTK+, but I would recommend using GTK+ 2.x.
  105 * pthread libraries. Most systems already satisfy this requirement. If you are
  106   on a platform other than Linux, you may want to take a look at the FSU
  107   Pthreads library at http://www.informatik.hu-berlin.de/~mueller/pthreads.
  108 
  109 -------------------------------------------------------------------------------
  110 
  111 1.2. How do I install gFTP?
  112 
  113 
  114 * If you do not want to compile gFTP yourself, you can check my webpage. I have
  115   DEBs for Debian and RPMs for RedHat available. If you're looking for Solaris
  116   binaries, check out http://www.sunfreeware.com.
  117 * If you are compiling gFTP yourself, extract the files from the distribution
  118   with tar -zxvf gftp-<version>.tar.gz
  119 * Go to the gftp-<version> directory and type
  120   ./configure
  121   make
  122   The configure script will generate a Makefile for your machine, and make will
  123   compile a binary for your machine. By default, when you run configure, it
  124   will install gFTP with the prefix /usr/local, so the gFTP binary will be /
  125   usr/local/bin/gftp. You can change this by typing configure --prefix=/usr,
  126   and it will then install the gFTP binary to /usr/bin/gftp.
  127 * If the compile suceeds without any errors, you can type make install to
  128   install the binary. This will also copy some necessary files to <install
  129   prefix>/share/gftp. If you do not have root on your machine to install these
  130   files, copy the contents of the docs/sample.gftp/ directory to ~/.gftp.
  131 * You may want to glance at the USERS-GUIDE file that comes with this
  132   distribution. It contains a little bit of information about how to use it.
  133 
  134 -------------------------------------------------------------------------------
  135 
  136 1.3. What systems is gFTP known to run on?
  137 
  138 I develop gFTP on a Debian GNU/Linux machine. It should run under any other
  139 Linux distributions. Here is a list of other platforms I have received
  140 successful compile reports:
  141 
  142 * FreeBSD/NetBSD/OpenBSD/BSDI
  143 * Solaris
  144 * IRIX
  145 * Digital UNIX
  146 * HP/UX 11
  147 
  148 If gFTP compiles and runs on a platform not listed here, please email me about
  149 it and I'll add it to this list. If you are having problems compiling GTK+ or
  150 gFTP on another platform, try using GNU make instead of your vendor supplied
  151 make.
  152 -------------------------------------------------------------------------------
  153 
  154 1.4. Does gFTP have a SVN repository?
  155 
  156 gFTP is stored in GNOME's SVN repository. For instructions on how to setup your
  157 subversion client, visit the website http://developer.gnome.org/tools/svn.html.
  158 In a nutshell, you will need to run the following command to download the
  159 latest code:
  160 svn co http://svn.gnome.org/svn/gftp/trunk gftp
  161 To compile the SVN code, you will need autoconf, automake and gettext installed
  162 on your system. Once you have those packages installed, run the following
  163 series of commands:
  164 
  165 * Run ./autogen.sh to generate the configure scripts.
  166 * If that is successful, run ./configure to generate the Makefiles. By default,
  167   the binaries will be installed in /usr/local/bin. You can change the install
  168   location by passing the --prefix argument to configure. For example, let's
  169   say you want to install the binaries in /usr/bin. Run configure --prefix=/
  170   usr.
  171 * If that is successful, run make to build the source.
  172 * Optional: If that is successful, run make install to install the binary on
  173   your computer.
  174 
  175 -------------------------------------------------------------------------------
  176 
  177 1.5. How do I report bugs in gFTP?
  178 
  179 If you find ANY bugs in gFTP, please check to make sure that you are using the
  180 latest version of gFTP. If you are, please submit all bug reports to GNOME's
  181 Bugzilla. When sending in bug reports, please try to be as descriptive as
  182 possible. Send me what OS/version you are running, what compiler you are
  183 compiling with, the output of gftp --info and any other important information.
  184 If you get gFTP to crash, it would be very helpful if you could send me a
  185 backtrace. If you do not know how to do a backtrace, download the source code
  186 from my website. Edit the Makefile, and make sure that -g appears in the CFLAGS
  187 variable. Then recompile gFTP, but do NOT run make install because it will
  188 install a stripped binary in $PREFIX/bin. Then type gdb ./gftp. Once you have a
  189 (gdb) prompt, type r. When gFTP crashes, go back to that terminal window, and
  190 type bt, and put that output in the bug that you file with bugzilla.
  191 I also have a gftp-users mailinglist setup. I have a link to the archives on my
  192 main webpage. If it is strictly a bug report, please submit it to Bugzilla
  193 instead of the mailinglist. Bugs that are submitted to bugzilla are much easier
  194 for me to track.
  195 Also, if you do not get a response back from me immediately, that is not
  196 uncommon. I usually stay very busy and I don't get to work on gFTP all of the
  197 time.
  198 -------------------------------------------------------------------------------
  199 
  200 1.6. How do I force running the text or gtk+ version of gFTP?
  201 
  202 To run the text port, you can type gftp-text or to run the gtk+ port, you can
  203 run the gftp-gtk. The gftp command is just a shell script that checks if your
  204 DISPLAY variable is set, and if so it'll run the appropriate version.
  205 -------------------------------------------------------------------------------
  206 
  207 1.7. Is there a way for gFTP to download a bunch of files/directories and then
  208 exit when it's completed?
  209 
  210 Yes, the text port of gFTP supports this well. You can type:
  211 gftp-text -d ftp://ftp.somesite.com/someplace
  212 If someplace is a directory, it'll automatically download all of its
  213 subdirectories as well. If you want to transfer a file through ssh instead of
  214 ftp, just change the ftp:// to ssh://.
  215 -------------------------------------------------------------------------------
  216 
  217 1.8. In the GTK+ version of gFTP, do I have to enter a port, username and
  218 password to connect to a ftp server?
  219 
  220 No you don't. If you leave the port blank, it'll default to the default port
  221 for the protocol you selected (port 21 for FTP). If you leave the username
  222 blank, it will default to logging in as anonymous.
  223 -------------------------------------------------------------------------------
  224 
  225 1.9. Where does gFTP store it's options?
  226 
  227 gFTP will automatically create a ~/.gftp directory when it is first run. Your
  228 config file is ~/.gftp/gftprc, and this is where all of gFTP's settings are
  229 stored. The config file is well commented, so take a glance at it and see if
  230 there is anything you want to change. Your bookmarks are stored in the file
  231 ~/.gftp/bookmarks.
  232 Every time gFTP is run, it will log the contents of the log window to ~/.gftp/
  233 gftp.log. The contents of this file will be automatically purged this file when
  234 gFTP is started up.
  235 -------------------------------------------------------------------------------
  236 
  237 1.10. Why aren't the file sizes comma separated?
  238 
  239 If gFTP was compiled with _GNU_SOURCE defined (run gftp --info), then gFTP will
  240 use the printf() modifier %'ld. If your LANG environment is set to C, then no
  241 commas will be inserted. If you are in the US, change your LANG environment
  242 variable to en_US.
  243 -------------------------------------------------------------------------------
  244 
  245 1.11. When using an external editor, gFTP does not detect changes that are
  246 being made to the file.
  247 
  248 Look at the man page for the editor you are using and see if there is a command
  249 line argument to have the editor run in the foreground (it won't fork to detact
  250 from the current terminal). If you are using one of the graphical VIM editors,
  251 you can add the --nofork argument.
  252 -------------------------------------------------------------------------------
  253 
  254 1.12. How can I increase the size of the fonts in gFTP?
  255 
  256 You can use the gnome-font-properties program to change the fonts used by all
  257 GTK+ 2.x applications.
  258 -------------------------------------------------------------------------------
  259 
  260 1.13. I can't transfer certain file types in binary mode using the FTP
  261 protocol.
  262 
  263 Edit your ~/.gftp/gftprc file and look at the ext= lines towards the bottom of
  264 the file. These lines control what icon is used for each file type. It also
  265 controls what mode is used for the file transfer. For example, to transfer all
  266 HTML files as binary, change the following two lines:
  267 ext=.htm:world.xpm:A:
  268 ext=.html:world.xpm:A:
  269 to the following:
  270 ext=.htm:world.xpm:B:
  271 ext=.html:world.xpm:B:
  272 -------------------------------------------------------------------------------
  273 
  274 
  275 Chapter 2. FTP Protocol
  276 
  277 
  278 2.1. When gFTP tries to get the remote directory listing, the remote server
  279 complains about either the -a or -L argument to LIST.
  280 
  281 If the server is complaining about the -L option, go under FTP->Options->FTP
  282 and disable resolve remote symlinks. If it is complaining about the -a option,
  283 go to FTP->Options->General and disable show hidden files.
  284 -------------------------------------------------------------------------------
  285 
  286 2.2. When gFTP tries to get the remote directory listing, I receive the error:
  287 Cannot create a data connection: Connection refused
  288 
  289 Go under FTP->Options->FTP and turn off passive file transfers. Instead of
  290 sending the PASV command to open up the data connection on the server side, the
  291 data connection will be opened up on the client side, and the PORT command will
  292 be sent to the server instead.
  293 -------------------------------------------------------------------------------
  294 
  295 
  296 Chapter 3. HTTP Protocol
  297 
  298 
  299 3.1. How do I set up my HTTP Proxy server?
  300 
  301 Go under FTP->Options and hit the FTP tab. Enter HTTP as the proxy type and
  302 fill in your proxy server info on that screen. Then hit the HTTP tab and enter
  303 your same proxy server info there.
  304 -------------------------------------------------------------------------------
  305 
  306 
  307 Chapter 4. SSH Protocol
  308 
  309 
  310 4.1. gFTP will not log into the remote SSH server when using a non-English
  311 locale.
  312 
  313 Note: This answer only applies to versions of gFTP >= 2.0.18
  314 You will need to download the source code to gFTP and edit the appropriate po/
  315 <lang>.po file. You will need to make sure the following strings are translated
  316 exactly as they appear in the SSH client.
  317 
  318 * Enter passphrase for RSA key
  319 * Enter passphrase for key
  320 * Password
  321 * password
  322 
  323 Please upload the changes to the PO file to GNOME's SVN or email me the updated
  324 PO file. If you email me the updates, please make sure that you grab the latest
  325 PO file from SVN.
  326 -------------------------------------------------------------------------------
  327 
  328 4.2. I'm having problems getting SSH2 transfers to work. I keep getting the
  329 error: Error: Message size XXXXXXXX too big from server
  330 
  331 Note: This answer only applies to versions of gFTP <= 2.0.17
  332 What probably is the problem, sftp-server isn't in your path on the remote
  333 server. When you try to connect to the remote server, you'll see the command
  334 gFTP is trying to run, and it'll look something like:
  335 ssh -e none -l username hostname "echo -n xsftp ; sftp-server"
  336 Try running this command. If you get a prompt asking:
  337 The authenticity of host 'hostname (###.###.###.###)' can't be established.
  338 RSA key fingerprint is xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx.
  339 Are you sure you want to continue connecting (yes/no)?
  340 Tell it yes. gFTP won't even try to answer this question for you at the moment.
  341 Then, if you get the following output:
  342 Enter passphrase for key '/home/brian/.ssh/id_dsa':
  343 xsftp
  344 bash: sftp-server: command not found
  345 You'll have to set the path to the sftp-server program. Alternatively you could
  346 go under FTP->Options->SSH and enable Use sftp subsys. If you enable this, then
  347 you don't have to know the remote path to your sftp executable. But if you
  348 enable this, gFTP won't be able to send your password over to the ssh client.
  349 So if you're not using ssh-agent, then ssh will spawn the ssh-askpass program
  350 to grab your password.
  351 -------------------------------------------------------------------------------
  352 
  353 4.3. What is the difference between the SSH and SSH2 protocols?
  354 
  355 Note: This answer only applies to versions of gFTP <= 2.0.15
  356 The SSH protocol uses sftp >= 0.7 from http://www.xbill.org/sftp. SSH2 uses the
  357 native file transfers found in the commercial SSH2 and in later versions of
  358 OpenSSH. The SSH2 protocol uses the sftp-server executable on the remote host
  359 and the SSH protocol uses the sftpserv executable.
  360 Note: Due to confusion, the origional SSH protocol was removed in gFTP 2.0.15.
  361 It is not shown in gFTP 2.0.14, but there is a config option called
  362 enable_old_ssh to enable this protocol.
  363 -------------------------------------------------------------------------------
  364 
  365 
  366 Chapter 5. SSL Issues
  367 
  368 
  369 5.1. When using the FTPS or HTTPS protocol, gFTP cannot connect if the remote
  370 server uses a self signed certificate.
  371 
  372 You must add the public key of your self signed CA to your OpenSSL certs
  373 directory. On my Debian box, the OpenSSL certs are installed in /usr/lib/ssl/
  374 certs.
  375 -------------------------------------------------------------------------------
  376 
  377 
  378 Chapter 6. Compiling Problems
  379 
  380 
  381 6.1. When I try to compile gFTP, I see undefined symbol libintl_gettext. Or,
  382 another error is undefined symbol LC_ALL.
  383 
  384 Try running
  385 make distclean ; configure --with-included-gettext.
  386 You could alternatively pass
  387 --disable-nls
  388 to configure, and internationalization support will not be compiled in.