Mercurial > gftp.yaz

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/AUTHORS	Wed Jan 10 23:22:37 2007 +0000
@@ -0,0 +1,1 @@
+Brian Masney <masneyb@gftp.org>
--- a/ChangeLog	Tue Dec 26 13:13:47 2006 +0000
+++ b/ChangeLog	Wed Jan 10 23:22:37 2007 +0000
@@ -1,3 +1,13 @@
+2007-1-10 Brian Masney <masneyb@gftp.org>
+	* AUTHORS README NEWS - added missing files for automake.
+
+	* autogen.sh - added -f flag to the gettext parameters
+
+	* docs/Makefile.am - updated to work with newer versions of automake
+
+	* configure.in - added AC_GNU_SOURCE for gettext. This supresses some
+	errors from autoconf/automake.
+
 2006-11-30 Brian Masney <masneyb@gftp.org>
 	* src/gtk/bookmarks.c (do_make_new) - don't allow creating
 	bookmarks that have an empty description. (closes #367933)
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/README	Wed Jan 10 23:22:37 2007 +0000
@@ -0,0 +1,381 @@
+
+
+gFTP FAQ
+
+
+Brian Masney
+
+This document is intended to answer questions that are likely to be frequently
+asked by users of gFTP.
+-------------------------------------------------------------------------------
+
+
+  Table of Contents
+
+  1. General_Information
+
+
+        1.1. What_are_the_requirements_to_run_gFTP?
+
+        1.2. How_do_I_install_gFTP?
+
+        1.3. What_systems_is_gFTP_known_to_run_on?
+
+        1.4. Does_gFTP_have_a_CVS_repository?
+
+        1.5. How_do_I_report_bugs_in_gFTP?
+
+        1.6. How_do_I_force_running_the_text_or_gtk+_version_of_gFTP?
+
+        1.7. Is_there_a_way_for_gFTP_to_download_a_bunch_of_files/directories
+        and_then_exit_when_it's_completed?
+
+        1.8. In_the_GTK+_version_of_gFTP,_do_I_have_to_enter_a_port,_username
+        and_password_to_connect_to_a_ftp_server?
+
+        1.9. Where_does_gFTP_store_it's_options?
+
+        1.10. Why_aren't_the_file_sizes_comma_separated?
+
+        1.11. When_using_an_external_editor,_gFTP_does_not_detect_changes_that
+        are_being_made_to_the_file.
+
+        1.12. How_can_I_increase_the_size_of_the_fonts_in_gFTP?
+
+        1.13. I_can't_transfer_certain_file_types_in_binary_mode_using_the_FTP
+        protocol.
+
+
+  2. FTP_Protocol
+
+
+        2.1. When_gFTP_tries_to_get_the_remote_directory_listing,_the_remote
+        server_complains_about_either_the_-a_or_-L_argument_to_LIST.
+
+        2.2. When_gFTP_tries_to_get_the_remote_directory_listing,_I_receive_the
+        error:_Cannot_create_a_data_connection:_Connection_refused
+
+
+  3. HTTP_Protocol
+
+
+        3.1. How_do_I_set_up_my_HTTP_Proxy_server?
+
+
+  4. SSH_Protocol
+
+
+        4.1. gFTP_will_not_log_into_the_remote_SSH_server_when_using_a_non-
+        English_locale.
+
+        4.2. I'm_having_problems_getting_SSH2_transfers_to_work._I_keep_getting
+        the_error:_Error:_Message_size_XXXXXXXX_too_big_from_server
+
+        4.3. What_is_the_difference_between_the_SSH_and_SSH2_protocols?
+
+
+  5. SSL_Issues
+
+
+        5.1. When_using_the_FTPS_or_HTTPS_protocol,_gFTP_cannot_connect_if_the
+        remote_server_uses_a_self_signed_certificate.
+
+
+  6. Compiling_Problems
+
+
+        6.1. When_I_try_to_compile_gFTP,_I_see_undefined_symbol
+        libintl_gettext._Or,_another_error_is_undefined_symbol_LC_ALL.
+
+
+-------------------------------------------------------------------------------
+
+
+Chapter 1. General Information
+
+
+1.1. What are the requirements to run gFTP?
+
+
+* GTK+ 1.2.3 or higher. GTK+/Glib is included with most systems now. If you
+  don't have it installed, you may want to check to see if your vendor has a
+  package available. If not, you can download the latest version of GTK+ and
+  Glib from ftp://ftp.gtk.org/pub/gtk. gFTP will work with either version 1.2
+  or 2.x of GTK+, but I would recommend using GTK+ 2.x.
+* pthread libraries. Most systems already satisfy this requirement. If you are
+  on a platform other than Linux, you may want to take a look at the FSU
+  Pthreads library at http://www.informatik.hu-berlin.de/~mueller/pthreads.
+
+-------------------------------------------------------------------------------
+
+1.2. How do I install gFTP?
+
+
+* If you do not want to compile gFTP yourself, you can check my webpage. I have
+  DEBs for Debian and RPMs for RedHat available. If you're looking for Solaris
+  binaries, check out http://www.sunfreeware.com.
+* If you are compiling gFTP yourself, extract the files from the distribution
+  with tar -zxvf gftp-<version>.tar.gz
+* Go to the gftp-<version> directory and type
+  ./configure
+  make
+  The configure script will generate a Makefile for your machine, and make will
+  compile a binary for your machine. By default, when you run configure, it
+  will install gFTP with the prefix /usr/local, so the gFTP binary will be /
+  usr/local/bin/gftp. You can change this by typing configure --prefix=/usr,
+  and it will then install the gFTP binary to /usr/bin/gftp.
+* If the compile suceeds without any errors, you can type make install to
+  install the binary. This will also copy some necessary files to <install
+  prefix>/share/gftp. If you do not have root on your machine to install these
+  files, copy the contents of the docs/sample.gftp/ directory to ~/.gftp.
+* You may want to glance at the USERS-GUIDE file that comes with this
+  distribution. It contains a little bit of information about how to use it.
+
+-------------------------------------------------------------------------------
+
+1.3. What systems is gFTP known to run on?
+
+I develop gFTP on a Debian GNU/Linux machine. It should run under any other
+Linux distributions. Here is a list of other platforms I have received
+successful compile reports:
+
+* FreeBSD/NetBSD/OpenBSD/BSDI
+* Solaris
+* IRIX
+* Digital UNIX
+* HP/UX 11
+
+If gFTP compiles and runs on a platform not listed here, please email me about
+it and I'll add it to this list. If you are having problems compiling GTK+ or
+gFTP on another platform, try using GNU make instead of your vendor supplied
+make.
+-------------------------------------------------------------------------------
+
+1.4. Does gFTP have a CVS repository?
+
+gFTP is stored in GNOME's CVS repository. For instructions on how to setup your
+CVS client, you can visit the webpage http://developer.gnome.org/tools/cvs.html
+for instructions. In a nutshell, you will need to run the following commands
+(this assumes you are using the bash shell):
+export CVSROOT=":pserver:anonymous@anoncvs.gnome.org:/cvs/gnome"
+cvs login
+Just hit enter at the password prompt since there is no password.
+cvs co gftp
+To compile the CVS code, you will need autoconf, automake 1.4 and gettext
+installed on your system. To generate a configure script, you will need to run
+autogen.sh. Once this script is generated, you can follow the normal
+installation instructions.
+-------------------------------------------------------------------------------
+
+1.5. How do I report bugs in gFTP?
+
+If you find ANY bugs in gFTP, please check to make sure that you are using the
+latest version of gFTP. If you are, please submit all bug reports to GNOME's
+Bugzilla. When sending in bug reports, please try to be as descriptive as
+possible. Send me what OS/version you are running, what compiler you are
+compiling with, the output of gftp --info and any other important information.
+If you get gFTP to crash, it would be very helpful if you could send me a
+backtrace. If you do not know how to do a backtrace, download the source code
+from my website. Edit the Makefile, and make sure that -g appears in the CFLAGS
+variable. Then recompile gFTP, but do NOT run make install because it will
+install a stripped binary in $PREFIX/bin. Then type gdb ./gftp. Once you have a
+(gdb) prompt, type r. When gFTP crashes, go back to that terminal window, and
+type bt, and put that output in the bug that you file with bugzilla.
+I also have a gftp-users mailinglist setup. I have a link to the archives on my
+main webpage. If it is strictly a bug report, please submit it to Bugzilla
+instead of the mailinglist. Bugs that are submitted to bugzilla are much easier
+for me to track.
+Also, if you do not get a response back from me immediately, that is not
+uncommon. I usually stay very busy and I don't get to work on gFTP all of the
+time.
+-------------------------------------------------------------------------------
+
+1.6. How do I force running the text or gtk+ version of gFTP?
+
+To run the text port, you can type gftp-text or to run the gtk+ port, you can
+run the gftp-gtk. The gftp command is just a shell script that checks if your
+DISPLAY variable is set, and if so it'll run the appropriate version.
+-------------------------------------------------------------------------------
+
+1.7. Is there a way for gFTP to download a bunch of files/directories and then
+exit when it's completed?
+
+Yes, the text port of gFTP supports this well. You can type:
+gftp-text -d ftp://ftp.somesite.com/someplace
+If someplace is a directory, it'll automatically download all of its
+subdirectories as well. If you want to transfer a file through ssh instead of
+ftp, just change the ftp:// to ssh://.
+-------------------------------------------------------------------------------
+
+1.8. In the GTK+ version of gFTP, do I have to enter a port, username and
+password to connect to a ftp server?
+
+No you don't. If you leave the port blank, it'll default to the default port
+for the protocol you selected (port 21 for FTP). If you leave the username
+blank, it will default to logging in as anonymous.
+-------------------------------------------------------------------------------
+
+1.9. Where does gFTP store it's options?
+
+gFTP will automatically create a ~/.gftp directory when it is first run. Your
+config file is ~/.gftp/gftprc, and this is where all of gFTP's settings are
+stored. The config file is well commented, so take a glance at it and see if
+there is anything you want to change. Your bookmarks are stored in the file
+~/.gftp/bookmarks.
+Every time gFTP is run, it will log the contents of the log window to ~/.gftp/
+gftp.log. The contents of this file will be automatically purged this file when
+gFTP is started up.
+-------------------------------------------------------------------------------
+
+1.10. Why aren't the file sizes comma separated?
+
+If gFTP was compiled with _GNU_SOURCE defined (run gftp --info), then gFTP will
+use the printf() modifier %'ld. If your LANG environment is set to C, then no
+commas will be inserted. If you are in the US, change your LANG environment
+variable to en_US.
+-------------------------------------------------------------------------------
+
+1.11. When using an external editor, gFTP does not detect changes that are
+being made to the file.
+
+Look at the man page for the editor you are using and see if there is a command
+line argument to have the editor run in the foreground (it won't fork to detact
+from the current terminal). If you are using one of the graphical VIM editors,
+you can add the --nofork argument.
+-------------------------------------------------------------------------------
+
+1.12. How can I increase the size of the fonts in gFTP?
+
+You can use the gnome-font-properties program to change the fonts used by all
+GTK+ 2.x applications.
+-------------------------------------------------------------------------------
+
+1.13. I can't transfer certain file types in binary mode using the FTP
+protocol.
+
+Edit your ~/.gftp/gftprc file and look at the ext= lines towards the bottom of
+the file. These lines control what icon is used for each file type. It also
+controls what mode is used for the file transfer. For example, to transfer all
+HTML files as binary, change the following two lines:
+ext=.htm:world.xpm:A:
+ext=.html:world.xpm:A:
+to the following:
+ext=.htm:world.xpm:B:
+ext=.html:world.xpm:B:
+-------------------------------------------------------------------------------
+
+
+Chapter 2. FTP Protocol
+
+
+2.1. When gFTP tries to get the remote directory listing, the remote server
+complains about either the -a or -L argument to LIST.
+
+If the server is complaining about the -L option, go under FTP->Options->FTP
+and disable resolve remote symlinks. If it is complaining about the -a option,
+go to FTP->Options->General and disable show hidden files.
+-------------------------------------------------------------------------------
+
+2.2. When gFTP tries to get the remote directory listing, I receive the error:
+Cannot create a data connection: Connection refused
+
+Go under FTP->Options->FTP and turn off passive file transfers. Instead of
+sending the PASV command to open up the data connection on the server side, the
+data connection will be opened up on the client side, and the PORT command will
+be sent to the server instead.
+-------------------------------------------------------------------------------
+
+
+Chapter 3. HTTP Protocol
+
+
+3.1. How do I set up my HTTP Proxy server?
+
+Go under FTP->Options and hit the FTP tab. Enter HTTP as the proxy type and
+fill in your proxy server info on that screen. Then hit the HTTP tab and enter
+your same proxy server info there.
+-------------------------------------------------------------------------------
+
+
+Chapter 4. SSH Protocol
+
+
+4.1. gFTP will not log into the remote SSH server when using a non-English
+locale.
+
+Note: This answer only applies to versions of gFTP >= 2.0.18
+You will need to download the source code to gFTP and edit the appropriate po/
+<lang>.po file. You will need to make sure the following strings are translated
+exactly as they appear in the SSH client.
+
+* Enter passphrase for RSA key
+* Enter passphrase for key
+* Password
+* password
+
+Please upload the changes to the PO file to GNOME's CVS or email me the updated
+PO file. If you email me the updates, please make sure that you grab the latest
+PO file from CVS.
+-------------------------------------------------------------------------------
+
+4.2. I'm having problems getting SSH2 transfers to work. I keep getting the
+error: Error: Message size XXXXXXXX too big from server
+
+Note: This answer only applies to versions of gFTP <= 2.0.17
+What probably is the problem, sftp-server isn't in your path on the remote
+server. When you try to connect to the remote server, you'll see the command
+gFTP is trying to run, and it'll look something like:
+ssh -e none -l username hostname "echo -n xsftp ; sftp-server"
+Try running this command. If you get a prompt asking:
+The authenticity of host 'hostname (###.###.###.###)' can't be established.
+RSA key fingerprint is xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx:xx.
+Are you sure you want to continue connecting (yes/no)?
+Tell it yes. gFTP won't even try to answer this question for you at the moment.
+Then, if you get the following output:
+Enter passphrase for key '/home/brian/.ssh/id_dsa':
+xsftp
+bash: sftp-server: command not found
+You'll have to set the path to the sftp-server program. Alternatively you could
+go under FTP->Options->SSH and enable Use sftp subsys. If you enable this, then
+you don't have to know the remote path to your sftp executable. But if you
+enable this, gFTP won't be able to send your password over to the ssh client.
+So if you're not using ssh-agent, then ssh will spawn the ssh-askpass program
+to grab your password.
+-------------------------------------------------------------------------------
+
+4.3. What is the difference between the SSH and SSH2 protocols?
+
+Note: This answer only applies to versions of gFTP <= 2.0.15
+The SSH protocol uses sftp >= 0.7 from http://www.xbill.org/sftp. SSH2 uses the
+native file transfers found in the commercial SSH2 and in later versions of
+OpenSSH. The SSH2 protocol uses the sftp-server executable on the remote host
+and the SSH protocol uses the sftpserv executable.
+Note: Due to confusion, the origional SSH protocol was removed in gFTP 2.0.15.
+It is not shown in gFTP 2.0.14, but there is a config option called
+enable_old_ssh to enable this protocol.
+-------------------------------------------------------------------------------
+
+
+Chapter 5. SSL Issues
+
+
+5.1. When using the FTPS or HTTPS protocol, gFTP cannot connect if the remote
+server uses a self signed certificate.
+
+You must add the public key of your self signed CA to your OpenSSL certs
+directory. On my Debian box, the OpenSSL certs are installed in /usr/lib/ssl/
+certs.
+-------------------------------------------------------------------------------
+
+
+Chapter 6. Compiling Problems
+
+
+6.1. When I try to compile gFTP, I see undefined symbol libintl_gettext. Or,
+another error is undefined symbol LC_ALL.
+
+Try running
+make distclean ; configure --with-included-gettext.
+You could alternatively pass
+--disable-nls
+to configure, and internationalization support will not be compiled in.
--- a/autogen.sh	Tue Dec 26 13:13:47 2006 +0000
+++ b/autogen.sh	Wed Jan 10 23:22:37 2007 +0000
@@ -67,7 +67,7 @@
 if test -z "$intl"; then
 	GETTEXTIZE_FLAGS="-c"
 else
-	GETTEXTIZE_FLAGS="-c --intl"
+	GETTEXTIZE_FLAGS="-c --intl -f"
 fi

 echo "$GETTEXTIZE $GETTEXTIZE_FLAGS"
--- a/configure.in	Tue Dec 26 13:13:47 2006 +0000
+++ b/configure.in	Wed Jan 10 23:22:37 2007 +0000
@@ -30,6 +30,7 @@

 ALL_LINGUAS="ar am ar az be bg bn ca cs da de dz el en_CA en_GB es fi fr ga gl he hr hu it ja ko lt lv mk ml ms nb ne nl pa pl pt pt_BR ro ru rw sk sq sr sr@Latn sv ta th tr uk zh_CN zh_HK zh_TW"

+AC_GNU_SOURCE
 AC_CANONICAL_HOST
 AC_PROG_CC
 AC_AIX
--- a/docs/Makefile.am	Tue Dec 26 13:13:47 2006 +0000
+++ b/docs/Makefile.am	Wed Jan 10 23:22:37 2007 +0000
@@ -11,43 +11,37 @@
 Iconsdir = $(datadir)/pixmaps
 Icons_DATA = gftp.png

-if HAVE_DOCBOOK
+html:
+	if HAVE_DOCBOOK
+		if test -w $(srcdir); then \
+			(cd $(srcdir); \
+			db2html -u gftp-faq.sgml); \
+		fi
+	else
+		echo "*** Warning: FAQ not built"

-html:
-	if test -w $(srcdir); then \
-		(cd $(srcdir); \
-		db2html -u gftp-faq.sgml); \
-	fi
+	endif

 pdf:
-	if test -w $(srcdir); then \
-		(cd $(srcdir); db2pdf gftp-faq.sgml); \
-	fi
+	if HAVE_DOCBOOK
+		if test -w $(srcdir); then \
+			(cd $(srcdir); db2pdf gftp-faq.sgml); \
+		fi
+	else
+		echo "*** Warning: FAQ not built"
+	endif

 clean:
 	rm -rf gftp-faq gftp-faq.junk gftp-faq.pdf

 dist-hook: html
-	cp $(srcdir)/gftp-faq/gftp-faq.html $(distdir)/../README.html
-	html2text -nobs -o $(distdir)/../README -style pretty $(srcdir)/gftp-faq/gftp-faq.html
-
-else
-
-html:
-	echo "***"
-	echo "*** Warning: FAQ not built"
-	echo "***"
+	if HAVE_DOCBOOK
+		cp $(srcdir)/gftp-faq/gftp-faq.html $(distdir)/../README.html
+		html2text -nobs -o $(distdir)/../README -style pretty $(srcdir)/gftp-faq/gftp-faq.html
+	else
+		echo "***"
+		echo "*** Warning: FAQ not built"
+		echo "*** DISTRIBUTION IS INCOMPLETE"
+		echo "***"
+	endif

-pdf:
-	echo "***"
-	echo "*** Warning: FAQ not built"
-	echo "***"
-
-dist-hook:
-	echo "***"
-	echo "*** Warning: FAQ not built"
-	echo "*** DISTRIBUTION IS INCOMPLETE"
-	echo "***"
-
-endif
-