Debian Codegraph @

doc/html/bug.html

raw
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>