From nobody@FreeBSD.org  Sat Jun 16 18:57:58 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 7A30837B403
	for <freebsd-gnats-submit@FreeBSD.org>; Sat, 16 Jun 2001 18:57:57 -0700 (PDT)
	(envelope-from nobody@FreeBSD.org)
Received: (from nobody@localhost)
	by freefall.freebsd.org (8.11.3/8.11.3) id f5H1vvF13511;
	Sat, 16 Jun 2001 18:57:57 -0700 (PDT)
	(envelope-from nobody)
Message-Id: <200106170157.f5H1vvF13511@freefall.freebsd.org>
Date: Sat, 16 Jun 2001 18:57:57 -0700 (PDT)
From: Matt COwger <mcowger@bowdoin.edu>
To: freebsd-gnats-submit@FreeBSD.org
Subject: Incorrect/misleading documentation for arp -s
X-Send-Pr-Version: www-1.0

>Number:         28215
>Category:       docs
>Synopsis:       Incorrect/misleading documentation for arp -s
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Sat Jun 16 19:00:02 PDT 2001
>Closed-Date:    Sat Jun 16 23:42:35 PDT 2001
>Last-Modified:  Sat Jun 16 23:42:49 PDT 2001
>Originator:     Matt COwger
>Release:        4.3-R
>Organization:
Bowdoin College
>Environment:
FreeBSD blondie.bowdoin.edu 4.3-RELEASE FreeBSD 4.3-RELEASE #0: Wed May  2 22:11:53 EDT 2001     mcowger@diablo.bowdoin.edu:/usr/obj/usr/src/sys/BLONDIE  i386
>Description:
According to the man page for arp(8):

-s hostname ether_addr
Create an ARP entry for the host called hostname with the Ether-net address ether_addr.  The Ethernet address is given as six hex
bytes separated by colons.

However, the hostname is NOT a valid argument, one must supply an IP address.  Hence, the documentation shoudl be changed to:

-s ip ether_addr

or something along those lines.
>How-To-Repeat:
see above
>Fix:
see above.
>Release-Note:
>Audit-Trail:

From: bem@atlanta-bsd.org
To: freebsd-gnats-submit@FreeBSD.org, mcowger@bowdoin.edu
Cc:  
Subject: Re: docs/28215: Incorrect/misleading documentation for arp
Date: Sat, 16 Jun 2001 23:25:42 -0400 (EDT)

 I was unable to verify this. As long as the hostname is in /etc/hosts, it works
 for me. I did not try a dns name, though. See example output:
 
 bandicoot# arp -s bandicoot 00:d0:b7:1d:7c:06
 bandicoot# uname -a
 FreeBSD bandicoot.atlanta-bsd.org 4.3-RELEASE FreeBSD 4.3-RELEASE #2: Sat Jun 16 17:19:24 EDT 2001     root@bandicoot.atlanta-bsd.org:/usr/src/sys/compile/GENERIC  i386
 bandicoot# arp -an
 ? (192.168.0.1) at 0:10:5a:1b:ef:d9 [ethernet]
 ? (192.168.0.3) at 0:10:b5:4b:17:ca [ethernet]
 ? (192.168.0.4) at 0:d0:b7:1d:7c:6 permanent [ethernet]
 bandicoot# cat /etc/hosts
 127.0.0.1               localhost localhost.atlanta-bsd.org
 192.168.0.4             bandicoot bandicoot.atlanta-bsd.org
 
 bandicoot# 
 
 
State-Changed-From-To: open->closed 
State-Changed-By: dd 
State-Changed-When: Sat Jun 16 23:42:35 PDT 2001 
State-Changed-Why:  
Originator reports pilot error. 

http://www.FreeBSD.org/cgi/query-pr.cgi?pr=28215 
>Unformatted:
