annotate README @ 971:95da79b9e637

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