Next: Standard Control Operations Up: x-Kernel Programmer's Manual Previous: ROM file parsing

Control Operations

Control operations are used to perform arbitrary operations on protocols and sessions, via the xControl operation described in section 2.2.12. xControl returns an integer that indicates the length in bytes of the information which was written into the buffer, or -1 to indicate an error.

All implementations of control operations should check the length field before reading or writing the buffer, returning -1 if the buffer is too small. The checkLen(actualLength, expectedLength) macro can be used for this.

The opcode field in xControl specifies the operation to be performed on the protocol or session. There are two ``classes'' of operations: standard ones that may be implemented by more than one protocol, and protocol-specific ones.



Tue Nov 29 16:28:56 MST 1994