f3s__v2unlock()*

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

Прототип:

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

Аргументы:

dbase

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

access

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

flags

Флаги:

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

text_offset

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

Эта функция удаляет блокировку записи блока, который содержит адрес text_offset (если поддерживается). Если блокировка уже удалена, функция не выполняет никаких действий. Следует иметь в виду, что некоторые устройства не поддерживают разблокирование отдельных блоков — все блоки должны разблокироваться одновременно. В этом случае следует использовать функцию f3s_*_v2unlockall().

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

EOK: Успешное завершение операции.
EIO: Устранимая ошибка ввода/вывода (например, данные блока были повреждены из-за низкого напряжения или произошла ошибка при разблокировании, однако она была обнаружена и блок будет доступен для использования после стирания).
EFAULT: Неустранимая ошибка ввода/вывода (например, блок вышел из строя).
EINVAL: Некорректная команда.
ERANGE: Нарушение границ диапазона при доступе к флеш-памяти (посредством функции service->page).
ENODEV: Флеш-память больше недоступна (например, накопитель извлечен из системы).
ESHUTDOWN: Произошла критическая ошибка и необходимо завершить работу драйвера.

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

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

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

f3s_flash_t

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

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