Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
49 changes: 13 additions & 36 deletions abi-versions/vNEXT/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -766,7 +766,7 @@ Returned `status` value is:
and/or `value_size` point to invalid memory address.


#### `proxy_replace_header_map_value`
#### `proxy_set_header_map_value`

* params:
- `i32 (uint32_t) stream_context_id`
Expand All @@ -782,6 +782,9 @@ Adds or replaces key's (`key_data`, `key_value`) value with the provided
value (`value_data`, `value_size`) in the map `map_id` of HTTP request
`stream_context_id`.

If the `value_data` is `0`, then the key (`key_data`, `key_size`) will be
removed from the map `map_id`.

Returned `status` value is:
- `OK` on success.
- `UNKNOWN_RESOURCE_ID` for unknown `stream_context_id`.
Expand All @@ -790,27 +793,6 @@ Returned `status` value is:
and/or `value_size` point to invalid memory address.


#### `proxy_remove_header_map_value`

* params:
- `i32 (uint32_t) stream_context_id`
- `i32 (`[`proxy_map_type_t`]`) map_id`
- `i32 (const char *) key_data`
- `i32 (size_t) key_size`
* returns:
- `i32 (`[`proxy_status_t`]`) status`

Removes the key (`key_data`, `key_value`) from the map `map_id` of HTTP request
`stream_context_id`.

Returned `status` value is:
- `OK` on success (including the case when the requested key didn't exist).
- `UNKNOWN_RESOURCE_ID` for unknown `stream_context_id`.
- `BAD_ARGUMENT` for unknown `map_id`.
- `INVALID_MEMORY_ACCESS` when `key_data` and/or `key_size` point to
invalid memory address.


## Common HTTP and TCP stream operations

### Functions exposed by the host
Expand Down Expand Up @@ -1012,9 +994,8 @@ All `num_headers` headers can be retrieved and/or modified using
with `map_id` set to `HTTP_REQUEST_HEADERS`.

Individual HTTP request headers can be retrieved and/or modified using
[`proxy_get_header_map_value`], [`proxy_replace_header_map_value`],
[`proxy_add_header_map_value`] and/or [`proxy_remove_header_map_value`]
with `map_id` set to `HTTP_REQUEST_HEADERS`.
[`proxy_get_header_map_value`], [`proxy_set_header_map_value`] and/or
[`proxy_add_header_map_value`] with `map_id` set to `HTTP_REQUEST_HEADERS`.

Paused HTTP requests can be resumed using [`proxy_continue_stream`]
or closed using [`proxy_close_stream`] with `stream_type` set to
Expand Down Expand Up @@ -1075,9 +1056,8 @@ All `num_trailers` trailers can be retrieved and/or modified using
with `map_id` set to `HTTP_REQUEST_TRAILERS`.

Individual HTTP request trailers can be retrieved and/or modified using
[`proxy_get_header_map_value`], [`proxy_replace_header_map_value`],
[`proxy_add_header_map_value`] and/or [`proxy_remove_header_map_value`]
with `map_id` set to `HTTP_REQUEST_TRAILERS`.
[`proxy_get_header_map_value`], [`proxy_set_header_map_value`] and/or
[`proxy_add_header_map_value`] with `map_id` set to `HTTP_REQUEST_TRAILERS`.

Paused HTTP requests can be resumed using [`proxy_continue_stream`]
or closed using [`proxy_close_stream`] with `stream_type` set to
Expand Down Expand Up @@ -1107,9 +1087,8 @@ All `num_headers` headers can be retrieved and/or modified using
with `map_id` set to `HTTP_RESPONSE_HEADERS`.

Individual headers can be retrieved and/or modified using
[`proxy_get_header_map_value`], [`proxy_replace_header_map_value`],
[`proxy_add_header_map_value`] and/or [`proxy_remove_header_map_value`]
with `map_id` set to `HTTP_RESPONSE_HEADERS`.
[`proxy_get_header_map_value`], [`proxy_set_header_map_value`] and/or
[`proxy_add_header_map_value`] with `map_id` set to `HTTP_RESPONSE_HEADERS`.

Paused HTTP requests can be resumed using [`proxy_continue_stream`]
or closed using [`proxy_close_stream`] with `stream_type` set to
Expand Down Expand Up @@ -1167,9 +1146,8 @@ All `num_trailers` trailers can be retrieved and/or modified using
with `map_id` set to `HTTP_RESPONSE_TRAILERS`.

Individual trailers can be retrieved and/or modified using
[`proxy_get_header_map_value`], [`proxy_replace_header_map_value`],
[`proxy_add_header_map_value`] and/or [`proxy_remove_header_map_value`]
with `map_id` set to `HTTP_RESPONSE_TRAILERS`.
[`proxy_get_header_map_value`], [`proxy_set_header_map_value`] and/or
[`proxy_add_header_map_value`] with `map_id` set to `HTTP_RESPONSE_TRAILERS`.

Paused HTTP requests can be resumed using [`proxy_continue_stream`]
or closed using [`proxy_close_stream`] with `stream_type` set to
Expand Down Expand Up @@ -2234,9 +2212,8 @@ changes to unrelated connections/requests.
[`proxy_get_header_map_pairs`]: #proxy_get_header_map_pairs
[`proxy_set_header_map_pairs`]: #proxy_set_header_map_pairs
[`proxy_get_header_map_value`]: #proxy_get_header_map_value
[`proxy_set_header_map_value`]: #proxy_set_header_map_value
[`proxy_add_header_map_value`]: #proxy_add_header_map_value
[`proxy_replace_header_map_value`]: #proxy_replace_header_map_value
[`proxy_remove_header_map_value`]: #proxy_remove_header_map_value
[`proxy_continue_stream`]: #proxy_continue_stream
[`proxy_close_stream`]: #proxy_close_stream
[`proxy_on_new_connection`]: #proxy_on_new_connection
Expand Down