/* ************************************************************************ * Copyright (C) 2018-2025 Advanced Micro Devices, Inc. All rights reserved. * * Permission is hereby granted, free of charge, to any person obtaining a copy * of this software and associated documentation files (the "Software"), to deal * in the Software without restriction, including without limitation the rights * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell cop- * ies of the Software, and to permit persons to whom the Software is furnished * to do so, subject to the following conditions: * * The above copyright notice and this permission notice shall be included in all * copies or substantial portions of the Software. * * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IM- * PLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS * FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR * COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNE- * CTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. * * ************************************************************************ */ #pragma once #include "testing_common.hpp" template void testing_trmm_bad_arg(const Arguments& arg) { auto rocblas_trmm_fn = arg.api & c_API_FORTRAN ? rocblas_trmm : rocblas_trmm; auto rocblas_trmm_fn_64 = arg.api & c_API_FORTRAN ? rocblas_trmm_64 : rocblas_trmm_64; // trmm has both inplace and outofplace versions. // inplace == true for inplace, inplace == false for outofplace bool inplace = !arg.outofplace; for(auto pointer_mode : {rocblas_pointer_mode_host, rocblas_pointer_mode_device}) { rocblas_local_handle handle{arg}; CHECK_ROCBLAS_ERROR(rocblas_set_pointer_mode(handle, pointer_mode)); const int64_t M = 100; const int64_t N = 100; const int64_t lda = 100; const int64_t ldb = 100; const int64_t ldc = 100; const int64_t ldOut = inplace ? ldb : ldc; DEVICE_MEMCHECK(device_vector, alpha_d, (1)); DEVICE_MEMCHECK(device_vector, zero_d, (1)); const T alpha_h(1), zero_h(0); const T* alpha = &alpha_h; const T* zero = &zero_h; if(pointer_mode == rocblas_pointer_mode_device) { CHECK_HIP_ERROR(hipMemcpy(alpha_d, alpha, sizeof(*alpha), hipMemcpyHostToDevice)); alpha = alpha_d; CHECK_HIP_ERROR(hipMemcpy(zero_d, zero, sizeof(*zero), hipMemcpyHostToDevice)); zero = zero_d; } const rocblas_side side = rocblas_side_left; const rocblas_fill uplo = rocblas_fill_upper; const rocblas_operation transA = rocblas_operation_none; const rocblas_diagonal diag = rocblas_diagonal_non_unit; int64_t K = side == rocblas_side_left ? M : N; // Allocate device memory DEVICE_MEMCHECK(device_matrix, dA, (K, K, lda)); DEVICE_MEMCHECK(device_matrix, dB, (M, N, ldb)); int64_t dC_M = inplace ? 1 : M; int64_t dC_N = inplace ? 1 : N; int64_t dC_ldc = inplace ? 1 : ldc; DEVICE_MEMCHECK(device_matrix, dC, (dC_M, dC_N, dC_ldc)); device_matrix* dOut = inplace ? &dB : &dC; // check for invalid enum DAPI_EXPECT(rocblas_status_invalid_value, rocblas_trmm_fn, (handle, rocblas_side_both, uplo, transA, diag, M, N, alpha, dA, lda, dB, ldb, *dOut, ldOut)); DAPI_EXPECT(rocblas_status_invalid_value, rocblas_trmm_fn, (handle, side, (rocblas_fill)rocblas_side_both, transA, diag, M, N, alpha, dA, lda, dB, ldb, *dOut, ldOut)); DAPI_EXPECT(rocblas_status_invalid_value, rocblas_trmm_fn, (handle, side, uplo, (rocblas_operation)rocblas_side_both, diag, M, N, alpha, dA, lda, dB, ldb, *dOut, ldOut)); DAPI_EXPECT(rocblas_status_invalid_value, rocblas_trmm_fn, (handle, side, uplo, transA, (rocblas_diagonal)rocblas_side_both, M, N, alpha, dA, lda, dB, ldb, *dOut, ldOut)); // check for invalid size DAPI_EXPECT( rocblas_status_invalid_size, rocblas_trmm_fn, (handle, side, uplo, transA, diag, -1, N, alpha, dA, lda, dB, ldb, *dOut, ldOut)); DAPI_EXPECT( rocblas_status_invalid_size, rocblas_trmm_fn, (handle, side, uplo, transA, diag, M, -1, alpha, dA, lda, dB, ldb, *dOut, ldOut)); // check for invalid leading dimension DAPI_EXPECT( rocblas_status_invalid_size, rocblas_trmm_fn, (handle, side, uplo, transA, diag, M, N, alpha, dA, lda, dB, M - 1, *dOut, ldOut)); DAPI_EXPECT( rocblas_status_invalid_size, rocblas_trmm_fn, (handle, side, uplo, transA, diag, M, N, alpha, dA, lda, dB, ldb, *dOut, M - 1)); DAPI_EXPECT(rocblas_status_invalid_size, rocblas_trmm_fn, (handle, rocblas_side_left, uplo, transA, diag, M, N, alpha, dA, M - 1, dB, ldb, *dOut, ldOut)); DAPI_EXPECT(rocblas_status_invalid_size, rocblas_trmm_fn, (handle, rocblas_side_right, uplo, transA, diag, M, N, alpha, dA, N - 1, dB, ldb, *dOut, ldOut)); // check that nullpointer gives rocblas_status_invalid_handle or rocblas_status_invalid_pointer DAPI_EXPECT( rocblas_status_invalid_handle, rocblas_trmm_fn, (nullptr, side, uplo, transA, diag, M, N, alpha, dA, lda, dB, ldb, *dOut, ldOut)); DAPI_EXPECT( rocblas_status_invalid_pointer, rocblas_trmm_fn, (handle, side, uplo, transA, diag, M, N, nullptr, dA, lda, dB, ldb, *dOut, ldOut)); DAPI_EXPECT( rocblas_status_invalid_pointer, rocblas_trmm_fn, (handle, side, uplo, transA, diag, M, N, alpha, nullptr, lda, dB, ldb, *dOut, ldOut)); DAPI_EXPECT( rocblas_status_invalid_pointer, rocblas_trmm_fn, (handle, side, uplo, transA, diag, M, N, alpha, dA, lda, nullptr, ldb, *dOut, ldOut)); DAPI_EXPECT( rocblas_status_invalid_pointer, rocblas_trmm_fn, (handle, side, uplo, transA, diag, M, N, alpha, dA, lda, dB, ldb, nullptr, ldOut)); // quick return: If alpha==0, then A and B can be nullptr without error DAPI_CHECK(rocblas_trmm_fn, (handle, side, uplo, transA, diag, M, N, zero, nullptr, lda, nullptr, ldb, *dOut, ldOut)); // quick return: If M==0, then all pointers can be nullptr without error DAPI_CHECK(rocblas_trmm_fn, (handle, side, uplo, transA, diag, 0, N, nullptr, nullptr, lda, nullptr, ldb, nullptr, ldOut)); // quick return: If N==0, then all pointers can be nullptr without error DAPI_CHECK(rocblas_trmm_fn, (handle, side, uplo, transA, diag, M, 0, nullptr, nullptr, lda, nullptr, ldb, nullptr, ldOut)); // in-place only checks if(inplace) { // if inplace, must have ldb == ldc DAPI_EXPECT( rocblas_status_invalid_value, rocblas_trmm_fn, (handle, side, uplo, transA, diag, M, N, alpha, dA, lda, dB, ldb, dB, ldb + 1)); } } } template void testing_trmm(const Arguments& arg) { auto rocblas_trmm_fn = arg.api & c_API_FORTRAN ? rocblas_trmm : rocblas_trmm; auto rocblas_trmm_fn_64 = arg.api & c_API_FORTRAN ? rocblas_trmm_64 : rocblas_trmm_64; // trmm has both inplace and outofplace versions. // inplace == true for inplace, inplace == false for outofplace bool inplace = !arg.outofplace; int64_t M = arg.M; int64_t N = arg.N; int64_t lda = arg.lda; int64_t ldb = arg.ldb; int64_t ldc = arg.ldc; int64_t ldOut = inplace ? ldb : ldc; char char_side = arg.side; char char_uplo = arg.uplo; char char_transA = arg.transA; char char_diag = arg.diag; T h_alpha_T = arg.get_alpha(); rocblas_side side = char2rocblas_side(char_side); rocblas_fill uplo = char2rocblas_fill(char_uplo); rocblas_operation transA = char2rocblas_operation(char_transA); rocblas_diagonal diag = char2rocblas_diagonal(char_diag); int64_t K = side == rocblas_side_left ? M : N; rocblas_local_handle handle{arg}; // ensure invalid sizes and quick return checked before pointer check bool invalid_size = M < 0 || N < 0 || lda < K || ldb < M || ldc < M; if(M == 0 || N == 0 || invalid_size) { DAPI_EXPECT(invalid_size ? rocblas_status_invalid_size : rocblas_status_success, rocblas_trmm_fn, (handle, side, uplo, transA, diag, M, N, nullptr, nullptr, lda, nullptr, ldb, nullptr, ldc)); return; } // Naming: `h` is in CPU (host) memory(eg hA), `d` is in GPU (device) memory (eg dA). // Allocate host memory HOST_MEMCHECK(host_matrix, hA, (K, K, lda)); HOST_MEMCHECK(host_matrix, hB, (M, N, ldb)); HOST_MEMCHECK(host_matrix, hC, (M, N, ldc)); HOST_MEMCHECK(host_matrix, hC_gold, (M, N, ldc)); // Allocate device memory DEVICE_MEMCHECK(device_matrix, dA, (K, K, lda)); DEVICE_MEMCHECK(device_matrix, dB, (M, N, ldb)); DEVICE_MEMCHECK(device_vector, alpha_d, (1)); // Initialize data on host memory rocblas_init_matrix( hA, arg, rocblas_client_alpha_sets_nan, rocblas_client_triangular_matrix, true); rocblas_init_matrix( hB, arg, rocblas_client_alpha_sets_nan, rocblas_client_general_matrix, false, true); rocblas_init_matrix(hC, arg, rocblas_client_alpha_sets_nan, rocblas_client_general_matrix); // copy data from CPU to device CHECK_HIP_ERROR(dA.transfer_from(hA)); CHECK_HIP_ERROR(dB.transfer_from(hB)); // inplace trmm is given by B <- alpha * op(A) * B so matrix C is not used // outofplace trmm is given by C <- alpha * op(A) * B and matrix C is used int64_t dC_M = inplace ? 1 : M; int64_t dC_N = inplace ? 1 : N; int64_t dC_ldc = inplace ? 1 : ldc; DEVICE_MEMCHECK(device_matrix, dC, (dC_M, dC_N, dC_ldc)); device_matrix* dOut = inplace ? &dB : &dC; if(inplace) { if(ldb != ldc) { DAPI_EXPECT( rocblas_status_invalid_value, rocblas_trmm_fn, (handle, side, uplo, transA, diag, M, N, &h_alpha_T, dA, lda, dB, ldb, *dOut, ldc)); return; } hC_gold = hB; } else { CHECK_HIP_ERROR(dC.transfer_from(hC)); hC_gold = hC; } double gpu_time_used, cpu_time_used; gpu_time_used = cpu_time_used = 0.0; double err_host = 0.0, err_device = 0.0; if(arg.unit_check || arg.norm_check) { if(arg.pointer_mode_host) { CHECK_ROCBLAS_ERROR(rocblas_set_pointer_mode(handle, rocblas_pointer_mode_host)); handle.pre_test(arg); DAPI_CHECK(rocblas_trmm_fn, (handle, side, uplo, transA, diag, M, N, &h_alpha_T, dA, lda, dB, ldb, *dOut, ldOut)); handle.post_test(arg); CHECK_HIP_ERROR(hC.transfer_from(*dOut)); } if(arg.pointer_mode_device) { CHECK_HIP_ERROR((*dOut).transfer_from(hC_gold)); CHECK_ROCBLAS_ERROR(rocblas_set_pointer_mode(handle, rocblas_pointer_mode_device)); CHECK_HIP_ERROR(hipMemcpy(alpha_d, &h_alpha_T, sizeof(T), hipMemcpyHostToDevice)); DAPI_CHECK( rocblas_trmm_fn, (handle, side, uplo, transA, diag, M, N, alpha_d, dA, lda, dB, ldb, *dOut, ldOut)); if(arg.repeatability_check) { HOST_MEMCHECK(host_matrix, hC_copy, (M, N, ldc)); CHECK_HIP_ERROR(hC.transfer_from(*dOut)); // multi-GPU support int device_id, device_count; CHECK_HIP_ERROR(limit_device_count(device_count, (int)arg.devices)); for(int dev_id = 0; dev_id < device_count; dev_id++) { CHECK_HIP_ERROR(hipGetDevice(&device_id)); if(device_id != dev_id) CHECK_HIP_ERROR(hipSetDevice(dev_id)); //New rocblas handle for new device rocblas_local_handle handle_copy{arg}; //Allocate device memory in new device DEVICE_MEMCHECK(device_matrix, dA_copy, (K, K, lda)); DEVICE_MEMCHECK(device_matrix, dB_copy, (M, N, ldb)); DEVICE_MEMCHECK(device_matrix, dC_copy, (dC_M, dC_N, dC_ldc)); DEVICE_MEMCHECK(device_vector, d_alpha_copy, (1)); // copy data from CPU to device CHECK_HIP_ERROR(dA_copy.transfer_from(hA)); CHECK_HIP_ERROR(dB_copy.transfer_from(hB)); CHECK_HIP_ERROR( hipMemcpy(d_alpha_copy, &h_alpha_T, sizeof(T), hipMemcpyHostToDevice)); device_matrix* dOut_copy = inplace ? &dB_copy : &dC_copy; CHECK_ROCBLAS_ERROR( rocblas_set_pointer_mode(handle_copy, rocblas_pointer_mode_device)); for(int runs = 0; runs < arg.iters; runs++) { CHECK_HIP_ERROR((*dOut_copy).transfer_from(hC_gold)); DAPI_CHECK(rocblas_trmm_fn, (handle_copy, side, uplo, transA, diag, M, N, d_alpha_copy, dA_copy, lda, dB_copy, ldb, *dOut_copy, ldOut)); CHECK_HIP_ERROR(hC_copy.transfer_from(*dOut_copy)); unit_check_general(M, N, ldc, hC, hC_copy); } } return; } } // CPU BLAS cpu_time_used = get_time_us_no_sync(); ref_trmm(side, uplo, transA, diag, M, N, h_alpha_T, hA, lda, hB, ldb); cpu_time_used = get_time_us_no_sync() - cpu_time_used; // copy B matrix into C matrix copy_matrix_with_different_leading_dimensions(hB, hC_gold); if(arg.pointer_mode_host) { if(arg.unit_check) { if(std::is_same_v && K > 10000) { // For large K, rocblas_half tends to diverge proportional to K // Tolerance is slightly greater than 1 / 1024.0 const double tol = K * sum_error_tolerance; near_check_general(M, N, ldc, hC_gold, hC, tol); } else { unit_check_general(M, N, ldc, hC_gold, hC); } } if(arg.norm_check) { err_host = std::abs(norm_check_general('F', M, N, ldc, hC_gold, hC)); } } if(arg.pointer_mode_device) { CHECK_HIP_ERROR(hC.transfer_from(*dOut)); if(arg.unit_check) { if(std::is_same_v && K > 10000) { // For large K, rocblas_half tends to diverge proportional to K // Tolerance is slightly greater than 1 / 1024.0 const double tol = K * sum_error_tolerance; near_check_general(M, N, ldc, hC_gold, hC, tol); } else { unit_check_general(M, N, ldc, hC_gold, hC); } } if(arg.norm_check) { err_device = std::abs(norm_check_general('F', M, N, ldc, hC_gold, hC)); } } } if(arg.timing) { int number_cold_calls = arg.cold_iters; int total_calls = number_cold_calls + arg.iters; CHECK_ROCBLAS_ERROR(rocblas_set_pointer_mode(handle, rocblas_pointer_mode_host)); hipStream_t stream; CHECK_ROCBLAS_ERROR(rocblas_get_stream(handle, &stream)); for(int i = 0; i < total_calls; i++) { if(i == number_cold_calls) gpu_time_used = get_time_us_sync(stream); DAPI_DISPATCH(rocblas_trmm_fn, (handle, side, uplo, transA, diag, M, N, &h_alpha_T, dA, lda, dB, ldb, *dOut, ldOut)); } gpu_time_used = get_time_us_sync(stream) - gpu_time_used; ArgumentModel{} .log_args(rocblas_cout, arg, gpu_time_used, trmm_gflop_count(M, N, side), ArgumentLogging::NA_value, cpu_time_used, err_host, err_device); } }