git.annexia.org
/
libguestfs.git
/ commitdiff
commit
grep
author
committer
pickaxe
?
search:
re
summary
|
shortlog
|
log
|
commit
| commitdiff |
tree
raw
|
patch
|
inline
| side by side (parent:
b3d2779
)
tools: Add section describing quoting libvirt domain names to docs (RHBZ#643624)
author
Richard W.M. Jones
<rjones@redhat.com>
Mon, 18 Oct 2010 12:18:20 +0000
(13:18 +0100)
committer
Richard W.M. Jones
<rjones@redhat.com>
Mon, 18 Oct 2010 12:18:20 +0000
(13:18 +0100)
12 files changed:
inspector/virt-inspector
patch
|
blob
|
history
tools/virt-cat
patch
|
blob
|
history
tools/virt-df
patch
|
blob
|
history
tools/virt-edit
patch
|
blob
|
history
tools/virt-list-filesystems
patch
|
blob
|
history
tools/virt-list-partitions
patch
|
blob
|
history
tools/virt-ls
patch
|
blob
|
history
tools/virt-make-fs
patch
|
blob
|
history
tools/virt-rescue
patch
|
blob
|
history
tools/virt-resize
patch
|
blob
|
history
tools/virt-tar
patch
|
blob
|
history
tools/virt-win-reg
patch
|
blob
|
history
diff --git
a/inspector/virt-inspector
b/inspector/virt-inspector
index
dc15f0d
..
04a0771
100755
(executable)
--- a/
inspector/virt-inspector
+++ b/
inspector/virt-inspector
@@
-843,6
+843,13
@@
sub output_query_kernel_arch
=back
=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)>,
=head1 SEE ALSO
L<guestfs(3)>,
diff --git
a/tools/virt-cat
b/tools/virt-cat
index
e000e25
..
67506c0
100755
(executable)
--- 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");
# 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)>,
=head1 SEE ALSO
L<guestfs(3)>,
diff --git
a/tools/virt-df
b/tools/virt-df
index
71658f7
..
1551221
100755
(executable)
--- 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.
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)>,
=head1 SEE ALSO
L<guestfs(3)>,
diff --git
a/tools/virt-edit
b/tools/virt-edit
index
128872e
..
59b5b2b
100755
(executable)
--- a/
tools/virt-edit
+++ b/
tools/virt-edit
@@
-322,6
+322,13
@@
If not set, C<vi> is used.
=back
=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)>,
=head1 SEE ALSO
L<guestfs(3)>,
diff --git
a/tools/virt-list-filesystems
b/tools/virt-list-filesystems
index
921704b
..
7b4d5ad
100755
(executable)
--- 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)>,
=head1 SEE ALSO
L<guestfs(3)>,
diff --git
a/tools/virt-list-partitions
b/tools/virt-list-partitions
index
8bda62e
..
0edecc4
100755
(executable)
--- 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)>,
=head1 SEE ALSO
L<guestfs(3)>,
diff --git
a/tools/virt-ls
b/tools/virt-ls
index
8813d2f
..
9271a91
100755
(executable)
--- a/
tools/virt-ls
+++ b/
tools/virt-ls
@@
-207,6
+207,13
@@
unless ($mode) {
close F;
}
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)>,
=head1 SEE ALSO
L<guestfs(3)>,
diff --git
a/tools/virt-make-fs
b/tools/virt-make-fs
index
3f27a62
..
1a6aee4
100755
(executable)
--- a/
tools/virt-make-fs
+++ b/
tools/virt-make-fs
@@
-524,6
+524,13
@@
sub create_pipe
return $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)>,
=head1 SEE ALSO
L<guestfish(1)>,
diff --git
a/tools/virt-rescue
b/tools/virt-rescue
index
7a87fbc
..
b8902a5
100755
(executable)
--- 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.
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)>,
=head1 SEE ALSO
L<guestfs(3)>,
diff --git
a/tools/virt-resize
b/tools/virt-resize
index
6e11d47
..
4bb8821
100755
(executable)
--- 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.
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)>,
=head1 SEE ALSO
L<virt-list-partitions(1)>,
diff --git
a/tools/virt-tar
b/tools/virt-tar
index
3e6e20b
..
5e6e95a
100755
(executable)
--- a/
tools/virt-tar
+++ b/
tools/virt-tar
@@
-254,6
+254,13
@@
undef $g;
exit 0;
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)>,
=head1 SEE ALSO
L<guestfs(3)>,
diff --git
a/tools/virt-win-reg
b/tools/virt-win-reg
index
afa8087
..
16688f4
100755
(executable)
--- 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)>,
=head1 SEE ALSO
L<hivex(3)>,