i2c_master_recv(9)

🌸 NAME 🌸

Okay bestie, this is i2c_master_recv(9) from the Kernel API Manual 💖 — it’s the page for issue a single I2C message in master receive mode, and we’re gonna make it make sense. periodt ✨

✨ SYNOPSIS ✨

int i2c_master_recv (const struct i2c_client *client , char *buf , int count );

🎀 ARGUMENTS 🎀

• client — handle to the slave device, aka your lil device bestie you’re talking to 🫶
• buf — where to store data read from the slave; this is the treasure chest for the bytes 💖
• count — how many bytes to read. It must be less than 64k, because msg.len is u16 — no cap, that’s just the limit 😭

🦋 DESCRIPTION 🦋

The return is literally: negative errno, or else the number of bytes read. That’s the whole vibe check 😭✨

So: negative errno = not today; otherwise = the byte count, periodt 💅

👑 SEE ALSO 👑

Kernel file: ./include/linux/i2c.h 📁

• i2c_master_recv_dmasafe(9)
• i2c_master_send(9)
• i2c_master_send_dmasafe(9)
• struct i2c_device_identity(9)
• enum i2c_driver_flags(9)
• struct i2c_driver(9)
• struct i2c_client(9)
• struct i2c_board_info(9)
• I2C_BOARD_INFO(9)
• struct i2c_algorithm(9)
• struct i2c_lock_operations(9)
• struct i2c_timings(9)
• struct i2c_bus_recovery_info(9)
• struct i2c_adapter_quirks(9)
• i2c_lock_bus(9)
• i2c_trylock_bus(9)
• i2c_unlock_bus(9)
• i2c_mark_adapter_suspended(9)
• i2c_mark_adapter_resumed(9)
• i2c_check_quirks(9)
• module_i2c_driver(9)
• builtin_i2c_driver(9)

Byeee 🫶 — source/version is ./include/linux, the date is October 2026, and this iconic page is i2c_master_recv(9). Stay slay 💅✨