Indicate which port gdb.1 and kgdb.1 come from.

This commit is contained in:
Jens Schweikhardt 2022-08-17 19:13:22 +02:00
parent fa46f3704b
commit 3c405c7e83
13 changed files with 36 additions and 36 deletions

View File

@ -312,7 +312,7 @@ or shorter:
The The
.Pa vmcore.# .Pa vmcore.#
can be now examined using can be now examined using
.Xr kgdb 1 : .Xr kgdb 1 Pq Pa ports/devel/gdb :
.Pp .Pp
.Dl # kgdb /boot/kernel/kernel vmcore.# .Dl # kgdb /boot/kernel/kernel vmcore.#
.Pp .Pp
@ -321,7 +321,7 @@ or shorter:
.Dl # kgdb -n # .Dl # kgdb -n #
.Pp .Pp
The core was decrypted properly if The core was decrypted properly if
.Xr kgdb 1 .Xr kgdb 1 Pq Pa ports/devel/gdb
does not print any errors. does not print any errors.
Note that the live kernel might be at a different path Note that the live kernel might be at a different path
which can be examined by looking at the which can be examined by looking at the
@ -368,7 +368,7 @@ Be sure to fill in the server IP address and change the interface name if
needed. needed.
.Sh SEE ALSO .Sh SEE ALSO
.Xr gzip 1 , .Xr gzip 1 ,
.Xr kgdb 1 , .Xr kgdb 1 Pq Pa ports/devel/gdb ,
.Xr zstd 1 , .Xr zstd 1 ,
.Xr ddb 4 , .Xr ddb 4 ,
.Xr netdump 4 , .Xr netdump 4 ,

View File

@ -102,7 +102,7 @@ for more details.
If you want to use If you want to use
.Nm .Nm
as a as a
.Xr gdb 1 .Xr gdb 1 Pq Pa ports/devel/gdb
port, add the following line into port, add the following line into
.Xr loader.conf 5 : .Xr loader.conf 5 :
.Bd -literal -offset indent .Bd -literal -offset indent

View File

@ -58,7 +58,7 @@ representation, define:
.Ed .Ed
.Pp .Pp
To enable the To enable the
.Xr gdb 1 .Xr gdb 1 Pq Pa ports/devel/gdb
backend, so that remote debugging with backend, so that remote debugging with
.Xr kgdb 1 Pq Pa ports/devel/gdb .Xr kgdb 1 Pq Pa ports/devel/gdb
is possible, include: is possible, include:
@ -69,7 +69,7 @@ is possible, include:
The The
.Nm .Nm
kernel debugger is an interactive debugger with a syntax inspired by kernel debugger is an interactive debugger with a syntax inspired by
.Xr gdb 1 . .Xr gdb 1 Pq Pa ports/devel/gdb .
If linked into the running kernel, If linked into the running kernel,
it can be invoked locally with the it can be invoked locally with the
.Ql debug .Ql debug
@ -1190,7 +1190,7 @@ subsystem.
.It Ic gdb .It Ic gdb
Switches to remote GDB mode. Switches to remote GDB mode.
In remote GDB mode, another machine is required that runs In remote GDB mode, another machine is required that runs
.Xr gdb 1 .Xr gdb 1 Pq Pa ports/devel/gdb
using the remote debug feature, with a connection to the serial using the remote debug feature, with a connection to the serial
console port on the target machine. console port on the target machine.
.Pp .Pp
@ -1598,7 +1598,7 @@ directory.
.Pa sys/vnode.h .Pa sys/vnode.h
.El .El
.Sh SEE ALSO .Sh SEE ALSO
.Xr gdb 1 , .Xr gdb 1 Pq Pa ports/devel/gdb ,
.Xr kgdb 1 Pq Pa ports/devel/gdb , .Xr kgdb 1 Pq Pa ports/devel/gdb ,
.Xr acpi 4 , .Xr acpi 4 ,
.Xr CAM 4 , .Xr CAM 4 ,

View File

