summaryrefslogtreecommitdiff
path: root/man/machinectl.xml
Commit message (Collapse)AuthorAgeFilesLines
* machinectl: add verb edit and cat to operate on .nspawn filesMike Yuan2023-03-151-0/+15
| | | | | | This allows operating on .nspawn files using machinectl. Closes #26246
* machinectl: add --now to start/stop containers when enabling/disablingMike Yuan2023-01-241-1/+16
| | | | Closes #26154
* machinectl: allow --max-addresses=0Zbigniew Jędrzejewski-Szmek2022-10-201-5/+4
| | | | Sometimes the addresses are not important, so allow skipping them in output.
* tree-wide: change --kill-who to --kill-whomZbigniew Jędrzejewski-Szmek2022-08-261-2/+2
| | | | | | | | | | | getopt allows non-ambiguous abbreviations, so backwards-compat is maintained, and people can use --kill-who (or even shorter abbreviations). English is flexible, so in common speach people would use both forms, even if "whom" is technically more correct. The advantage of using the longer form in the code is that we effectively allow both forms, so we stop punishing people who DTGCT¹, but still allow people to use the spoken form if they prefer. 1. Do the gramatically correct thing
* man: similar → similarlyZbigniew Jędrzejewski-Szmek2022-08-231-36/+29
| | | | | | | | | Something *is* similar Something *works* similarly Something does something, similarly to how something else does something See https://sites.ulethbridge.ca/roussel/2017/11/29/similar-and-similarly-are-they-similar/ for a clear explanation.
* machinectl: Add plumbing for a `--force` flag for file copyAlexander Wilson2022-07-271-2/+2
| | | | | | machine: Add APIs CopyTo[Machine]WithFlags + CopyFrom[Machine]WithFlags - Same API to those without `WithFlags` (except this can take flags) - Initially, only a flag to allow replacing a file if it already exists
* machinectl: allow --setenv=FOOZbigniew Jędrzejewski-Szmek2021-08-111-8/+10
|
* man: rename less-variables→common-variablesZbigniew Jędrzejewski-Szmek2021-03-011-1/+1
| | | | Some are not about less, e.g. $SYSTEMD_URLIFY.
* systemctl,loginctl,machinectl: use a shared helper for arg_signalZbigniew Jędrzejewski-Szmek2021-02-141-11/+1
| | | | | I seems frivolous to yet another two -util.[ch] files, but the helper should be in shared/ and it doesn't seem to fit anywhere else.
* license: LGPL-2.1+ -> LGPL-2.1-or-laterYu Watanabe2020-11-091-1/+1
|
* man/machinectl: fix pull-raw exampleZbigniew Jędrzejewski-Szmek2020-10-271-6/+11
| | | | | We do not allow machine names with "_", so the command would fail as written. Share the example with the systemd-nspawn page instead.
* man: use trailing slash on directories in more placesZbigniew Jędrzejewski-Szmek2020-10-051-6/+6
|
* tree-wide: fixes for assorted grammar and spelling issuesZbigniew Jędrzejewski-Szmek2020-07-061-1/+1
| | | | Fixes #16363. Also includes some changes where I generalized the pattern.
* tree-wide: use "hostname" spelling everywhereZbigniew Jędrzejewski-Szmek2020-04-211-3/+3
| | | | | | | | It's not that I think that "hostname" is vastly superior to "host name". Quite the opposite — the difference is small, and in some context the two-word version does fit better. But in the tree, there are ~200 occurrences of the first, and >1600 of the other, and consistent spelling is more important than any particular spelling choice.
* man: suffix parameter with = in our documentation, if it expects an argumentLennart Poettering2020-01-131-9/+5
| | | | | Also, don't claim we'd insert a "," between addresses, because we actually don't do that.
* machinectl: do not truncate addresses when --full is specifiedYu Watanabe2020-01-101-1/+2
|
* machinectl: do not ellipsize table when --full is specifiedYu Watanabe2020-01-101-1/+1
|
* Move the Commands section above Options sectionZbigniew Jędrzejewski-Szmek2019-10-081-214/+214
| | | | | | | For executables which take a verb, we should list the verbs first, and then options which modify those verbs second. The general layout of the man page is from general description to specific details, usually Overview, Commands, Options, Return Value, Examples, References.
* man: Add a missing space in machinectl(1)Philip Withnall2019-09-241-1/+1
| | | | Signed-off-by: Philip Withnall <withnall@endlessm.com>
* man: use same header for all filesZbigniew Jędrzejewski-Szmek2019-03-141-1/+1
| | | | | | | The "include" files had type "book" for some raeason. I don't think this is meaningful. Let's just use the same everywhere. $ perl -i -0pe 's^..DOCTYPE (book|refentry) PUBLIC "-//OASIS//DTD DocBook XML V4.[25]//EN"\s+"http^<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"\n "http^gms' man/*.xml
* man: standarize on one-line license headerZbigniew Jędrzejewski-Szmek2019-03-141-4/+1
| | | | | | No need to waste space, and uniformity is good. $ perl -i -0pe 's|\n+<!--\s*SPDX-License-Identifier: LGPL-2.1..\s*-->|\n<!-- SPDX-License-Identifier: LGPL-2.1+ -->|gms' man/*.xml
* import: drop logic of setting up /var/lib/machines as btrfs loopback mountLennart Poettering2018-11-261-34/+4
| | | | | | | | | | | | | | | | | | | Let's simplify things and drop the logic that /var/lib/machines is setup as auto-growing btrfs loopback file /var/lib/machines.raw. THis was done in order to make quota available for machine management, but quite frankly never really worked properly, as we couldn't grow the file system in sync with its use properly. Moreover philosophically it's problematic overriding the admin's choice of file system like this. Let's hence drop this, and simplify things. Deleting code is a good feeling. Now that regular file systems provide project quota we could probably add per-machine quota support based on that, hence the btrfs quota argument is not that interesting anymore (though btrfs quota is a bit more powerful as it allows recursive quota, i.e. that the machine pool gets an overall quota in addition to per-machine quota).
* machine: add support for importing containers from plain directoriesLennart Poettering2018-11-261-0/+9
| | | | | | | | | Fixes: #2728 This is also supposed to be preparation for doing #10234 eventually, where a very similar operation is requested: instead of importing a tree to /var/lib/machines it would need to be imported into /var/lib/portables/.
* man: document that machinectl is also happy with block devices these daysLennart Poettering2018-11-261-4/+5
|
* man: drop mode line in file headersZbigniew Jędrzejewski-Szmek2018-07-031-1/+1
| | | | | This is already included in .dir-locals, so we don't need it in the files themselves.
* Merge pull request #9301 from keszybz/man-drop-authorgroupLennart Poettering2018-06-141-9/+0
|\ | | | | man: drop unused <authorgroup> tags from man sources
| * man: drop unused <authorgroup> tags from man sourcesZbigniew Jędrzejewski-Szmek2018-06-141-9/+0
| | | | | | | | | | | | | | | | | | | | | | | | Docbook styles required those to be present, even though the templates that we use did not show those names anywhere. But something changed semi-recently (I would suspect docbook templates, but there was only a minor version bump in recent years, and the changelog does not suggest anything related), and builds now work without those entries. Let's drop this dead weight. Tested with F26-F29, debian unstable. $ perl -i -0pe 's/\s*<authorgroup>.*<.authorgroup>//gms' man/*xml
* | Drop my copyright headersZbigniew Jędrzejewski-Szmek2018-06-141-2/+0
|/ | | | | | | perl -i -0pe 's/\s*Copyright © .... Zbigniew Jędrzejewski.*?\n/\n/gms' man/*xml git grep -e 'Copyright.*Jędrzejewski' -l | xargs perl -i -0pe 's/(#\n)?# +Copyright © [0-9, -]+ Zbigniew Jędrzejewski.*?\n//gms' git grep -e 'Copyright.*Jędrzejewski' -l | xargs perl -i -0pe 's/\s*\/\*\*\*\s+Copyright © [0-9, -]+ Zbigniew Jędrzejewski[^\n]*?\s*\*\*\*\/\s*/\n\n/gms' git grep -e 'Copyright.*Jędrzejewski' -l | xargs perl -i -0pe 's/\s+Copyright © [0-9, -]+ Zbigniew Jędrzejewski[^\n]*//gms'
* tree-wide: beautify remaining copyright statementsLennart Poettering2018-06-141-1/+1
| | | | | | Let's unify an beautify our remaining copyright statements, with a unicode ©. This means our copyright statements are now always formatted the same way. Yay.
* tree-wide: drop 'This file is part of systemd' blurbLennart Poettering2018-06-141-2/+0
| | | | | | | | | | | | | | | | This part of the copyright blurb stems from the GPL use recommendations: https://www.gnu.org/licenses/gpl-howto.en.html The concept appears to originate in times where version control was per file, instead of per tree, and was a way to glue the files together. Ultimately, we nowadays don't live in that world anymore, and this information is entirely useless anyway, as people are very welcome to copy these files into any projects they like, and they shouldn't have to change bits that are part of our copyright header for that. hence, let's just get rid of this old cruft, and shorten our codebase a bit.
* doc: more spelling fixesMichael Biebl2018-06-121-1/+1
|
* man: minor machinectl updatesLennart Poettering2018-04-171-7/+2
|
* tree-wide: drop license boilerplateZbigniew Jędrzejewski-Szmek2018-04-061-13/+0
| | | | | | | | | | Files which are installed as-is (any .service and other unit files, .conf files, .policy files, etc), are left as is. My assumption is that SPDX identifiers are not yet that well known, so it's better to retain the extended header to avoid any doubt. I also kept any copyright lines. We can probably remove them, but it'd nice to obtain explicit acks from all involved authors before doing that.
* man: machinectl: update fedora exmple URL (#8642)Radostin Stoyanov2018-04-031-4/+4
|
* man: remove duplicated lineYu Watanabe2018-01-161-1/+0
| | | | Follow-up for c46bc7e2162d774f55847c1a8cb9d49085cf89bb.
* machined: use getent to get default shell for machinectl shell (#7684)Shawn Landden2018-01-161-2/+3
| | | Closes: https://github.com/systemd/systemd/issues/1395
* man: machinectl: fix typoYu Watanabe2018-01-101-1/+1
|
* man: add missing optionsYu Watanabe2017-12-041-0/+7
|
* Add SPDX license identifiers to man pagesZbigniew Jędrzejewski-Szmek2017-11-191-0/+2
|
* machined: support "machinectl bind" on non-directories (#7349)Lennart Poettering2017-11-191-12/+14
| | | Fixes: #7195
* man: use "filename" not "file name" by defaultZbigniew Jędrzejewski-Szmek2017-09-151-1/+1
| | | | | | | We settled on "filename" and "file system", so change a couple of places for consistency. The exception is when there's an adjective before "file" that binds more strongly then "name": "password file name", "output file name", etc. Those cases are left intact.
* man: update the description of machinectl -MZbigniew Jędrzejewski-Szmek2017-09-151-7/+17
| | | | | | Fixes #6621. Also rework the introduction a bit.
* importd: support SUSE style checksums (#5206)tblume2017-04-241-13/+16
| | | | | | | | | | | In order to verify a pulled container or disk image, importd only supports SHA256SUMS files with the detached signature in SHA256SUMS.gpg. SUSE is using an inline signed file with the name of the image itself and the suffix .sha256 instead. This commit adds support for this type of signature files. It is first attempted to pull the .sha256 file. If this fails with error 404, the SHA256SUMS and SHA256SUMS.gpg files are pulled and used for verification.
* machined: refuse bind mounts on containers that have user namespaces appliedLennart Poettering2017-02-171-13/+8
| | | | | | | | As the kernel won't map the UIDs this is simply not safe, and hence we should generate a clean error and refuse it. We can restore this feature later should a "shiftfs" become available in the kernel.
* machined: when copying files from/to userns containers chown to rootLennart Poettering2017-02-171-3/+10
| | | | | | | | This changes the file copy logic of machined to set the UID/GID of all copied files to 0 if the host and container do not share the same user namespace. Fixes: #4078
* man: document that "systemd-run -M" propagates exit codes, and "machinectl ↵Lennart Poettering2016-12-271-6/+12
| | | | | | | | | | | | | | | | | | | | | | | | | | | | shell" does not This adds a brief explanation, suggesting the use of "systemd-run -M" to acquire exit status/code information for the invoked process. My original plan was to propagate the exit code/status in "machinectl shell" too, but this would mean we'd have to actively watch the shell's runtime status, and thus would need full, highly privileged and continious access to the container's system manager, the way "systemd-run" does it. This would be quite a departure from the simplistic, low-priviliged OpenShell() bus call implementation of the current code, that really just acquires a PTY device with a shell connected. Moreover it would blur the lines between the two commands even further, which I think is not desirable. Hence, from now on: "machinectl shell" is the full-session, interactive shell for human users "systemd-run -M …" is the low-level tool, that supports on-interactive mode, and is more configurable and suitable for streaming. Fixes: #4215
* man: two trivial formatting fixesZbigniew Jędrzejewski-Szmek2016-12-111-1/+1
|
* man: use unicode ellipsis in more placesZbigniew Jędrzejewski-Szmek2016-12-111-14/+14
| | | | | | | | | | | | | | As requested in https://github.com/systemd/systemd/pull/4864#pullrequestreview-12372557. docbook will substitute triple dots for the ellipsis in man output, so this has no effect on the troff output, only on HTML, making it infinitesimally nicer. In some places we show output from programs, which use dots, and those places should not be changed. In some tables, the alignment would change if dots were changed to the ellipsis which is only one character. Since docbook replaces the ellipsis automatically, we should leave those be. This patch changes all other places.
* nspawn: add fallback top normal copy/reflink when we cannot btrfs snapshotLennart Poettering2016-11-221-3/+3
| | | | | | | | | | | | | | | | | Given that other file systems (notably: xfs) support reflinks these days, let's extend the file system snapshotting logic to fall back to plan copies or reflinks when full btrfs subvolume snapshots are not available. This essentially makes "systemd-nspawn --ephemeral" and "systemd-nspawn --template=" available on non-btrfs subvolumes. Of course, both operations will still be slower on non-btrfs than on btrfs (simply because reflinking each file individually in a directory tree is still slower than doing this in one step for a whole subvolume), but it's probably good enough for many cases, and we should provide the users with the tools, they have to figure out what's good for them. Note that "machinectl clone" already had a fallback like this in place, this patch generalizes this, and adds similar support to our other cases.
* man: fix typos (#4527)Jakub Wilk2016-10-311-1/+1
|
View Lorry Controller Status