.\" Automatically generated by Pandoc 2.2.1
.\"
.TH "NETCONSOLE\-SETUP" "8" "2018\-10\-30" "netconsole\-setup" "netconsole\-setup's Manual"
.hy
.SH NAME
.PP
netconsole\-setup \- Dynamically configure Linux netconsole
.SH SYNOPSIS
.PP
\f[B]netconsole\-setup\f[]
[[\f[B]+\f[]][\f[B]target\-port\f[]]\@]\f[B]target\-host\f[] \&...
.SH DESCRIPTION
.PP
Netconsole is a Linux kernel module that sends all kernel log messages
over the network to another computer.
It was designed to be as instantaneous as possible, to enable the
logging of even the most critical kernel bugs.
It works from IRQ contexts as well, and does not enable interrupts while
sending packets.
Due to these unique needs, only IP networks, UDP packets and Ethernet
devices are supported.
.PP
\f[B]netconsole\-setup\f[] eases the configuration of the netconsole by
just taking the target hostname or IP address.
It determines all the needed configuration values from the running
network device (like network interface, target IP and MAC address).
Multiple target hosts can be specified.
Each host can be prefixed with a target port and a plus sign to enable
extended console support.
.SH OPTIONS
.TP
.B \f[B]+\f[]
if present, enable extended console support for this host
.RS
.RE
.TP
.B \f[B]target\-port\f[]
port for logging agent (kernel default is port 6666)
.RS
.RE
.TP
.B \f[B]target\-host\f[]
hostname or IP address for logging agent
.RS
.RE
.SH EXAMPLES
.IP
.nf
\f[C]
netconsole\-setup\ loghost
\f[]
.fi
.PP
sends all kernel log messages to host \f[I]loghost\f[].
.IP
.nf
\f[C]
netconsole\-setup\ +4444\@loghost
\f[]
.fi
.PP
sends all kernel log messages to host \f[I]loghost\f[] on port
\f[I]4444\f[] using the extended console support.
.IP
.nf
\f[C]
netconsole\-setup\ loghost1\ 4444\@loghost2
\f[]
.fi
.PP
sends all kernel log messages to host \f[I]loghost1\f[] on the default
port and to host \f[I]loghost2\f[] on port \f[I]4444\f[].
.SH AUTHOR
.PP
Benjamin Drung <benjamin.drung@cloud.ionos.com>