Skip site navigation (1)Skip section navigation (2)
Date:      Sun, 29 Jan 2017 11:18:44 -0800 (PST)
From:      "Rodney W. Grimes" <freebsd@pdx.rh.CN85.dnsmgr.net>
To:        Meny Yossefi <menyy@mellanox.com>
Cc:        Benjamin Kaduk <kaduk@mit.edu>, "doc@FreeBSD.org" <doc@FreeBSD.org>, "re@FreeBSD.org" <re@FreeBSD.org>, Hans Petter Selasky <hanss@mellanox.com>
Subject:   Re: Mellanox as an HW vendor in FreeBSD 9.x (and above) HW notes
Message-ID:  <201701291918.v0TJIiRl036061@pdx.rh.CN85.dnsmgr.net>
In-Reply-To: <DB3PR05MB08937793E1FF8FE69123224C3480@DB3PR05MB089.eurprd05.prod.outlook.com>

next in thread | previous in thread | raw e-mail | index | archive | help
Having just recently started to play with Mellanox HW I can say that most likely
the cause of not getting in the release notes are there are NO manual pages for
the Mellanox drivers.

So my guess would be the first step is to write section 4 manual pages for
mtcha(4), mlx4(4), mlx5(4), mlx4en(4), mlx4ib(4), ... etc

> Thanks Ben.
> 
> I got no response from re@Freebsd. 
> 
> Is there a specific person you can refer me to? 
> 
> -Meny
> 
> 
> -----Original Message-----
> From: Benjamin Kaduk [mailto:kaduk@mit.edu] 
> Sent: Sunday, January 15, 2017 11:42 PM
> To: Meny Yossefi <menyy@mellanox.com>
> Cc: doc@FreeBSD.org; Hans Petter Selasky <hanss@mellanox.com>; re@FreeBSD.org
> Subject: Re: Mellanox as an HW vendor in FreeBSD 9.x (and above) HW notes
> 
> On Sun, Jan 15, 2017 at 03:38:06PM +0000, Meny Yossefi wrote:
> > Hi,
> > 
> > My name is Meny and I'm leading Mellanox's FreeBSD team these days, developing Ethernet and InfiniBand drivers for our ConnectX NICs.
> > 
> > We came across the FreeBSD 11.0 hardware notes and found that we were not included in the list although we have an Ethernet and InfiniBand driver since FreeBSD 9.1.
> > 
> > https://www.freebsd.org/releases/11.0R/relnotes.html
> > 
> > 
> > Can you please let me know what is the procedure for adding us as a vendor?
> 
> As I understand it, the hardware notes are generated automatically via certain portions of certain manual pages.
> 
> It looks like that takes the form of &hwlist.<drivername>; entities in
> (e.g.) ^/base/head/release/doc/en_US.ISO8859-1/hardware/article.xml, with the hwlist entities being generated by ^/base/head/release/doc/share/misc/man2hwnotes.pl.  I don't know offhand whether mlx5en.4 is formatted properly for that script, but it seems that at a minimum, the &hwlist.mlx5en; entity needs to be added to the release notes sources.
> 
> I've cc'd re@FreeBSD.org, since they have change control over the release notes and would need to make or approve such a change.
> 
> -Ben
> 
> 

-- 
Rod Grimes                                                 rgrimes@freebsd.org



Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201701291918.v0TJIiRl036061>