@ -37,7 +37,7 @@
The The
.Nm .Nm
kernel debugger is a variation of kernel debugger is a variation of
.Xr gdb 1 .Xr gdb 1 Pq Pa ports/devel/gdb
which understands some aspects of the which understands some aspects of the
.Fx .Fx
kernel environment. kernel environment.
@ -90,7 +90,7 @@ on,
In this mode, you need the In this mode, you need the
.Fl k .Fl k
flag to indicate to flag to indicate to
.Xr gdb 1 .Xr gdb 1 Pq Pa ports/devel/gdb
that the that the
.Dq "dump file" .Dq "dump file"
.Pa /dev/mem .Pa /dev/mem
@ -336,9 +336,9 @@ The remote system continues to run.
The user interface to The user interface to
.Nm .Nm
is via is via
.Xr gdb 1 , .Xr gdb 1 Pq Pa ports/devel/gdb ,
so so
.Xr gdb 1 .Xr gdb 1 Pq Pa ports/devel/gdb
commands also work. commands also work.
This section discusses only the extensions for kernel debugging that get This section discusses only the extensions for kernel debugging that get
installed in the kernel build directory. installed in the kernel build directory.
@ -387,7 +387,7 @@ are convenience commands which invoke
.Ss "The current process environment" .Ss "The current process environment"
The following macros are convenience functions intended to make things easier The following macros are convenience functions intended to make things easier
than the standard than the standard
.Xr gdb 1 .Xr gdb 1 Pq Pa ports/devel/gdb
commands. commands.
.Bl -tag -width indent .Bl -tag -width indent
.It Ic f0 .It Ic f0
@ -467,7 +467,7 @@ Show some PCB contents of the process
.El .El
.Ss "Examining data structures" .Ss "Examining data structures"
You can use standard You can use standard
.Xr gdb 1 .Xr gdb 1 Pq Pa ports/devel/gdb
commands to look at most data structures. commands to look at most data structures.
The macros in this section are The macros in this section are
convenience functions which typically display the data in a more readable convenience functions which typically display the data in a more readable
@ -568,7 +568,7 @@ It does nothing else except to print a warning
message to remind you to remove it again. message to remind you to remove it again.
.El .El
.Sh SEE ALSO .Sh SEE ALSO
.Xr gdb 1 , .Xr gdb 1 Pq Pa ports/devel/gdb ,
.Xr ps 1 , .Xr ps 1 ,
.Xr ddb 4 , .Xr ddb 4 ,
.Xr firewire 4 , .Xr firewire 4 ,
@ -581,7 +581,7 @@ This man page was written by
.An Greg Lehey Aq Mt grog@FreeBSD.org . .An Greg Lehey Aq Mt grog@FreeBSD.org .
.Sh BUGS .Sh BUGS
The The
.Xr gdb 1 .Xr gdb 1 Pq Pa ports/devel/gdb
debugger debugger
was never designed to debug kernels, and it is not a very good match. was never designed to debug kernels, and it is not a very good match.
Many problems exist. Many problems exist.

View File

@ -299,7 +299,7 @@ driver also includes a character device interface that can be used for
additional diagnostics, configuration and debugging. additional diagnostics, configuration and debugging.
With this character With this character
device interface, and a specially patched version of device interface, and a specially patched version of
.Xr gdb 1 , .Xr gdb 1 Pq Pa ports/devel/gdb ,
the user can the user can
debug firmware running on the Tigon board. debug firmware running on the Tigon board.
.Pp .Pp

View File

@ -386,7 +386,7 @@ The
.Dv N_STAB .Dv N_STAB
mask selects bits of interest to symbolic debuggers mask selects bits of interest to symbolic debuggers
such as such as
.Xr gdb 1 ; .Xr gdb 1 Pq Pa ports/devel/gdb ;
the values are described in the values are described in
.Xr stab 5 . .Xr stab 5 .
.It Fa n_other .It Fa n_other
@ -429,7 +429,7 @@ so its minimum value (or the offset of the first string)
is always 4 on 32-bit machines. is always 4 on 32-bit machines.
.Sh SEE ALSO .Sh SEE ALSO
.Xr as 1 , .Xr as 1 ,
.Xr gdb 1 , .Xr gdb 1 Pq Pa ports/devel/gdb ,
.Xr ld 1 , .Xr ld 1 ,
.Xr brk 2 , .Xr brk 2 ,
.Xr execve 2 , .Xr execve 2 ,

View File

@ -177,7 +177,7 @@ command can be used:
.Pp .Pp
.Dl sysctl kern.corefile=/var/coredumps/\&%U/\&%N.core .Dl sysctl kern.corefile=/var/coredumps/\&%U/\&%N.core
.Sh SEE ALSO .Sh SEE ALSO
.Xr gdb 1 , .Xr gdb 1 Pq Pa ports/devel/gdb ,
.Xr gzip 1 , .Xr gzip 1 ,
.Xr kgdb 1 Pq Pa ports/devel/gdb , .Xr kgdb 1 Pq Pa ports/devel/gdb ,
.Xr setrlimit 2 , .Xr setrlimit 2 ,

View File

@ -1387,7 +1387,7 @@ writeable and executable.
.El .El
.Sh SEE ALSO .Sh SEE ALSO
.Xr as 1 , .Xr as 1 ,
.Xr gdb 1 , .Xr gdb 1 Pq Pa ports/devel/gdb ,
.Xr ld 1 , .Xr ld 1 ,
.Xr objdump 1 , .Xr objdump 1 ,
.Xr readelf 1 , .Xr readelf 1 ,

View File

@ -4685,7 +4685,7 @@ The default is 10.
.El .El
.Sh SEE ALSO .Sh SEE ALSO
.Xr chmod 1 , .Xr chmod 1 ,
.Xr gdb 1 , .Xr gdb 1 Pq Pa ports/devel/gdb ,
.Xr info 1 , .Xr info 1 ,
.Xr kbdcontrol 1 , .Xr kbdcontrol 1 ,
.Xr limits 1 , .Xr limits 1 ,

