From d175651f5f4b806782a47ce4ec64bc1b53dcb1b7 Mon Sep 17 00:00:00 2001 From: Imgyu Kim Date: Fri, 20 Mar 2026 22:18:07 +0900 Subject: [PATCH] Docs: note that service.masked may require service.disabled first (#61322) Add a note to the service.masked docstring advising users to disable the service before masking it, as masking an enabled service can result in a systemd error. --- salt/states/service.py | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/salt/states/service.py b/salt/states/service.py index ab14ed0abf1c..183d3d9cd4f8 100644 --- a/salt/states/service.py +++ b/salt/states/service.py @@ -832,6 +832,12 @@ def masked(name, runtime=False): Ensures that the named service is masked (i.e. prevented from being started). + .. note:: + If the service is currently enabled, it should be disabled first + using :py:func:`service.disabled ` + before masking. Attempting to mask an enabled service may result + in a systemd error. + name Name of the service to mask