X-Git-Url: http://git.annexia.org/?a=blobdiff_plain;f=fish%2Fguestfish.pod;h=e2ea5057d61e87cba52d21ac23265bba1cb6fcda;hb=9ac3cfd1a7b9d5464cfd059328b547a31fb549a0;hp=13a9fa7dd2d917233c4a37c0f0612e5e6e39bc7f;hpb=8980c01b46eafcf4b5dc127e4696c2cbe1bff09f;p=libguestfs.git diff --git a/fish/guestfish.pod b/fish/guestfish.pod index 13a9fa7..e2ea505 100644 --- a/fish/guestfish.pod +++ b/fish/guestfish.pod @@ -98,7 +98,7 @@ the functionality of the guestfs API, see L. Guestfish gives you structured access to the libguestfs API, from shell scripts or the command line or interactively. If you want to -rescue a broken virtual machine image, you might want to look at the +rescue a broken virtual machine image, you should look at the L command. Using guestfish in read/write mode on live virtual machines can be @@ -296,6 +296,25 @@ must be escaped with a backslash. command "/bin/echo 'foo bar'" command "/bin/echo \'foo\'" +=head1 NUMBERS + +Commands which take integers as parameters use the C convention which +is to use C<0> to prefix an octal number or C<0x> to prefix a +hexadecimal number. For example: + + 1234 decimal number 1234 + 02322 octal number, equivalent to decimal 1234 + 0x4d2 hexadecimal number, equivalent to decimal 1234 + +When using the C command, you almost always want to specify an +octal number for the mode, and you must prefix it with C<0> (unlike +the Unix L program): + + chmod 0777 /public # OK + chmod 777 /public # WRONG! This is mode 777 decimal = 01411 octal. + +Commands that return numbers currently always print them in decimal. + =head1 WILDCARDS AND GLOBBING Neither guestfish nor the underlying guestfs API performs @@ -719,11 +738,15 @@ I<1> if there was an error. L, L, L, +L, L, L, +L, L, +L, L, -L. +L, +L. =head1 AUTHORS