f3s_*_v2lock()

Callback-обработчик для защиты от записи блока флеш-памяти

Прототип:

#include <fs/f3s_flash.h>
    
int f3s_*_v2lock( f3s_dbase_t *dbase,
                  f3s_access_t *access,
                  uint32_t flags,
                  uint32_t text_offset );

Аргументы:

dbase

Адрес дескриптора базы данных сервиса флеш-памяти.

access

Адрес дескриптора-контейнера для сокета и службы сокетов драйвера флеш-памяти.

flags

Флаги:

F3S_VERIFY_WRITE

Функция должна проверять успешность записи посредством контрольного чтения. Тем не менее, даже этот механизм иногда не обнаруживает ошибки при записи.

text_offset

Адрес блока данных во флеш-устройстве.

Библиотека:

libfs-flash3

Описание:

Эта функция защищает от записи блок, который содержит адрес text_offset (если поддерживается). Если блок уже заблокирован, функция f3s_*_v2lock() не выполняет никаких действий.

Возвращаемое значение:

EOK

Успешное завершение операции.

EIO

Устранимая ошибка ввода/вывода (например, данные блока были повреждены из-за низкого напряжения или произошла ошибка при блокировании, однако она была обнаружена и блок будет доступен для использования после стирания).

EFAULT

Неустранимая ошибка ввода/вывода (например, блок вышел из строя).

EINVAL

Некорректная команда.

ERANGE

Нарушение границ диапазона при доступе к флеш-памяти (посредством функции service->page).

ENODEV

Флеш-память больше недоступна (например, накопитель извлечен из системы).

ESHUTDOWN

Произошла критическая ошибка и необходимо завершить работу драйвера.

Классификация:

ЗОСРВ «Нейтрино», libfs-flash3

Тематические ссылки:

f3s_flash_t

Разработка драйвера флеш-памяти

Предыдущий раздел: перейти