From 55641f5d1e9964f8a039005b511b8e688c92cddb Mon Sep 17 00:00:00 2001 From: Richard Jones Date: Thu, 29 Apr 2010 13:55:52 +0100 Subject: [PATCH] guestfs(3): Documentation on protocol gotchas. --- src/guestfs.pod | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/src/guestfs.pod b/src/guestfs.pod index 584e996..e1fa4f5 100644 --- a/src/guestfs.pod +++ b/src/guestfs.pod @@ -610,6 +610,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 -- 1.8.3.1