From nobody@FreeBSD.org  Thu Sep 27 08:28:55 2001
Return-Path: <nobody@FreeBSD.org>
Received: from freefall.freebsd.org (freefall.FreeBSD.org [216.136.204.21])
	by hub.freebsd.org (Postfix) with ESMTP id 521F437B416
	for <freebsd-gnats-submit@FreeBSD.org>; Thu, 27 Sep 2001 08:28:55 -0700 (PDT)
Received: (from nobody@localhost)
	by freefall.freebsd.org (8.11.4/8.11.4) id f8RFStO48749;
	Thu, 27 Sep 2001 08:28:55 -0700 (PDT)
	(envelope-from nobody)
Message-Id: <200109271528.f8RFStO48749@freefall.freebsd.org>
Date: Thu, 27 Sep 2001 08:28:55 -0700 (PDT)
From: Douglas De Couto <decouto@lcs.mit.edu>
To: freebsd-gnats-submit@FreeBSD.org
Subject: ``ip'' man page does not specify byte order for ip header with raw sockets
X-Send-Pr-Version: www-1.0

>Number:         30873
>Category:       docs
>Synopsis:       ``ip'' man page does not specify byte order for ip header with raw sockets
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    jcamou
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Sep 27 08:30:00 PDT 2001
>Closed-Date:    Tue Apr 26 00:55:29 GMT 2005
>Last-Modified:  Tue Apr 26 00:55:29 GMT 2005
>Originator:     Douglas De Couto
>Release:        4.3
>Organization:
MIT LCS
>Environment:
FreeBSD bermuda.lcs.mit.edu 4.3-RELEASE FreeBSD 4.3-RELEASE #0: Wed Sep 19 11:25:11 EDT 2001     decouto@bermuda.lcs.mit.edu:/usr/src/sys/compile/PDOS-BERMUDA  i386
>Description:
There is no easy way to use the man pages figure out how to use raw sockets.  On my system ``apropos raw'' doesn't point me to the ``ip'' man page, which describes raw sockets.  Furthermor, the ``ip'' man page doesn't specify the byte order for the up header fields when the user is supplying the ip header.
>How-To-Repeat:
man ip
apropos raw
>Fix:
1. mention the required byte order in the ``ip'' man page
2. put the word ``raw'' somewhere in the title of the ``ip'' man page
>Release-Note:
>Audit-Trail:

From: Ruslan Ermilov <ru@FreeBSD.ORG>
To: Douglas De Couto <decouto@lcs.mit.edu>
Cc: freebsd-gnats-submit@FreeBSD.ORG
Subject: Re: docs/30873: ``ip'' man page does not specify byte order for ip header with raw sockets
Date: Thu, 27 Sep 2001 18:39:12 +0300

 On Thu, Sep 27, 2001 at 08:28:55AM -0700, Douglas De Couto wrote:
 > 
 > There is no easy way to use the man pages figure out how to use raw sockets.
 > On my system ``apropos raw'' doesn't point me to the ``ip'' man page,
 > which describes raw sockets.  Furthermor, the ``ip'' man page doesn't
 > specify the byte order for the up header fields when the user is supplying
 > the ip header.
 >
 Hmm, the ip.4 manpage, in the ``Raw IP Sockets'' has this info
 in the form of an example.  The only missing item is that the
 ``ip_id'' field (if supplied) should be in network byte order,
 historically.
 
 
 Cheers,
 -- 
 Ruslan Ermilov		Oracle Developer/DBA,
 ru@sunbay.com		Sunbay Software AG,
 ru@FreeBSD.org		FreeBSD committer,
 +380.652.512.251	Simferopol, Ukraine
 
 http://www.FreeBSD.org	The Power To Serve
 http://www.oracle.com	Enabling The Information Age

From: "Douglas S. J. De Couto" <decouto@lcs.mit.edu>
To: ru@FreeBSD.ORG
Cc: freebsd-gnats-submit@FreeBSD.ORG
Subject: Re: docs/30873: ``ip'' man page does not specify byte order for ip header with raw sockets
Date: Thu, 27 Sep 2001 12:00:20 -0400 (EDT)

 > > 
 > > There is no easy way to use the man pages figure out how to use raw sockets.
 > > On my system ``apropos raw'' doesn't point me to the ``ip'' man page,
 > > which describes raw sockets.  Furthermor, the ``ip'' man page doesn't
 > > specify the byte order for the up header fields when the user is supplying
 > > the ip header.
 > >
 > Hmm, the ip.4 manpage, in the ``Raw IP Sockets'' has this info
 > in the form of an example.  The only missing item is that the
 > ``ip_id'' field (if supplied) should be in network byte order,
 > historically.
 
 true it has the information, but it would be nice if ``apropos raw''
 pointed you to this manpage.  also, i guess maybe solaris wants the ip
 header in network byte order (from looking at the traceroute source),
 so it wouldn't hurt to clarify?
 
 it would have helped me anyway.
 
 thanks,
 d
 
 -- 
 Douglas S. J. De Couto    decouto@lcs.mit.edu
 
State-Changed-From-To: open->patched 
State-Changed-By: bms 
State-Changed-When: Tue Jun 15 01:15:53 GMT 2004 
State-Changed-Why:  
Committed to HEAD 

http://www.freebsd.org/cgi/query-pr.cgi?pr=30873 
State-Changed-From-To: patched->closed 
State-Changed-By: keramida 
State-Changed-When: Tue Feb 22 13:32:59 GMT 2005 
State-Changed-Why:  
The RELENG_5 branch was created after this change was committed to HEAD. 
This means that the change is already in 5-STABLE, so there is no need 
to keep this PR open as "patched". 

http://www.freebsd.org/cgi/query-pr.cgi?pr=30873 
State-Changed-From-To: closed->patched 
State-Changed-By: keramida 
State-Changed-When: Tue Feb 22 14:10:34 GMT 2005 
State-Changed-Why:  
The changes may need to be merged to RELENG_4 too. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=30873 
Responsible-Changed-From-To: freebsd-doc->jcamou  
Responsible-Changed-By: jcamou 
Responsible-Changed-When: Fri Apr 22 20:30:55 GMT 2005 
Responsible-Changed-Why:  
I'll make it happen.  

http://www.freebsd.org/cgi/query-pr.cgi?pr=30873 
State-Changed-From-To: patched->closed  
State-Changed-By: jcamou 
State-Changed-When: Tue Apr 26 00:54:52 GMT 2005 
State-Changed-Why:  
The changes have been merged to RELENG_4, thanks. 

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