Skip to content
Mazin Assanie edited this page Oct 5, 2016 · 10 revisions

debug

Contains commands that provide access to Soar's internals. Most users will not need to access these commands.

Usage

debug allocate [pool blocks]
debug internal-symbols
debug port

Sub-Commands

allocate

Allocate additional 32 kilobyte blocks of memory for a specified memory pool without running Soar.

Usage

allocate [pool blocks]

Description

Soar allocates blocks of memory for its memory pools as it is needed during a run (or during other actions like loading productions). Unfortunately, this behavior translates to an increased run time for the first run of a memory-intensive agent. To mitigate this, blocks can be allocated before a run by using this command.

Issuing the command with no parameters lists current pool usage, exactly like stats command's memory flag.

Issuing the command with part of a pool's name and a positive integer will allocate that many additional blocks for the specified pool. Only the first few letters of the pool's name are necessary. If more than one pool starts with the given letters, which pool will be chosen is unspecified.

Memory pool block size in this context is approximately 32 kilobytes, the exact size determined during agent initialization.

internal-symbols

The internal-symbols command prints information about the Soar symbol table. Such information is typically only useful for users attempting to debug Soar by locating memory leaks or examining I/O structure.

port

Returns the port the kernel instance is listening on.

See Also

stats

Clone this wiki locally