rtt_server: Add option for a message when client connects
[openocd.git] / src / server / rtt_server.c
1 // SPDX-License-Identifier: GPL-2.0-or-later
2
3 /*
4 * Copyright (C) 2016-2017 by Marc Schink <dev@zapb.de>
5 */
6
7 #ifdef HAVE_CONFIG_H
8 #include "config.h"
9 #endif
10
11 #include <stdint.h>
12 #include <rtt/rtt.h>
13
14 #include "server.h"
15 #include "rtt_server.h"
16
17 /**
18 * @file
19 *
20 * RTT server.
21 *
22 * This server allows access to Real Time Transfer (RTT) channels via TCP
23 * connections.
24 */
25
26 struct rtt_service {
27 unsigned int channel;
28 char *hello_message;
29 };
30
31 static int read_callback(unsigned int channel, const uint8_t *buffer,
32 size_t length, void *user_data)
33 {
34 int ret;
35 struct connection *connection;
36 size_t offset;
37
38 connection = (struct connection *)user_data;
39 offset = 0;
40
41 while (offset < length) {
42 ret = connection_write(connection, buffer + offset, length - offset);
43
44 if (ret < 0) {
45 LOG_ERROR("Failed to write data to socket.");
46 return ERROR_FAIL;
47 }
48
49 offset += ret;
50 }
51
52 return ERROR_OK;
53 }
54
55 static int rtt_new_connection(struct connection *connection)
56 {
57 int ret;
58 struct rtt_service *service;
59
60 service = connection->service->priv;
61
62 LOG_DEBUG("rtt: New connection for channel %u", service->channel);
63
64 ret = rtt_register_sink(service->channel, &read_callback, connection);
65
66 if (ret != ERROR_OK)
67 return ret;
68
69 if (service->hello_message)
70 connection_write(connection, service->hello_message, strlen(service->hello_message));
71
72 return ERROR_OK;
73 }
74
75 static int rtt_connection_closed(struct connection *connection)
76 {
77 struct rtt_service *service;
78
79 service = (struct rtt_service *)connection->service->priv;
80 rtt_unregister_sink(service->channel, &read_callback, connection);
81
82 LOG_DEBUG("rtt: Connection for channel %u closed", service->channel);
83
84 return ERROR_OK;
85 }
86
87 static int rtt_input(struct connection *connection)
88 {
89 int bytes_read;
90 unsigned char buffer[1024];
91 struct rtt_service *service;
92 size_t length;
93
94 service = (struct rtt_service *)connection->service->priv;
95 bytes_read = connection_read(connection, buffer, sizeof(buffer));
96
97 if (!bytes_read)
98 return ERROR_SERVER_REMOTE_CLOSED;
99 else if (bytes_read < 0) {
100 LOG_ERROR("error during read: %s", strerror(errno));
101 return ERROR_SERVER_REMOTE_CLOSED;
102 }
103
104 length = bytes_read;
105 rtt_write_channel(service->channel, buffer, &length);
106
107 return ERROR_OK;
108 }
109
110 static const struct service_driver rtt_service_driver = {
111 .name = "rtt",
112 .new_connection_during_keep_alive_handler = NULL,
113 .new_connection_handler = rtt_new_connection,
114 .input_handler = rtt_input,
115 .connection_closed_handler = rtt_connection_closed,
116 .keep_client_alive_handler = NULL,
117 };
118
119 COMMAND_HANDLER(handle_rtt_start_command)
120 {
121 int ret;
122 struct rtt_service *service;
123
124 if (CMD_ARGC < 2 || CMD_ARGC > 3)
125 return ERROR_COMMAND_SYNTAX_ERROR;
126
127 service = calloc(1, sizeof(struct rtt_service));
128
129 if (!service)
130 return ERROR_FAIL;
131
132 COMMAND_PARSE_NUMBER(uint, CMD_ARGV[1], service->channel);
133
134 if (CMD_ARGC >= 3) {
135 const char *hello_message = CMD_ARGV[2];
136 size_t hello_length = strlen(hello_message);
137
138 service->hello_message = malloc(hello_length + 2);
139 if (!service->hello_message) {
140 LOG_ERROR("Out of memory");
141 free(service);
142 return ERROR_FAIL;
143 }
144 strcpy(service->hello_message, hello_message);
145 service->hello_message[hello_length] = '\n';
146 service->hello_message[hello_length + 1] = '\0';
147 }
148 ret = add_service(&rtt_service_driver, CMD_ARGV[0], CONNECTION_LIMIT_UNLIMITED, service);
149
150 if (ret != ERROR_OK) {
151 free(service);
152 return ERROR_FAIL;
153 }
154
155 return ERROR_OK;
156 }
157
158 COMMAND_HANDLER(handle_rtt_stop_command)
159 {
160 if (CMD_ARGC != 1)
161 return ERROR_COMMAND_SYNTAX_ERROR;
162
163 remove_service("rtt", CMD_ARGV[0]);
164
165 return ERROR_OK;
166 }
167
168 static const struct command_registration rtt_server_subcommand_handlers[] = {
169 {
170 .name = "start",
171 .handler = handle_rtt_start_command,
172 .mode = COMMAND_ANY,
173 .help = "Start a RTT server",
174 .usage = "<port> <channel> [message]"
175 },
176 {
177 .name = "stop",
178 .handler = handle_rtt_stop_command,
179 .mode = COMMAND_ANY,
180 .help = "Stop a RTT server",
181 .usage = "<port>"
182 },
183 COMMAND_REGISTRATION_DONE
184 };
185
186 static const struct command_registration rtt_server_command_handlers[] = {
187 {
188 .name = "server",
189 .mode = COMMAND_ANY,
190 .help = "RTT server",
191 .usage = "",
192 .chain = rtt_server_subcommand_handlers
193 },
194 COMMAND_REGISTRATION_DONE
195 };
196
197 static const struct command_registration rtt_command_handlers[] = {
198 {
199 .name = "rtt",
200 .mode = COMMAND_ANY,
201 .help = "RTT",
202 .usage = "",
203 .chain = rtt_server_command_handlers
204 },
205 COMMAND_REGISTRATION_DONE
206 };
207
208 int rtt_server_register_commands(struct command_context *ctx)
209 {
210 return register_commands(ctx, NULL, rtt_command_handlers);
211 }

