FUDO README

fudo is a wrapper for translating sudo commands to doas commands. Typically, fudo is invoked via a symbolic link named sudo. It parses the arguments originally intended for sudo, translates those arguments to a doas command, and then invokes doas with the translated arguments.

Features

Since the sudo feature set is larger than doas, not all sudo commands can be converted into exact doas commands. For instance, sudo has a --preserve-env flag with no direct doas equivalent. However, the doas.conf options keepenv and setenv can be set to produce a similar effect.

The goal of fudo is to facilitate the replacement of sudo with doas on operating systems built to integrate with sudo (e.g., Arch Linux, which deploys scripts using sudo-specific features). This is achieved by converting as many flags as possible and ignoring the rest. Flags that can't be translated are left to be configured in doas.conf. The system administrator must decide how doas.conf should be configured to accommodate the necessary environment.

Building & Installation

To build fudo, navigate to its source directory and run:

make

To install fudo as the root user, execute:

install fudo /usr/bin/fudo
ln -s /usr/bin/fudo /usr/bin/sudo

Using fudo

Once installed, any sudo command will be converted to a doas command. By default, fudo displays the command translation to stderr. For example:

$ sudo whoami
fudo <<< sudo whoami
fudo >>> /usr/bin/doas whoami
root

You can disable this by setting the environment variable FUDO_HIDE:

$ export FUDO_HIDE=1
$ sudo whoami
root

The environment variables SUDO_USER, SUDO_UID, and SUDO_GID are always passed to doas. If you're running scripts or commands that rely on these variables, ensure doas.conf is configured to use them. For example:

permit setenv { SUDO_USER SUDO_UID SUDO_GID } user as root