CURLOPT_IOCTLFUNCTION(3) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

CURLOPT_IOCTLFUNCTION(3)

/usr/local/bin/rman를 실행할 수 없습니다

CURLOPT_IOCTLFUNCTION(3)   Library Functions Manual   CURLOPT_IOCTLFUNCTION(3)

NAME
       CURLOPT_IOCTLFUNCTION - callback for I/O operations

SYNOPSIS
       #include <curl/curl.h>

       typedef enum {
         CURLIOE_OK,            /* I/O operation successful */
         CURLIOE_UNKNOWNCMD,    /* command was unknown to callback */
         CURLIOE_FAILRESTART,   /* failed to restart the read */
         CURLIOE_LAST           /* never use */
       } curlioerr;

       typedef enum  {
         CURLIOCMD_NOP,         /* no operation */
         CURLIOCMD_RESTARTREAD, /* restart the read stream from start */
         CURLIOCMD_LAST         /* never use */
       } curliocmd;

       curlioerr ioctl_callback(CURL *handle, int cmd, void *clientp);

       CURLcode curl_easy_setopt(CURL *handle, CURLOPT_IOCTLFUNCTION, ioctl_callback);

DESCRIPTION
       Pass a pointer to your callback function, which should match the proto‐
       type shown above.

       This  callback  function  gets called by libcurl when something special
       I/O-related needs to be done that the library cannot do by itself.  For
       now,  rewinding the read data stream is the only action it can request.
       The rewinding of the read data stream may be necessary  when  doing  an
       HTTP PUT or POST with a multi-pass authentication method.

       The  callback  must  return  CURLIOE_UNKNOWNCMD if the input cmd is not
       CURLIOCMD_RESTARTREAD.

       The clientp argument to the callback is  set  with  the  CURLOPT_IOCTL‐
       DATA(3) option.

       This  option  is deprecated. Do not use it. Use CURLOPT_SEEKFUNCTION(3)
       instead to provide seeking. If CURLOPT_SEEKFUNCTION(3) is set, this pa‐
       rameter is ignored when seeking.

DEFAULT
       NULL

PROTOCOLS
       This functionality affects all supported protocols

EXAMPLE
       #include <unistd.h> /* for lseek */

       struct data {
         int fd; /* our file descriptor */
       };

       static curlioerr ioctl_callback(CURL *handle, int cmd, void *clientp)
       {
         struct data *io = (struct data *)clientp;
         if(cmd == CURLIOCMD_RESTARTREAD) {
           lseek(io->fd, 0, SEEK_SET);
           return CURLIOE_OK;
         }
         return CURLIOE_UNKNOWNCMD;
       }
       int main(void)
       {
         struct data ioctl_data;
         CURL *curl = curl_easy_init();
         if(curl) {
           curl_easy_setopt(curl, CURLOPT_IOCTLFUNCTION, ioctl_callback);
           curl_easy_setopt(curl, CURLOPT_IOCTLDATA, &ioctl_data);
         }
       }

DEPRECATED
       Deprecated since 7.18.0.

AVAILABILITY
       Added in curl 7.12.3

RETURN VALUE
       curl_easy_setopt(3) returns a CURLcode indicating success or error.

       CURLE_OK (0) means everything was OK, non-zero means an error occurred,
       see libcurl-errors(3).


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

       box; cbp-1 | cbp-1 l | l .  ATTRIBUTE TYPE ATTRIBUTE VALUE = Availabil‐
       ity   web/curl = Stability Uncommitted

SEE ALSO
       CURLOPT_IOCTLDATA(3), CURLOPT_SEEKFUNCTION(3)



NOTES
       Source code for open source software components in Oracle  Solaris  can
       be found at https://www.oracle.com/downloads/opensource/solaris-source-
       code-downloads.html.

       This software was built from source available at:
       https://github.com/oracle/solaris-userland

       The original community source was downloaded from:
       https://curl.se/download/curl-8.17.0.tar.bz2

       Further information about this software can be found on the open source
       community website at http://curl.haxx.se/.

libcurl                           2025-12-01          CURLOPT_IOCTLFUNCTION(3)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3