Функции безопасности C

В языке C для повышения безопасности кода, особенно для предотвращения распространённых проблем безопасности, таких как переполнение буфера, стандарт C11 ввёл некоторыебезопасные функции, также известные какПриложение Kстандартные библиотечные функции. Эти безопасные функции в основном представляют собой улучшенные версии стандартных функций работы со строками и памятью, обеспечивая лучшую обработку и обнаружение ошибок путём добавления параметров (таких как размер буфера).

Особенности функций безопасности:

  • Проверка размера буфераВсе безопасные функции требуют передачи параметра размера целевого буфера для предотвращения переполнения буфера.
  • Проверка возвращаемого значения: Большинство функций возвращаютerrno_tКоды ошибок этого типа можно проверить, чтобы определить, успешно ли выполнилась функция.
  • Улучшенная обработка ошибок: Когда размера буфера недостаточно или возникают другие проблемы, эти функции возвращают код ошибки и пытаются очистить или инициализировать выходной буфер.

Безопасные функции хорошо поддерживаются в таких компиляторах, как Visual Studio, но могут быть недоступны в некоторых старых версиях компиляторов, поэтому следует обратить внимание на совместимость.

Ниже приведено сравнение распространённых безопасных функций в C и соответствующих им традиционных функций:

1. Безопасные функции для работы со строками

strcpy_s: Безопасная версия strcpy, копирует строку и проверяет размер целевого буфера.

errno_t strcpy_s(char *dest, rsize_t destsz, const char *src);

strcat_sБезопасная версия strcat, добавляет исходную строку в конец строки назначения и проверяет размер буфера.

errno_t strcat_s(char *dest, rsize_t destsz, const char *src);

strncpy_s: Безопасная версия strncpy, копирует до n символов и проверяет размер буфера.

errno_t strncpy_s(char *dest, rsize_t destsz, const char *src, rsize_t count);

strncat_sБезопасная версия strncat, добавляет не более n символов в конец строки назначения и проверяет размер буфера.

errno_t strncat_s(char *dest, rsize_t destsz, const char *src, rsize_t count);

strtok_sБезопасная версия strtok, вводит параметр контекста для решения проблем потокобезопасности.

char *strtok_s(char *str, const char *delim, char **context);

2. Безопасные функции форматированного вывода

sprintf_sБезопасная версия sprintf, проверяет размер буфера при форматировании вывода в строку.

int sprintf_s(char *buffer, rsize_t buffer_size, const char *format, ...);

snprintf_sБезопасная версия snprintf, ограничивает количество символов и проверяет размер буфера при форматированном выводе.

int snprintf_s(char *buffer, rsize_t buffer_size, const char *format, ...);

vsprintf_sБезопасная версия vsprintf, принимает список аргументов va_list и проверяет размер буфера.

int vsprintf_s(char *buffer, rsize_t buffer_size, const char *format, va_list argptr);

3. Безопасные функции для операций с памятью

memcpy_s: Безопасная версия memcpy, проверяет размер целевого буфера при копировании области памяти.

errno_t memcpy_s(void *dest, rsize_t destsz, const void *src, rsize_t count);

memmove_s: Безопасная версия memmove, копирует области памяти, допускает перекрытие и проверяет размер целевого буфера.

errno_t memmove_s(void *dest, rsize_t destsz, const void *src, rsize_t count);

memset_sБезопасная версия memset, заполняет блок памяти указанным символом и проверяет размер буфера.

errno_t memset_s(void *dest, rsize_t destsz, int ch, rsize_t count);

4. Другие распространённые безопасные функции

_itoa_sи_ultoa_sБезопасная версия функций преобразования целых чисел, проверяет размер буфера назначения при преобразовании целых чисел в строки.

errno_t _itoa_s(int value, char *buffer, size_t buffer_size, int radix);
errno_t _ultoa_s(unsigned long value, char *buffer, size_t buffer_size, int radix);

_strlwr_sи_strupr_sБезопасные версии, преобразующие строки в нижний или верхний регистр.

errno_t _strlwr_s(char *str, size_t numberOfElements);
errno_t _strupr_s(char *str, size_t numberOfElements);

Пример

Ниже приведены примеры использования безопасных функций C для строковых операций и операций с памятью, демонстрирующие, как они позволяют избежать распространённых проблем переполнения буфера и обеспечивают более безопасный подход к программированию.

Пример 1: strcpy_s и strcat_s

Пример

#include <stdio.h>
#include <string.h>

int main() {
    char dest[20]; // Размер целевого буфера — 20
    const char *src = "Hello, World!";

    // Используйте strcpy_s для копирования src в dest
    if (strcpy_s(dest, sizeof(dest), src) != 0) {
        printf("Ошибка strcpy_s!\n");
        return 1; // Вернуть код ошибки
    } else {
        printf("После strcpy_s: %s\n", dest);
    }

    // Используйте strcat_s, чтобы добавить " C Language" к dest
    const char *appendStr = " C Language";
    if (strcat_s(dest, sizeof(dest), appendStr) != 0) {
        printf("Ошибка strcat_s!\n");
        return 1; // Вернуть код ошибки
    } else {
        printf("После strcat_s: %s\n", dest);
    }

    return 0;
}

Вывод:

After strcpy_s: Hello, World!
strcat_s failed!

В приведённом выше коде strcpy_s успешно скопировал строку "Hello, World!" в dest, но поскольку размер dest равен 20, чего недостаточно для размещения "Hello, World! C Language", strcat_s обнаружит, что буфер недостаточен, и вернёт код ошибки.

