ODBM_File

СОДЕРЖАНИЕ

• НАЗВАНИЕ
• СИНТАКСИС
• ОПИСАНИЕ
• ДИАГНОСТИКА
  • odbm store returned -1, errno 22, key "..." at ...
• БЕЗОПАСНОСТЬ И ПЕРЕНОСИМОСТЬ
• ОШИБКИ И ПРЕДУПРЕЖДЕНИЯ

НАЗВАНИЕ

ODBM_File - Связанный доступ к файлам odbm

СИНТАКСИС

use Fcntl;   # For O_RDWR, O_CREAT, etc.
use ODBM_File;

 # Now read and change the hash
 $h{newkey} = newvalue;
 print $h{oldkey}; 
 ...

 untie %h;

ОПИСАНИЕ

ODBM_File устанавливает соединение между переменной Perl hash и файлом в формате ODBM_File;. Вы можете манипулировать данными в файле так, как будто они находятся в переменной Perl hash, но после завершения программы данные останутся в файле для использования при следующем запуске программы.

Используйте ODBM_File с внутренней функцией Perl tie для установления соединения между переменной и файлом. Аргументы для tie должны быть:

1. Переменная hash, которую вы хотите связать.

2. Строка "ODBM_File". (Это указывает Perl использовать пакет ODBM_File для выполнения функций hash.)

3. Имя файла, который вы хотите связать с hash.

4. Флаги. Используйте один из:

   O_RDONLY

   Только чтение данных из файла.

   O_WRONLY

   Только запись данных в файл.

   O_RDWR

   Чтение и запись.

   Если вы хотите создать файл, если он не существует, добавьте O_CREAT к любому из этих, как в примере. Если вы опустите O_CREAT и файл не существует, вызов tie завершится ошибкой.

5. По умолчанию права доступа, если создается новый файл. Фактические права доступа будут изменены маской пользователя, поэтому вы, вероятно, должны использовать 0666. (См. "umask" в perlfunc.)

ДИАГНОСТИКА

При ошибке функция tie возвращает неопределенное значение и, вероятно, устанавливает $! для хранения причины, по которой файл не удалось связать.

odbm store returned -1, errno 22, key "..." at ...

Это предупреждение выводится, когда вы пытаетесь сохранить ключ или значение, которые слишком длинные. Это означает, что изменение не было записано в базу данных. Смотрите ОШИБКИ И ПРЕДУПРЕЖДЕНИЯ ниже.

БЕЗОПАСНОСТЬ И ПЕРЕНОСИМОСТЬ

Не принимайте файлы ODBM из ненадежных источников.

На современных системах Linux это обычно файлы GDBM, которые не переносимы между платформами.

Документация GDBM не предполагает, что файлы из ненадежных источников можно безопасно использовать с libgdbm.

Системы, которые не используют совместимость GDBM для поддержки старой dbm, будут использовать платформенно-зависимую библиотеку, возможно, унаследованную от систем BSD, где использование ненадежного файла может быть или не быть безопасным.

Злонамеренно созданный файл может привести к сбою Perl или даже к раскрытию уязвимости.

ОШИБКИ И ПРЕДУПРЕЖДЕНИЯ

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

См. "tie" в perlfunc, perldbmfilter, Fcntl