From nobody@FreeBSD.org  Sat Jan  2 15:04:14 2010
Return-Path: <nobody@FreeBSD.org>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id BEB65106568B
	for <freebsd-gnats-submit@FreeBSD.org>; Sat,  2 Jan 2010 15:04:14 +0000 (UTC)
	(envelope-from nobody@FreeBSD.org)
Received: from www.freebsd.org (www.freebsd.org [IPv6:2001:4f8:fff6::21])
	by mx1.freebsd.org (Postfix) with ESMTP id AE7078FC12
	for <freebsd-gnats-submit@FreeBSD.org>; Sat,  2 Jan 2010 15:04:14 +0000 (UTC)
Received: from www.freebsd.org (localhost [127.0.0.1])
	by www.freebsd.org (8.14.3/8.14.3) with ESMTP id o02F4Ewa016710
	for <freebsd-gnats-submit@FreeBSD.org>; Sat, 2 Jan 2010 15:04:14 GMT
	(envelope-from nobody@www.freebsd.org)
Received: (from nobody@localhost)
	by www.freebsd.org (8.14.3/8.14.3/Submit) id o02F4EAU016709;
	Sat, 2 Jan 2010 15:04:14 GMT
	(envelope-from nobody)
Message-Id: <201001021504.o02F4EAU016709@www.freebsd.org>
Date: Sat, 2 Jan 2010 15:04:14 GMT
From: Yasir <yasir27@mail.ru>
To: freebsd-gnats-submit@FreeBSD.org
Subject: Netcat (nc(1)) manual mistake
X-Send-Pr-Version: www-3.1
X-GNATS-Notify:

>Number:         142243
>Category:       docs
>Synopsis:       Netcat (nc(1)) manual mistake
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    bcr
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sat Jan 02 15:10:04 UTC 2010
>Closed-Date:    Mon Aug 02 16:02:44 UTC 2010
>Last-Modified:  Mon Aug 02 16:02:44 UTC 2010
>Originator:     Yasir
>Release:        7.1-RELEASE
>Organization:
>Environment:
FreeBSD conductor.loc 7.1-RELEASE FreeBSD 7.1-RELEASE #0: Thu Jan  1 14:37:25 UTC 2009     root@logan.cse.buffalo.edu:/usr/obj/usr/src/sys/GENERIC  i386
>Description:
man 1 nc states in TALKING TO SERVERS section:
[..]
For example, to retrieve the home page of a web site:

           $ echo -n "GET / HTTP/1.0\r\n\r\n" | nc host.example.com 80
[..]

But this kind of request often returns either nothing or something irrelevant, maybe due to a strong server implementation (e.g. meets RFCs).
>How-To-Repeat:
According to man one could do the following:

           $ echo "GET / HTTP/1.0\r\n\r\n" | nc example.com 80

But nothing is returned upon request.

Another attempt which also fails:
           $ echo "HEAD / HTTP/1.0\r\n\r\n" | nc ya.ru 80
           <html>
           <head><title>400 Bad Request</title></head>
           <body bgcolor="white">
           <center><h1>400 Bad Request</h1></center>
           <hr><center>nginx</center>
           </body>
           </html>
>Fix:
There should have been used printf(1) instead.
Man should be corrected, namely, sed 's/echo -n/printf/'

>Release-Note:
>Audit-Trail:

From: Yasir Arsanukaev <yarsanukaev@gmail.com>
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/142243: Netcat (nc(1)) manual mistake
Date: Sun, 3 Jan 2010 02:26:45 +1000

 --00032555843a449031047c30f459
 Content-Type: text/plain; charset=UTF-8
 
 While echo in bash(1), sh(1) and csh(1) don't handle '\n' and '\r' properly,
 I've discovered echo works correctly in zsh(1).
 
 Patch is attached and can be applied this way:
 $ patch /usr/src/contrib/netcat/nc.1 < nc.1.diff
 
 The other way is to mention that example works only in zsh.
 
 --00032555843a449031047c30f459
 Content-Type: application/octet-stream; name="nc.1.diff"
 Content-Disposition: attachment; filename="nc.1.diff"
 Content-Transfer-Encoding: base64
 X-Attachment-Id: file0
 
 LS0tIG5jLjEJMjAwOC0xMS0yNSAxMjo1OToyOS4wMDAwMDAwMDAgKzEwMDAKKysrIG5jLjEubmV3
 CTIwMTAtMDEtMDMgMDM6MTg6MzMuMDAwMDAwMDAwICsxMDAwCkBAIC0zMzEsNyArMzMxLDcgQEAK
 IGluIHJlc3BvbnNlIHRvIGNvbW1hbmRzIGlzc3VlZCBieSB0aGUgY2xpZW50LgogRm9yIGV4YW1w
 bGUsIHRvIHJldHJpZXZlIHRoZSBob21lIHBhZ2Ugb2YgYSB3ZWIgc2l0ZToKIC5CZCAtbGl0ZXJh
 bCAtb2Zmc2V0IGluZGVudAotJCBlY2hvIC1uICJHRVQgLyBIVFRQLzEuMFxlclxlblxlclxlbiIg
 fCBuYyBob3N0LmV4YW1wbGUuY29tIDgwCiskIHByaW50ZiAiR0VUIC8gSFRUUC8xLjBcZXJcZW5c
 ZXJcZW4iIHwgbmMgaG9zdC5leGFtcGxlLmNvbSA4MAogLkVkCiAuUHAKIE5vdGUgdGhhdCB0aGlz
 IGFsc28gZGlzcGxheXMgdGhlIGhlYWRlcnMgc2VudCBieSB0aGUgd2ViIHNlcnZlci4K
 --00032555843a449031047c30f459--

