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

FreeBSD Manual Pages

  
 
  

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

NAME
       curl_mime_filename - set	a mime part's remote file name

SYNOPSIS
       #include	<curl/curl.h>

       CURLcode	 curl_mime_filename(curl_mimepart  *  part, const char * file-
       name);

DESCRIPTION
       curl_mime_filename(3) sets a mime part's	remote file name. When	remote
       file  name is set, content data is processed as a file, whatever	is the
       part's content source. A	part's remote file name	is transmitted to  the
       server in the associated	Content-Disposition generated header.

       part is the part's handle to assign the remote file name	to.

       filename	 points	to the null-terminated file name string; it may	be set
       to NULL to remove a previously attached remote file name.

       The remote file name string is copied into the part, thus  the  associ-
       ated  storage  may  safely  be released or reused after call. Setting a
       part's file name	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
	curl_mime *mime;
	curl_mimepart *part;

	/* create a mime handle	*/
	mime = curl_mime_init(easy);

	/* add a part */
	part = curl_mime_addpart(mime);

	/* send	image data from	memory */
	curl_mime_data(part, imagebuf, imagebuf_len);

	/* set a file name to make it look like	a file upload */
	curl_mime_filename(part, "image.png");

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

SEE ALSO
       curl_mime_addpart(3), curl_mime_filedata(3), curl_mime_data(3)

libcurl	7.74.0		       November	04, 2020	 curl_mime_filename(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_filename&sektion=3&manpath=FreeBSD+13.0-RELEASE+and+Ports>

home | help