Merged revisions 222176 via svnmerge from

Merged revisions 222176 via svnmerge from
https://origsvn.digium.com/svn/asterisk/trunk

................
  r222176 | kpfleming | 2009-10-05 20:24:24 -0500 (Mon, 05 Oct 2009) | 27 lines

  Recorded merge of revisions 222152 via svnmerge from
  https://origsvn.digium.com/svn/asterisk/branches/1.4

  ........
    r222152 | kpfleming | 2009-10-05 20:16:36 -0500 (Mon, 05 Oct 2009) | 20 lines

    Fix ao2_iterator API to hold references to containers being iterated.

    See Mantis issue for details of what prompted this change.

    Additional notes:

    This patch changes the ao2_iterator API in two ways: F_AO2I_DONTLOCK
    has become an enum instead of a macro, with a name that fits our
    naming policy; also, it is now necessary to call
    ao2_iterator_destroy() on any iterator that has been
    created. Currently this only releases the reference to the container
    being iterated, but in the future this could also release other
    resources used by the iterator, if the iterator implementation changes
    to use additional resources.

    (closes issue #15987)
    Reported by: kpfleming

    Review: https://reviewboard.asterisk.org/r/383/
  ........
................

git-svn-id: https://origsvn.digium.com/svn/asterisk/branches/1.6.0@222185 65c4cc65-6c06-0410-ace0-fbb531ad65f3