{
    "content": [
        {
            "type": "text",
            "text": "# Net::LDAP::Control::PostRead (perldoc)\n\n## NAME\n\nNet::LDAP::Control::PostRead - LDAPv3 Post-Read control object\n\n## SYNOPSIS\n\nuse 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}\n\n## DESCRIPTION\n\n\"Net::LDAP::Control::PostRead\" provides an interface for the creation and manipulation of\nobjects that represent the \"Post-Read Controls\" as described by RFC 4527.\n\n## Sections\n\n- **NAME**\n- **SYNOPSIS**\n- **DESCRIPTION**\n- **CONSTRUCTOR ARGUMENTS**\n- **METHODS**\n- **SEE ALSO**\n- **AUTHOR**\n- **COPYRIGHT**\n\nUse structuredContent.sections for detailed options, examples, and full documentation.\n"
        }
    ],
    "structuredContent": {
        "command": "Net::LDAP::Control::PostRead",
        "section": "",
        "mode": "perldoc",
        "summary": "Net::LDAP::Control::PostRead - LDAPv3 Post-Read control object",
        "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}",
        "tldr_summary": null,
        "tldr_examples": [],
        "tldr_source": null,
        "flags": [],
        "examples": [],
        "see_also": [],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "SYNOPSIS",
                "lines": 23,
                "subsections": []
            },
            {
                "name": "DESCRIPTION",
                "lines": 12,
                "subsections": []
            },
            {
                "name": "CONSTRUCTOR ARGUMENTS",
                "lines": 11,
                "subsections": []
            },
            {
                "name": "METHODS",
                "lines": 12,
                "subsections": []
            },
            {
                "name": "SEE ALSO",
                "lines": 2,
                "subsections": []
            },
            {
                "name": "AUTHOR",
                "lines": 5,
                "subsections": []
            },
            {
                "name": "COPYRIGHT",
                "lines": 3,
                "subsections": []
            }
        ],
        "sections": {
            "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 and manipulation of\nobjects that represent the \"Post-Read Controls\" as described by RFC 4527.\n\nIn modification operations, the \"Post-Read request control\" indicates to the server that a copy\nof the modified entry after the update is to be returned. After the successful completion of the\noperation, the accompanying \"Post-Read response control\" allows one to retrieve the updated\nvalue from the server's response.\n\nOne use case of this control may be to obtain values of operational attributes, such as the\n\"entryUUID\" and \"modifyTimestamp\" attributes, updated by the server as part of the update\noperation.\n",
                "subsections": []
            },
            "CONSTRUCTOR ARGUMENTS": {
                "content": "In addition to the constructor arguments described in Net::LDAP::Control the following are\nprovided.\n\nattrs => [ ATTR, ... ]\nA list of attributes to be returned in the entry returned in the response control.\n\nIf absent, all attributes are returned.\n\nOperational attributes may be included in the list by explicitly asking for them or by using\nspecial \"+\" feature (provided the server supports this feature).\n",
                "subsections": []
            },
            "METHODS": {
                "content": "As with Net::LDAP::Control each constructor argument described above is also available as a\nmethod on the object which will return the current value for the attribute if called without an\nargument, and set a new value for the attribute if called with an argument.\n\nIn addition to these methods, the control also supports the following method:\n\nentry ()\nReturns the entry from the response control in the response message to the LDAP request that\ncontained 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 mailing list\n<perl-ldap@perl.org>\n",
                "subsections": []
            },
            "COPYRIGHT": {
                "content": "Copyright (c) 2008,2011 Peter Marschall. All rights reserved. This program is free software; you\ncan redistribute it and/or modify it under the same terms as Perl itself.\n",
                "subsections": []
            }
        }
    }
}