| 1 |
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0//EN"> |
| 2 |
<HTML> |
| 3 |
<HEAD> |
| 4 |
<TITLE>NcFTP Client</TITLE> |
| 5 |
<STYLE TYPE="text/css"> |
| 6 |
h1 { color: black } |
| 7 |
h2 { color: #660000 } |
| 8 |
h3 { color: black } |
| 9 |
h4 { color: black } |
| 10 |
a:link { color: #660000 } |
| 11 |
a.only_for_bots:link { color: white } |
| 12 |
a.only_for_bots:active { color: red } |
| 13 |
a.only_for_bots:visited { color: white } |
| 14 |
p { color: black } |
| 15 |
p.only_for_bots { color: white } |
| 16 |
</STYLE> |
| 17 |
</HEAD> |
| 18 |
<BODY BGCOLOR="white"> |
| 19 |
|
| 20 |
<H2>How to Report Bugs in <I>NcFTP Client</I></H2> |
| 21 |
|
| 22 |
<P>Because each FTP server program has its own quirks and unique |
| 23 |
interpretation of the FTP protocol, most bugs in |
| 24 |
<I>NcFTP Client</I> |
| 25 |
are caused by an unexpected interaction with a particular type of |
| 26 |
server software. |
| 27 |
What helps us fix our own bugs or work-around server bugs is the actual FTP |
| 28 |
protocol dialogue that was exchanged, and we call this a FTP protocol <i>trace</i>. |
| 29 |
|
| 30 |
<P><I>NcFTP Client</i> (the interactive <tt>ncftp</tt> program) |
| 31 |
automatically stores the trace in the file <TT>$HOME/.ncftp/trace</TT>. |
| 32 |
Simply run <tt>ncftp</tt>, recreate the problem, quit the program, and |
| 33 |
inspect the <TT>$HOME/.ncftp/trace</TT> file. |
| 34 |
|
| 35 |
<p> |
| 36 |
The other programs |
| 37 |
(<tt>ncftpget</tt>, |
| 38 |
<tt>ncftpput</tt>, |
| 39 |
etc.) have a special command-line option (<tt>-d</tt>) which saves |
| 40 |
the trace to a log file. For example, if your original command was: |
| 41 |
<p> |
| 42 |
<ul> |
| 43 |
<tt>ncftpget ftp.freebsd.org . /pub/FreeBSD/README.TXT</tt> |
| 44 |
</ul> |
| 45 |
Then here is the same thing, with the trace information saved to |
| 46 |
<tt>/tmp/ncftpget.log</tt>: |
| 47 |
<p> |
| 48 |
<ul> |
| 49 |
<tt>ncftpget -d /tmp/ncftpget.log ftp.freebsd.org . /pub/FreeBSD/README.TXT</tt> |
| 50 |
</ul> |
| 51 |
|
| 52 |
<P>A sample <TT>$HOME/.ncftp/trace</TT> file follows. |
| 53 |
When |
| 54 |
<a href="../../contact/" target=_parent>sending us your bug report</a>, |
| 55 |
please include a trace with your e-mail. |
| 56 |
This will help us diagnose the problem, and recreate the problem as closely |
| 57 |
as possible. |
| 58 |
|
| 59 |
<p> |
| 60 |
<ul> |
| 61 |
<pre>SESSION STARTED at: Wed Aug 27 14:18:41 2003 |
| 62 |
Program Version: NcFTP 3.1.6/102 Aug 25 2003, 08:04 PM |
| 63 |
Library Version: LibNcFTP 3.1.6 (August 24, 2003) |
| 64 |
Process ID: 1174 |
| 65 |
Platform: linux-x86 |
| 66 |
Hostname: pc.example.com (rc=3) |
| 67 |
Terminal: vt100 |
| 68 |
14:18:41 Fw: firewall.example.com Type: 0 User: joseph Pass: ******** Port: 21 |
| 69 |
14:18:41 FwExceptions: .example.com,localhost,localdomain |
| 70 |
14:18:51 > o ftp.example.com |
| 71 |
|
| 72 |
14:18:51 Resolving ftp.example.com... |
| 73 |
14:18:51 Connecting to 172.16.75.25... |
| 74 |
14:18:51 LibNcFTP 3.1.6 (August 24, 2003) compiled for linux-x86 |
| 75 |
14:18:51 Uname: Linux|pc|2.4.20|#2 SMP Mon Feb 17 15:36:45 CST 2003|i686 |
| 76 |
14:18:51 Glibc: 2.2.4 (stable) |
| 77 |
14:18:51 Remote server is running wu-ftpd. |
| 78 |
14:18:51 Logging in... |
| 79 |
14:18:51 220: ftp.example.com FTP server (Version wu-2.6.1-18) ready. |
| 80 |
14:18:51 Connected to 172.16.75.25. |
| 81 |
14:18:51 Cmd: USER anonymous |
| 82 |
14:18:51 331: Guest login ok, send your complete e-mail address as password. |
| 83 |
14:18:51 Cmd: PASS [email protected] |
| 84 |
14:18:51 Logging in... |
| 85 |
14:18:51 230: Guest login ok, access restrictions apply. |
| 86 |
14:18:51 Cmd: PWD |
| 87 |
14:18:51 257: "/" is current directory. |
| 88 |
14:18:51 Logged in to 172.16.75.25 as anonymous. |
| 89 |
14:19:31 > get secretfile.txt |
| 90 |
|
| 91 |
14:19:31 Cmd: SIZE secretfile.txt |
| 92 |
14:19:31 550: secretfile.txt: No such file or directory. |
| 93 |
14:19:31 Cmd: PASV |
| 94 |
14:19:31 227: Entering Passive Mode (172,16,75,25,49,39) |
| 95 |
14:19:31 Cmd: RETR secretfile.txt |
| 96 |
14:19:31 550: secretfile.txt: No such file or directory. |
| 97 |
14:19:44 > quit |
| 98 |
|
| 99 |
14:19:46 Cmd: QUIT |
| 100 |
14:19:46 221: You have transferred 0 bytes in 0 files. |
| 101 |
14:19:46 Total traffic for this session was 1011 bytes in 0 transfers. |
| 102 |
14:19:46 Thank you for using the FTP service on ftp.example.com. |
| 103 |
SESSION ENDED at: Wed Aug 27 14:19:46 2003</pre> |
| 104 |
</ul> |
| 105 |
</BODY> |
| 106 |
</HTML> |