File 0032-fish-Clarify-documentation-for-ro-option.patch of Package libguestfs
From 23fcf92ea9ac792467e76898f56b77f56d405428 Mon Sep 17 00:00:00 2001 From: Richard W.M. Jones <rjones@redhat.com> Date: Sun, 12 Dec 2010 10:02:00 +0000 Subject: [PATCH 32/72] fish: Clarify documentation for --ro option. (cherry picked from commit e49aefd1f8a85c02d344cef18c8b07aa1c2187f9) --- fish/guestfish.pod | 7 ++++--- 1 files changed, 4 insertions(+), 3 deletions(-) diff --git a/fish/guestfish.pod b/fish/guestfish.pod index 71814cc..f1a7409 100644 --- a/fish/guestfish.pod +++ b/fish/guestfish.pod @@ -354,15 +354,16 @@ L</REMOTE CONTROL GUESTFISH OVER A SOCKET> below. =item B<--ro> -This changes the I<-a> and I<-m> options so that disks are added and -mounts are done read-only (see L<guestfs(3)/guestfs_mount_ro>). +This changes the I<-a>, I<-d> and I<-m> options so that disks are +added and mounts are done read-only. The option must always be used if the disk image or virtual machine might be running, and is generally recommended in cases where you don't need write access to the disk. Note that prepared disk images created with I<-N> are not affected by -the I<--ro> option. +this option. Also commands like C<add> are not affected - you have to +specify the C<readonly:true> option explicitly if you need it. See also L</OPENING DISKS FOR READ AND WRITE> below. -- 1.7.1