Go to main content

man pages section 3: Library Interfaces and Headers

Exit Print View

Updated: Wednesday, July 27, 2022
 
 

curl_mime_free (3)

Name

curl_mime_free - free a previously built mime structure

Synopsis

#include <curl/curl.h>

void curl_mime_free(curl_mime *mime);

Description

curl_mime_free(3)               libcurl Manual               curl_mime_free(3)



NAME
       curl_mime_free - free a previously built mime structure

SYNOPSIS
       #include <curl/curl.h>

       void curl_mime_free(curl_mime *mime);

DESCRIPTION
       curl_mime_free(3)  is  used  to clean up data previously built/appended
       with curl_mime_addpart(3) and other mime-handling functions. This  must
       be  called  when  the  data  has been used, which typically means after
       curl_easy_perform(3) has been called.

       The handle to free is the one you  passed  to  the  CURLOPT_MIMEPOST(3)
       option:  attached subparts mime structures must not be explicitly freed
       as they are by the top structure freeing.

       mime  is  the  handle   as   returned   from   a   previous   call   to
       curl_mime_init(3) and may be NULL.

       Passing  in a NULL pointer in mime will make this function return imme-
       diately with no action.

EXAMPLE
         /* Build the mime message. */
         mime = curl_mime_init(curl);

         /* ... */

         /* Free multipart message. */
         curl_mime_free(mime);

AVAILABILITY
       As long as at least one of HTTP, SMTP or  IMAP  is  enabled.  Added  in
       7.56.0.

RETURN VALUE
       None


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


       +---------------+------------------+
       |ATTRIBUTE TYPE | ATTRIBUTE VALUE  |
       +---------------+------------------+
       |Availability   | web/curl         |
       +---------------+------------------+
       |Stability      | Uncommitted      |
       +---------------+------------------+

SEE ALSO
       curl_mime_init(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/down-
       load/curl-7.83.1.tar.bz2.

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



libcurl 7.83.1                 November 26, 2021             curl_mime_free(3)