From: Richard Jones <rjones@redhat.com>
Date: Thu, 29 Apr 2010 12:55:52 +0000 (+0100)
Subject: guestfs(3): Documentation on protocol gotchas.
X-Git-Tag: 1.3.9~6
X-Git-Url: http://git.annexia.org/?p=libguestfs.git;a=commitdiff_plain;h=55641f5d1e9964f8a039005b511b8e688c92cddb

guestfs(3): Documentation on protocol gotchas.
---

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<guestfish -c
 command> 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<guestmount(1)> 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