Procedure 8

Inquire Registers

capability

 

resource name length

 

resource name

 

pattern length

 

pattern

 

cookie

count

REQUEST

If the resource specified is known by the server and the access capability is valid those register names known by the server for the resource are returned with a total size of up to count bytes.
The pattern string supplied is used to select the set of registers to be returned from the total available.

success = 0

valid = 1

register name length

 

register name

 

cookie

 

:

 

valid = 0

eod

RESPONSE - success

Each entry contains the name of the register and a cookie which is an opaque pointer to the next entry. The cookie is used in the next Inquire 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

9

invalid cookie

13

count invalid

procedure status

XDR Specification

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

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

Implementation

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