From 72ad93f00de779866d9a96692b302301ed8e59b2 Mon Sep 17 00:00:00 2001 From: Dave Allan Date: Mon, 1 Oct 2012 14:01:36 -0400 Subject: [PATCH] Add note about numeric domain names to manpage Clarify that domains with numeric names can only be identified by their domain id. (cherry picked from commit 13c69cd0b446669dc53417cb5207c51167a9c14f) --- tools/virsh.pod | 16 ++++++++++------ 1 file changed, 10 insertions(+), 6 deletions(-) diff --git a/tools/virsh.pod b/tools/virsh.pod index 2120429bfb..c02ffe8232 100644 --- a/tools/virsh.pod +++ b/tools/virsh.pod @@ -26,12 +26,16 @@ The basic structure of most virsh usage is: virsh [OPTION]... [ARG]... -Where I is one of the commands listed below, I is the numeric -domain id, or the domain name, or the domain UUID and I are command -specific options. There are a few exceptions to this rule in the cases where -the command in question acts on all domains, the entire machine, or directly -on the xen hypervisor. Those exceptions will be clear for each of those -commands. +Where I is one of the commands listed below; I is the +numeric domain id, or the domain name, or the domain UUID; and I +are command specific options. There are a few exceptions to this rule +in the cases where the command in question acts on all domains, the +entire machine, or directly on the xen hypervisor. Those exceptions +will be clear for each of those commands. Note: it is permissible to +give numeric names to domains, however, doing so will result in a +domain that can only be identified by domain id. In other words, if a +numeric value is supplied it will be interpreted as a domain id, not +as a name. The B program can be used either to run one I by giving the command and its arguments on the shell command line, or a I