Documentation: RobotLocomotion/drake@7713cb3

Author: drake-jenkins-bot

doxygen_cxx/classdrake_1_1lcm_1_1_drake_lcm.html

@@ -168,7 +168,8 @@
 <div class="contents">
 <a name="details" id="details"></a><h2 class="groupheader">Detailed Description</h2>
 <div class="textblock"><p>A wrapper around a <em>real</em> LCM instance. </p>
-<p>See <a class="el" href="group__allow__network.html">DRAKE_ALLOW_NETWORK</a> for an environment variable option to disable LCM network traffic (i.e., only allowing <code>memq://</code> URLs). </p>
+<p>See <a class="el" href="group__allow__network.html">DRAKE_ALLOW_NETWORK</a> for an environment variable option to disable LCM network traffic (i.e., only allowing <code>memq://</code> URLs).</p>
+<p>For network issues on macOS, see <a href="https://drake.mit.edu/troubleshooting.html#lcm-macos">https://drake.mit.edu/troubleshooting.html#lcm-macos</a>. </p>
 </div>
 <p><code>#include &lt;drake/lcm/drake_lcm.h&gt;</code></p>
 <table class="memberdecls">

pydrake/pydrake.lcm.html

@@ -131,6 +131,8 @@
 <p>See allow_network “DRAKE_ALLOW_NETWORK” for an environment variable
 option to disable LCM network traffic (i.e., only allowing <code class="docutils literal notranslate"><span class="pre">memq://</span></code>
 URLs).</p>
+<p>For network issues on macOS, see
+<a class="reference external" href="https://drake.mit.edu/troubleshooting.html#lcm-macos">https://drake.mit.edu/troubleshooting.html#lcm-macos</a>.</p>
 <dl class="py method">
 <dt class="sig sig-object py" id="pydrake.lcm.DrakeLcm.__init__">
 <span class="sig-name descname"><span class="pre">__init__</span></span><span class="sig-paren">(</span><em class="sig-param"><span class="o"><span class="pre">*</span></span><span class="n"><span class="pre">args</span></span></em>, <em class="sig-param"><span class="o"><span class="pre">**</span></span><span class="n"><span class="pre">kwargs</span></span></em><span class="sig-paren">)</span><a class="headerlink" href="#pydrake.lcm.DrakeLcm.__init__" title="Permalink to this definition"></a></dt>

pydrake/searchindex.js

@@ -170,6 +170,10 @@ <h5>Table of Contents</h5>
       <li><a href="#build-oom" id="markdown-toc-build-oom">Out of memory</a></li>
     </ul>
   </li>
+  <li><a href="#network-configuration" id="markdown-toc-network-configuration">Network Configuration</a>    <ul>
+      <li><a href="#lcm-macos" id="markdown-toc-lcm-macos">LCM on macOS</a></li>
+    </ul>
+  </li>
 </ul>
 
   </div>
@@ -415,6 +419,35 @@ <h2 id="build-oom">Out of memory</h2>
 propagate through to affect the concurrency of most of Drake’s build steps; you
 need to configure the dotfile in order to control the build concurrency.</p>
 
+  <h1 id="network-configuration">Network Configuration</h1>
+
+  <h2 id="lcm-macos">LCM on macOS</h2>
+
+  <p>When building and testing Drake from source on macOS 15 (Sequoia), you may
+encounter issues with <a href="https://lcm-proj.github.io/lcm/index.html">LCM</a>.
+In particular, an error message that can arise is: “LCM self test failed!!
+Check your routing tables and firewall settings.” LCM relies on
+<a href="https://lcm-proj.github.io/lcm/content/multicast-setup.html">UDP Multicast</a>
+over loopback, so multicast traffic must be enabled over the loopback
+interface on your computer in order for it to work.</p>
+
+  <p>Sometimes this is not explicitly enabled on macOS. If you see this error,
+check the routing table by running <code class="language-plaintext highlighter-rouge">netstat -nr</code>. The following entry in the
+IPv4 table is correct:</p>
+
+  <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>Internet:
+Destination        Gateway            Flags               Netif Expire
+...
+224.0.0/4          lo0                UmS                   lo0
+</code></pre></div>  </div>
+
+  <p>If you see a different interface for this address, such as <code class="language-plaintext highlighter-rouge">en0</code>, then
+run the following to change it to loopback (<code class="language-plaintext highlighter-rouge">lo0</code>):</p>
+
+  <div class="language-plaintext highlighter-rouge"><div class="highlight"><pre class="highlight"><code>sudo route -nv delete 224.0.0.0/4
+sudo route -nv add -net 224.0.0.0/4 -interface lo0
+</code></pre></div>  </div>
+
   <!-- Links to the various Drake doxygen pages.
      Order determined by directory structure first and names second.
 -->