X-Git-Url: http://git.annexia.org/?p=libguestfs.git;a=blobdiff_plain;f=src%2Fguestfs.pod;h=8404e742948277b4cf17106e333081053c9178d3;hp=584e996ad6a16ef29d010fe05df9a4e9ff69cb54;hb=3920ad95f6b2db8fbf20aa26692877a09070cb04;hpb=ce95be8b185ce697816c3446406d7129e01cc0e1 diff --git a/src/guestfs.pod b/src/guestfs.pod index 584e996..8404e74 100644 --- a/src/guestfs.pod +++ b/src/guestfs.pod @@ -258,9 +258,7 @@ L. It's often the case that you want to write a file or files to the disk image. -For small, single files, use L. This call -currently contains a bug which limits the call to plain text files -(not containing ASCII NUL characters). +For small, single files, use L. To upload a single file, use L. This call has no limits on file content or size (even files larger than 4 GB). @@ -610,6 +608,23 @@ the error message was also unintuitive, but we have corrected this since. Like the Bourne shell, we should have used C to run commands. +=item Protocol limit of 256 characters for error messages + +This limit is both rather small and quite unnecessary. We should be +able to return error messages up to the length of the protocol message +(2-4 MB). + +Note that we cannot change the protocol without some breakage, because +there are distributions that repackage the Fedora appliance. + +=item Protocol should return errno with error messages. + +It would be a nice-to-have to be able to get the original value of +'errno' from inside the appliance along error paths (where set). +Currently L goes through hoops to try to reverse the +error message string into an errno, see the function error() in +fuse/guestmount.c. + =back =head2 PROTOCOL LIMITS