|
|
|
@ -10,9 +10,9 @@ From the repo
|
|
|
|
|
|
|
|
|
|
You can pull the code from the repository at URL using pip:
|
|
|
|
|
|
|
|
|
|
.. code-block:: bash
|
|
|
|
|
::
|
|
|
|
|
|
|
|
|
|
pip install git+ssh://URL/python-simplezfs
|
|
|
|
|
pip install git+https://github.com/svalouch/python-simplezfs#egg=simplezfs
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Interfaces
|
|
|
|
@ -22,17 +22,17 @@ For both ``zfs(8)`` and ``zpool(8)`` there exist two interfaces:
|
|
|
|
|
* **cli** calls the ``zfs`` and ``zpool`` binaries in subprocesses
|
|
|
|
|
* **native** uses ``libzfs_core`` to achieve the same goals
|
|
|
|
|
|
|
|
|
|
There exist two functions :func:`~simplezfs.zfs.get_zfs` and :func:`~simplezfs.zpool.get_zpool` that take the implementation as
|
|
|
|
|
first argument and return the appropriate implementation. The main documentation about how it works are in the api
|
|
|
|
|
documentation for the interface classes :class:`~simplezfs.zfs.ZFS` and :class:`~simplezfs.zpool.ZPool`.
|
|
|
|
|
There exist two functions :func:`~simplezfs.zfs.get_zfs` and :func:`~simplezfs.zpool.get_zpool` that take the
|
|
|
|
|
implementation as first argument and return the appropriate implementation. The main documentation about how it works
|
|
|
|
|
are in the api documentation for the interface classes :class:`~simplezfs.zfs.ZFS` and :class:`~simplezfs.zpool.ZPool`.
|
|
|
|
|
|
|
|
|
|
This guide focuses on the ``cli`` variants.
|
|
|
|
|
|
|
|
|
|
It is not strictly neccessary to get and pass around an instance every time, as the classes hold very little state.
|
|
|
|
|
They need to do some initialization however, such as finding the binaries (and thus hitting the local filesystem).
|
|
|
|
|
|
|
|
|
|
For the rest of the guide, we'll assume that the following has been run and we have a :class:`~simplezfs.zfs.ZFS` instance
|
|
|
|
|
in ``zfs``:
|
|
|
|
|
For the rest of the guide, we'll assume that the following has been run and we have a :class:`~simplezfs.zfs.ZFS`
|
|
|
|
|
instance in ``zfs``:
|
|
|
|
|
|
|
|
|
|
.. code-block:: pycon
|
|
|
|
|
|
|
|
|
|