Deployed e804d09 with MkDocs version: 1.6.1

guide/cli-reference/index.html

@@ -3295,6 +3295,10 @@ and keeps the service's numbering unchanged. Pick an order that covers the whole
 <td>Use only the CDM, or only Key Vaults, for key acquisition.</td>
 </tr>
 <tr>
+<td><code>--cdm &lt;name&gt;</code></td>
+<td>Use the named CDM device from the <code>cdm</code> config mapping for this run, ignoring the service/default mapping.</td>
+</tr>
+<tr>
 <td><code>--skip-dl</code></td>
 <td>Skip the download but still retrieve keys.</td>
 </tr>

guide/downloading/index.html

@@ -3921,6 +3921,7 @@ configured proxy providers), or a <code>provider:region</code> form.</p>
 a content key when the vault misses. You can force one side or the other:</p>
 <ul>
 <li><code>--cdm-only</code>: only use the CDM (skip vaults).</li>
+<li><code>--cdm &lt;name&gt;</code>: use the named CDM device for this run, ignoring the <code>cdm</code> config mapping (including its quality and Widevine/PlayReady sub-entries).</li>
 <li><code>--vaults-only</code>: only use key vaults and never license through the CDM. A missing
   content key fails.</li>
 </ul>
@@ -4298,6 +4299,11 @@ authoritative list.</p>
 <td>Content key source control.</td>
 </tr>
 <tr>
+<td><code>--cdm &lt;name&gt;</code></td>
+<td></td>
+<td>Pin one CDM device, bypassing the <code>cdm</code> config mapping.</td>
+</tr>
+<tr>
 <td><code>--export</code></td>
 <td></td>
 <td>Export track info and keys to JSON.</td>

guide/drm-and-cdm/index.html

@@ -2996,6 +2996,10 @@ control this trade-off on the <code>dl</code> command:</p>
 <td><code>--cdm-only</code></td>
 <td>Ignore vaults for sourcing keys and always perform a fresh license request.</td>
 </tr>
+<tr>
+<td><code>--cdm &lt;name&gt;</code></td>
+<td>Use the named CDM device for this run instead of the one the <code>cdm</code> config maps for the service.</td>
+</tr>
 </tbody>
 </table>
 <p>See <a href="../vaults/">key vaults</a> for how to configure vault backends.</p>

reference/configuration/drm/index.html

@@ -2083,8 +2083,9 @@ the <a href="../../../guide/drm-and-cdm/">DRM &amp; CDM guide</a>. Device files
 <li><strong>Type:</strong> <code>dict</code> &nbsp;·&nbsp; <strong>Default:</strong> <code>{}</code></li>
 </ul>
 <p>Maps a service tag to the CDM (Widevine/PlayReady device) to use, with a <code>default</code> fallback.
-Resolution is case-insensitive: a per-request API override wins, then the per-service entry,
-then <code>default</code>.</p>
+Resolution is case-insensitive: an override (<code>dl --cdm &lt;name&gt;</code>, or the <code>cdm</code> field of an API
+job) wins, then the per-service entry, then <code>default</code>. An override pins one device for the whole
+run and skips any quality or Widevine/PlayReady sub-entries.</p>
 <div class="language-yaml highlight"><pre><span></span><code><span id="__span-0-1"><a id="__codelineno-0-1" name="__codelineno-0-1" href="#__codelineno-0-1"></a><span class="nt">cdm</span><span class="p">:</span>
 </span><span id="__span-0-2"><a id="__codelineno-0-2" name="__codelineno-0-2" href="#__codelineno-0-2"></a><span class="w">  </span><span class="nt">default</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">chromecdm_l3</span>
 </span><span id="__span-0-3"><a id="__codelineno-0-3" name="__codelineno-0-3" href="#__codelineno-0-3"></a><span class="w">  </span><span class="nt">EXAMPLE2</span><span class="p">:</span><span class="w"> </span><span class="l l-Scalar l-Scalar-Plain">android_l1</span>