From patchwork Fri May 21 21:31:13 2010 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Arlin Davis X-Patchwork-Id: 101547 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by demeter.kernel.org (8.14.3/8.14.3) with ESMTP id o4LLVGwm005298 for ; Fri, 21 May 2010 21:31:16 GMT Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752631Ab0EUVbP (ORCPT ); Fri, 21 May 2010 17:31:15 -0400 Received: from mga02.intel.com ([134.134.136.20]:3098 "EHLO mga02.intel.com" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752352Ab0EUVbO convert rfc822-to-8bit (ORCPT ); Fri, 21 May 2010 17:31:14 -0400 Received: from orsmga002.jf.intel.com ([10.7.209.21]) by orsmga101.jf.intel.com with ESMTP; 21 May 2010 14:28:19 -0700 X-ExtLoop1: 1 X-IronPort-AV: E=Sophos;i="4.53,280,1272870000"; d="scan'208";a="520193798" Received: from orsmsx602.amr.corp.intel.com ([10.22.226.211]) by orsmga002.jf.intel.com with ESMTP; 21 May 2010 14:30:32 -0700 Received: from orsmsx506.amr.corp.intel.com ([10.22.226.44]) by orsmsx602.amr.corp.intel.com ([10.22.226.211]) with mapi; Fri, 21 May 2010 14:31:13 -0700 From: "Davis, Arlin R" To: "linux-rdma@vger.kernel.org" , ofw_list Date: Fri, 21 May 2010 14:31:13 -0700 Subject: [PATCH] dapl-2.0: update dat.conf manpage for static configuration options Thread-Topic: [PATCH] dapl-2.0: update dat.conf manpage for static configuration options Thread-Index: Acr5LPAf6cWb2k6HRliQzQGYS7vjdA== Message-ID: Accept-Language: en-US Content-Language: en-US X-MS-Has-Attach: X-MS-TNEF-Correlator: acceptlanguage: en-US MIME-Version: 1.0 Sender: linux-rdma-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-rdma@vger.kernel.org X-Greylist: IP, sender and recipient auto-whitelisted, not delayed by milter-greylist-4.2.3 (demeter.kernel.org [140.211.167.41]); Fri, 21 May 2010 21:31:16 +0000 (UTC) diff --git a/man/dat.conf.5 b/man/dat.conf.5 index 6dee668..8360e92 100644 --- a/man/dat.conf.5 +++ b/man/dat.conf.5 @@ -45,18 +45,63 @@ entry is termed Static Registration. - ia params, IA specific parameters - device name and port - platform params, (not used) .PP -.SH Example netdev entries for OpenFabrics rdma_cm providers, both v1.2 and v2.0 +.SH OpenFabrics RDMA providers: \br + Provider options for both 1.2 and 2.0, each using different CM services + + 1. cma - OpenFabrics rdma_cm - uses rdma_cm services for connections + - requires IPoIB and SA/SM services for IB + - netdev used for device name, without port designation (ia_params) + - Supports any transport rdma_cm supports including IB, iWARP, RoCEE + - libdaplcma.so (1.2), libdaplofa (2.0) + + 2. scm - uDAPL socket based CM - exchanges CM information over sockets + - eliminates the need for rdma_cm, IPoIB, and SA for IB + - verbs device used for device name with port designation (ia_param) + - Supports IB, RoCEE. Doesn't support iWARP + - libdaplscm.so (1.2), libdaploscm (2.0) + + 3. ucm - uDAPL unreliable IB CM - exchanges CM information via IB UD QP's + - eliminates the need for sockets or rdma_cm + - verbs device used for device name with port designation (ia_param) + - Supports IB only, no name service. + - libdaplucm.so (1.2), libdaploucm (2.0) +.PP +.SH Example entries for each OpenFabrics provider +\br + + 1. cma - OpenFarbrics rdma_cm (v1.2 and v2.0 examples) + OpenIB-cma u1.2 nonthreadsafe default libdaplcma.so.1 dapl.1.2 "ib0 0" "" ofa-v2-ib0 u2.0 nonthreadsafe default libdaplofa.so.2 dapl.2.0 "ib0 0" "" + ofa-v2-iwarp u2.0 nonthreadsafe default libdaplofa.so.2 dapl.2.0 "eth2 0" "" + ofa-v2-cma-roe-eth2 u2.0 nonthreadsafe default libdaplofa.so.2 dapl.2.0 "eth2 0" "" + ofa-v2-cma-roe-eth3 u2.0 nonthreadsafe default libdaplofa.so.2 dapl.2.0 "eth3 0" "" - NOTE: The OpenFabrics providers use to specify the device with one of the following: + NOTE: The OpenFabrics CMA providers use to specify the device with one of the following: network address, network hostname, or netdev name; along with port number. - The OpenIB- and ofa-v2- IA names are unique mappings. Reserved for OpenFabrics providers. + 2. scm - uDAPL socket based CM (v1.2 and v2.0 examples) + + OpenIB-mlx4_0-1 u1.2 nonthreadsafe default libdaplscm.so.1 dapl.1.2 "mlx4_0 1" "" + OpenIB-ipath0-1 u1.2 nonthreadsafe default libdaplscm.so.1 dapl.1.2 "ipath0 1" "" + ofa-v2-mlx4_0-1 u2.0 nonthreadsafe default libdaploscm.so.2 dapl.2.0 "mlx4_0 1" "" + ofa-v2-mlx4_0-2 u2.0 nonthreadsafe default libdaploscm.so.2 dapl.2.0 "mlx4_0 2" "" + ofa-v2-mlx4_1-1 u2.0 nonthreadsafe default libdaploscm.so.2 dapl.2.0 "mlx4_1 1" "" + ofa-v2-ehca0-1 u2.0 nonthreadsafe default libdaploscm.so.2 dapl.2.0 "ehca0 1" "" + + 3. ucm - uDAPL unreliable IB CM (not supported in 1.2, v2.0 examples) + + ofa-v2-mlx4_0-1u u2.0 nonthreadsafe default libdaploucm.so.2 dapl.2.0 "mlx4_0 1" "" + ofa-v2-mlx4_0-2u u2.0 nonthreadsafe default libdaploucm.so.2 dapl.2.0 "mlx4_0 2" "" + ofa-v2-ipath0-1u u2.0 nonthreadsafe default libdaploucm.so.2 dapl.2.0 "ipath0 1" "" + ofa-v2-ehca0-1u u2.0 nonthreadsafe default libdaploucm.so.2 dapl.2.0 "ehca0 1" "" + + Note: OpenIB- and ofa-v2- IA names are unique mappings, reserved for OpenFabrics providers. +.PP +The default location for this configuration file is /etc/dat.conf. .PP -The default location for this configuration file is /etc/dat.conf. The file location may be overridden with the environment variable DAT_OVERRIDE=/your_own_directory/your_dat.conf. .PP -.SH "SEE ALSO" +.SH "SEE ALSO" rdma_cm verbs socket .PP