개요

• 솔라나라에 설명된 어플리케이션에 대해 맨 페이지를 찾아 출력한다.
• MAN 페이지에 대한 설명은 윈디하나의 솔라나라: MAN 페이지을 참고하자.
• svcadm(8)을 검색하려면 섹션에서 8 을 선택하고, 맨 페이지 이름에 svcadm을 입력하고 검색을 누른다.

aio_error(3c)

Standard C Library Functions                                     aio_error(3C)



NAME
       aio_error - retrieve errors status for an asynchronous I/O operation

SYNOPSIS
       #include <aio.h>

       int aio_error(const struct aiocb *aiocbp);

DESCRIPTION
       The  aio_error()  function returns the error status associated with the
       aiocb structure referenced by the aiocbp argument. The error status for
       an  asynchronous  I/O operation is the errno value that would be set by
       the corresponding read(2), write(2), or  fsync(3C)  operation.  If  the
       operation has not yet completed, then the error status will be equal to
       EINPROGRESS.

RETURN VALUES
       If the asynchronous I/O operation has completed successfully, then 0 is
       returned.  If  the asynchronous operation has completed unsuccessfully,
       then  the  error  status,  as  described  for  read(2),  write(2),  and
       fsync(3C),  is  returned. If the asynchronous I/O operation has not yet
       completed, then EINPROGRESS is returned.

ERRORS
       The aio_error() function may fail if:

       EINVAL    The aiocbp argument does not refer to an asynchronous  opera‐
                 tion whose return status has not yet been retrieved.


USAGE
       The  aio_error()  function has a transitional interface for 64-bit file
       offsets. See lf64(7).

EXAMPLES
       Example 1 The following is an example  of  an  error  handling  routine
       using the aio_error() function.


         #include <aio.h>
         #include <errno.h>
         #include <signal.h>
         struct aiocb      my_aiocb;
         struct sigaction  my_sigaction;
         void              my_aio_handler(int, siginfo_t *, void *);
         ...
         my_sigaction.sa_flags = SA_SIGINFO;
         my_sigaction.sa_sigaction = my_aio_handler;
         sigemptyset(&my_sigaction.sa_mask);
         (void) sigaction(SIGRTMIN, &my_sigaction, NULL);
         ...
         my_aiocb.aio_sigevent.sigev_notify = SIGEV_SIGNAL;
         my_aiocb.aio_sigevent.sigev_signo = SIGRTMIN;
         my_aiocb.aio_sigevent.sigev_value.sival_ptr = &myaiocb;
         ...
         (void) aio_read(&my_aiocb);
         ...
         void
         my_aio_handler(int signo, siginfo_t *siginfo, void *context) {
         int  my_errno;
         struct aiocb   *my_aiocbp;

         my_aiocbp = siginfo->si_value.sival_ptr;
             if ((my_errno = aio_error(my_aiocb)) != EINPROGRESS) {
                 int my_status = aio_return(my_aiocb);
                     if (my_status >= 0){ /* start another operation */
                             ...
                     } else        { /* handle I/O error */
                              ...
                     }
             }
         }


ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       tab()  box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE TYPEAT‐
       TRIBUTE VALUE _ Interface  StabilityCommitted  _  MT-LevelAsync-Signal-
       Safe _ StandardSee standards(7).


SEE ALSO
       _Exit(2),  close(2),  fork(2),  lseek(2),  read(2),  write(2), aio_can‐
       cel(3C), aio_fsync(3C),  aio_read(3C),  aio_return(3C),  aio_write(3C),
       lio_listio(3C),  aio.h(3HEAD), signal.h(3HEAD), attributes(7), lf64(7),
       standards(7)



Oracle Solaris 11.4               5 Feb 2008                     aio_error(3C)