mirror of
https://github.com/robbert-vdh/yabridge.git
synced 2026-05-06 19:40:10 +02:00
Robbert van der Helm
47 lines
2.1 KiB
C++
47 lines
2.1 KiB
C++
// yabridge: a Wine plugin bridge
|
|
// Copyright (C) 2020-2026 Robbert van der Helm
|
|
//
|
|
// This program is free software: you can redistribute it and/or modify
|
|
// it under the terms of the GNU General Public License as published by
|
|
// the Free Software Foundation, either version 3 of the License, or
|
|
// (at your option) any later version.
|
|
//
|
|
// This program is distributed in the hope that it will be useful,
|
|
// but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
|
// GNU General Public License for more details.
|
|
//
|
|
// You should have received a copy of the GNU General Public License
|
|
// along with this program. If not, see <https://www.gnu.org/licenses/>.
|
|
|
|
#pragma once
|
|
|
|
#include <string>
|
|
|
|
/**
|
|
* Finds the matching `libyabridge-*.so` for this chainloader. Returns the
|
|
* handle if it is found. Otherwise, we'll log an error and show a desktop
|
|
* notification, and this function returns a null pointer. The pointer may be
|
|
* `dlclose()`'d when it's no longer needed. This search works in the following
|
|
* order:
|
|
*
|
|
* - First we'll try to locate `yabridge-host.exe` using the same method used by
|
|
* the yabridge plugin bridges themselves. We'll search in `$PATH`, followed
|
|
* by `${XDG_DATA_HOME:-$HOME/.local/share}/yabridge`. If that file exists and
|
|
* the target plugin library exists right next to it, then we'll use that.
|
|
* - For compatibility with 32-bit only builds of yabridge, we'll repeat this
|
|
* process for `yabridge-host-32.exe`.
|
|
* - When those don't exist, we'll try to `dlopen()` the file directly. This
|
|
* will use the correct path for the system.
|
|
* - If we still can't find the file, we'll do one last scan through common lib
|
|
* directories in case `ldconfig` was not set up correctly.
|
|
*/
|
|
void* find_plugin_library(const std::string& name);
|
|
|
|
/**
|
|
* Log a message when a `dlsym()` call fails and show a corresponding desktop
|
|
* notification. Used as part of the `LOAD_FUNCTION` macros.
|
|
*/
|
|
void log_failing_dlsym(const std::string& library_name,
|
|
const char* function_name);
|