From uhclem@handsoff.iadfw.net  Thu Sep 25 11:35:34 1997
Received: from handsoff.iadfw.net (handsoff.iadfw.net [206.66.13.72])
          by hub.freebsd.org (8.8.7/8.8.7) with ESMTP id LAA04039
          for <FreeBSD-gnats-submit@freebsd.org>; Thu, 25 Sep 1997 11:35:34 -0700 (PDT)
Received: (from uhclem@localhost) by handsoff.iadfw.net (8.7.5/8.7.3) id NAA18051; Thu, 25 Sep 1997 13:34:56 -0500 (CDT)
Message-Id: <199709251834.NAA18051@handsoff.iadfw.net>
Date: Thu, 25 Sep 1997 13:34:56 -0500 (CDT)
From: uhclem@nemesis.lonestar.org
Reply-To: uhclem@nemesis.lonestar.org
To: FreeBSD-gnats-submit@freebsd.org
Subject: Ifconfig media options not documented in de man page  FDIV070
X-Send-Pr-Version: 3.2

>Number:         4627
>Category:       docs
>Synopsis:       Ifconfig media options not documented in de man page FDIV070
>Confidential:   no
>Severity:       non-critical
>Priority:       medium
>Responsible:    freebsd-bugs
>State:          closed
>Quarter:
>Keywords:
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Thu Sep 25 11:40:00 PDT 1997
>Closed-Date:    Fri Sep 26 05:38:41 PDT 1997
>Last-Modified:  Fri Sep 26 05:41:47 PDT 1997
>Originator:     Frank Durda
>Release:        FreeBSD 2.2-970921-RELENG i386
>Organization:
None
>Environment:

FreeBSD 970921-RELENG

>Description:

I have been using Matt Thomas' new version of the DE driver that
supports Full Duplex 10baseT for some months and they have worked fine.
(The full duplex mode for this driver is activated using -link0 link1 -link2
in the ifconfig command.)

However, in this and probably recent RELENG releases, using the link
options to communicate with this driver no longer work, since Matts
code now detects the presence of the if_media ioctls and is trying
to use that mechanism.  Fair enough.  I also find that most of the
Full Duplex support has finally been incorporated into the FreeBSD de
driver, so I switched to that.   But it also ignores the link commands,
so I must use the "media" command to set full duplex.

So, I refer to man ifconfig and find "media", which refers me to the
appropriate interface man page for the parameters allowed for "media".
However, the man page for the DE driver has not been updated (apart from
typos/style) in YEARS, so apart from the source code, there is no
documentation.

(Also, so far I have been unable to get ifconfig de0 media to accept
the parameters listed in the DE source code driver, but that will
be discussed in a different problem report.)

If we are going to break the ability to change settings on drivers,
we should actually document what you are supposed to do now.

>How-To-Repeat:

Read man ifconfig.  Then read man 4 if_de and look for any explanation
of what parameters are accepted by the ifconfig "media" command, as
claimed by the ifconfig man page.

>Fix:
	
Whoever changed this code to do this ifconfig "media" stuff (holy VMS-style
commands, Batman!) needs to document their handywork.


>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: peter 
State-Changed-When: Fri Sep 26 05:38:41 PDT 1997 
State-Changed-Why:  
All media options are completely and utterly driver specific. 

If you take a driver from a third party you should not 
expect the driver that corresponds to the freebsd version to 
document the options that the 3rd party driver happens to implement 
on that particular card.  The 'de' driver (from matt's site) 
has different media options for different cards. 
>Unformatted:
