hrun

command module
v0.0.4 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: May 29, 2025 License: MIT Imports: 5 Imported by: 0

README

hrun

Run commands on your host machine from inside your distrobox or toolbx container.

Highly inspired by host-spawn.

[!WARNING]
This is a work in progress and not yet ready for production use. Expect breaking changes and the worst possible bugs. A LOT of features are missing, the code is not optimized, security is not a concern and the documentation is incomplete. Good luck!

Usage

First you have to start the socket server on your host machine:

Usage: hrun [options] [command] [args...]

Options:
  -h, --help         Display this help message.
  --start            Start the server.
  --allowed-cmd      Specify allowed command (can be used multiple times).
  --socket           Specify an alternative socket path (default: /tmp/hrun.sock).

If command is "start", it starts the server with specified allowed commands.
Otherwise, it starts the client and sends the command to the server.
If no command is provided, it starts a shell on the host.

What's the point?

The main difference between hrun and host-spawn is that hrun relies on a socket server running on the host machine, while host-spawn uses the Flatpak DBus to communicate with the host, introducing 2 big dependencies.

This is not a replacement for host-spawn, but a different approach to the same problem on those systems where Flatpak or DBus are not available.

Documentation

The Go Gopher

There is no documentation for this package.

Directories

Path Synopsis
pkg

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL