Package: lacli
The Longaccess client=====================This is the prototype client program for interacting with the`Longaccess service <https://www.longaccess.com>`__. It is usable viathe command line on systems that have `Python <http://www.python.org>`__installed but also requires a registered account. If you are unfamiliarwith other aspects of the Longaccess service a good place to start is"`What isLongaccess? <https://github.com/longaccess/longaccess-docs/blob/master/what_is_longaccess.md>`__\ "Installation------------We have binary packages for certain platforms, like MacOS X, Windows 864-bit, Linux and FreeBSD. For more information see the `Longaccessdownloads page <https://downloads.longaccess.com>`__. For otherplatforms or purposes you can download or clone the source repository,create a `virtualenv <http://www.virtualenv.org>`__ if needed, andinstall the client via ``pip``. E.g.:::pip install https://github.com/longaccess/longaccess-client/tarball/masterNote that currently, certain third-party libraries are required inmodified form. These special dependencies are described in`requirements.txt <>`__ and can be automatically installed if thefollowing command is given:::pip install -r requirements.txtDependencies------------The prebuilt binary packages are self-contained, i.e. they do not haveany hard external dependencies. There is however a soft dependency on anexternal tool to securely delete files from the filesystem, see belowfor more information. When installing from source most dependencies areautomatically installable via ``pip``. On some platforms theinstallation might require manually installing development packages,e.g. on [Fedora Linux][] you might need to install the ``python2-devel``package. Additional packages, like ``thrift`` and ``twisted`` arenecessary for the RPC server (used to communicate with GUI frontends).Last, install the ```python-zipstream`` <>`__ package to enableon-the-fly operations, requiring less temporary space on disk.Usage-----After installation the program is invoked as ``lacli``. Run it with noarguments to see a synopsis of supported usages. In short, there arefour basic commands:-  ``lacli login`` set up credentials to use with other commands-  ``lacli archive`` helps you manage archives-  ``lacli certificate`` helps you manage certificates-  ``lacli capsules`` let's you view your available capsules-  ``lacli server`` runs the RPC server. You normally do not need this.Alternatively one may run the program interactively by running``lacli -i``.The ``lacli`` command supports certain global options which you can seein the aforementioned synopsis. The only required argument however isthe authentication parameters which we discuss in the next section.Authentication--------------In order to use the service you must first have a username and passwordfor the service. You can provide them to the program in two ways:1. as global arguments, e.g. ``lacli -u user -p pass archive list ...``.If a password is not provided you will be prompted for one.2. as entries in your ``.netrc`` file. This way you will not have toprovide them everytime (but you should keep your ``.netrc`` safe).3. by using the ``login`` command. If authentication is succesfull youwill be prompted to save the credentials in ``.netrc`` as above forfuture use. If interactive the credentials will be used forsubsequent commands.Netrc~~~~~The correct ``machine`` to add to ``.netrc`` for the service inproduction at Longaccess is ``www.longaccess.com``. For example you needthis entry:::machine www.longaccess.com login user@domain.com password somep4ssExample usage-------------An example scenario:::$ lacli login your@email.comPassword:authentication succesfull as your@email.comSave credentials? y$ lacli archive listNo available archives.$ lacli archive create /home/kouk/toread -t documentsEncrypting..archive prepared$ lacli archive list001  36MiB             documents      LOCAL$ lacli archive upload 1/home/kouk/.longaccess/data/2013-10-18-documents.zip.crypt : |###################| ETA:  0:00:00 349.66 MB/sUpload finished, waiting for verificationPress Ctrl-C to check manually laterstatus: completedCertificate 68-H1BK saved.Use lacli certificate list to see your certificates, or lacli certificate --help for more optionsdone.$ lacli archive list001  36MiB             documents   COMPLETE    68-H1BK$ lacli certificate list68-H1BK  36MiB documents$ lacli certificate print 68-H1BKCreated files:longaccess-68-H1BK.html$Secure removal--------------When removing archives and certificates from the disk the programsupports `secure deletion <https://ssd.eff.org/tech/deletion>`__ throughan external program. In case a suitable removal program cannot befound\* the client will complain and give further instructions.Currently we automatically support the following tools, if they areavailable on the system path:-  `srm <http://en.wikipedia.org/wiki/Srm_(Unix)>`__ (Mac, Unix)-  `shred <http://en.wikipedia.org/wiki/Shred_(Unix)>`__ (Unix)-  `sdelete <http://technet.microsoft.com/en-us/sysinternals/bb897443.aspx>`__(Windows, proprietary)-  `Eraser <http://eraser.heidi.ie/>`__ (Windows, open-source)*\* or one has not been provided via the optional argument to the``delete`` command.*