[sigrok-util.git] / cross-compile / appimage / contrib / excludelist

# This file lists libraries that we will assume to be present on the host system and hence
# should NOT be bundled inside AppImages. This is a working document; expect it to change
# over time. File format: one filename per line. Each entry should have a justification comment.

# See the useful tool at https://abi-laboratory.pro/index.php?view=navigator&symbol=hb_buffer_set_cluster_level#result
# to investigate issues with missing symbols.

ld-linux.so.2
ld-linux-x86-64.so.2
libanl.so.1
libBrokenLocale.so.1
libcidn.so.1
libcrypt.so.1
libc.so.6
libdl.so.2
libm.so.6
libmvec.so.1
libnsl.so.1
libnss_compat.so.2
libnss_db.so.2
libnss_dns.so.2
libnss_files.so.2
libnss_hesiod.so.2
libnss_nisplus.so.2
libnss_nis.so.2
libpthread.so.0
libresolv.so.2
librt.so.1
libthread_db.so.1
libutil.so.1
# These files are all part of the GNU C Library which should never be bundled.
# List was generated from a fresh build of glibc 2.25.

libstdc++.so.6
# Workaround for:
# usr/lib/libstdc++.so.6: version `GLIBCXX_3.4.21' not found

libGL.so.1
libEGL.so.1
# Part of the video driver (OpenGL); present on any regular
# desktop system, may also be provided by proprietary drivers.
# Known to cause issues if it's bundled.

libdrm.so.2
# Workaround for:
# Antergos Linux release 2015.11 (ISO-Rolling)
# /usr/lib/libdrm_amdgpu.so.1: error: symbol lookup error: undefined symbol: drmGetNodeTypeFromFd (fatal)
# libGL error: unable to load driver: swrast_dri.so
# libGL error: failed to load driver: swrast
# Unrecognized OpenGL version

libglapi.so.0
# Part of mesa
# known to cause problems with graphics, see https://github.com/RPCS3/rpcs3/issues/4427#issuecomment-381674910

libxcb.so.1
# Workaround for:
# Fedora 23
# symbol lookup error: /lib64/libxcb-dri3.so.0: undefined symbol: xcb_send_fd
# Uncertain if this is required to be bundled for some distributions - if so we need to write a version check script and use LD_PRELOAD to load the system version if it is newer
# Fedora 25:
# undefined symbol: xcb_send_request_with_fds
# https://github.com/AppImage/AppImages/issues/128

libX11.so.6
# Workaround for:
# Fedora 23
# symbol lookup error: ./lib/libX11.so.6: undefined symbol: xcb_wait_for_reply64
# Uncertain if this is required to be bundled for some distributions - if so we need to write a version check script and use LD_PRELOAD to load the system version if it is newer

libgio-2.0.so.0
# Workaround for:
# On Ubuntu, "symbol lookup error: /usr/lib/x86_64-linux-gnu/gtk-2.0/modules/liboverlay-scrollbar.so: undefined symbol: g_settings_new"

# libgdk-x11-2.0.so.0 # Missing on openSUSE-Tumbleweed-KDE-Live-x86_64-Snapshot20170601-Media.iso
# libgtk-x11-2.0.so.0 # Missing on openSUSE-Tumbleweed-KDE-Live-x86_64-Snapshot20170601-Media.iso

libasound.so.2
# Workaround for:
# No sound, e.g., in VLC.AppImage (does not find sound cards)

libgdk_pixbuf-2.0.so.0
# Workaround for:
# On Ubuntu, get (inkscape:25621): GdkPixbuf-WARNING **: Error loading XPM image loader: Image type 'xpm' is not supported

libfontconfig.so.1
# Workaround for:
# Application stalls when loading fonts during application launch; e.g., KiCad on ubuntu-mate

libthai.so.0
# Workaround for:
# audacity: /tmp/.mount_AudaciUsFbON/usr/lib/libthai.so.0: version `LIBTHAI_0.1.25' not found (required by /usr/lib64/libpango-1.0.so.0)
# on openSUSE Tumbleweed

