mirror of https://github.com/openzfs/zfs.git
29 lines
1.4 KiB
Plaintext
29 lines
1.4 KiB
Plaintext
This package provides a wrapper for libzfs_core C library.
|
|
|
|
libzfs_core is intended to be a stable interface for programmatic
|
|
administration of ZFS.
|
|
This wrapper provides one-to-one wrappers for libzfs_core API functions,
|
|
but the signatures and types are more natural to Python.
|
|
nvlists are wrapped as dictionaries or lists depending on their usage.
|
|
Some parameters have default values depending on typical use for
|
|
increased convenience.
|
|
Enumerations and bit flags become strings and lists of strings in Python.
|
|
Errors are reported as exceptions rather than integer errno-style
|
|
error codes. The wrapper takes care to provide one-to-many mapping
|
|
of the error codes to the exceptions by interpreting a context
|
|
in which the error code is produced.
|
|
|
|
Unit tests and automated test for the libzfs_core API are provided
|
|
with this package.
|
|
Please note that the API tests perform lots of ZFS dataset level
|
|
operations and ZFS tries hard to ensure that any modifications
|
|
do reach stable storage. That means that the operations are done
|
|
synchronously and that, for example, disk caches are flushed.
|
|
Thus, the tests can be very slow on real hardware.
|
|
It is recommended to place the default temporary directory or
|
|
a temporary directory specified by, for instance, TMP environment
|
|
variable on a memory backed filesystem.
|
|
|
|
Package documentation: http://pyzfs.readthedocs.org
|
|
Package development: https://github.com/openzfs/zfs
|