---
name: "modbus_write_register"
section: "3"
platform: "linux"
package: "libmodbus-dev"
version: "3.1.6-2.1"
release: "Debian 12 (Bookworm)"
platforms: ["linux"]
url: "https://new.carta.tech/modbus_write_register"
---

# modbus\_write\_register(3)

write a single register

## NAME

modbus\_write\_register - write a single register

## SYNOPSIS

**int modbus\_write\_register(modbus\_t \****ctx***, int** *addr***, const uint16\_t** *value***);**

## DESCRIPTION

The **modbus\_write\_register()** function shall write the value of *value* holding registers at the address *addr* of the remote device.

The function uses the Modbus function code 0x06 (preset single register).

## RETURN VALUE

The function shall return 1 if successful. Otherwise it shall return -1 and set errno.

## SEE ALSO

[**modbus\_read\_registers**(3)](/modbus_read_registers/3.md) [**modbus\_write\_registers**(3)](/modbus_write_registers/3.md)

## AUTHORS

The libmodbus documentation was written by Stéphane Raimbault \<stephane.raimbault@gmail.com\>