aboutsummaryrefslogtreecommitdiff
path: root/manual/llio.texi
diff options
context:
space:
mode:
authorUlrich Drepper <drepper@redhat.com>1998-06-15 18:12:05 +0000
committerUlrich Drepper <drepper@redhat.com>1998-06-15 18:12:05 +0000
commitfed8f7f7aeb06dfae0dfbfb085c6857cc457c254 (patch)
tree292caa308359deaa5fed820469d0b37805126e68 /manual/llio.texi
parente5bafd559a4c155fa9d1b1a669c67d99ea773565 (diff)
downloadglibc-fed8f7f7aeb06dfae0dfbfb085c6857cc457c254.tar
glibc-fed8f7f7aeb06dfae0dfbfb085c6857cc457c254.tar.gz
glibc-fed8f7f7aeb06dfae0dfbfb085c6857cc457c254.tar.bz2
glibc-fed8f7f7aeb06dfae0dfbfb085c6857cc457c254.zip
Update.
1998-06-15 18:07 Ulrich Drepper <drepper@cygnus.com> * iconvdata/ksc5601.h: Clean up a bit. 1998-06-15 14:35 Ulrich Drepper <drepper@cygnus.com> * sunrpc/svc_tcp.c (readtcp): Also listen to all the other connections and process incoming data. * sunrpc/xdr_rec.c (set_input_fragment): Only recognize zero length fragments as invalid. Patches by Thorsten Kukuk <kukuk@weber.uni-paderborn.de>. 1998-06-13 Andreas Jaeger <aj@arthur.rhein-neckar.de> Removal of duplicates like "the the". * manual/time.texi (TZ Variable): Likewise. * manual/users.texi (Manipulating the Database): Likewise. * manual/sysinfo.texi (Filesystem handling): Likewise. * manual/signal.texi (Signaling Yourself): Likewise. * manual/message.texi (Message Translation): Likewise. (Common Usage): Likewise. * manual/llio.texi: Likewise. * manual/arith.texi (Old-style number conversion): Likewise. * manual/argp.texi (Argp): Likewise. (Argp Parsers): Likewise. (Argp Help Filtering): Likewise. * hesiod/README.hesiod: Correct typo. * manual/llio.texi: Correct typos. * manual/sysinfo.texi: Likewise. 1998-06-13 Andreas Jaeger <aj@arthur.rhein-neckar.de> * rt/aio.h: Rename __op to __operation for g++. 1998-06-13 20:17 -0400 Zack Weinberg <zack@rabi.phys.columbia.edu> * iconvdata/gen-8bit-gap.sh: Use awk not perl. Clean up sed script. * iconvdata/gen-8bit-gap-1.sh: Likewise. * iconvdata/gen-8bit.sh: Clean up sed script. * iconvdata/Makefile: Remove all PERL conditionals; build all the modules all the time. Export AWK. (gen-8bit-gap): Delete setting of PERL. (gen-8bit-gap-1): Likewise. (perl-generated-headers): Renamed awk-generated-headers. * iconvdata/gap.pl: Removed. * iconvdata/gaptab.pl: Removed. * iconvdata/gap.awk: New file. * iconvdata/gaptab.awk: New file. 1998-06-15 Ulrich Drepper <drepper@cygnus.com> * sysdeps/generic/Dist: Add errno-loc.c. * sysdeps/unix/sysv/linux/alpha/glob.c: Add prototypes for the __new_* functions. 1998-06-14 14:21 -0400 Zack Weinberg <zack@rabi.phys.columbia.edu> * stdio-common/bug12.c: New test for fread()/fseek(). * stdio-common/Makefile (tests): Add bug12.
Diffstat (limited to 'manual/llio.texi')
-rw-r--r--manual/llio.texi88
1 files changed, 44 insertions, 44 deletions
diff --git a/manual/llio.texi b/manual/llio.texi
index e0b16716ab..6387eecbe0 100644
--- a/manual/llio.texi
+++ b/manual/llio.texi
@@ -142,7 +142,7 @@ or @code{O_CREAT} is set and the file does not already exist.
If on a 32 bits machine the sources are translated with
@code{_FILE_OFFSET_BITS == 64} the function @code{open} returns a file
descriptor opened in the large file mode which enables the file handling
-functions to use files up to @math{2^63} in size and offset from
+functions to use files up to @math{2^63} bytes in size and offset from
@math{-2^63} to @math{2^63}. This happens transparently for the user
since all of the lowlevel file handling functions are equally replaced.
@@ -266,7 +266,7 @@ on their meaning.
Please note that there is @emph{no} separate @code{close64} function.
This is not necessary since this function does not determine nor depend
-on the more of the file. The kernel which performs the @code{close}
+on the mode of the file. The kernel which performs the @code{close}
operation knows for which mode the descriptor is used and can handle
this situation.
@end deftypefun
@@ -1402,7 +1402,7 @@ These functions are part of the library with realtime functions named
The implementation of these functions can be done using support in the
kernel (if available) or using an implementation based on threads at
userlevel. In the latter case it might be necessary to link applications
-with the thread library @file{libthread} in addition to @file{librt}.
+with the thread library @file{libpthread} in addition to @file{librt}.
All AIO operations operate on files which were opened previously. There
might be arbitrary many operations for one file running. The
@@ -1429,8 +1429,8 @@ I.e., it is not possible to use any of the AIO operations on devices
like terminals where an @code{lseek} call would lead to an error.
@item off_t aio_offset
-This element specified at which offset in the file the operation (input
-or output) is performed. Since the operation are carried in arbitrary
+This element specifies at which offset in the file the operation (input
+or output) is performed. Since the operations are carried out in arbitrary
order and more than one operation for one file descriptor can be
started, one cannot expect a current read/write position of the file
descriptor.
@@ -1451,10 +1451,10 @@ AIO operation.
@item struct sigevent aio_sigevent
This element specifies how the calling process is notified once the
-operation terminated. If the @code{sigev_notify} element is
+operation terminates. If the @code{sigev_notify} element is
@code{SIGEV_NONE} no notification is send. If it is @code{SIGEV_SIGNAL}
the signal determined by @code{sigev_signo} is send. Otherwise
-@code{sigev_notify} must be @code{SIGEV_THREAD} in which case a thread
+@code{sigev_notify} must be @code{SIGEV_THREAD}. In this case a thread
is created which starts executing the function pointed to by
@code{sigev_notify_function}.
@@ -1478,12 +1478,12 @@ Start a write operation. Write @code{aio_nbytes} bytes starting at
@item LIO_NOP
Do nothing for this control block. This value is useful sometimes when
an array of @code{struct aiocb} values contains holes, i.e., some of the
-values must not be handled allthough the whole array is presented to the
+values must not be handled although the whole array is presented to the
@code{lio_listio} function.
@end vtable
@end table
-When the sourcs are compiled using @code{_FILE_OFFSET_BITS == 64} on a
+When the sources are compiled using @code{_FILE_OFFSET_BITS == 64} on a
32 bits machine this type is in fact @code{struct aiocb64} since the LFS
interface transparently replaces the @code{struct aiocb} definition.
@end deftp
@@ -1529,7 +1529,7 @@ AIO operation.
@item struct sigevent aio_sigevent
This element specifies how the calling process is notified once the
-operation terminated. If the @code{sigev_notify} element is
+operation terminates. If the @code{sigev_notify} element is
@code{SIGEV_NONE} no notification is send. If it is @code{SIGEV_SIGNAL}
the signal determined by @code{sigev_signo} is send. Otherwise
@code{sigev_notify} must be @code{SIGEV_THREAD} in which case a thread
@@ -1539,7 +1539,7 @@ which starts executing the function pointeed to by
@item int aio_lio_opcode
This element is only used by the @code{lio_listio} and
@code{[lio_listio64} functions. Since these functions allow to start an
-arbitrary number of operations at once and since each operationcan be
+arbitrary number of operations at once and since each operation can be
input or output (or nothing) the information must be stored in the
control block. See the description of @code{struct aiocb} for a description
of the possible values.
@@ -1566,7 +1566,7 @@ aiocb64} since the LFS replaces transparently the old interface.
@deftypefun int aio_read (struct aiocb *@var{aiocbp})
This function initiates an asynchronous read operation. The function
call immediately returns after the operation was enqueued or when an
-error was encoutered.
+error was encountered.
The first @code{aiocbp->aio_nbytes} bytes of the file for which
@code{aiocbp->aio_fildes} is a descriptor are written to the buffer
@@ -1593,8 +1593,8 @@ limitations.
The @code{aio_read} function is not implemented.
@item EBADF
The @code{aiocbp->aio_fildes} descriptor is not valid. This condition
-need not be recognized before enqueueing the request and so this error
-might also be signaled asynchrously.
+needs not be recognized before enqueueing the request and so this error
+might also be signaled asynchronously.
@item EINVAL
The @code{aiocbp->aio_offset} or @code{aiocbp->aio_reqpiro} value is
invalid. This condition need not be recognized before enqueueing the
@@ -1609,7 +1609,7 @@ functions. As long as the value returned by @code{aio_error} is
otherwise the value is to be interpreted as an error code. If the
function terminated the result of the operation can be get using a call
to @code{aio_return}. The returned value is the same as an equivalent
-call to @code{read} would have returned. Possible error code returned
+call to @code{read} would have returned. Possible error codes returned
by @code{aio_error} are:
@table @code
@@ -1635,7 +1635,7 @@ difference is that on @w{32 bits} machines the file descriptor should
be opened in the large file mode. Internally @code{aio_read64} uses
functionality equivalent to @code{lseek64} (@pxref{File Position
Primitive}) to position the file descriptor correctly for the reading,
-as opposed to @code{lseek} funcationality used in @code{aio_read}.
+as opposed to @code{lseek} functionality used in @code{aio_read}.
When the sources are compiled with @code{_FILE_OFFSET_BITS == 64} this
function is available under the name @code{aio_read} and so transparently
@@ -1650,7 +1650,7 @@ of functions with a very similar interface.
@deftypefun int aio_write (struct aiocb *@var{aiocbp})
This function initiates an asynchronous write operation. The function
call immediately returns after the operation was enqueued or if before
-this happens an error was encoutered.
+this happens an error was encountered.
The first @code{aiocbp->aio_nbytes} bytes from the buffer starting at
@code{aiocbp->aio_buf} are written to the file for which
@@ -1677,12 +1677,12 @@ limitations.
The @code{aio_write} function is not implemented.
@item EBADF
The @code{aiocbp->aio_fildes} descriptor is not valid. This condition
-need not be recognized before enqueueing the request and so this error
-might also be signaled asynchrously.
+needs not be recognized before enqueueing the request and so this error
+might also be signaled asynchronously.
@item EINVAL
The @code{aiocbp->aio_offset} or @code{aiocbp->aio_reqpiro} value is
-invalid. This condition need not be recognized before enqueueing the
-request and so this error might also be signaled asynchrously.
+invalid. This condition needs not be recognized before enqueueing the
+request and so this error might also be signaled asynchronously.
@end table
In the case @code{aio_write} returns zero the current status of the
@@ -1715,11 +1715,11 @@ replaces the normal implementation.
@comment Unix98
@deftypefun int aio_write64 (struct aiocb *@var{aiocbp})
This function is similar to the @code{aio_write} function. The only
-difference is that only @w{32 bits} machines the file descriptor should
+difference is that on @w{32 bits} machines the file descriptor should
be opened in the large file mode. Internally @code{aio_write64} uses
functionality equivalent to @code{lseek64} (@pxref{File Position
Primitive}) to position the file descriptor correctly for the writing,
-as opposed to @code{lseek} funcationality used in @code{aio_write}.
+as opposed to @code{lseek} functionality used in @code{aio_write}.
When the sources are compiled with @code{_FILE_OFFSET_BITS == 64} this
function is available under the name @code{aio_write} and so transparently
@@ -1755,14 +1755,14 @@ a time. Another situation is where the @code{lio_listio} call was
cancelled before all requests are processed (@pxref{Cancel AIO
Operations}) and the remaining requests have to be reissued.
-The the other members of each element of the array pointed to by
+The other members of each element of the array pointed to by
@code{list} must have values suitable for the operation as described in
the documentation for @code{aio_read} and @code{aio_write} above.
The @var{mode} argument determines how @code{lio_listio} behaves after
having enqueued all the requests. If @var{mode} is @code{LIO_WAIT} it
waits until all requests terminated. Otherwise @var{mode} must be
-@code{LIO_NOWAIT} and in this case the function returns immeditely after
+@code{LIO_NOWAIT} and in this case the function returns immediately after
having enqueued all the requests. In this case the caller gets a
notification of the termination of all requests according to the
@var{sig} parameter. If @var{sig} is @code{NULL} no notification is
@@ -1793,7 +1793,7 @@ The resources necessary to queue all the requests are not available in
the moment. The error status for each element of @var{list} must be
checked which request failed.
-Another reason could be that the systemwide limit of AIO requests is
+Another reason could be that the system wide limit of AIO requests is
exceeded. This cannot be the case for the implementation on GNU systems
since no arbitrary limits exist.
@item EINVAL
@@ -1801,7 +1801,7 @@ The @var{mode} parameter is invalid or @var{nent} is larger than
@code{AIO_LISTIO_MAX}.
@item EIO
One or more of the request's I/O operations failed. The error status of
-each request should be checked which one failed.
+each request should be checked for which one failed.
@item ENOSYS
The @code{lio_listio} function is not supported.
@end table
@@ -1823,7 +1823,7 @@ difference is that only @w{32 bits} machines the file descriptor should
be opened in the large file mode. Internally @code{lio_listio64} uses
functionality equivalent to @code{lseek64} (@pxref{File Position
Primitive}) to position the file descriptor correctly for the reading or
-writing, as opposed to @code{lseek} funcationality used in
+writing, as opposed to @code{lseek} functionality used in
@code{lio_listio}.
When the sources are compiled with @code{_FILE_OFFSET_BITS == 64} this
@@ -1835,7 +1835,7 @@ machines.
@node Status of AIO Operations
@subsection Getting the Status of AIO Operations
-As already decsribes in the documentation of the functions in the last
+As already described in the documentation of the functions in the last
section it must be possible to get information about the status of a I/O
request. When the operation is performed really asynchronous (as with
@code{aio_read} and @code{aio_write} and with @code{aio_listio} when the
@@ -1847,11 +1847,11 @@ The following two function allow to get this kind of information.
@comment POSIX.1b
@deftypefun int aio_error (const struct aiocb *@var{aiocbp})
This function determines the error state of the request described by the
-@code{struct aiocb} variable pointed to by @var{aiocbp}. If the the
+@code{struct aiocb} variable pointed to by @var{aiocbp}. If the
request has not yet terminated the value returned is always
@code{EINPROGRESS}. Once the request has terminated the value
@code{aio_error} returns is either @math{0} if the request completed
-successfully or it returns the the value which would be stored in the
+successfully or it returns the value which would be stored in the
@code{errno} variable if the request would have been done using
@code{read}, @code{write}, or @code{fsync}.
@@ -1886,8 +1886,8 @@ carried out by the request described in the variable pointed to by
by @code{aio_error} is @code{EINPROGRESS} the return of this function is
undefined.
-Once the request is finished this function can used used exactly once to
-retriece the return value. Following calls might lead to undefined
+Once the request is finished this function can be used exactly once to
+retrieve the return value. Following calls might lead to undefined
behaviour. The return value itself is the value which would have been
returned by the @code{read}, @code{write}, or @code{fsync} call.
@@ -1917,10 +1917,10 @@ machines.
@subsection Getting into a Consistent State
When dealing with asynchronous operations it is sometimes necessary to
-get into a consistent state. This would mean for AIO that ones wants to
+get into a consistent state. This would mean for AIO that one wants to
know whether a certain request or a group of request were processed.
This could be done by waiting for the notification sent by the system
-after the operation terminated but this sometimes would been a wasting
+after the operation terminated but this sometimes would mean wasting
resources (mainly computation time). Instead POSIX.1b defines two
functions which will help with most kinds of consistency.
@@ -1933,7 +1933,7 @@ defined.
@comment POSIX.1b
@deftypefun int aio_fsync (int @var{op}, struct aiocb *@var{aiocbp})
Calling this function forces all I/O operations operating queued at the
-time of the function call operating on the file desriptor
+time of the function call operating on the file descriptor
@code{aiocbp->aio_fildes} into the synchronized I/O completion state
(@pxref{Synchronizing I/O}). The @code{aio_fsync} function return
immediately but the notification through the method described in
@@ -1944,12 +1944,12 @@ after the synchronization request are not effected.
If @var{op} is @code{O_DSYNC} the synchronization happens as with a call
to @code{fdatasync}. Otherwise @var{op} should be @code{O_SYNC} and
-thee synchronization happens as with @code{fsync}.
+the synchronization happens as with @code{fsync}.
-As long as the synchronization hasn't happened a call to
+As long as the synchronization has not happened a call to
@code{aio_error} with the reference to the object pointed to by
-@var{aiocbp} returns @code{EINPROGRESS}. Once the synchronizatio is
-done @code{aio_error} return @math{0} if the synchronization wasn
+@var{aiocbp} returns @code{EINPROGRESS}. Once the synchronization is
+done @code{aio_error} return @math{0} if the synchronization was not
successful. Otherwise the value returned is the value to which the
@code{fsync} or @code{fdatasync} function would have set the
@code{errno} variable. In this case nothing can be assumed about the
@@ -1961,7 +1961,7 @@ successfully filed. Otherwise the return value is @math{-1} and
@table @code
@item EAGAIN
-The request coulnd't be enqueued due to temporary lack of resources.
+The request could not be enqueued due to temporary lack of resources.
@item EBADF
The file descriptor @code{aiocbp->aio_fildes} is not valid or not open
for writing.
@@ -1990,7 +1990,7 @@ transparently replaces the interface for small files on 32 bits
machines.
@end deftypefun
-Another method of synchronization is to until one or more requests of a
+Another method of synchronization is to wait until one or more requests of a
specific set terminated. This could be achieved by the @code{aio_*}
functions to notify the initiating process about the termination but in
some situations this is not the ideal solution. In a program which
@@ -2020,7 +2020,7 @@ finished. If @var{timeout} is not @code{NULL} the process remains
suspended at as long as specified in @var{timeout}. In this case
@code{aio_suspend} returns with an error.
-The return value of the function is @math{0} is one or more requests
+The return value of the function is @math{0} if one or more requests
from the @var{list} have terminated. Otherwise the function returns
@math{-1} and @code{errno} is set to one of the following values:
@@ -2135,7 +2135,7 @@ The POSIX standard does not specify how the AIO functions are
implemented. They could be system calls but it is also possible to
emulate them at userlevel.
-At least the available implementatio at the point of this writing is a
+At least the available implementation at the point of this writing is a
userlevel implementation which uses threads for handling the enqueued
requests. This implementation requires to make some decisions about
limitations but hard limitations are something which better should be