libnvme\_get\_telemetry\_log(9) libnvme API manual libnvme\_get\_telemetry\_log(9)

# [NAME](#NAME)

libnvme\_get\_telemetry\_log - Get specified telemetry log

# [SYNOPSIS](#SYNOPSIS)

**int libnvme\_get\_telemetry\_log** **(struct libnvme\_transport\_handle \*hdl ,** **bool create ,** **bool ctrl ,** **bool rae ,** **size\_t max\_data\_tx ,** **enum nvme\_telemetry\_da da ,** **struct nvme\_telemetry\_log \*\*log ,** **size\_t \*size );**

# [ARGUMENTS](#ARGUMENTS)

[hdl](#hdl)

Transport handle

[create](#create)

Generate new host initated telemetry capture

[ctrl](#ctrl)

Get controller Initiated log

[rae](#rae)

Retain asynchronous events

[max\_data\_tx](#max_data_tx)

Set the max data transfer size to be used retrieving telemetry.

[da](#da)

Log page data area, valid values: *enum nvme\_telemetry\_da*.

[log](#log)

On success, set to the value of the allocated and retrieved log.

[size](#size)

Ptr to the telemetry log size, so it can be returned

# [DESCRIPTION](#DESCRIPTION)

The total size allocated can be calculated as: (nvme\_telemetry\_log da size + 1) * NVME\_LOG\_TELEM\_BLOCK\_SIZE.

# [RETURN](#RETURN)

0 on success, the nvme command status if a response was received (see *enum nvme\_status\_field*) or a negative error otherwise.

libnvme\_get\_telemetry\_log September 2026

---

Document: libnvme_get_telemetry_log-libnvme3(2) from nvme-cli 3.1-r0 (Chainguard OS)
Source: https://github.com/linux-nvme/nvme-cli