From patchwork Mon Sep 19 15:56:32 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Christoph Hellwig X-Patchwork-Id: 9339827 Return-Path: Received: from mail.wl.linuxfoundation.org (pdx-wl-mail.web.codeaurora.org [172.30.200.125]) by pdx-korg-patchwork.web.codeaurora.org (Postfix) with ESMTP id 514486077A for ; Mon, 19 Sep 2016 15:57:23 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 42FF8294D5 for ; Mon, 19 Sep 2016 15:57:23 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 37AF429545; Mon, 19 Sep 2016 15:57:23 +0000 (UTC) X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on pdx-wl-mail.web.codeaurora.org X-Spam-Level: X-Spam-Status: No, score=-6.9 required=2.0 tests=BAYES_00,RCVD_IN_DNSWL_HI autolearn=ham version=3.3.1 Received: from vger.kernel.org (vger.kernel.org [209.132.180.67]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 7C8CB294D5 for ; Mon, 19 Sep 2016 15:57:22 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S1752399AbcISP5U (ORCPT ); Mon, 19 Sep 2016 11:57:20 -0400 Received: from bombadil.infradead.org ([198.137.202.9]:54282 "EHLO bombadil.infradead.org" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S1752388AbcISP5T (ORCPT ); Mon, 19 Sep 2016 11:57:19 -0400 Received: from [4.28.11.153] (helo=localhost) by bombadil.infradead.org with esmtpsa (Exim 4.85_2 #1 (Red Hat Linux)) id 1bm0wY-0005OP-4S; Mon, 19 Sep 2016 15:57:18 +0000 From: Christoph Hellwig To: jgunthorpe@obsidianresearch.com Cc: linux-rdma@vger.kernel.org Subject: [PATCH 8/9] move srp_daemon documentation to Documentation/ Date: Mon, 19 Sep 2016 08:56:32 -0700 Message-Id: <1474300593-31922-9-git-send-email-hch@lst.de> X-Mailer: git-send-email 2.1.4 In-Reply-To: <1474300593-31922-1-git-send-email-hch@lst.de> References: <1474300593-31922-1-git-send-email-hch@lst.de> X-SRS-Rewrite: SMTP reverse-path rewritten from by bombadil.infradead.org. See http://www.infradead.org/rpr.html Sender: linux-rdma-owner@vger.kernel.org Precedence: bulk List-ID: X-Mailing-List: linux-rdma@vger.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP And drop bits that are outdated or replaced by top-level Documentation. Signed-off-by: Christoph Hellwig --- Documentation/ibsrpdm.md | 41 ++++++++++++++++++++++++ srp_daemon/README | 82 ------------------------------------------------ 2 files changed, 41 insertions(+), 82 deletions(-) create mode 100644 Documentation/ibsrpdm.md delete mode 100644 srp_daemon/README diff --git a/Documentation/ibsrpdm.md b/Documentation/ibsrpdm.md new file mode 100644 index 0000000..0fc544d --- /dev/null +++ b/Documentation/ibsrpdm.md @@ -0,0 +1,41 @@ +# Using ibsrpdm + +ibsrpdm is used for discovering and connecting to SRP SCSI targets on +InfiniBand fabrics. These targets can be accessed with the InfiniBand SRP +initiator module, "ib_srp," included in Linux kernels 2.6.15 and newer. + +To run ibsrpdm, the ib_umad module must be loaded, as well as an appropriate +low-level driver for the installed IB hardware. + +With no command line parameters, ibsrpdm displays information about +SRP targets in human-readable form: + + # ibsrpdm + IO Unit Info: + port LID: 0009 + port GID: fe800000000000000005ad00000013e9 + change ID: 73b0 + max controllers: 0x01 + + controller[ 1] + GUID: 0005ad00000013e7 + vendor ID: 0005ad + device ID: 0005ad + IO class : 0100 + ID: Topspin SRP/FC TCA + service entries: 2 + service[ 0]: 0000000000000066 / SRP.T10:20030003BA27CC7A + service[ 1]: 0000000000000066 / SRP.T10:20030003BA27CF53 + +With the "-c" flag, ibsrpdm displays information in a form that can be +written to the kernel SRP initiators add_target file to connect to the +SRP targets. For example: + + # ibsrpdm -c + id_ext=20030003BA27CC7A,ioc_guid=0005ad00000013e7,dgid=fe800000000000000005ad00000013e9,pkey=ffff,service_id=0000000000000066 + id_ext=20030003BA27CF53,ioc_guid=0005ad00000013e7,dgid=fe800000000000000005ad00000013e9,pkey=ffff,service_id=0000000000000066 + +Given this, the command below will connect to the first target +discovered from the first port of the local HCA device "mthca0": + + # echo -n id_ext=20030003BA27CC7A,ioc_guid=0005ad00000013e7,dgid=fe800000000000000005ad00000013e9,pkey=ffff,service_id=0000000000000066 > /sys/class/infiniband_srp/srp-mthca0-1/add_target diff --git a/srp_daemon/README b/srp_daemon/README deleted file mode 100644 index c44f11c..0000000 --- a/srp_daemon/README +++ /dev/null @@ -1,82 +0,0 @@ -Introduction -============ - -srptools is a package of tools for discovering and connecting to SRP -SCSI targets on InfiniBand fabrics. These targets can be accessed -with the InfiniBand SRP initiator module, "ib_srp," included in Linux -kernels 2.6.15 and newer. - -Using srptools -============== - -srptools currently contains only a single executable, ibsrpdm. To run -ibsrpdm, the ib_umad module must be loaded, as well as an appropriate -low-level driver for the installed IB hardware -- for example, -ib_mthca for a Mellanox HCA, ib_ipath for a QLogic HCA, or hcad_mod -for an IBM eHCA. - -With no command line parameters, ibsrpdm displays information about -SRP targets in human-readable form: - - # ibsrpdm - IO Unit Info: - port LID: 0009 - port GID: fe800000000000000005ad00000013e9 - change ID: 73b0 - max controllers: 0x01 - - controller[ 1] - GUID: 0005ad00000013e7 - vendor ID: 0005ad - device ID: 0005ad - IO class : 0100 - ID: Topspin SRP/FC TCA - service entries: 2 - service[ 0]: 0000000000000066 / SRP.T10:20030003BA27CC7A - service[ 1]: 0000000000000066 / SRP.T10:20030003BA27CF53 - -With the "-c" flag, ibsrpdm displays information in a form that can be -written to the kernel SRP initiators add_target file to connect to the -SRP targets. For example: - - # ibsrpdm -c - id_ext=20030003BA27CC7A,ioc_guid=0005ad00000013e7,dgid=fe800000000000000005ad00000013e9,pkey=ffff,service_id=0000000000000066 - id_ext=20030003BA27CF53,ioc_guid=0005ad00000013e7,dgid=fe800000000000000005ad00000013e9,pkey=ffff,service_id=0000000000000066 - -Given this, the command below will connect to the first target -discovered from the first port of the local HCA device "mthca0": - - # echo -n id_ext=20030003BA27CC7A,ioc_guid=0005ad00000013e7,dgid=fe800000000000000005ad00000013e9,pkey=ffff,service_id=0000000000000066 > /sys/class/infiniband_srp/srp-mthca0-1/add_target - -Reporting bugs -============== - -Bugs should be reported to the OpenIB mailing list -. In your bug report, please include: - - * Information about your system: - - Linux distribution and version - - Linux kernel and version - - InfiniBand hardware and firmware version - - ... any other relevant information - - * How to reproduce the bug. - - * If the bug is a crash, the exact output printed out when the crash - occurred, including any kernel messages produced. - -Submitting patches -================== - -Patches should also be submitted to the OpenIB mailing list -. Please use unified diff form (the -u -option to GNU diff), and include a good description of what your patch -does and why it should be applied. If your patch fixes a bug, please -make sure to describe the bug and how your fix works. - -Please include a change to the ChangeLog file (in standard GNU -changelog format) as part of your patch. - -Make sure that your contribution can be licensed under the same -license as the original code you are patching, and that you have all -necessary permissions to release your work.