annotate lib/binary-io.h @ 14079:97fc9a21a8fb

maint: update almost all copyright ranges to include 2011 Run the new "make update-copyright" rule.
author Jim Meyering <meyering@redhat.com>
date Sat, 01 Jan 2011 20:17:23 +0100
parents c2cbabec01dd
children f6ec6d171e52
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
4273
72b1283160ce New module 'binary-io'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
1 /* Binary mode I/O.
14079
97fc9a21a8fb maint: update almost all copyright ranges to include 2011
Jim Meyering <meyering@redhat.com>
parents: 12559
diff changeset
2 Copyright (C) 2001, 2003, 2005, 2008-2011 Free Software Foundation, Inc.
4273
72b1283160ce New module 'binary-io'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
3
9309
bbbbbf4cd1c5 Change copyright notice from GPLv2+ to GPLv3+.
Bruno Haible <bruno@clisp.org>
parents: 5916
diff changeset
4 This program is free software: you can redistribute it and/or modify
4273
72b1283160ce New module 'binary-io'.
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: 5916
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: 5916
diff changeset
7 (at your option) any later version.
4273
72b1283160ce New module 'binary-io'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
8
72b1283160ce New module 'binary-io'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
9 This program is distributed in the hope that it will be useful,
72b1283160ce New module 'binary-io'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
10 but WITHOUT ANY WARRANTY; without even the implied warranty of
72b1283160ce New module 'binary-io'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
11 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
72b1283160ce New module 'binary-io'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
12 GNU General Public License for more details.
72b1283160ce New module 'binary-io'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
13
72b1283160ce New module 'binary-io'.
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: 5916
diff changeset
15 along with this program. If not, see <http://www.gnu.org/licenses/>. */
4273
72b1283160ce New module 'binary-io'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
16
72b1283160ce New module 'binary-io'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
17 #ifndef _BINARY_H
72b1283160ce New module 'binary-io'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
18 #define _BINARY_H
72b1283160ce New module 'binary-io'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
19
72b1283160ce New module 'binary-io'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
20 /* For systems that distinguish between text and binary I/O.
72b1283160ce New module 'binary-io'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
21 O_BINARY is usually declared in <fcntl.h>. */
4608
a079d84287d0 Make it work with MSVC.
Bruno Haible <bruno@clisp.org>
parents: 4273
diff changeset
22 #include <fcntl.h>
a079d84287d0 Make it work with MSVC.
Bruno Haible <bruno@clisp.org>
parents: 4273
diff changeset
23
a079d84287d0 Make it work with MSVC.
Bruno Haible <bruno@clisp.org>
parents: 4273
diff changeset
24 /* The MSVC7 <stdio.h> doesn't like to be included after '#define fileno ...',
a079d84287d0 Make it work with MSVC.
Bruno Haible <bruno@clisp.org>
parents: 4273
diff changeset
25 so we include it here first. */
a079d84287d0 Make it work with MSVC.
Bruno Haible <bruno@clisp.org>
parents: 4273
diff changeset
26 #include <stdio.h>
a079d84287d0 Make it work with MSVC.
Bruno Haible <bruno@clisp.org>
parents: 4273
diff changeset
27
4273
72b1283160ce New module 'binary-io'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
28 #if !defined O_BINARY && defined _O_BINARY
72b1283160ce New module 'binary-io'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
29 /* For MSC-compatible compilers. */
72b1283160ce New module 'binary-io'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
30 # define O_BINARY _O_BINARY
72b1283160ce New module 'binary-io'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
31 # define O_TEXT _O_TEXT
72b1283160ce New module 'binary-io'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
32 #endif
10778
ddc567d280d1 Treat Haiku like BeOS.
Ingo Weinhold <ingo_weinhold@gmx.de>
parents: 9905
diff changeset
33 #if defined __BEOS__ || defined __HAIKU__
ddc567d280d1 Treat Haiku like BeOS.
Ingo Weinhold <ingo_weinhold@gmx.de>
parents: 9905
diff changeset
34 /* BeOS 5 and Haiku have O_BINARY and O_TEXT, but they have no effect. */
4273
72b1283160ce New module 'binary-io'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
35 # undef O_BINARY
72b1283160ce New module 'binary-io'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
36 # undef O_TEXT
72b1283160ce New module 'binary-io'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
37 #endif
12498
7aad334c08d7 binary-io: Avoid gcc warning due to SET_BINARY.
Bruno Haible <bruno@clisp.org>
parents: 12453
diff changeset
38
7aad334c08d7 binary-io: Avoid gcc warning due to SET_BINARY.
Bruno Haible <bruno@clisp.org>
parents: 12453
diff changeset
39 /* SET_BINARY (fd);
7aad334c08d7 binary-io: Avoid gcc warning due to SET_BINARY.
Bruno Haible <bruno@clisp.org>
parents: 12453
diff changeset
40 changes the file descriptor fd to perform binary I/O. */
4273
72b1283160ce New module 'binary-io'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
41 #if O_BINARY
9905
f2fd1d89ec4b Avoid warning on emx+gcc.
Bruno Haible <bruno@clisp.org>
parents: 9309
diff changeset
42 # if defined __EMX__ || defined __DJGPP__ || defined __CYGWIN__
f2fd1d89ec4b Avoid warning on emx+gcc.
Bruno Haible <bruno@clisp.org>
parents: 9309
diff changeset
43 # include <io.h> /* declares setmode() */
f2fd1d89ec4b Avoid warning on emx+gcc.
Bruno Haible <bruno@clisp.org>
parents: 9309
diff changeset
44 # else
4273
72b1283160ce New module 'binary-io'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
45 # define setmode _setmode
5916
e9721cce07d6 Avoid gcc warning on mingw.
Bruno Haible <bruno@clisp.org>
parents: 5848
diff changeset
46 # undef fileno
4273
72b1283160ce New module 'binary-io'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
47 # define fileno _fileno
72b1283160ce New module 'binary-io'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
48 # endif
72b1283160ce New module 'binary-io'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
49 # ifdef __DJGPP__
72b1283160ce New module 'binary-io'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
50 # include <unistd.h> /* declares isatty() */
12453
41db359d31ee binary-io: avoid potential compilation warning
Eric Blake <ebb9@byu.net>
parents: 10778
diff changeset
51 /* Avoid putting stdin/stdout in binary mode if it is connected to
41db359d31ee binary-io: avoid potential compilation warning
Eric Blake <ebb9@byu.net>
parents: 10778
diff changeset
52 the console, because that would make it impossible for the user
41db359d31ee binary-io: avoid potential compilation warning
Eric Blake <ebb9@byu.net>
parents: 10778
diff changeset
53 to interrupt the program through Ctrl-C or Ctrl-Break. */
12498
7aad334c08d7 binary-io: Avoid gcc warning due to SET_BINARY.
Bruno Haible <bruno@clisp.org>
parents: 12453
diff changeset
54 # define SET_BINARY(fd) ((void) (!isatty (fd) ? (setmode (fd, O_BINARY), 0) : 0))
4273
72b1283160ce New module 'binary-io'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
55 # else
12498
7aad334c08d7 binary-io: Avoid gcc warning due to SET_BINARY.
Bruno Haible <bruno@clisp.org>
parents: 12453
diff changeset
56 # define SET_BINARY(fd) ((void) setmode (fd, O_BINARY))
4273
72b1283160ce New module 'binary-io'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
57 # endif
72b1283160ce New module 'binary-io'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
58 #else
72b1283160ce New module 'binary-io'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
59 /* On reasonable systems, binary I/O is the default. */
4611
35fed2680490 Avoid warning on QNX.
Bruno Haible <bruno@clisp.org>
parents: 4608
diff changeset
60 # undef O_BINARY
4273
72b1283160ce New module 'binary-io'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
61 # define O_BINARY 0
12498
7aad334c08d7 binary-io: Avoid gcc warning due to SET_BINARY.
Bruno Haible <bruno@clisp.org>
parents: 12453
diff changeset
62 # define SET_BINARY(fd) /* do nothing */ ((void) 0)
4273
72b1283160ce New module 'binary-io'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
63 #endif
72b1283160ce New module 'binary-io'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
64
72b1283160ce New module 'binary-io'.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
65 #endif /* _BINARY_H */