noStructEnum

var noStructEnum [(0|1)]

Examples:

"var noStructEnum 1": Don't put "struct" or "enum" before the data type for variables that are structures or enumerated types.

Structure fields that are structures or enumerated types normally have "struct" or "enum" as part of their type description. This usually just clutters up the display, however, so this variable shuts off this prepending.

The default value of this variable is one.

See Also: print.

null

null <val>

Examples:

"null $sym": Sees if the symbol token stored in $sym is the empty string or "nil."

Checks to see if a string is either empty or "nil," special values returned by many commands when something isn't found or doesn't apply. Returns non-zero if <val> is either of these special values.

The notion of "nil" as a value comes from lisp.

See Also: index, range.

objbrk

objbrk [<obj address>] [<message>]

Examples:

"objbrk ds:si MSG_VIS_DRAW ": break when a MSG_VIS_DRAW reaches the object
"objbrk -p": Break when any message is sent to the process object.

Break when a particular message reaches a particular object.

If you do not give a <message> argument after the <obj> argument, the machine will stop when any message is delivered to the object.
<obj> is the address of the object to watch.
The <objbrk> argument to "objbrk del" is the token/number returned when you set the breakpoint.

See Also: objwatch, objmessagebrk, mwatch.

obj-class

objclass <obj-addr>

Examples:

"var cs [obj-class ^lbx:si]": Store the symbol token for the class of the object ^lbx:si in the variable $cs.

Figures out the class of an object, coping with unrelocated object blocks and the like.

The value return is a symbol token, as one would pass to the "symbol" command. Using "symbol name" or "symbol fullname" you can obtain the actual class name.
We decide whether to relocate the class pointer ourselves based on the LMF_RELOCATED bit in the LMBH_flags field of the object block's header. There are times, e.g. during the call to MSG_META_RELOCATE for an object, when this bit doesn't accurately reflect the state of the class pointer and we will return an error when we should not.

See Also: symbol.

objcount

objcount [-q] [-X] [-Y] [-b #] [-o #] [-p #]

Examples:

"objcount": count all objects
"objcount -p welcome": count all objects owned by welcome
"objcount -o *desktop::DiskDrives": count this one object
"objcount -b 0x3270": count all objects in this block.

Count up instances of various objects on the heap.

The first argument specifies the options:

q: quiet operation - no progress output (not applicable with X, Y)
o #: check only object #
b #: check ONLY block #
p #: check only blocks for patient #
c #: check only objects of class #
C #: check only objects of top-level class #
X: show general verbose info
Y: show search verbose info

Output fields:

direct: number of direct instances of this class
indirect: number if indirect instance of this class (i.e object's superclass is this class)
size: total size of instance data for this class (excludes instance data inherited from superclass)

Status output:

.: processing heap block
,: processing matching object's top-level class
;: processing matching object's non-top-level class

See Also: hwalk, objwalk, lhwalk.

obj-foreach-class

obj-foreach-class <function> <object> [<args>]

Examples:

"obj-foreach-class foo-callback ^lbx:si": calls foo-callback with each class in turn to which the object ^lbx:si belongs.

Processes all the classes to which an object belongs, calling a callback procedure for each class symbol in turn.

<function> is called with the symbol for the current class as its first argument, <object> as its second, and the arguments that follow <object> as its third and subsequent arguments.
<function> should return an empty string to continue up the class tree.
obj-foreach-class returns whatever <function> returned, if it halted processing before the root of the class tree was reached. It returns the empty string if <function> never returned a non-empty result.

See Also: obj-class.

GEOS SDK TechDocs |

memsize ... | Next:

objmessagebrk ...