diff options
author | russell <russell@f38db490-d61c-443f-a65b-d21fe96a405b> | 2008-12-22 17:09:36 +0000 |
---|---|---|
committer | russell <russell@f38db490-d61c-443f-a65b-d21fe96a405b> | 2008-12-22 17:09:36 +0000 |
commit | 87c96dd4d04f1046447430f700d2406e25f2b8d8 (patch) | |
tree | 97efdb1323ea8cb3038a987daaded8806e5b4213 /include/asterisk/utils.h | |
parent | 7d7c94a817bb12cdf92e82d9e03df25fc5340bc5 (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: http://svn.digium.com/svn/asterisk/trunk@166282 f38db490-d61c-443f-a65b-d21fe96a405b
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) */ |