Procedure 15

Read Attributes

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 attribute string 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

 

attribute value length

 

attribute value

 

cookie

 

:

 

valid = 0

eod

RESPONSE - success

Each entry contains the name of the register, its associated attribute string and a cookie which is an opaque pointer to the next entry.
The cookie is used in the next Read Attributes 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   ReadAttributes (cap, res, patt, k, n)   returns(reply)
            capability    cap;
            resource    res;
            pattern    patt;
            cookie    k;
            unsigned   n;

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

Implementation

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