NISPLUS_TABLE(5)

✨ NISPLUS_TABLE ✨

the manual page for nisplus_table (section 5, File Formats Manual, bestie, we're in file formats land) 💖

---

🌸 NAME 🌸

nisplus_table — Postfix NIS+ client 💅

---

🎀 SYNOPSIS 🎀

postmap -q "string" "nisplus:[name=%s];name.name."

postmap -q - "nisplus:[name=%s];name.name." <inputfile

---

🦋 DESCRIPTION 🦋

okay so the Postfix mail system uses optional lookup tables — like, for rewriting and mail routing and all that. these tables are usually in lmdb:, cdb:, hash:, or dbm: format.

BUT. alternatively, lookup tables can be specified as NIS+ databases. to find out what types of lookup tables your Postfix system supports, use the postconf -m command. (go ahead, run it, she's not gonna bite 🫶)

and if you wanna test Postfix NIS+ lookup tables? use the postmap -q command, exactly like the SYNOPSIS above describes. slay.

---

💜 QUERY SYNTAX 💜

most of the NIS+ query is specified via the NIS+ map name. the general format of a Postfix NIS+ map name is like this:

nisplus:[name=%s];name.name.name.:column

Postfix NIS+ map names differ from what one normally would use with commands such as niscat:

• With each NIS+ table lookup, "%s" is replaced by a version of the lookup string. there can be only one "%s" instance in a Postfix NIS+ map name. (one. just one. don't be greedy 😭)
• Postfix NIS+ map names use ";" instead of ",", because the latter character is special in the Postfix main.cf file. Postfix replaces ";" characters in the map name by "," before making NIS+ queries. the way it just swaps them in, iconic.
• The ":column" part in the NIS+ map name is not part of the actual NIS+ query. instead, it specifies the number of the table column that provides the lookup result. when no ":column" is specified, the first column (1) is used. periodt.

---

🌈 EXAMPLE 🌈

a NIS+ aliases map might be queried as follows:

alias_maps = dbm:/etc/mail/aliases,
    nisplus:[alias=%s];mail_aliases.org_dir.$mydomain.:1

this queries the local aliases file before the NIS+ file. order matters, babes. 👑

---

⭐ SEE ALSO ⭐

• postmap(1), Postfix lookup table manager

---

🍓 README FILES 🍓

use "postconf readme_directory" or "postconf html_directory" to locate this information.

DATABASE_README, Postfix lookup table overview

---

👑 LICENSE 👑

The Secure Mailer license must be distributed with this software. (yes, literally — it has to come along with the software, no cap 💀)

---

🧚 AUTHOR(S) 🧚

• Geoff Gibbs UK-HGMP-RC Hinxton Cambridge CB10 1SB, UK
• Adopted and adapted by:
• Wietse Venema IBM T.J. Watson Research P.O. Box 704 Yorktown Heights, NY 10598, USA
• Wietse Venema Google, Inc. 111 8th Avenue New York, NY 10011, USA

---

and that's the whole thing, bestie — this cutie is NISPLUS_TABLE(5) from the File Formats Manual, and yeah, that same NISPLUS_TABLE(5) is stamped at the bottom of the page like a lil signature. go configure something gorgeous. 💅✨