Hallo, dies ist ein Test.

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

Running in File Mode
Relative path: ./../../../../.././../usr/man/man3dax/dax_poll.3dax
Real path: /usr/share/man/man3dax/dax_poll.3dax
Zurück

'\" te .\" Copyright (c) 2016, 2017, Oracle and/or its affiliates. All rights reserved. .TH dax_poll 3DAX "03 Mar 2017" "Oracle Solaris 11.4" "DAX Library Functions" .SH NAME dax_poll \- poll for command completion .SH SYNOPSIS .LP .nf cc [ flag... ] file... -ldax [ library...] #include <dax.h> int dax_poll(dax_queue_t *\fIqueue\fR, dax_poll_t \fIres\fR[], int \fInres\fR, int64_t \fItimeout\fR); .fi .SH DESCRIPTION .sp .LP This function polls for the completion of up to \fInres\fR requests posted to the \fIqueue\fR. Returns the status of the completed requests in the \fIres\fR array. .sp .LP The behavior of this function for various values of the \fItimeout\fR parameter is as follows: .RS +4 .TP .ie t \(bu .el o If \fBtimeout < 0\fR, waits indefinitely for the \fInres\fR requests to complete. .RE .RS +4 .TP .ie t \(bu .el o If \fBtimeout == 0\fR, returns immediately with the results of at most \fInres\fR completed requests. .RE .RS +4 .TP .ie t \(bu .el o If \fBtimeout > 0\fR, waits for \fItimeout\fR nanoseconds to elapse, or for \fInres\fR requests to complete, whichever is first. .RE .sp .LP The members of the \fBdax_poll_t\fR structure are: .sp .ne 2 .mk .na \fBudata\fR .ad .RS 10n .rt The \fBudata\fR value for the operation that completed, as passed to the corresponding post function. .RE .sp .ne 2 .mk .na \fBstatus\fR .ad .RS 10n .rt The completion status. Possible values are the return values in the \fBdax_result_t status\fR field for the corresponding non-poll function, plus: .sp .ne 2 .mk .na \fBDAX_EPIPE\fR .ad .RS 13n .rt The current request piped its output to another request, and the other request completed with \fBstatus != DAX_SUCCESS\fR or another request piped its output to the current request, and the other request completed with \fBstatus != DAX_SUCCESS\fR. .RE .RE .sp .ne 2 .mk .na \fBcount\fR .ad .RS 10n .rt Result count. Possible values are the return values in the \fBdax_result_t count\fR field for the corresponding non-poll function. .RE .SH RETURN VALUES .sp .ne 2 .mk .na \fB\fB0\fR\fR .ad .RS 20n .rt No requests completed .RE .sp .ne 2 .mk .na \fBA positive value\fR .ad .RS 20n .rt The number of requests completed .RE .sp .ne 2 .mk .na \fB\fBDAX_EQEMPTY\fR\fR .ad .RS 20n .rt No requests are pending .RE .sp .ne 2 .mk .na \fB\fBDAX_EINVAL\fR\fR .ad .RS 20n .rt \fInres\fR is 0 or negative .RE .sp .ne 2 .mk .na \fB\fBDAX_ETHREAD\fR\fR .ad .RS 20n .rt The calling thread did not create the \fIqueue\fR .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 _ Availability system/library _ Interface Stability Committed .TE .sp .SH SEE ALSO .sp .LP \fBlibdax\fR(3LIB), \fBdax_queue_create\fR(3DAX), \fBdax_post\fR(3DAX) .SH NOTES .sp .LP This function moves the requests that are yet to start from the software \fBdax_queue_t\fR queue to the DAX hardware queue as and when space is available in the DAX hardware. Therefore, to guarantee forward progress, periodic calls to the \fBdax_poll()\fR function are necessary.