Commands



next up previous
Next: Future commands ... Up: The Remote Debug Protocol Previous: Protocol Details

Commands

All commands contain the major command number in octet zero of the message. This octet contains the error code in a reply, or zero for success. The error EOPNOTSUPP is returned if the command is not implemented on the server.

Tracing control

This command is used to control the dynamic debugging tracing that is available in the Wanda kernel. Tracing which was compiled in to be controllable at run time may be switched on or off using this command. This is command number 0. Octet 1 contains the index in the tracing control table. Octet 2 contains a mask indicating which bits in this position should be cleared. Octet 3 contains a set of bits which will be set. The meaning of these indexes and bits is kernel specific and comes from the kernel tracing control file. The unix program which uses this major command number is wkmem. The error EINVAL is returned if the index is too large.

Raw memory access

This command, which has value 1, is used to perform remote memory access. There are four minor commands defined, although some servers only implement the first two. A Unix program which uses this major command number is wprobe. The error EINVAL is returned if the minor command is not supported.

Read Word

Octet 1 contains the minor command number which is 1. Octets 4-7 contain, in network standard form, the address to be read. In the reply octets 8-11 contain the word value, in network standard form, of the memory at that location.

Write Word

Octet 1 contains the minor command number which is 2. Octets 4-7 contain, in network standard form, the address to be written. Octets 8-11 contain the word value, in network standard form, to be written to that address.

Read Block

Octet 1 contains the minor command number which is 3. Octet 2 contains the number of words to be read. Octets 4-7 contain, in network standard form, the base of the addresses to be read. In the reply octets 8-(7+4*n) contain the words read, each in network standard form.

Write Block

Octet 1 contains the minor command number which is 4. Octet 2 contains the number of words to be read. Octets 4-7 contain, in network standard form, the base of the addresses to be written. Octets 8-(7+4*n) contain the words to be written, each in network standard form.

Remote information protocol

This command is used to get information about the identity and state of a Wanda machine. It has major command number 2. In the reply octets 4-5 contain the 16 bit serial number of the machine (if any). Octets 6-11 contain the 802.2 allocated number of the machine (if any). Octets 12-15 contain the MSNL address of the sender of the rarp reply which gave this machine its MSNL address. This value will be zero if the machine booted from a bootserver. An example of a Unix program which uses this command number is wkinfo.

Spin

This command, which has number 3, is reserved for the use of the author and should neither be implemented or used in installed systems. It is mentioned here only for completeness.



next up previous
Next: Future commands ... Up: The Remote Debug Protocol Previous: Protocol Details



Richard Black