Changeset View
Changeset View
Standalone View
Standalone View
share/man/man4/netdump.4
Show All 18 Lines | |||||
.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | .\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) | ||||
.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | .\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT | ||||
.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | .\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY | ||||
.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | .\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF | ||||
.\" SUCH DAMAGE. | .\" SUCH DAMAGE. | ||||
.\" | .\" | ||||
.\" $FreeBSD$ | .\" $FreeBSD$ | ||||
.\" | .\" | ||||
.Dd December 5, 2018 | .Dd August 30, 2019 | ||||
.Dt NETDUMP 4 | .Dt NETDUMP 4 | ||||
.Os | .Os | ||||
.Sh NAME | .Sh NAME | ||||
.Nm netdump | .Nm netdump | ||||
.Nd protocol for transmitting kernel dumps to a remote server | .Nd protocol for transmitting kernel dumps to a remote server | ||||
.Sh SYNOPSIS | .Sh SYNOPSIS | ||||
To compile netdump client support into the kernel, place the following line in | To compile netdump client support into the kernel, place the following line in | ||||
your kernel configuration file: | your kernel configuration file: | ||||
.Bd -ragged -offset indent | .Bd -ragged -offset indent | ||||
.Cd "options NETDUMP" | .Cd "options NETDUMP" | ||||
.Ed | .Ed | ||||
.Sh DESCRIPTION | .Sh DESCRIPTION | ||||
netdump is a UDP-based protocol for transmitting kernel dumps to a remote host. | netdump is a UDP-based protocol for transmitting kernel dumps to a remote host. | ||||
A netdump client is a panicking kernel, and a netdump server is a host | A netdump client is a panicking kernel, and a netdump server is a host | ||||
running the | running the | ||||
.Nm | .Nm | ||||
daemon, available in ports as | daemon, available in ports as | ||||
.Pa ports/ftp/netdumpd . | .Pa ports/ftp/netdumpd . | ||||
.Nm | .Nm | ||||
clients are configured using the | clients are configured using the | ||||
.Xr dumpon 8 | .Xr dumpon 8 | ||||
utility. | utility or the | ||||
.Ic netdump | |||||
command in | |||||
.Xr ddb 4 . | |||||
.Pp | .Pp | ||||
.Nm | .Nm | ||||
client messages consist of a fixed-size header followed by a variable-sized | client messages consist of a fixed-size header followed by a variable-sized | ||||
payload. | payload. | ||||
The header contains the message type, a sequence number, the offset of | The header contains the message type, a sequence number, the offset of | ||||
the payload data in the kernel dump, and the length of the payload data | the payload data in the kernel dump, and the length of the payload data | ||||
(not including the header). | (not including the header). | ||||
The message types are | The message types are | ||||
▲ Show 20 Lines • Show All 104 Lines • Show Last 20 Lines |