From 943ce504ddb058f47d727c6df824d641253587af Mon Sep 17 00:00:00 2001
From: jkhall81 <jason.kei.hall@gmail.com>
Date: Thu, 25 Dec 2025 17:47:46 -0700
Subject: [PATCH] docs: added attributes metadata for check_mode support (fixes
 #643)

---
 changelogs/fragments/643-sysctl-docs.yml |  3 +++
 plugins/modules/sysctl.py                | 11 +++++++++++
 2 files changed, 14 insertions(+)
 create mode 100644 changelogs/fragments/643-sysctl-docs.yml

diff --git a/changelogs/fragments/643-sysctl-docs.yml b/changelogs/fragments/643-sysctl-docs.yml
new file mode 100644
index 0000000..54ffa75
--- /dev/null
+++ b/changelogs/fragments/643-sysctl-docs.yml
@@ -0,0 +1,3 @@
+---
+trivial:
+  - sysctl - added the attributes section to the module documentation to reflect check_mode support (https://github.com/ansible-collections/ansible.posix/issues/643).
diff --git a/plugins/modules/sysctl.py b/plugins/modules/sysctl.py
index 86712db..960fad3 100644
--- a/plugins/modules/sysctl.py
+++ b/plugins/modules/sysctl.py
@@ -56,6 +56,17 @@ options:
             - Verify token value with the sysctl command and set with C(-w) if necessary.
         type: bool
         default: false
+attributes:
+  check_mode:
+    support: full
+    description: Can run in check_mode and return changed status prediction without modifying target.
+  diff_mode:
+    support: none
+    description: Does not support differences output.
+  platform:
+    platforms: posix
+    support: full
+    description: Supported on POSIX-compliant systems.
 author:
 - David CHANIAL (@davixx)
 '''