From: Richard Jones <rjones@redhat.com>
Date: Mon, 19 Oct 2009 15:57:54 +0000 (+0100)
Subject: guestfs_find: Document protocol limits for this API call.
X-Git-Tag: 1.0.74~5
X-Git-Url: http://git.annexia.org/?a=commitdiff_plain;ds=sidebyside;h=55f5dc6f1195d7dec5687ece3f6e74dde649ff7c;p=libguestfs.git

guestfs_find: Document protocol limits for this API call.

guestfs_find has to send the complete list of files in a single
protocol message (hence, limited to 2-4 MB).  Unfortunately on
a typical Linux guest, guestfs_find ("/") will exceed this limit
resulting in an error.

Therefore we should add an unlimited version of this call in a
future commit.  This commit just documents the current limit.
---

diff --git a/src/generator.ml b/src/generator.ml
index 4f03c06..74890b4 100755
--- a/src/generator.ml
+++ b/src/generator.ml
@@ -2488,7 +2488,7 @@ C<resize2fs> sometimes gives an error about this and sometimes not.
 In any case, it is always safe to call C<guestfs_e2fsck_f> before
 calling this function.");
 
-  ("find", (RStringList "names", [Pathname "directory"]), 107, [],
+  ("find", (RStringList "names", [Pathname "directory"]), 107, [ProtocolLimitWarning],
    [InitBasicFS, Always, TestOutputList (
       [["find"; "/"]], ["lost+found"]);
     InitBasicFS, Always, TestOutputList (