FCPv2 GetFailed

Chris Double edited this page Mar 28, 2017 · 1 revision

GetFailed indicates a Freenet retrieval has failed. See below for error codes and their descriptions. Complex GetFailed messages are also possible; the format is identical to that of a PutFailed.

Example

 GetFailed
 Global=true
 Code=3
 CodeDescription=Unknown metadata
 ExtraDescription=<extra description of this specific error, if available>
 Fatal=true
 ShortCodeDescription=<short code description>
 Identifier=<identifier passed in by client>
 ExpectedDataLength=<expected data length if known>
 ExpectedMetadata.ContentType=<expected content type if known>
 FinalizedExpected=<whether the Expected fields can be trusted; if false, then data length may change, and if ContentType is null or application/octet-stream then it may be set later on>
 RedirectURI=<uri to redirect to; only included for e.g. USKs where we want the client to update any links to the old URI to point to the new one; equivalent to HTTP 301>
 EndMessage

Details

Field Example or [Range] Description
Code Integer Error code identifier. See #Fetch Error Codes
CodeDescription <description></description> Description of error code.
ExtraDescription Extra description of this specific error, if available.
Fatal [true,false] True means there isn't much point retrying as it's probably an error with the data.
Errors
ShortCodeDescription Short code description.
Identifier Identifier passed in by client.
ExpectedDataLength Expected data length, if known.
ExpectedMetadata.ContentType Expected content type, if known.
FinalizedExpected [true,false] Whether the Expected fields can be trusted; if false, then data length may change, and if ContentType is null or application/octet-stream then it may be set later on.
RedirectURI URI to redirect to; only included for e.g. USKs where we want the client to update any links to the old URI to point to the new one; equivalent to HTTP 301>

Fetch Error Codes

(Always refer to the source code for the most up to date list)

Value Message
1 (Depreciated) Too many levels of archive recursion
2 (Depreciated) Unknown splitfile metadata
3 Unknown metadata
4 Invalid metadata
5 Archive failure
6 Block decode error
7 (Depreciated) Too many metadata levels
8 Too many archive restarts
9 Too many levels of recursion
10 Tried to access an archive file but not in an archive (this isn't an archive, but you seem to be telling me it is)
11 The URI has more metastrings and I can't deal with them
12 Bucket error (ie. internal, ie. not your fault!)
13 Data not found (I've looked, and it's really not there. Get over it)
14 Route not found (I can't get to where it would be)
15 Rejected overload (A downstream node was too busy to deal with us right now)
16 (Depreciated) Too many redirects
17 Internal error
18 Transfer failed (I found it, but never managed to get the data)
19 Splitfile error
20 Invalid URI
21 Too big!
22 Metadata is too big
23 Too many blocks per segment (in a splitfile)
24 Not enough metastrings (be more specific - put /something at the end)
25 Cancelled
26 Archive restart
27 Permanent redirect (there's a newer version of the USK you asked for)
28 All data not found (means we fetched some data but not all - perhaps a redirect to a file that hasn't been inserted)
29 Requestor specified a list of allowed MIME types, and the key's type wasn't in the list
30 A node killed the request because it had recently been tried and had DNFed
Clone this wiki locally
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.