From 75f4bd7fd0a28e4080a3f0c05a574820dc9411ac Mon Sep 17 00:00:00 2001
From: =?utf8?q?Martin=20Hundeb=C3=B8ll?= <martin@geanix.com>
Date: Fri, 1 May 2020 10:27:06 +0200
Subject: [PATCH] man: document ReadWriteOnly property for mount units

---
 docs/TRANSIENT-SETTINGS.md |  1 +
 man/systemd.mount.xml      | 13 +++++++++++++
 2 files changed, 14 insertions(+)

diff --git a/docs/TRANSIENT-SETTINGS.md b/docs/TRANSIENT-SETTINGS.md
index d5a80466769..d9b1c20c77f 100644
--- a/docs/TRANSIENT-SETTINGS.md
+++ b/docs/TRANSIENT-SETTINGS.md
@@ -332,6 +332,7 @@ All mount unit settings are available to transient units:
 ✓ SloppyOptions=
 ✓ LazyUnmount=
 ✓ ForceUnmount=
+✓ ReadWriteOnly=
 ```
 
 ## Automount Unit Settings
diff --git a/man/systemd.mount.xml b/man/systemd.mount.xml
index d775d74053f..d18773663fd 100644
--- a/man/systemd.mount.xml
+++ b/man/systemd.mount.xml
@@ -497,6 +497,19 @@
         off.</para></listitem>
       </varlistentry>
 
+      <varlistentry>
+        <term><varname>ReadWriteOnly=</varname></term>
+
+        <listitem><para>Takes a boolean argument. If false, a mount
+        point that shall be mounted read-write but cannot be mounted
+        so is retried to be mounted read-only. If true the operation
+        will fail immediately after the read-write mount attempt did
+        not succeed. This corresponds with
+        <citerefentry project='man-pages'><refentrytitle>mount</refentrytitle><manvolnum>8</manvolnum></citerefentry>'s
+        <parameter>-w</parameter> switch. Defaults to
+        off.</para></listitem>
+      </varlistentry>
+
       <varlistentry>
         <term><varname>ForceUnmount=</varname></term>
 
-- 
2.47.3