diff options
Diffstat (limited to 'templates/man5/capsule@.service.5.pot')
| -rw-r--r-- | templates/man5/capsule@.service.5.pot | 225 |
1 files changed, 225 insertions, 0 deletions
diff --git a/templates/man5/capsule@.service.5.pot b/templates/man5/capsule@.service.5.pot new file mode 100644 index 00000000..79e78f9a --- /dev/null +++ b/templates/man5/capsule@.service.5.pot @@ -0,0 +1,225 @@ +# SOME DESCRIPTIVE TITLE +# Copyright (C) YEAR Free Software Foundation, Inc. +# This file is distributed under the same license as the PACKAGE package. +# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. +# +#, fuzzy +msgid "" +msgstr "" +"Project-Id-Version: PACKAGE VERSION\n" +"POT-Creation-Date: 2024-06-15 09:11+0200\n" +"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" +"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n" +"Language-Team: LANGUAGE <LL@li.org>\n" +"Language: \n" +"MIME-Version: 1.0\n" +"Content-Type: text/plain; charset=UTF-8\n" +"Content-Transfer-Encoding: 8bit\n" + +#. type: TH +#: debian-unstable fedora-rawhide +#, no-wrap +msgid "CAPSULE@\\&.SERVICE" +msgstr "" + +#. type: TH +#: debian-unstable fedora-rawhide +#, no-wrap +msgid "systemd 256~rc3" +msgstr "" + +#. type: TH +#: debian-unstable fedora-rawhide +#, no-wrap +msgid "capsule@.service" +msgstr "" + +#. ----------------------------------------------------------------- +#. * MAIN CONTENT STARTS HERE * +#. ----------------------------------------------------------------- +#. type: SH +#: debian-unstable fedora-rawhide +#, no-wrap +msgid "NAME" +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "capsule@.service - System unit for the capsule service manager" +msgstr "" + +#. type: SH +#: debian-unstable fedora-rawhide +#, no-wrap +msgid "SYNOPSIS" +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "capsule@I<NAME>\\&.service" +msgstr "" + +#. type: SH +#: debian-unstable fedora-rawhide +#, no-wrap +msgid "DESCRIPTION" +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "" +"Service managers for capsules run in capsule@I<NAME>\\&.service system " +"units, with the capsule name as the instance identifier\\&. Capsules are way " +"to run additional instances of the service manager, under dynamic user IDs, " +"i\\&.e\\&. UIDs that are allocated when the capsule service manager is " +"started, and released when it is stopped\\&." +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "" +"In many ways capsule@\\&.service is similar to the per-user user@\\&.service " +"service manager, but there are a few important distinctions:" +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "" +"The capsule service manager utilizes I<DynamicUser=> (see B<systemd." +"exec>(5)) to allocate a new UID dynamically on invocation\\&. The user name " +"is automatically generated from the capsule name, by prefixng \"p_\"\\&. The " +"UID is released when the service is terminated\\&. The user service manager " +"on the other hand operates under a statically allocated user ID that must be " +"pre-existing, before the user service manager is invoked\\&." +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "" +"User service managers register themselves with B<pam>(8), capsule service " +"managers do not\\&." +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "" +"User service managers typically read their configuration from a I<$HOME> " +"directory below /home/, capsule service managers from a I<$HOME> directory " +"below /var/lib/capsules/\\&." +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "" +"User service managers are collectively contained in the user\\&.slice unit, " +"capsule service managers in capsule\\&.slice\\&. Also see B<systemd." +"special>(7)\\&." +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "" +"User service managers start the user unit default\\&.target initially\\&. " +"Capsule service managers invoke the user unit capsule@\\&.target instead\\&." +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "" +"The capsule service manager and the capsule\\*(Aqs bus broker can be reached " +"via the B<--capsule=> switch to B<systemctl>(1), B<systemd-run>(1) and " +"B<busctl>(1)\\&." +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "" +"New capsules can be started via a simple B<systemctl start " +"capsule@>I<NAME>B<\\&.service> command, and stopped via B<systemctl stop " +"capsule@>I<NAME>B<\\&.service>\\&. Starting a capsule will implicitly create " +"a home directory /var/lib/capsules/I<NAME>/, if missing\\&. A runtime " +"directory is created as /run/capsules/I<NAME>/\\&. To remove these resources " +"use B<systemctl clean capsule@>I<NAME>B<\\&.service>, for example with the " +"B<--what=all> switch\\&." +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "" +"The capsule@\\&.service unit invokes a B<systemd --user> service manager " +"process\\&. This means unit files are looked for according to the sames " +"rules as for regular user service managers, for example in /var/lib/capsules/" +"I<NAME>/\\&.config/systemd/user/\\&." +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "" +"Capsule names may be chosen freely by the user, however, they must be " +"suitable as UNIX filenames (i\\&.e\\&. 255 characters max, and contain no \"/" +"\"), and when prefixed with \"p-\" be suitable as a user name matching " +"strict POSIX rules, see \\m[blue]B<User/Group Name " +"Syntax>\\m[]\\&\\s-2\\u[1]\\d\\s+2 for details\\&." +msgstr "" + +#. type: SH +#: debian-unstable fedora-rawhide +#, no-wrap +msgid "EXAMPLES" +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "" +"B<Example\\ \\&1.\\ \\&Create a new capsule, invoke two programs in it (one " +"interactively), terminate it, and clean everything up>" +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +#, no-wrap +msgid "" +"# systemctl start capsule@tatze\\&.service\n" +"# systemd-run --capsule=tatze --unit=sleeptest\\&.service sleep 999\n" +"# systemctl --capsule=tatze status sleeptest\\&.service\n" +"# systemd-run -t --capsule=tatze bash\n" +"# systemctl --capsule=tatze stop sleeptest\\&.service\n" +"# systemctl stop capsule@tatze\\&.service\n" +"# systemctl clean --all capsule@tatze\\&.service\n" +msgstr "" + +#. type: SH +#: debian-unstable fedora-rawhide +#, no-wrap +msgid "SEE ALSO" +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "" +"B<systemd>(1), B<user@.service>(5), B<systemd.service>(5), B<systemd." +"slice>(5), B<systemd.exec>(5), B<systemd.special>(7), B<systemctl>(1), " +"B<systemd-run>(1), B<busctl>(1), B<pam>(8)" +msgstr "" + +#. type: SH +#: debian-unstable fedora-rawhide +#, no-wrap +msgid "NOTES" +msgstr "" + +#. type: IP +#: debian-unstable fedora-rawhide +#, no-wrap +msgid " 1." +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "User/Group Name Syntax" +msgstr "" + +#. type: Plain text +#: debian-unstable fedora-rawhide +msgid "\\%https://systemd.io/USER_NAMES" +msgstr "" |