1 /* SPDX-License-Identifier: BSD-3-Clause 2 * Copyright(c) 2020 Intel Corporation 3 */ 4 5 #ifndef RTE_EXEC_ENV_WINDOWS 6 #include <unistd.h> 7 #include <pthread.h> 8 #include <sys/socket.h> 9 #include <sys/un.h> 10 #include <dlfcn.h> 11 #endif /* !RTE_EXEC_ENV_WINDOWS */ 12 13 /* we won't link against libbsd, so just always use DPDKs-specific strlcpy */ 14 #undef RTE_USE_LIBBSD 15 #include <rte_string_fns.h> 16 #include <rte_common.h> 17 #include <rte_spinlock.h> 18 #include <rte_log.h> 19 20 #include "rte_telemetry.h" 21 #include "telemetry_json.h" 22 #include "telemetry_data.h" 23 #include "telemetry_internal.h" 24 25 #define MAX_CMD_LEN 56 26 #define MAX_HELP_LEN 64 27 #define MAX_OUTPUT_LEN (1024 * 16) 28 #define MAX_CONNECTIONS 10 29 30 #ifndef RTE_EXEC_ENV_WINDOWS 31 static void * 32 client_handler(void *socket); 33 #endif /* !RTE_EXEC_ENV_WINDOWS */ 34 35 struct cmd_callback { 36 char cmd[MAX_CMD_LEN]; 37 telemetry_cb fn; 38 char help[MAX_HELP_LEN]; 39 }; 40 41 #ifndef RTE_EXEC_ENV_WINDOWS 42 struct socket { 43 int sock; 44 char path[sizeof(((struct sockaddr_un *)0)->sun_path)]; 45 handler fn; 46 uint16_t *num_clients; 47 }; 48 static struct socket v2_socket; /* socket for v2 telemetry */ 49 static struct socket v1_socket; /* socket for v1 telemetry */ 50 #endif /* !RTE_EXEC_ENV_WINDOWS */ 51 52 static const char *telemetry_version; /* save rte_version */ 53 static const char *socket_dir; /* runtime directory */ 54 static rte_cpuset_t *thread_cpuset; 55 static rte_log_fn rte_log_ptr; 56 static uint32_t logtype; 57 58 #define TMTY_LOG(l, ...) \ 59 rte_log_ptr(RTE_LOG_ ## l, logtype, "TELEMETRY: " __VA_ARGS__) 60 61 /* list of command callbacks, with one command registered by default */ 62 static struct cmd_callback callbacks[TELEMETRY_MAX_CALLBACKS]; 63 static int num_callbacks; /* How many commands are registered */ 64 /* Used when accessing or modifying list of command callbacks */ 65 static rte_spinlock_t callback_sl = RTE_SPINLOCK_INITIALIZER; 66 #ifndef RTE_EXEC_ENV_WINDOWS 67 static uint16_t v2_clients; 68 #endif /* !RTE_EXEC_ENV_WINDOWS */ 69 70 int 71 rte_telemetry_register_cmd(const char *cmd, telemetry_cb fn, const char *help) 72 { 73 int i = 0; 74 75 if (strlen(cmd) >= MAX_CMD_LEN || fn == NULL || cmd[0] != '/' 76 || strlen(help) >= MAX_HELP_LEN) 77 return -EINVAL; 78 if (num_callbacks >= TELEMETRY_MAX_CALLBACKS) 79 return -ENOENT; 80 81 rte_spinlock_lock(&callback_sl); 82 while (i < num_callbacks && strcmp(cmd, callbacks[i].cmd) > 0) 83 i++; 84 if (i != num_callbacks) 85 /* Move elements to keep the list alphabetical */ 86 memmove(callbacks + i + 1, callbacks + i, 87 sizeof(struct cmd_callback) * (num_callbacks - i)); 88 89 strlcpy(callbacks[i].cmd, cmd, MAX_CMD_LEN); 90 callbacks[i].fn = fn; 91 strlcpy(callbacks[i].help, help, MAX_HELP_LEN); 92 num_callbacks++; 93 rte_spinlock_unlock(&callback_sl); 94 95 return 0; 96 } 97 98 #ifndef RTE_EXEC_ENV_WINDOWS 99 100 static int 101 list_commands(const char *cmd __rte_unused, const char *params __rte_unused, 102 struct rte_tel_data *d) 103 { 104 int i; 105 106 rte_tel_data_start_array(d, RTE_TEL_STRING_VAL); 107 for (i = 0; i < num_callbacks; i++) 108 rte_tel_data_add_array_string(d, callbacks[i].cmd); 109 return 0; 110 } 111 112 static int 113 json_info(const char *cmd __rte_unused, const char *params __rte_unused, 114 struct rte_tel_data *d) 115 { 116 rte_tel_data_start_dict(d); 117 rte_tel_data_add_dict_string(d, "version", telemetry_version); 118 rte_tel_data_add_dict_int(d, "pid", getpid()); 119 rte_tel_data_add_dict_int(d, "max_output_len", MAX_OUTPUT_LEN); 120 return 0; 121 } 122 123 static int 124 command_help(const char *cmd __rte_unused, const char *params, 125 struct rte_tel_data *d) 126 { 127 int i; 128 129 if (!params) 130 return -1; 131 rte_tel_data_start_dict(d); 132 rte_spinlock_lock(&callback_sl); 133 for (i = 0; i < num_callbacks; i++) 134 if (strcmp(params, callbacks[i].cmd) == 0) { 135 rte_tel_data_add_dict_string(d, params, 136 callbacks[i].help); 137 break; 138 } 139 rte_spinlock_unlock(&callback_sl); 140 if (i == num_callbacks) 141 return -1; 142 return 0; 143 } 144 145 static int 146 container_to_json(const struct rte_tel_data *d, char *out_buf, size_t buf_len) 147 { 148 size_t used = 0; 149 unsigned int i; 150 151 if (d->type != RTE_TEL_ARRAY_U64 && d->type != RTE_TEL_ARRAY_INT 152 && d->type != RTE_TEL_ARRAY_STRING) 153 return snprintf(out_buf, buf_len, "null"); 154 155 used = rte_tel_json_empty_array(out_buf, buf_len, 0); 156 if (d->type == RTE_TEL_ARRAY_U64) 157 for (i = 0; i < d->data_len; i++) 158 used = rte_tel_json_add_array_u64(out_buf, 159 buf_len, used, 160 d->data.array[i].u64val); 161 if (d->type == RTE_TEL_ARRAY_INT) 162 for (i = 0; i < d->data_len; i++) 163 used = rte_tel_json_add_array_int(out_buf, 164 buf_len, used, 165 d->data.array[i].ival); 166 if (d->type == RTE_TEL_ARRAY_STRING) 167 for (i = 0; i < d->data_len; i++) 168 used = rte_tel_json_add_array_string(out_buf, 169 buf_len, used, 170 d->data.array[i].sval); 171 return used; 172 } 173 174 static void 175 output_json(const char *cmd, const struct rte_tel_data *d, int s) 176 { 177 char out_buf[MAX_OUTPUT_LEN]; 178 179 char *cb_data_buf; 180 size_t buf_len, prefix_used, used = 0; 181 unsigned int i; 182 183 RTE_BUILD_BUG_ON(sizeof(out_buf) < MAX_CMD_LEN + 184 RTE_TEL_MAX_SINGLE_STRING_LEN + 10); 185 switch (d->type) { 186 case RTE_TEL_NULL: 187 used = snprintf(out_buf, sizeof(out_buf), "{\"%.*s\":null}", 188 MAX_CMD_LEN, cmd ? cmd : "none"); 189 break; 190 case RTE_TEL_STRING: 191 used = snprintf(out_buf, sizeof(out_buf), "{\"%.*s\":\"%.*s\"}", 192 MAX_CMD_LEN, cmd, 193 RTE_TEL_MAX_SINGLE_STRING_LEN, d->data.str); 194 break; 195 case RTE_TEL_DICT: 196 prefix_used = snprintf(out_buf, sizeof(out_buf), "{\"%.*s\":", 197 MAX_CMD_LEN, cmd); 198 cb_data_buf = &out_buf[prefix_used]; 199 buf_len = sizeof(out_buf) - prefix_used - 1; /* space for '}' */ 200 201 used = rte_tel_json_empty_obj(cb_data_buf, buf_len, 0); 202 for (i = 0; i < d->data_len; i++) { 203 const struct tel_dict_entry *v = &d->data.dict[i]; 204 switch (v->type) { 205 case RTE_TEL_STRING_VAL: 206 used = rte_tel_json_add_obj_str(cb_data_buf, 207 buf_len, used, 208 v->name, v->value.sval); 209 break; 210 case RTE_TEL_INT_VAL: 211 used = rte_tel_json_add_obj_int(cb_data_buf, 212 buf_len, used, 213 v->name, v->value.ival); 214 break; 215 case RTE_TEL_U64_VAL: 216 used = rte_tel_json_add_obj_u64(cb_data_buf, 217 buf_len, used, 218 v->name, v->value.u64val); 219 break; 220 case RTE_TEL_CONTAINER: 221 { 222 char temp[buf_len]; 223 const struct container *cont = 224 &v->value.container; 225 if (container_to_json(cont->data, 226 temp, buf_len) != 0) 227 used = rte_tel_json_add_obj_json( 228 cb_data_buf, 229 buf_len, used, 230 v->name, temp); 231 if (!cont->keep) 232 rte_tel_data_free(cont->data); 233 } 234 } 235 } 236 used += prefix_used; 237 used += strlcat(out_buf + used, "}", sizeof(out_buf) - used); 238 break; 239 case RTE_TEL_ARRAY_STRING: 240 case RTE_TEL_ARRAY_INT: 241 case RTE_TEL_ARRAY_U64: 242 case RTE_TEL_ARRAY_CONTAINER: 243 prefix_used = snprintf(out_buf, sizeof(out_buf), "{\"%.*s\":", 244 MAX_CMD_LEN, cmd); 245 cb_data_buf = &out_buf[prefix_used]; 246 buf_len = sizeof(out_buf) - prefix_used - 1; /* space for '}' */ 247 248 used = rte_tel_json_empty_array(cb_data_buf, buf_len, 0); 249 for (i = 0; i < d->data_len; i++) 250 if (d->type == RTE_TEL_ARRAY_STRING) 251 used = rte_tel_json_add_array_string( 252 cb_data_buf, 253 buf_len, used, 254 d->data.array[i].sval); 255 else if (d->type == RTE_TEL_ARRAY_INT) 256 used = rte_tel_json_add_array_int(cb_data_buf, 257 buf_len, used, 258 d->data.array[i].ival); 259 else if (d->type == RTE_TEL_ARRAY_U64) 260 used = rte_tel_json_add_array_u64(cb_data_buf, 261 buf_len, used, 262 d->data.array[i].u64val); 263 else if (d->type == RTE_TEL_ARRAY_CONTAINER) { 264 char temp[buf_len]; 265 const struct container *rec_data = 266 &d->data.array[i].container; 267 if (container_to_json(rec_data->data, 268 temp, buf_len) != 0) 269 used = rte_tel_json_add_array_json( 270 cb_data_buf, 271 buf_len, used, temp); 272 if (!rec_data->keep) 273 rte_tel_data_free(rec_data->data); 274 } 275 used += prefix_used; 276 used += strlcat(out_buf + used, "}", sizeof(out_buf) - used); 277 break; 278 } 279 if (write(s, out_buf, used) < 0) 280 perror("Error writing to socket"); 281 } 282 283 static void 284 perform_command(telemetry_cb fn, const char *cmd, const char *param, int s) 285 { 286 struct rte_tel_data data; 287 288 int ret = fn(cmd, param, &data); 289 if (ret < 0) { 290 char out_buf[MAX_CMD_LEN + 10]; 291 int used = snprintf(out_buf, sizeof(out_buf), "{\"%.*s\":null}", 292 MAX_CMD_LEN, cmd ? cmd : "none"); 293 if (write(s, out_buf, used) < 0) 294 perror("Error writing to socket"); 295 return; 296 } 297 output_json(cmd, &data, s); 298 } 299 300 static int 301 unknown_command(const char *cmd __rte_unused, const char *params __rte_unused, 302 struct rte_tel_data *d) 303 { 304 return d->type = RTE_TEL_NULL; 305 } 306 307 static void * 308 client_handler(void *sock_id) 309 { 310 int s = (int)(uintptr_t)sock_id; 311 char buffer[1024]; 312 char info_str[1024]; 313 snprintf(info_str, sizeof(info_str), 314 "{\"version\":\"%s\",\"pid\":%d,\"max_output_len\":%d}", 315 telemetry_version, getpid(), MAX_OUTPUT_LEN); 316 if (write(s, info_str, strlen(info_str)) < 0) { 317 close(s); 318 return NULL; 319 } 320 321 /* receive data is not null terminated */ 322 int bytes = read(s, buffer, sizeof(buffer) - 1); 323 while (bytes > 0) { 324 buffer[bytes] = 0; 325 const char *cmd = strtok(buffer, ","); 326 const char *param = strtok(NULL, "\0"); 327 telemetry_cb fn = unknown_command; 328 int i; 329 330 if (cmd && strlen(cmd) < MAX_CMD_LEN) { 331 rte_spinlock_lock(&callback_sl); 332 for (i = 0; i < num_callbacks; i++) 333 if (strcmp(cmd, callbacks[i].cmd) == 0) { 334 fn = callbacks[i].fn; 335 break; 336 } 337 rte_spinlock_unlock(&callback_sl); 338 } 339 perform_command(fn, cmd, param, s); 340 341 bytes = read(s, buffer, sizeof(buffer) - 1); 342 } 343 close(s); 344 __atomic_sub_fetch(&v2_clients, 1, __ATOMIC_RELAXED); 345 return NULL; 346 } 347 348 static void * 349 socket_listener(void *socket) 350 { 351 while (1) { 352 pthread_t th; 353 struct socket *s = (struct socket *)socket; 354 int s_accepted = accept(s->sock, NULL, NULL); 355 if (s_accepted < 0) { 356 TMTY_LOG(ERR, "Error with accept, telemetry thread quitting\n"); 357 return NULL; 358 } 359 if (s->num_clients != NULL) { 360 uint16_t conns = __atomic_load_n(s->num_clients, 361 __ATOMIC_RELAXED); 362 if (conns >= MAX_CONNECTIONS) { 363 close(s_accepted); 364 continue; 365 } 366 __atomic_add_fetch(s->num_clients, 1, 367 __ATOMIC_RELAXED); 368 } 369 pthread_create(&th, NULL, s->fn, (void *)(uintptr_t)s_accepted); 370 pthread_detach(th); 371 } 372 return NULL; 373 } 374 375 static inline char * 376 get_socket_path(const char *runtime_dir, const int version) 377 { 378 static char path[PATH_MAX]; 379 snprintf(path, sizeof(path), "%s/dpdk_telemetry.v%d", 380 strlen(runtime_dir) ? runtime_dir : "/tmp", version); 381 return path; 382 } 383 384 static void 385 unlink_sockets(void) 386 { 387 if (v2_socket.path[0]) 388 unlink(v2_socket.path); 389 if (v1_socket.path[0]) 390 unlink(v1_socket.path); 391 } 392 393 static int 394 create_socket(char *path) 395 { 396 int sock = socket(AF_UNIX, SOCK_SEQPACKET, 0); 397 if (sock < 0) { 398 TMTY_LOG(ERR, "Error with socket creation, %s\n", strerror(errno)); 399 return -1; 400 } 401 402 struct sockaddr_un sun = {.sun_family = AF_UNIX}; 403 strlcpy(sun.sun_path, path, sizeof(sun.sun_path)); 404 unlink(sun.sun_path); 405 if (bind(sock, (void *) &sun, sizeof(sun)) < 0) { 406 TMTY_LOG(ERR, "Error binding socket: %s\n", strerror(errno)); 407 sun.sun_path[0] = 0; 408 goto error; 409 } 410 411 if (listen(sock, 1) < 0) { 412 TMTY_LOG(ERR, "Error calling listen for socket: %s\n", strerror(errno)); 413 goto error; 414 } 415 416 return sock; 417 418 error: 419 close(sock); 420 unlink_sockets(); 421 return -1; 422 } 423 424 static int 425 telemetry_legacy_init(void) 426 { 427 pthread_t t_old; 428 429 if (num_legacy_callbacks == 1) { 430 TMTY_LOG(WARNING, "No legacy callbacks, legacy socket not created\n"); 431 return -1; 432 } 433 434 v1_socket.fn = legacy_client_handler; 435 if ((size_t) snprintf(v1_socket.path, sizeof(v1_socket.path), 436 "%s/telemetry", socket_dir) >= sizeof(v1_socket.path)) { 437 TMTY_LOG(ERR, "Error with socket binding, path too long\n"); 438 return -1; 439 } 440 v1_socket.sock = create_socket(v1_socket.path); 441 if (v1_socket.sock < 0) 442 return -1; 443 pthread_create(&t_old, NULL, socket_listener, &v1_socket); 444 pthread_setaffinity_np(t_old, sizeof(*thread_cpuset), thread_cpuset); 445 pthread_setname_np(t_old, "telemetry-v1"); 446 TMTY_LOG(DEBUG, "Legacy telemetry socket initialized ok\n"); 447 return 0; 448 } 449 450 static int 451 telemetry_v2_init(void) 452 { 453 pthread_t t_new; 454 455 v2_socket.num_clients = &v2_clients; 456 rte_telemetry_register_cmd("/", list_commands, 457 "Returns list of available commands, Takes no parameters"); 458 rte_telemetry_register_cmd("/info", json_info, 459 "Returns DPDK Telemetry information. Takes no parameters"); 460 rte_telemetry_register_cmd("/help", command_help, 461 "Returns help text for a command. Parameters: string command"); 462 v2_socket.fn = client_handler; 463 if (strlcpy(v2_socket.path, get_socket_path(socket_dir, 2), 464 sizeof(v2_socket.path)) >= sizeof(v2_socket.path)) { 465 TMTY_LOG(ERR, "Error with socket binding, path too long\n"); 466 return -1; 467 } 468 469 v2_socket.sock = create_socket(v2_socket.path); 470 if (v2_socket.sock < 0) 471 return -1; 472 pthread_create(&t_new, NULL, socket_listener, &v2_socket); 473 pthread_setaffinity_np(t_new, sizeof(*thread_cpuset), thread_cpuset); 474 pthread_setname_np(t_new, "telemetry-v2"); 475 atexit(unlink_sockets); 476 477 return 0; 478 } 479 480 #endif /* !RTE_EXEC_ENV_WINDOWS */ 481 482 int32_t 483 rte_telemetry_init(const char *runtime_dir, const char *rte_version, rte_cpuset_t *cpuset, 484 rte_log_fn log_fn, uint32_t registered_logtype) 485 { 486 telemetry_version = rte_version; 487 socket_dir = runtime_dir; 488 thread_cpuset = cpuset; 489 rte_log_ptr = log_fn; 490 logtype = registered_logtype; 491 492 #ifndef RTE_EXEC_ENV_WINDOWS 493 if (telemetry_v2_init() != 0) 494 return -1; 495 TMTY_LOG(DEBUG, "Telemetry initialized ok\n"); 496 telemetry_legacy_init(); 497 #endif /* RTE_EXEC_ENV_WINDOWS */ 498 499 return 0; 500 } 501