{
    "mode": "info",
    "parameter": "Net::LDAP::Control::PostRead",
    "section": "",
    "url": "https://www.chedong.com/phpMan.php/info/Net%3A%3ALDAP%3A%3AControl%3A%3APostRead/json",
    "generated": "2026-07-07T10:00:06Z",
    "synopsis": "use Net::LDAP;\nuse Net::LDAP::Control::PostRead;\nuse Net::LDAP::Constant qw( LDAPCONTROLPOSTREAD LDAPSUCCESS );\n$ldap = Net::LDAP->new( \"ldap.mydomain.eg\" );\n$postread = Net::LDAP::Control::PostRead->new( attrs => [ qw/givenName/ ] );\nmy $mesg = $ldap->modify( \"cn=Barbara Jensen, o=University of Michigan, c=US\",\nreplace => { givenName => \"Babs\" },\ncontrol => $postread );\nif ($mesg->code eq LDAPSUCCESS) {\nmy ($afterwards) = $mesg->control( LDAPCONTROLPREREAD );\nmy $entry = $afterwards ? $afterwards->entry() : undef;\nif ($entry) {\nprint \"givenName changed to '\" .\njoin(\"', '\", $entry->getvalue(givenName\") .\n\"' to 'Babs'\\n\");\n}\n}",
    "sections": {
        "Net::LDAP::Control::PoUseraContributed Perl DNet::LDAP::Control::PostRead(3pm)": {
            "content": "",
            "subsections": []
        },
        "NAME": {
            "content": "Net::LDAP::Control::PostRead - LDAPv3 Post-Read control object\n",
            "subsections": []
        },
        "SYNOPSIS": {
            "content": "use Net::LDAP;\nuse Net::LDAP::Control::PostRead;\nuse Net::LDAP::Constant qw( LDAPCONTROLPOSTREAD LDAPSUCCESS );\n\n$ldap = Net::LDAP->new( \"ldap.mydomain.eg\" );\n\n$postread = Net::LDAP::Control::PostRead->new( attrs => [ qw/givenName/ ] );\n\nmy $mesg = $ldap->modify( \"cn=Barbara Jensen, o=University of Michigan, c=US\",\nreplace => { givenName => \"Babs\" },\ncontrol => $postread );\n\nif ($mesg->code eq LDAPSUCCESS) {\nmy ($afterwards) = $mesg->control( LDAPCONTROLPREREAD );\nmy $entry = $afterwards ? $afterwards->entry() : undef;\n\nif ($entry) {\nprint \"givenName changed to '\" .\njoin(\"', '\", $entry->getvalue(givenName\") .\n\"' to 'Babs'\\n\");\n}\n}\n",
            "subsections": []
        },
        "DESCRIPTION": {
            "content": "\"Net::LDAP::Control::PostRead\" provides an interface for the creation\nand manipulation of objects that represent the \"Post-Read Controls\" as\ndescribed by RFC 4527.\n\nIn modification operations, the \"Post-Read request control\" indicates\nto the server that a copy of the modified entry after the update is to\nbe returned.  After the successful completion of the operation, the\naccompanying \"Post-Read response control\" allows one to retrieve the\nupdated value from the server's response.\n\nOne use case of this control may be to obtain values of operational\nattributes, such as the \"entryUUID\" and \"modifyTimestamp\" attributes,\nupdated by the server as part of the update operation.\n",
            "subsections": []
        },
        "CONSTRUCTOR ARGUMENTS": {
            "content": "In addition to the constructor arguments described in\nNet::LDAP::Control the following are provided.\n\nattrs => [ ATTR, ... ]\nA list of attributes to be returned in the entry returned in the\nresponse control.\n\nIf absent, all attributes are returned.\n\nOperational attributes may be included in the list by explicitly\nasking for them or by using special \"+\" feature (provided the\nserver supports this feature).\n",
            "subsections": []
        },
        "METHODS": {
            "content": "As with Net::LDAP::Control each constructor argument described above is\nalso available as a method on the object which will return the current\nvalue for the attribute if called without an argument, and set a new\nvalue for the attribute if called with an argument.\n\nIn addition to these methods, the control also supports the following\nmethod:\n\nentry ()\nReturns the entry from the response control in the response message\nto the LDAP request that contained the request control.\n\nThe result is either a Net::LDAP::Entry object or undefined.\n",
            "subsections": []
        },
        "SEE ALSO": {
            "content": "Net::LDAP, Net::LDAP::Control, http://www.ietf.org/rfc/rfc4527.txt\n",
            "subsections": []
        },
        "AUTHOR": {
            "content": "Peter Marschall <peter@adpm.de>\n\nPlease report any bugs, or post any suggestions, to the perl-ldap\nmailing list <perl-ldap@perl.org>\n",
            "subsections": []
        },
        "COPYRIGHT": {
            "content": "Copyright (c) 2008,2011 Peter Marschall. All rights reserved. This\nprogram is free software; you can redistribute it and/or modify it\nunder the same terms as Perl itself.\n\nperl v5.32.0                      2021-01-03 Net::LDAP::Control::PostRead(3pm)",
            "subsections": []
        }
    },
    "summary": "Net::LDAP::Control::PostRead - LDAPv3 Post-Read control object",
    "flags": [],
    "examples": [],
    "see_also": []
}