X-Git-Url: http://git.annexia.org/?p=libguestfs.git;a=blobdiff_plain;f=fish%2Fguestfish.pod;h=eb9ff39a864d2cdfb3ca1b2c815326cf0fa0be79;hp=abf6d7ac08b851305f84e2e6241cc2435ca2707b;hb=11374abeadfb01252bdb02c0915d1edc79512e79;hpb=a20e5c00c35490fa29668630113a01240a69b701 diff --git a/fish/guestfish.pod b/fish/guestfish.pod index abf6d7a..eb9ff39 100644 --- a/fish/guestfish.pod +++ b/fish/guestfish.pod @@ -299,9 +299,9 @@ L below. Connect to a live virtual machine. (Experimental, see L). -=item B<-m dev[:mountpoint]> +=item B<-m dev[:mountpoint[:options]]> -=item B<--mount dev[:mountpoint]> +=item B<--mount dev[:mountpoint[:options]]> Mount the named partition or logical volume on the given mountpoint. @@ -318,8 +318,17 @@ filesystems and LVs available (see L, L and L commands), or you can use the L program. -Using this flag is mostly equivalent to using the C -command or the C command if the I<--ro> flag was given. +The third (and rarely used) part of the mount parameter is the list of +mount options used to mount the underlying filesystem. If this is not +given, then the mount options are either the empty string or C +(the latter if the I<--ro> flag is used). By specifying the mount +options, you override this default choice. Probably the only time you +would use this is to enable ACLs and/or extended attributes if the +filesystem can support them: + + -m /dev/sda1:/:acl,user_xattr + +Using this flag is equivalent to using the C command. =item B<-n> @@ -393,7 +402,9 @@ Display the guestfish / libguestfs version number and exit. =item B<--rw> -This option does nothing at the moment. +This changes the I<-a>, I<-d> and I<-m> options so that disks are +added and mounts are done read-write. + See L below. =item B<-x> @@ -457,27 +468,30 @@ asked for without doing this. =head1 OPENING DISKS FOR READ AND WRITE -The guestfish (and L) options I<--ro> and I<--rw> -affect whether the other command line options I<-a>, I<-c>, I<-d>, -I<-i> and I<-m> open disk images read-only or for writing. +The guestfish, L and L options I<--ro> +and I<--rw> affect whether the other command line options I<-a>, +I<-c>, I<-d>, I<-i> and I<-m> open disk images read-only or for +writing. -In libguestfs E 1.6.2, guestfish and guestmount defaulted to -opening disk images supplied on the command line for write. To open a -disk image read-only you have to do I<-a image --ro>. +In libguestfs E 1.8, guestfish, guestmount and virt-rescue +defaulted to opening disk images supplied on the command line for +write. To open a disk image read-only you have to do I<-a image --ro>. This matters: If you accidentally open a live VM disk image writable then you will cause irreversible disk corruption. -By libguestfs 1.10 we intend to change the default the other way. Disk -images will be opened read-only. You will have to either specify -I or change a configuration file in order to get write -access for disk images specified by those other command line options. +By libguestfs 1.10 we intend to change the default the other way. +Disk images will be opened read-only. You will have to either specify +I, I, I, or change +the configuration file C in order to get +write access for disk images specified by those other command line +options. -This version of guestfish has a I<--rw> option which does nothing (it -is already the default). However it is highly recommended that you -use this option to indicate that guestfish needs write access, and to -prepare your scripts for the day when this option will be required for -write access. +This version of guestfish, guestmount and virt-rescue has a I<--rw> +option which does nothing (it is already the default). However it is +highly recommended that you use this option to indicate that you need +write access, and prepare your scripts for the day when this option +will be required for write access. B This does I affect commands like L and L, or any other libguestfs program apart from guestfish and guestmount. @@ -784,19 +798,24 @@ on each one. Then you can close the mapper device: =head1 WINDOWS PATHS If a path is prefixed with C then you can use Windows-style -paths (with some limitations). The following commands are equivalent: +drive letters and paths (with some limitations). The following +commands are equivalent: file /WINDOWS/system32/config/system.LOG - file win:/windows/system32/config/system.log - file win:\windows\system32\config\system.log - file WIN:C:\Windows\SYSTEM32\conFIG\SYSTEM.LOG + file WIN:C:\Windows\SYSTEM32\CONFIG\SYSTEM.LOG + +The parameter is rewritten "behind the scenes" by looking up the +position where the drive is mounted, prepending that to the path, +changing all backslash characters to forward slash, then resolving the +result using L. For example if the E: drive +was mounted on C then the parameter might be rewritten like this: -This syntax implicitly calls C (q.v.) so it also -handles case insensitivity like Windows would. This only works in -argument positions that expect a path. + win:e:\foo\bar => /e/FOO/bar + +This only works in argument positions that expect a path. =head1 UPLOADING AND DOWNLOADING FILES @@ -1072,6 +1091,15 @@ enough. =over 4 +=item $HOME/.libguestfs-tools.rc + +=item /etc/libguestfs-tools.conf + +This configuration file controls the default read-only or read-write +mode (I<--ro> or I<--rw>). + +See L. + =item $HOME/.guestfish If compiled with GNU readline support, then the command history @@ -1147,7 +1175,7 @@ Richard W.M. Jones (C) =head1 COPYRIGHT -Copyright (C) 2009-2010 Red Hat Inc. +Copyright (C) 2009-2011 Red Hat Inc. L This program is free software; you can redistribute it and/or modify