annotate lib/full-write.c @ 7302:8a1a9361108c

* _fpending.c: Include <config.h> unconditionally, since we no longer worry about uses that don't define HAVE_CONFIG_H. * acl.c, alloca.c, argmatch.c, atexit.c, backupfile.c: * basename.c, c-stack.c, c-strtod.c, calloc.c, canon-host.c: * canonicalize.c, chdir-long.c, chdir-safer.c, chown.c: * cloexec.c, close-stream.c, closeout.c, creat-safer.c: * cycle-check.c, diacrit.c, dirchownmod.c, dirfd.c, dirname.c: * dup-safer.c, dup2.c, error.c, euidaccess.c, exclude.c: * exitfail.c, fchmodat.c, fchown-stub.c, fd-safer.c: * file-type.c, fileblocks.c, filemode.c, filenamecat.c: * fnmatch.c, fopen-safer.c, fprintftime.c, free.c, fsusage.c: * ftruncate.c, fts-cycle.c, fts.c, full-write.c, gai_strerror.c: * getcwd.c, getdate.y, getdomainname.c, getgroups.c: * gethostname.c, gethrxtime.c, getloadavg.c, getlogin_r.c: * getndelim2.c, getnline.c, getopt.c, getopt1.c, getpass.c: * gettime.c, gettimeofday.c, getugroups.c, getusershell.c: * glob.c, group-member.c, hard-locale.c, hash-pjw.c, hash.c: * human.c, idcache.c, inet_ntop.c, inet_pton.c, inttostr.c: * isdir.c, lchown.c, linebuffer.c, long-options.c, lstat.c: * malloc.c, md5.c, memcasecmp.c, memchr.c, memcmp.c, memcoll.c: * memcpy.c, memmove.c, memrchr.c, mkancesdirs.c, mkdir-p.c: * mkdir.c, mkdirat.c, mkstemp-safer.c, mkstemp.c, modechange.c: * mountlist.c, nanosleep.c, obstack.c, open-safer.c: * openat-die.c, openat.c, pagealign_alloc.c, physmem.c: * pipe-safer.c, posixtm.c, posixver.c, putenv.c, quote.c: * quotearg.c, raise.c, readtokens.c, readtokens0.c, readutmp.c: * realloc.c, regex.c, rename.c, rmdir.c, rpmatch.c, safe-read.c: * same.c, save-cwd.c, savedir.c, setenv.c, settime.c, sha1.c: * sig2str.c, snprintf.c, strdup.c, strerror.c, strftime.c: * stripslash.c, strndup.c, strnlen.c, strpbrk.c, strtod.c: * strtoimax.c, strtol.c, strverscmp.c, tempname.c, time_r.c: * timegm.c, tmpfile-safer.c, unlinkdir.c, userspec.c, utime.c: * utimecmp.c, utimens.c, version-etc-fsf.c, version-etc.c: * xalloc-die.c, xgetcwd.c, xgethostname.c, xmalloc.c: * xmemcoll.c, xnanosleep.c, xreadlink.c, xstrtod.c: * xstrtoimax.c, xstrtol.c, xstrtoumax.c, yesno.c: Likewise.
author Paul Eggert <eggert@cs.ucla.edu>
date Wed, 13 Sep 2006 22:38:14 +0000
parents a84d5045e247
children 318625b71404
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
4140
40c9aa461079 Rework so that it may serve to define full_read, too.
Jim Meyering <jim@meyering.net>
parents: 4002
diff changeset
1 /* An interface to read and write that retries (if necessary) until complete.
3403
9ab12ba48e48 Correct credits, as cccp.c no longer
Jim Meyering <jim@meyering.net>
parents: 2460
diff changeset
2
5159
a535859efd14 Merge from coreutils.
Paul Eggert <eggert@cs.ucla.edu>
parents: 4144
diff changeset
3 Copyright (C) 1993, 1994, 1997, 1998, 1999, 2000, 2001, 2002, 2003,
7302
8a1a9361108c * _fpending.c: Include <config.h> unconditionally, since we no
Paul Eggert <eggert@cs.ucla.edu>
parents: 7015
diff changeset
4 2004, 2005, 2006 Free Software Foundation, Inc.
179
Jim Meyering <jim@meyering.net>
parents:
diff changeset
5
Jim Meyering <jim@meyering.net>
parents:
diff changeset
6 This program is free software; you can redistribute it and/or modify
Jim Meyering <jim@meyering.net>
parents:
diff changeset
7 it under the terms of the GNU General Public License as published by
Jim Meyering <jim@meyering.net>
parents:
diff changeset
8 the Free Software Foundation; either version 2, or (at your option)
Jim Meyering <jim@meyering.net>
parents:
diff changeset
9 any later version.
Jim Meyering <jim@meyering.net>
parents:
diff changeset
10
Jim Meyering <jim@meyering.net>
parents:
diff changeset
11 This program is distributed in the hope that it will be useful,
Jim Meyering <jim@meyering.net>
parents:
diff changeset
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
Jim Meyering <jim@meyering.net>
parents:
diff changeset
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
Jim Meyering <jim@meyering.net>
parents:
diff changeset
14 GNU General Public License for more details.
Jim Meyering <jim@meyering.net>
parents:
diff changeset
15
Jim Meyering <jim@meyering.net>
parents:
diff changeset
16 You should have received a copy of the GNU General Public License
640
d60db0e1c0d9 Libit tweaks.
Jim Meyering <jim@meyering.net>
parents: 557
diff changeset
17 along with this program; if not, write to the Free Software Foundation,
5848
a48fb0e98c8c *** empty log message ***
Paul Eggert <eggert@cs.ucla.edu>
parents: 5159
diff changeset
18 Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA. */
179
Jim Meyering <jim@meyering.net>
parents:
diff changeset
19
7302
8a1a9361108c * _fpending.c: Include <config.h> unconditionally, since we no
Paul Eggert <eggert@cs.ucla.edu>
parents: 7015
diff changeset
20 #include <config.h>
179
Jim Meyering <jim@meyering.net>
parents:
diff changeset
21
4144
96e52fc820a5 Include specification first.
Bruno Haible <bruno@clisp.org>
parents: 4142
diff changeset
22 /* Specification. */
96e52fc820a5 Include specification first.
Bruno Haible <bruno@clisp.org>
parents: 4142
diff changeset
23 #ifdef FULL_READ
96e52fc820a5 Include specification first.
Bruno Haible <bruno@clisp.org>
parents: 4142
diff changeset
24 # include "full-read.h"
96e52fc820a5 Include specification first.
Bruno Haible <bruno@clisp.org>
parents: 4142
diff changeset
25 #else
96e52fc820a5 Include specification first.
Bruno Haible <bruno@clisp.org>
parents: 4142
diff changeset
26 # include "full-write.h"
96e52fc820a5 Include specification first.
Bruno Haible <bruno@clisp.org>
parents: 4142
diff changeset
27 #endif
96e52fc820a5 Include specification first.
Bruno Haible <bruno@clisp.org>
parents: 4142
diff changeset
28
4142
1e52316e571b Undefine and define-away `const' after inclusion
Jim Meyering <jim@meyering.net>
parents: 4140
diff changeset
29 #include <errno.h>
1e52316e571b Undefine and define-away `const' after inclusion
Jim Meyering <jim@meyering.net>
parents: 4140
diff changeset
30
4140
40c9aa461079 Rework so that it may serve to define full_read, too.
Jim Meyering <jim@meyering.net>
parents: 4002
diff changeset
31 #ifdef FULL_READ
40c9aa461079 Rework so that it may serve to define full_read, too.
Jim Meyering <jim@meyering.net>
parents: 4002
diff changeset
32 # include "safe-read.h"
40c9aa461079 Rework so that it may serve to define full_read, too.
Jim Meyering <jim@meyering.net>
parents: 4002
diff changeset
33 # define safe_rw safe_read
40c9aa461079 Rework so that it may serve to define full_read, too.
Jim Meyering <jim@meyering.net>
parents: 4002
diff changeset
34 # define full_rw full_read
40c9aa461079 Rework so that it may serve to define full_read, too.
Jim Meyering <jim@meyering.net>
parents: 4002
diff changeset
35 # undef const
40c9aa461079 Rework so that it may serve to define full_read, too.
Jim Meyering <jim@meyering.net>
parents: 4002
diff changeset
36 # define const /* empty */
40c9aa461079 Rework so that it may serve to define full_read, too.
Jim Meyering <jim@meyering.net>
parents: 4002
diff changeset
37 #else
40c9aa461079 Rework so that it may serve to define full_read, too.
Jim Meyering <jim@meyering.net>
parents: 4002
diff changeset
38 # include "safe-write.h"
40c9aa461079 Rework so that it may serve to define full_read, too.
Jim Meyering <jim@meyering.net>
parents: 4002
diff changeset
39 # define safe_rw safe_write
40c9aa461079 Rework so that it may serve to define full_read, too.
Jim Meyering <jim@meyering.net>
parents: 4002
diff changeset
40 # define full_rw full_write
40c9aa461079 Rework so that it may serve to define full_read, too.
Jim Meyering <jim@meyering.net>
parents: 4002
diff changeset
41 #endif
3403
9ab12ba48e48 Correct credits, as cccp.c no longer
Jim Meyering <jim@meyering.net>
parents: 2460
diff changeset
42
4140
40c9aa461079 Rework so that it may serve to define full_read, too.
Jim Meyering <jim@meyering.net>
parents: 4002
diff changeset
43 #ifdef FULL_READ
40c9aa461079 Rework so that it may serve to define full_read, too.
Jim Meyering <jim@meyering.net>
parents: 4002
diff changeset
44 /* Set errno to zero upon EOF. */
40c9aa461079 Rework so that it may serve to define full_read, too.
Jim Meyering <jim@meyering.net>
parents: 4002
diff changeset
45 # define ZERO_BYTE_TRANSFER_ERRNO 0
40c9aa461079 Rework so that it may serve to define full_read, too.
Jim Meyering <jim@meyering.net>
parents: 4002
diff changeset
46 #else
40c9aa461079 Rework so that it may serve to define full_read, too.
Jim Meyering <jim@meyering.net>
parents: 4002
diff changeset
47 /* Some buggy drivers return 0 when one tries to write beyond
40c9aa461079 Rework so that it may serve to define full_read, too.
Jim Meyering <jim@meyering.net>
parents: 4002
diff changeset
48 a device's end. (Example: Linux 1.2.13 on /dev/fd0.)
40c9aa461079 Rework so that it may serve to define full_read, too.
Jim Meyering <jim@meyering.net>
parents: 4002
diff changeset
49 Set errno to ENOSPC so they get a sensible diagnostic. */
40c9aa461079 Rework so that it may serve to define full_read, too.
Jim Meyering <jim@meyering.net>
parents: 4002
diff changeset
50 # define ZERO_BYTE_TRANSFER_ERRNO ENOSPC
40c9aa461079 Rework so that it may serve to define full_read, too.
Jim Meyering <jim@meyering.net>
parents: 4002
diff changeset
51 #endif
4002
9fcf64c770ed Orthogonal approach to read()/write() that handles EINTR and counts > 2^31
Bruno Haible <bruno@clisp.org>
parents: 3403
diff changeset
52
4140
40c9aa461079 Rework so that it may serve to define full_read, too.
Jim Meyering <jim@meyering.net>
parents: 4002
diff changeset
53 /* Write(read) COUNT bytes at BUF to(from) descriptor FD, retrying if
40c9aa461079 Rework so that it may serve to define full_read, too.
Jim Meyering <jim@meyering.net>
parents: 4002
diff changeset
54 interrupted or if a partial write(read) occurs. Return the number
40c9aa461079 Rework so that it may serve to define full_read, too.
Jim Meyering <jim@meyering.net>
parents: 4002
diff changeset
55 of bytes transferred.
40c9aa461079 Rework so that it may serve to define full_read, too.
Jim Meyering <jim@meyering.net>
parents: 4002
diff changeset
56 When writing, set errno if fewer than COUNT bytes are written.
40c9aa461079 Rework so that it may serve to define full_read, too.
Jim Meyering <jim@meyering.net>
parents: 4002
diff changeset
57 When reading, if fewer than COUNT bytes are read, you must examine
40c9aa461079 Rework so that it may serve to define full_read, too.
Jim Meyering <jim@meyering.net>
parents: 4002
diff changeset
58 errno to distinguish failure from EOF (errno == 0). */
3403
9ab12ba48e48 Correct credits, as cccp.c no longer
Jim Meyering <jim@meyering.net>
parents: 2460
diff changeset
59 size_t
4140
40c9aa461079 Rework so that it may serve to define full_read, too.
Jim Meyering <jim@meyering.net>
parents: 4002
diff changeset
60 full_rw (int fd, const void *buf, size_t count)
179
Jim Meyering <jim@meyering.net>
parents:
diff changeset
61 {
4140
40c9aa461079 Rework so that it may serve to define full_read, too.
Jim Meyering <jim@meyering.net>
parents: 4002
diff changeset
62 size_t total = 0;
40c9aa461079 Rework so that it may serve to define full_read, too.
Jim Meyering <jim@meyering.net>
parents: 4002
diff changeset
63 const char *ptr = buf;
181
Jim Meyering <jim@meyering.net>
parents: 180
diff changeset
64
4140
40c9aa461079 Rework so that it may serve to define full_read, too.
Jim Meyering <jim@meyering.net>
parents: 4002
diff changeset
65 while (count > 0)
179
Jim Meyering <jim@meyering.net>
parents:
diff changeset
66 {
4140
40c9aa461079 Rework so that it may serve to define full_read, too.
Jim Meyering <jim@meyering.net>
parents: 4002
diff changeset
67 size_t n_rw = safe_rw (fd, ptr, count);
40c9aa461079 Rework so that it may serve to define full_read, too.
Jim Meyering <jim@meyering.net>
parents: 4002
diff changeset
68 if (n_rw == (size_t) -1)
40c9aa461079 Rework so that it may serve to define full_read, too.
Jim Meyering <jim@meyering.net>
parents: 4002
diff changeset
69 break;
40c9aa461079 Rework so that it may serve to define full_read, too.
Jim Meyering <jim@meyering.net>
parents: 4002
diff changeset
70 if (n_rw == 0)
179
Jim Meyering <jim@meyering.net>
parents:
diff changeset
71 {
4140
40c9aa461079 Rework so that it may serve to define full_read, too.
Jim Meyering <jim@meyering.net>
parents: 4002
diff changeset
72 errno = ZERO_BYTE_TRANSFER_ERRNO;
40c9aa461079 Rework so that it may serve to define full_read, too.
Jim Meyering <jim@meyering.net>
parents: 4002
diff changeset
73 break;
179
Jim Meyering <jim@meyering.net>
parents:
diff changeset
74 }
4140
40c9aa461079 Rework so that it may serve to define full_read, too.
Jim Meyering <jim@meyering.net>
parents: 4002
diff changeset
75 total += n_rw;
40c9aa461079 Rework so that it may serve to define full_read, too.
Jim Meyering <jim@meyering.net>
parents: 4002
diff changeset
76 ptr += n_rw;
40c9aa461079 Rework so that it may serve to define full_read, too.
Jim Meyering <jim@meyering.net>
parents: 4002
diff changeset
77 count -= n_rw;
179
Jim Meyering <jim@meyering.net>
parents:
diff changeset
78 }
4002
9fcf64c770ed Orthogonal approach to read()/write() that handles EINTR and counts > 2^31
Bruno Haible <bruno@clisp.org>
parents: 3403
diff changeset
79
4140
40c9aa461079 Rework so that it may serve to define full_read, too.
Jim Meyering <jim@meyering.net>
parents: 4002
diff changeset
80 return total;
179
Jim Meyering <jim@meyering.net>
parents:
diff changeset
81 }