summaryrefslogtreecommitdiff
path: root/doc/cli.rst
blob: af2b5f1c1889b0d5355a386bb03fe17c236b73d3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
Commandline interface
==================================================

A lot of the Python-RSA functionality is also available as commandline
scripts. On Linux and other unix-like systems they are executable
Python scripts, on Windows they are .exe files.

All scripts accept a ``--help`` parameter that give you instructions
on how to use them. Here is a short overview:

.. index:: CLI interface
.. index:: pyrsa-keygen, pyrsa-encrypt, pyrsa-decrypt, pyrsa-sign
.. index:: pyrsa-verify, pyrsa-priv2pub, pyrsa-encrypt-bigfile
.. index:: pyrsa-decrypt-bigfile, pyrsa-decrypt-bigfile

+-----------------------+--------------------------------------------------+-----------------------------------------+
| Command               | Usage                                            | Core function                           |
+=======================+==================================================+=========================================+
| pyrsa-keygen          | Generates a new RSA keypair in PEM or DER format | :py:func:`rsa.newkeys`                  |
+-----------------------+--------------------------------------------------+-----------------------------------------+
| pyrsa-encrypt         | Encrypts a file. The file must be shorter than   | :py:func:`rsa.encrypt`                  |
|                       | the key length in order to be encrypted.         |                                         |
+-----------------------+--------------------------------------------------+-----------------------------------------+
| pyrsa-decrypt         | Decrypts a file.                                 | :py:func:`rsa.decrypt`                  |
+-----------------------+--------------------------------------------------+-----------------------------------------+
| pyrsa-sign            | Signs a file, outputs the signature.             | :py:func:`rsa.sign`                     |
+-----------------------+--------------------------------------------------+-----------------------------------------+
| pyrsa-verify          | Verifies a signature. The result is written to   | :py:func:`rsa.verify`                   |
|                       | the console as well as returned in the exit      |                                         |
|                       | status code.                                     |                                         |
+-----------------------+--------------------------------------------------+-----------------------------------------+
| pyrsa-priv2pub        | Reads a private key and outputs the              | \-                                      |
|                       | corresponding public key.                        |                                         |
+-----------------------+--------------------------------------------------+-----------------------------------------+
| pyrsa-encrypt-bigfile | Encrypts a file to an encrypted VARBLOCK file.   | :py:func:`rsa.bigfile.encrypt_bigfile`  |
|                       | The file can be larger than the key length, but  |                                         |
|                       | the output file is only compatible with          |                                         |
|                       | Python-RSA.                                      |                                         |
+-----------------------+--------------------------------------------------+-----------------------------------------+
| pyrsa-decrypt-bigfile | Decrypts an encrypted VARBLOCK file.             | :py:func:`rsa.bigfile.encrypt_bigfile`  |
+-----------------------+--------------------------------------------------+-----------------------------------------+