netdev - Re: [RFC 1/8] docs: networking: reorganize driver documentation again

lists.openwall.net		lists / announce owl-users owl-dev john-users john-dev passwdqc-users yescrypt popa3d-users / oss-security kernel-hardening musl sabotage tlsify passwords / crypt-dev xvendor / Bugtraq Full-Disclosure linux-kernel linux-netdev linux-ext4 linux-hardening linux-cve-announce PHC
Open Source and information security mailing list archives

Hash Suite: Windows password security audit tool. GUI, reports in PDF.

[<prev] [next>] [<thread-prev] [thread-next>] [day] [month] [year] [list]

Message-ID: <20200611151842.392642c5@hermes.lan>
Date:   Thu, 11 Jun 2020 15:18:42 -0700
From:   Stephen Hemminger <stephen@...workplumber.org>
To:     "Kirsher, Jeffrey T" <jeffrey.t.kirsher@...el.com>
Cc:     Jakub Kicinski <kuba@...nel.org>,
        "davem@...emloft.net" <davem@...emloft.net>,
        "netdev@...r.kernel.org" <netdev@...r.kernel.org>,
        "linux-doc@...r.kernel.org" <linux-doc@...r.kernel.org>,
        "klassert@...nel.org" <klassert@...nel.org>,
        "akiyano@...zon.com" <akiyano@...zon.com>,
        "irusskikh@...vell.com" <irusskikh@...vell.com>,
        "ioana.ciornei@....com" <ioana.ciornei@....com>,
        "kys@...rosoft.com" <kys@...rosoft.com>,
        "saeedm@...lanox.com" <saeedm@...lanox.com>,
        "jdmason@...zu.us" <jdmason@...zu.us>,
        "snelson@...sando.io" <snelson@...sando.io>,
        "GR-Linux-NIC-Dev@...vell.com" <GR-Linux-NIC-Dev@...vell.com>,
        "stuyoder@...il.com" <stuyoder@...il.com>,
        "sgoutham@...vell.com" <sgoutham@...vell.com>,
        "luobin9@...wei.com" <luobin9@...wei.com>,
        "csully@...gle.com" <csully@...gle.com>,
        "kou.ishizaki@...hiba.co.jp" <kou.ishizaki@...hiba.co.jp>,
        "peppe.cavallaro@...com" <peppe.cavallaro@...com>,
        "chessman@....org" <chessman@....org>
Subject: Re: [RFC 1/8] docs: networking: reorganize driver documentation
 again

On Thu, 11 Jun 2020 21:17:49 +0000
"Kirsher, Jeffrey T" <jeffrey.t.kirsher@...el.com> wrote:

> > -----Original Message-----
> > From: Jakub Kicinski <kuba@...nel.org>
> > Sent: Thursday, June 11, 2020 10:30
> > To: davem@...emloft.net
> > Cc: netdev@...r.kernel.org; linux-doc@...r.kernel.org; Jakub Kicinski
> > <kuba@...nel.org>; klassert@...nel.org; akiyano@...zon.com;
> > irusskikh@...vell.com; ioana.ciornei@....com; kys@...rosoft.com;
> > saeedm@...lanox.com; jdmason@...zu.us; snelson@...sando.io; GR-Linux-
> > NIC-Dev@...vell.com; stuyoder@...il.com; Kirsher, Jeffrey T
> > <jeffrey.t.kirsher@...el.com>; sgoutham@...vell.com; luobin9@...wei.com;
> > csully@...gle.com; kou.ishizaki@...hiba.co.jp; peppe.cavallaro@...com;
> > chessman@....org
> > Subject: [RFC 1/8] docs: networking: reorganize driver documentation again
> > 
> > Organize driver documentation by device type. Most documents
> > have fairly verbose yet uninformative names, so let users
> > first select a well defined device type, and then search for
> > a particular driver.
> > 
> > While at it rename the section from Vendor drivers to
> > Hardware drivers. This seems more accurate, besides people
> > sometimes refer to out-of-tree drivers as vendor drivers.
> > 
> > Signed-off-by: Jakub Kicinski <kuba@...nel.org>


How much of it is still relevant and useful?

The last time I checked, lots of this had bad advice about settings.
And there was lots of drivers documenting what was generic Linux
functionality

And still there were references to old commands like ifconfig or ifenslave.