systemd-run: add page (#9949)

* systemd-run: add page

* systemd-run: fix minor typo

* systemd-run: reorder wording to reduce ambiguity

* systemd-run: apply review suggestions

Co-authored-by: K.B.Dharun Krishna <kbdharunkrishna@gmail.com>

---------

Co-authored-by: K.B.Dharun Krishna <kbdharunkrishna@gmail.com>
pull/18/head
cyqsimon 2023-03-21 11:19:40 +08:00 committed by GitHub
parent 18fb7ac920
commit 36e2578753
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
1 changed files with 24 additions and 0 deletions

View File

@ -0,0 +1,24 @@
# systemd-run
> Run programs in transient units.
> More information: <https://manned.org/systemd-run>.
- Start a transient service:
`sudo systemd-run {{command}} {{argument1 argument2 ...}}`
- Start a transient service under the service manager of the current user (no privileges):
`systemd-run --user {{command}} {{argument1 argument2 ...}}`
- Start a transient service with a custom unit name and description:
`sudo systemd-run --unit={{name}} --description={{string}} {{command}} {{argument1 argument2 ...}}`
- Start a transient service that does not get cleaned up after it terminates with a custom environment variable:
`sudo systemd-run --remain-after-exit --set-env={{name}}={{value}} {{command}} {{argument1 argument2 ...}}`
- Start a transient timer that periodically runs its transient service (see `man systemd.time` for calendar event format):
`sudo systemd-run --on-calendar={{calendar_event}} {{command}} {{argument1 argument2 ...}}`