DSSM Protocol Specification
DSSM is a protocol for multiplexing 256 bidirectional byte streams over a single one.
DSSM does not provide any error detection, it depends on a reliable, ordered transport.
DSSM does not provide encryption. If this is required, the underlying transport must provide it.
DSSM uses a minimal set of control characters from the C0 ASCII character set for stream multiplexing, keep alive signaling and stream termination indication.
For DSSM, streams are stateless. Error signalling is out of scope of DSSM. Senders and receivers have to agree on stream and stream state semantics as well as on error signalling.
The control characters
EM are used for signaling. The
ESC control character is used as a prefix for transmitting any of these control characters or for transmitting itself inside a stream.
Upon connection establishment of the underlying transport any data transmitted is considered to be sent by stream 0.
SOH signals a switch to another stream. The byte following the
SOH character is interpreted as the stream number (0..255). All following characters up to the next signal are part of the respective stream.
Stream termination indication
A stream sender can signal the "end" of the current stream by sending the
EM character followed by a status byte.
To DSSM there is no meaning of "end" of a stream or the stream "status". Especially, if a sender "ends" a stream and then continues sending data to the same stream, DSSM does not consider this an error.
Keep alive signaling
ENQ character is received, the receiver should send back an
NAK character before sending the next byte of the stream.
NAK is considered a good/bad status indication, or whether the failure to respond an
NAK has any meaning is completely up to the implementation of sender and receiver.
NAK signals are not considered an error and must be discarded by the receiver.
NAK signals can be used to keep an idle connection alive or to sense operational status of the opposite side.
ACK can be used by a sender to meter round trip delay, transmission queue sizes or to flush remote buffers.
NAK can be used to indicate fatal conditions or request restart of the underlying connection.
The receiver can choose to interpret a sequence of multiple
NAK characters or unsolicited
NAK characters as a denial of service attack. The same applies to sequences of stream switch or stream end signalling without interspersed stream data.
If the underlying transport is packet oriented, senders might decide to split the streams into pieces fitting into one packet.
Implementers must take care not to intermingle
NAK signals into an
The rationale for defining DSSM is to provide the
stderr backchannel for rush, the 'remote unsecure shell', inside a
single TCP connection in a leaner way than done by SSH.