Opened 8 years ago

Closed 8 years ago

Last modified 8 years ago

#1216 closed enhancement (fixed)

New pjsua_destroy2() API to allow shutting down the library without sending any outgoing messages

Reported by: bennylp Owned by: bennylp
Priority: normal Milestone: release-1.12
Component: pjsua-lib Version: 1.x-branch
Keywords: Cc: Magnus, Galåen, Johan, Lantz
Backport to 1.x milestone: Backported:

Description (last modified by bennylp)

New API is proposed by this ticket:

PJ_DECL(void) pjsua_destroy2(unsigned flags);

The flags argument may contain bitmask of the following options:

  • PJSUA_DESTROY_NO_RX_MSG: allow sending outgoing messages (such as unregistration, event unpublication, BYEs, unsubscription, etc.), but do not wait for responses. This is useful to perform "best effort" clean up without delaying the shutdown process waiting for responses. But note that if the requests are challenged with authentication (and usually they are), this would not accomplish much if any.
  • PJSUA_DESTROY_NO_TX_MSG: do not send any outgoing messages at all. This flag is useful if application knows that the network which the messages are to be sent on is currently down.
  • PJSUA_DESTROY_NO_NETWORK: combination of the two above.

Change History (6)

comment:1 Changed 8 years ago by bennylp

  • Cc Magnus Galåen added

comment:2 Changed 8 years ago by bennylp

  • Cc Johan Lantz added

comment:3 Changed 8 years ago by bennylp

  • Version changed from trunk to 1.x-branch

comment:4 Changed 8 years ago by bennylp

  • Resolution set to fixed
  • Status changed from new to closed

(In [3829]) Fixed #1216: New pjsua_destroy2() API to allow shutting down the library without sending any outgoing messages

comment:5 Changed 8 years ago by bennylp

  • Description modified (diff)

comment:6 Changed 8 years ago by bennylp

(In [3830]) Renamed enum names to comply with the spec in ticket (re #1216)

Note: See TracTickets for help on using tickets.