diff --git a/docs-xml/smbdotconf/misc/smbdmaxasyncdosmode.xml b/docs-xml/smbdotconf/misc/smbdmaxasyncdosmode.xml
new file mode 100644
index 00000000000..b375298be31
--- /dev/null
+++ b/docs-xml/smbdotconf/misc/smbdmaxasyncdosmode.xml
@@ -0,0 +1,12 @@
+<samba:parameter name="smbd max async dosmode"
+                 context="S"
+                 type="integer"
+                 xmlns:samba="http://www.samba.org/samba/DTD/samba-doc">
+<description>
+	<para>
+	  This parameter controls how many async operations to fetch the DOS
+	  attributes the fileserver will queue when doing directory listings.
+	</para>
+</description>
+<value type="default">aio max threads * 2</value>
+</samba:parameter>
diff --git a/python/samba/tests/docs.py b/python/samba/tests/docs.py
index b64f9726367..b6c15b7d8de 100644
--- a/python/samba/tests/docs.py
+++ b/python/samba/tests/docs.py
@@ -125,6 +125,7 @@ class SmbDotConfTests(TestCase):
         'include system krb5 conf',
         'rpc server dynamic port range',
         'mit kdc command',
+        'smbd max async dosmode',
     ])
 
     def setUp(self):
@@ -247,6 +248,7 @@ class SmbDotConfTests(TestCase):
             exceptions = set([
                 'printing',
                 'rpc server dynamic port range',
+                'smbd max async dosmode',
             ])
 
             if param in exceptions: