[GUACAMOLE-661] Deprecate "nest" instruction

• Type: Improvement
• Status: Resolved
• Priority: Minor
• Resolution: Done
• Fix Version/s: 1.1.0
• Component/s: Documentation, libguac
• Assignee: Mike Jumper
• Reporter: Mike Jumper
• Created: 16/Nov/18 20:40
• Updated: 07/Jan/19 17:53
• Resolved: 07/Jan/19 17:53

Description

The "nest" instruction was created in the early days of the Guacamole protocol as a means of splitting up large instructions. At the time, this was necessary because images and audio were transmitted within instructions that required the entire block of data to be available at once. The "nest" instruction thus provided a means of streaming data for instructions that otherwise did not support it.

The Guacamole protocol switched over instructions with actual stream semantics around the 0.9.0 release (back in 2014). Since that time, the nest instruction has become unnecessary, and is actually no longer used in practice.

It's time the instruction and related functions/structures were deprecated.

Issue Links

• is related to: GUACAMOLE-662 Failing unit tests for guacamole-server not triggering build failure
• relates to: GUACAMOLE-510 Nested socket index is not initialized