diff --git a/include/freerdp/utils/helpers.h b/include/freerdp/utils/helpers.h new file mode 100644 index 000000000..c0c3d1898 --- /dev/null +++ b/include/freerdp/utils/helpers.h @@ -0,0 +1,39 @@ +/** + * FreeRDP: A Remote Desktop Protocol Implementation + * common helper utilities + * + * Copyright 2024 Armin Novak + * Copyright 2024 Thincast Technologies GmbH + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#pragma once + +#include +#include + +/** @brief Return the absolute path of a configuration file (the path of the configuration + * directory if \b filename is \b NULL) + * + * @param system a boolean indicating the configuration base, \b TRUE for system configuration, + * \b FALSE for user configuration + * @param filename an optional configuration file name to append. + * + * @return The absolute path of the desired configuration or \b NULL in case of failure. Use \b + * free to clean up the allocated string. + * + * + * @since version 3.9.0 + */ +FREERDP_API char* freerdp_GetConfigFilePath(BOOL system, const char* filename); diff --git a/libfreerdp/utils/CMakeLists.txt b/libfreerdp/utils/CMakeLists.txt index 2102501ae..ddb1b94ee 100644 --- a/libfreerdp/utils/CMakeLists.txt +++ b/libfreerdp/utils/CMakeLists.txt @@ -20,6 +20,7 @@ set(MODULE_PREFIX "FREERDP_UTILS") set(${MODULE_PREFIX}_SRCS encoded_types.c + helpers.c passphrase.c cliprdr_utils.c rdpdr_utils.c diff --git a/libfreerdp/utils/helpers.c b/libfreerdp/utils/helpers.c new file mode 100644 index 000000000..34bfde71d --- /dev/null +++ b/libfreerdp/utils/helpers.c @@ -0,0 +1,46 @@ +/** + * FreeRDP: A Remote Desktop Protocol Implementation + * common helper utilities + * + * Copyright 2024 Armin Novak + * Copyright 2024 Thincast Technologies GmbH + * + * Licensed under the Apache License, Version 2.0 (the "License"); + * you may not use this file except in compliance with the License. + * You may obtain a copy of the License at + * + * http://www.apache.org/licenses/LICENSE-2.0 + * + * Unless required by applicable law or agreed to in writing, software + * distributed under the License is distributed on an "AS IS" BASIS, + * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. + * See the License for the specific language governing permissions and + * limitations under the License. + */ + +#include + +#include +#include + +char* freerdp_GetConfigFilePath(BOOL system, const char* filename) +{ + eKnownPathTypes id = system ? KNOWN_PATH_SYSTEM_CONFIG_HOME : KNOWN_PATH_XDG_CONFIG_HOME; + + char* vendor = GetKnownSubPath(id, FREERDP_VENDOR_STRING); + if (!vendor) + return NULL; + + char* base = GetCombinedPath(vendor, FREERDP_PRODUCT_STRING); + free(vendor); + + if (!base) + return NULL; + + if (!filename) + return base; + + char* path = GetCombinedPath(base, filename); + free(base); + return path; +}