safe-write.h 1.7 KB

1234567891011121314151617181920212223242526272829303132333435363738
  1. /* An interface to write() that retries after interrupts.
  2. Copyright (C) 2002, 2009-2017 Free Software Foundation, Inc.
  3. This program is free software: you can redistribute it and/or modify
  4. it under the terms of the GNU Lesser General Public License as published by
  5. the Free Software Foundation; either version 3 of the License, or
  6. (at your option) any later version.
  7. This program is distributed in the hope that it will be useful,
  8. but WITHOUT ANY WARRANTY; without even the implied warranty of
  9. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
  10. GNU Lesser General Public License for more details.
  11. You should have received a copy of the GNU Lesser General Public License
  12. along with this program. If not, see <http://www.gnu.org/licenses/>. */
  13. /* Some system calls may be interrupted and fail with errno = EINTR in the
  14. following situations:
  15. - The process is stopped and restarted (signal SIGSTOP and SIGCONT, user
  16. types Ctrl-Z) on some platforms: Mac OS X.
  17. - The process receives a signal for which a signal handler was installed
  18. with sigaction() with an sa_flags field that does not contain
  19. SA_RESTART.
  20. - The process receives a signal for which a signal handler was installed
  21. with signal() and for which no call to siginterrupt(sig,0) was done,
  22. on some platforms: AIX, HP-UX, IRIX, OSF/1, Solaris.
  23. This module provides a wrapper around write() that handles EINTR. */
  24. #include <stddef.h>
  25. #define SAFE_WRITE_ERROR ((size_t) -1)
  26. /* Write up to COUNT bytes at BUF to descriptor FD, retrying if interrupted.
  27. Return the actual number of bytes written, zero for EOF, or SAFE_WRITE_ERROR
  28. upon error. */
  29. extern size_t safe_write (int fd, const void *buf, size_t count);