From owner-freebsd-doc@freebsd.org Mon Jan 30 11:15:59 2017 Return-Path: Delivered-To: freebsd-doc@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 60CCFCC8936 for ; Mon, 30 Jan 2017 11:15:59 +0000 (UTC) (envelope-from menyy@mellanox.com) Received: from mailman.ysv.freebsd.org (unknown [127.0.1.3]) by mx1.freebsd.org (Postfix) with ESMTP id 2E7C71CD9 for ; Mon, 30 Jan 2017 11:15:59 +0000 (UTC) (envelope-from menyy@mellanox.com) Received: by mailman.ysv.freebsd.org (Postfix) id 2AD1FCC8935; Mon, 30 Jan 2017 11:15:59 +0000 (UTC) Delivered-To: doc@mailman.ysv.freebsd.org Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:1900:2254:206a::19:1]) by mailman.ysv.freebsd.org (Postfix) with ESMTP id 2A6E1CC8934 for ; Mon, 30 Jan 2017 11:15:59 +0000 (UTC) (envelope-from menyy@mellanox.com) Received: from EUR03-DB5-obe.outbound.protection.outlook.com (mail-eopbgr40062.outbound.protection.outlook.com [40.107.4.62]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-SHA384 (256/256 bits)) (Client CN "mail.protection.outlook.com", Issuer "Microsoft IT SSL SHA2" (verified OK)) by mx1.freebsd.org (Postfix) with ESMTPS id AC8B81CD8; Mon, 30 Jan 2017 11:15:58 +0000 (UTC) (envelope-from menyy@mellanox.com) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=Mellanox.com; s=selector1; h=From:Date:Subject:Message-ID:Content-Type:MIME-Version; bh=VPb6mcSt8974RRZSlmXBHSU2C65YmhwcP6YXdx3L/eU=; b=YWilj4iTs3EaPUt34k1eVbTYidyTPzTtEeuhZDD6+sIAUUtjoI4hMSbDHOWPOZT+2ESI7Tjl1yyXW3W7rxdqpyfiYjJDRRKBskdmI7Sl83So+0IT8vMrmV8km/M5bGFBsPZAmfmRp9tahLQtI1tV7sikZAUWB0VFtEcqMNq9jTk= Received: from DB3PR05MB089.eurprd05.prod.outlook.com (10.255.251.144) by DB6PR0501MB2582.eurprd05.prod.outlook.com (10.168.74.22) with Microsoft SMTP Server (version=TLS1_2, cipher=TLS_ECDHE_RSA_WITH_AES_256_CBC_SHA384_P384) id 15.1.860.13; Mon, 30 Jan 2017 11:15:55 +0000 Received: from DB3PR05MB089.eurprd05.prod.outlook.com ([169.254.8.74]) by DB3PR05MB089.eurprd05.prod.outlook.com ([169.254.8.74]) with mapi id 15.01.0860.026; Mon, 30 Jan 2017 11:15:55 +0000 From: Meny Yossefi To: "rgrimes@FreeBSD.org" CC: Benjamin Kaduk , "doc@FreeBSD.org" , "re@FreeBSD.org" , Hans Petter Selasky Subject: RE: Mellanox as an HW vendor in FreeBSD 9.x (and above) HW notes Thread-Topic: Mellanox as an HW vendor in FreeBSD 9.x (and above) HW notes Thread-Index: AdJvRUQ9n2teuq0fRJKv78x0AR3HRAAMvL0AAq4EssAADQ30AAAhVs6w Date: Mon, 30 Jan 2017 11:15:55 +0000 Message-ID: References: <201701291918.v0TJIiRl036061@pdx.rh.CN85.dnsmgr.net> In-Reply-To: <201701291918.v0TJIiRl036061@pdx.rh.CN85.dnsmgr.net> Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: authentication-results: spf=none (sender IP is ) smtp.mailfrom=menyy@mellanox.com; x-originating-ip: [193.47.165.251] x-microsoft-exchange-diagnostics: 1; DB6PR0501MB2582; 7:i4PkEJl3jAbwdiCw+GEpzVFjD45JaV6R4uJC0s2nqNj/0tadmkZYMNg363HaPkNTteEbaZ8FBxaLNCuJye/enf9sOdx9BHNedFLFDNWXSAC77Ndzgcanq0MZ0QMOI7oFI4J+UBjEo90w6zAG14du0kh17jrb9yiIMrp1BUOKT9vZ0bWdjg5yB06oka4Q04+6oqU18ot3XcFl9p+x+FGLVIvit63f10hPELzQ/edZN19/wnDImhFjWiZZHH/CvtyAmCbUE/pLnjJFf2ZLlCoGPwRjPoIrwTd3wr94hn6UFlRkiEv0S66Z8gRAv11VTDiwMhBz/9nVTvxjFP/sZAMZVet79PCGiXnmNU1guXPnvU/Miw5DGbbCzePFhOC9sIxVGAyVWaHQGQ71YSQfmDlNQbFcw+lgwZ41RJexs8eh/bkEfzEVfSmW54YhV2K0lYTEaRlbnMePqECLoVcgirv1ZA== x-forefront-antispam-report: SFV:SKI; SCL:-1SFV:NSPM; SFS:(10009020)(6009001)(7916002)(39850400002)(39860400002)(39450400003)(39840400002)(39410400002)(189002)(24454002)(377454003)(13464003)(199003)(6916009)(2950100002)(102836003)(6116002)(6436002)(6306002)(97736004)(54906002)(2501003)(86362001)(7696004)(3660700001)(6506006)(110136003)(5660300001)(5640700003)(2351001)(25786008)(9686003)(229853002)(76176999)(101416001)(55016002)(1730700003)(54356999)(50986999)(106356001)(105586002)(555904002)(3846002)(4326007)(99286003)(38730400001)(2900100001)(8676002)(81166006)(81156014)(66066001)(68736007)(122556002)(189998001)(53936002)(3280700002)(107886002)(2906002)(7736002)(33656002)(305945005)(92566002)(74316002)(8936002)(4001430100002); DIR:OUT; SFP:1101; SCL:1; SRVR:DB6PR0501MB2582; H:DB3PR05MB089.eurprd05.prod.outlook.com; FPR:; SPF:None; PTR:InfoNoRecords; MX:1; A:1; LANG:en; x-ms-office365-filtering-correlation-id: a9b73b8d-db80-408e-f8d3-08d449015c0c x-ms-office365-filtering-ht: Tenant x-microsoft-antispam: UriScan:; BCL:0; PCL:0; RULEID:(22001)(48565401076); SRVR:DB6PR0501MB2582; x-microsoft-antispam-prvs: x-exchange-antispam-report-test: UriScan:; x-exchange-antispam-report-cfa-test: BCL:0; PCL:0; RULEID:(6040375)(601004)(2401047)(8121501046)(5005006)(10201501046)(3002001)(6055026)(6041248)(20161123560025)(20161123564025)(20161123562025)(20161123555025)(6072148); SRVR:DB6PR0501MB2582; BCL:0; PCL:0; RULEID:; SRVR:DB6PR0501MB2582; x-forefront-prvs: 0203C93D51 received-spf: None (protection.outlook.com: mellanox.com does not designate permitted sender hosts) spamdiagnosticoutput: 1:99 spamdiagnosticmetadata: NSPM Content-Type: text/plain; charset="us-ascii" Content-Transfer-Encoding: quoted-printable MIME-Version: 1.0 X-OriginatorOrg: Mellanox.com X-MS-Exchange-CrossTenant-originalarrivaltime: 30 Jan 2017 11:15:55.1111 (UTC) X-MS-Exchange-CrossTenant-fromentityheader: Hosted X-MS-Exchange-CrossTenant-id: a652971c-7d2e-4d9b-a6a4-d149256f461b X-MS-Exchange-Transport-CrossTenantHeadersStamped: DB6PR0501MB2582 X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Mon, 30 Jan 2017 11:15:59 -0000 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 Cc: Benjamin Kaduk ; doc@FreeBSD.org; re@FreeBSD.org; Hans P= etter Selasky 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 > Cc: doc@FreeBSD.org; Hans Petter Selasky ;=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.; 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