Linking to existing account procedure

If you already have an account and want to add another login method you MUST first sign in with your existing account and then change URL to read https://review.openocd.org/login/?link to get to this page again but this time it'll work for linking. Thank you.

SSH host keys fingerprints

1024 SHA256:YKx8b7u5ZWdcbp7/4AeXNaqElP49m6QrwfXaqQGJAOk gerrit-code-review@openocd.zylin.com (DSA)
384 SHA256:jHIbSQa4REvwCFG4cq5LBlBLxmxSqelQPem/EXIrxjk gerrit-code-review@openocd.org (ECDSA)
521 SHA256:UAOPYkU9Fjtcao0Ul/Rrlnj/OsQvt+pgdYSZ4jOYdgs gerrit-code-review@openocd.org (ECDSA)
256 SHA256:A13M5QlnozFOvTllybRZH6vm7iSt0XLxbA48yfc2yfY gerrit-code-review@openocd.org (ECDSA)
256 SHA256:spYMBqEYoAOtK7yZBrcwE8ZpYt6b68Cfh9yEVetvbXg gerrit-code-review@openocd.org (ED25519)
+--[ED25519 256]--+
|=..              |
|+o..   .         |
|*.o   . .        |
|+B . . .         |
|Bo. = o S        |
|Oo.+ + =         |
|oB=.* = . o      |
| =+=.+   + E     |
|. .=o   . o      |
+----[SHA256]-----+
2048 SHA256:0Onrb7/PHjpo6iVZ7xQX2riKN83FJ3KGU0TvI0TaFG4 gerrit-code-review@openocd.zylin.com (RSA)