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

Ftp客户端

开发平台:

Visual C++

  1. gFTP README
  2. -----------
  3. [Requirements]
  4. * GTK+ 1.2.3 or higher. GTK+/Glib is included with most systems now. If you 
  5.   don't have it installed, you may want to check to see if your vendor has a 
  6.   package available. If not, you can download the latest version of GTK+ and 
  7.   Glib from ftp://ftp.gtk.org/pub/gtk. gFTP will work with version 1.2 or 2.0 
  8.   of GTK+, I would suggest using GTK+ 2.0, but installing GTK+ 2.0 does 
  9.   require installing more packages onto your system.
  10. * pthread libraries. If you have a libc6 based machine (Debian >= 2.x, Red Hat 
  11.   >= 5.x), you should already have the pthread libraries installed. If you 
  12.   have a libc5 based machine (Slackware < 7.0), you will need to install 
  13.   LinuxThreads from my website. Also, if you don't have LinuxThreads installed,
  14.   you most likely don't have thread safe X libraries. You must have thread 
  15.   safe X libraries or gFTP will constantly crash. You can download some thread 
  16.   safe X libraries off my website. If you are on a platform other than Linux, 
  17.   you may want to take a look at the FSU Pthreads library at 
  18.   http://www.informatik.hu-berlin.de/~mueller/pthreads.
  19. * I would recommend running X in at least 800x600 mode.
  20. * pkgconfig 0.9.0 or newer.  pkgconfig is available at
  21.   http://www.freedesktop.org/software/pkgconfig.
  22. [Installation Instructions]
  23. * If you do not want to compile this program yourself, you can check my
  24.   webpage. I have DEBs for Debian and RPMs for RedHat available. If you're 
  25.   looking for Solaris binaries, check out http://www.sunfreeware.com
  26. * If you are compiling gFTP yourself, extract the files from the distribution 
  27.   with tar -zxvf gftp-<version>.tar.gz
  28. * Go to the gftp-<version> directory and type 
  29. ./configure
  30. make
  31.   The configure script will generate a Makefile for your machine, and make
  32.   will compile a binary for your machine. By default, when you run
  33.   configure, it will install gFTP with the prefix /usr/local, so the gFTP
  34.   binary will be /usr/local/bin/gftp. You can change this by typing 
  35.   configure --prefix=/usr, and it will then install the gFTP binary in 
  36.   /usr/bin/gftp.
  37. * If the compile suceeds without any errors, you can type make install to 
  38.   install the binary. This will also copy some necessary
  39.   files to <install prefix>/share/gftp. If you do not have root on your 
  40.   machine to install these files, copy the contents of the docs/sample.gftp/ 
  41.   directory to ~/.gftp.
  42. * [OPTIONAL] If you compiled gFTP on a platform other than Linux, could you
  43.   please send me your OS name/version and I will post on my website
  44.   the operating systems gFTP has been successfully compiled on.
  45. * You may want to glance at the USERS-GUIDE file that comes with this
  46.   distribution. It contains a little bit of information about how to use it.
  47. [Frequently Asked Questions]
  48. Here is a list of frequently asked questions about gFTP. You can always find
  49. the latest version of this FAQ off my website.
  50. *******************************************************************************
  51. Q: I'm having problems with installing the RPMs off of your website. 
  52. A: If the RPM installs fine, but when you run gFTP, if you get an error about the symbol GCC_3.0 not found, then you need to recompile the RPM. Or if you try to install the RPM and you get an error about unresolved dependency libreadline.so.1 and you have the readline RPM installed, you'll also have to get a different gFTP RPM. The RPMs on my website I built on a Debian GNU/Linux i386 box with gcc 3.0.3.
  53. I would first suggest checking your distributions development tree (RedHat Rawhide or Mandrake Cooker for example), they probably have a RPM of the latest gFTP there. If not, download the SRC RPM and type rpm -i gftp-version-1.src.rpm. It will build a RPM and put it in /usr/src/redhat/RPMS/arch or /usr/src/rpm/RPMS/arch (arch is i386, sparc, axp, etc...)
  54. *******************************************************************************
  55. Q: What systems is gFTP known to run on?
  56. A: I develop gFTP on a Debian GNU/Linux machine. Here is a list of other 
  57.    platforms I have received successful compile reports on: 
  58.      * FreeBSD/NetBSD/OpenBSD/BSDI
  59.      * Solaris 
  60.      * IRIX
  61.      * Digital UNIX
  62.      * HP/UX 11
  63.    If you got gFTP to compile on a platform not listed here, please email me 
  64.    about it and I'll add it to this list. If you are having problems compiling 
  65.    gtk+ or gFTP on another platform, try using GNU make instead of your vendor 
  66.    supplied make. Most of the vendor supplied makes are brain-dead. 
  67. *******************************************************************************
  68. Q: I'm having problems getting SSH2 transfers to work. I keep getting the error:
  69.    Error: Message size XXXXXXXX too big from server
  70. A: What probably is the problem, sftp-server isn't in your path on the remote
  71.    server. When you try to connect to the remote server, you'll see the command
  72.    gFTP is trying to run, and it'll look something like:
  73.    ssh -e none -l username hostname "echo -n xsftp ;  sftp-server"
  74.    Try running this command. If you get a prompt asking:
  75.    The authenticity of host 'hostname (###.###.###.###)' can't be established.
  76.    RSA key fingerprint is xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx.
  77.    Are you sure you want to continue connecting (yes/no)?
  78.    Tell it yes. gFTP won't even try to answer this question for you at the
  79.    moment. Then, if you get the following output:
  80.    Enter passphrase for key '/home/brian/.ssh/id_dsa':
  81.    xsftp
  82.    bash: sftp-server: command not found
  83.    You'll have to set the path to the sftp-server program. Alternatively you 
  84.    could go under FTP->Options->SSH and enable Use sftp subsys. If you enable
  85.    this, then you don't have to know the remote path to your sftp executable.
  86.    But if you enable this, gFTP won't be able to send your password over to
  87.    the ssh client. So if you're not using ssh-agent, then ssh will spawn the
  88.    ssh-askpass program to grab your password.
  89. *******************************************************************************
  90. Q: What is the difference between the SSH and SSH2 protocols?
  91. A: The SSH protocol uses sftp >= 0.7 from http://www.xbill.org/sftp. SSH2 uses
  92.    the native file transfers found in the commercial SSH2 and in later versions
  93.    of OpenSSH. The SSH2 protocol uses the sftp-server executable on the remote 
  94.    host and the SSH protocol uses the sftpserv executable.
  95. *******************************************************************************
  96. Q: How do I force running the text or gtk+ version of gFTP?
  97. A: To run the text port, you can type gftp-text or to run the gtk+ port, you
  98.    can run the gftp-gtk. The gftp command is just a shell script that sees
  99.    if your DISPLAY variable is set, and if so it'll run the appropriate version
  100. *******************************************************************************
  101. Q: Is there a way for gFTP to download a bunch of files/directories and then
  102.    exit when it's completed?
  103. A: Yes, the text port of gFTP supports this well. You can type:
  104.    gftp-text -d ftp://ftp.somesite.com/someplace
  105.    If someplace is a directory, it'll automatically download all its subdirs
  106.    as well. If you want to transfer a file through ssh instead of ftp, just
  107.    change the ftp:// to ssh://
  108. *******************************************************************************
  109. Q: In the GTK+ version of gFTP, do I have to enter a port, username and password
  110.    to connect to a ftp server?
  111. A: No you don't. If you leave the port blank, it'll default to the default port
  112.    for the protocol you selected (port 21 for FTP). If you leave the username
  113.    blank, it will default to logging in as anonymous
  114. *******************************************************************************
  115. Q: How do I set up my HTTP Proxy server?
  116. A: Go under FTP->Options and hit the FTP tab. Enter HTTP as the proxy type
  117.    and fill in your proxy server info on that screen. Then hit the HTTP tab
  118.    and enter your same proxy server info there.
  119. *******************************************************************************
  120. Q: When gFTP tries to get the remote directory listing, it sends LIST -L, but
  121.    the remote server sends an error back
  122. A: Go to FTP->Options and turn off resolve remote symlinks. gFTP will then send
  123.    LIST instead of LIST -L. You should only have to do this if you are
  124.    connecting to Novell servers.
  125. *******************************************************************************
  126. Q: When gFTP tries to get the remote directory listing, I get an error that
  127.    says: Cannot create a data connection: Connection refused
  128. A: Go under FTP->Options and turn off passive file transfers. Instead of 
  129.    sending the PASV command to open up the data connection on the server side,
  130.    the data connection will be opened up on the client side, and the PORT
  131.    command will be sent to the server instead.
  132. *******************************************************************************
  133. Q: When I try to compile gFTP, I get some errors. One of them is undefined
  134.    symbol LC_ALL
  135. A: Try typing make distclean ; configure --with-included-gettext and it
  136.    should compile fine then. 
  137. *******************************************************************************
  138. Q: How do I report bugs in gFTP?
  139. A: If you find ANY bugs in gFTP, please email them to me at
  140.    masneyb@gftp.org. If there is a newer version of gFTP available,
  141.    please try it first before you send me a bug report. If the problem
  142.    exists in that version, feel free to email me about it. When sending in 
  143.    bug reports, please try to be as descriptive as possible. Send me what 
  144.    OS/version you are running, what compiler you are compiling with, and any 
  145.    other important information. If you get gFTP to crash, it would be very 
  146.    helpful if you could send me a backtrace. If you do not know how to do a 
  147.    backtrace, download the source code from my website. Edit the Makefile,
  148.    and make sure that -g appear in the CFLAGS variable. Then recompile gFTP,
  149.    but do NOT do a make install because it will install a stripped binary in 
  150.    $PREFIX/bin. Then type gdb ./gftp. Once you have a (gdb) prompt, type r.
  151.    Once you get gFTP to crash, go back to that terminal window, and type bt,
  152.    and send me that output in an email message along with a short description
  153.    of how it happened.
  154. *******************************************************************************
  155. Q: I downloaded a binary off the internet and everytime I run gFTP I get an
  156.    error saying: undefined symbol :__register_frame_info
  157. A: ObiTuarY <obituary@freshmeat.net> says:
  158.    "This happens when you compile a library with egcs. The library then has 
  159.    the __register_frame_info symbol. If you link a program to it, it will 
  160.    require this symbol. Now if you have the exact same library compiled with
  161.    gcc 2.7.2.3 it won't have this symbol. The thing about glibc 2.1 under Red 
  162.    Hat 6 is it was compiled with egcs and glibc 2.0.x under Red Hat 5.x was 
  163.    compiled with gcc 2.7.2.3, therefore it's not an incompatibility between 
  164.    glibc 2.0.x and 2.1.x. What some people do for that is they get the .o file 
  165.    of egcs with __register_frame_info in it and link into the program so it's 
  166.    always there, that way it works with libs compiled with egcs or gcc 2.7.2.3.
  167.    (in /usr/lib/gcc-lib/i386-*-linux/egcs-*/ )"
  168.    Another alternative, is to recompile gFTP on your machine, or you can
  169.    download some RPMs off my website that were compiled against Red Hat 5.2.
  170. *******************************************************************************
  171. Q: I upgraded to a newer version of gFTP and now I am getting some warnings
  172.    about some config file lines not having enough arguments, and it cannot find
  173.    html.xpm. 
  174. A: This is from upgrading from a very old version of gFTP to a newer version. 
  175.    I removed some icons from the distribution (0.20 to 0.21). Edit your 
  176.    ~/.gftp/gftprc file. At the bottom of the file, there are some ext= lines. 
  177.    Some of them have html.xpm, rpm.xpm and pdf.xpm. Remove these lines and gFTP 
  178.    will startup fine. Don't worry about fixing he warnings...they will go away 
  179.    themselves.
  180. *******************************************************************************
  181. Q: Where does gFTP store it's options?
  182. A: gFTP will automatically create a ~/.gftp directory when it is first run.
  183.    Your config file is ~/.gftp/gftprc, and this is where all of gFTP's
  184.    settings are stored. The config file is well commented, so take a glance
  185.    at it and see if there is anything you want to change. Your bookmarks are
  186.    stored in the file ~/.gftp/bookmarks
  187. *******************************************************************************
  188. Q: I am trying to compile your program and I get some parse errors before
  189.    GdkDragContext. What's wrong?
  190. A: You have an older version of gtk installed on your system. If you are
  191.    using Red Hat or Debian Linux, simply remove the gtk and glib devel
  192.    packages. You can still leave the gtk 1.0 libraries installed.
  193. *******************************************************************************
  194. Q: I am having a hard time using the drag and drop in gFTP. How do I use it?
  195. A: To drag from the file listboxes in gFTP, you have to drag with button #3.
  196.    On a two button mouse, you have to hold down both buttons. For this to work
  197.    tho, you have to edit your XF86Config file, and go to the Pointer section.
  198.    You have to make sure Emulate3Buttons is in there. Here's the section out of
  199.    my config file:
  200.    Section "Pointer"
  201.       Protocol        "PS/2"             # This will depend on your mouse
  202.       Device          "/dev/mouse"       # This will also depend on your mouse
  203.       Emulate3Buttons                    # You need this for a 2 button mouse
  204.    EndSection
  205. *******************************************************************************
  206. Q: I have a libc 5 based machine and everytime I run gFTP it instantly crashes. 
  207.    I get an error something like: Gdk-ERROR **: an x io error occurred 
  208.    What's wrong?
  209. A: Your X libraries are not thread safe. They must be compiled with 
  210.    -D_REENTRANT. You can either recompile your X libraries, or you can
  211.    download some from my webpage at
  212.    http://www.gftp.org/XFree86-libs-3.3-2_threading.i386.tgz
  213. Brian Masney <masneyb@gftp.org> 
  214. gFTP Official Webpage - http://www.gftp.org/