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
.Pa vmcore.#
can be now examined using
.Xr kgdb 1 :
.Xr kgdb 1 Pq Pa ports/devel/gdb :
.Pp
.Dl # kgdb /boot/kernel/kernel vmcore.#
.Pp
@ -321,7 +321,7 @@ or shorter:
.Dl # kgdb -n #
.Pp
The core was decrypted properly if
.Xr kgdb 1
.Xr kgdb 1 Pq Pa ports/devel/gdb
does not print any errors.
Note that the live kernel might be at a different path
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.
.Sh SEE ALSO
.Xr gzip 1 ,
.Xr kgdb 1 ,
.Xr kgdb 1 Pq Pa ports/devel/gdb ,
.Xr zstd 1 ,
.Xr ddb 4 ,
.Xr netdump 4 ,

View File

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

View File

@ -58,7 +58,7 @@ representation, define:
.Ed
.Pp
To enable the
.Xr gdb 1
.Xr gdb 1 Pq Pa ports/devel/gdb
backend, so that remote debugging with
.Xr kgdb 1 Pq Pa ports/devel/gdb
is possible, include:
@ -69,7 +69,7 @@ is possible, include:
The
.Nm
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,
it can be invoked locally with the
.Ql debug
@ -1190,7 +1190,7 @@ subsystem.
.It Ic gdb
Switches to remote GDB mode.
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
console port on the target machine.
.Pp
@ -1598,7 +1598,7 @@ directory.
.Pa sys/vnode.h
.El
.Sh SEE ALSO
.Xr gdb 1 ,
.Xr gdb 1 Pq Pa ports/devel/gdb ,
.Xr kgdb 1 Pq Pa ports/devel/gdb ,
.Xr acpi 4 ,
.Xr CAM 4 ,

View File

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

View File

@ -386,7 +386,7 @@ The
.Dv N_STAB
mask selects bits of interest to symbolic debuggers
such as
.Xr gdb 1 ;
.Xr gdb 1 Pq Pa ports/devel/gdb ;
the values are described in
.Xr stab 5 .
.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.
.Sh SEE ALSO
.Xr as 1 ,
.Xr gdb 1 ,
.Xr gdb 1 Pq Pa ports/devel/gdb ,
.Xr ld 1 ,
.Xr brk 2 ,
.Xr execve 2 ,

View File

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

View File

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

View File

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

View File

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

View File

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

View File

@ -178,7 +178,7 @@ debuggers available prior to
.Bx 4.4 Lite
were able to find some information
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
for any meaningful analysis.
.Pp

View File

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