tools: Add section describing quoting libvirt domain names to docs (RHBZ#643624)

12 files changed, 84 insertions, 0 deletions

diff --git a/inspector/virt-inspector b/inspector/virt-inspector
index dc15f0db..04a0771a 100755
--- a/inspector/virt-inspector
+++ b/inspector/virt-inspector
@@ -843,6 +843,13 @@ sub output_query_kernel_arch
 
 =back
 
+=head1 SHELL QUOTING
+
+Libvirt guest names can contain arbitrary characters, some of which
+have meaning to the shell such as C<#> and space.  You may need to
+quote or escape these characters on the command line.  See the shell
+manual page L<sh(1)> for details.
+
 =head1 SEE ALSO
 
 L<guestfs(3)>,
diff --git a/tools/virt-cat b/tools/virt-cat
index e000e25f..67506c0b 100755
--- a/tools/virt-cat
+++ b/tools/virt-cat
@@ -160,6 +160,13 @@ mount_operating_system ($g, $os);
 # NB: https://bugzilla.redhat.com/show_bug.cgi?id=501888
 print $g->download($filename, "/dev/stdout");
 
+=head1 SHELL QUOTING
+
+Libvirt guest names can contain arbitrary characters, some of which
+have meaning to the shell such as C<#> and space.  You may need to
+quote or escape these characters on the command line.  See the shell
+manual page L<sh(1)> for details.
+
 =head1 SEE ALSO
 
 L<guestfs(3)>,
diff --git a/tools/virt-df b/tools/virt-df
index 71658f72..15512216 100755
--- a/tools/virt-df
+++ b/tools/virt-df
@@ -533,6 +533,13 @@ for Perl or Python's built-in csv library).
 
 Most spreadsheets and databases can import CSV directly.
 
+=head1 SHELL QUOTING
+
+Libvirt guest names can contain arbitrary characters, some of which
+have meaning to the shell such as C<#> and space.  You may need to
+quote or escape these characters on the command line.  See the shell
+manual page L<sh(1)> for details.
+
 =head1 SEE ALSO
 
 L<guestfs(3)>,
diff --git a/tools/virt-edit b/tools/virt-edit
index 128872e8..59b5b2b9 100755
--- a/tools/virt-edit
+++ b/tools/virt-edit
@@ -322,6 +322,13 @@ If not set, C<vi> is used.
 
 =back
 
+=head1 SHELL QUOTING
+
+Libvirt guest names can contain arbitrary characters, some of which
+have meaning to the shell such as C<#> and space.  You may need to
+quote or escape these characters on the command line.  See the shell
+manual page L<sh(1)> for details.
+
 =head1 SEE ALSO
 
 L<guestfs(3)>,
diff --git a/tools/virt-list-filesystems b/tools/virt-list-filesystems
index 921704b2..7b4d5ad3 100755
--- a/tools/virt-list-filesystems
+++ b/tools/virt-list-filesystems
@@ -188,6 +188,13 @@ sub canonicalize
     $_;
 }
 
+=head1 SHELL QUOTING
+
+Libvirt guest names can contain arbitrary characters, some of which
+have meaning to the shell such as C<#> and space.  You may need to
+quote or escape these characters on the command line.  See the shell
+manual page L<sh(1)> for details.
+
 =head1 SEE ALSO
 
 L<guestfs(3)>,
diff --git a/tools/virt-list-partitions b/tools/virt-list-partitions
index 8bda62ef..0edecc4b 100755
--- a/tools/virt-list-partitions
+++ b/tools/virt-list-partitions
@@ -226,6 +226,13 @@ sub human_size
     }
 }
 
+=head1 SHELL QUOTING
+
+Libvirt guest names can contain arbitrary characters, some of which
+have meaning to the shell such as C<#> and space.  You may need to
+quote or escape these characters on the command line.  See the shell
+manual page L<sh(1)> for details.
+
 =head1 SEE ALSO
 
 L<guestfs(3)>,
