%http-post-data(5)

NAME

%http-post-data - Set HTTP request form data
%http-post-file - Set HTTP request file to submit

SYNOPSIS

%http-post-data "name=value&..."; Default is undefined
%http-post-file "file-name"; Default is undefined

DESCRIPTION

If either of these variables are defined the next HTTP file loading request, using a command like find-file(2), will be changed from a GET to a POST, submitting the required data in the first request. The variable at this point is unset so that if the request leads to a redirect, the data is only submitted on the first request.

When %http-post-data variable is set to a non-empty string its value is submitted as a simple URL encoded form data.

When %http-post-file variable is set to a non-empty string its value must be set to the absolute path of an existing local file that is to be submitted with the http request. If %http-header(5) is set and includes "Content-type:" then the given file becomes the full data body. However, if the variable is not set or does not contain the header string "Content-type:" then the file is submitted as part of a multi-part form submission (with "Content-Disposition: form-data;" and "Content-Type: application/octet-stream").

Both variables cannot be used at the same time.

SEE ALSO

%http-flags(5), %http-cookies(5), %http-header(5), %http-proxy-addr(5), %sock-send-timeout(5), find-file(2), ftp(3).

Ref: %http-post-data(5) File: m5var014.5 Date: 2024/09/02

(c) Copyright JASSPA 2026