<p>Neels Hofmeyr has uploaded this change for <strong>review</strong>.</p><p><a href="https://gerrit.osmocom.org/13946">View Change</a></p><pre style="font-family: monospace,monospace; white-space: pre-wrap;">call_leg: document the parent_event_* items<br><br>Change-Id: Ib099178a0f6ab218646c67c0e7a3d360c81af684<br>---<br>M include/osmocom/msc/call_leg.h<br>M src/libmsc/call_leg.c<br>2 files changed, 9 insertions(+), 0 deletions(-)<br><br></pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;">git pull ssh://gerrit.osmocom.org:29418/osmo-msc refs/changes/46/13946/1</pre><pre style="font-family: monospace,monospace; white-space: pre-wrap;"><span>diff --git a/include/osmocom/msc/call_leg.h b/include/osmocom/msc/call_leg.h</span><br><span>index 61107ee..d8380f5 100644</span><br><span>--- a/include/osmocom/msc/call_leg.h</span><br><span>+++ b/include/osmocom/msc/call_leg.h</span><br><span>@@ -34,6 +34,7 @@</span><br><span>   /* Array indexed by enum rtp_direction. */</span><br><span>   enum mgcp_connection_mode crcx_conn_mode[2];</span><br><span> </span><br><span style="color: hsl(120, 100%, 40%);">+      /* Events dispatched to the parent fi, see call_leg_alloc() doc. */</span><br><span>  uint32_t parent_event_rtp_addr_available;</span><br><span>    uint32_t parent_event_rtp_complete;</span><br><span> </span><br><span>diff --git a/src/libmsc/call_leg.c b/src/libmsc/call_leg.c</span><br><span>index 1b7db2b..46405bc 100644</span><br><span>--- a/src/libmsc/call_leg.c</span><br><span>+++ b/src/libmsc/call_leg.c</span><br><span>@@ -64,6 +64,14 @@</span><br><span>        OSMO_ASSERT( osmo_fsm_register(&call_leg_fsm) == 0 );</span><br><span> }</span><br><span> </span><br><span style="color: hsl(120, 100%, 40%);">+/* Allocate a call leg FSM instance as child of an arbitrary other FSM instance.</span><br><span style="color: hsl(120, 100%, 40%);">+ * The call leg FSM dispatches events to its parent FSM instance on specific events:</span><br><span style="color: hsl(120, 100%, 40%);">+ * - parent_event_term: dispatch this to the parent FI when the call leg terminates (call ended, either planned or by</span><br><span style="color: hsl(120, 100%, 40%);">+ *   failure).</span><br><span style="color: hsl(120, 100%, 40%);">+ * - parent_event_rtp_addr_available: one of the rtp_stream instances managed by the call leg has received an RTP</span><br><span style="color: hsl(120, 100%, 40%);">+ *   address from the MGW. The struct rtp_stream instance is passed as data argument for the event dispatch.</span><br><span style="color: hsl(120, 100%, 40%);">+ * - parent_event_rtp_complete: one of the rtp_stream instances entered the RTP_STREAM_ST_ESTABLISHED state.</span><br><span style="color: hsl(120, 100%, 40%);">+ */</span><br><span> struct call_leg *call_leg_alloc(struct osmo_fsm_inst *parent_fi,</span><br><span>                            uint32_t parent_event_term,</span><br><span>                          uint32_t parent_event_rtp_addr_available,</span><br><span></span><br></pre><p>To view, visit <a href="https://gerrit.osmocom.org/13946">change 13946</a>. To unsubscribe, or for help writing mail filters, visit <a href="https://gerrit.osmocom.org/settings">settings</a>.</p><div itemscope itemtype="http://schema.org/EmailMessage"><div itemscope itemprop="action" itemtype="http://schema.org/ViewAction"><link itemprop="url" href="https://gerrit.osmocom.org/13946"/><meta itemprop="name" content="View Change"/></div></div>

<div style="display:none"> Gerrit-Project: osmo-msc </div>
<div style="display:none"> Gerrit-Branch: master </div>
<div style="display:none"> Gerrit-MessageType: newchange </div>
<div style="display:none"> Gerrit-Change-Id: Ib099178a0f6ab218646c67c0e7a3d360c81af684 </div>
<div style="display:none"> Gerrit-Change-Number: 13946 </div>
<div style="display:none"> Gerrit-PatchSet: 1 </div>
<div style="display:none"> Gerrit-Owner: Neels Hofmeyr <nhofmeyr@sysmocom.de> </div>