.\" Man page generated from reStructuredText.
.
.TH "LAVA-RUN" "1" "January 11, 2023" "2020.12
" "LAVA"
.SH NAME
lava-run \- run jobs on LAVA devices
.
.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\-run\fP runs a LAVA test job on the reserved device, as
scheduled by the \fBlava\-scheduler\fP and publish the test result back to
the server. Jobs are scheduled by the server but can also be run by
calling \fBlava\-run\fP directly.
.sp
You can see an up\-to\-date list of supported target devices by looking
at the device types on the relevant server.
.SH USAGE
.INDENT 0.0
.TP
.B lava\-run [\-h] \-\-job\-id ID \-\-output\-dir DIR [\-\-validate]
[\-\-url URL] [\-\-token token]
\-\-device PATH [\-\-dispatcher PATH] [\-\-env\-dut PATH]
[\-\-debug] definition
.UNINDENT
.SH OPTIONS
.INDENT 0.0
.TP
.B positional arguments:
definition         job definition
.TP
.B optional arguments:
.INDENT 7.0
.TP
.B \-h\fP,\fB  \-\-help
show this help message and exit
.TP
.BI \-\-job\-id \ ID
Job identifier. This alters process name for easier debugging
.TP
.BI \-\-output\-dir \ DIR
Directory for temporary resources
.TP
.B \-\-validate
validate the job file, do not execute any steps. The description is saved into description.yaml
.TP
.B \-\-debug
Start remote pdb right before running the job, for debugging
.UNINDENT
.TP
.B logging:
.INDENT 7.0
.TP
.BI \-\-url \ URL
URL of the server to send logs
.TP
.BI \-\-token \ token
token for server authentication
.UNINDENT
.TP
.B configuration files:
.INDENT 7.0
.TP
.BI \-\-device \ PATH
Device configuration
.TP
.BI \-\-dispatcher \ PATH
Dispatcher configuration
.TP
.BI \-\-env\-dut \ PATH
DUT environment
.UNINDENT
.UNINDENT
.sp
For more information on writing job definition and tests, look at:
.sp
\fI\%https://validation.linaro.org/static/docs/v2/first\-job.html\fP
.sp
\fI\%https://validation.linaro.org/static/docs/v2/contents.html#writing\-tests\-for\-lava\fP
.SH AUTHOR
Linaro Validation Team
.SH COPYRIGHT
2010-2023, Linaro Limited
.\" Generated by docutils manpage writer.
.