From: Doug Barton <dougb@FreeBSD.org>
To: Yasir <yasir27@mail.ru>
Cc: freebsd-gnats-submit@FreeBSD.org
Subject: Re: docs/142243: Netcat (nc(1)) manual mistake
Date: Sat, 02 Jan 2010 10:57:44 -0800

 Yasir wrote:
 >> Fix:
 > There should have been used printf(1) instead.
 > Man should be corrected, namely, sed 's/echo -n/printf/'
 
 
 printf should always work, yes. In our sh and in bash, 'echo -e' will
 also work.
 
 
 hth,
 
 Doug
 
 -- 
 
 	Improve the effectiveness of your Internet presence with
 	a domain name makeover!    http://SupersetSolutions.com/
 
 	Computers are useless. They can only give you answers.
 			-- Pablo Picasso
 
Responsible-Changed-From-To: freebsd-doc->bcr 
Responsible-Changed-By: bcr 
Responsible-Changed-When: Sun Jul 25 13:42:57 UTC 2010 
Responsible-Changed-Why:  
I'm working on that. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=142243 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/142243: commit references a PR
Date: Mon, 26 Jul 2010 18:33:47 +0000 (UTC)

 Author: bcr (doc committer)
 Date: Mon Jul 26 18:33:33 2010
 New Revision: 210511
 URL: http://svn.freebsd.org/changeset/base/210511
 
 Log:
   Use "printf" instead of "echo -n" in an example because it
   should be more compatible for most shells that are out there.
   
   I contacted Philip Guenther at OpenBSD about this PR and he
   corrected the issue in their tree pretty fast.
   
   PR:			docs/142243
   Submitted by:		Yasir (yasir27 at mail dot ru)
   Obtained from:		OpenBSD
   Discussed with:		delphij
   MFC after:		7 days
 
 Modified:
   head/contrib/netcat/nc.1
 
 Modified: head/contrib/netcat/nc.1
 ==============================================================================
 --- head/contrib/netcat/nc.1	Mon Jul 26 18:23:05 2010	(r210510)
 +++ head/contrib/netcat/nc.1	Mon Jul 26 18:33:33 2010	(r210511)
 @@ -27,7 +27,7 @@
  .\"
  .\" $FreeBSD$
  .\"
 -.Dd April 15, 2010
 +.Dd July 3, 2010
  .Dt NC 1
  .Os
  .Sh NAME
 @@ -340,7 +340,7 @@ when it might be necessary to verify wha
  in response to commands issued by the client.
  For example, to retrieve the home page of a web site:
  .Bd -literal -offset indent
 -$ echo -n "GET / HTTP/1.0\er\en\er\en" | nc host.example.com 80
 +$ printf "GET / HTTP/1.0\er\en\er\en" | nc host.example.com 80
  .Ed
  .Pp
  Note that this also displays the headers sent by the web server.
 _______________________________________________
 svn-src-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-src-all
 To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: open->patched 
State-Changed-By: bcr 
State-Changed-When: Mon Jul 26 18:42:37 UTC 2010 
State-Changed-Why:  
The fix based on this PR was incorporated into the OpenBSD tree. 
A commit to our HEAD has been made as a result. Until the MFC is 
through, I'll keep it in this state.  

http://www.freebsd.org/cgi/query-pr.cgi?pr=142243 

From: dfilter@FreeBSD.ORG (dfilter service)
To: bug-followup@FreeBSD.org
Cc:  
Subject: Re: docs/142243: commit references a PR
Date: Mon,  2 Aug 2010 15:55:18 +0000 (UTC)

 Author: bcr (doc committer)
 Date: Mon Aug  2 15:54:59 2010
 New Revision: 210771
 URL: http://svn.freebsd.org/changeset/base/210771
 
 Log:
   MFC r210511:
   
   Use "printf" instead of "echo -n" in an example because it
   should be more compatible for most shells that are out there.
   
   I contacted Philip Guenther at OpenBSD about this PR and he
   corrected the issue in their tree pretty fast.
   
   PR:                 docs/142243
   Submitted by:       Yasir (yasir27 at mail dot ru)
   Obtained from:      OpenBSD
   Discussed with:     delphij
 
 Modified:
   stable/8/contrib/netcat/nc.1
 Directory Properties:
   stable/8/contrib/netcat/   (props changed)
 
 Modified: stable/8/contrib/netcat/nc.1
 ==============================================================================
 --- stable/8/contrib/netcat/nc.1	Mon Aug  2 15:33:16 2010	(r210770)
 +++ stable/8/contrib/netcat/nc.1	Mon Aug  2 15:54:59 2010	(r210771)
 @@ -27,7 +27,7 @@
  .\"
  .\" $FreeBSD$
  .\"
 -.Dd April 15, 2010
 +.Dd July 3, 2010
  .Dt NC 1
  .Os
  .Sh NAME
 @@ -340,7 +340,7 @@ when it might be necessary to verify wha
  in response to commands issued by the client.
  For example, to retrieve the home page of a web site:
  .Bd -literal -offset indent
 -$ echo -n "GET / HTTP/1.0\er\en\er\en" | nc host.example.com 80
 +$ printf "GET / HTTP/1.0\er\en\er\en" | nc host.example.com 80
  .Ed
  .Pp
  Note that this also displays the headers sent by the web server.
 _______________________________________________
 svn-src-all@freebsd.org mailing list
 http://lists.freebsd.org/mailman/listinfo/svn-src-all
 To unsubscribe, send any mail to "svn-src-all-unsubscribe@freebsd.org"
 
State-Changed-From-To: patched->closed 
State-Changed-By: bcr 
State-Changed-When: Mon Aug 2 16:01:08 UTC 2010 
State-Changed-Why:  
MFC is finished, PR closed. Thanks for sending us this issue. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=142243 
>Unformatted:
