Skip site navigation (1)Skip section navigation (2)
Date:      Mon, 30 Jan 2017 11:15:55 +0000
From:      Meny Yossefi <menyy@mellanox.com>
To:        "rgrimes@FreeBSD.org" <rgrimes@FreeBSD.org>
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:  <DB3PR05MB08948944833090B7856CCF4C34B0@DB3PR05MB089.eurprd05.prod.outlook.com>
In-Reply-To: <201701291918.v0TJIiRl036061@pdx.rh.CN85.dnsmgr.net>
References:  <DB3PR05MB08937793E1FF8FE69123224C3480@DB3PR05MB089.eurprd05.prod.outlook.com> <201701291918.v0TJIiRl036061@pdx.rh.CN85.dnsmgr.net>

next in thread | previous in thread | raw e-mail | index | archive | help
We have man page for mlx5en on FreeBSD 10.x, 11.x and 12.x
We also have mlx4en and mlx4ib on 12.x

We'll work on adding the missing man pages.

What would be the next step?

-Meny


-----Original Message-----
From: Rodney W. Grimes [mailto:freebsd@pdx.rh.CN85.dnsmgr.net]=20
Sent: Sunday, January 29, 2017 9:19 PM
To: Meny Yossefi <menyy@mellanox.com>
Cc: Benjamin Kaduk <kaduk@mit.edu>; doc@FreeBSD.org; re@FreeBSD.org; Hans P=
etter Selasky <hanss@mellanox.com>
Subject: Re: Mellanox as an HW vendor in FreeBSD 9.x (and above) HW notes

Having just recently started to play with Mellanox HW I can say that most l=
ikely 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.
>=20
> I got no response from re@Freebsd.=20
>=20
> Is there a specific person you can refer me to?=20
>=20
> -Meny
>=20
>=20
> -----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>;=20
> re@FreeBSD.org
> Subject: Re: Mellanox as an HW vendor in FreeBSD 9.x (and above) HW=20
> notes
>=20
> On Sun, Jan 15, 2017 at 03:38:06PM +0000, Meny Yossefi wrote:
> > Hi,
> >=20
> > My name is Meny and I'm leading Mellanox's FreeBSD team these days, dev=
eloping Ethernet and InfiniBand drivers for our ConnectX NICs.
> >=20
> > We came across the FreeBSD 11.0 hardware notes and found that we were n=
ot included in the list although we have an Ethernet and InfiniBand driver =
since FreeBSD 9.1.
> >=20
> > https://www.freebsd.org/releases/11.0R/relnotes.html
> >=20
> >=20
> > Can you please let me know what is the procedure for adding us as a ven=
dor?
>=20
> As I understand it, the hardware notes are generated automatically via ce=
rtain portions of certain manual pages.
>=20
> 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 properl=
y for that script, but it seems that at a minimum, the &hwlist.mlx5en; enti=
ty needs to be added to the release notes sources.
>=20
> 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.
>=20
> -Ben
>=20
>=20

--=20
Rod Grimes                                                 rgrimes@freebsd.=
org



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