wrapped

Crates.iowrapped
lib.rswrapped
version0.2.1
sourcesrc
created_at2019-11-28 17:22:50.345824
updated_at2019-12-04 01:33:43.22481
descriptionA simple wrapper process to forward stdio over unix sockets
homepage
repositoryhttps://git.asonix.dog/asonix/wrapped
max_upload_size
id185124
size74,569
asonix (asonix)

documentation

README

Wrapped

A simple wrapper around any user-interactive program to expose stdio over unix sockets

Why would I want this?

Say you were trying to host a minecraft server, and you want to be able to log into the server's console, but you also want to manage your server with SystemD unit files. Ordinarily this isn't possible, since running a minecraft server as a system service means you can't access it's console. This program helps you get around that.

Example

Say we want to start our minecraft server in a unit file

[Unit]
Description=Our minecraft server
After=network.target

[Service]
Type=simple
User=minecraft
WorkingDirectory=/home/minecraft
ExecStart=/usr/bin/java -Xmx1024M -Xms1024M -jar minecraft_server.1.14.4.jar nogui
TimeoutSec=15
Restart=always

[Install]
WantedBy=multi-user.target

We can make this interactable like so

[Unit]
Description=Our minecraft server
After=network.target

[Service]
Type=simple
User=minecraft
WorkingDirectory=/home/minecraft
ExecStart=/usr/local/bin/wrapped -s /tmp/uds -- /usr/bin/java -Xmx1024M -Xms1024M -jar minecraft_server.1.14.4.jar nogui
TimeoutSec=15
Restart=always

[Install]
WantedBy=multi-user.target

And now we can log into our minecraft server like this:

$ sudo -u minecraft wrapped -s /tmp/uds

Simple!

License

This project is licensed under the Cooperative Public License. See the provided LICENSE file for more information.

Commit count: 0

cargo fmt