.\" Man page generated from reStructuredText.
.
.TH "LAVA-SLAVE" "8" "November 19, 2018" "2018.11
" "LAVA"
.SH NAME
lava-slave \- manage connections to lava master
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.SH SUMMARY
.sp
\fBlava\-slave\fP runs the connection to the lava master over ZMQ to
manage LAVA test jobs running on the reserved device, sending log
messages back to the master. \fBlava\-slave\fP runs as a daemon.
.SH USAGE
.INDENT 0.0
.TP
.B lava\-slave [\-h] [\-\-hostname HOSTNAME] \-\-master MASTER \-\-socket\-addr
SOCKET_ADDR [\-\-log\-file LOG_FILE]
[\-\-level {DEBUG,ERROR,INFO,WARN}] [\-\-timeout TIMEOUT]
[\-\-ipv6] [\-\-encrypt] [\-\-master\-cert MASTER_CERT]
[\-\-slave\-cert SLAVE_CERT]
.UNINDENT
.SH OPTIONS
.sp
Options can be passed by editing /etc/default/lava\-slave or
/etc/lava\-dispatcher/lava\-slave
.INDENT 0.0
.TP
.B optional arguments:
.INDENT 7.0
.TP
.B \-h\fP,\fB  \-\-help
show this help message and exit
.TP
.BI \-\-hostname \ HOSTNAME
Name of the slave
.TP
.BI \-\-master \ MASTER
Main master socket
.TP
.BI \-\-socket\-addr \ SOCKET_ADDR
Log socket
.TP
.BI \-\-log\-file \ LOG_FILE
Log file for the slave logs
.TP
.B \-\-level\fP,\fB  \-l
Log level (DEBUG, ERROR, INFO, WARN); default to INFO
.TP
.BI \-\-timeout \ TIMEOUT\fP,\fB \ \-t \ TIMEOUT
Socket connection timeout in seconds; default to 5
.TP
.B \-\-ipv6
Enable IPv6
.TP
.B \-\-encrypt
Encrypt messages
.TP
.BI \-\-master\-cert \ MASTER_CERT
Master certificate file
.TP
.BI \-\-slave\-cert \ SLAVE_CERT
Slave certificate file
.UNINDENT
.UNINDENT
.SH ENCRYPTION
.sp
Some LAVA instances require the ZMQ connection to the master to be
encrypted. For more information on configuring lava\-slave to use
encryption support, see the lava\-server documentation on your
local instance or at:
\fI\%https://validation.linaro.org/static/docs/v2/pipeline\-server.html#zmq\-curve\fP
.sp
You will need to contact the admin of the instance to obtain the
certificate of the master to which this slave should connect.
.sp
The default install uses systemd translation of the sysvinit script
but a systemd service file is available, if desired:
.INDENT 0.0
.INDENT 3.5
.sp
.nf
.ft C
/usr/share/lava\-dispatcher/lava\-slave.service
.ft P
.fi
.UNINDENT
.UNINDENT
.sp
This file can be copied to \fB/lib/systemd/system/\fP\&.
.SH AUTHOR
Linaro Validation Team
.SH COPYRIGHT
2010-2018, Linaro Limited
.\" Generated by docutils manpage writer.
.