> -----Original Message----- > From: lng-odp [mailto:lng-odp-boun...@lists.linaro.org] On Behalf Of ext > Ola Liljedahl > Sent: Tuesday, May 19, 2015 1:04 AM > To: lng-odp@lists.linaro.org > Subject: [lng-odp] [RFC] Add ipc.h > > As promised, here is my first attempt at a standalone API for IPC - inter > process communication in a shared nothing architecture (message passing > between processes which do not share memory). > > Currently all definitions are in the file ipc.h but it is possible to > break out some message/event related definitions (everything from > odp_ipc_sender) in a separate file message.h. This would mimic the > packet_io.h/packet.h separation. > > The semantics of message passing is that sending a message to an endpoint > will always look like it succeeds. The appearance of endpoints is > explicitly > notified through user-defined messages specified in the odp_ipc_resolve() > call. Similarly, the disappearance (e.g. death or otherwise lost > connection) > is also explicitly notified through user-defined messages specified in the > odp_ipc_monitor() call. The send call does not fail because the addressed > endpoints has disappeared. > > Messages (from endpoint A to endpoint B) are delivered in order. If > message > N sent to an endpoint is delivered, then all messages <N have also been > delivered. Message delivery does not guarantee actual processing by the
Ordered is OK requirement, but "all messages <N have also been delivered" means in practice loss less delivery (== re-tries and retransmission windows, etc). Lossy vs loss less link should be an configuration option. Also what "delivered" means? Message: - transmitted successfully over the link ? - is now under control of the remote node (post office) ? - delivered into application input queue ? - has been dequeued from application queue ? > recipient. End-to-end acknowledgements (using messages) should be used if > this guarantee is important to the user. > > IPC endpoints can be seen as interfaces (taps) to an internal reliable > multidrop network where each endpoint has a unique address which is only > valid for the lifetime of the endpoint. I.e. if an endpoint is destroyed > and then recreated (with the same name), the new endpoint will have a > new address (eventually endpoints addresses will have to be recycled but > not for a very long time). Endpoints names do not necessarily have to be > unique. How widely these addresses are unique: inside one VM, multiple VMs under the same host, multiple devices on a LAN (VLAN), ... > > Signed-off-by: Ola Liljedahl <ola.liljed...@linaro.org> > --- > (This document/code contribution attached is provided under the terms of > agreement LES-LTM-21309) > > +/** > + * Create IPC endpoint > + * > + * @param name Name of local IPC endpoint > + * @param pool Pool for incoming messages > + * > + * @return IPC handle on success > + * @retval ODP_IPC_INVALID on failure and errno set > + */ > +odp_ipc_t odp_ipc_create(const char *name, odp_pool_t pool); This creates (implicitly) the local end point address. > + > +/** > + * Set the default input queue for an IPC endpoint > + * > + * @param ipc IPC handle > + * @param queue Queue handle > + * > + * @retval 0 on success > + * @retval <0 on failure > + */ > +int odp_ipc_inq_setdef(odp_ipc_t ipc, odp_queue_t queue); Multiple input queues are likely needed for different priority messages. > + > +/** > + * Resolve endpoint by name > + * > + * Look up an existing or future endpoint by name. > + * When the endpoint exists, return the specified message with the > endpoint > + * as the sender. > + * > + * @param ipc IPC handle > + * @param name Name to resolve > + * @param msg Message to return > + */ > +void odp_ipc_resolve(odp_ipc_t ipc, > + const char *name, > + odp_ipc_msg_t msg); How widely these names are visible? Inside one VM, multiple VMs under the same host, multiple devices on a LAN (VLAN), ... I think name service (or address resolution) are better handled in middleware layer. If ODP provides unique addresses and message passing mechanism, additional services can be built on top. > + > +/** > + * Monitor endpoint > + * > + * Monitor an existing (potentially already dead) endpoint. > + * When the endpoint is dead, return the specified message with the > endpoint > + * as the sender. > + * > + * Unrecognized or invalid endpoint addresses are treated as dead > endpoints. > + * > + * @param ipc IPC handle > + * @param addr Address of monitored endpoint > + * @param msg Message to return > + */ > +void odp_ipc_monitor(odp_ipc_t ipc, > + const uint8_t addr[ODP_IPC_ADDR_SIZE], > + odp_ipc_msg_t msg); Again, I'd see node health monitoring and alarms as middleware services. > + > +/** > + * Send message > + * > + * Send a message to an endpoint (which may already be dead). > + * Message delivery is ordered and reliable. All (accepted) messages will > be > + * delivered up to the point of endpoint death or lost connection. > + * Actual reception and processing is not guaranteed (use end-to-end > + * acknowledgements for that). > + * Monitor the remote endpoint to detect death or lost connection. > + * > + * @param ipc IPC handle > + * @param msg Message to send > + * @param addr Address of remote endpoint > + * > + * @retval 0 on success > + * @retval <0 on error > + */ > +int odp_ipc_send(odp_ipc_t ipc, > + odp_ipc_msg_t msg, > + const uint8_t addr[ODP_IPC_ADDR_SIZE]); This would be used to send a message to an address, but normal odp_queue_enq() could be used to circulate this event inside an application (ODP instance). > + > +/** > + * Get address of sender (source) of message > + * > + * @param msg Message handle > + * @param addr Address of sender endpoint > + */ > +void odp_ipc_sender(odp_ipc_msg_t msg, > + uint8_t addr[ODP_IPC_ADDR_SIZE]); > + > +/** > + * Message data pointer > + * > + * Return a pointer to the message data > + * > + * @param msg Message handle > + * > + * @return Pointer to the message data > + */ > +void *odp_ipc_data(odp_ipc_msg_t msg); > + > +/** > + * Message data length > + * > + * Return length of the message data. > + * > + * @param msg Message handle > + * > + * @return Message length > + */ > +uint32_t odp_ipc_length(const odp_ipc_msg_t msg); > + > +/** > + * Set message length > + * > + * Set length of the message data. > + * > + * @param msg Message handle > + * @param len New length > + * > + * @retval 0 on success > + * @retval <0 on error > + */ > +int odp_ipc_reset(const odp_ipc_msg_t msg, uint32_t len); When data ptr or data len is modified: push/pull head, push/pull tail would be analogies from packet API -Petri _______________________________________________ lng-odp mailing list lng-odp@lists.linaro.org https://lists.linaro.org/mailman/listinfo/lng-odp