[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]
[gnunet-scheme] branch master updated: fs/struct: Define new message typ
From: |
gnunet |
Subject: |
[gnunet-scheme] branch master updated: fs/struct: Define new message type /:msg:fs:start-search!. |
Date: |
Fri, 28 Oct 2022 19:34:52 +0200 |
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.
[Prev in Thread] |
Current Thread |
[Next in Thread] |
- [gnunet-scheme] branch master updated: fs/struct: Define new message type /:msg:fs:start-search!.,
gnunet <=