AcornSearch - Acorn and RISC OS information searching
RISC OS Search
containing
"Nutty quip goes here!"
Home  |  About  |  Filebase Archive  |  StrongHelp Manuals  |  Newsgroups  |  Module Database
=>     R0 =     flags
     R1 =     Freeway type number
     R2 =     pointer to object name, 0 terminated
     R3 =     length of buffer for object descriptor
     R4 =     pointer to buffer for object descriptor, or 0
     R5 =     authentication value if present, otherwise undefined
<=     R3 =     length of held object descriptor
     R5 =     IP address of computer which holds the object

This SWI reads information about the attributes of an object. The type number
and object name must be provided. The SWI returns the IP address of the
holder, and optionally the descriptor. The length of a held object descriptor
may be read by setting R4 to 0 on entry. However
in this case there is no guarantee that the object attributes will not have
changed, or that the object will still exist, if the SWI is called again some
time later.

An error is returned if the type number is unknown, or the object name is
unknown, or if a supplied authentication value does not match the object's
own authentication value, or if a supplied object descriptor buffer is too
short;  in this case the actual length is returned in R3.
bit     /meaning/
0     1 =     authentication value provided
1-31     reserved - must be set to 0

[sh-index] Back to list of manuals