void-service-control/README.md

82 lines
1.3 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-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
$ pip install https://git.orudo.ru/trueold89/void-service-control/releases/download/0.2/VoidServiceControl-0.2.tar.gz
```
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
***
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-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)