Patrick Kelley 8fd444092b initial
2025-05-07 15:35:15 -04:00

90 lines
3.1 KiB
ReStructuredText

:tocdepth: 3
base/frameworks/storage/main.zeek
=================================
.. zeek:namespace:: Storage
The storage framework provides a way to store long-term data to disk.
:Namespace: Storage
Summary
~~~~~~~
Types
#####
========================================================= ===================================================================
:zeek:type:`Storage::BackendOptions`: :zeek:type:`record` Base record for backend options that can be passed to
:zeek:see:`Storage::Async::open_backend` and
:zeek:see:`Storage::Sync::open_backend`.
:zeek:type:`Storage::PutArgs`: :zeek:type:`record` Record for passing arguments to :zeek:see:`Storage::Async::put` and
:zeek:see:`Storage::Sync::put`.
:zeek:type:`Storage::Backend`: :zeek:type:`enum`
:zeek:type:`Storage::Serializer`: :zeek:type:`enum`
========================================================= ===================================================================
Detailed Interface
~~~~~~~~~~~~~~~~~~
Types
#####
.. zeek:type:: Storage::BackendOptions
:source-code: base/frameworks/storage/main.zeek 10 13
:Type: :zeek:type:`record`
serializer: :zeek:type:`Storage::Serializer` :zeek:attr:`&default` = ``Storage::STORAGE_SERIALIZER_JSON`` :zeek:attr:`&optional`
The serializer used for converting Zeek data.
redis: :zeek:type:`Storage::Backend::Redis::Options` :zeek:attr:`&optional`
(present if :doc:`/scripts/policy/frameworks/storage/backend/redis/main.zeek` is loaded)
sqlite: :zeek:type:`Storage::Backend::SQLite::Options` :zeek:attr:`&optional`
(present if :doc:`/scripts/policy/frameworks/storage/backend/sqlite/main.zeek` is loaded)
Base record for backend options that can be passed to
:zeek:see:`Storage::Async::open_backend` and
:zeek:see:`Storage::Sync::open_backend`. Backend plugins can redef this record
to add relevant fields to it.
.. zeek:type:: Storage::PutArgs
:source-code: base/frameworks/storage/main.zeek 17 31
:Type: :zeek:type:`record`
key: :zeek:type:`any`
The key to store the value under.
value: :zeek:type:`any`
The value to store associated with the key.
overwrite: :zeek:type:`bool` :zeek:attr:`&default` = ``T`` :zeek:attr:`&optional`
Indicates whether this value should overwrite an existing entry for the
key.
expire_time: :zeek:type:`interval` :zeek:attr:`&default` = ``0 secs`` :zeek:attr:`&optional`
An interval of time until the entry is automatically removed from the
backend.
Record for passing arguments to :zeek:see:`Storage::Async::put` and
:zeek:see:`Storage::Sync::put`.
.. zeek:type:: Storage::Backend
:Type: :zeek:type:`enum`
.. zeek:enum:: Storage::STORAGE_BACKEND_REDIS Storage::Backend
.. zeek:enum:: Storage::STORAGE_BACKEND_SQLITE Storage::Backend
.. zeek:type:: Storage::Serializer
:Type: :zeek:type:`enum`
.. zeek:enum:: Storage::STORAGE_SERIALIZER_JSON Storage::Serializer