GEOS SDK TechDocs

delassoc ...

elist ...

drivewalk

drivewalk

Examples:

"drivewalk"

Prints the table of drives known to the system.

Prints out all disk drives known to the system, along with their current status.

• The Flags column is a string of single character flags with the following meanings:

L

The drive is accessible to the local machine only, i.e. it's not visible over a network.

R

The drive is read-only.

F

Disks may be formatted in the drive.

A

The drive is actually an alias for a path on another drive.

B

The drive is busy, performing some extended operation, such as formatting or copying a disk.

r

The drive uses disks that may be removed by the user.

n

The drive is accessed over the network.

• The Locks column can reflect one of three states:

none

The drive isn't being accessed by any thread.

Excl

The drive is locked for exclusive access by a single thread.

<num>

The drive is locked for shared access for a particular disk, whose handle is the number. This is followed by the volume name of the disk, in square brackets.

See Also: diskwalk.

dumpstack

dumpstack [<address>] [<length>]

Examples:

"dumpstack"

dump the stack at SS:SP

"ds ds:si 10"

dump ten words starting at DS:SI

Dump the stack and perform some simple interpretation upon it.

• The <address> argument is the address of the list of words to dump. This defaults to SS:SP.
• The <length> argument is the number of words to dump. This defaults to 50.
• This dumps the stack and tries to make symbolic sense of the values, in terms of handles, segments, and routines.
• After doing a dumpstack, if you just hit return without entering a new command, by default you will see a continuation of the dumpstack.

See Also: backtrace.

dwordIsPtr

var dwordIsPtr [(0|1)]

Examples:

"var dwordIsPtr 1"

Tells "print" to print all double-word variables as if they were far pointers (segment:offset).

Controls whether dword (a.k.a. long) variables are printed as 32-bit unsigned integers or untyped far pointers.

• For debugging C code, a value of 0 is more appropriate, while 1 is best for debugging assembly language.
• The default value for this variable is 1.

See Also: intFormat, print.

dwords

dwords [<address>] [<length>]

Examples:

"dwords"

lists 4 double words at DS:SI

"dwords ds:di 8"

lists 8 double words at DS:DI

Examine memory as a dump of double words (32 bit hex numbers).

• The <address> argument is the address to examine. If not specified, the address after the last examined memory location is used. If no address has be examined then DS:SI is used for the address.
• The <length> argument is the number of dwords to examine. It defaults to 4.
• Pressing <Return> after this command continues the list.

See Also: bytes, words, imem, assign.

ec

ec [<args>]

Examples:

"ec"

list the error checking turned on

"ec +vm"

add vmem file structure checking

"ec all"

turn on all error checking (slow)

"ec save none"

save the current error checking and then use none

"ec restore"

use the saved error checking flags

Get or set the error checking level active in the kernel.

• The following arguments may occur in any combination:

< flag >

turn on <flag>

+< flag >

turn on <flag>

-< flag >

turn off <flag>

all

turn on all error checking flags

ALL

turn on all error checking flags

none

turn off all error checking flags

sum < handle >

turn on checksum checking for the memory block with the given handle ("ec sum bx"). The current contents of the block will be summed and that sum regenerated and checked for changes at strategic points in the system (e.g. when a call between modules occurs).

- sum

turn off checksum checking

save

save the current error checking

restore

restore the saved error checking flags where <flag> may be one of the following:

analVM

perform over-aggressive checking of vmem files

graphics

graphics checking

heapFree

heap free block checking

lmemFree

lmem free area checking

lmemInternal

internal lmem error checking

lmemObject

lmem object checking

normal

normal error checking

region

region checking segment extensive

segment

adds register checking to Swat. If this flag is turned on, Swat will check whether ds and es are valid memory handle at various points in the debugging cycle by calling ECCheckSegment() .

lmemMove

force lmem blocks to move whenever possible

unlockMove

forces unlocked blocks to move whenever possible. This ensures that your code isn't referencing into an unstable block location. I.e., a block which may move, but usually doesn't , therefore causing non-reproducible (and quite frustrating) errors.

vm

vmem file structure checking

vmemDiscard

force vmem blocks to be discarded if possible

• If there isn't an argument, `ec' reports the current error checking flags.
• Each time GEOS is run the ec flags are cleared. The saved flags are preserved between sessions. The ec flags may be saved and then restored after restarting GEOS so that the flag settings are not lost when restarting GEOS.

See Also: why.

echo

echo [-n] <string>+

Examples:

"echo -n yes?"

Prints "yes?" without a newline.

"echo hi mom"

Prints "hi mom" followed by a newline.

Prints its arguments, separated by spaces.

If the first argument is "-n", no newline is printed after the arguments.

See Also: flush-output.

GEOS SDK TechDocs

delassoc ...

elist ...