%ftp-flags(5)

NAME

%ftp-flags - "Configure the FTP console"
%http-flags - "Configure HTTP and HTTPS support"

SYNOPSIS

%ftp-flags "[c|d|i|p|s]" ; Default when undefined is "ci".
%http-flags "[C|c|d|h|i|p|s|v|w]" ; Default when undefined is "c".

DESCRIPTION

The %ftp-flags and %http-flags modify the behavior of the editor during FTP and HTTP file transfers, respectively. (see ftp(3) and find-file(2)).

By default, the flags are disabled, the facilities outlined below are enabled by setting the variable in the user configuration. The flag values for both flags are defined as follows:

C


HTTP(S) only: close socket after every request. When this flag is not given MicroEmacs sends keep-alive so the socket connection may be reused.

c


Create a console buffer (*ftp-console* for ftp, *http-console* for http) into which the FTP/HTTP command interactions with the remote server are logged.

d


Show details of commands executed and returned headers.

h


HTTP(S) only: halt on a redirection. When this flag is not given MicroEmacs will automatically follow up to 5 redirections (Location: in the response header), note that a %http-post-file(5) or %http-post-data(5) is only sent on the initial request.

i


FTPS, FTPE & HTTPS only: ignore certificate errors, useful when trying to load pages from a self-signed site.

p


Show the download progress within the console window ('#' for every 2KB downloaded)

s


Show the console whenever a FTP/HTTP operation is performed. The console is popped into the display pane and shows the current interaction status.

v


FTPS, FTPE & HTTPS only: show verbose information such as certificate details.

w


FTPS, FTPE & HTTPS only: show warnings of potential issues with the secure socket support layer.

Typically the following flags are enabled in the user.emf file:

set-variable %ftp-flags "cisp" 
set-variable %http-flags "csp" 

Once familiar with this facility the console pop-up becomes inconvenient and the flags are typically reduced to:

set-variable %ftp-flags "ci" 
set-variable %http-flags "c" 

This disables the pop-up feature of the console. Enabling the limited flag set allows some post mortem debugging to be performed if anything goes wrong. The console buffers are manually selected when these flags are set.

NOTES

Note that ftp and http facilities are available on UNIX by default, but must be compiled in for Windows versions.

SEE ALSO

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

Ref: %ftp-flags(5) File: m5var049.5 Date: 2026/02/23

(c) Copyright JASSPA 2026