Mercurial > hg > octave-nkf > gnulib-hg

annotate doc/posix-functions/open.texi @ 17608:63e4133ca82e

Find changesets by keywords (author, files, the commit message), revision number or hash, or revset expression.
relocatable-maint.texi: escape braces The change causes makeinfo 5.2 to fail: env LANG= LC_MESSAGES= LC_ALL= LANGUAGE= makeinfo --no-split --reference-limit=2000 gnulib.texi ./relocatable-maint.texi:153: misplaced { ... Escaping the braces as per the attached patch seems to fix this.
author Daniel Albers <daniel@lbe.rs>
date Thu, 16 Jan 2014 12:56:52 +0100
parents 8d0c35a0ae1d
children 49eed2643636
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
rev   line source
9638
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
1 @node open
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
2 @section @code{open}
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
3 @findex open
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
4
13549
bb0ceefd22dc avoid some overlong lines from posix urls, etc.
Karl Berry <karl@freefriends.org>
parents: 13490
diff changeset
5 POSIX specification:@* @url{http://www.opengroup.org/onlinepubs/9699919799/functions/open.html}
9638
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
6
11922
9750527ffbab fchdir: port to mingw
Eric Blake <ebb9@byu.net>
parents: 10876
diff changeset
7 Gnulib module: open, fchdir
9638
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
8
11922
9750527ffbab fchdir: port to mingw
Eric Blake <ebb9@byu.net>
parents: 10876
diff changeset
9 Portability problems fixed by the Gnulib module open:
9638
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
10 @itemize
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
11 @item
15474
51231c56c0a1 Add dependencies to the 'largefile' module.
Paul Eggert <eggert@cs.ucla.edu>
parents: 14857
diff changeset
12 On platforms where @code{off_t} is a 32-bit type, @code{open} may not work
51231c56c0a1 Add dependencies to the 'largefile' module.
Paul Eggert <eggert@cs.ucla.edu>
parents: 14857
diff changeset
13 correctly with files larger than 2 GB. (Cf. @code{AC_SYS_LARGEFILE}.)
51231c56c0a1 Add dependencies to the 'largefile' module.
Paul Eggert <eggert@cs.ucla.edu>
parents: 14857
diff changeset
14 @item
10201
270b7afb8fb7 Work around open() bug on HP-UX 11 and Solaris 9.
Bruno Haible <bruno@clisp.org>
parents: 9638
diff changeset
15 This function does not fail when the file name argument ends in a slash
10472
a4dc39a18d54 Ensure that a filename ending in a slash cannot be used to access a non-directory.
Bruno Haible <bruno@clisp.org>
parents: 10201
diff changeset
16 and (without the slash) names a nonexistent file or a file that is not a
a4dc39a18d54 Ensure that a filename ending in a slash cannot be used to access a non-directory.
Bruno Haible <bruno@clisp.org>
parents: 10201
diff changeset
17 directory, on some platforms:
13490
e04f4ee19c1b open, fopen: Update regarding AIX.
Bruno Haible <bruno@clisp.org>
parents: 12259
diff changeset
18 FreeBSD 7.2, AIX 7.1, HP-UX 11.00, Solaris 9, Irix 5.3.
10201
270b7afb8fb7 Work around open() bug on HP-UX 11 and Solaris 9.
Bruno Haible <bruno@clisp.org>
parents: 9638
diff changeset
19 @item
14594
e270695eecd5 Move the support of O_NONBLOCK in open() to the 'open' module.
Bruno Haible <bruno@clisp.org>
parents: 13549
diff changeset
20 This function does not support the @code{O_NONBLOCK} flag when it is defined
14857
cef4d5bc6b72 doc: Fix a module name.
Bruno Haible <bruno@clisp.org>
parents: 14594
diff changeset
21 by the gnulib module @code{nonblocking} on some platforms:
15607
6355dc4626b5 doc: Update regarding MSVC 9.
Bruno Haible <bruno@clisp.org>
parents: 15474
diff changeset
22 mingw, MSVC 9.
14594
e270695eecd5 Move the support of O_NONBLOCK in open() to the 'open' module.
Bruno Haible <bruno@clisp.org>
parents: 13549
diff changeset
23 @item
9638
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
24 On Windows platforms (excluding Cygwin), this function does usually not
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
25 recognize the @file{/dev/null} filename.
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
26 @end itemize
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
27
11922
9750527ffbab fchdir: port to mingw
Eric Blake <ebb9@byu.net>
parents: 10876
diff changeset
28 Portability problems fixed by the Gnulib module fchdir:
9750527ffbab fchdir: port to mingw
Eric Blake <ebb9@byu.net>
parents: 10876
diff changeset
29 @itemize
9750527ffbab fchdir: port to mingw
Eric Blake <ebb9@byu.net>
parents: 10876
diff changeset
30 @item
9750527ffbab fchdir: port to mingw
Eric Blake <ebb9@byu.net>
parents: 10876
diff changeset
31 On Windows platforms (excluding Cygwin), this function fails to open a
9750527ffbab fchdir: port to mingw
Eric Blake <ebb9@byu.net>
parents: 10876
diff changeset
32 read-only descriptor for directories.
9750527ffbab fchdir: port to mingw
Eric Blake <ebb9@byu.net>
parents: 10876
diff changeset
33 @end itemize
9750527ffbab fchdir: port to mingw
Eric Blake <ebb9@byu.net>
parents: 10876
diff changeset
34
9638
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
35 Portability problems not fixed by Gnulib:
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
36 @itemize
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
37 @item
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
38 On Windows, this function returns a file handle in @code{O_TEXT} mode by
16236
8d0c35a0ae1d doc: fix minor quoting issues, mostly with `
Paul Eggert <eggert@cs.ucla.edu>
parents: 15607
diff changeset
39 default; this means that it translates @code{'\n'} to CR/LF by default. Use the
9638
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
40 @code{O_BINARY} flag if you need reliable binary I/O.
070329237839 Rename two directories: headers -> posix-headers, functions -> posix-functions.
Bruno Haible <bruno@clisp.org>
parents:
diff changeset
41 @end itemize