X-Git-Url: https://src.twobees.de/?a=blobdiff_plain;f=stow%2Foh-my-zsh%2F.oh-my-zsh%2Fplugins%2Fsystemd%2FREADME.md;fp=stow%2Foh-my-zsh%2F.oh-my-zsh%2Fplugins%2Fsystemd%2FREADME.md;h=0000000000000000000000000000000000000000;hb=1a8e170bbe5c6641a26ab1ce2e6ce6c5c1faa4cd;hp=ffa0567a853f683930e069a931fe835f7ea5609a;hpb=475ba35502579302593f4735c853c49ef1845dcb;p=dotfiles.git diff --git a/stow/oh-my-zsh/.oh-my-zsh/plugins/systemd/README.md b/stow/oh-my-zsh/.oh-my-zsh/plugins/systemd/README.md deleted file mode 100644 index ffa0567..0000000 --- a/stow/oh-my-zsh/.oh-my-zsh/plugins/systemd/README.md +++ /dev/null @@ -1,97 +0,0 @@ -# Systemd plugin - -The systemd plugin provides many useful aliases for systemd. - -To use it, add systemd to the plugins array of your zshrc file: - -```zsh -plugins=(... systemd) -``` - -## Aliases - -| Alias | Command | Description | -|:-----------------------|:-----------------------------------|:-----------------------------------------------------------------| -| `sc-list-units` | `systemctl list-units` | List all units systemd has in memory | -| `sc-is-active` | `systemctl is-active` | Show whether a unit is active | -| `sc-status` | `systemctl status` | Show terse runtime status information about one or more units | -| `sc-show` | `systemctl show` | Show properties of units, jobs, or the manager itself | -| `sc-help` | `systemctl help` | Show man page of units | -| `sc-list-unit-files` | `systemctl list-unit-files` | List unit files installed on the system | -| `sc-is-enabled` | `systemctl is-enabled` | Checks whether any of the specified unit files are enabled | -| `sc-list-jobs` | `systemctl list-jobs` | List jobs that are in progress | -| `sc-show-environment` | `systemctl show-environment` | Dump the systemd manager environment block | -| `sc-cat` | `systemctl cat` | Show backing files of one or more units | -| `sc-list-timers` | `systemctl list-timers` | List timer units currently in memory | -| **Aliases with sudo** ||| -| `sc-start` | `sudo systemctl start` | Start Unit(s) | -| `sc-stop` | `sudo systemctl stop` | Stop Unit(s) | -| `sc-reload` | `sudo systemctl reload` | Reload Unit(s) | -| `sc-restart` | `sudo systemctl restart` | Restart Unit(s) | -| `sc-try-restart` | `sudo systemctl try-restart` | Restart Unit(s) | -| `sc-isolate` | `sudo systemctl isolate` | Start a unit and its dependencies and stop all others | -| `sc-kill` | `sudo systemctl kill` | Kill unit(s) | -| `sc-reset-failed` | `sudo systemctl reset-failed` | Reset the "failed" state of the specified units, | -| `sc-enable` | `sudo systemctl enable` | Enable unit(s) | -| `sc-disable` | `sudo systemctl disable` | Disable unit(s) | -| `sc-reenable` | `sudo systemctl reenable` | Reenable unit(s) | -| `sc-preset` | `sudo systemctl preset` | Reset the enable/disable status one or more unit files | -| `sc-mask` | `sudo systemctl mask` | Mask unit(s) | -| `sc-unmask` | `sudo systemctl unmask` | Unmask unit(s) | -| `sc-link` | `sudo systemctl link` | Link a unit file into the unit file search path | -| `sc-load` | `sudo systemctl load` | Load unit(s) | -| `sc-cancel` | `sudo systemctl cancel` | Cancel job(s) | -| `sc-set-environment` | `sudo systemctl set-environment` | Set one or more systemd manager environment variables | -| `sc-unset-environment` | `sudo systemctl unset-environment` | Unset one or more systemd manager environment variables | -| `sc-edit` | `sudo systemctl edit` | Edit a drop-in snippet or a whole replacement file with `--full` | -| `sc-enable-now` | `sudo systemctl enable --now` | Enable and start unit(s) | -| `sc-disable-now` | `sudo systemctl disable --now` | Disable and stop unit(s) | -| `sc-mask-now` | `sudo systemctl mask --now` | Mask and stop unit(s) | - -### User aliases - -You can use the above aliases as `--user` by using the prefix `scu` instead of `sc`. -For example: `scu-list-units` will be aliased to `systemctl --user list-units`. - -### Unit Status Prompt - -You can add a token to your prompt in a similar way to the gitfast plugin. To add the token -to your prompt, drop `$(systemd_prompt_info [unit]...)` into your prompt (more than one unit -may be specified). - -The plugin will add the following to your prompt for each `$unit`. - -```text -: -``` - -You can control these parts with the following variables: - -- ``: Set `$ZSH_THEME_SYSTEMD_PROMPT_PREFIX`. - -- ``: Set `$ZSH_THEME_SYSTEMD_PROMPT_SUFFIX`. - -- ``: name passed as parameter to the function. If you want it to be in ALL CAPS, - you can set the variable `$ZSH_THEME_SYSTEMD_PROMPT_CAPS` to a non-empty string. - -- ``: shown if the systemd unit is active. - Set `$ZSH_THEME_SYSTEMD_PROMPT_ACTIVE`. - -- ``: shown if the systemd unit is *not* active. - Set `$ZSH_THEME_SYSTEMD_PROMPT_NOTACTIVE`. - -For example, if your prompt contains `PROMPT='$(systemd_prompt_info dhcpd httpd)'` and you set the following variables: - -```sh -ZSH_THEME_SYSTEMD_PROMPT_PREFIX="[" -ZSH_THEME_SYSTEMD_PROMPT_SUFFIX="]" -ZSH_THEME_SYSTEMD_PROMPT_ACTIVE="+" -ZSH_THEME_SYSTEMD_PROMPT_NOTACTIVE="X" -ZSH_THEME_SYSTEMD_PROMPT_CAPS=1 -``` - -If `dhcpd` is running, and `httpd` is not, then your prompt will look like this: - -```text -[DHCPD: +][HTTPD: X] -```