mirrors/libguestfs
1
0
Fork 0
mirror of https://github.com/libguestfs/libguestfs.git synced 2026-03-22 07:03:38 +00:00
Code Issues Packages Projects Releases Wiki Activity

docs: Update documentation on attach-methods.

Browse Source 
Add better instructions for getting the default attach-method.

Update libguestfs-test-tool(1) to show how to enable and disable
libvirt.
This commit is contained in:
Richard W.M. Jones
2013-03-12 13:19:26 +00:00
parent 6e4f9be492
commit 0b285cd8a6
2 changed files with 39 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

1
src/guestfs.pod
View File

@@ -1262,6 +1262,7 @@ default by doing:
To find out if libguestfs was compiled with a different default
attach method, do:
unset LIBGUESTFS_ATTACH_METHOD
guestfish get-attach-method
=head2 ATTACHING TO RUNNING DAEMONS

38
test-tool/libguestfs-test-tool.pod
View File

@@ -92,6 +92,12 @@ for further information.
=head1 TRYING OUT A DIFFERENT VERSION OF LIBVIRT
To find out which attach-method is the default in your libguestfs
package, do:
unset LIBGUESTFS_ATTACH_METHOD
guestfish get-attach-method
If you are using the libvirt attach-method, then you can try out a
different (eg. upstream) version of libvirt by running these commands
(I<not> as root):
@@ -105,8 +111,40 @@ script (in the top-level libvirt build directory) to set some
environment variables so that the alternate version of libvirt is used
to run the program.
=head1 TRYING OUT WITH / WITHOUT LIBVIRT
To find out which attach-method is the default in your libguestfs
package, do:
unset LIBGUESTFS_ATTACH_METHOD
guestfish get-attach-method
If you are using the libvirt attach-method, you can try without
(ie. libguestfs directly launching qemu) by doing:
export LIBGUESTFS_ATTACH_METHOD=appliance
Or if you are using the default (appliance) attach-method, then you
can try libvirt:
export LIBGUESTFS_ATTACH_METHOD=libvirt
or with libvirt and a specific
L<libvirt URI|http://libvirt.org/uri.html>:
export LIBGUESTFS_ATTACH_METHOD=libvirt:qemu:///session
=head1 TRYING OUT DIFFERENT SELINUX SETTINGS
To find out which attach-method is the default in your libguestfs
package, do:
LIBGUESTFS_ATTACH_METHOD= guestfish get-attach-method
To find out if SELinux is being used, do:
getenforce
If you are using libvirt, SELinux and sVirt, then you can try to see
if changing SELinux to "permissive" mode makes any difference. Use
this command as root: