Hallo, dies ist ein Test.

PWD: /www/data-lst1/unixsoft/unixsoft/kaempfer/.public_html

Running in File Mode
Relative path: ./../../.././../../../usr/man/man3c/aiowait.3c
Real path: /usr/share/man/man3c/aiowait.3c
Zurück

'\" te .\" Copyright (c) 2008, Oracle and/or its affiliates. All rights reserved. .TH aiowait 3C "5 Feb 2008" "Oracle Solaris 11.4" "Standard C Library Functions" .SH NAME aiowait \- wait for completion of asynchronous I/O operation .SH SYNOPSIS .LP .nf #include <sys/asynch.h> #include <sys/time.h> \fBaio_result_t *\fR\fBaiowait\fR(\fBconst struct timeval *\fR\fItimeout\fR); .fi .SH DESCRIPTION .sp .LP The \fBaiowait()\fR function suspends the calling process until one of its outstanding asynchronous I/O operations completes, providing a synchronous method of notification. .sp .LP If \fItimeout\fR is a non-zero pointer, it specifies a maximum interval to wait for the completion of an asynchronous I/O operation. If \fItimeout\fR is a zero pointer, \fBaiowait()\fR blocks indefinitely. To effect a poll, the \fItimeout\fR parameter should be non-zero, pointing to a zero-valued \fItimeval\fR structure. .sp .LP The \fBtimeval\fR structure is defined in <\fBsys/time.h\fR> and contains the following members: .sp .in +2 .nf long tv_sec; /* seconds */ long tv_usec; /* and microseconds */ .fi .in -2 .sp .SH RETURN VALUES .sp .LP Upon successful completion, \fBaiowait()\fR returns a pointer to the result structure used when the completed asynchronous I/O operation was requested. Upon failure, \fBaiowait()\fR returns \fB\(mi1\fR and sets \fBerrno\fR to indicate the error. \fBaiowait()\fR returns \fB0\fR if the time limit expires. .SH ERRORS .sp .LP The \fBaiowait()\fR function will fail if: .sp .ne 2 .mk .na \fB\fBEFAULT\fR\fR .ad .RS 10n .rt The \fItimeout\fR argument points to an address outside the address space of the requesting process. See \fBNOTES\fR. .RE .sp .ne 2 .mk .na \fB\fBEINTR\fR\fR .ad .RS 10n .rt The execution of \fBaiowait()\fR was interrupted by a signal. .RE .sp .ne 2 .mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n .rt There are no outstanding asynchronous I/O requests. .RE .sp .ne 2 .mk .na \fB\fBEINVAL\fR\fR .ad .RS 10n .rt The \fBtv_secs\fR member of the \fBtimeval\fR structure pointed to by \fItimeout\fR is less than 0 or the \fBtv_usecs\fR member is greater than the number of seconds in a microsecond. .RE .SH ATTRIBUTES .sp .LP See \fBattributes\fR(7) for descriptions of the following attributes: .sp .TS tab( ) box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) . ATTRIBUTE TYPE ATTRIBUTE VALUE _ MT-Level Safe .TE .sp .SH SEE ALSO .sp .LP \fBaiocancel\fR(3C), \fBaioread\fR(3C), \fBattributes\fR(7) .SH NOTES .sp .LP The \fBaiowait()\fR function is the only way to dequeue an asynchronous notification. It can be used either inside a \fBSIGIO\fR signal handler or in the main program. One \fBSIGIO\fR signal can represent several queued events. .sp .LP Passing an illegal address as \fItimeout\fR will result in setting \fBerrno\fR to \fBEFAULT\fR only if detected by the application process.