.\" Man page generated from reStructuredText.
.
.
.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
..
.TH "LXC-ATTACH" "1" "January 23, 2023" "2023.01
" "LAVA"
.SH NAME
lxc-attach \- mock lxc-attach command used by LAVA
.SH SUMMARY
.sp
Mocks \fBlxc\-attach\fP command used by Linaro Automated Validation Architecture
(LAVA). LXC is Linux Containers userspace tools. \fBlxc\-attach\fP does not
use LXC. It is part of \fBlava\-lxc\-mocker\fP, which mocks some of the LXC
commands used by LAVA.
.SH SYNOPSIS
.sp
lxc\-attach {\-n name} [\-\- command]
.SH OPTIONS
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
.BI \-n \ NAME
Use container identifier NAME. The container identifier format
is an alphanumeric string. This argument is required, but not
used.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
optional argument:
.INDENT 0.0
.INDENT 3.5
.INDENT 0.0
.TP
.B \-\- COMMAND    runs the specified COMMAND that follows \(aq\-\-\(aq
When no COMMAND is specified, then opens up a shell.
.UNINDENT
.UNINDENT
.UNINDENT
.sp
\fBlxc\-attach\fP accepts the above options. Any other option specified other than
the above, will be ignored.
.SH EXAMPLES
.INDENT 0.0
.TP
.B To update the package repository, use
lxc\-attach \-n container \-\- apt\-get \-y \-q update
.UNINDENT
.sp
The above will run \(dqapt\-get \-y \-q update\(dq directly on the host.
.INDENT 0.0
.TP
.B To open up a shell, use
lxc\-attach \-n container
.UNINDENT
.SH NOTE
.sp
The commands provided by \fBlava\-lxc\-mocker\fP are simple shell scripts that use
the same command names mocking some LXC commands and does not
use LXC. \fBlava\-lxc\-mocker\fP commands still need to be executed in the same
sequence as a typical LXC operation. In particular, once a container has been
created, that container needs to be destroyed to clean up the symlinks and
other artifacts.
.SH SEE ALSO
.sp
lava\-lxc\-mocker(7), lxc\-create(1), lxc\-destroy(1), lxc\-device(1), lxc\-info(1),
lxc\-start(1), lxc\-stop(1)
.SH LICENSE
.sp
Released under the MIT License:
\fI\%http://www.opensource.org/licenses/mit\-license.php\fP
.SH AUTHOR
Senthil Kumaran S <senthil.kumaran@linaro.org>
.SH COPYRIGHT
2010-2023, Linaro Limited
.\" Generated by docutils manpage writer.
.