diff --git a/i2p2www/pages/site/docs/api/samv3.html b/i2p2www/pages/site/docs/api/samv3.html index d9fc7a9e..84349643 100644 --- a/i2p2www/pages/site/docs/api/samv3.html +++ b/i2p2www/pages/site/docs/api/samv3.html @@ -1,7 +1,7 @@ {% extends "global/layout.html" %} {% block title %}SAM V3{% endblock %} -{% block lastupdated %}2023-01{% endblock %} -{% block accuratefor %}API 0.9.57{% endblock %} +{% block lastupdated %}2023-10{% endblock %} +{% block accuratefor %}API 0.9.59{% endblock %} {% block content %}

SAM is a simple client protocol for interacting with I2P. SAM is the recommended protocol for non-Java applications to connect to the I2P network, @@ -944,6 +944,26 @@ passing through the current socket is forwarded from and to the connected I2P destination peer, until one of the peer closes the socket.

+

Errors After OK

+

+In rare cases, the SAM bridge may encounter an error after sending RESULT=OK, +but before a connection comes in and sending the $destination line to the client. +These errors may include router shutdown, router restart, and session close. +In these cases, when SILENT=false, the SAM bridge may, but is not required to +(implementation-dependent), send the line: + +

+<-  STREAM STATUS
+         RESULT=I2P_ERROR
+         [MESSAGE=...]
+
+ +before immediately closing the socket. This line is not, of course, decodable as a +valid Base 64 destination. +

+ + +

SAM Virtual Streams : FORWARD

A client can use a regular socket server and wait for connection requests