.\" -*- coding: UTF-8 -*-
.if \n(.g .ds T< \\FC
.if \n(.g .ds T> \\F[\n[.fam]]
.de URL
\\$2 \(la\\$1\(ra\\$3
..
.if \n(.g .mso www.tmac
.TH lxc-info 1 2025-08-26 "" ""
.SH NAME
lxc-info \- query information about a container 
.SH SYNOPSIS
'nh
.fi
.ad l
\fBlxc-info\fR \kx
.if (\nx>(\n(.l/2)) .nr x (\n(.l/5)
'in \n(.iu+\nxu
{-n \fIname\fR} [-c \fIKEY\fR] [-s] [-p] [-i] [-S] [-H]
'in \n(.iu-\nxu
.ad b
'hy
.SH DESCRIPTION
\fBlxc-info\fR queries and shows information about a
container.
.SH OPTIONS
.TP 
\*(T<\fB\-c, \-\-config \fR\*(T>\fIKEY\fR 
Print a configuration key from the container. This option
may be given multiple times to print out multiple key = value pairs.
.TP 
\*(T<\fB\-s, \-\-state\fR\*(T> 
Just print the container's state.
.TP 
\*(T<\fB\-p, \-\-pid\fR\*(T> 
Just print the container's pid.
.TP 
\*(T<\fB\-i, \-\-ips\fR\*(T> 
Just print the container's IP addresses.
.TP 
\*(T<\fB\-S, \-\-stats\fR\*(T> 
Just print the container's statistics.
Note that for performance reasons the kernel does not account
kernel memory use unless a kernel memory limit is set. If a limit
is not set, \fBlxc-info\fR will display kernel memory
use as 0. A limit can be set by specifying

.nf
\*(T<
            lxc.cgroup.memory.kmem.limit_in_bytes = \fInumber\fR
            \*(T>
.fi

in your container configuration file, see
\fBlxc.conf\fR(5).
.TP 
\*(T<\fB\-H, \-\-no\-humanize\fR\*(T> 
Print the container's statistics in raw, non-humanized form. The
default is to print statistics in humanized form.
.SH "COMMON OPTIONS"
These options are common to most of lxc commands.
.TP 
\*(T<\fB\-?, \-h, \-\-help\fR\*(T>
Print a longer usage message than normal.
.TP 
\*(T<\fB\-\-usage\fR\*(T>
Give the usage message
.TP 
\*(T<\fB\-q, \-\-quiet\fR\*(T>
mute on
.TP 
\*(T<\fB\-P, \-\-lxcpath=\fR\*(T>\fIPATH\fR
Use an alternate container path. The default is /var/lib/lxc.
.TP 
\*(T<\fB\-o, \-\-logfile=\fR\*(T>\fIFILE\fR
Output to an alternate log
\fIFILE\fR. The default is no log.
.TP 
\*(T<\fB\-l, \-\-logpriority=\fR\*(T>\fILEVEL\fR
Set log priority to
\fILEVEL\fR. The default log
priority is \*(T<ERROR\*(T>. Possible values are :
\*(T<FATAL\*(T>, \*(T<ALERT\*(T>,
\*(T<CRIT\*(T>,
\*(T<WARN\*(T>, \*(T<ERROR\*(T>,
\*(T<NOTICE\*(T>, \*(T<INFO\*(T>,
\*(T<DEBUG\*(T>, \*(T<TRACE\*(T>.

Note that this option is setting the priority of the events
log in the alternate log file. It do not have effect on the
ERROR events log on stderr.
.TP 
\*(T<\fB\-n, \-\-name=\fR\*(T>\fINAME\fR
Use container identifier \fINAME\fR.
The container identifier format is an alphanumeric string.
.TP 
\*(T<\fB\-\-rcfile=\fR\*(T>\fIFILE\fR
Specify the configuration file to configure the virtualization
and isolation functionalities for the container.

This configuration file if present will be used even if there is
already a configuration file present in the previously created
container (via lxc-create).
.TP 
\*(T<\fB\-\-version\fR\*(T>
Show the version number.
.SH EXAMPLES
.TP 
lxc-info -n foo
Show information for foo.
.TP 
lxc-info -n 'ubuntu.*'
Show information for all containers whose name starts with ubuntu.
.TP 
lxc-info -n foo -c lxc.net.0.veth.pair
prints the veth pair name of foo.
.SH "SEE ALSO"
\fBlxc\fR(7),
\fBlxc-create\fR(1),
\fBlxc-copy\fR(1),
\fBlxc-destroy\fR(1),
\fBlxc-start\fR(1),
\fBlxc-stop\fR(1),
\fBlxc-execute\fR(1),
\fBlxc-console\fR(1),
\fBlxc-monitor\fR(1),
\fBlxc-wait\fR(1),
\fBlxc-cgroup\fR(1),
\fBlxc-ls\fR(1),
\fBlxc-info\fR(1),
\fBlxc-freeze\fR(1),
\fBlxc-unfreeze\fR(1),
\fBlxc-attach\fR(1),
\fBlxc.conf\fR(5)
