X-Git-Url: http://git.annexia.org/?a=blobdiff_plain;ds=sidebyside;f=inspector%2Fvirt-inspector.pod;h=04e421dc3b1e34c18070cdb423f2a1912e813289;hb=3bde9fdffdb74183f7bf1315eb402918d3b13ed1;hp=df9dfdad0ed1815f1518c12389ecb78047fde648;hpb=baefb8225c8cbde56a1637c17af5c0965a81060e;p=libguestfs.git
diff --git a/inspector/virt-inspector.pod b/inspector/virt-inspector.pod
index df9dfda..04e421d 100755
--- a/inspector/virt-inspector.pod
+++ b/inspector/virt-inspector.pod
@@ -132,6 +132,13 @@ Display version number and exit.
Enable tracing of libguestfs API calls.
+=item B<--xpath> query
+
+Perform an XPath query on the XML on stdin, and print the result on
+stdout. In this mode virt-inspector simply runs an XPath query; all
+other inspection functions are disabled. See L below
+for some examples.
+
=back
=head1 OLD-STYLE COMMAND LINE ARGUMENTS
@@ -327,26 +334,34 @@ installer, or one part of a multipart CD. For example:
installer
-=head1 USING XPATH
+=head1 XPATH QUERIES
+
+Virt-inspector includes built in support for running XPath queries.
+The reason for including XPath support directly in virt-inspector is
+simply that there are no good and widely available command line
+programs that can do XPath queries. The only good one is
+L and that is not available on Red Hat Enterprise
+Linux.
-You can use the XPath query language to select parts of the XML. We
-recommend using C to perform XPath queries from the
-command line.
+To perform an XPath query, use the I<--xpath> option. Note that in
+this mode, virt-inspector simply reads XML from stdin and outputs the
+query result on stdout. All other inspection features are disabled in
+this mode.
For example:
- $ virt-inspector -d Guest | xmlstarlet sel -t -c '//filesystems'
+ $ virt-inspector -d Guest | virt-inspector --xpath '//filesystems'
ext4
[...]
$ virt-inspector -d Guest | \
- xmlstarlet sel -t -c "string(//filesystem[@dev='/dev/sda1']/type)"
+ virt-inspector --xpath "string(//filesystem[@dev='/dev/sda1']/type)"
ext4
$ virt-inspector -d Guest | \
- xmlstarlet sel -t -v '//icon' | base64 -i -d | display -
+ virt-inspector --xpath 'string(//icon)' | base64 -i -d | display -
[displays the guest icon, if there is one]
=head1 SHELL QUOTING
@@ -416,4 +431,4 @@ GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with this program; if not, write to the Free Software
-Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
+Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.