From dceff5dd1d47962fa716c2d212aa65099e4f5669 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Sat, 4 Jun 2022 07:23:14 +0200 Subject: Merging upstream version 20220604. Signed-off-by: Daniel Baumann --- share/man/container.1 | 185 ++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 185 insertions(+) create mode 100644 share/man/container.1 (limited to 'share/man/container.1') diff --git a/share/man/container.1 b/share/man/container.1 new file mode 100644 index 0000000..671f4d4 --- /dev/null +++ b/share/man/container.1 @@ -0,0 +1,185 @@ +.\" Open Infrastructure: compute-tools +.\" +.\" Copyright (C) 2014-2022 Daniel Baumann +.\" +.\" SPDX-License-Identifier: GPL-3.0+ +.\" +.\" This program is free software: you can redistribute it and/or modify +.\" it under the terms of the GNU General Public License as published by +.\" the Free Software Foundation, either version 3 of the License, or +.\" (at your option) any later version. +.\" +.\" This program is distributed in the hope that it will be useful, +.\" but WITHOUT ANY WARRANTY; without even the implied warranty of +.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +.\" GNU General Public License for more details. +.\" +.\" You should have received a copy of the GNU General Public License +.\" along with this program. If not, see . +.\" +. +.TH CONTAINER 1 compute-tools "Open Infrastructure" +.SH NAME +container \- Manage systemd-nspawn containers +. +.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 SYNOPSIS +.nf +\fBcontainer\fP \(aqCOMMAND\(aq [\(aqOPTIONS\(aq] +\fBcontainer\fP \(aqCOMMAND1\(aq,\(aqCOMMAND2\(aq,... \(aqCOMMANDn\(aq +.fi +.sp +.SH DESCRIPTION +.sp +compute\-tools provides the system integration for managing containers using +systemd\-nspawn. +.SH OPTIONS +.sp +The following \fBcontainer\fP common options are available: +.INDENT 0.0 +.TP +.B \-n, \-\-name=\(aqNAME\(aq: +Specify container name. +.UNINDENT +.SH COMMANDS +.sp +The following \fBcontainer\fP commands are available: +.INDENT 0.0 +.TP +.B build: +Build a new container, see container\-build(1). +.TP +.B start: +Start a container, see container\-start(1). +.TP +.B rebuild: +Rebuild a container, see container\-rebuild(1). +.TP +.B restart: +Restart a container, see container\-restart(1). +.TP +.B stop: +Stop a container, see container\-stop(1). +.TP +.B remove: +Remove a container, see container\-remove(1). +.TP +.B move: +Rename a container, see container\-move(1). +.TP +.B console: +Attach console to a container, see container\-console(1). +.TP +.B enter: +Enter a container namespace, see container\-enter(1). +.TP +.B run: +Execute commands in a container namespace, see container\-run(1). +.TP +.B info: +Show specific information of a container, see container\-info(1). +.TP +.B key: +Manage GnuPG keyring for container operations, see container\-key(1). +.TP +.B limit: +Limit resources of a container, see container\-limit(1). +.TP +.B list: +List container on the system, see container\-list(1). +.TP +.B log: +Show container log, see container\-log(1). +.TP +.B status: +Show container status, see container\-status(1). +.TP +.B top: +Dynamic list of container on the system, see container\-top(1). +.TP +.B update: +Update the packages installed in a container. +.TP +.B version: +Show container version, see container\-version(1). +.UNINDENT +.SH FILES +.sp +The following files are used: +.INDENT 0.0 +.TP +.B /etc/compute\-tools/container.conf, /etc/compute\-tools/container.conf.d/*.conf: +Container configuration files. +.TP +.B /usr/bin/container, /usr/bin/cnt: +Container program. +.TP +.B /usr/bin/container\-shell, /usr/bin/cntsh: +Container shell program. +.TP +.B /usr/libexec/container: +Container commands. +.TP +.B /usr/share/compute\-tools/: +Container shared data. +.TP +.B /usr/share/doc/compute\-tools: +Container documentation files. +.TP +.B /var/cache/container: +Container cache directory. +.TP +.B /var/lib/machines: +Container root directory. +.TP +.B /var/log/compute\-tools: +Container log files. +.UNINDENT +.SH SEE ALSO +.nf +machinectl(1), +systemd\-nspawn(1). +.fi +.sp +.SH HOMEPAGE +.sp +More information about compute\-tools and the Open Infrastructure project can be +found on the homepage (\fI\%https://open\-infrastructure.net\fP). +.SH CONTACT +.sp +Bug reports, feature requests, help, patches, support and everything else are +welcome on the Open Infrastructure Software Mailing List +<\fI\%software@lists.open\-infrastructure.net\fP>. +.sp +Debian specific bugs can also be reported in the Debian Bug Tracking System +(\fI\%https://bugs.debian.org\fP). +.SH AUTHORS +.sp +compute\-tools were written by Daniel Baumann +<\fI\%daniel.baumann@open\-infrastructure.net\fP> and others. +. -- cgit v1.2.3