diff --git a/man/systemctl.xml b/man/systemctl.xml index 4b25a286da..134b1a9f44 100644 --- a/man/systemctl.xml +++ b/man/systemctl.xml @@ -941,13 +941,24 @@ Jan 12 10:46:45 example.com bluetoothd[8900]: gatt-time-server: Input/output err mask UNIT - Mask one or more units, as specified on the command line. This will link these unit files to - /dev/null, making it impossible to start them. This is a stronger version of - disable, since it prohibits all kinds of activation of the unit, including enablement - and manual activation. Use this option with care. This honors the option to only - mask temporarily until the next reboot of the system. The option may be used to - ensure that the units are also stopped. This command expects valid unit names only, it does not accept unit - file paths. + Mask one or more units, as specified on the command line. This will link these unit files + to /dev/null, making it impossible to start them. This is a stronger version + of disable, since it prohibits all kinds of activation of the unit, including + enablement and manual activation. Use this option with care. This honors the + option to only mask temporarily until the next reboot of the + system. The option may be used to ensure that the units are also + stopped. This command expects valid unit names only, it does not accept unit file paths. + + Note that this will create a symlink under the unit's name in + /etc/systemd/system/ (in case is not specified) + or /run/systemd/system/ (in case is + specified). If a matching unit file already exists under these directories this operation will + hence fail. This means that the operation is primarily useful to mask units shipped by the vendor + (as those are shipped in /usr/lib/systemd/system/ and not the aforementioned + two directories), but typically doesn't work for units created locally (as those are typically + placed precisely in the two aforementioned directories). Similar restrictions apply for + mode, in which case the directories are below the user's home directory + however.