omrslTest.cpp

/*******************************************************************************
 * Copyright (c) 1991, 2021 IBM Corp. and others
 *
 * This program and the accompanying materials are made available under
 * the terms of the Eclipse Public License 2.0 which accompanies this
 * distribution and is available at http://eclipse.org/legal/epl-2.0
 * or the Apache License, Version 2.0 which accompanies this distribution
 * and is available at https://www.apache.org/licenses/LICENSE-2.0.
 *
 * This Source Code may also be made available under the following Secondary
 * Licenses when the conditions for such availability set forth in the
 * Eclipse Public License, v. 2.0 are satisfied: GNU General Public License,
 * version 2 with the GNU Classpath Exception [1] and GNU General Public
 * License, version 2 with the OpenJDK Assembly Exception [2].
 *
 * [1] https://www.gnu.org/software/classpath/license.html
 * [2] http://openjdk.java.net/legal/assembly-exception.html
 *
 * SPDX-License-Identifier: EPL-2.0 OR Apache-2.0 OR GPL-2.0 WITH Classpath-exception-2.0 OR LicenseRef-GPL-2.0 WITH Assembly-exception
 *******************************************************************************/

/**
 * @file
 * @ingroup PortTest
 * @brief Verify port library file system.
 *
 * Exercise the API for port library shared library system operations.  These functions
 * can be found in the file @ref omrsl.c
 */
#include <stdlib.h>
#include <stdio.h>
#include <string.h>
#include "omrport.h"


#include "testHelpers.hpp"
#include "testProcessHelpers.hpp"
#include "omrfileTest.h"

#if defined(J9ZOS39064)
/* We replicate the function pointer definitions from omrcel4ro31 here to avoid unnecessarily
 * having to expose omr_cel4ro31_is_supported() in omrport.h.  These are static defintions
 * not subject to change.
 */
#define CEEPCBFLAG6_VALUE *((char *)(*(long *)(((char *)__gtca())+912))+344)
#define CEEPCB_3164_MASK 0x4

#endif /* defined(J9ZOS39064) */

/**
 * Verify port library properly setup to run sl tests
 */
TEST(PortSlTest, sl_verify_function_slots)
{
	OMRPORT_ACCESS_FROM_OMRPORT(portTestEnv->getPortLibrary());
	const char *testName = "omrsl_verify_function_slots";

	reportTestEntry(OMRPORTLIB, testName);

	if (NULL == OMRPORTLIB->sl_close_shared_library) {
		outputErrorMessage(PORTTEST_ERROR_ARGS, "portLibrary->sl_close_shared_library is NULL\n");
	}

	if (NULL == OMRPORTLIB->sl_lookup_name) {
		outputErrorMessage(PORTTEST_ERROR_ARGS, "portLibrary->sl_lookup_name is NULL\n");
	}

	if (NULL == OMRPORTLIB->sl_open_shared_library) {
		outputErrorMessage(PORTTEST_ERROR_ARGS, "portLibrary->sl_open_shared_library is NULL\n");
	}

	if (NULL == OMRPORTLIB->sl_shutdown) {
		outputErrorMessage(PORTTEST_ERROR_ARGS, "portLibrary->sl_shutdown is NULL\n");
	}

	if (NULL == OMRPORTLIB->sl_startup) {
		outputErrorMessage(PORTTEST_ERROR_ARGS, "portLibrary->sl_startup is NULL\n");
	}

	reportTestExit(OMRPORTLIB, testName);

}


/**
 * Basic test: load the port Library dll.
 */
TEST(PortSlTest, sl_test1)
{
	OMRPORT_ACCESS_FROM_OMRPORT(portTestEnv->getPortLibrary());
	const char *testName = "omrsl_test1";
	uintptr_t handle;
	uintptr_t rc = 0;
	char sharedLibName[] = "sltestlib";

	reportTestEntry(OMRPORTLIB, testName);

	rc = omrsl_open_shared_library(sharedLibName, &handle, OMRPORT_SLOPEN_DECORATE);
	if (0 != rc) {
		outputErrorMessage(PORTTEST_ERROR_ARGS, "Unable to open %s, \n", sharedLibName, omrerror_last_error_message());
		goto exit;
	}

exit:

	reportTestExit(OMRPORTLIB, testName);
}

/**
 * For omrsl_open_shared_library, check if:
 * i)  OMRPORT_SL_UNSUPPORTED is received for a path larger than EsMaxPath chars
 * ii) OMRPORT_SL_INVALID or OMRPORT_SL_NOT_FOUND is received for an incorrect path less than or equal to EsMaxPath chars
 */
