GEOS SDK TechDocs

drivewalk ...

fatalerr_auto_explain ...

elist

elist [<patient>]

Examples:

"elist"

list the events for the current thread and patient

"elist ui"

list the events for the last thread of the ui patient

"elist :1"

list the events for the first thread of the current patient

"elist geos:2"

list the events for the second thread of the GEOS patient

Display all events pending for a patient.

The <patient> argument is of the form `patient:thread'. Each part of the patient name is optional, and if nothing is specified then the current patient is listed.

See Also: showcalls.

ensure-swat-attached

ensure-swat-attached

Examples:

"ensure-swat-attached"

Stop if Swat isn't attached to GEOS.

If Swat is not attached to GEOS, display an error and stop a command.

Use this command at the start of any other command that accesses the target PC. Doing so protects the user from the numerous warnings that can result from an attempt to read memory when not attached.

eqfind

eqfind [-p]

Examples:

"eqfind" list all event queues in the system.

"eqfind -p" list and print all event queues in the system.

Display all event queues in the system.

See Also: elist, eqlist, erfind.

eqlist

eqlist <queue handle> <name>

Examples:

"eqlist 8320 geos:2"

show the event list for geos:2

Display all events in a queue.

• The queue handle argument is the handle to a queue.
• The name argument is the name of the queue.

See Also: elist.

erfind

erfind [-p]

Examples:

"erfind" list all recorded event handles in the system.

"erfind -p" list and print all recorded event handles in the system.

Display all record event handles in the system. These are events that have been recorded but not necessarily sent anywhere, so they will not appear in the queue of any thread.

See Also: elist, eqlist, eqfind, pevent.

exit

exit <patient>

Examples:

"exit faxmon"

Causes the faxmon application to exit.

Sends messages required to make an application quit.

This command does nothing when you're stopped at FatalError , as it will wait until the machine is idle before attempting to send MSG_META_QUIT ; continuing from FatalError will cause the system to exit.

See Also: run.

exit-thread

exit-thread [<exit-code>]

Examples:

"exit-thread"

Exit the current thread, returning zero to its parent.

"exit-thread 1"

Exit the current thread, returning one to its parent.

Exit the current thread.

• The exit code argument is the status to return to the current thread's parent, which defaults to zero.
• Do not invoke this function for an event-driven thread; send it a MSG_META_DETACH instead.

See Also: quit.

explain

explain

Examples: "explain"

Print a more detailed description of why the system crashed, if possible.

• This must be run from within the frame of the FatalError() function. Sometimes GEOS is not quite there. In this case, step an instruction or two and then try the "why" command again.
• This simply looks up the enumerated constant for the error code in the AX register in the FatalErrors enumerated type defined by the geode that called FatalError() . For example, if a function in the kernel called FatalError() , AX would be looked up in geos::FatalErrors, while if a function in your application called FatalError() , this function would look it up in the FatalErrors type defined by your application. Each assembly application defines this enumerated type by virtue of having included ec.def .
• This command also relies on programmers having explained their FatalErrors when defining them.
• For certain fatal errors, additional information is provided by invoking the command <patient>::<error code name>, if it exists.

explode

explode <string> [<sep-set>]

Examples:

"explode $args"

Breaks the string stored in the variable "args" into a list of its individual letters.

"explode $file /"

Breaks the string stored in the variable "file" into a list of its components, using "/" as the boundary between components when performing the split.

Breaks a string into a list of its component letters, allowing them to be handled quickly via a foreach loop, or the map or mapconcat commands.

This is especially useful for parsing command switches.

See Also: foreach, index, range.

GEOS SDK TechDocs

drivewalk ...

fatalerr_auto_explain ...