From patchwork Wed Feb 17 17:20:59 2016 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: Jim Fehlig X-Patchwork-Id: 8341701 Return-Path: X-Original-To: patchwork-xen-devel@patchwork.kernel.org Delivered-To: patchwork-parsemail@patchwork1.web.kernel.org Received: from mail.kernel.org (mail.kernel.org [198.145.29.136]) by patchwork1.web.kernel.org (Postfix) with ESMTP id 9C4FE9F372 for ; Wed, 17 Feb 2016 17:23:05 +0000 (UTC) Received: from mail.kernel.org (localhost [127.0.0.1]) by mail.kernel.org (Postfix) with ESMTP id C9742202AE for ; Wed, 17 Feb 2016 17:23:03 +0000 (UTC) Received: from lists.xen.org (lists.xenproject.org [50.57.142.19]) (using TLSv1 with cipher AES256-SHA (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id BB793203AE for ; Wed, 17 Feb 2016 17:23:02 +0000 (UTC) Received: from localhost ([127.0.0.1] helo=lists.xen.org) by lists.xen.org with esmtp (Exim 4.72) (envelope-from ) id 1aW5n0-0000tl-7z; Wed, 17 Feb 2016 17:21:22 +0000 Received: from mail6.bemta5.messagelabs.com ([195.245.231.135]) by lists.xen.org with esmtp (Exim 4.72) (envelope-from ) id 1aW5my-0000qn-9C for xen-devel@lists.xen.org; Wed, 17 Feb 2016 17:21:20 +0000 Received: from [85.158.139.211] by server-2.bemta-5.messagelabs.com id 3B/40-21594-F0CA4C65; Wed, 17 Feb 2016 17:21:19 +0000 X-Env-Sender: jfehlig@suse.com X-Msg-Ref: server-11.tower-206.messagelabs.com!1455729677!10832427!1 X-Originating-IP: [137.65.250.81] X-SpamReason: No, hits=0.0 required=7.0 tests= X-StarScan-Received: X-StarScan-Version: 7.35.1; banners=-,-,- X-VirusChecked: Checked Received: (qmail 6020 invoked from network); 17 Feb 2016 17:21:18 -0000 Received: from smtp2.provo.novell.com (HELO smtp2.provo.novell.com) (137.65.250.81) by server-11.tower-206.messagelabs.com with DHE-RSA-AES256-GCM-SHA384 encrypted SMTP; 17 Feb 2016 17:21:18 -0000 Received: from talkeetna.gns.novell.com (prv-ext-foundry1int.gns.novell.com [137.65.251.240]) by smtp2.provo.novell.com with ESMTP (NOT encrypted); Wed, 17 Feb 2016 10:21:13 -0700 From: Jim Fehlig To: xen-devel@lists.xen.org Date: Wed, 17 Feb 2016 10:20:59 -0700 Message-Id: <1455729659-7885-4-git-send-email-jfehlig@suse.com> X-Mailer: git-send-email 2.1.4 In-Reply-To: <1455729659-7885-1-git-send-email-jfehlig@suse.com> References: <1455729659-7885-1-git-send-email-jfehlig@suse.com> Cc: wei.liu2@citrix.com, Jim Fehlig , ian.jackson@eu.citrix.com, ian.campbell@citrix.com Subject: [Xen-devel] [PATCH V2 3/3] docs: add more info about target= in disk config X-BeenThere: xen-devel@lists.xen.org X-Mailman-Version: 2.1.13 Precedence: list List-Id: Xen developer discussion List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , MIME-Version: 1.0 Sender: xen-devel-bounces@lists.xen.org Errors-To: xen-devel-bounces@lists.xen.org X-Spam-Status: No, score=-4.2 required=5.0 tests=BAYES_00, RCVD_IN_DNSWL_MED, UNPARSEABLE_RELAY autolearn=unavailable version=3.3.1 X-Spam-Checker-Version: SpamAssassin 3.3.1 (2010-03-16) on mail.kernel.org X-Virus-Scanned: ClamAV using ClamSMTP target= in disk config can be used to convey arbitrary configuration information to backends. Add a bit more info to xl-disk-configuration.txt to clarify this, including some simple nbd and rbd qdisk configurations. Signed-off-by: Jim Fehlig Acked-by: Ian Campbell --- docs/misc/xl-disk-configuration.txt | 10 +++++++++- 1 file changed, 9 insertions(+), 1 deletion(-) diff --git a/docs/misc/xl-disk-configuration.txt b/docs/misc/xl-disk-configuration.txt index 29f6ddb..79f1e4a 100644 --- a/docs/misc/xl-disk-configuration.txt +++ b/docs/misc/xl-disk-configuration.txt @@ -75,7 +75,15 @@ Special syntax: the target was already specified as a positional parameter. This is the only way to specify a target string containing metacharacters such as commas and (in some cases) colons, which would otherwise be - misinterpreted. + misinterpreted. Meta-information in a target string can be used to + specify configuration information for a qdisk block backend. For + example the nbd and rbd qdisk block backends can be configured with + + target=nbd:192.168.0.1:5555 + target=rbd:pool/image:mon_host=192.186.0.1\\:6789 + + Note that '\' is used to escape metacharacters. Literal backslashes + in target= strings must use '\\'. Future parameter and flag names will start with an ascii letter and contain only ascii alphanumerics, hyphens and underscores, and will