Date: Thu, 25 Sep 1997 13:34:56 -0500 (CDT) From: uhclem@nemesis.lonestar.org To: FreeBSD-gnats-submit@FreeBSD.ORG Subject: docs/4627: Ifconfig media options not documented in de man page FDIV070 Message-ID: <199709251834.NAA18051@handsoff.iadfw.net> Resent-Message-ID: <199709251840.LAA04346@hub.freebsd.org>
next in thread | raw e-mail | index | archive | help
>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: open >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Thu Sep 25 11:40:00 PDT 1997 >Last-Modified: >Originator: Frank Durda >Organization: None >Release: FreeBSD 2.2-970921-RELENG i386 >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. >Audit-Trail: >Unformatted:
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?199709251834.NAA18051>