FCPv2 SendBookmark

SendBookmark sends a bookmark to a darknet peer node. While the URI is set as field on this message, an optional description can be set as payload.

Once the message has been sent to the peer, the node will reply with a SentPeer message.

If the peer node cannot be found, an UnknownNodeIdentifier message is sent. If the peer is not a darknet peer, a ProtocolError with error code DARKNET_ONLY is sent. If the Name is missing, a ProtocolError with error code MISSING_FIELD is sent. If the URI is not a valid Hyphanet URI, a ProtocolError with error code FREENET_URI_PARSE_ERROR is sent.

Example

SendBookmark
Identifier=send-bookmark-0001
NodeIdentifier=other.node:1234
Name=The GNU Public License
URI=KSK@gpl.txt
HasAnActivelink=false
DataLength=3
Data
GPL

Details

Field	Possible values	Mandatory	Default	Description
Identifier	any string	No		The identifier of the request.
NodeIdentifer	<name>/<identity>/<ip>:<port>	Yes	n/a	The identifier of the peer node to send the bookmark to.
Name	any string	Yes	n/a	The name of the bookmark.
URI	a Hyphanet URI	Yes	n/a	The URI of the bookmark.
HasAnActivelink	[true, false]	No	false	Whether the site linked by URI has an active-link image.
DataLength	integer > 0	only iff payload is used	none	The length of the message payload.
<payload>	any UTF-8-encoded string	only iff DataLength is set		The description of the bookmark.