TEST(PortSlTest, sl_testOpenPathLengths)
{
	OMRPORT_ACCESS_FROM_OMRPORT(portTestEnv->getPortLibrary());
	const char *testName = "omrsl_testOpenPathLengths";
	uintptr_t handle = 0;
	uintptr_t rc = 0;
#if defined(OMR_OS_WINDOWS)
	const char *fakeName = "\\temp";
#else /* defined(OMR_OS_WINDOWS) */
	const char *fakeName = "/temp";
#endif /* defined(OMR_OS_WINDOWS) */
	size_t fakeNameLength = strlen(fakeName);
	char sharedLibName[2*EsMaxPath] = "temp";
	size_t pathLength = strlen(sharedLibName);

	/* Within omrsl_open_shared_library,
	 * zOS - "lib.so" is added to the input path
	 * Win - ".dll" is added to the input path
	 * Unix - "lib.so" is added to the input path
	 * AIX - "lib.so", "lib.a" and ".srvpgm" are added to the input path consecutively
	 */

#if defined(OMR_OS_WINDOWS)
	const char *extension = ".dll";
#elif defined(AIXPPC) /* defined(OMR_OS_WINDOWS) */
#if defined(J9OS_I5)
	const char *extension = ".srvpgm";
#else /* defined(J9OS_I5) */
	const char *extension = "lib.so";
#endif /* defined(J9OS_I5) */
#else /* defined(AIXPPC) */
#if defined(OSX)
	const char *extension = "lib.dylib";
#else /* defined(OSX) */
	const char *extension = "lib.so";
#endif /* defined(OSX) */
#endif /* defined(OMR_OS_WINDOWS) */

	size_t extensionLength = strlen(extension);

	reportTestEntry(OMRPORTLIB, testName);

	/* Loop to create a random file path that contains more than EsMaxPath + 1 chars */
	while (pathLength <= EsMaxPath) {
		strcat(sharedLibName, fakeName);
		pathLength += fakeNameLength;
	}

	/* Reducing path length to EsMaxPath - strlen(extension) chars that includes the NUL terminator */
	sharedLibName[EsMaxPath - extensionLength] = '\0';
	/* Avoid a path ending with a separator */
	sharedLibName[EsMaxPath - extensionLength - 1] = 'a';

	/* Check if OMRPORT_SL_UNSUPPORTED is received for a path of EsMaxPath - strlen(extension) chars that includes the NUL terminator */
	rc = omrsl_open_shared_library(sharedLibName, &handle, OMRPORT_SLOPEN_DECORATE);
	if (OMRPORT_SL_UNSUPPORTED != rc) {
		outputErrorMessage(PORTTEST_ERROR_ARGS, "Received error code %zu instead of error code %zu for shared library, \n%s,\n", rc, (uintptr_t)OMRPORT_SL_UNSUPPORTED, sharedLibName, omrerror_last_error_message());
		goto exit;
	}

	/* Reducing path length to EsMaxPath - strlen(extension) - 1 chars that includes the NUL terminator */
	sharedLibName[EsMaxPath - extensionLength - 1] = '\0';
	/* Avoid a path ending with a separator */
	sharedLibName[EsMaxPath - extensionLength - 2] = 'a';

	/* Check if OMRPORT_SL_INVALID or OMRPORT_SL_NOT_FOUND is received for an incorrect path of EsMaxPath - strlen(extension) - 1 chars that includes the NUL terminator */
	rc = omrsl_open_shared_library(sharedLibName, &handle, OMRPORT_SLOPEN_DECORATE);
	if ((OMRPORT_SL_INVALID != rc) && (OMRPORT_SL_NOT_FOUND != rc)) {
		outputErrorMessage(PORTTEST_ERROR_ARGS, "Received error code %zu instead of error code %zu or %zu for shared library, \n%s,\n", rc, (uintptr_t)OMRPORT_SL_INVALID, (uintptr_t)OMRPORT_SL_NOT_FOUND, sharedLibName, omrerror_last_error_message());
		goto exit;
	}

exit:
	reportTestExit(OMRPORTLIB, testName);
}

#if defined(AIXPPC)

/**
 * CMVC 197740
 * The exact message varies depending on the OS version. look for any of several possible strings.
 * @param dlerrorOutput actual dlerror() result
 * @param expectedOutputs list of possible strings, terminated by a null  pointer
 * @result true if one of expectedOutputs is found in dlerrorOutput
 */
static BOOLEAN
isValidLoadErrorMessage(const char *dlerrorOutput, const char *possibleMessageStrings[])
{
	BOOLEAN result = FALSE;
	uintptr_t candidate = 0;
	while (NULL != possibleMessageStrings[candidate]) {
		if (NULL != strstr(dlerrorOutput, possibleMessageStrings[candidate])) {
			result = TRUE;
			break;
		}
		++candidate;
	}
	return result;
}

/**
 * Loading dll with missing dependency on AIX, expecting a descriptive OS error message
 */
