# perldoc > Net::LDAP::Control::TreeDelete

## NAME
    [Net::LDAP::Control::TreeDelete](https://www.chedong.com/phpMan.php/perldoc/Net%3A%3ALDAP%3A%3AControl%3A%3ATreeDelete/markdown) - LDAPv3 Tree Delete control object

## SYNOPSIS
     use [Net::LDAP](https://www.chedong.com/phpMan.php/perldoc/Net%3A%3ALDAP/markdown);
     use [Net::LDAP::Control::TreeDelete](https://www.chedong.com/phpMan.php/perldoc/Net%3A%3ALDAP%3A%3AControl%3A%3ATreeDelete/markdown);

     $ldap = [Net::LDAP](https://www.chedong.com/phpMan.php/perldoc/Net%3A%3ALDAP/markdown)->new( "ldap.mydomain.eg" );

     $treedel = [Net::LDAP::Control::TreeDelete](https://www.chedong.com/phpMan.php/perldoc/Net%3A%3ALDAP%3A%3AControl%3A%3ATreeDelete/markdown)->new( critical => 1 );

     $msg = $ldap->delete( 'o=University of Michigan,c=US',
                           control  => [ $treedel ] );

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

## DESCRIPTION
    "[Net::LDAP::Control::TreeDelete](https://www.chedong.com/phpMan.php/perldoc/Net%3A%3ALDAP%3A%3AControl%3A%3ATreeDelete/markdown)" provides an interface for the creation and manipulation of
    objects that represent the "TreeDelete" control as described by
    draft-armijo-ldap-treedelete-02.txt
    <<https://tools.ietf.org/html/draft-armijo-ldap-treedelete-02>>

    It allows the client to delete an entire subtree.

    The control is appropriate for LDAP delete operations [RFC4511] only, and inappropriate for all
    other operations.

    Its criticality may be TRUE or FALSE; it has no value.

    There is no corresponding response control.

## CONSTRUCTOR ARGUMENTS
    Since the "TreeDelete" control does not have any values, only the constructor arguments
    described in [Net::LDAP::Control](https://www.chedong.com/phpMan.php/perldoc/Net%3A%3ALDAP%3A%3AControl/markdown) are supported

## METHODS
    As there are no additional values in the control, only the methods in [Net::LDAP::Control](https://www.chedong.com/phpMan.php/perldoc/Net%3A%3ALDAP%3A%3AControl/markdown) are
    available for "[Net::LDAP::Control::TreeDelete](https://www.chedong.com/phpMan.php/perldoc/Net%3A%3ALDAP%3A%3AControl%3A%3ATreeDelete/markdown)" objects.

## SEE ALSO
    [Net::LDAP](https://www.chedong.com/phpMan.php/perldoc/Net%3A%3ALDAP/markdown), [Net::LDAP::Control](https://www.chedong.com/phpMan.php/perldoc/Net%3A%3ALDAP%3A%3AControl/markdown),

## 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.