A simple wrapper program to expose stdio over unix sockets
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
Arlo (Hyena) 53f712adc1 Clean a couple loops 2 months ago
src Clean a couple loops 2 months ago
.gitignore Initial commit 2 months ago
Cargo.lock 0.2.0-alpha.1 2 months ago
Cargo.toml 0.2.0-alpha.1 2 months ago
LICENSE Initial commit 2 months ago
README.md Add sudo -u to readme 2 months ago

README.md

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.