IDB(1)			       Intel(R) Debugger			IDB(1)



NAME
       idb - Intel(R) Debugger



SYNOPSIS
       idb [options...]	 [executable_file [core_file]]


DESCRIPTION
       The  Intel Debugger is a symbolic source code debugger that debugs pro-
       grams compiled by the Intel(R) C/C++  Compiler,	the  Intel(R)  Fortran
       Compiler,  and  the  GNU*  compilers (gcc, g++).	 For full source-level
       debugging, compile the  source  code  with  the	compiler  option  that
       includes	 the symbol table information in the compiled executable file.
       Intel IDB supports DBX and GDB modes. In the GDB mode,  Intel  Debugger
       operates like the GNU* Debugger, GDB*.

       For  full  details on Intel IDB, see opt/intel/idb/9.1.xxx/doc/Intel(R)
       Debugger Manual and /opt/intel/idb/9.1.xxx/doc/idb_release_notes.htm.



OPTIONS AND ARGUMENTS
       The DBX options are listed below and are followed by the GDB options


DBX mode options:
       -c <file>,-command <file>
		Specifies an initialization command file

       -cd <dir>
		Specifies a new working directory

       -echo	Causes the debugger to print the prompt when running in a non-
		interactive session

       -gdb	Turns on GDB mode

       -gui	Starts with GUI if avaliable

       -emacs,-fullname
		Starts the debugger under Emacs*

       -help	Prints a help message

       -i <file>
		Specifies a pre-initialization command file

       -I <dir> Searches for source files in directory

       -interactive
		Explicitly sets the interactive mode

       -interpreter <mode>
		Selects a mode interpreter interface

       -maxruntime <minutes>
		Specifies  the	maximum	 allowable  runtime in minutes for the
		debugging session

       -nosharedobjs
		Do not load symbolic information from shared objects

       -parallel <launcher> <launcher_args>
		Starts debugging session on a parallel application created  by
		launcher with arguments " <launcher_args>"

       -pid <pid>
		Specifies the process ID of the process to be debugged

       -prompt <string>
		Sets prompt string

       -quiet	Causes the debugger to start but not to print sign-on message

       -remote <[[protocol:]address:]port>
		Specifies address of remote agent

       -tty <terminal_device>
		Specifies the input/output tty device for the user program

       -V,-version
		Prints version information


GDB mode options:
       -cd <dir>
		Specifies a new working directory

       -command <file>
		Specifies an initialization command file

       -dbx	Turns on DBX mode

       -directory <dir>
		Searches for source files in dir

       -fullname
		Outputs information used by Emacs*-GDB interface

       -help	Prints a help message

       -i <mode>,-interpreter <mode>
		Selects a mode interpreter interface

       -nw,-nowindows
		Do not use a window interface

       -pid <pid>
		Specifies the process ID of the process to be debugged

       -quiet,-silent
		Causes the debugger to start but not to print sign-on message

       -tty <device>
		Uses device for input/output by the program being debugged

       -ui <mode>
		Selects a mode interpreter interface

       -version Prints version information



COMMANDS
       Enter Intel IDB commands at the debugger prompt.

       You can enter more than one command on the same line by separating each
       command with a semicolon.  Commands are executed in the same  order  in
       which they are entered in the command line.

       Continue	 command  input to another line by entering a backslash at the
       end of each line.

       The most frequently used commands are listed below:

	quit	Exit from the debugger.

	help [name]
		Show information about a command name or  general  information
		about using Inel IDB.

	run [arglist]
		Start your program (with arglist, if specified).

	where	Display program stack.

	print <expr>
		Display the value of expression expr.

	cont	Continue  running  your	 program  (after  stopping, e.g., at a
		breakpoint).

	next	Execute	 next  program line (after stopping);  step  over  any
		function calls in the line.

	step	Execute	 next  program	line  (after  stopping); step into any
		function calls in the line.

       For DBX mode only:

	stop in [function]
		Set breakpoint in a function.

	stop at [line]
		Set breakpoint at a specified line in the current file.

       For GDB mode only:

	break [function | line]
		Set breakpoint in a function or a specified line in  the  cur-
		rent file.


RESTRICTIONS
	The maximum command-line length is 255 characters.

	Alias commands may contain no more than 56 arguments.


FILES
	a.out	Default object file name.

	core	Default core dump file name.

	.idbrc and/or .dbxinit
		Initialization	file.  By default, Intel Debugger searches for
		these files at startup, first in  the  current	directory;  if
		they  are  not there, Intel Debugger searches your home direc-
		tory.


SEE ALSO
       Intel(R)	     Debugger	   Manual:	default	     location	    is
       opt/intel/idb/9.1.xxx/doc/idb_manual/index.htm



Copyright(C) 2006	       Intel Corporation			IDB(1)