Procedure 18

Read Class Names

capability

 

resource name length

 

resource name

 

paattern length

 

pattern

 

cookie

count

REQUEST

If the resource specified is known by the server and the access capability is valid those register names and the associated class names known by the server for the resource, as defined in Procedure 3, 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

 

class name length

 

class name

 

cookie

 

:

 

valid = 0

eod

RESPONSE - success

Each entry contains the name of the register, its associated class name and a cookie which is an opaque pointer to the next entry.
The cookie is used in the next Read Class Names 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

invalid count

procedure status

XDR Specification

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

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

Implementation

N.B. This procedure is provided from version 2 of the protocol.