From 873fffae7343a7521547c2f026174e7b9c00e477 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?J=C3=B8rgen=20Kvalsvik?= Date: Fri, 16 Mar 2018 18:43:07 +0100 Subject: [PATCH] Add common issues section in readme Add a common issues section in the readme, for frequently encountered problems, and possible solutions. --- README.md | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/README.md b/README.md index f7d163cb6..55149acfb 100644 --- a/README.md +++ b/README.md @@ -20,6 +20,7 @@ * [Goals](#project-goals) * [Contributing](#contributing) * [Examples](#examples) +* [Common issues](#common-issues) * [History](#history) ## Introduction ## @@ -544,6 +545,25 @@ data1 = 2*data; Segy.put_traces(output_file, data1); ``` +## Common issues ## + +### ImportError: libsegyio.so.1: cannot open shared object file + +This error shows up when the loader cannot find the core segyio library. If +you've explicitly set the install prefix (with `-DCMAKE_INSTALL_PREFIX`) you +must configure your loader to also look in this prefix, either with a +`ld.conf.d` file or the `LD_LIBRARY_PATH` variable. + +If you haven't set `CMAKE_INSTALL_PREFIX`, cmake will by default install to +`/usr/local`, which your loader usually knows about. On Debian based systems, +the library often gets installed to `/usr/local/lib`, which the loader may not +know about. See [issue #239](https://github.com/Statoil/segyio/issues/239). + +#### Possible solutions + +* Configure the loader (`sudo ldconfig` often does the trick) +* Install with a different, known prefix, e.g. `-DCMAKE_INSTALL_LIBDIR=lib64` + ## History ## Segyio was initially written and is maintained by [Statoil ASA](http://www.statoil.com/) as a free, simple, easy-to-use way of interacting