From patchwork Tue Jan 28 06:21:07 2020 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 7bit X-Patchwork-Submitter: =?utf-8?b?SsO8cmdlbiBHcm/Dnw==?= X-Patchwork-Id: 11353673 Return-Path: Received: from mail.kernel.org (pdx-korg-mail-1.web.codeaurora.org [172.30.200.123]) by pdx-korg-patchwork-2.web.codeaurora.org (Postfix) with ESMTP id 5B3F5139A for ; Tue, 28 Jan 2020 06:22:27 +0000 (UTC) Received: from lists.xenproject.org (lists.xenproject.org [192.237.175.120]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by mail.kernel.org (Postfix) with ESMTPS id 376E32467B for ; Tue, 28 Jan 2020 06:22:27 +0000 (UTC) DMARC-Filter: OpenDMARC Filter v1.3.2 mail.kernel.org 376E32467B Authentication-Results: mail.kernel.org; dmarc=none (p=none dis=none) header.from=suse.com Authentication-Results: mail.kernel.org; spf=none smtp.mailfrom=xen-devel-bounces@lists.xenproject.org Received: from localhost ([127.0.0.1] helo=lists.xenproject.org) by lists.xenproject.org with esmtp (Exim 4.89) (envelope-from ) id 1iwKFO-0001Zy-Jb; Tue, 28 Jan 2020 06:21:14 +0000 Received: from all-amaz-eas1.inumbo.com ([34.197.232.57] helo=us1-amaz-eas2.inumbo.com) by lists.xenproject.org with esmtp (Exim 4.89) (envelope-from ) id 1iwKFM-0001Zt-W8 for xen-devel@lists.xenproject.org; Tue, 28 Jan 2020 06:21:13 +0000 X-Inumbo-ID: 60a67c5e-4196-11ea-8622-12813bfff9fa Received: from mx2.suse.de (unknown [195.135.220.15]) by us1-amaz-eas2.inumbo.com (Halon) with ESMTPS id 60a67c5e-4196-11ea-8622-12813bfff9fa; Tue, 28 Jan 2020 06:21:11 +0000 (UTC) X-Virus-Scanned: by amavisd-new at test-mx.suse.de Received: from relay2.suse.de (unknown [195.135.220.254]) by mx2.suse.de (Postfix) with ESMTP id 29277AD54; Tue, 28 Jan 2020 06:21:10 +0000 (UTC) From: Juergen Gross To: xen-devel@lists.xenproject.org Date: Tue, 28 Jan 2020 07:21:07 +0100 Message-Id: <20200128062107.14334-1-jgross@suse.com> X-Mailer: git-send-email 2.16.4 Subject: [Xen-devel] [PATCH v2] docs: document CONTROL command of xenstore protocol X-BeenThere: xen-devel@lists.xenproject.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: Xen developer discussion List-Unsubscribe: , List-Post: List-Help: List-Subscribe: , Cc: Juergen Gross , Stefano Stabellini , Julien Grall , Wei Liu , Konrad Rzeszutek Wilk , George Dunlap , Andrew Cooper , Ian Jackson MIME-Version: 1.0 Errors-To: xen-devel-bounces@lists.xenproject.org Sender: "Xen-devel" The CONTROL command (former DEBUG command) isn't specified in the xenstore protocol doc. Add it. Signed-off-by: Juergen Gross Acked-by: Wei Liu Acked-by: Ian Jackson --- docs/misc/xenstore.txt | 36 ++++++++++++++++++++++++++++-------- 1 file changed, 28 insertions(+), 8 deletions(-) diff --git a/docs/misc/xenstore.txt b/docs/misc/xenstore.txt index 65570183b6..6f8569d576 100644 --- a/docs/misc/xenstore.txt +++ b/docs/misc/xenstore.txt @@ -318,12 +318,32 @@ SET_TARGET || ---------- Miscellaneous ---------- -DEBUG print||?? sends to debug log -DEBUG print| EINVAL -DEBUG check|?? checks xenstored innards -DEBUG no-op (future extension) - - These requests should not generally be used and may be - withdrawn in the future. - +CONTROL |[|] + Send a control command with optional parameters + () to Xenstore daemon. + + The set of commands and their semantics is implementation + specific and is likely to change from one Xen version to the + next. Out-of-tree users will encounter compatibility issues. + + Current commands are: + check + checks xenstored innards + log|on + turn xenstore logging on + log|off + turn xenstore logging off + logfile| + log to specified file + memreport|[] + print memory statistics to logfile (no + specified) or to specific file + print| + print to syslog (xenstore runs as daemon) or + to console (xenstore runs as stubdom) + help + return list of supported commands for CONTROL + +DEBUG + Deprecated, now named CONTROL