---
name: "table-socketmap"
section: "5"
platform: "linux"
package: "opensmtpd-table-socketmap"
version: "1.1.1-1+b1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/table-socketmap"
---

# table-socketmap(5)

format description for smtpd socketmap tables

## NAME

**table\_socketmap** – format description for smtpd socketmap tables

## DESCRIPTION

This manual page documents the file format of "socketmap" tables used by the [smtpd(8)](/smtpd/8.md) mail daemon.

The format described here applies to tables as defined in [smtpd.conf(5)](/smtpd.conf/5.md).

## SOCKETMAP TABLE

A "socketmap" table uses a simple protocol. The client sends a single-line request and the server sends a single-line reply.

The table may be used for any kind of key-based lookup and replies are expected to follow the formats described in [table(5)](/table/5.md).

## SEE ALSO

[smtpd.conf(5)](/smtpd.conf/5.md), [table(5)](/table/5.md), [smtpctl(8)](/smtpctl/8.md), [smtpd(8)](/smtpd/8.md)

## HISTORY

The first version of **table\_socketmap** was written in 2014. It was converted to the stdio table protocol in 2024.

## AUTHORS

**table\_socketmap** was initially written by Gilles Chehade ⟨*gilles@poolp.org*⟩. The conversion to the stdio protocol was done by Omar Polo ⟨*op@openbsd.org*⟩.