Skip to content

Lightpanda: the headless browser designed for AI and automation

3.2 KB
Raw Blame
// Copyright (C) 2023-2026  Lightpanda (Selecy SAS)
//
// Francis Bouvier <[email protected]>
// Pierre Tachoire <[email protected]>
//
// This program is free software: you can redistribute it and/or modify
// it under the terms of the GNU Affero General Public License as
// published by the Free Software Foundation, either version 3 of the
// License, or (at your option) any later version.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU Affero General Public License for more details.
//
// You should have received a copy of the GNU Affero General Public License
// along with this program.  If not, see <https://www.gnu.org/licenses/>.

//! Opt-in core-dump suppression.
//!
//! On Linux, fatal signals are re-raised after nonblocking diagnostics.
//! Core limits still apply, but the core captures the re-raise context;
//! the diagnostic record holds the original fault PC. Other platforms keep
//! their existing signal handling. Signals and panics can produce cores. When many
//! instances run under a shared `core_pattern` crash reporter — e.g. a
//! containerized crawl fleet — those dumps become pure storage and alert
//! noise, and a browser core can capture the contents of arbitrary pages.
//! `LIGHTPANDA_DISABLE_CORE_DUMP` lets an operator drop the cores while
//! leaving the default behavior (and local debugging) untouched.

const std = @import("std");
const builtin = @import("builtin");
const lp = @import("lightpanda.zig");

const log = lp.log;

pub fn disableIfRequested() void {
    if (!shouldDisable()) return;
    disable() catch |err| {
        log.warn(.app, "could not disable core dumps", .{ .err = err });
    };
}

fn shouldDisable() bool {
    if (builtin.target.os.tag == .windows) return false;
    return std.c.getenv("LIGHTPANDA_DISABLE_CORE_DUMP") != null;
}

// Zeroes only the soft limit; that is what the kernel consults when deciding
// whether to dump (including the piped-`core_pattern` opt-out), and keeping the
// hard limit lets the process raise it again if it ever needs to.
fn disable() !void {
    var limit = try std.posix.getrlimit(.CORE);
    limit.cur = 0;
    try std.posix.setrlimit(.CORE, limit);
}

const testing = @import("testing.zig");

extern fn setenv(name: [*:0]u8, value: [*:0]u8, override: c_int) c_int;
extern fn unsetenv(name: [*:0]u8) c_int;

test "core_dump: disabled only when the env var is set" {
    _ = unsetenv(@constCast("LIGHTPANDA_DISABLE_CORE_DUMP"));
    try testing.expectEqual(false, shouldDisable());

    _ = setenv(@constCast("LIGHTPANDA_DISABLE_CORE_DUMP"), @constCast(""), 1);
    defer _ = unsetenv(@constCast("LIGHTPANDA_DISABLE_CORE_DUMP"));
    try testing.expectEqual(true, shouldDisable());
}

test "core_dump: disable zeroes the soft RLIMIT_CORE" {
    if (builtin.target.os.tag == .windows) return;

    const original = try std.posix.getrlimit(.CORE);
    defer std.posix.setrlimit(.CORE, original) catch {};

    try disable();

    const after = try std.posix.getrlimit(.CORE);
    try testing.expectEqual(@as(@TypeOf(after.cur), 0), after.cur);
    try testing.expectEqual(original.max, after.max);
}