diff options
author | Richard W.M. Jones <rjones@redhat.com> | 2010-10-18 13:18:20 +0100 |
---|---|---|
committer | Richard W.M. Jones <rjones@redhat.com> | 2010-10-18 13:18:20 +0100 |
commit | a80177cc847102d5a6e43a8ff87769e86f30bd6c (patch) | |
tree | 3080e2d7ba0f9ff0a3711180c2eeec8e43fb92cc /tools | |
parent | b3d27793f04ae44b2c11f6422a19b4422ac941cd (diff) | |
download | libguestfs-a80177cc847102d5a6e43a8ff87769e86f30bd6c.tar.gz libguestfs-a80177cc847102d5a6e43a8ff87769e86f30bd6c.tar.xz libguestfs-a80177cc847102d5a6e43a8ff87769e86f30bd6c.zip |
tools: Add section describing quoting libvirt domain names to docs (RHBZ#643624)
Diffstat (limited to 'tools')
-rwxr-xr-x | tools/virt-cat | 7 | ||||
-rwxr-xr-x | tools/virt-df | 7 | ||||
-rwxr-xr-x | tools/virt-edit | 7 | ||||
-rwxr-xr-x | tools/virt-list-filesystems | 7 | ||||
-rwxr-xr-x | tools/virt-list-partitions | 7 | ||||
-rwxr-xr-x | tools/virt-ls | 7 | ||||
-rwxr-xr-x | tools/virt-make-fs | 7 | ||||
-rwxr-xr-x | tools/virt-rescue | 7 | ||||
-rwxr-xr-x | tools/virt-resize | 7 | ||||
-rwxr-xr-x | tools/virt-tar | 7 | ||||
-rwxr-xr-x | tools/virt-win-reg | 7 |
11 files changed, 77 insertions, 0 deletions
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)>, |