GitLocker: The Coding Marketplace

Description:

lacli 0.2.6.1

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 to provide them everytime (but you should keep your ``.netrc`` safe).3. by using the ``login`` command. If authentication is succesfull you will be prompted to save the credentials in ``.netrc`` as above for future use. If interactive the credentials will be used for subsequent 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::: lacliloginyour@email.comPassword:authenticationsuccesfullasyour@email.comSavecredentials?y lacli archive list No available archives. lacliarchivecreate/home/kouk/toread−tdocumentsEncrypting..archiveprepared lacli archive list 001 36MiB documents LOCAL You can't use 'macro parameter character #' in math modeYou can't use 'macro parameter character #' in math mode lacli archive list 001 36MiB documents COMPLETE 68-H1BK laclicertificatelist68−H1BK36MiBdocuments lacli certificate print 68-H1BK Created 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.*