# other "low-level" font rendering libraries
# should fix https://github.com/probonopd/linuxdeployqt/issues/261#issuecomment-377522251
# and https://github.com/probonopd/linuxdeployqt/issues/157#issuecomment-320755694
libfreetype.so.6
libharfbuzz.so.0

# Note, after discussion we do not exlude this, but we can use a dummy library that just does nothing
# libselinux.so.1
# Workaround for:
# sed: error while loading shared libraries: libpcre.so.3: cannot open shared object file: No such file or directory
# Some distributions, such as Arch Linux, do not come with libselinux.so.1 by default.
# The solution is to bundle a dummy mock library:
# echo "extern int is_selinux_enabled(void){return 0;}" >> selinux-mock.c
# gcc -s -shared -o libselinux.so.1 -Wl,-soname,libselinux.so.1 selinux-mock.c 
# strip libselinux.so.1
# More information: https://github.com/AppImage/AppImages/issues/83

# The following are assumed to be part of the base system
# Removing these has worked e.g., for Krita. Feel free to report if
# you think that some of these should go into AppImages and why.
libcom_err.so.2
libcrypt.so.1
libexpat.so.1
libgcc_s.so.1
libglib-2.0.so.0
libgpg-error.so.0
# libgssapi_krb5.so.2 # Disputed, seemingly needed by Arch Linux since Kerberos is named differently there
# libgssapi.so.3 # Seemingly needed when running Ubuntu 14.04 binaries on Fedora 23
# libhcrypto.so.4 # Missing on openSUSE LEAP 42.0
# libheimbase.so.1 # Seemingly needed when running Ubuntu 14.04 binaries on Fedora 23
# libheimntlm.so.0 # Seemingly needed when running Ubuntu 14.04 binaries on Fedora 23
# libhx509.so.5 # Missing on openSUSE LEAP 42.0
libICE.so.6
# libidn.so.11 # Does not come with Solus by default
# libk5crypto.so.3 # Runnning AppImage built on Debian 9 or Ubuntu 16.04 on an Archlinux fails otherwise; https://github.com/AppImage/AppImages/issues/301
libkeyutils.so.1
# libkrb5.so.26 # Disputed, seemingly needed by Arch Linux since Kerberos is named differently there. Missing on openSUSE LEAP 42.0
# libkrb5.so.3 # Disputed, seemingly needed by Arch Linux since Kerberos is named differently there
# libkrb5support.so.0 # Disputed, seemingly needed by Arch Linux since Kerberos is named differently there
libp11-kit.so.0
# libpcre.so.3 # Missing on Fedora 24, SLED 12 SP1, and openSUSE Leap 42.2
# libroken.so.18 # Mission on openSUSE LEAP 42.0
# libsasl2.so.2 # Seemingly needed when running Ubuntu 14.04 binaries on Fedora 23
libSM.so.6
libusb-1.0.so.0
libuuid.so.1
# libwind.so.0 # Missing on openSUSE LEAP 42.0
libz.so.1

# Potentially dangerous libraries
libgobject-2.0.so.0

# Workaround for:
# Rectangles instead of fonts
# https://github.com/AppImage/AppImages/issues/240
libpangoft2-1.0.so.0
libpangocairo-1.0.so.0
libpango-1.0.so.0

# Workaround for:
# e.g., Spotify
# relocation error: /lib/x86_64-linux-gnu/libgcrypt.so.20: 
# symbol gpgrt_lock_lock, version GPG_ERROR_1.0 not defined
# in file libgpg-error.so.0 with link time reference
libgpg-error.so.0

libjack.so.0
# it must match the ABI of the JACK server which is installed in the base system
# rncbc confirmed this

# Unsolved issue:
# https://github.com/probonopd/linuxdeployqt/issues/35
# Error initializing NSS with a persistent database (sql:/home/me/.pki/nssdb): libsoftokn3.so: cannot open shared object file: No such file or directory
# Error initializing NSS without a persistent database: NSS error code: -5925
# nss_error=-5925, os_error=0
# libnss3.so should not be removed from the bundles, as this causes other issues, e.g.,
# https://github.com/probonopd/linuxdeployqt/issues/35#issuecomment-256213517
# and https://github.com/AppImage/AppImages/pull/114
# libnss3.so

# The following cannot be excluded, see
# https://github.com/AppImage/AppImages/commit/6c7473d8cdaaa2572248dcc53d7f617a577ade6b
# http://stackoverflow.com/questions/32644157/forcing-a-binary-to-use-a-specific-newer-version-of-a-shared-library-so
# libssl.so.1
# libssl.so.1.0.0
# libcrypto.so.1
# libcrypto.so.1.0.0

# The following may be spefific to a particular GPU and may need to be excluded
# according to https://github.com/RicardoEPRodrigues/3Engine/issues/4#issuecomment-402532194
# libGLEW.so.2.0 # to be confirmed
# libglut.so.3 # to be confirmed
Commit	Line	Data
63fc42fe UH	1	# This file lists libraries that we will assume to be present on the host system and hence
	2	# should NOT be bundled inside AppImages. This is a working document; expect it to change
	3	# over time. File format: one filename per line. Each entry should have a justification comment.
	4
ca369dfa UH	5	# See the useful tool at https://abi-laboratory.pro/index.php?view=navigator&symbol=hb_buffer_set_cluster_level#result
	6	# to investigate issues with missing symbols.
	7
8c7df980 UH	8	ld-linux.so.2
	9	ld-linux-x86-64.so.2
	10	libanl.so.1
	11	libBrokenLocale.so.1
	12	libcidn.so.1
	13	libcrypt.so.1
63fc42fe	14	libc.so.6
63fc42fe	15	libdl.so.2
63fc42fe	16	libm.so.6
8c7df980 UH	17	libmvec.so.1
	18	libnsl.so.1
	19	libnss_compat.so.2
	20	libnss_db.so.2
	21	libnss_dns.so.2
	22	libnss_files.so.2
	23	libnss_hesiod.so.2
	24	libnss_nisplus.so.2
	25	libnss_nis.so.2
63fc42fe	26	libpthread.so.0
63fc42fe	27	libresolv.so.2
8c7df980 UH	28	librt.so.1
	29	libthread_db.so.1
	30	libutil.so.1
	31	# These files are all part of the GNU C Library which should never be bundled.
	32	# List was generated from a fresh build of glibc 2.25.
	33
	34	libstdc++.so.6
63fc42fe	35	# Workaround for:
8c7df980	36	# usr/lib/libstdc++.so.6: version `GLIBCXX_3.4.21' not found
63fc42fe UH	37
63fc42fe UH	38	libGL.so.1
ca369dfa	39	libEGL.so.1
8c7df980 UH	40	# Part of the video driver (OpenGL); present on any regular
	41	# desktop system, may also be provided by proprietary drivers.
	42	# Known to cause issues if it's bundled.
63fc42fe UH	43
	44	libdrm.so.2
	45	# Workaround for:
	46	# Antergos Linux release 2015.11 (ISO-Rolling)
	47	# /usr/lib/libdrm_amdgpu.so.1: error: symbol lookup error: undefined symbol: drmGetNodeTypeFromFd (fatal)
	48	# libGL error: unable to load driver: swrast_dri.so
	49	# libGL error: failed to load driver: swrast
	50	# Unrecognized OpenGL version
	51
ca369dfa UH	52	libglapi.so.0
	53	# Part of mesa
	54	# known to cause problems with graphics, see https://github.com/RPCS3/rpcs3/issues/4427#issuecomment-381674910
	55
63fc42fe UH	56	libxcb.so.1
	57	# Workaround for:
	58	# Fedora 23
	59	# symbol lookup error: /lib64/libxcb-dri3.so.0: undefined symbol: xcb_send_fd
	60	# Uncertain if this is required to be bundled for some distributions - if so we need to write a version check script and use LD_PRELOAD to load the system version if it is newer
