void-service-control/README.md

99 lines
1.9 KiB
Markdown
Raw Normal View History

2023-08-28 08:26:11 +00:00
# Void Service Control (VSC)
## A simple script that will allow you to manage runit services in Void Linux
2024-03-27 20:57:04 +00:00
## Available on:
[![](https://cloud.orudo.ru/apps/files_sharing/publicpreview/RpcoJB8FwgNmqHC?file=/&fileId=48757&x=1920&y=1200&a=true&etag=10effec96382ba8b9fc181a5c1c85012)](https://git.orudo.ru/trueold89/void-service-control)
[![](https://cloud.orudo.ru/s/D8xtkTS8ZBCq8fC/download/GH.png)](https://github.com/Trueold89/void-service-control)
***
2024-03-25 04:40:19 +00:00
- [Installation](#install)
- [Usage](#usage)
- [Build from sources](#build-from_sources)
- [Example (Screenshot)](#example)
2024-01-06 11:39:37 +00:00
### Install:
**You can install vsc using pip:**
2024-03-25 04:40:19 +00:00
From [git.orudo.ru](https://git.orudo.ru/trueold89/void-service-control/releases):
```bash
2024-03-27 20:57:04 +00:00
$ pip install https://git.orudo.ru/trueold89/void-service-control/releases/download/0.2.1/VoidServiceControl-0.2.1.tar.gz
2024-03-25 04:40:19 +00:00
```
or pypi
2024-01-06 11:39:37 +00:00
```bash
$ pip install void-service-control
```
---
2024-03-25 04:40:19 +00:00
**Or by downloading the pre-built binary / xbps-package from the **[releases](https://git.orudo.ru/trueold89/void-service-control/releases)** page**
2024-01-06 11:39:37 +00:00
2024-03-27 20:57:04 +00:00
#### Install [.xbps package](https://git.orudo.ru/trueold89/void-service-control/releases):
```bash
& xbps-rindex -a *.xbps && xbps-install --repository=$PWD void-service-control
```
2024-01-06 11:39:37 +00:00
***
2023-08-28 08:26:11 +00:00
### Usage:
**Enbale service:**
2024-01-06 11:39:37 +00:00
```bash
$ vsc e <service_name>
2023-08-28 08:26:11 +00:00
```
**Disable service:**
2024-01-06 11:39:37 +00:00
```bash
$ vsc d <service_name>
2023-08-28 08:26:11 +00:00
```
2024-03-27 20:57:04 +00:00
**Action with multiple services:**
```bash
$ vsc e <first_service_name> <second_service_name>
```
2024-03-25 04:40:19 +00:00
**Print help:**
2023-08-28 08:26:11 +00:00
2024-01-06 11:39:37 +00:00
```bash
$ vsc --help
2023-08-28 08:26:11 +00:00
```
*All commands require root privileges*
2024-03-25 04:40:19 +00:00
### Build from sources
**Clone repo:**
```bash
$ git clone https://git.orudo.ru/trueold89/void-service-control.git --depth=1 && cd void-service-control
```
**Install deps:**
```bash
$ pip install setuptools
```
**Build sdist:**
```bash
$ python3 setup.py sdist
```
**Install:**
```bash
$ pip install dist/*
```
*Last command require root privileges*
2024-01-06 11:39:37 +00:00
***
2023-08-28 08:26:11 +00:00
## Example:
2024-03-25 04:40:19 +00:00
![](.ex.jpg)