From f42d0c6ef956d119e8762a3ecda37886fa055637 Mon Sep 17 00:00:00 2001 From: Garrett D'Amore Date: Sun, 5 Jan 2025 16:46:03 -0800 Subject: http: server callback API simplified This simplified API lets callbacks obtain the response from the connection objection directly, and does not require the aio to carry it as a parameter. Further, the request and response are both stored inline in the connection, reducing allocations. This is at present only for the server; the client will get a similar set of changes. --- docs/man/nng_http_conn_read_req.3http.adoc | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) (limited to 'docs/man/nng_http_conn_read_req.3http.adoc') diff --git a/docs/man/nng_http_conn_read_req.3http.adoc b/docs/man/nng_http_conn_read_req.3http.adoc index 01d790cc..4a8d3e05 100644 --- a/docs/man/nng_http_conn_read_req.3http.adoc +++ b/docs/man/nng_http_conn_read_req.3http.adoc @@ -1,6 +1,6 @@ = nng_http_conn_read_req(3http) // -// Copyright 2018 Staysail Systems, Inc. +// Copyright 2025 Staysail Systems, Inc. // Copyright 2018 Capitar IT Group BV // // This document is supplied under the terms of the MIT License, a @@ -20,15 +20,15 @@ nng_http_conn_read_req - read HTTP request #include #include -void nng_http_conn_read_req(nng_http_conn *conn, nng_http_req *req, - nng_aio *aio); +void nng_http_conn_read_req(nng_http_conn *conn, nng_aio *aio); ---- == DESCRIPTION The `nng_http_conn_read_req()` function starts an asynchronous read from the -HTTP connection _conn_, reading an HTTP request into the _req_, including all -of the related headers. +HTTP connection _conn_, reading an HTTP request into the request object +associated with _conn_, including all of the related headers. +(The request object can be obtained via `nng_http_conn_req()`. NOTE: Any HTTP entity/body data associated with the request is *not* read automatically. -- cgit v1.2.3-70-g09d2