8c7df980 UH	61	# Fedora 25:
8c7df980 UH	62	# undefined symbol: xcb_send_request_with_fds
ca369dfa	63	# https://github.com/AppImage/AppImages/issues/128
63fc42fe UH	64
	65	libX11.so.6
	66	# Workaround for:
	67	# Fedora 23
	68	# symbol lookup error: ./lib/libX11.so.6: undefined symbol: xcb_wait_for_reply64
	69	# Uncertain if this is required to be bundled for some distributions - if so we need to write a version check script and use LD_PRELOAD to load the system version if it is newer
	70
	71	libgio-2.0.so.0
	72	# Workaround for:
	73	# On Ubuntu, "symbol lookup error: /usr/lib/x86_64-linux-gnu/gtk-2.0/modules/liboverlay-scrollbar.so: undefined symbol: g_settings_new"
	74
8c7df980 UH	75	# libgdk-x11-2.0.so.0 # Missing on openSUSE-Tumbleweed-KDE-Live-x86_64-Snapshot20170601-Media.iso
8c7df980 UH	76	# libgtk-x11-2.0.so.0 # Missing on openSUSE-Tumbleweed-KDE-Live-x86_64-Snapshot20170601-Media.iso
63fc42fe UH	77
	78	libasound.so.2
	79	# Workaround for:
	80	# No sound, e.g., in VLC.AppImage (does not find sound cards)
	81
	82	libgdk_pixbuf-2.0.so.0
	83	# Workaround for:
	84	# On Ubuntu, get (inkscape:25621): GdkPixbuf-WARNING **: Error loading XPM image loader: Image type 'xpm' is not supported
	85
	86	libfontconfig.so.1
	87	# Workaround for:
	88	# Application stalls when loading fonts during application launch; e.g., KiCad on ubuntu-mate
	89
ca369dfa UH	90	libthai.so.0
	91	# Workaround for:
	92	# audacity: /tmp/.mount_AudaciUsFbON/usr/lib/libthai.so.0: version `LIBTHAI_0.1.25' not found (required by /usr/lib64/libpango-1.0.so.0)
	93	# on openSUSE Tumbleweed
	94
	95	# other "low-level" font rendering libraries
	96	# should fix https://github.com/probonopd/linuxdeployqt/issues/261#issuecomment-377522251
	97	# and https://github.com/probonopd/linuxdeployqt/issues/157#issuecomment-320755694
	98	libfreetype.so.6
	99	libharfbuzz.so.0
	100
	101	# Note, after discussion we do not exlude this, but we can use a dummy library that just does nothing
	102	# libselinux.so.1
63fc42fe UH	103	# Workaround for:
63fc42fe UH	104	# sed: error while loading shared libraries: libpcre.so.3: cannot open shared object file: No such file or directory
ca369dfa UH	105	# Some distributions, such as Arch Linux, do not come with libselinux.so.1 by default.
	106	# The solution is to bundle a dummy mock library:
	107	# echo "extern int is_selinux_enabled(void){return 0;}" >> selinux-mock.c
	108	# gcc -s -shared -o libselinux.so.1 -Wl,-soname,libselinux.so.1 selinux-mock.c
	109	# strip libselinux.so.1
	110	# More information: https://github.com/AppImage/AppImages/issues/83
63fc42fe UH	111
	112	# The following are assumed to be part of the base system
	113	# Removing these has worked e.g., for Krita. Feel free to report if
	114	# you think that some of these should go into AppImages and why.
	115	libcom_err.so.2
	116	libcrypt.so.1
	117	libexpat.so.1
	118	libgcc_s.so.1
	119	libglib-2.0.so.0
	120	libgpg-error.so.0
