/* * Copyright (c) 2021 Huawei Device Co., Ltd. * 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 "securecutil.h" /******************************************************************************* * * The vsnprintf_s function is equivalent to the vsnprintf function * except for the parameter destMax/count and the explicit runtime-constraints violation * The vsnprintf_s function takes a pointer to an argument list, then formats * and writes up to count characters of the given data to the memory pointed * to by strDest and appends a terminating null. * * * strDest Storage location for the output. * destMax The size of the strDest for output. * count Maximum number of character to write(not including * the terminating NULL) * format Format-control string. * arglist pointer to list of arguments. * * * strDest is updated * * * return the number of characters written, not including the terminating null * return -1 if an error occurs. * return -1 if count < destMax and the output string has been truncated * * If there is a runtime-constraint violation, strDest[0] will be set to the '\0' when strDest and destMax valid ******************************************************************************* */ #ifndef __MINGW32__ int vsnprintf_s(char *strDest, size_t destMax, size_t count, const char *format, va_list arglist) { int retVal; if (format == NULL || strDest == NULL || destMax == 0 || destMax > SECUREC_STRING_MAX_LEN || (count > (SECUREC_STRING_MAX_LEN - 1) && count != (size_t)-1)) { if (strDest != NULL && destMax > 0) { strDest[0] = '\0'; } SECUREC_ERROR_INVALID_PARAMTER("vsnprintf_s"); return -1; } if (destMax > count) { retVal = SecVsnprintfImpl(strDest, count + 1, format, arglist); if (retVal == SECUREC_PRINTF_TRUNCATE) { /* lsd add to keep dest buffer not destroyed 2014.2.18 */ /* the string has been truncated, return -1 */ return -1; /* to skip error handler, return strlen(strDest) or -1 */ } } else { /* destMax <= count */ retVal = SecVsnprintfImpl(strDest, destMax, format, arglist); #ifdef SECUREC_COMPATIBLE_WIN_FORMAT if (retVal == SECUREC_PRINTF_TRUNCATE && count == (size_t)-1) { return -1; } #endif } if (retVal < 0) { strDest[0] = '\0'; /* empty the dest strDest */ if (retVal == SECUREC_PRINTF_TRUNCATE) { /* Buffer too small */ SECUREC_ERROR_INVALID_RANGE("vsnprintf_s"); } SECUREC_ERROR_INVALID_PARAMTER("vsnprintf_s"); return -1; } return retVal; } #endif #if defined(__MINGW32__) || defined(SECUREC_SNPRINTF_TRUNCATED) int vsnprintf_truncated_s(char *strDest, size_t destMax, const char *format, va_list arglist) { int retVal; if (format == NULL || strDest == NULL || destMax == 0 || destMax > SECUREC_STRING_MAX_LEN) { if (strDest != NULL && destMax > 0) { strDest[0] = '\0'; } SECUREC_ERROR_INVALID_PARAMTER("vsnprintf_ex_s"); return -1; } retVal = SecVsnprintfImpl(strDest, destMax, format, arglist); if (retVal < 0) { if (retVal == SECUREC_PRINTF_TRUNCATE) { return (int)(destMax - 1); /* to skip error handler, return strlen(strDest) */ } strDest[0] = '\0'; /* empty the dest strDest */ SECUREC_ERROR_INVALID_PARAMTER("vsnprintf_ex_s"); return -1; } return retVal; } #endif