'\" t
.\"     Title: PDUCLIENT
.\"    Author: Matthew Hart <matthew.hart@linaro.org>
.\" Generator: DocBook XSL Stylesheets v1.78.1 <http://docbook.sf.net/>
.\"      Date: 07/29/2014
.\"    Manual: pduclient User Manual
.\"    Source: pduclient
.\"  Language: English
.\"
.TH "PDUCLIENT" "1" "07/29/2014" "pduclient" "pduclient User Manual"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
pduclient \- program to automate power control of a device
.SH "SYNOPSIS"
.HP \w'\fBpduclient\fR\ 'u
\fBpduclient\fR \fB\-\-daemon\ \fR\fB\fIdaemonhostname\fR\fR \fB\-\-hostname\ \fR\fB\fIpduhostname\fR\fR \fB\-\-port\ \fR\fB\fIpduportnumber\fR\fR \fB\-\-command\ \fR\fB\fIpducommand\fR\fR
.HP \w'\fBpduclient\fR\ 'u
\fBpduclient\fR [{\fB\-h\fR\ |\ \fB\-\-help\fR}]
.SH "DESCRIPTION"
.PP
This manual page documents briefly the
\fBpduclient\fR
command\&.
.PP
\fBpduclient\fR
is the frontend for lavapdu to issue commands to a Power Distribution Unit (PDU)\&. Commands include
\fIon\fR,
\fIoff\fR
and
\fIreboot\fR\&.
.PP
A particular device will be connected to a particular port on a PDU\&. The
lavapdu\-runner
is able to control multiple PDUs, specified by hostname\&.
pduclient
connects to the
lavapdu\-listen
daemon which stores the command until the
lavapdu\-runner
daemon is able to connect to the specified PDU and execute the command on the specified port\&.
.PP
Typically,
pduclient
will be used from the device configuration file of a LAVA instance, using
lava\-dispatcher\&.
.SH "REVERSE LOOKUPS"
.PP
pduclient
needs the hostname of the calling machine to match a DNS reverse lookup\&. This means that not only does
\fIhostname \-f\fR
need to resolve to an IP address but that IP address must resolve to that hostname:
.PP
.if n \{\
.RS 4
.\}
.nf
        $ dig myhostname\&.domain
        \&.\&.\&.
        192\&.168\&.0\&.56
        \&.\&.\&.
        
.fi
.if n \{\
.RE
.\}
.sp
.if n \{\
.RS 4
.\}
.nf
        $ dig \-x 192\&.168\&.0\&.56
        \&.\&.\&.
        myhostname\&.domain
        \&.\&.\&.
        
.fi
.if n \{\
.RE
.\}
.PP
If the second call does not work, you will need to fix the local DNS resolution before
pduclient
will operate\&. Error messages will look something like:
.PP
.if n \{\
.RS 4
.\}
.nf
            Unknown error sending command! control replied: nack
        
.fi
.if n \{\
.RE
.\}
.sp
.SH "OPTIONS"
.PP
\fB\-\-daemon \fR\fB\fIdaemonhostname\fR\fR
.RS 4
Determines the hostname of the hostname which is running
lavapdu\-listen
to which the client can connect and add the command to the queue\&.
.RE
.PP
\fB\-\-hostname \fR\fB\fIpduhostname\fR\fR
.RS 4
The PDU which will run the command\&.
.RE
.PP
\fB\-\-port \fR\fB\fIpduportnumber\fR\fR
.RS 4
The port on the specified PDU to which the device is connected\&.
.RE
.PP
\fB\-\-command \fR\fB\fIpducommand\fR\fR
.RS 4
The command to run on the specified port of the specified PDU\&.
.RE
.PP
\fB\-h\fR, \fB\-\-help\fR
.RS 4
Show a summary of the required commands\&.
.RE
.SH "SEE ALSO"
.PP
\fBlavapdu-listen\fR(8),
\fBlavapdu-runner\fR(8)
.SH "AUTHOR"
.PP
\fBMatthew Hart\fR <\&matthew\&.hart@linaro\&.org\&>
.RS 4
Wrote this manpage for the Debian system\&.
.RE
.SH "COPYRIGHT"
.br
Copyright \(co 2014 Matthew Hart
.br
.PP
This manual page was written for the Debian system (and may be used by others)\&.
.PP
Permission is granted to copy, distribute and/or modify this document under the terms of the GNU General Public License, Version 2 or (at your option) any later version published by the Free Software Foundation\&.
.PP
On Debian systems, the complete text of the GNU General Public License can be found in
/usr/share/common\-licenses/GPL\&.
.sp