.\"		-*-Nroff-*-
.\" Copyright © 2002 Alexander Larsson <alexl@redhat.com>
.\"
.\" This program is free software; you can redistribute it and/or modify
.\" it under the terms of the GNU General Public License as published by
.\" the Free Software Foundation; either version 2 of the License, or
.\" (at your option) any later version.
.\"
.\" This program is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public License
.\" along with this program; if not, write to the Free Software
.\" Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
.\"
.TH NETDUMP-CLIENT 8 "14 Feb 2002" "Linux" "System Programs"
.SH NAME
netdump \- send oops data and memory dumps over the network
.SH SYNOPSIS
.nf
.B /etc/init.d/netdump {start|stop|status|restart|propagate}
.fi
.SH DESCRIPTION
Loads and configures the netdump kernel modules. Once these are loaded,
when the kernel crashes it will send the oops message and a dump of
physical memory to the machine that runs the netdump-server. This can
then be used to debug the problem using gdb and a kernel image.
.SH OPTIONS
.TP
.B start
Starts the netdump client service. Loads the kernel modules with the right
options.
.TP
.B stop
Unloads the kernel modules.
.TP
.B status
Shows the status of the netdump client
.TP
.B restart
Restarts the netclient modules with new configurations.
.TP
.B propagate
Sends the ssh public key needed to update the random key for each
netdump session to the netdump server.
.SH FILES
.TP
/etc/sysconfig/netdump
Configuration for the netdump client. You need to at least specify the
address of the machine running the netdump server here.  The 
.B NETDUMPKEYEXCHANGE 
variable in 
.I /etc/sysconfig/netdump 
can be set to
.B none 
to disable security features of netdump.  If 
.B none 
is specified, the server must be configured not to use security.
.TP
/etc/sysconfig/netdump_id_dsa.pub
Public key for this machine. Used by the server to authenticate the client.
This must be installed on the server if security is enabled, possibly by
using the the propagate capability of the netdump init script, which does:
.TP
.nf
.B cat /etc/sysconfig/netdump_id_dsa.pub | ssh netdump@$NETDUMPADDR cat '>>' /var/crash/.ssh/authorized_keys2
.fi

Where $NETDUMPADDR is the ip or name of the machine running the netdump server.
.SH "SEE ALSO"
.BR netdump-server (8),
.BR init (8)

.SH BUGS
Report any bugs you find to http://bugzilla.redhat.com/bugzilla

.SH AUTHOR
Alexander Larsson <alexl@redhat.com>