TEST(PortSlTest, sl_AixDLLMissingDependency)
{
	OMRPORT_ACCESS_FROM_OMRPORT(portTestEnv->getPortLibrary());
	const char *testName = "omrsl_AixDLLMissingDependency";
	uintptr_t handle;
	uintptr_t rc = 0;
	char *sharedLibName = "aixbaddep";
	const char *osErrMsg;
	const char *possibleMessageStrings[] = {"0509-150", "Dependent module dummy.exp could not be loaded", NULL};

	reportTestEntry(OMRPORTLIB, testName);

	rc = omrsl_open_shared_library(sharedLibName, &handle, OMRPORT_SLOPEN_DECORATE);
	if (0 == rc) {
		outputErrorMessage(PORTTEST_ERROR_ARGS, " Unexpectedly loaded %s, should have failed with dependency error\n", sharedLibName, omrerror_last_error_message());
		goto exit;
	}

	osErrMsg = omrerror_last_error_message();
	portTestEnv->log(LEVEL_ERROR, "System error message=\n\"%s\"\n", osErrMsg);
	if (!isValidLoadErrorMessage(osErrMsg, possibleMessageStrings)) {
		outputErrorMessage(PORTTEST_ERROR_ARGS, " Cannot find valid error code, should have failed with dependency error\n", sharedLibName, omrerror_last_error_message());
	}
exit:

	reportTestExit(OMRPORTLIB, testName);
}

/**
 * Loading dll of wrong platform on AIX, expecting a descriptive OS error message
 */
TEST(PortSlTest, sl_AixDLLWrongPlatform)
{
	OMRPORT_ACCESS_FROM_OMRPORT(portTestEnv->getPortLibrary());
	const char *testName = "omrsl_AixDLLWrongPlatform";
	uintptr_t handle;
	uintptr_t rc = 0;
	/* Intentionally load 64bit dll on 32 bit AIX, and 32bit dll on 64bit AIX */
#if defined(OMR_ENV_DATA64)
	char *sharedLibName = "/usr/lib/jpa";
#else
	char *sharedLibName = "/usr/lib/jpa64";
#endif
	const char *osErrMsg;
	const char *possibleMessageStrings[] = {"0509-103", "System error: Exec format error",
											"0509-026", "System error: Cannot run a file that does not have a valid format",
											NULL};

	reportTestEntry(OMRPORTLIB, testName);

	rc = omrsl_open_shared_library(sharedLibName, &handle, OMRPORT_SLOPEN_DECORATE);
	if (0 == rc) {
		outputErrorMessage(PORTTEST_ERROR_ARGS, "Unexpectedly loaded %s, should have failed with dependency error\n", sharedLibName, omrerror_last_error_message());
		goto exit;
	}

	osErrMsg = omrerror_last_error_message();
	portTestEnv->log(LEVEL_ERROR, "System error message=\n\"%s\"\n", osErrMsg);
	if (!isValidLoadErrorMessage(osErrMsg, possibleMessageStrings)) {
		outputErrorMessage(PORTTEST_ERROR_ARGS, "Cannot find valid error code, should have failed with wrong platform error\n", sharedLibName, omrerror_last_error_message());
	}
exit:

	reportTestExit(OMRPORTLIB, testName);
}
#endif /* defined(AIXPPC) */

#if defined(J9ZOS39064)
/**
 * Basic test: load the port Library 31-bit test dll via CEL4RO31 interface
 */
TEST(PortSlTest, sl_testOpen31bitDLLviaCEL4RO31)
{
	OMRPORT_ACCESS_FROM_OMRPORT(portTestEnv->getPortLibrary());
	const char *testName = "omrsl_testOpen31bitDLLviaCEL4RO31";
	uintptr_t dllHandle = 0;
	uintptr_t funcHandle = 0;
	uintptr_t rc = 0;
	char sharedLibName[] = "sltestlib31";
	char functionName[] = "sl_testOpen31bitDLLviaCEL4RO31_function";
	const char *functionArgs = "()V";

	reportTestEntry(OMRPORTLIB, testName);

	if (OMR_ARE_ANY_BITS_SET(CEEPCBFLAG6_VALUE, CEEPCB_3164_MASK)) {
		/* Only attempt the test if the underlying LE support is available. */
		rc = omrsl_open_shared_library(sharedLibName, &dllHandle, OMRPORT_SLOPEN_DECORATE | OMRPORT_SLOPEN_ATTEMPT_31BIT_OPEN);
		if (0 != rc) {
			outputErrorMessage(PORTTEST_ERROR_ARGS, "Unable to open %s, \n", sharedLibName, omrerror_last_error_message());
			goto exit;
		}
		rc = omrsl_lookup_name(dllHandle, functionName, &funcHandle, functionArgs);
		if (0 != rc) {
			outputErrorMessage(
				PORTTEST_ERROR_ARGS, "Unable to lookup function %s from library %s, \n",
				functionName, sharedLibName, omrerror_last_error_message());
			goto exit;
		}
	}

exit:
	reportTestExit(OMRPORTLIB, testName);
}
#endif /* defined(J9ZOS39064) */