Indicate which port gdb.1 and kgdb.1 come from.
This commit is contained in:
parent
fa46f3704b
commit
3c405c7e83
@ -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 ,
|
||||||
|
@ -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
|
||||||
|
@ -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 ,
|
||||||
|
@ -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.
|
||||||
|
@ -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
|
||||||
|
@ -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 ,
|
||||||
|
@ -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 ,
|
||||||
|
@ -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 ,
|
||||||
|
@ -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 ,
|
||||||
|
@ -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
|
||||||
|
@ -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
|
||||||
|
@ -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
|
||||||
|
@ -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 ,
|
||||||
|
Loading…
Reference in New Issue
Block a user