Command/Reply Formatting and Commands

The commands sent by a client and the responses sent back by the server must adhere to the following formatting conventions.

Client Command Format

• Each client command is composed of a single line of text terminated by a newline character. A carriage return followed by a newline (\r\n) is considered to be the same as a newline character (\n) alone.
• Client commands may or may not require additional parameters. Each parameter consists of values, separated by 'pipe' symbol (|). Example command_name value1 [ | value2 | value3 ... ].
• A pipe symbol ( | ) is not permitted as part of the value.
• For each client command, the server responds with a response code indicating success or failure, and optionally includes some descriptive text indicating the actions taken.
• Command names are not case sensitive.
• Parameters/values for any command must appear in exact order following the command. If a value is not applicable or existent for a particular command, an empty value ( | | ) should be provided.

Server Response Format

The server always responds to client initiated commands/requests with text in the following format: <status code> optional informative text
where status code is one of the following:

• OK, which indicates the command/request was successful.
• ERR, which is indicative of failure to execute the request.