Commit 62d0d0d4 authored by Kenton Varda's avatar Kenton Varda

Clarify that question and export IDs are per-connection and suggest how to allocate them.

parent 7d0f5e6f
...@@ -107,13 +107,19 @@ $Cxx.namespace("capnp::rpc"); ...@@ -107,13 +107,19 @@ $Cxx.namespace("capnp::rpc");
# ======================================================================================== # ========================================================================================
# The Four Tables # The Four Tables
# #
# As in CapTP, for each open connection, a vat maintains four tables: questions, answers, imports, # Cap'n Proto RPC connections are stateful (although an application built on Cap'n Proto could
# and exports. See the diagram at: # export a stateless interface). As in CapTP, for each open connection, a vat maintains four state
# tables: questions, answers, imports, and exports. See the diagram at:
# http://www.erights.org/elib/distrib/captp/4tables.html # http://www.erights.org/elib/distrib/captp/4tables.html
# #
# The question table corresponds to the other end's answer table, and the imports table corresponds # The question table corresponds to the other end's answer table, and the imports table corresponds
# to the other end's exports table. # to the other end's exports table.
# #
# The entries in each table are identified by ID numbers (defined below as 32-bit integers). These
# numbers are always specific to the connection; a newly-established connection starts with no
# valid IDs. Since low-numbered IDs will pack better, it is suggested that IDs be assigned like
# Unix file descriptors -- prefer the lowest-number ID that is currently available.
#
# IDs in the questions/answers tables are chosen by the questioner and generally represent method # IDs in the questions/answers tables are chosen by the questioner and generally represent method
# calls that are in progress. # calls that are in progress.
# #
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment