Browse Source

docs/rpc-interface.rst: update

patch-2
Neil Booth 6 years ago
parent
commit
c0b8589f0f
  1. 40
      docs/rpc-interface.rst

40
docs/rpc-interface.rst

@ -107,13 +107,10 @@ Apart from very short intervals, typically after a new block or when
a client has just connected, the number of unprocessed requests a client has just connected, the number of unprocessed requests
should normally be zero. should normally be zero.
Sessions are put into groups, primarily as an anti-DoS measure. Sessions are put into groups, primarily as an anti-DoS measure. Currently each session
Initially all connections made within a period of time are put in the goes into two groups: one for an IP subnet, and one based on the timeslice it connected
same group. High bandwidth usage by a member of a group deprioritizes in. Each member of a group incurs a fraction of the costs of the other group members.
that session, and all members of its group to a lesser extent. This appears in the `sessions_` list under the column XCost.
Low-priority sessions have their requests served after higher priority
sessions. ElectrumX will start delaying responses to a session if it
becomes sufficiently deprioritized.
groups groups
------ ------
@ -206,22 +203,19 @@ sessions
Return a list of all current sessions. Takes no arguments:: Return a list of all current sessions. Takes no arguments::
ID Flags Client Proto Reqs Txs Subs Recv Recv KB Sent Sent KB Time Peer ID Flags Client Proto Cost XCost Reqs Txs Subs Recv Recv KB Sent Sent KB Time Peer
110 S1 2.9.4 0.10 0 0 0 403 28 442 37 06h41m41s xxx.xxx.xxx.xxx:xx 1 S6 1.1.1 1.4 0 16 0 0 0 3 0 3 0 05m42s 165.255.191.213:22349
282 S1 3.1.5 1.1 0 0 0 380 25 417 40 06h21m38s xxx.xxx.xxx.xxx:xx 2 S6 all_seeing_eye 1.4 0 16 0 0 0 2 0 2 0 05m40s 67.170.52.226:24995
300 S1 2.9.4 0.10 0 0 0 381 25 418 34 06h19m35s xxx.xxx.xxx.xxx:xx 4 S6 3.3.2 1.4 0 16 0 0 34 45 5 45 3 05m40s 185.220.100.252:40463
[...] 3 S6 1.1.2 1.4 0 16 0 0 0 3 0 3 0 05m40s 89.17.142.28:59241
3313 S1 2.9.3 0.10 0 0 0 22 1 22 6 07s xxx.xxx.xxx.xxx:xx
4 R0 RPC RPC 0 0 0 1 0 0 0 00s [::1]:62479 The columns show information by session: the session ID, flags (see below), how the client
identifies itself - typically the Electrum client version, the protocol version
The columns show information by session: the session ID, flags (see negotiated, the session cost, the additional session cost accrued from its groups, the
below), how the client identifies itself - typically the Electrum number of unprocessed requests, the number of transactions sent, the number of address
client version, the protocol version negotiated, the number of subscriptions, the number of requests received and their total size, the number of
unprocessed requests, the number of transactions sent, the number of messages sent and their size, how long the client has been connected, and the client's IP
address subscriptions, the number of requests received and their total address (if anonymous logging is disabled).
size, the number of messages sent and their size, how long the client
has been connected, and the client's IP address (if anonymous logging
is disabled).
The flags are: The flags are:

Loading…
Cancel
Save