annotate lib/safe-write.h @ 17907:0a1c2535cad9

euidaccess: Fix Android build * modules/euidaccess (Depends-on): Add fcntl-h to ensure that AT_EACCESS gets declared.
author Kevin Cernekee <cernekee@google.com>
date Wed, 11 Feb 2015 15:22:54 -0800
parents ab58d4870664
children
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
4002
9fcf64c770ed Orthogonal approach to read()/write() that handles EINTR and counts > 2^31
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
1 /* An interface to write() that retries after interrupts.
17848
ab58d4870664 version-etc: new year
Paul Eggert <eggert@cs.ucla.edu>
parents: 17587
diff changeset
2 Copyright (C) 2002, 2009-2015 Free Software Foundation, Inc.
4002
9fcf64c770ed Orthogonal approach to read()/write() that handles EINTR and counts > 2^31
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
3
9309
bbbbbf4cd1c5 Change copyright notice from GPLv2+ to GPLv3+.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
4 This program is free software: you can redistribute it and/or modify
4002
9fcf64c770ed Orthogonal approach to read()/write() that handles EINTR and counts > 2^31
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
5 it under the terms of the GNU General Public License as published by
9309
bbbbbf4cd1c5 Change copyright notice from GPLv2+ to GPLv3+.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
6 the Free Software Foundation; either version 3 of the License, or
bbbbbf4cd1c5 Change copyright notice from GPLv2+ to GPLv3+.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
7 (at your option) any later version.
4002
9fcf64c770ed Orthogonal approach to read()/write() that handles EINTR and counts > 2^31
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
8
9fcf64c770ed Orthogonal approach to read()/write() that handles EINTR and counts > 2^31
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
9 This program is distributed in the hope that it will be useful,
9fcf64c770ed Orthogonal approach to read()/write() that handles EINTR and counts > 2^31
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
9fcf64c770ed Orthogonal approach to read()/write() that handles EINTR and counts > 2^31
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
9fcf64c770ed Orthogonal approach to read()/write() that handles EINTR and counts > 2^31
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
12 GNU General Public License for more details.
9fcf64c770ed Orthogonal approach to read()/write() that handles EINTR and counts > 2^31
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
13
9fcf64c770ed Orthogonal approach to read()/write() that handles EINTR and counts > 2^31
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
14 You should have received a copy of the GNU General Public License
9309
bbbbbf4cd1c5 Change copyright notice from GPLv2+ to GPLv3+.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
15 along with this program. If not, see <http://www.gnu.org/licenses/>. */
4002
9fcf64c770ed Orthogonal approach to read()/write() that handles EINTR and counts > 2^31
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
16
15336
5ba0229c806b Comments about EINTR.
Bruno Haible <bruno@clisp.org>
parents: 14079
diff changeset
17 /* Some system calls may be interrupted and fail with errno = EINTR in the
5ba0229c806b Comments about EINTR.
Bruno Haible <bruno@clisp.org>
parents: 14079
diff changeset
18 following situations:
5ba0229c806b Comments about EINTR.
Bruno Haible <bruno@clisp.org>
parents: 14079
diff changeset
19 - The process is stopped and restarted (signal SIGSTOP and SIGCONT, user
16935
498a2211d839 Write "Mac OS X" instead of "MacOS X".
Bruno Haible <bruno@clisp.org>
parents: 16201
diff changeset
20 types Ctrl-Z) on some platforms: Mac OS X.
15336
5ba0229c806b Comments about EINTR.
Bruno Haible <bruno@clisp.org>
parents: 14079
diff changeset
21 - The process receives a signal for which a signal handler was installed
5ba0229c806b Comments about EINTR.
Bruno Haible <bruno@clisp.org>
parents: 14079
diff changeset
22 with sigaction() with an sa_flags field that does not contain
5ba0229c806b Comments about EINTR.
Bruno Haible <bruno@clisp.org>
parents: 14079
diff changeset
23 SA_RESTART.
5ba0229c806b Comments about EINTR.
Bruno Haible <bruno@clisp.org>
parents: 14079
diff changeset
24 - The process receives a signal for which a signal handler was installed
5ba0229c806b Comments about EINTR.
Bruno Haible <bruno@clisp.org>
parents: 14079
diff changeset
25 with signal() and for which no call to siginterrupt(sig,0) was done,
5ba0229c806b Comments about EINTR.
Bruno Haible <bruno@clisp.org>
parents: 14079
diff changeset
26 on some platforms: AIX, HP-UX, IRIX, OSF/1, Solaris.
5ba0229c806b Comments about EINTR.
Bruno Haible <bruno@clisp.org>
parents: 14079
diff changeset
27
5ba0229c806b Comments about EINTR.
Bruno Haible <bruno@clisp.org>
parents: 14079
diff changeset
28 This module provides a wrapper around write() that handles EINTR. */
5ba0229c806b Comments about EINTR.
Bruno Haible <bruno@clisp.org>
parents: 14079
diff changeset
29
4002
9fcf64c770ed Orthogonal approach to read()/write() that handles EINTR and counts > 2^31
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
30 #include <stddef.h>
9fcf64c770ed Orthogonal approach to read()/write() that handles EINTR and counts > 2^31
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
31
4049
6a1238f585b1 Synchronize safe-write with safe-read.
Bruno Haible <bruno@clisp.org>
parents: 4002
diff changeset
32 #define SAFE_WRITE_ERROR ((size_t) -1)
6a1238f585b1 Synchronize safe-write with safe-read.
Bruno Haible <bruno@clisp.org>
parents: 4002
diff changeset
33
4002
9fcf64c770ed Orthogonal approach to read()/write() that handles EINTR and counts > 2^31
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
34 /* Write up to COUNT bytes at BUF to descriptor FD, retrying if interrupted.
4049
6a1238f585b1 Synchronize safe-write with safe-read.
Bruno Haible <bruno@clisp.org>
parents: 4002
diff changeset
35 Return the actual number of bytes written, zero for EOF, or SAFE_WRITE_ERROR
6a1238f585b1 Synchronize safe-write with safe-read.
Bruno Haible <bruno@clisp.org>
parents: 4002
diff changeset
36 upon error. */
4002
9fcf64c770ed Orthogonal approach to read()/write() that handles EINTR and counts > 2^31
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
37 extern size_t safe_write (int fd, const void *buf, size_t count);