psa_constant_names.c 11 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322
  1. /*
  2. * Copyright The Mbed TLS Contributors
  3. * SPDX-License-Identifier: Apache-2.0
  4. *
  5. * Licensed under the Apache License, Version 2.0 (the "License"); you may
  6. * not use this file except in compliance with the License.
  7. * You may obtain a copy of the License at
  8. *
  9. * http://www.apache.org/licenses/LICENSE-2.0
  10. *
  11. * Unless required by applicable law or agreed to in writing, software
  12. * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
  13. * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
  14. * See the License for the specific language governing permissions and
  15. * limitations under the License.
  16. */
  17. #include <errno.h>
  18. #include <stdint.h>
  19. #include <stdio.h>
  20. #include <stdlib.h>
  21. #include <string.h>
  22. #include "psa/crypto.h"
  23. /* This block is present to support Visual Studio builds prior to 2015 */
  24. #if defined(_MSC_VER) && _MSC_VER < 1900
  25. #include <stdarg.h>
  26. int snprintf(char *s, size_t n, const char *fmt, ...)
  27. {
  28. int ret;
  29. va_list argp;
  30. /* Avoid calling the invalid parameter handler by checking ourselves */
  31. if (s == NULL || n == 0 || fmt == NULL) {
  32. return -1;
  33. }
  34. va_start(argp, fmt);
  35. #if defined(_TRUNCATE) && !defined(__MINGW32__)
  36. ret = _vsnprintf_s(s, n, _TRUNCATE, fmt, argp);
  37. #else
  38. ret = _vsnprintf(s, n, fmt, argp);
  39. if (ret < 0 || (size_t) ret == n) {
  40. s[n-1] = '\0';
  41. ret = -1;
  42. }
  43. #endif
  44. va_end(argp);
  45. return ret;
  46. }
  47. #endif
  48. static void append(char **buffer, size_t buffer_size,
  49. size_t *required_size,
  50. const char *string, size_t length)
  51. {
  52. *required_size += length;
  53. if (*required_size < buffer_size) {
  54. memcpy(*buffer, string, length);
  55. *buffer += length;
  56. }
  57. }
  58. static void append_integer(char **buffer, size_t buffer_size,
  59. size_t *required_size,
  60. const char *format /*printf format for value*/,
  61. unsigned long value)
  62. {
  63. size_t n = snprintf(*buffer, buffer_size - *required_size, format, value);
  64. if (n < buffer_size - *required_size) {
  65. *buffer += n;
  66. }
  67. *required_size += n;
  68. }
  69. /* The code of these function is automatically generated and included below. */
  70. static const char *psa_ecc_family_name(psa_ecc_family_t curve);
  71. static const char *psa_dh_family_name(psa_dh_family_t group);
  72. static const char *psa_hash_algorithm_name(psa_algorithm_t hash_alg);
  73. static void append_with_curve(char **buffer, size_t buffer_size,
  74. size_t *required_size,
  75. const char *string, size_t length,
  76. psa_ecc_family_t curve)
  77. {
  78. const char *family_name = psa_ecc_family_name(curve);
  79. append(buffer, buffer_size, required_size, string, length);
  80. append(buffer, buffer_size, required_size, "(", 1);
  81. if (family_name != NULL) {
  82. append(buffer, buffer_size, required_size,
  83. family_name, strlen(family_name));
  84. } else {
  85. append_integer(buffer, buffer_size, required_size,
  86. "0x%02x", curve);
  87. }
  88. append(buffer, buffer_size, required_size, ")", 1);
  89. }
  90. static void append_with_group(char **buffer, size_t buffer_size,
  91. size_t *required_size,
  92. const char *string, size_t length,
  93. psa_dh_family_t group)
  94. {
  95. const char *group_name = psa_dh_family_name(group);
  96. append(buffer, buffer_size, required_size, string, length);
  97. append(buffer, buffer_size, required_size, "(", 1);
  98. if (group_name != NULL) {
  99. append(buffer, buffer_size, required_size,
  100. group_name, strlen(group_name));
  101. } else {
  102. append_integer(buffer, buffer_size, required_size,
  103. "0x%02x", group);
  104. }
  105. append(buffer, buffer_size, required_size, ")", 1);
  106. }
  107. typedef const char *(*psa_get_algorithm_name_func_ptr)(psa_algorithm_t alg);
  108. static void append_with_alg(char **buffer, size_t buffer_size,
  109. size_t *required_size,
  110. psa_get_algorithm_name_func_ptr get_name,
  111. psa_algorithm_t alg)
  112. {
  113. const char *name = get_name(alg);
  114. if (name != NULL) {
  115. append(buffer, buffer_size, required_size,
  116. name, strlen(name));
  117. } else {
  118. append_integer(buffer, buffer_size, required_size,
  119. "0x%08lx", alg);
  120. }
  121. }
  122. #include "psa_constant_names_generated.c"
  123. static int psa_snprint_status(char *buffer, size_t buffer_size,
  124. psa_status_t status)
  125. {
  126. const char *name = psa_strerror(status);
  127. if (name == NULL) {
  128. return snprintf(buffer, buffer_size, "%ld", (long) status);
  129. } else {
  130. size_t length = strlen(name);
  131. if (length < buffer_size) {
  132. memcpy(buffer, name, length + 1);
  133. return (int) length;
  134. } else {
  135. return (int) buffer_size;
  136. }
  137. }
  138. }
  139. static int psa_snprint_ecc_curve(char *buffer, size_t buffer_size,
  140. psa_ecc_family_t curve)
  141. {
  142. const char *name = psa_ecc_family_name(curve);
  143. if (name == NULL) {
  144. return snprintf(buffer, buffer_size, "0x%02x", (unsigned) curve);
  145. } else {
  146. size_t length = strlen(name);
  147. if (length < buffer_size) {
  148. memcpy(buffer, name, length + 1);
  149. return (int) length;
  150. } else {
  151. return (int) buffer_size;
  152. }
  153. }
  154. }
  155. static int psa_snprint_dh_group(char *buffer, size_t buffer_size,
  156. psa_dh_family_t group)
  157. {
  158. const char *name = psa_dh_family_name(group);
  159. if (name == NULL) {
  160. return snprintf(buffer, buffer_size, "0x%02x", (unsigned) group);
  161. } else {
  162. size_t length = strlen(name);
  163. if (length < buffer_size) {
  164. memcpy(buffer, name, length + 1);
  165. return (int) length;
  166. } else {
  167. return (int) buffer_size;
  168. }
  169. }
  170. }
  171. static void usage(const char *program_name)
  172. {
  173. printf("Usage: %s TYPE VALUE [VALUE...]\n",
  174. program_name == NULL ? "psa_constant_names" : program_name);
  175. printf("Print the symbolic name whose numerical value is VALUE in TYPE.\n");
  176. printf("Supported types (with = between aliases):\n");
  177. printf(" alg=algorithm Algorithm (psa_algorithm_t)\n");
  178. printf(" curve=ecc_curve Elliptic curve identifier (psa_ecc_family_t)\n");
  179. printf(" group=dh_group Diffie-Hellman group identifier (psa_dh_family_t)\n");
  180. printf(" type=key_type Key type (psa_key_type_t)\n");
  181. printf(" usage=key_usage Key usage (psa_key_usage_t)\n");
  182. printf(" error=status Status code (psa_status_t)\n");
  183. }
  184. typedef enum {
  185. TYPE_STATUS,
  186. } signed_value_type;
  187. int process_signed(signed_value_type type, long min, long max, char **argp)
  188. {
  189. for (; *argp != NULL; argp++) {
  190. char buffer[200];
  191. char *end;
  192. long value = strtol(*argp, &end, 0);
  193. if (*end) {
  194. printf("Non-numeric value: %s\n", *argp);
  195. return EXIT_FAILURE;
  196. }
  197. if (value < min || (errno == ERANGE && value < 0)) {
  198. printf("Value too small: %s\n", *argp);
  199. return EXIT_FAILURE;
  200. }
  201. if (value > max || (errno == ERANGE && value > 0)) {
  202. printf("Value too large: %s\n", *argp);
  203. return EXIT_FAILURE;
  204. }
  205. switch (type) {
  206. case TYPE_STATUS:
  207. psa_snprint_status(buffer, sizeof(buffer),
  208. (psa_status_t) value);
  209. break;
  210. }
  211. puts(buffer);
  212. }
  213. return EXIT_SUCCESS;
  214. }
  215. typedef enum {
  216. TYPE_ALGORITHM,
  217. TYPE_ECC_CURVE,
  218. TYPE_DH_GROUP,
  219. TYPE_KEY_TYPE,
  220. TYPE_KEY_USAGE,
  221. } unsigned_value_type;
  222. int process_unsigned(unsigned_value_type type, unsigned long max, char **argp)
  223. {
  224. for (; *argp != NULL; argp++) {
  225. char buffer[200];
  226. char *end;
  227. unsigned long value = strtoul(*argp, &end, 0);
  228. if (*end) {
  229. printf("Non-numeric value: %s\n", *argp);
  230. return EXIT_FAILURE;
  231. }
  232. if (value > max || errno == ERANGE) {
  233. printf("Value out of range: %s\n", *argp);
  234. return EXIT_FAILURE;
  235. }
  236. switch (type) {
  237. case TYPE_ALGORITHM:
  238. psa_snprint_algorithm(buffer, sizeof(buffer),
  239. (psa_algorithm_t) value);
  240. break;
  241. case TYPE_ECC_CURVE:
  242. psa_snprint_ecc_curve(buffer, sizeof(buffer),
  243. (psa_ecc_family_t) value);
  244. break;
  245. case TYPE_DH_GROUP:
  246. psa_snprint_dh_group(buffer, sizeof(buffer),
  247. (psa_dh_family_t) value);
  248. break;
  249. case TYPE_KEY_TYPE:
  250. psa_snprint_key_type(buffer, sizeof(buffer),
  251. (psa_key_type_t) value);
  252. break;
  253. case TYPE_KEY_USAGE:
  254. psa_snprint_key_usage(buffer, sizeof(buffer),
  255. (psa_key_usage_t) value);
  256. break;
  257. }
  258. puts(buffer);
  259. }
  260. return EXIT_SUCCESS;
  261. }
  262. int main(int argc, char *argv[])
  263. {
  264. if (argc <= 1 ||
  265. !strcmp(argv[1], "help") ||
  266. !strcmp(argv[1], "--help")) {
  267. usage(argv[0]);
  268. return EXIT_FAILURE;
  269. }
  270. if (!strcmp(argv[1], "error") || !strcmp(argv[1], "status")) {
  271. /* There's no way to obtain the actual range of a signed type,
  272. * so hard-code it here: psa_status_t is int32_t. */
  273. return process_signed(TYPE_STATUS, INT32_MIN, INT32_MAX,
  274. argv + 2);
  275. } else if (!strcmp(argv[1], "alg") || !strcmp(argv[1], "algorithm")) {
  276. return process_unsigned(TYPE_ALGORITHM, (psa_algorithm_t) (-1),
  277. argv + 2);
  278. } else if (!strcmp(argv[1], "curve") || !strcmp(argv[1], "ecc_curve")) {
  279. return process_unsigned(TYPE_ECC_CURVE, (psa_ecc_family_t) (-1),
  280. argv + 2);
  281. } else if (!strcmp(argv[1], "group") || !strcmp(argv[1], "dh_group")) {
  282. return process_unsigned(TYPE_DH_GROUP, (psa_dh_family_t) (-1),
  283. argv + 2);
  284. } else if (!strcmp(argv[1], "type") || !strcmp(argv[1], "key_type")) {
  285. return process_unsigned(TYPE_KEY_TYPE, (psa_key_type_t) (-1),
  286. argv + 2);
  287. } else if (!strcmp(argv[1], "usage") || !strcmp(argv[1], "key_usage")) {
  288. return process_unsigned(TYPE_KEY_USAGE, (psa_key_usage_t) (-1),
  289. argv + 2);
  290. } else {
  291. printf("Unknown type: %s\n", argv[1]);
  292. return EXIT_FAILURE;
  293. }
  294. }