View File

@ -61,7 +61,7 @@ style
fashion. fashion.
These events can then be dumped with These events can then be dumped with
.Xr ddb 4 , .Xr ddb 4 ,
.Xr gdb 1 .Xr gdb 1 Pq Pa ports/devel/gdb
or or
.Xr ktrdump 8 . .Xr ktrdump 8 .
.Pp .Pp

View File

@ -46,7 +46,7 @@ The
.Nm .Nm
utility creates a core image of the specified process, utility creates a core image of the specified process,
suitable for use with suitable for use with
.Xr gdb 1 . .Xr gdb 1 Pq Pa ports/devel/gdb .
By default, the core is written to the file By default, the core is written to the file
.Dq Pa core.<pid> . .Dq Pa core.<pid> .
The process identifier, The process identifier,
@ -96,7 +96,7 @@ usage
may not work with processes which are actively being investigated with may not work with processes which are actively being investigated with
.Xr truss 1 .Xr truss 1
or or
.Xr gdb 1 . .Xr gdb 1 Pq Pa ports/devel/gdb .
Additionally, interruptable sleeps may exit with EINTR. Additionally, interruptable sleeps may exit with EINTR.
.Pp .Pp
The The

View File

@ -178,7 +178,7 @@ debuggers available prior to
.Bx 4.4 Lite .Bx 4.4 Lite
were able to find some information were able to find some information
from a normal kernel; from a normal kernel;
.Xr gdb 1 .Xr gdb 1 Pq Pa ports/devel/gdb
provides very little support for normal kernels, and a debug kernel is needed provides very little support for normal kernels, and a debug kernel is needed
for any meaningful analysis. for any meaningful analysis.
.Pp .Pp

View File

@ -79,16 +79,16 @@ utility and the
.Xr dcons 4 .Xr dcons 4
driver communicate using 2 ports, one for the console port and another driver communicate using 2 ports, one for the console port and another
for remote for remote
.Xr gdb 1 .Xr gdb 1 Pq Pa ports/devel/gdb
port. port.
Users are supposed to access Users are supposed to access
.Nm .Nm
using TTY, using TTY,
.Xr telnet 1 .Xr telnet 1
and and
.Xr gdb 1 . .Xr gdb 1 Pq Pa ports/devel/gdb .
You can specify listen ports for console and You can specify listen ports for console and
.Xr gdb 1 .Xr gdb 1 Pq Pa ports/devel/gdb
port using the port using the
.Fl C .Fl C
and and
@ -129,7 +129,7 @@ The following options are supported.
Translate Ctrl-C to ALT_BREAK (CR + Translate Ctrl-C to ALT_BREAK (CR +
.Ql ~ .Ql ~
+ Ctrl-B) on + Ctrl-B) on
.Xr gdb 1 .Xr gdb 1 Pq Pa ports/devel/gdb
port. port.
.It Fl r .It Fl r
Replay old buffer on connection. Replay old buffer on connection.
@ -169,7 +169,7 @@ Specify the console port.
The default value is 0 (stdin/stdout). The default value is 0 (stdin/stdout).
.It Fl G Ar gdb_port .It Fl G Ar gdb_port
Specify Specify
.Xr gdb 1 .Xr gdb 1 Pq Pa ports/devel/gdb
port. port.
The default value is \-1 (disabled). The default value is \-1 (disabled).
.It Fl M Ar core .It Fl M Ar core
@ -252,9 +252,9 @@ To quit the session, type CR +
in the console port. in the console port.
.Pp .Pp
Using Using
.Xr gdb 1 .Xr gdb 1 Pq Pa ports/devel/gdb
port is almost the same as remote port is almost the same as remote
.Xr gdb 1 .Xr gdb 1 Pq Pa ports/devel/gdb
over serial line except over serial line except
using TCP/IP instead of using TCP/IP instead of
.Pa /dev/cu* . .Pa /dev/cu* .
@ -271,13 +271,13 @@ for details.
.Ed .Ed
.Pp .Pp
Once Once
.Xr gdb 1 .Xr gdb 1 Pq Pa ports/devel/gdb
is attached and you specified the is attached and you specified the
.Fl b .Fl b
option to option to
.Nm , .Nm ,
typing Ctrl-C in typing Ctrl-C in
.Xr gdb 1 .Xr gdb 1 Pq Pa ports/devel/gdb
causes a break to debugger. causes a break to debugger.
.Pp .Pp
The following command gets the console log from the crash dump: The following command gets the console log from the crash dump:
@ -311,7 +311,7 @@ console remote {
} }
.Ed .Ed
.Sh SEE ALSO .Sh SEE ALSO
.Xr gdb 1 , .Xr gdb 1 Pq Pa ports/devel/gdb ,
.Xr telnet 1 , .Xr telnet 1 ,
.Xr kvm 3 , .Xr kvm 3 ,
.Xr dcons 4 , .Xr dcons 4 ,