Procedure 5

Read Register

capability

 

resource name length

 

resource name

 

register name length

 

register name

 

REQUEST

If the register specified is known by the server for the resource specified and the access capability is valid the read procedure defined by the object associated with the register is envoked and the data obtained is returned.

success = 0

register value length

 

register value

 

RESPONSE - success

Register length is a 4 byte field which defines the length of the following register data in bytes.
Register value contains the data returned by the read procedure. Data in this field conforms to the XDR standard for the particular data type.

procedure status

RESPONSE - failure

procedure status which is non zero indicates the cause of the failure.

1

invalid resource

3

capability invalid

4

register not known

8

application not responding

10

application detected failure

procedure status

XDR Specification

 
procedure   ReadRegister (cap, res, reg)   returns(reply)
            capability    cap;
            resource    res;
            register    reg;

            union switch (stat status)  {
                OK:
                registervalue    v;
                default:
                struct   {}
            }  reply;

Implementation

This procedure is provided in versions 1 and 2 of the protocol.