From cc01a73ef0b1c6fe7b79018c6545d420b29bb5c0 Mon Sep 17 00:00:00 2001 From: Brian Coca Date: Thu, 3 Aug 2023 15:17:07 -0400 Subject: [PATCH] service action: improve documenation about service and service (#81405) * service action: improve documenation about service and service moudule used as backup and cli that confuses everyone * Update service.py --------- Co-authored-by: Matt Davis <6775756+nitzmahone@users.noreply.github.com> --- lib/ansible/modules/service.py | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/lib/ansible/modules/service.py b/lib/ansible/modules/service.py index a9d48e79c40..b562f53d036 100644 --- a/lib/ansible/modules/service.py +++ b/lib/ansible/modules/service.py @@ -82,6 +82,7 @@ options: description: - The service module actually uses system specific modules, normally through auto detection, this setting can force a specific module. - Normally it uses the value of the 'ansible_service_mgr' fact and falls back to the old 'service' module when none matching is found. + - The 'old service module' still uses autodetection and in no way does it correspond to the C(service) command. type: str default: auto version_added: 2.2 @@ -106,6 +107,9 @@ attributes: platforms: all notes: - For AIX, group subsystem names can be used. + - The C(service) command line utility is not part of any service manager system but a convenience. + It does not have a standard implementation across systems, and this action cannot use it directly. + Though it might be used if found in certain circumstances, the detected system service manager is normally preferred. seealso: - module: ansible.windows.win_service author: