From 4d4430e1257aee1366e2c8f3f8cf1c7e9f4007ed Mon Sep 17 00:00:00 2001 From: Peter Krempa Date: Fri, 16 Sep 2011 12:04:40 +0200 Subject: [PATCH] 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 --- src/libvirt.c | 3 ++- tools/virsh.pod | 3 +++ 2 files changed, 5 insertions(+), 1 deletion(-) diff --git a/src/libvirt.c b/src/libvirt.c index c32c7a6eef..4fb200d285 100644 --- 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 5114580b36..02726f3b42 100644 --- 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. + =item B I [I<--inactive>] [I<--security-info>] [I<--update-cpu>] -- 2.39.5