|
|
|
@ -7,9 +7,9 @@ sxmsg_send_pp \- Create and send a message in postponed mode.
|
|
|
|
|
.B #include <sxmp/sxmp.h>
|
|
|
|
|
.br
|
|
|
|
|
.sp
|
|
|
|
|
int sxmsg_send(chnl_t *channel, const char *data, size_t datalen, sxmsg_t **msg);
|
|
|
|
|
int sxmsg_send(sxchnl_t *channel, const char *data, size_t datalen, sxmsg_t **msg);
|
|
|
|
|
|
|
|
|
|
int sxmsg_send_pp(chnl_t *channel, const char *data, size_t datalen, sxmsg_t **msg);
|
|
|
|
|
int sxmsg_send_pp(sxchnl_t *channel, const char *data, size_t datalen, sxmsg_t **msg);
|
|
|
|
|
|
|
|
|
|
void sxmsg_clean(sxmsg_t *msg);
|
|
|
|
|
.br
|
|
|
|
@ -38,43 +38,43 @@ will clean up the data used for closed dialog message, it should be used in case
|
|
|
|
|
.SH RETURN VALUE
|
|
|
|
|
Dialog will be closed in all cases except the following error codes returns:
|
|
|
|
|
.sp
|
|
|
|
|
.B SNE_REPLYREQ
|
|
|
|
|
.B SXE_REPLYREQ
|
|
|
|
|
means other side waiting a reply for this message (i.e. dialog isn't closed).
|
|
|
|
|
.br
|
|
|
|
|
In other cases message will not set except
|
|
|
|
|
.B SNE_RAPIDMSG
|
|
|
|
|
.B SXE_RAPIDMSG
|
|
|
|
|
error code, in this case to avoid memory leaks
|
|
|
|
|
.B sxmsg_clean
|
|
|
|
|
must be called after data is processed. In other cases a different and specific error code might be returned, but usual cases listed below:
|
|
|
|
|
.br
|
|
|
|
|
.B SNE_SUCCESS
|
|
|
|
|
.B SXE_SUCCESS
|
|
|
|
|
will returns if message was processed and dialog is closed.
|
|
|
|
|
.br
|
|
|
|
|
.B SNE_FAILED
|
|
|
|
|
.B SXE_FAILED
|
|
|
|
|
pointed data is invalid.
|
|
|
|
|
.br
|
|
|
|
|
.B SNE_ENOMEM
|
|
|
|
|
.B SXE_ENOMEM
|
|
|
|
|
not available memory for operation.
|
|
|
|
|
.br
|
|
|
|
|
.B SNE_BADPROTO
|
|
|
|
|
.B SXE_BADPROTO
|
|
|
|
|
bad protocol.
|
|
|
|
|
.br
|
|
|
|
|
.B SNE_ENORPC
|
|
|
|
|
.B SXE_ENORPC
|
|
|
|
|
No RPC call exists i.e. message sent contains an invalid RPC function name.
|
|
|
|
|
.br
|
|
|
|
|
.B SNE_TOOLONG
|
|
|
|
|
.B SXE_TOOLONG
|
|
|
|
|
Data os too long to be sent with one message.
|
|
|
|
|
.br
|
|
|
|
|
.B SNE_NOSUCHCHAN
|
|
|
|
|
.B SXE_NOSUCHCHAN
|
|
|
|
|
Pointed channel doesn't exists
|
|
|
|
|
.br
|
|
|
|
|
.B SNE_ETIMEDOUT
|
|
|
|
|
.B SXE_ETIMEDOUT
|
|
|
|
|
Other side timedout with replying to your message.
|
|
|
|
|
.br
|
|
|
|
|
.B SNE_LINKBROKEN
|
|
|
|
|
.B SXE_LINKBROKEN
|
|
|
|
|
Connection link is broken during a message send.
|
|
|
|
|
.br
|
|
|
|
|
.B SNE_MMESSAGES
|
|
|
|
|
.B SXE_MMESSAGES
|
|
|
|
|
Limit for the active messages exceeded.
|
|
|
|
|
.br
|
|
|
|
|
.SH BUGS
|
|
|
|
@ -86,7 +86,7 @@ None.
|
|
|
|
|
.SH RATIONALE
|
|
|
|
|
None.
|
|
|
|
|
.SH SEE_ALSO
|
|
|
|
|
.BI connection_link(3)
|
|
|
|
|
.BI sxlink_connect(3)
|
|
|
|
|
,
|
|
|
|
|
.BI sxchannel_open(3)
|
|
|
|
|
,
|
|
|
|
|