diff options
| author | Tobias Brunner <tobias@strongswan.org> | 2016-05-11 11:11:44 +0200 |
|---|---|---|
| committer | Tobias Brunner <tobias@strongswan.org> | 2016-05-11 11:16:43 +0200 |
| commit | fa844a798b76b09667cccaa569debd8313949d17 (patch) | |
| tree | 0279185b7c25678546b4b85800a5533f69ed7196 /src/libcharon/plugins/vici/python/README.rst | |
| parent | 5d5ecd8e72d173b78424094e71fd0bc1f6e0c929 (diff) | |
| download | strongswan-fa844a798b76b09667cccaa569debd8313949d17.tar.bz2 strongswan-fa844a798b76b09667cccaa569debd8313949d17.tar.xz | |
vici: Add README.rst to be used as description on PyPI
Diffstat (limited to 'src/libcharon/plugins/vici/python/README.rst')
| -rw-r--r-- | src/libcharon/plugins/vici/python/README.rst | 24 |
1 files changed, 24 insertions, 0 deletions
diff --git a/src/libcharon/plugins/vici/python/README.rst b/src/libcharon/plugins/vici/python/README.rst new file mode 100644 index 000000000..3990f6300 --- /dev/null +++ b/src/libcharon/plugins/vici/python/README.rst @@ -0,0 +1,24 @@ +About +----- + +The strongSwan VICI protocol allows external applications to monitor, configure +and control the IKE daemon charon. This Python package provides a native client +side implementation of the VICI protocol, well suited to script automated tasks +in a reliable way. + + +Example Usage +------------- + +.. code-block:: python + + >>> import vici + >>> s = vici.Session() + >>> s.version() + OrderedDict([('daemon', b'charon'), ('version', b'5.4.0'), + ('sysname', b'Linux'), ('release', b'3.13.0-27-generic'), ('machine', b'x86_64')]) + >>> s.load_pool({"p1": {"addrs": "10.0.0.0/24"}}) + OrderedDict([('success', b'yes')]) + >>> s.get_pools() + OrderedDict([('p1', OrderedDict([('base', b'10.0.0.0'), ('size', b'254'), + ('online', b'0'), ('offline', b'0')]))]) |