Uploaded image for project: 'Qpid Proton'
  1. Qpid Proton
  2. PROTON-999

Docs: pn_messenger_subscribe(): "source" is undocumented

    Details

    • Type: Bug
    • Status: Closed
    • Priority: Major
    • Resolution: Won't Fix
    • Affects Version/s: proton-0.10
    • Fix Version/s: None
    • Component/s: proton-c
    • Labels:

      Description

      The pn_messenger_subscribe() function is documented to take a const char * as a "source":

      https://qpid.apache.org/releases/qpid-proton-0.10/proton/c/api/group__messenger.html#gaf1f1bfe4894d971f0b8d679bcab5cae6

      The definition of a "source" isn't specified, nor is the acceptable source format specified.

      In addition, it isn't specified in the docs whether this function must be called once, or whether it can be called multiple times. Reverse engineering the source seems to indicate that it should be called just once, and if you call it multiple times the underlying event loop will be corrupted.

        Attachments

          Activity

            People

            • Assignee:
              justi9 Justin Ross
              Reporter:
              minfrin Graham Leggett
            • Votes:
              0 Vote for this issue
              Watchers:
              2 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved: