Net::LD...entries(3)

💖 NAME 💖

Okay bestie, welcome to the Net::LDAP::Control::Subentries page from User Contributed Perl Documentation — the header is literally Net::LD...entries(3), iykyk. The actual main character is the LDAPv3 Subentries control object. 💅

---

✨ SYNOPSIS ✨

Here's the whole vibe, code exactly as written:

        use Net::LDAP;
        use Net::LDAP::Control::Subentries;

        $ldap = Net::LDAP->new( "ldap.mydomain.eg" );

        $subentries = Net::LDAP::Control::Subentries->new( visibility => 1 );

        $msg = $ldap->search( base => 'dc=sub,dc=mydomain,dc=eg",
                              filter => '(objectclass=*)',
                              attrs => [ qw/1.1/ ],
                              control => [ $subentries ] );

        die "error: ",$msg->code(),": ",$msg->error()  if ($msg->code());

---

🌸 DESCRIPTION 🌸

Net::LDAP::Control::Subentries gives you an interface for the creation and manipulation of objects that represent the "Subentries" control, as described by RFC 3672. 🦋

This control has no corresponding response control — like, none exists, periodt — and it's appropriate for LDAP search operations only. 🔥

If you don't include this control, subentries are visible only to LDAP search requests with scope => 'base', but not to searches with any other scope value. That's the tea. 🍓

---

🛠️ CONSTRUCTOR ARGUMENTS 🛠️

In addition to the constructor arguments described in Net::LDAP::Control, the following are provided:

• visibility — a Boolean value indicating the visibility of subentries or regular entries. The value "TRUE" indicates that subentries are visible and normal entries are not; the value "FALSE" indicates that normal entries are visible and subentries are not. 💖

---

🧚 METHODS 🧚

As with Net::LDAP::Control, each constructor argument described above is also available as a method on the object. Call it without an argument and it returns the current value for the attribute; call it with an argument and it sets a new value for the attribute. ✨

---

👀 SEE ALSO 👀

• Net::LDAP
• Net::LDAP::Control

The original list ends with a lil trailing comma, bestie: Net::LDAP, Net::LDAP::Control, — and that's it. 🫶

---

💌 AUTHOR 💌

Peter Marschall <peter@adpm.de>.

Please report any bugs, or post any suggestions, to the perl-ldap mailing list <perl-ldap@perl.org>

---

🎀 COPYRIGHT 🎀

Copyright (c) 2020 Peter Marschall. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.

---

Bye bestie! 💋 This page's footer is perl v5.42.0, dated 2024-01-02, and it's the Net::LD...entries(3) page. Slay. 🌈