Skip to content

Commit

Permalink
docs: Update documentation on attach-methods.
Browse files Browse the repository at this point in the history
Add better instructions for getting the default attach-method.

Update libguestfs-test-tool(1) to show how to enable and disable
libvirt.
  • Loading branch information
rwmjones committed Mar 12, 2013
1 parent 6e4f9be commit 0b285cd
Show file tree
Hide file tree
Showing 2 changed files with 39 additions and 0 deletions.
1 change: 1 addition & 0 deletions src/guestfs.pod
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
38 changes: 38 additions & 0 deletions test-tool/libguestfs-test-tool.pod
Original file line number Diff line number Diff line change
Expand Up @@ -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):
Expand All @@ -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:
Expand Down

0 comments on commit 0b285cd

Please sign in to comment.