User`s guide

Invoking dbx

dbx

Options

Table 2-1 lists options you can give to dbx. These options are described in

detail later in this chapter.

Table 2-1 dbx Command-Line Options

Option Description

–I dir Tells dbx to look in the speciﬁed directory (in addition to the

current directory and the object ﬁle’s directory) for source

ﬁles. To specify multiple directories, use a separate –I for

each. If no directory is speciﬁed when you invokedbx, it

looks for source ﬁles in the current directory and in the

object ﬁle’s directory. From dbx, changes the directories

searched for source ﬁles with the use and dir commands.

–c ﬁle Selects a command ﬁle other than .dbxinit to execute on

startingdbx. For information on .dbxinit, see “Automatically

Executing Commands on Startup.”

–e num Chooses a large size for the evaluation stack (as large as you

want). The default stack size is 20,000 bytes. num = number

of bytes. If you see the message too large to evaluate,

rerun dbx suppling a value greater than 20,000.

–k Turns on kernel debugging. When debugging a running

system, specify /dev/kmem as the core ﬁle.

–i Uses interactive mode. This option prompts for source even

when it reads from a ﬁle and treats data in a ﬁle as if it comes

from a terminal (stdin). This option does not treat “#”

characters as comments in a ﬁle.

–p pid Debugs the process speciﬁed by thepid number.

–P name Debugs the running process with the speciﬁed name (name as

described in the ps(1) reference page).

–r program [arg] Runs the named program upon entering dbx, using the

speciﬁed arguments. The .dbxinit ﬁle (if any) is read and

executedafter executing the object_ﬁle. You cannot specify a

core ﬁle with –r.