man: clarify enqueue-marked uses try-restart semantics

Document that needs-restart/needs-reload markers follow try-restart /
try-reload behavior for enqueue-marked, and drop the duplicated note
from the deprecated --marked alias entry.
This commit is contained in:
Hashim Khan
2026-08-06 01:53:42 +09:00
committed by Yu Watanabe
parent 756399c79e
commit c59ad15aec
+6
View File
@@ -514,6 +514,12 @@ Jan 12 10:46:45 example.com bluetoothd[8900]: gatt-time-server: Input/output err
<literal>needs-*</literal> markers set. When a unit marked for reload does not support reload,
restart will be queued. Those properties can be set using <command>set-property Markers=…</command>.</para>
<para>Note that <literal>needs-restart</literal> and <literal>needs-reload</literal> use
<command>try-restart</command>/<literal>try-reload</literal> semantics: inactive units are not started.
This differs from <command>reload-or-restart</command> without <option>--marked</option>, which
starts units that are not yet running. Markers such as <literal>needs-start</literal> still
enqueue an unconditional start job.</para>
<para>Unless <option>--no-block</option> is used, <command>systemctl</command> will wait for the
queued jobs to finish.</para>