[gnunet-scheme] branch master updated: fs/struct: Define new message type /:msg:fs:start-search!.

[gnunet]

This is an automated email from the git hooks/post-receive script.

maxime-devos pushed a commit to branch master
in repository gnunet-scheme.

The following commit(s) were added to refs/heads/master by this push:
     new 9273184  fs/struct: Define new message type /:msg:fs:start-search!.
9273184 is described below

commit 927318473b60bf7ce6a14f3a96d95e569ccd676d
Author: Maxime Devos <maximedevos@telenet.be>
AuthorDate: Fri Oct 28 19:34:20 2022 +0200

    fs/struct: Define new message type /:msg:fs:start-search!.
    
    * gnu/gnunet/fs/struct.scm (/:msg:fs:start-search!): New definition.
---
 gnu/gnunet/fs/struct.scm | 43 +++++++++++++++++++++++++++++++++++++++++--
 1 file changed, 41 insertions(+), 2 deletions(-)

diff --git a/gnu/gnunet/fs/struct.scm b/gnu/gnunet/fs/struct.scm
index e1bebbc..27d19c5 100644
--- a/gnu/gnunet/fs/struct.scm
+++ b/gnu/gnunet/fs/struct.scm
@@ -25,7 +25,8 @@
          /:msg:fs:response-loc-signature
          /:msg:fs:index-start!
          /:msg:fs:index-list:entry
-         /:msg:fs:unindex!)
+         /:msg:fs:unindex!
+         /:msg:fs:start-search!)
   (import (only (rnrs base) define begin * quote)
          (only (gnu gnunet crypto struct)
                /peer-identity)
@@ -151,4 +152,42 @@ already not on the list).")
        (field (reserved u32/big)
              (synopsis "Always zero."))
        (field (file-id /hashcode:512)
-             (synopsis "Hash of the file that we will unindex."))))))
+             (synopsis "Hash of the file that we will unindex."))))
+
+    (define-type /:msg:fs:start-search!
+      (structure/packed
+       (synopsis "Message to the service to start a (keyword) search.")
+       (documentation "This is followed by the hash codes of already-known
+results (which should hence be excluded from what the service returns);
+naturally, this only applies to queries that can have multiple results
+(UBLOCKS). ")
+       (properties '((message-symbol msg:fs:start-search!)
+                    (c-type . SearchMessage)))
+       (field (header /:message-header))
+       ;; TODO: better support bitmasks in (gnu gnunet netstruct ...)
+       ;; TODO: SEARCH_MESSAGE_OPTION_???
+       (field (options u32/big)
+             (synopsis "Bitmask with search options")
+             (documentation "Zero for no options, one for loopback-only,
+two for 'to be continued' (with a second search message for the same
+type/query/target and additional already-known results following this one).
+See @code{SEARCH_MESSAGE_OPTION_...}.  Other bits are currently undefined."))
+       (field (type u32/big)
+             (synopsis "Type of the content that we are looking for.
+TODO: reference to enumeration."))
+       (field (anonymity-level u32/big)
+             ;; TODO: bounds, reference to interpretation.
+             (synopsis "Desired anonymity level"))
+       (field (target /peer-identity)
+             (synopsis "Identity of peer known to have a response, if any.")
+             (documentation "If the request is for a DBLOCK or IBLOCK, this is
+the identity of the peer that is known to have a response.  Set to all-zeros if
+such a target is not known (note that even if @emph{our} anonymity level is >0,
+we may happen to know the responder's identity; nevertheless, we should
+probably not use it for a DHT-lookup or simiar blunt actions in order to avoid
+exposing ourselves).
+
+Otherwise, @var{target} must be all zeros."))
+       (field (query /hashcode:512)
+             (synopsis "Hash of the public key for UBLOCKs: hash of the
+CHK-encoded block for DBLOCKS and IBLOCKS."))))))

-- 
To stop receiving notification emails like this one, please contact
gnunet@gnunet.org.