LDAP_PARSE_VLV_CONTROL(3)

💖 NAME 💖

Okay bestie, this is LDAP_PARSE_VLV_CONTROL(3), a Library Functions Manual page — and it's all about ldap_parse_vlv_control: decode the information returned from a search operation that used a VLV (virtual list view) control. That's the vibe. ✨

📚 LIBRARY 📚

OpenLDAP LDAP — libldap, -lldap. That's where this icon lives. 👑

🛠️ SYNOPSIS 🛠️

#include <ldap.h>

int ldap_parse_vlv_control( ld, ctrlp, target_posp, list_countp, contextp, errcodep )
LDAP *ld;
LDAPControl **ctrlp;
unsigned long *target_posp, *list_countp;
struct berval **contextp;
int *errcodep;

🦋 DESCRIPTION 🦋

ldap_parse_vlv_control is used to decode the information returned from a search operation that used a VLV (virtual list view) control. It takes a null terminated array of LDAPControl structures, usually obtained by a call to the ldap_parse_resultfunction — and yes, bestie, that's exactly how the page spells it, no space between ldap_parse_result and function. Iykyk. 😭

• target_posp — the page calls it target_pos in the prose, and it points to the list index of the target entry. If this parameter is NULL, the target position is not returned. The index returned is an approximation of the position of the target entry. It is not guaranteed to be exact. Highkey important, no cap. 🎯
• list_countp — points to the server's estimate of the size of the list. If this parameter is NULL, the size is not returned. 📏
• contextp — a pointer to the address of a berval structure that contains a server-generated context identifier if the server returns one. If the server does not return a context identifier, the server returns a NULL in this parameter. If this parameter is set to NULL, the context identifier is not returned. You should use this returned context in the next call to create a VLV control. When the berval structure is no longer needed, you should free the memory by calling the ber_bvfree function. 🧚
• errcodep — first, the original text has the exact string function.e errcodep right before this, so don't let the function.e part confuse you; errcodep is an output parameter, which points to the result code returned by the server. If this parameter is NULL, the result code is not returned. 💀

See ldap.h for a list of possible return codes. 👀

👀 SEE ALSO 👀

• ldap_search(3) — go read that one too, bestie. 🫶

🫶 ACKNOWLEDGEMENTS 🫶

OpenLDAP Software is developed and maintained by The OpenLDAP Project <http://www.openldap.org/>. OpenLDAP Software is derived from the University of Michigan LDAP 3.3 Release. 💜

---

That's a wrap, bestie — this page is from OpenLDAP 2.6.16 and dated 2026/10/21. Slay. 💅🎀