Procedure 9

Read Registers

capability

 

resource name length

 

resource name

 

paattern length

 

pattern

 

cookie

count

REQUEST

If the resource specified is known to the server and the access capability is valid the read procedure defined by the object associated with each register selected from the total available using the supplied pattern is envoked.

success = 0

valid = 1

register name length

 

register name

 

register value length

 

register value

 

cookie

 

:

 

valid = 0

eod

RESPONSE - success

Each entry contains the name of the register, the data returned by the read procedure and a cookie which is an opaque pointer to the next entry.
The cookie is used in the next Read Registers call to get more entries starting at a given point. The special cookie zero (all bits zero) can be used to get the entries starting at the beginning.
The eod flag has a value of TRUE if there are no more entries.
The valid flag is used to mark the end of the entries.

procedure status

RESPONSE - failure

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

1

invalid resource

3

capability invalid

8

application not responding

9

invalid cookie

10

application detected failure

13

invalid count

procedure status

XDR Specification

 
procedure   ReadRegisters (cap, res, patt, k, n)   returns(reply)
            capability    cap;
            resource    res;
            pattern    patt;
            cookie    k;
            unsigned   n;

            union switch (stat status)  {
                OK:
                regvallist    regvals;
                boolean    eod;
                default:
                struct   {}
            }  reply;

Implementation

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