webmin/systemd/help/systemd_socketuser.html at cbebe22a1459722ef6628d408caebdfe7727d463 - webmin - PurpleGit

michael/webmin

mirror of https://github.com/webmin/webmin.git synced 2026-06-24 21:10:29 +01:00

Files

Ilia Ross d94000afbd Add Systemd Services and Units module

This PR adds a standalone Systemd Services and Units module for managing systemd units across system and user scopes.

The module keeps systemd-specific behavior separate from the legacy Bootup and Shutdown module and is implemented as standalone `strict`/`warnings` Perl code rather than depending on its existing init helpers. Those helpers intentionally smooth over multiple init systems, while this module keeps systemd-specific file handling, user-manager behavior, ACL checks, and control operations explicit, scoped, and easier to audit.

It includes:

- Tabbed views for services, timers, sockets, paths, targets, storage, resources, devices, and user units
- Guided creation and editing for common unit types, with contextual fields, validation, and help
- User-scoped unit management with linger support and safe handling of home-directory unit files
- Runtime actions for start, stop, restart, enable, disable, status, logs, properties, dependencies, and system-unit mask/unmask
- Drop-in override inventory plus create, edit, and delete flows
- Manual unit-file editing with daemon reload reminders and actions
- Configurable module behavior, visible tabs, display options, and post-create navigation
- Comprehensive ACL controls for system/user scopes, actions, manual edits, drop-ins, linger, reload, backup, and user filters
- Safe Webmin user support through a scoped safe ACL preset
- Virtualmin integration for granting domain owners access to their own systemd user units
- Tests for unit generation, safety checks, ACL behavior, user-unit handling, backup coverage, and Perl::Critic compatibility

A companion Virtualmin PR adds template integration so domain owners can be granted scoped access to their own systemd user units when this module is installed.

2026-06-12 20:55:28 +02:00

7 lines

355 B

HTML

Raw Blame History

 <header>Socket owner</header>
 <p>The Unix user name for <tt>SocketUser=</tt>. This controls ownership of the
 socket node when systemd creates filesystem sockets or FIFOs.</p>
 <p>For user units, filesystem sockets and FIFOs are created by the selected
 user's systemd manager and are owned by that user. This guided field is used
 only for system units.</p>