binutils-gdb/gdb/doc
John Baldwin 6e9567fe2a Add support for LWP-based threads on FreeBSD.
Older versions of FreeBSD supported userland threading via a pure
user-space threading library (N threads scheduled on 1 process) and
a N:M model (N threads scheduled on M LWPs).  However, modern FreeBSD
versions only support a M:M threading model where each user thread is
backed by a dedicated LWP.  This thread target only supports this
threading model.  It also uses ptrace to query and alter LWP state
directly rather than using libthread_db to simplify the implementation.

FreeBSD recently gained support for reporting LWP events (birth and death
of LWPs).  GDB will use LWP events when present.  For older systems it
fetches the list of LWPs in the to_update_thread_list target op to update
the list of threads on each stop.

This target supports scheduler locking by using ptrace to suspend
individual LWPs as necessary before resuming a process.

gdb/ChangeLog:

	* configure.ac: Check for support for LWP names on FreeBSD.
	* fbsd-nat.c [PT_LWPINFO] New variable debug_fbsd_lwp.
	[TDP_RFPPWAIT || HAVE_STRUCT_PTRACE_LWPINFO_PL_TDNAME]
	(fbsd_fetch_kinfo_proc): Move function earlier.
	[PT_LWPINFO] (fbsd_thread_alive): New function.
	[PT_LWPINFO] (fbsd_pid_to_str): New function.
	[HAVE_STRUCT_PTRACE_LWPINFO_PL_TDNAME] (fbsd_thread_name): New function.
	[PT_LWP_EVENTS] (fbsd_enable_lwp_events): New function.
	[PT_LWPINFO] (fbsd_add_threads): New function.
	[PT_LWPINFO] (fbsd_update_thread_list): New function.
	[PT_LWPINFO] New variable super_resume.
	[PT_LWPINFO] (resume_one_thread_cb): New function.
	[PT_LWPINFO] (resume_all_threads_cb): New function.
	[PT_LWPINFO] (fbsd_resume): New function.
	(fbsd_remember_child): Save full ptid instead of plain pid.
	(fbsd_is_child_pending): Return ptid of saved child process.
	(fbsd_wait): Include lwp in returned ptid and switch to LWP ptid on
	first stop.
	[PT_LWP_EVENTS] Handle LWP events.
	[TDP_RFPPWAIT] Include LWP in child ptid.
	(fbsd_post_startup_inferior) [PT_LWP_EVENTS]: Enable LWP events.
	(fbsd_post_attach) [PT_LWP_EVENTS]: Enable LWP events.
	Add threads for existing processes.
	(fbsd_nat_add_target) [PT_LWPINFO]: Set "to_thread_alive" to
	"fbsd_thread_alive".
	Set "to_pid_to_str" to "fbsd_pid_to_str".
	[HAVE_STRUCT_PTRACE_LWPINFO_PL_TDNAME]: Set "to_thread_name" to
	"fbsd_thread_name".
	[PT_LWPINFO]: Set "to_update_thread_list" to "fbsd_update_thread_list".
	Set "to_has_thread_control" to "tc_schedlock".
	Set "to_resume" to "fbsd_resume".
	(_initialize_fbsd_nat): New function.
	* configure: Regenerate.
	* config.in: Regenerate.

gdb/doc/ChangeLog:

	* gdb.texinfo (Debugging Output): Document "set/show debug fbsd-lwp".
2016-01-19 08:19:00 -08:00
..
a4rc.sed
agentexpr.texi GDB copyright headers update after running GDB's copyright.py script. 2016-01-01 08:43:22 +04:00
all-cfg.texi GDB copyright headers update after running GDB's copyright.py script. 2016-01-01 08:43:22 +04:00
annotate.texinfo GDB copyright headers update after running GDB's copyright.py script. 2016-01-01 08:43:22 +04:00
ChangeLog Add support for LWP-based threads on FreeBSD. 2016-01-19 08:19:00 -08:00
doxy-index.in GDB copyright headers update after running GDB's copyright.py script. 2016-01-01 08:43:22 +04:00
Doxyfile-base.in GDB copyright headers update after running GDB's copyright.py script. 2016-01-01 08:43:22 +04:00
Doxyfile-gdb-api.in GDB copyright headers update after running GDB's copyright.py script. 2016-01-01 08:43:22 +04:00
Doxyfile-gdb-xref.in GDB copyright headers update after running GDB's copyright.py script. 2016-01-01 08:43:22 +04:00
Doxyfile-gdbserver.in GDB copyright headers update after running GDB's copyright.py script. 2016-01-01 08:43:22 +04:00
fdl.texi
filter-for-doxygen Add Doxygen support to GDB 2014-02-10 19:10:34 -08:00
filter-params.pl Add Doxygen support to GDB 2014-02-10 19:10:34 -08:00
gdb.texinfo Add support for LWP-based threads on FreeBSD. 2016-01-19 08:19:00 -08:00
gpl.texi
guile.texi Per-inferior/Inferior-qualified thread IDs 2016-01-13 10:59:43 +00:00
lpsrc.sed
Makefile.in GDB copyright headers update after running GDB's copyright.py script. 2016-01-01 08:43:22 +04:00
observer.texi GDB copyright headers update after running GDB's copyright.py script. 2016-01-01 08:43:22 +04:00
psrc.sed
python.texi Add Python InferiorThread.global_num attribute 2016-01-13 11:00:54 +00:00
refcard.tex GDB copyright headers update after running GDB's copyright.py script. 2016-01-01 08:43:22 +04:00
stabs.texinfo GDB copyright headers update after running GDB's copyright.py script. 2016-01-01 08:43:22 +04:00
stack_frame.eps
stack_frame.pdf
stack_frame.png
stack_frame.svg
stack_frame.txt