Skip to content

Commit 4f6d745

Browse files
authored
Add troubleshooting section about handling ABI breaks (#1350)
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 18f676c commit 4f6d745

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)