diff --git a/tools/virt-ls b/tools/virt-ls
index 8813d2fa..9271a914 100755
--- a/tools/virt-ls
+++ b/tools/virt-ls
@@ -207,6 +207,13 @@ unless ($mode) {
     close F;
 }
 
+=head1 SHELL QUOTING
+
+Libvirt guest names can contain arbitrary characters, some of which
+have meaning to the shell such as C<#> and space.  You may need to
+quote or escape these characters on the command line.  See the shell
+manual page L<sh(1)> for details.
+
 =head1 SEE ALSO
 
 L<guestfs(3)>,
diff --git a/tools/virt-make-fs b/tools/virt-make-fs
index 3f27a623..1a6aee4f 100755
--- a/tools/virt-make-fs
+++ b/tools/virt-make-fs
@@ -524,6 +524,13 @@ sub create_pipe
     return $pipe;
 }
 
+=head1 SHELL QUOTING
+
+Libvirt guest names can contain arbitrary characters, some of which
+have meaning to the shell such as C<#> and space.  You may need to
+quote or escape these characters on the command line.  See the shell
+manual page L<sh(1)> for details.
+
 =head1 SEE ALSO
 
 L<guestfish(1)>,
diff --git a/tools/virt-rescue b/tools/virt-rescue
index 7a87fbcf..b8902a59 100755
--- a/tools/virt-rescue
+++ b/tools/virt-rescue
@@ -228,6 +228,13 @@ exit 0;
 Several environment variables affect virt-rescue.  See
 L<guestfs(3)/ENVIRONMENT VARIABLES> for the complete list.
 
+=head1 SHELL QUOTING
+
+Libvirt guest names can contain arbitrary characters, some of which
+have meaning to the shell such as C<#> and space.  You may need to
+quote or escape these characters on the command line.  See the shell
+manual page L<sh(1)> for details.
+
 =head1 SEE ALSO
 
 L<guestfs(3)>,
diff --git a/tools/virt-resize b/tools/virt-resize
index 6e11d475..4bb88214 100755
--- a/tools/virt-resize
+++ b/tools/virt-resize
@@ -1396,6 +1396,13 @@ hand-calculating sector offsets, which is something that virt-resize
 was designed to avoid.  If you want to see the guestfish-equivalent
 commands that virt-resize runs, use the C<--debug> flag.
 
+=head1 SHELL QUOTING
+
+Libvirt guest names can contain arbitrary characters, some of which
+have meaning to the shell such as C<#> and space.  You may need to
+quote or escape these characters on the command line.  See the shell
+manual page L<sh(1)> for details.
+
 =head1 SEE ALSO
 
 L<virt-list-partitions(1)>,
diff --git a/tools/virt-tar b/tools/virt-tar
index 3e6e20b9..5e6e95a2 100755
--- a/tools/virt-tar
+++ b/tools/virt-tar
@@ -254,6 +254,13 @@ undef $g;
 
 exit 0;
 
+=head1 SHELL QUOTING
+
+Libvirt guest names can contain arbitrary characters, some of which
+have meaning to the shell such as C<#> and space.  You may need to
+quote or escape these characters on the command line.  See the shell
+manual page L<sh(1)> for details.
+
 =head1 SEE ALSO
 
 L<guestfs(3)>,
diff --git a/tools/virt-win-reg b/tools/virt-win-reg
index afa8087a..16688f47 100755
--- a/tools/virt-win-reg
+++ b/tools/virt-win-reg
@@ -458,6 +458,13 @@ sub upload_hive
     }
 }
 
+=head1 SHELL QUOTING
+
+Libvirt guest names can contain arbitrary characters, some of which
+have meaning to the shell such as C<#> and space.  You may need to
+quote or escape these characters on the command line.  See the shell
+manual page L<sh(1)> for details.
+
 =head1 SEE ALSO
 
 L<hivex(3)>,