cloudron-box/src/shell.js

'use strict';

const assert = require('assert'),
    BoxError = require('./boxerror.js'),
    child_process = require('child_process'),
    debug = require('debug')('box:shell'),
    once = require('./once.js'),
    util = require('util');

exports = module.exports = shell;

function shell(tag) {
    assert.strictEqual(typeof tag, 'string');

    return {
        exec: exec.bind(null, tag),
        spawn: spawn.bind(null, tag),
        sudo: sudo.bind(null, tag),
        promises: { sudo: util.promisify(sudo.bind(null, tag)) }
    };
}

const SUDO = '/usr/bin/sudo';

// default no shell, handles input, separate args, wait for process to finish
function spawn(tag, file, args, options) {
    assert.strictEqual(typeof tag, 'string');
    assert.strictEqual(typeof file, 'string');
    assert(Array.isArray(args));
    assert.strictEqual(typeof options, 'object');

    debug(`${tag}: ${file} ${JSON.stringify(args)}`);

    const spawnOptions = Object.assign({ shell: false }, options); // note: no encoding!

    return new Promise((resolve, reject) => {
        const cp = child_process.spawn(file, args, spawnOptions);
        const stdoutBuffers = [], stderrBuffers = [];

        cp.stdout.on('data', (data) => stdoutBuffers.push(data));
        cp.stderr.on('data', (data) => stderrBuffers.push(data));

        cp.on('close', function (code, signal) { // always called. after 'exit' or 'error'
            const stdoutBuffer = Buffer.concat(stdoutBuffers);
            const stdout = options.encoding ? stdoutBuffer.toString(options.encoding) : stdoutBuffer;
            if (code === 0) return resolve(stdout);

            const stderrBuffer = Buffer.concat(stderrBuffers);
            const stderr = options.encoding ? stderrBuffer.toString(options.encoding) : stderrBuffer;

            const e = new BoxError(BoxError.SHELL_ERROR, `${file} exited with code ${code} signal ${signal}`);
            e.stdout = stdout; // when promisified, this is the way to get stdout
            e.stderr = stderr; // when promisified, this is the way to get stderr
            e.code = code;
            e.signal = signal;

            debug(`${tag}: ${file} ${args.join(' ').replace(/\n/g, '\\n')} errored`, e);

            reject(e);
        });

        cp.on('error', function (error) { // when the command itself could not be started
            debug(`${tag}: ${file} ${args.join(' ').replace(/\n/g, '\\n')} errored`, error);
        });

        // https://github.com/nodejs/node/issues/25231
        if (options.input) {
            cp.stdin.write(options.input);
            cp.stdin.end();
        }
    });
}

// default encoding utf8, no shell, handles input, full command, wait for process to finish
async function exec(tag, cmd, options) {
    assert.strictEqual(typeof tag, 'string');
    assert.strictEqual(typeof cmd, 'string');
    assert.strictEqual(typeof options, 'object');

    if (!options.shell) {
        cmd = cmd.replace(/\s+/g, ' '); // collapse spaces when not using shell. note: no more complexity like parsing quotes here!
        const [file, ...args] = cmd.split(' ');
        return await spawn(tag, file, args, options);
    }

    debug(`${tag} exec: ${cmd}`);

    return new Promise((resolve, reject) => {
        const cp = child_process.exec(cmd, options, function (error, stdout, stderr) {
            if (!error) return resolve(stdout);

            const e = new BoxError(BoxError.SHELL_ERROR, `${tag} errored with code ${error.code} message ${error.message}`);
            e.code = error.code;
            e.signal = error.signal;
            e.stdout = stdout; // when promisified, this is the way to get stdout
            e.stderr = stderr; // when promisified, this is the way to get stderr
            debug(`${tag}: ${cmd} errored`, error);
            reject(e);
        });

        // https://github.com/nodejs/node/issues/25231
        if (options.input) {
            cp.stdin.write(options.input);
            cp.stdin.end();
        }
    });
}

function sudo(tag, args, options, callback) {
    assert.strictEqual(typeof tag, 'string');
    assert(Array.isArray(args));
    assert.strictEqual(typeof options, 'object');
    assert.strictEqual(typeof callback, 'function');

    const sudoArgs = [ '-S' ]; // -S makes sudo read stdin for password
    if (options.preserveEnv) sudoArgs.push('-E'); // -E preserves environment

    callback = once(callback); // exit may or may not be called after an 'error'

    const logFunc = options.outputHasTimestamps ? process.stdout.write : debug;

    if (options.ipc) {
        sudoArgs.push('--close-from=4'); // keep the ipc open. requires closefrom_override in sudoers file
        options.stdio = ['pipe', 'pipe', 'pipe', 'ipc'];
    }

    const spawnArgs = sudoArgs.concat(args);

    debug(`${tag} ${SUDO} ${spawnArgs.join(' ').replace(/\n/g, '\\n')}`);
    const cp = child_process.spawn(SUDO, spawnArgs, options);
    let stdoutResult = '';

    cp.stdout.on('data', (data) => {
        if (options.captureStdout) stdoutResult += data.toString('utf8');
        if (!options.quiet) logFunc(data.toString('utf8'));
    });
    cp.stderr.on('data', (data) => logFunc(data.toString('utf8')));

    cp.on('exit', function (code, signal) {
        if (code === 0) return callback(null, options.captureStdout ? stdoutResult : null);
        const e = new BoxError(BoxError.SHELL_ERROR, `${tag} exited with code ${code} signal ${signal}`);
        e.code = code;
        e.signal = signal;

        if (cp.terminated) {
            debug(`${tag}: ${SUDO} ${spawnArgs.join(' ').replace(/\n/g, '\\n')} terminated`); // was killed by us
        } else {
            debug(`${tag}: ${SUDO} ${spawnArgs.join(' ').replace(/\n/g, '\\n')} errored`, e);
        }

        callback(e);
    });

    cp.on('error', function (error) {
        debug(`${tag}: ${SUDO} ${spawnArgs.join(' ').replace(/\n/g, '\\n')} errored`, error);
        const e = new BoxError(BoxError.SHELL_ERROR, `${tag} errored with code ${error.code} message ${error.message}`);
        e.code = error.code;
        e.signal = error.signal;
        callback(e);
    });

    // sudo forks and execs the program. sudo also hangs around as the parent of the program waiting on the program and also forwarding signals.
    // sudo does not forward signals when the originator comes from the same process group. recently, there has been a change where it will
    // forward signals as long as sudo or the command is not the group leader (https://www.sudo.ws/repos/sudo/rev/d1bf60eac57f)
    // for us, this means that calling kill from this node process doesn't work since it's in the same group (and ubuntu 22 doesn't have the above fix).
    // the workaround is to invoke a kill from a different process group and this is done by starting detached
    // another idea is: use "ps --pid cp.pid -o pid=" to get the pid of the command and then send it signal directly
    cp.terminate = function () {
        cp.terminated = true; // hint for better debug message in 'exit'
        child_process.spawn('kill', ['-SIGTERM', cp.pid], { detached: true }, (error) => { if (error) debug(`${tag} could not terminate`, error); });
    };

    cp.stdin.end();
    if (options.onMessage) cp.on('message', options.onMessage);

    return cp;
}