2 * Copyright (c) 2017-2022 Cisco and/or its affiliates.
3 * Licensed under the Apache License, Version 2.0 (the "License");
4 * you may not use this file except in compliance with the License.
5 * You may obtain a copy of the License at:
7 * http://www.apache.org/licenses/LICENSE-2.0
9 * Unless required by applicable law or agreed to in writing, software
10 * distributed under the License is distributed on an "AS IS" BASIS,
11 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 * See the License for the specific language governing permissions and
13 * limitations under the License.
16 #include <http_static/http_static.h>
18 #include <sys/types.h>
22 /** @file static_server.c
23 * Static http server, sufficient to serve .html / .css / .js content.
25 /*? %%clicmd:group_label Static HTTP Server %% ?*/
27 #define HSS_FIFO_THRESH (16 << 10)
31 static hss_session_t *
32 hss_session_alloc (u32 thread_index)
34 hss_main_t *hsm = &hss_main;
37 pool_get_zero (hsm->sessions[thread_index], hs);
38 hs->session_index = hs - hsm->sessions[thread_index];
39 hs->thread_index = thread_index;
40 hs->cache_pool_index = ~0;
44 static hss_session_t *
45 hss_session_get (u32 thread_index, u32 hs_index)
47 hss_main_t *hsm = &hss_main;
48 if (pool_is_free_index (hsm->sessions[thread_index], hs_index))
50 return pool_elt_at_index (hsm->sessions[thread_index], hs_index);
54 hss_session_free (hss_session_t *hs)
56 hss_main_t *hsm = &hss_main;
58 pool_put (hsm->sessions[hs->thread_index], hs);
62 u32 save_thread_index;
63 save_thread_index = hs->thread_index;
64 /* Poison the entry, preserve timer state and thread index */
65 memset (hs, 0xfa, sizeof (*hs));
66 hs->thread_index = save_thread_index;
70 /** \brief Disconnect a session
73 hss_session_disconnect_transport (hss_session_t *hs)
75 vnet_disconnect_args_t _a = { 0 }, *a = &_a;
76 a->handle = hs->vpp_session_handle;
77 a->app_index = hss_main.app_index;
78 vnet_disconnect_session (a);
82 start_send_data (hss_session_t *hs, http_status_code_t status)
88 ts = session_get (hs->vpp_session_index, hs->thread_index);
90 msg.type = HTTP_MSG_REPLY;
92 msg.content_type = HTTP_CONTENT_TEXT_HTML;
93 msg.data.len = hs->data_len;
95 if (hs->data_len > hss_main.use_ptr_thresh)
97 msg.data.type = HTTP_MSG_DATA_PTR;
98 rv = svm_fifo_enqueue (ts->tx_fifo, sizeof (msg), (u8 *) &msg);
99 ASSERT (rv == sizeof (msg));
101 uword data = pointer_to_uword (hs->data);
102 rv = svm_fifo_enqueue (ts->tx_fifo, sizeof (data), (u8 *) &data);
103 ASSERT (rv == sizeof (sizeof (data)));
108 msg.data.type = HTTP_MSG_DATA_INLINE;
110 rv = svm_fifo_enqueue (ts->tx_fifo, sizeof (msg), (u8 *) &msg);
111 ASSERT (rv == sizeof (msg));
116 rv = svm_fifo_enqueue (ts->tx_fifo, hs->data_len, hs->data);
118 if (rv != hs->data_len)
120 hs->data_offset = rv;
121 svm_fifo_add_want_deq_ntf (ts->tx_fifo, SVM_FIFO_WANT_DEQ_NOTIF);
126 if (svm_fifo_set_event (ts->tx_fifo))
127 session_send_io_evt_to_thread (ts->tx_fifo, SESSION_IO_EVT_TX);
131 hss_session_send_data (hss_url_handler_args_t *args)
135 hs = hss_session_get (args->sh.thread_index, args->sh.session_index);
139 if (hs->data && hs->free_data)
142 hs->data = args->data;
143 hs->data_len = args->data_len;
144 hs->free_data = args->free_vec_data;
145 start_send_data (hs, args->sc);
149 try_url_handler (hss_main_t *hsm, hss_session_t *hs, http_req_method_t rt,
152 http_status_code_t sc = HTTP_STATUS_OK;
153 hss_url_handler_args_t args = {};
154 uword *p, *url_table;
157 if (!hsm->enable_url_handlers || !request)
160 /* Look for built-in GET / POST handlers */
162 (rt == HTTP_REQ_GET) ? hsm->get_url_handlers : hsm->post_url_handlers;
164 p = hash_get_mem (url_table, request);
170 hs->cache_pool_index = ~0;
172 if (hsm->debug_level > 0)
173 clib_warning ("%s '%s'", (rt == HTTP_REQ_GET) ? "GET" : "POST", request);
176 args.request = request;
177 args.sh.thread_index = hs->thread_index;
178 args.sh.session_index = hs->session_index;
180 rv = ((hss_url_handler_fn) p[0]) (&args);
182 /* Wait for data from handler */
183 if (rv == HSS_URL_HANDLER_ASYNC)
186 if (rv == HSS_URL_HANDLER_ERROR)
188 clib_warning ("builtin handler %llx hit on %s '%s' but failed!", p[0],
189 (rt == HTTP_REQ_GET) ? "GET" : "POST", request);
190 sc = HTTP_STATUS_NOT_FOUND;
193 hs->data = args.data;
194 hs->data_len = args.data_len;
195 hs->free_data = args.free_vec_data;
197 start_send_data (hs, sc);
200 hss_session_disconnect_transport (hs);
206 file_path_is_valid (u8 *path)
208 struct stat _sb, *sb = &_sb;
210 if (stat ((char *) path, sb) < 0 /* can't stat the file */
211 || (sb->st_mode & S_IFMT) != S_IFREG /* not a regular file */)
218 try_index_file (hss_main_t *hsm, hss_session_t *hs, u8 *path)
220 u8 *port_str = 0, *redirect;
221 transport_endpoint_t endpt;
222 transport_proto_t proto;
228 /* Remove the trailing space */
229 vec_dec_len (path, 1);
230 plen = vec_len (path);
232 /* Append "index.html" */
233 if (path[plen - 1] != '/')
234 path = format (path, "/index.html%c", 0);
236 path = format (path, "index.html%c", 0);
238 if (hsm->debug_level > 0)
239 clib_warning ("trying to find index: %s", path);
241 if (!file_path_is_valid (path))
242 return HTTP_STATUS_NOT_FOUND;
245 * We found an index.html file, build a redirect
247 vec_delete (path, vec_len (hsm->www_root) - 1, 0);
249 ts = session_get (hs->vpp_session_index, hs->thread_index);
250 session_get_endpoint (ts, &endpt, 1 /* is_local */);
252 local_port = clib_net_to_host_u16 (endpt.port);
253 proto = session_type_transport_proto (ts->session_type);
255 if ((proto == TRANSPORT_PROTO_TCP && local_port != 80) ||
256 (proto == TRANSPORT_PROTO_TLS && local_port != 443))
259 port_str = format (0, ":%u", (u32) local_port);
264 "HTTP/1.1 301 Moved Permanently\r\n"
265 "Location: http%s://%U%s%s\r\n\r\n",
266 proto == TRANSPORT_PROTO_TLS ? "s" : "", format_ip46_address,
267 &endpt.ip, endpt.is_ip4, print_port ? port_str : (u8 *) "", path);
269 if (hsm->debug_level > 0)
270 clib_warning ("redirect: %s", redirect);
275 hs->data_len = vec_len (redirect);
278 return HTTP_STATUS_OK;
282 try_file_handler (hss_main_t *hsm, hss_session_t *hs, http_req_method_t rt,
285 http_status_code_t sc = HTTP_STATUS_OK;
289 /* Feature not enabled */
294 * Construct the file to open
295 * Browsers are capable of sporadically including a leading '/'
298 path = format (0, "%s%c", hsm->www_root, 0);
299 else if (request[0] == '/')
300 path = format (0, "%s%s%c", hsm->www_root, request, 0);
302 path = format (0, "%s/%s%c", hsm->www_root, request, 0);
304 if (hsm->debug_level > 0)
305 clib_warning ("%s '%s'", (rt == HTTP_REQ_GET) ? "GET" : "POST", path);
307 if (hs->data && hs->free_data)
314 hss_cache_lookup_and_attach (&hsm->cache, path, &hs->data, &hs->data_len);
317 if (!file_path_is_valid (path))
319 sc = try_index_file (hsm, hs, path);
323 hss_cache_add_and_attach (&hsm->cache, path, &hs->data, &hs->data_len);
326 sc = HTTP_STATUS_INTERNAL_ERROR;
331 hs->cache_pool_index = ce_index;
335 start_send_data (hs, sc);
337 hss_session_disconnect_transport (hs);
343 handle_request (hss_session_t *hs, http_req_method_t rt, u8 *request)
345 hss_main_t *hsm = &hss_main;
347 if (!try_url_handler (hsm, hs, rt, request))
350 if (!try_file_handler (hsm, hs, rt, request))
353 /* Handler did not find anything return 404 */
354 start_send_data (hs, HTTP_STATUS_NOT_FOUND);
355 hss_session_disconnect_transport (hs);
361 hss_ts_rx_callback (session_t *ts)
368 hs = hss_session_get (ts->thread_index, ts->opaque);
370 /* Read the http message header */
371 rv = svm_fifo_dequeue (ts->rx_fifo, sizeof (msg), (u8 *) &msg);
372 ASSERT (rv == sizeof (msg));
374 if (msg.type != HTTP_MSG_REQUEST ||
375 (msg.method_type != HTTP_REQ_GET && msg.method_type != HTTP_REQ_POST))
378 start_send_data (hs, HTTP_STATUS_METHOD_NOT_ALLOWED);
385 vec_validate (request, msg.data.len - 1);
386 rv = svm_fifo_dequeue (ts->rx_fifo, msg.data.len, request);
387 ASSERT (rv == msg.data.len);
390 /* Find and send data */
391 handle_request (hs, msg.method_type, request);
399 hss_ts_tx_callback (session_t *ts)
405 hs = hss_session_get (ts->thread_index, ts->opaque);
406 if (!hs || !hs->data)
409 to_send = hs->data_len - hs->data_offset;
410 rv = svm_fifo_enqueue (ts->tx_fifo, to_send, hs->data + hs->data_offset);
414 svm_fifo_add_want_deq_ntf (ts->tx_fifo, SVM_FIFO_WANT_DEQ_NOTIF);
420 hs->data_offset += rv;
421 svm_fifo_add_want_deq_ntf (ts->tx_fifo, SVM_FIFO_WANT_DEQ_NOTIF);
424 if (svm_fifo_set_event (ts->tx_fifo))
425 session_send_io_evt_to_thread (ts->tx_fifo, SESSION_IO_EVT_TX);
430 /** \brief Session accept callback
433 hss_ts_accept_callback (session_t *ts)
438 hs = hss_session_alloc (ts->thread_index);
440 hs->vpp_session_index = ts->session_index;
441 hs->vpp_session_handle = session_handle (ts);
443 /* The application sets a threshold for it's fifo to get notified when
444 * additional data can be enqueued. We want to keep the TX fifo reasonably
445 * full, however avoid entering a state where the
446 * fifo is full all the time and small chunks of data are being enqueued
447 * each time. If the fifo is small (under 16K) we set
448 * the threshold to it's size, meaning a notification will be given when the
451 thresh = clib_min (svm_fifo_size (ts->tx_fifo), HSS_FIFO_THRESH);
452 svm_fifo_set_deq_thresh (ts->tx_fifo, thresh);
454 ts->opaque = hs->session_index;
455 ts->session_state = SESSION_STATE_READY;
460 hss_ts_disconnect_callback (session_t *ts)
462 hss_main_t *hsm = &hss_main;
463 vnet_disconnect_args_t _a = { 0 }, *a = &_a;
465 a->handle = session_handle (ts);
466 a->app_index = hsm->app_index;
467 vnet_disconnect_session (a);
471 hss_ts_reset_callback (session_t *ts)
473 hss_main_t *hsm = &hss_main;
474 vnet_disconnect_args_t _a = { 0 }, *a = &_a;
476 a->handle = session_handle (ts);
477 a->app_index = hsm->app_index;
478 vnet_disconnect_session (a);
482 hss_ts_connected_callback (u32 app_index, u32 api_context, session_t *ts,
485 clib_warning ("called...");
490 hss_add_segment_callback (u32 client_index, u64 segment_handle)
496 hss_ts_cleanup (session_t *s, session_cleanup_ntf_t ntf)
498 hss_main_t *hsm = &hss_main;
501 if (ntf == SESSION_CLEANUP_TRANSPORT)
504 hs = hss_session_get (s->thread_index, s->opaque);
508 if (hs->cache_pool_index != ~0)
510 hss_cache_detach_entry (&hsm->cache, hs->cache_pool_index);
511 hs->cache_pool_index = ~0;
521 hss_session_free (hs);
524 static session_cb_vft_t hss_cb_vft = {
525 .session_accept_callback = hss_ts_accept_callback,
526 .session_disconnect_callback = hss_ts_disconnect_callback,
527 .session_connected_callback = hss_ts_connected_callback,
528 .add_segment_callback = hss_add_segment_callback,
529 .builtin_app_rx_callback = hss_ts_rx_callback,
530 .builtin_app_tx_callback = hss_ts_tx_callback,
531 .session_reset_callback = hss_ts_reset_callback,
532 .session_cleanup_callback = hss_ts_cleanup,
538 vnet_app_add_cert_key_pair_args_t _ck_pair, *ck_pair = &_ck_pair;
539 hss_main_t *hsm = &hss_main;
540 u64 options[APP_OPTIONS_N_OPTIONS];
541 vnet_app_attach_args_t _a, *a = &_a;
542 u32 segment_size = 128 << 20;
544 clib_memset (a, 0, sizeof (*a));
545 clib_memset (options, 0, sizeof (options));
547 if (hsm->private_segment_size)
548 segment_size = hsm->private_segment_size;
550 a->api_client_index = ~0;
551 a->name = format (0, "http_static_server");
552 a->session_cb_vft = &hss_cb_vft;
553 a->options = options;
554 a->options[APP_OPTIONS_SEGMENT_SIZE] = segment_size;
555 a->options[APP_OPTIONS_ADD_SEGMENT_SIZE] = segment_size;
556 a->options[APP_OPTIONS_RX_FIFO_SIZE] =
557 hsm->fifo_size ? hsm->fifo_size : 8 << 10;
558 a->options[APP_OPTIONS_TX_FIFO_SIZE] =
559 hsm->fifo_size ? hsm->fifo_size : 32 << 10;
560 a->options[APP_OPTIONS_FLAGS] = APP_OPTIONS_FLAGS_IS_BUILTIN;
561 a->options[APP_OPTIONS_PREALLOC_FIFO_PAIRS] = hsm->prealloc_fifos;
562 a->options[APP_OPTIONS_TLS_ENGINE] = CRYPTO_ENGINE_OPENSSL;
564 if (vnet_application_attach (a))
567 clib_warning ("failed to attach server");
571 hsm->app_index = a->app_index;
573 clib_memset (ck_pair, 0, sizeof (*ck_pair));
574 ck_pair->cert = (u8 *) test_srv_crt_rsa;
575 ck_pair->key = (u8 *) test_srv_key_rsa;
576 ck_pair->cert_len = test_srv_crt_rsa_len;
577 ck_pair->key_len = test_srv_key_rsa_len;
578 vnet_app_add_cert_key_pair (ck_pair);
579 hsm->ckpair_index = ck_pair->index;
585 hss_transport_needs_crypto (transport_proto_t proto)
587 return proto == TRANSPORT_PROTO_TLS || proto == TRANSPORT_PROTO_DTLS ||
588 proto == TRANSPORT_PROTO_QUIC;
594 hss_main_t *hsm = &hss_main;
595 session_endpoint_cfg_t sep = SESSION_ENDPOINT_CFG_NULL;
596 vnet_listen_args_t _a, *a = &_a;
597 char *uri = "tcp://0.0.0.0/80";
601 clib_memset (a, 0, sizeof (*a));
602 a->app_index = hsm->app_index;
605 uri = (char *) hsm->uri;
607 if (parse_uri (uri, &sep))
610 need_crypto = hss_transport_needs_crypto (sep.transport_proto);
612 sep.transport_proto = TRANSPORT_PROTO_HTTP;
613 clib_memcpy (&a->sep_ext, &sep, sizeof (sep));
617 session_endpoint_alloc_ext_cfg (&a->sep_ext,
618 TRANSPORT_ENDPT_EXT_CFG_CRYPTO);
619 a->sep_ext.ext_cfg->crypto.ckpair_index = hsm->ckpair_index;
622 rv = vnet_listen (a);
625 clib_mem_free (a->sep_ext.ext_cfg);
631 hss_url_handlers_init (hss_main_t *hsm)
633 if (!hsm->get_url_handlers)
635 hsm->get_url_handlers = hash_create_string (0, sizeof (uword));
636 hsm->post_url_handlers = hash_create_string (0, sizeof (uword));
639 hss_builtinurl_json_handlers_init ();
643 hss_create (vlib_main_t *vm)
645 vlib_thread_main_t *vtm = vlib_get_thread_main ();
646 hss_main_t *hsm = &hss_main;
649 num_threads = 1 /* main thread */ + vtm->n_threads;
650 vec_validate (hsm->sessions, num_threads - 1);
654 clib_warning ("failed to attach server");
659 clib_warning ("failed to start listening");
664 hss_cache_init (&hsm->cache, hsm->cache_size, hsm->debug_level);
666 if (hsm->enable_url_handlers)
667 hss_url_handlers_init (hsm);
672 static clib_error_t *
673 hss_create_command_fn (vlib_main_t *vm, unformat_input_t *input,
674 vlib_cli_command_t *cmd)
676 unformat_input_t _line_input, *line_input = &_line_input;
677 hss_main_t *hsm = &hss_main;
678 clib_error_t *error = 0;
682 if (hsm->app_index != (u32) ~0)
683 return clib_error_return (0, "http server already running...");
685 hsm->prealloc_fifos = 0;
686 hsm->private_segment_size = 0;
688 hsm->cache_size = 10 << 20;
690 /* Get a line of input. */
691 if (!unformat_user (input, unformat_line_input, line_input))
694 while (unformat_check_input (line_input) != UNFORMAT_END_OF_INPUT)
696 if (unformat (line_input, "www-root %s", &hsm->www_root))
699 if (unformat (line_input, "prealloc-fifos %d", &hsm->prealloc_fifos))
701 else if (unformat (line_input, "private-segment-size %U",
702 unformat_memory_size, &seg_size))
703 hsm->private_segment_size = seg_size;
704 else if (unformat (line_input, "fifo-size %d", &hsm->fifo_size))
705 hsm->fifo_size <<= 10;
706 else if (unformat (line_input, "cache-size %U", unformat_memory_size,
709 else if (unformat (line_input, "uri %s", &hsm->uri))
711 else if (unformat (line_input, "debug %d", &hsm->debug_level))
713 else if (unformat (line_input, "debug"))
714 hsm->debug_level = 1;
715 else if (unformat (line_input, "ptr-thresh %U", unformat_memory_size,
716 &hsm->use_ptr_thresh))
718 else if (unformat (line_input, "url-handlers"))
719 hsm->enable_url_handlers = 1;
722 error = clib_error_return (0, "unknown input `%U'",
723 format_unformat_error, line_input);
728 unformat_free (line_input);
735 if (hsm->www_root == 0 && !hsm->enable_url_handlers)
737 error = clib_error_return (0, "Must set www-root or url-handlers");
741 if (hsm->cache_size < (128 << 10))
743 error = clib_error_return (0, "cache-size must be at least 128kb");
744 vec_free (hsm->www_root);
748 vnet_session_enable_disable (vm, 1 /* turn on TCP, etc. */ );
750 if ((rv = hss_create (vm)))
752 error = clib_error_return (0, "server_create returned %d", rv);
753 vec_free (hsm->www_root);
762 * Enable the static http server
765 * This command enables the static http server. Only the www-root
766 * parameter is required
768 * http static server www-root /tmp/www uri tcp://0.0.0.0/80 cache-size 2m
770 * @cliexcmd{http static server www-root <path> [prealloc-fios <nn>]
771 * [private-segment-size <nnMG>] [fifo-size <nbytes>] [uri <uri>]}
773 VLIB_CLI_COMMAND (hss_create_command, static) = {
774 .path = "http static server",
776 "http static server www-root <path> [prealloc-fifos <nn>]\n"
777 "[private-segment-size <nnMG>] [fifo-size <nbytes>] [uri <uri>]\n"
778 "[ptr-thresh <nn>] [url-handlers] [debug [nn]]\n",
779 .function = hss_create_command_fn,
783 format_hss_session (u8 *s, va_list *args)
785 hss_session_t *hs = va_arg (*args, hss_session_t *);
786 int __clib_unused verbose = va_arg (*args, int);
788 s = format (s, "\n path %s, data length %u, data_offset %u",
789 hs->path ? hs->path : (u8 *) "[none]", hs->data_len,
794 static clib_error_t *
795 hss_show_command_fn (vlib_main_t *vm, unformat_input_t *input,
796 vlib_cli_command_t *cmd)
798 int verbose = 0, show_cache = 0, show_sessions = 0;
799 hss_main_t *hsm = &hss_main;
801 if (hsm->www_root == 0)
802 return clib_error_return (0, "Static server disabled");
804 while (unformat_check_input (input) != UNFORMAT_END_OF_INPUT)
806 if (unformat (input, "verbose %d", &verbose))
808 else if (unformat (input, "verbose"))
810 else if (unformat (input, "cache"))
812 else if (unformat (input, "sessions"))
818 if ((show_cache + show_sessions) == 0)
819 return clib_error_return (0, "specify one or more of cache, sessions");
822 vlib_cli_output (vm, "%U", format_hss_cache, &hsm->cache, verbose);
826 u32 *session_indices = 0;
831 for (i = 0; i < vec_len (hsm->sessions); i++)
833 pool_foreach (hs, hsm->sessions[i])
834 vec_add1 (session_indices, hs - hsm->sessions[i]);
836 for (j = 0; j < vec_len (session_indices); j++)
839 vm, "%U", format_hss_session,
840 pool_elt_at_index (hsm->sessions[i], session_indices[j]),
843 vec_reset_length (session_indices);
845 vec_free (session_indices);
851 * Display static http server cache statistics
854 * This command shows the contents of the static http server cache
856 * show http static server
858 * @cliexcmd{show http static server sessions cache [verbose [nn]]}
860 VLIB_CLI_COMMAND (hss_show_command, static) = {
861 .path = "show http static server",
862 .short_help = "show http static server sessions cache [verbose [<nn>]]",
863 .function = hss_show_command_fn,
866 static clib_error_t *
867 hss_clear_cache_command_fn (vlib_main_t *vm, unformat_input_t *input,
868 vlib_cli_command_t *cmd)
870 hss_main_t *hsm = &hss_main;
873 if (hsm->www_root == 0)
874 return clib_error_return (0, "Static server disabled");
876 busy_items = hss_cache_clear (&hsm->cache);
879 vlib_cli_output (vm, "Note: %d busy items still in cache...", busy_items);
881 vlib_cli_output (vm, "Cache cleared...");
886 * Clear the static http server cache, to force the server to
887 * reload content from backing files
890 * This command clear the static http server cache
892 * clear http static cache
894 * @cliexcmd{clear http static cache}
896 VLIB_CLI_COMMAND (clear_hss_cache_command, static) = {
897 .path = "clear http static cache",
898 .short_help = "clear http static cache",
899 .function = hss_clear_cache_command_fn,
902 static clib_error_t *
903 hss_main_init (vlib_main_t *vm)
905 hss_main_t *hsm = &hss_main;
913 VLIB_INIT_FUNCTION (hss_main_init);
916 * fd.io coding-style-patch-verification: ON
919 * eval: (c-set-style "gnu")