Пример 2: memcpy_s

Пример

#include <stdio.h>
#include <string.h>

int main() {
    char src[] = "Sensitive Data";
    char dest[15]; // Размер буфера назначения равен 15

    // Используйте memcpy_s для копирования данных в dest
    if (memcpy_s(dest, sizeof(dest), src, strlen(src) + 1) != 0) {
        printf("memcpy_s failed!\n");
        return 1; // Вернуть код ошибки
    } else {
        printf("After memcpy_s: %s\n", dest);
    }

    return 0;
}

Вывод:

After memcpy_s: Sensitive Data

В этом примере memcpy_s проверяет, достаточно ли велик буфер назначения dest, чтобы вместить данные из src, включая нулевой символ в конце строки. Если destsz меньше, чем strlen(src) + 1, функция возвращает ошибку и не выполняет копирование памяти.

Пример 3: strtok_s

Пример

#include <stdio.h>
#include <string.h>

int main() {
    char str[] = "apple,orange,banana";
    char *token;
    char *context = NULL;

    // Использование strtok_s для разделения строки
    token = strtok_s(str, ",", &context);
    while (token != NULL) {
        printf("Токен: %s\n", token);
        token = strtok_s(NULL, ",", &context);
    }

    return 0;
}

Вывод:

Token: apple
Token: orange
Token: banana

В этом примере strtok_s использует параметр context для сохранения информации о контексте при разделении строки, тем самым избегая проблемы потоковой небезопасности strtok.

Пример 4: sprintf_s

Пример

#include <stdio.h>

int main() {
    char buffer[50];
    int num = 42;
    const char *str = "Привет";

    // Использование sprintf_s для форматирования строки и проверки размера буфера
    if (sprintf_s(buffer, sizeof(buffer), "Число: %d, Строка: %s", num, str) < 0) {
        printf("sprintf_s завершился с ошибкой!"\n");
        return 1; // Вернуть код ошибки
    } else {
        printf("Форматированная строка: %s\n", buffer);
    }

    return 0;
}

Вывод:

Formatted String: Number: 42, String: Hello

Здесь sprintf_s принимает размер буфера в качестве параметра при форматировании строки. Если отформатированная строка превышает размер буфера, функция возвращает ошибку, тем самым избегая переполнения буфера.

Приведённые выше примеры демонстрируют способы использования безопасных функций C для копирования строк, конкатенации, копирования памяти, разбиения строк и форматированного вывода. Эти функции обеспечивают проверки размера буфера, значительно повышая безопасность кода.


Справочное руководство

Безопасные функции в основном предназначены для предотвращения переполнения буфера. Этот тип уязвимости обычно возникает из-за того, что функции не проверяют размер буфера назначения.

Текущие основные стандарты безопасных функций в основном происходят из Приложения K (интерфейсы проверки границ) стандарта C11, а также из расширенных версий, предоставляемых различными операционными системами (например, MSVC CRT в Windows).

В следующей таблице представлена справочная таблица безопасных функций C.

1. Обработка строк

Это область, наиболее подверженная переполнению, и безопасные функции обычно требуют передачи размера буфера назначения.

Исходная функция (небезопасная) Безопасные заменяющие функции Основные улучшения
strcpy strcpy_s Добавляет параметр размера буфера назначения; если исходная строка слишком длинная, вызывается обработчик ограничений.
strcat strcat_s Добавляет параметр для размера оставшегося пространства буфера назначения, чтобы предотвратить выход за границы при конкатенации.
strncpy strncpy_s Убедитесь, что целевая строка заканчивается на\0в конце, и добавлена проверка ошибок во время выполнения.
strtok strtok_s Вводит указатель контекста, делая егопотокобезопасными более надёжным.
strlen strnlen_s Добавьте максимальную длину проверки, чтобы предотвратить бесконечные циклы при некорректных данных без\0нулевого терминатора.

2. Форматированный ввод/вывод

Небезопасные функции форматирования могут привести к уязвимостям форматной строки или переполнению буфера.

Исходная функция (небезопасная) Безопасные заменяющие функции Основные улучшения
sprintf snprintf / sprintf_s snprintfОграничьте количество записываемых символов;sprintf_sПроверьте корректность строки формата.
vsprintf vsnprintf_s Добавляет ограничения размера буфера, подходящие для списков переменных аргументов.
scanf scanf_s Пара%sи%cспецификаторы преобразования и т. д.,ПринудительноТребует указания размера буфера.
fscanf fscanf_s Добавить ограничение длины при чтении ввода из файла.
sscanf sscanf_s Добавить ограничение длины при чтении из строки.

3. Стандартный ввод/вывод
Исходная функция (небезопасная) Безопасные заменяющие функции Основные улучшения
gets gets_s / fgets getsУстарело в C11.gets_sНеобходимо указать верхний предел чтения.
tmpnam tmpnam_s Добавляет проверку размера буфера для сгенерированных имён временных файлов.

4. Операции с памятью

Исходная функция (небезопасная) Безопасные заменяющие функции Основные улучшения
memcpy memcpy_s Добавляет проверку размера буфера назначения. При перекрытии или переполнении возвращается ошибка.
memmove memmove_s Добавляет проверку ограничения размера при обработке перекрывающихся областей памяти.
memset memset_s Гарантирует, что компилятор не пропускает операции очистки памяти из-за оптимизации (обычно используется для очистки конфиденциальных данных, таких как пароли).
Другие расширения