Return to safe-read.h CVS log

Up to [ELWIX - Embedded LightWeight unIX -] / embedaddon / libiconv / srclib

Annotation of embedaddon/libiconv/srclib/safe-read.h, revision 1.1.1.1

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