README add/update
This commit is contained in:
parent
61e5509636
commit
c2d8f143c1
23
README.md
23
README.md
@ -10,16 +10,19 @@
|
||||
myRPC/
|
||||
├── libmysyslog/
|
||||
│ ├── Makefile
|
||||
│ ├── README.md
|
||||
│ ├── libmysyslog.c
|
||||
│ └── libmysyslog.h
|
||||
├── systemd/
|
||||
│ └── myrpc-server.service
|
||||
├── myRPC-client/
|
||||
│ ├── Makefile
|
||||
│ ├── README.md
|
||||
│ └── src/
|
||||
│ └── myRPC-client.c
|
||||
├── myRPC-server
|
||||
│ ├── Makefile
|
||||
│ ├── README.md
|
||||
│ └── src/
|
||||
│ └── myRPC-server.c
|
||||
└── Makefile
|
||||
@ -39,10 +42,18 @@ myRPC/
|
||||
make all
|
||||
```
|
||||
|
||||
Сборка производится в директории `build`. Там же будут размещены исполняемые файлы:
|
||||
Сборка производится в директории соответствующих подпроектам дирректориях. Там же будут размещены исполняемые файлы:
|
||||
|
||||
- `build/myRPC-client`
|
||||
- `build/myRPC-server`
|
||||
- `myRPC-client/myRPC-client`
|
||||
- `myRPC-server/myRPC-server`
|
||||
|
||||
### Подлючение библиотеки проекта
|
||||
|
||||
1. При работе на локальном машине, требуется подключить библиотеку `libmysyslog` для работоспособности проекта.
|
||||
2. Выполните следующую команду:
|
||||
```sh
|
||||
export LD_LIBRARY_PATH=/home/user/myRPC/libmysyslog:$LD_LIBRARY_PATH
|
||||
```
|
||||
|
||||
## Использование
|
||||
|
||||
@ -69,19 +80,19 @@ make all
|
||||
Запустите сервер:
|
||||
|
||||
```bash
|
||||
sudo ./build/myRPC-server
|
||||
sudo myRPC-server
|
||||
```
|
||||
|
||||
### Использование клиента
|
||||
|
||||
```bash
|
||||
./build/myRPC-client -h <адрес_сервера> -p <порт> -s -c "команда bash"
|
||||
myRPC-client -h <адрес_сервера> -p <порт> -s -c "команда bash"
|
||||
```
|
||||
|
||||
Пример:
|
||||
|
||||
```bash
|
||||
./build/myRPC-client -h 127.0.0.1 -p 1234 -s -c "ls -la"
|
||||
myRPC-client -h 127.0.0.1 -p 1234 -s -c "ls -la"
|
||||
```
|
||||
|
||||
## Создание deb-пакетов
|
||||
|
||||
25
myRPC-client/README.md
Normal file
25
myRPC-client/README.md
Normal file
@ -0,0 +1,25 @@
|
||||
Консольная утилита для отправки команд на удалённый myRPC-сервер.
|
||||
|
||||
## Сборка
|
||||
|
||||
```bash
|
||||
cd myRPC-client
|
||||
make all
|
||||
```
|
||||
|
||||
В результате появится исполняемый файл `myRPC-client`.
|
||||
|
||||
## Использование
|
||||
|
||||
```bash
|
||||
./myRPC-client -s|--stream | -d|--dgram \
|
||||
-h <IP_сервера> \
|
||||
-p <порт> \
|
||||
-c|--command "bash команда"
|
||||
```
|
||||
|
||||
Примеры:
|
||||
```bash
|
||||
./myRPC-client -s -h 192.168.0.10 -p 1234 -c "ls -la /tmp"
|
||||
./myRPC-client --dgram --host 10.0.0.5 --port 4321 --command "df -h"
|
||||
```
|
||||
57
myRPC-server/README.md
Normal file
57
myRPC-server/README.md
Normal file
@ -0,0 +1,57 @@
|
||||
Служба-демон для удалённого выполнения команд по протоколу myRPC.
|
||||
|
||||
## Зависимости
|
||||
|
||||
- GCC (gcc)
|
||||
- libconfig (`libconfig-dev`)
|
||||
- libmysyslog (собирается в подпроекте `libmysyslog`)
|
||||
- pkg-config
|
||||
|
||||
Установите зависимости:
|
||||
```bash
|
||||
sudo apt-get update
|
||||
sudo apt-get install -y gcc make libconfig-dev pkg-config
|
||||
```
|
||||
|
||||
## Сборка
|
||||
|
||||
```bash
|
||||
cd myRPC-server
|
||||
make all
|
||||
```
|
||||
|
||||
- Соберётся бинарник `myRPC-server` в текущей папке.
|
||||
- Он автоматически требует, чтобы в соседней папке `../libmysyslog` уже была собрана библиотека `libmysyslog.a` или `.so`. Если не собрана, запустите там `make all`.
|
||||
|
||||
## Настройка
|
||||
|
||||
1. Создайте каталог `/etc/myRPC`:
|
||||
```bash
|
||||
sudo mkdir -p /etc/myRPC
|
||||
```
|
||||
2. Файл `/etc/myRPC/myRPC.conf`:
|
||||
```conf
|
||||
port = 1234;
|
||||
socket_type = "stream"; # stream или dgram
|
||||
```
|
||||
3. Файл `/etc/myRPC/users.conf` — список разрешённых пользователей, по одному на строку:
|
||||
```
|
||||
alice
|
||||
bob
|
||||
```
|
||||
|
||||
## Запуск
|
||||
```bash
|
||||
sudo ./myRPC-server
|
||||
```
|
||||
|
||||
## Пакет
|
||||
|
||||
Создать DEB-пакет:
|
||||
```bash
|
||||
make deb
|
||||
```
|
||||
Получится `MyRPC_server_1.0-0_all.deb`. Устанавливается командой:
|
||||
```bash
|
||||
sudo dpkg -i MyRPC_server_1.0-0_all.deb
|
||||
```
|
||||
Loading…
x
Reference in New Issue
Block a user