Gentoo Websites Logo
Go to: Gentoo Home Documentation Forums Lists Bugs Planet Store Wiki Get Gentoo!
Bug 112154 - Bad documentation on the qmail-remote-auth patch
Summary: Bad documentation on the qmail-remote-auth patch
Status: RESOLVED UPSTREAM
Alias: None
Product: Gentoo Linux
Classification: Unclassified
Component: New packages (show other bugs)
Hardware: All Linux
: High normal (vote)
Assignee: Qmail Team (OBSOLETE)
URL:
Whiteboard:
Keywords:
Depends on:
Blocks:
 
Reported: 2005-11-11 03:16 UTC by Ciprian Ciubotariu
Modified: 2005-11-13 09:53 UTC (History)
0 users

See Also:
Package list:
Runtime testing required: ---


Attachments

Note You need to log in before you can comment on or make changes to this bug.
Description Ciprian Ciubotariu 2005-11-11 03:16:31 UTC
I've been trying to set up a TLS/AUTHenticated MTA-MTA connection for my company
using qmail. The biggest problem was the AUTH part with the ISPs SMTP server,
since it rejected my supplied credentials.

After a lot of investigation I reached the conclusion that
/usr/share/doc/qmail-1.03-r16/qmail-remote-auth-patch-doc.txt.gz was wrong (from
mail-mta/qmail-1.03-r16 - the stable ebuild on x86) to instruct me to add the
username/password base64-encoded, since they are re-encoded by qmail. This also
raises the issue on how to transmit spaces as part of the username/password,
since the parser in the patch tokenizes the string using ' ' as delimiter. I'd
suggest leaving the original qmail-remote-auth patch (which uses the pre-encoded
credentials) in order to have this possibility too.

Reproducible: Always
Steps to Reproduce:
1. Install mail-mta/qmail-1.03-r16
2. Setup an non TLS connection through a TCP/IP tunnel (or cap with Ethereal) to
a SMTP-AUTH supporting MTA in /var/qmail/control/smtproutes following the docs.
3. Send a mail and decode64 the auth credentials.

Actual Results:  
I got the base64-encoded username/base64-encoded password as credentials.

Expected Results:  
I got the nonencoded username/password as credentials to the remote server.

Actually the patch supports AUTH-LOGIN, thus the credentials should be
base64-encoded. Using the docs with the patched qmail produced credentials
encoded two times. I'm not sure which is correct (should be encoded 2 times???)
since I'm not a SMTP guru etc., so maybe the ISP's server I tested towards was
poorly configured
Comment 1 Jakub Moc (RETIRED) gentoo-dev 2005-11-11 03:40:03 UTC
NOT a Gentoo documentation issue.
Comment 2 Michael Hanselmann (hansmi) (RETIRED) gentoo-dev 2005-11-11 12:11:14 UTC
This documentation is included from upstream, so please bug them. It's true that
it's not base64 encoded.
Comment 3 Ciprian Ciubotariu 2005-11-13 08:27:53 UTC
(In reply to comment #2) 
> This documentation is included from upstream, so please bug them. It's true 
that 
> it's not base64 encoded. 
 
You mean that the original patch has poor documentation? 
Comment 4 Michael Hanselmann (hansmi) (RETIRED) gentoo-dev 2005-11-13 08:56:07 UTC
(In reply to comment #3)
> You mean that the original patch has poor documentation? 

Yes, because Gentoo doesn't install special documentation of the patches but
includes the ones provided by the patch author.
Comment 5 Ciprian Ciubotariu 2005-11-13 09:52:16 UTC
(In reply to comment #4) 
> (In reply to comment #3) 
> > You mean that the original patch has poor documentation?  
>  
> Yes, because Gentoo doesn't install special documentation of the patches but 
> includes the ones provided by the patch author. 
 
After further investigation, here's what I found: 
 
The docs are downloaded explicitly by the ebuild from 
http://www.soffian.org/downloads/qmail/qmail-remote-auth-patch-doc.txt, and the 
only web reference inside is the link to the patch itself. The doc is signed 
"j." (not helpful imho). 
 
The link http://tomclegg.net/qmail/#qmail-remote-auth tells of some 
modifications to the patch (made by "j"ay soffian, modified by tom clegg), and 
the new docs are consistent with the behavior of qmail-remote. I guess the 
ebuild author did not realize that the patch is not the original. 
 
Is there anything more I can do? 
Comment 6 Ciprian Ciubotariu 2005-11-13 09:53:42 UTC
(In reply to comment #5)  
> Is there anything more I can do?   
  
Maybe to mail Tom Clegg about the problem of putting spaces in the 
username/password.