---
name: "TSHttpTxnPostBufferReaderGet"
section: "3ts"
platform: "linux"
package: "trafficserver-dev"
version: "9.2.5+ds-0+deb12u4"
release: "Debian 12 (Bookworm)"
platforms: ["linux"]
url: "https://new.carta.tech/TSHttpTxnPostBufferReaderGet"
---

# TSHttpTxnPostBufferReaderGet(3ts)

TSHttpTxnPostBufferReaderGet API function

## NAME

TSHttpTxnPostBufferReaderGet - TSHttpTxnPostBufferReaderGet API function

## SYNOPSIS

```
#include <ts/ts.h>
```

- ***TSIOBufferReader* TSHttpTxnPostBufferReaderGet(*TSHttpTxn* txnp)**

  ## DESCRIPTION

Retrieve the client request body for the transaction referenced by *txnp*. The body is read from via the returned *TSIOBufferReader*. The returned *TSIOBufferReader* is owned by the caller and the caller must free it via *TSIOBufferReaderFree()*. This function should be used in the handler for *TS\_HTTP\_REQUEST\_BUFFER\_READ\_COMPLETE\_HOOK*. The following example handler makes use of *TSHttpTxnPostBufferReaderGet()*.

```
int
CB_Read_Request_Body_Hook(TSCont contp, TSEvent event, void* data) {
  ink_assert(event == TS_EVENT_HTTP_REQUEST_BUFFER_COMPLETE);
  auto txnp = reinterpret_cast<TSHttpTxn>(data);
  TSIOBufferReader post_buffer_reader = TSHttpTxnPostBufferReaderGet(txnp);
  int64_t read_avail                  = TSIOBufferReaderAvail(post_buffer_reader);
  if (read_avail > 0) {
    char *body_bytes = reinterpret_cast<char *>(TSmalloc(sizeof(char) * read_avail));
    int64_t consumed      = 0;
    TSIOBufferBlock block = TSIOBufferReaderStart(post_buffer_reader);
    while (block != NULL) {
      int64_t data_len        = 0;
      const char *block_bytes = TSIOBufferBlockReadStart(block, post_buffer_reader, &data_len);
      memcpy(body_bytes + consumed, block_bytes, data_len);
      consumed += data_len;
      block = TSIOBufferBlockNext(block);
    }
    // Now do something with body_bytes which contains the contents of the
    // request's body.
  }
  // Remember to free the TSIOBufferReader.
  TSIOBufferReaderFree(post_buffer_reader);
  TSHttpTxnReenable(txnp);
  return 0;
}
```

*example/plugins/c-api/request\_buffer/request\_buffer.c* is a simple yet complete plugin that accesses HTTP request bodies.

## COPYRIGHT

2026, dev@trafficserver.apache.org