home | help
LLDB(1) 		     General Commands Manual			 LLDB(1)

NAME
     lldb -- The debugger

SYNOPSIS
     lldb [-hvdexw] [-a arch] [-c core-file] [-l script-language]
	  [-s lldb-commands] [-n process-name] [-p pid] [[--] <PROGRAM-ARG1>
	  <PROGRAM-ARG2> ...]

DESCRIPTION
     lldb is the command line interface for the LLDB debugger library.	lldb can
     debug C, C++, Objective-C, and Objective-C++ programs.

     The following options are available:

     -h, --help
	     Prints out the usage information for the lldb debugger.  The --help
	     text may be more up-to-date and authoritative than the command line
	     options described in this man page.

     -v, --version
	     Prints out the version number of the lldb debugger.

     -a, --arch arch
	     Specifies which architecture lldb will use when launching the spec-
	     ified program (assuming the provided executable is built for multi-
	     ple architectures.)

     -f, --file filename
	     Specifies the executable file that lldb will be launching / attach-
	     ing to.

     -n, --attach-name process-name
	     Specifies	the  name  of  a currently-running process to attach to.
	     (or the name of a process to wait for if -w is used.)

     -w, --wait-for
	     When used in concert with	-n  process-name,  indicates  that  lldb
	     should wait for a new process of that name to be started -- and at-
	     tach to it as early in the process-launch as possible.

     -p, --attach-pid pid
	     Specifies a currently running process that lldb should attach to.

     -c, --core core-file
	     Specifies the core file to examine.

     -l, --script-language language
	     Tells  the  debugger  to  use  the specified scripting language for
	     user-defined scripts, rather than	the  default.	Valid  scripting
	     languages that can be specified include Python, Perl, Ruby and Tcl.
	     Currently only the Python extensions have been implemented.

     -d, --debug
	     Tells the debugger to print out extra information for debugging it-
	     self.

     -s, --source filename
	     Tells lldb to read in and execute the file "filename", which should
	     contain lldb commands.

     -e, --editor
	     Instructs lldb to open source files using the host's "external edi-
	     tor" mechanism.

     -x, --no-lldbinit
	     Do not automatically parse any '.lldbinit' files.

	     (If  you do not provide -f then the first argument will be the file
	     to be debugged so	'lldb  --  <filename>  [<ARG1>	[<ARG2>]]'  also
	     works.   Remember to end the options with "--" if any of your argu-
	     ments have a "-" in them.)

USING LLDB
     In lldb there is a help command which can be used to find descriptions  and
     examples  of  all lldb commands.  To get help on "breakpoint set" you would
     type "help breakpoint set".

     There is also an apropos command which will search the  help  text  of  all
     commands  for  a  given  term  --	this is useful for locating a command by
     topic.  For instance, "apropos breakpoint" will list any command  that  has
     the word "breakpoint" in its help text.

FILES
     lldb  will  read  settings/aliases/commands from three files at startup, if
     they exist.

     First, it will read a ~/.lldbinit-debugger command file.  If you are  using
     the  lldb command line interface, this is ~/.lldbinit-lldb.  If you are us-
     ing lldb inside a GUI debugger like Xcode this will  be  ~/.lldbinit-Xcode.
     This  is  a useful place to put settings that you want to apply only when a
     given lldb command interpreter is used.

     Second, ~/.lldbinit is read.

     Third, an .lldbinit file in the current working directory	(where	lldb  is
     started) will be read.

SEE ALSO
     The  LLDB	project  page http://lldb.llvm.org/ has many different resources
     for   lldb   users   --   the    gdb/lldb	  command    equivalence    page
     http://lldb.llvm.org/lldb-gdb.html can be especially helpful for users com-
     ing from gdb.

BUGS
     To report bugs, please visit http://llvm.org/bugs/

AUTHOR
     Maintained by the LLDB Team, http://lldb.llvm.org/

FreeBSD 11.1			December 16, 2015			 LLDB(1)

home | help