Serdyukov, Denys 9dca83fd68 Add information about the status command to cli/README.md, correct GUI-CLI Protocol. 4 years ago
..
include 856ce375bf US53: CLI adjust output of status command to show username and IP/port 4 years ago
src 05c4810d40 Merge branch 'clean-ssl-quit-networkmain' into 'develop' 4 years ago
test 856ce375bf US53: CLI adjust output of status command to show username and IP/port 4 years ago
CMakeLists.txt 5e1a4565bd rework CMakeLists into one per directory with one top-level file to build all. get boilerplate for cmdman_test up, also test for version command. 4 years ago
README.md 9dca83fd68 Add information about the status command to cli/README.md, correct GUI-CLI Protocol. 4 years ago

README.md

Using the Command Line Interface (CLI)

Starting the CLI

The command line interface can be started with the following arguments:

Choosing the CLI mode

no argument:
Regular user mode, designed for user interaction.

--machine:
Machine mode, not designed for user interaction. Other programs (like the GUI) can use this for communication with the CLI. For usage, please refer to GUI-CLI Protocol.md.

--batch <file>:
Batch mode. A batch file for the CLI must contain commands (as used in regular user mode) separated by line breaks. The operations can be run by passing the path to the batch file as argument <file>.

Additional arguments

--usessl <certfile>:
Used to enable SSL communication with the server using the certificate file specified by the file path <certfile>. Needs to be passed if server is configured to use SSL encryption. Configurations where only one side has SSL encryption enabled are not supported.

--verbose:
Prints additional output for debugging purposes.

Connecting to a server and logging in

The user connects to a server using connect <ip> <port> where <ip> is the IP of the server and <port> is the port used by the server. The <port> parameter is optional. If no port is specified, 1234 is used.

Then a user has to connect by typing login <username> <password>. Alternatively the user can create an account and log in with signup <username> <password>. If wrong user data was passed, the user is disconnected from the server and needs to connect again.

Specifying a key file for encryption

The following commands are used to specify key files used for encryption of all sent files and for decryption. They can be used at any time.

keyfile <filepath>:
Set a key file. The path of the file has to be specified by <filepath>.

closekey:
Stop using the previously selected keyfile.

Viewing information about the connection

status:
This command shows wether the user is connected to a server, and displays the IP and port of the server in this case. If the user is logged in, also the username and information wether a file transfer between server and client is running are shown.

Interacting with the server

The following commands can be sent when the user is connected to a server and logged in.

extendedstatus:
Shows detailed information about ongoing transfers at the server.

list:
Shows a simple list of the files stored on the server.

extendedlist:
Shows a detailed list of the files stored on the server, containing file size and decryptability.

notifications:
Shows a list of notifications since the last time.

put <filepath>:
Request a file upload to the server. The path of the file has to be specified by <filepath>.

get <filepath>:
Request a download of the file with name <filepath> from the server.
Alternatively a path can be specified where the file with corresponding name is to save, e.g. get ./subfolder/foo.txt downloads the file foo.txt from the server to the directory ./subfolder/.

deletefile <filename>:
Request a deletion of the file with name <filename> from the server. Has to be activated in the server configuration.

queue <filename>:
To add a file that is already on the server to the queue for sending with the covert channel.

dequeue <filename>:
To remove a file from the queue for sending with the covert channel. If the transfer is already running and the covert cahnnel method allows it, this cancels the transfer.

head <filename>:
Request the first 32 bytes of a file on the server in base64 encoding. If the file is smaller than 32 bytes, the first 4 bytes are shown if possible.

deleteme <password>:
Allows the logged in user to delete their account on the server. This action needs to be confirmed with the password.

Disconnecting and exiting

Disconnecting from a server is possible by typing disconnect. After this, it is possible to connect to a server again.

The program can be exited by typing exit at any time.

Displaying a list of commands

help can be used at any time and shows a list of commands.