Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
curl_mime_headers(3)		libcurl	Manual		  curl_mime_headers(3)

NAME
       curl_mime_headers - set a mime part's custom headers

SYNOPSIS
       #include	<curl/curl.h>

       CURLcode	 curl_mime_headers(curl_mimepart  *  part, struct curl_slist *
       headers,	int take_ownership);

DESCRIPTION
       curl_mime_headers(3) sets a mime	part's custom headers.

       part is the part's handle to assign the custom headers list to.

       headers is the head of a	list of	custom headers;	it may be set to  NULL
       to remove a previously attached custom header list.

       take_ownership:	when  non-zero,	 causes	 the list to be	freed upon re-
       placement or mime structure deletion; in	this case the list must	not be
       freed explicitly.

       Setting a part's	custom headers list twice is valid: only the value set
       by the last call	is retained.

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

RETURN VALUE
       CURLE_OK	or a CURL error	code upon failure.

EXAMPLE
	struct curl_slist *headers = NULL;

	headers	= curl_slist_append("Custom-Header: mooo", headers);

	/* use these headers, please take ownership */
	curl_mime_headers(part,	headers, TRUE);

	/* pass	on this	data */
	curl_mime_data(part, "12345679", CURL_ZERO_TERMINATED);

	/* set name */
	curl_mime_name(part, "numbers");

SEE ALSO
       curl_mime_addpart(3)

libcurl	7.72.0		      September	22, 2017	  curl_mime_headers(3)

NAME | SYNOPSIS | DESCRIPTION | AVAILABILITY | RETURN VALUE | EXAMPLE | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=curl_mime_headers&sektion=3&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help