tee_client_api: define additional return codes

The precision from [1] defines 9 additional return codes. One of them,
TEEC_ERROR_TARGET_DEAD was already added in [2]. Apply the 8 other
ones and reorder them by values.

The added documentation is a verbatim copy of the description from
[1]. Overwrite the existing documentation of TEEC_ERROR_TARGET_DEAD
with the one from the specification.

[1] TEE Client API Specification v1.0 Errata and Precisions
    Version 2.0, §P.4 Define Additional Return Codes

[2] commit f2b0ed41 ("Updated related Linux Driver Refactoring")
Link: https://github.com/OP-TEE/optee_client/commit/f2b0ed41c8c7b3



Signed-off-by: Vincent Mailhol <mailhol.vincent@wanadoo.fr>
Reviewed-by: Etienne Carriere <etienne.carriere@foss.st.com>