diff options
author | Russell Bryant <russell@russellbryant.com> | 2008-12-22 17:09:36 +0000 |
---|---|---|
committer | Russell Bryant <russell@russellbryant.com> | 2008-12-22 17:09:36 +0000 |
commit | c2999a8366b0738f14b2d4493cda496ff65bcc09 (patch) | |
tree | 97efdb1323ea8cb3038a987daaded8806e5b4213 /include/asterisk/utils.h | |
parent | 77b1fe0cebbecbbf104f4ed5b3b81fbd0d8bce7c (diff) |
Introduce ast_careful_fwrite() and use in AMI to prevent partial writes.
This patch introduces a function to do careful writes on a file stream which
will handle timeouts and partial writes. It is currently used in AMI to
address the issue that has been reported. However, there are probably a few
other places where this could be used.
(closes issue #13546)
Reported by: srt
Tested by: russell
http://reviewboard.digium.com/r/104/
git-svn-id: https://origsvn.digium.com/svn/asterisk/trunk@166282 65c4cc65-6c06-0410-ace0-fbb531ad65f3
Diffstat (limited to 'include/asterisk/utils.h')
-rw-r--r-- | include/asterisk/utils.h | 19 |
1 files changed, 19 insertions, 0 deletions
diff --git a/include/asterisk/utils.h b/include/asterisk/utils.h index 1c676b8ee..941b5e57a 100644 --- a/include/asterisk/utils.h +++ b/include/asterisk/utils.h @@ -326,6 +326,25 @@ int ast_wait_for_input(int fd, int ms); */ int ast_carefulwrite(int fd, char *s, int len, int timeoutms); +/*! + * \brief Write data to a file stream with a timeout + * + * \param f the file stream to write to + * \param fd the file description to poll on to know when the file stream can + * be written to without blocking. + * \param s the buffer to write from + * \param len the number of bytes to write + * \param timeoutms The maximum amount of time to block in this function trying + * to write, specified in milliseconds. + * + * \note This function assumes that the associated file stream has been set up + * as non-blocking. + * + * \retval 0 success + * \retval -1 error + */ +int ast_careful_fwrite(FILE *f, int fd, const char *s, size_t len, int timeoutms); + /* * Thread management support (should be moved to lock.h or a different header) */ |