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");
# ========================================================================================
# The Four Tables
#
# As in CapTP, for each open connection, a vat maintains four tables: questions, answers, imports,
# and exports. See the diagram at:
# Cap'n Proto RPC connections are stateful (although an application built on Cap'n Proto could
# 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
#
# The question table corresponds to the other end's answer table, and the imports table corresponds
# 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
# 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