#stdio #system #unix-socket #sockets #server #forward #minecraft-server

app wrapped

A simple wrapper process to forward stdio over unix sockets

2 releases

0.2.1 Dec 4, 2019
0.2.0 Nov 28, 2019

#44 in #forward

29 downloads per month

Custom license

19KB
370 lines

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.

Dependencies

~10–19MB
~235K SLoC