SYMPA_TEST_LDAP(1)

💖 NAME 💖

okay so bestie, welcome to sympa_test_ldap — and also sympa_test_ldap.pl, same girl, different name tag. this is the lil tool that lets you test an LDAP connection for Sympa. that's the whole job. it's giving "poke the LDAP server and see if it pokes back" 🦋

---

✨ SYNOPSIS ✨

here's the whole menu of how you can call her, exactly as written, no cap:

sympa_test_ldap.pl --filter=string --host=string --suffix=string
[ --attrs=[ string,...|* ] ]
[ --bind_dn=string [ --bind_password=string ] ]
[ --port=string ] [ --scope=base|one|sub ]
[ --use_tls=starttls|ldaps|none
  [ --ca_file=string ] [ --ca_path=string ]
  [ --ca_verify=none|optional|require ]
  [ --ssl_cert=string ] [ --ssl_ciphers=string ] [ --ssl_key=string ]
  [ --ssl_version=sslv2|sslv3|tlsv1|tlsv1_1|tlsv1_2|tlsv1_3 ] ]

sympa_test_ldap.pl --help

sympa_test_ldap.pl --version

so like, the first three — --filter, --host, --suffix — are not in brackets, which means they're the mandatory trio. the rest are all optional lil extras in square brackets. and yeah, --bind_password is nested inside --bind_dn's brackets, and the whole TLS family is nested inside --use_tls. nesting is real, respect the nesting. 🫶

let's break down every single one, because you deserve to know:

• --filter=string — the LDAP search filter. give her a string. required, no skipping.
• --host=string — where the LDAP server lives. string. required.
• --suffix=string — the search suffix. string. required. yes bestie, all three, every time.
• --attrs=[ string,...|* ] — which attributes you want back. either a comma-separated list of strings, or just * for the whole slay buffet.
• --bind_dn=string — the DN you're binding as. optional, and it's the parent of the next one.
• --bind_password=string — the password for that bind DN. only really makes sense hanging off --bind_dn.
• --port=string — the port, as a string. yes, a string. that's what it says. 💅
• --scope=base|one|sub — how deep the search goes. pick exactly one of base, one or sub.
• --use_tls=starttls|ldaps|none — the TLS vibe check. pick one of starttls, ldaps or none. everything below only applies when you're in here.
  • --ca_file=string — path to a CA file, as a string.
  • --ca_path=string — path to a CA directory, as a string.
  • --ca_verify=none|optional|require — how hard you want the cert checked. one of none, optional or require.
  • --ssl_cert=string — the SSL cert, as a string.
  • --ssl_ciphers=string — the cipher list, as a string.
  • --ssl_key=string — the SSL key, as a string.
  • --ssl_version=sslv2|sslv3|tlsv1|tlsv1_1|tlsv1_2|tlsv1_3 — which protocol version to speak. one of sslv2, sslv3, tlsv1, tlsv1_1, tlsv1_2, tlsv1_3. (and yes, the old ones are on that list, we don't make the rules 😭)
• --help — she tells you how to use her. that's it, that's the whole line.
• --version — she tells you who she is. main character energy, honestly. 👑

---

🌸 DESCRIPTION 🌸

so what does sympa_test_ldap.pl actually do, bestie? she tests the LDAP connection and the search operation using the LDAP driver of Sympa. that's the tea. she uses Sympa's own LDAP driver to do it — not some random other thing — so you're testing the exact vibe your actual Sympa is gonna have. 🧚

---

💜 SEE ALSO 💜

• Sympa::DatabaseDriver::LDAP — go read that one too, iykyk. it's the driver doing the heavy lifting behind the scenes. 🎀

---

📜 HISTORY 📜

the lore, because you gotta know your roots:

• testldap.pl got renamed to sympa_test_ldap.pl back on Sympa 6.2. glow-up era. ✨
• the --use_ssl and --use_start_tls options were obsoleted by Sympa 6.2.15. rest in peace, girlies. 🪦
• instead, you use --use_tls. that's the one now. periodt. 💅

---

fr fr, don't go reaching for --use_ssl or --use_start_tls — they've been obsoleted since Sympa 6.2.15. --use_tls is the moment. 💖

okay and that's the whole page, bestie — this was sympa version 6.2.70, dated 2026-07-13, and yes, that's the manual page SYMPA_TEST_LDAP(1). go forth and test those connections. slay. 🌈💖✨