Next: Mail Configuration Files, Previous: Scripting, Up: mail [Contents][Index]
mailFollowing variables control the behavior of GNU mail:
appendType: Boolean, Read-Only
Default: True
Messages saved in mbox are appended to the end rather than prepended.
This is the default and cannot be changed. This variable exists only
for compatibility with other mailx implementations.
appenddeadletterType: Boolean.
Default: False.
If this variable is True, the contents of canceled letter is
appended to the user’s dead.letter file. Otherwise it overwrites
its contents.
askbccType: Boolean.
Default: False.
When set to True the user will be prompted to enter Bcc
field before composing the message.
askccWhen set to True the user will be prompted to enter Cc
field before composing the message.
asksubType: Boolean.
Default: True in interactive mode, False otherwise.
When set to True the user will be prompted to enter Subject
field before composing the message.
autoincAutomatically incorporate newly arrived messages.
autoprintType: Boolean.
Default: False.
Causes the delete command to behave like dp - thus, after deleting a message, the next one will be typed automatically.
bangType: Boolean.
Default: False.
When set, every occurrence of ! in arguments to !
command is replaced with the last executed command.
bynameRecord outgoing messages in a file named after the first recipient. The name is the login-name portion of the address found first on the ‘To:’ line in the mail header. This variable overrides the ‘record’ variable.
It is set by the --byname (-F) command line option.
datefieldType: Boolean.
Default: False.
By default the date in a header summary is taken from the SMTP
envelope of the message. Setting this variable tells mail
to use the date from Date: header field, converted to
local time. Notice, that for messages lacking this field mail
will fall back to using SMTP envelope.
See fromfield.
charsetThe value of this variable is the character set used for input and
output operations. If the value is ‘auto’, mail will
try to deduce the name of the character set from the value of
‘LC_ALL’ environment variable. If the variable contains the
character set part (e.g. ‘nb_NO.utf-8’), it will be used.
Otherwise, mail will look up in its built-in database the
value of the character for this language/territory combination. If
‘LC_ALL’ is not set, the ‘LANG’ environment variable is
inspected.
The value of ‘charset’ controls both input and output operations. On input, it is used to set the value of the ‘charset’ parameter in the ‘Content-Type’ MIME header, if its value begins with ‘text/’ and ‘charset’ is not present.
On output, it is used to display values of the header fields encodied using RFC 2047. If the variable is unset, no decoding is performed and the fields are printed as they are. Otherwise, they are recoded to that character set.
cmdContains default shell command for pipe.
columnsType: Numeric.
Default: Detected at startup by querying the terminal device. If this
fails, the value of environment variable COLUMNS is used.
This variable contains the number of columns on terminal screen.
crtType: Boolean or Numeric
Default: True in interactive mode, False otherwise.
The variable crt determines the minimum number of lines the body
of the message must contain in order to be piped through pager command
specified by environment variable PAGER. If crt is set
to a numeric value, this value is taken as the threshold. Otherwise,
if crt is set without a value, then the height of the terminal
screen is used to compute the threshold. The number of lines on
screen is controlled by screen variable.
debugType: String to boolean
Default: Not set
Sets mailutils debug level. If set to string, the value must be a valid Mailutils debugging specification. See Debug Statement, for a description.
If unset (i.e. set nodebug), clears and disables all debugging
information. If set to ‘true’ (i.e. set debug), sets
maximum debugging (‘<trace7’) on mailbox and its underlying
objects.
decode-fallbackType: String.
Default: ‘none’.
This variable controls the way to represent characters that cannot be rendered using current character set. It can have three values:
Such characters are not printed at all. The conversion process stops at the first character that cannot be rendered.
The characters are displayed ‘as is’. Notice, that depending on your setup, this may screw-up your terminal settings.
Unprintable characters are represented by their octal codes. Printable ones are printed ‘as is’.
debugThis variable is not used. It exists for compatibility with other
mailx implementations and for future use.
dotType: Boolean.
Default: False.
If True, causes mail to interpret a period alone on a line as the
terminator of a message you are sending.
emptystartType: Boolean.
Default: False.
If the mailbox is empty, mail normally prints ‘No mail for user’ and
exits immediately. If this option is set, mail will start no matter is
the mailbox empty or not.
editheadersType: Boolean.
Default: False.
When set, mail will include message headers in the text to
be the ~e and ~v escapes, thus allowing you to customize
the headers.
escapeIf defined, the first character of this option gives the character to denoting escapes.
fliprIf set, the variable flipr swaps the meanings of reply
and Reply commands (see Replying).
folderThe name of the directory to use for storing folders of messages. If
unset, $HOME is assumed.
fromfieldType: Boolean.
Default: True.
By default the sender address is taken from the ‘From’ header.
Unsetting this variable tells mail to obtain it from the
SMTP envelope, instead.
See datefield.
headerType: Boolean.
Default: True, unless started with --nosum (-N) option.
Whether to run headers command automatically after entering
interactive mode.
headlineType: String
Default: ‘%>%a%4m %18f %16d %3l/%-5o %s’
A format string to use for the header summary. The ‘%’ character introduces a format specifier. Valid format specifiers are:
| Letter | Meaning |
|---|---|
| %a | Message attributes. |
| %d | The date when the message was received. |
| %f | The address of the message sender. |
| %l | The number of lines of the message. |
| %m | Message number. |
| %o | The number of octets (bytes) in the message. |
| %s | Message subject (if any). |
| %S | Message subject (if any) in double quotes. |
| %> | A ‘>’ for the current message, otherwise a space. |
| %< | A ‘<’ for the current message, otherwise a space. |
| %% | A ‘%’ character. |
Some additional symbols are allowed between ‘%’ and the specifier letter. The ‘-’ character immediately following ‘%’ indicates that this field should be left aligned. Similarly, the ‘+’ character indicates right alignment. Default alignment depends on the type of the specifier: the specifiers that produce numeric values (‘%l’, ‘%m’, and ‘%o’) are aligned to the right, whereas the ones producing string values are aligned to the left.
A number following ‘%’ or the alignment flag, indicates the field width. Consider, for example, the following specifiers:
Print current message number. Take as much screen columns as necessary to output it.
Print current message number. Occupy 4 screen columns, truncate the output if it does not fit that width. Align the output to the right.
Same as above, but align to the left.
holdType: Boolean.
Default: False.
When set to True, the read or saved messages will be stored in
user’s mailbox ($HOME/mbox). Otherwise, they will be held in
system mailbox also. This option is in effect only when operating
upon user’s system mailbox.
ignoreType: Boolean.
Default: False.
When set to True, mail will ignore keyboard interrupts
when composing messages. Otherwise an interrupt will be taken as a
signal to abort composing.
ignoreeofType: Boolean.
Default: False.
Controls whether typing EOF character terminates the letter being composed.
indentprefixType: String.
Default: "\t" (a tab character).
String used by the ~m tilde escape for indenting quoted messages.
inplacealiasesType: Boolean
Default: False
If set, mail will expand aliases in the address header field
before entering send mode (see Composing Mail). By default, the
address header fields are left intact while composing, the alias
expansion takes place immediately before sending message.
keepType: Boolean, Read-Only
Default: True
Truncate the user’s system mailbox when it is empty, instead of
removing it. This is the default and cannot be changed. This variable
exists only for compatibility with other mailx implementations.
keepsaveType: Boolean.
Default: False.
Controls whether saved messages should be kept in system mailbox too. This variable is in effect only when operating upon a user’s system mailbox.
mailxType: Boolean.
Default: False.
When set, enables mailx compatibility mode. This mode has the following effects:
mail will ask
for Cc and Bcc addresses after composing the body.
The default behavior is to ask for these values before composing
the body.
mail
will exit with zero status. By default it exits with zero status only
if the message was sent successfully.
metamailType: Boolean or String.
Default: True.
This variable controls operation of decode command. If
it is unset, decode will not attempt any interpretation
of the content of message parts. Otherwise, if metamail
is set to true, decode will use internal metamail
support to interpret message parts. Finally, if metamail
is assigned a string, this string is treated as command line of
the external metamail command which will be used to
display parts of a multipart message. For example:
# Disable MIME interpretation: set nometamail # Enable built-in MIME support: set metamail # Use external program to display MIME parts: set metamail="metamail -m mail -p"
mimeType: String
Default: Unset (false)
If set, this variable instructs mail to compose MIME
messages.
It can be set from the command line using --mime option.
mimenoaskBy default mail asks for confirmation before running
interpreter to view a part of the multi-part message. If this variable
is set, its value is treated as a comma-separated list of MIME types
for which no confirmation is needed. Elements of this list may include
shell-style globbing patterns, e.g. setting
set mimenoask=text/*,image/jpeg
will disable prompting before displaying any textual files, no matter what their subtype is, and before displaying files with type ‘image/jpeg’.
metooType: Boolean.
Default: False.
Usually, when an alias is expanded that contains the sender, the sender is removed from the expansion. Setting this option causes the sender to be included in the group.
modeType: String, Read-Only
Default: The name of current operation mode.
This variable keeps the name of the current operation mode. Its possible values are:
The program is started with the --headers (-H) command line option (see Invoking Mail).
The program is started with the --exist (-e) command line option (see Invoking Mail).
The program is started with the --print (-p) command line option (see Invoking Mail).
The program operates in read mode. This is the default.
The program operates in send mode. This means it was given one or more recipient addresses in the command line.
nullbodyControls whether mail accepts messages with an empty
body. The default value, true, means such messages are sent,
and a warning (traditionally saying ‘Null message body; hope
that's ok’) is displayed. The text of the warning can be set using
nullbodymsg variable (see below).
If nullbody is unset, mail will silently ignore such
messages. This can be useful in crontab files, to avoid sending
mails when nothing important happens. For example, the crontab
entry below will send mail only if the utility some-prog
outputs something on its standard output or error:
*/5 * * * * some-prog 2>&1 | \ /bin/mail -E'set nonullbody' -s 'Periodic synchronization'
showenvelopeType: Boolean
Default: Unset
If this variable is set, the print command will include the
STMP envelope in its output.
nullbodymsgType: String
Default: Null message body; hope that’s ok
Keeps the text of the warning, displayed by mail before
sending an empty message. When available, the translation of
this text, in accordance with the current locale, is displayed.
Unsetting this variable disables the warning.
onehopThis variable is not used. It exists for compatibility with other
mailx implementations and for future use.
outfolderContains the directory in which files created by save,
write, etc. commands will be stored. When unset, current
directory is assumed.
pageType: Boolean.
Default: False.
If set to True, the pipe command will emit a linefeed
character after printing each message.
promptContains the command prompt sequence.
quietThis variable is not used. It exists for compatibility with other
mailx implementations and for future use.
quitType: Boolean.
Default: False, unless started with --quit (-q) option.
When set, causes keyboard interrupts to terminate the program.
rcType: Boolean.
Default: True, unless started with --norc (-N) option.
When this variable is set, mail will read the system-wide
configuration file upon startup. See Mail Configuration Files.
readonlyWhen set, mailboxes are opened in readonly mode. In this mode, any
mail commands that alter the contents of the mailbox are
disabled. These commands include, but are not limited to:
delete, save and mbox.
recordWhen set, any outgoing message will be saved to the named file.
recursivealiasesType: Boolean
Default: True
When set, mail will expand aliases recursively.
regexSetting this to True enables use of regular expressions in
‘/.../’ message specifications.
replyprefixSets the prefix that will be used when constructing the subject line of a reply message.
replyregexType: String
Default: ‘^re: *’
Sets the regular expression used to recognize subjects of reply
messages. If the Subject header of the message matches this
expression, the value of replyprefix will not be prepended to
it before replying. The expression should be a POSIX extended regular
expression. The comparison is case-insensitive.
For example, to recognize usual English, Polish, Norwegian and German reply subject styles, use:
set replyregex="^(re|odp|aw|ang)(\\[[0-9]+\\])?:[[:blank:]]"
(Notice the quoting of backslash characters).
return-addressSets the return email address to use when sending messages. If unset, the address is composed from the current user name and the host name.
saveWhen set, the aborted messages will be stored in the user’s
dead.file. See also appenddeadletter.
screenType: Numeric.
Default: Detected at startup by querying the terminal device. If this
fails, the value of environment variable LINES is used.
This variable contains the number of lines on terminal screen.
sendmailType: String.
Default: sendmail:/usr/lib/sendmail
Contains URL of the mail transport agent.
sendwaitThis variable is not used. It exists for compatibility with other
mailx implementations and for future use.
showtoIf the message was sent by the user, print its recipient address in the header summary.
SignContains the filename holding users signature. The contents of this
file is appended to the end of a message being composed by ~A
escape.
signContains the user’s signature. The contents of this variable is appended
to the end of a message being composed by ~a escape. Use
Sign variable, if your signature occupies more than one line.
showtoIf this variable is set, mail will show To: addresses
instead of From: for all messages that come from the user that
invoked the program.
subjectContains default subject line. This will be used when asksub is
off.
toplinesNumber of lines to be displayed by top and Top commands.
variable-strictvarstrictType: Boolean.
Default: False.
Setting this variable enables strict control over variable
settings. In this mode, mail refuses to set read-only
variables. Also, if the user is trying to set an unknown variable,
mail prints a warning.
variable-pretty-printvarppType: Boolean.
Default: False.
If this variable is set, the listing output by set contains short
descriptions before each variable. See Setting and Unsetting the Variables.
verboseType: Boolean.
Default: False.
When set, the actual delivery of messages is displayed on the user’s terminal.
xmailerControls whether the header ‘X-Mailer’ should be added to outgoing messages. The default value of this header is
X-Mailer: mail (GNU Mailutils 3.4)
Next: Mail Configuration Files, Previous: Scripting, Up: mail [Contents][Index]