You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
libsxmp/man/sxmsg_rreply.3SNTL

36 lines
988 B
Plaintext

.TH SXMSG_RREPLY 3SNTL "20 July 2015" "SNTLLv2" "SNTL Library Manual"
.SH NAME
sxmsg_rreply \- Function used to send a rapid reply without confirmation
.SH SYNOPSIS
.B #include <sntl/sntllv2.h>
.sp
.BI int sxmsg_rreply(sxmsg_t *msg, size_t datalen);
.br
.sp
.SH DESCRIPTION
.B sxmsg_rreply
Will reply rapidly to the message using already allocated buffer, which might be
retrieved via sxmsg_rapidbuf(). This function will write desired message as soon
as possible. It will not wait any write or delivery confirmation.
.br
.SH RETURN VALUE
.B SNE_FAILED
returns if message has invalid index, channel or message pointer is NULL.
.br
.B SNE_ESSL
returns if write was failed i.e. connection link was broken, or SSL error occurs.
.br
.B SNE_SUCCESS
returns on success.
.br
.SH BUGS
Not known yet.
.SH EXAMPLE
.B Reply rapidly from the RPC function call.
.RS
.nf
.if t .ft CW
char *buf = sxmsg_rapidbuf(msg);
int ln = snprintf(buf, MAX_BBUFLEN, "(is-done)");
return sxmsg_rreply(msg, str, ln);