Skip to content

Commit 6508bcc

Browse files
committed
Add troubleshooting section about handling ABI breaks
It happens frequently that people run into symbol lookup errors due to ABI breaks. This section should give them something to do on that.
1 parent 81f71bc commit 6508bcc

File tree

1 file changed

+26
-0
lines changed

1 file changed

+26
-0
lines changed

ur_robot_driver/doc/usage/toc.rst

Lines changed: 26 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -117,3 +117,29 @@ On the e-Series the robot has to be in :ref:`remote control mode <operation_mode
117117
.. |play_button| image:: ../resources/play_button.svg
118118
:height: 20px
119119
:width: 20px
120+
121+
When I start the driver, I get a symbol lookup error
122+
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
123+
124+
This error can show for example like this:
125+
126+
.. code-block:: text
127+
128+
[ros2_control_node-1] /opt/ros/rolling/lib/controller_manager/ros2_control_node: symbol lookup error: /opt/ros/rolling/lib/libpal_statistics_msgs__rosidl_typesupport_fastrtps_cpp.so: undefined symbol: _ZN8eprosima7fastcdr3Cdr9serializeEj
129+
[ERROR] [ros2_control_node-1]: process has died [pid 251, exit code 127, cmd '/opt/ros/rolling/lib/controller_manager/ros2_control_node --ros-args --params-file /opt/ros/rolling/share/ur_robot_driver/config/ur5e_update_rate.yaml --params-file /tmp/launch_params_cdtxg1uh'].
130+
131+
132+
When an upstream package introduces an ABI break, you may see this error. This can happen in two
133+
situations:
134+
135+
- You have installed ROS a longer time ago and you have installed the driver package recently.
136+
- You have compiled the driver from source and you have updated your system, so the upstream
137+
libraries are there in a newer (ABI incompatible) version.
138+
139+
When this happens, it is best to update your complete system using
140+
141+
.. code-block:: console
142+
143+
$ sudo apt update && sudo apt dist-upgrade
144+
145+
and then recompile your workspace if you have built things from source.

0 commit comments

Comments
 (0)