8c7df980	121	# libgssapi_krb5.so.2 # Disputed, seemingly needed by Arch Linux since Kerberos is named differently there
63fc42fe	122	# libgssapi.so.3 # Seemingly needed when running Ubuntu 14.04 binaries on Fedora 23
8c7df980	123	# libhcrypto.so.4 # Missing on openSUSE LEAP 42.0
63fc42fe UH	124	# libheimbase.so.1 # Seemingly needed when running Ubuntu 14.04 binaries on Fedora 23
63fc42fe UH	125	# libheimntlm.so.0 # Seemingly needed when running Ubuntu 14.04 binaries on Fedora 23
8c7df980	126	# libhx509.so.5 # Missing on openSUSE LEAP 42.0
63fc42fe	127	libICE.so.6
ca369dfa UH	128	# libidn.so.11 # Does not come with Solus by default
ca369dfa UH	129	# libk5crypto.so.3 # Runnning AppImage built on Debian 9 or Ubuntu 16.04 on an Archlinux fails otherwise; https://github.com/AppImage/AppImages/issues/301
63fc42fe	130	libkeyutils.so.1
8c7df980 UH	131	# libkrb5.so.26 # Disputed, seemingly needed by Arch Linux since Kerberos is named differently there. Missing on openSUSE LEAP 42.0
	132	# libkrb5.so.3 # Disputed, seemingly needed by Arch Linux since Kerberos is named differently there
	133	# libkrb5support.so.0 # Disputed, seemingly needed by Arch Linux since Kerberos is named differently there
63fc42fe	134	libp11-kit.so.0
8c7df980 UH	135	# libpcre.so.3 # Missing on Fedora 24, SLED 12 SP1, and openSUSE Leap 42.2
8c7df980 UH	136	# libroken.so.18 # Mission on openSUSE LEAP 42.0
63fc42fe UH	137	# libsasl2.so.2 # Seemingly needed when running Ubuntu 14.04 binaries on Fedora 23
	138	libSM.so.6
	139	libusb-1.0.so.0
	140	libuuid.so.1
8c7df980	141	# libwind.so.0 # Missing on openSUSE LEAP 42.0
63fc42fe UH	142	libz.so.1
63fc42fe UH	143
63fc42fe UH	144	# Potentially dangerous libraries
	145	libgobject-2.0.so.0
	146
8c7df980 UH	147	# Workaround for:
8c7df980 UH	148	# Rectangles instead of fonts
ca369dfa	149	# https://github.com/AppImage/AppImages/issues/240
8c7df980 UH	150	libpangoft2-1.0.so.0
	151	libpangocairo-1.0.so.0
	152	libpango-1.0.so.0
	153
63fc42fe UH	154	# Workaround for:
	155	# e.g., Spotify
	156	# relocation error: /lib/x86_64-linux-gnu/libgcrypt.so.20:
	157	# symbol gpgrt_lock_lock, version GPG_ERROR_1.0 not defined
	158	# in file libgpg-error.so.0 with link time reference
	159	libgpg-error.so.0
	160
ca369dfa UH	161	libjack.so.0
	162	# it must match the ABI of the JACK server which is installed in the base system
	163	# rncbc confirmed this
	164
63fc42fe UH	165	# Unsolved issue:
	166	# https://github.com/probonopd/linuxdeployqt/issues/35
	167	# Error initializing NSS with a persistent database (sql:/home/me/.pki/nssdb): libsoftokn3.so: cannot open shared object file: No such file or directory
	168	# Error initializing NSS without a persistent database: NSS error code: -5925
	169	# nss_error=-5925, os_error=0
	170	# libnss3.so should not be removed from the bundles, as this causes other issues, e.g.,
	171	# https://github.com/probonopd/linuxdeployqt/issues/35#issuecomment-256213517
ca369dfa	172	# and https://github.com/AppImage/AppImages/pull/114
63fc42fe UH	173	# libnss3.so
63fc42fe UH	174
63fc42fe	175	# The following cannot be excluded, see
ca369dfa	176	# https://github.com/AppImage/AppImages/commit/6c7473d8cdaaa2572248dcc53d7f617a577ade6b
63fc42fe UH	177	# http://stackoverflow.com/questions/32644157/forcing-a-binary-to-use-a-specific-newer-version-of-a-shared-library-so
	178	# libssl.so.1
	179	# libssl.so.1.0.0
	180	# libcrypto.so.1
	181	# libcrypto.so.1.0.0
ca369dfa UH	182
	183	# The following may be spefific to a particular GPU and may need to be excluded
	184	# according to https://github.com/RicardoEPRodrigues/3Engine/issues/4#issuecomment-402532194
	185	# libGLEW.so.2.0 # to be confirmed
	186	# libglut.so.3 # to be confirmed