From patchwork Wed Sep 21 22:08:48 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jason Gunthorpe X-Patchwork-Id: 9344323 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 0A97D601C2 for ; Wed, 21 Sep 2016 22:32:15 +0000 (UTC) Received: from mail.wl.linuxfoundation.org (localhost [127.0.0.1]) by mail.wl.linuxfoundation.org (Postfix) with ESMTP id 198DC2A2F4 for ; Wed, 21 Sep 2016 22:32:15 +0000 (UTC) Received: by mail.wl.linuxfoundation.org (Postfix, from userid 486) id 0E6212A346; Wed, 21 Sep 2016 22:32:15 +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.8 required=2.0 tests=BAYES_00,DKIM_SIGNED, RCVD_IN_DNSWL_HI,T_DKIM_INVALID 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 A80B72A2F4 for ; Wed, 21 Sep 2016 22:32:14 +0000 (UTC) Received: (majordomo@vger.kernel.org) by vger.kernel.org via listexpand id S934221AbcIUWcN (ORCPT ); Wed, 21 Sep 2016 18:32:13 -0400 Received: from quartz.orcorp.ca ([184.70.90.242]:55480 "EHLO quartz.orcorp.ca" rhost-flags-OK-OK-OK-OK) by vger.kernel.org with ESMTP id S934051AbcIUWcN (ORCPT ); Wed, 21 Sep 2016 18:32:13 -0400 DKIM-Signature: v=1; a=rsa-sha256; q=dns/txt; c=relaxed/relaxed; d=obsidianresearch.com; s=rsa1; h=References:In-Reply-To:Message-Id:Date:Subject:Cc:To:From; bh=TgPAYBgo6aM5zRCd0pfXkYyomFSy4aFCemXoO349+Y4=; b=cdnWBDxDYFT2lMiwP1DeHxe6jI0Hhkkcdg63324sWzVccamlgSoN7WNB3ElS7YijttV2c0dcqp1wqnzyURs/Q1RQCuBK9uCShdomVxyBNE/aglKwggJ+7xrWR4AV88/OVHCqAhjSmXlJg8Vko3jy8v4qJKNpS5aiNokCDN5RjaM=; Received: from [10.0.0.151] (helo=jggl.edm.orcorp.ca) by quartz.orcorp.ca with esmtps (TLS1.2:ECDHE_RSA_AES_128_CBC_SHA256:128) (Exim 4.84_2) (envelope-from ) id 1bmphG-0003vd-SW; Wed, 21 Sep 2016 16:08:54 -0600 From: Jason Gunthorpe To: linux-rdma@vger.kernel.org Cc: Christoph Hellwig Subject: [PATCH 22/23] srp_daemon: Move documentation to Documentation/ Date: Wed, 21 Sep 2016 16:08:48 -0600 Message-Id: <1474495729-17604-23-git-send-email-jgunthorpe@obsidianresearch.com> X-Mailer: git-send-email 2.1.4 In-Reply-To: <1474495729-17604-1-git-send-email-jgunthorpe@obsidianresearch.com> References: <1474495729-17604-1-git-send-email-jgunthorpe@obsidianresearch.com> X-Broken-Reverse-DNS: no host name found for IP address 10.0.0.151 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 From: Christoph Hellwig And drop bits that are outdated or replaced by top-level Documentation. Signed-off-by: Christoph Hellwig Reviewed-by: Bart Van Assche --- 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/srp_daemon/README b/srp_daemon/README deleted file mode 100644 index c44f11c5c51e..000000000000 diff --git a/Documentation/ibsrpdm.md b/Documentation/ibsrpdm.md new file mode 100644 index 000000000000..0fc544d0352a --- /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