doc: Add statment about permissions needed to do a core dump

Documentation did not specify, that some permissions are required on
target path for coredump for the user running the hypervisor.

Diff to v1:
- reword statements

diff --git a/src/libvirt.c b/src/libvirt.c
index c32c7a6eeffc3af8f440f5ad856b02bc2a9c977d..4fb200d28586d7b9254c8a921ac7f30e9708e77e 100644 (file)
--- a/src/libvirt.c
+++ b/src/libvirt.c
@@ -2777,7 +2777,8 @@ error:
  *
  * This method will dump the core of a domain on a given file for analysis.
  * Note that for remote Xen Daemon the file path will be interpreted in
- * the remote host.
+ * the remote host. Hypervisors may require  the user to manually ensure
+ * proper permissions on the file named by @to.
  *
  * If @flags includes VIR_DUMP_CRASH, then leave the guest shut off with
  * a crashed state after the dump completes.  If @flags includes

diff --git a/tools/virsh.pod b/tools/virsh.pod
index 5114580b365084c926fa4ffe1bfd7179d7f7f735..02726f3b422905647a13ce4f697f62fafdb20e15 100644 (file)
--- a/tools/virsh.pod
+++ b/tools/virsh.pod
@@ -621,6 +621,9 @@ rather than merely left in a paused state.
 If I<--bypass-cache> is specified, the save will avoid the file system
 cache, although this may slow down the operation.
 
+NOTE: Some hypervisors may require the user to manually ensure proper
+permissions on file and path specified by argument I<corefilepath>.
+
 =item B<dumpxml> I<domain-id> [I<--inactive>] [I<--security-info>]
 [I<--update-cpu>]