MASH(1) MASH(1)
NAME
mash - programmable shell
SYNOPSIS
mash [ -denx ][ -ccommand ] [ file [ arg ... ]]
DESCRIPTION
Mash is an older alternative to the original Inferno shell
(now tiny(1)). Mash is a programmable shell that also allows
the definition of simple dependency rules, resembling those
of Unix make. It executes commands read from standard input
or a file or, with the -c flag, from mash's argument list.
Its syntax and semantics are similar to that of Plan 9's rc.
Invocation
If mash is started with no arguments it reads commands from
standard input. Otherwise its first non-flag argument is the
name of a file from which to read commands (but see -c
below). Subsequent arguments become the initial value of
$args. Mash accepts the following command-line flags.
-c string Commands are read from string.
-d Dump parsed commands before execution.
-e Fail if a top level command does.
-n Parse but do not execute.
-x Print each simple command before executing it.
If invoked without arguments mash first runs the commands
found in /lib/mashinit.
Command Lines
Each command is terminated with an ampersand or a semicolon
(& or ;). When reading from /dev/cons a newline not escaped
with a backslash (\) is treated as a semicolon. Mash does
not wait for a command followed by & to finish executing
before starting the following command.
A number-sign (#) and any following characters up to (but
not including) the next newline are ignored, except in quo-
tation marks.
Simple Commands
A simple command is a sequence of words interspersed with
I/O redirections. If the first word is the name of a mash
function or of one of mash's built-in commands, it is exe-
cuted by mash. Otherwise, if the name starts with a slash
(/), it must be the path name of a Dis file to be loaded and
executed. Names containing no initial slash are searched for
Page 1 Plan 9 (printed 10/27/25)
MASH(1) MASH(1)
in the current directory and then in /dis. The .dis exten-
sion need not be supplied.
The keywords are
case else fn for hd if in len rescue tl while
Words and Variables
A number of constructions may be used where mash's syntax
requires a word to appear. In many cases a construction's
value will be a list of strings rather than a single string.
The simplest kind of word is the unquoted word: a sequence
of one or more characters none of which is a blank, tab,
newline, or any of the following:
# : ; ! ~ @ & | ^ $ = " ` ' { } ( ) < >
An unquoted word that contains any of the characters *, ?
or [ is a pattern for matching against file names. The char-
acter * matches any sequence of characters, ? matches any
single character, and [ class ] matches any character in the
class. The class may also contain pairs of characters sepa-
rated by -, standing for all characters lexically between
the two. The character / must appear explicitly in a pat-
tern. A pattern is replaced by a list of words, one for each
path name matched, except that a pattern matching no names
is not replaced by the empty list, but rather stands for
itself. Pattern matching is done after all other operations.
Thus,
x=/tmp; echo $x^/*.c;
matches /tmp/*.c, rather than matching /*.c and then prefix-
ing /tmp.
A quoted word is a sequence of characters surrounded by sin-
gle quotes ('). A single quote is escaped with a backslash.
Each of the following is a word.
$identifier
The identifier after the $ is the name of a variable
whose value is substituted. Variable values are lists
of strings. It is an error if the named variable has
never been assigned a value.
$number
See the description of rules for the mash-make(1) buil-
tin.
$"identifier
The value is a single string containing the components
of the named variable separated by spaces.
`{commands}
mash executes the commands and reads the standard out-
put, splitting it into a list of words, using the
whitespace characters (space, tab, newline and carriage
return) as separators.
Page 2 Plan 9 (printed 10/27/25)
MASH(1) MASH(1)
"{commands}
mash executes the commands and reads the standard out-
put, splitting it into a list of words, using the
whitespace characters (space, tab, newline and carriage
return) as separators.
<{commands}
>{commands}
The commands are executed asynchronously with their
standard output or standard input connected to a pipe.
The value of the word is the name of a file referring
to the other end of the pipe. This allows the construc-
tion of non-linear pipelines. For example, the follow-
ing runs two commands old and new and uses cmp to com-
pare their outputs
cmp <{old} <{new};
(expr)
mash evaluates expr as an expression. The value is a
(possibly null) list of words. Expressions are
described in detail below.
word^word
The ^ operator concatenates its two operands. If either
operand is a singleton, the concatenation is distribu-
tive. Otherwise the lists are concatenated pairwise.
Free Carets
In most circumstances, mash will insert the ^ operator auto-
matically between words that are not separated by white
space. Whenever one of $ 'or ` (dollar, single quote or back
quote) follows a quoted or unquoted word or an unquoted word
follows a quoted word with no intervening blanks or tabs, a
^ is inserted between the two. If an unquoted word immedi-
ately follows a $ and contains a character other than an
alphanumeric, or underscore, a ^ is inserted before the
first such character. Thus
limbo -$flags $stem.b
is equivalent to
limbo -^$flags $stem^.b
I/O Redirections
The sequence >file redirects the standard output file (file
descriptor 1, normally /dev/cons) to the named file; >>file
appends standard output to the file. The standard input file
(file descriptor 0, also normally /dev/cons) may be redi-
rected from a file by the sequence <file. The sequence
<>file opens the file for read/write and associates both
file descriptor 0 and 1 with it.
Page 3 Plan 9 (printed 10/27/25)
MASH(1) MASH(1)
Compound Commands
A pair of commands separated by a pipe operator (|) is a
command. The standard output of the left command is sent
through a pipe to the standard input of the right command.
Each of the following is a command.
if ( expr ) command1
if ( expr ) command1 else command2
The expr
is evaluated and if the result is not null, then
command1 is executed. In the second form command2 is
executed if the result is null.
for ( name in list )command
The command is executed once for each word in list with
that word assigned to name.
while ( expr ) command
The expr is evaluated repeatedly until its value is
null. Each time it evaluates to non-null, the command
is executed.
case expr { pattern-list => command ... }
case expr-list { pattern => command ... }
In the first form of the command the expr is matched
against a series of lists of regular expressions (See
regex(2)). The command associated with the matching
expression is executed. In the second form the command
associated with the first pattern to match one of the
words in expr-list is executed. An expr-list will never
match a pattern-list.
{commands}
@{commands}
Braces serve to alter the grouping of commands implied
by operator priorities. The body is a sequence of com-
mands separated by & or ;. The second form is executed
with a new scope. Either form can be followed by redi-
rections.
fnname{list}
fnname
The first form defines a function with the given name.
Subsequently, whenever a command whose first word is
name is encountered, the current value of the remainder
of the command's word list will be assigned to the
local variable args, in a new scope, and mash will
execute the list. The second form removes name's func-
tion definition.
name=list
name:=list
The first form is an assignment to a variable. If the
name is currently defined as a local variable its value
will be updated. Otherwise a global variable with the
given name will be defined or updated. The second form
is an explicit definition or update of a local vari-
able.
Page 4 Plan 9 (printed 10/27/25)
MASH(1) MASH(1)
list:list
list:list{commands}
word:~word{commands}
These forms define dependencies and rules for the make
loadable builtin. The first form defines a simple
dependency, the second a dependency with an explicit
rule. The third form defines an implicit rule where the
left-hand word is a file pattern, the right-hand word
is the prerequisite. The right-hand word and the com-
mands can contain references to the characters matched
by the * meta-character in the pattern ($1 evaluates to
the characters matched by the first *, $2 the second
and so on; $0 is the entire match).
Expressions
Expressions evaluate to possibly null lists of strings. A
word is an expression. An expression may take one of the
following forms
( expr )
Parentheses are used for grouping.
hd expr
tl expr
len expr
! expr
hd is the first element of a list, tl the remainder.
len is the length of a list. Both evaluate to the null
list if their operand is a null list. ! is the not
operator and evaluates to true for a null list or to a
null list otherwise.
expr ^ expr
expr :: expr
expr == expr
expr != expr
expr ~ expr
^ is concatenation (as defined above), :: is list con-
catenation, == and != are the equality operators evalu-
ating to true or the null list, depending on the equal-
ity or inequality of the two operands. ~ is the match
operator, true if a singleton string matches one of a
list of regular expressions, or one of a list of
strings matches a regular expression. (If neither
operand is a singleton it evaluates to the null list.)
^ has the highest precedence, followed by :: followed
by the other three. All associate to the left except
::.
Built-in Commands
Mash supports loadable modules of builtins. The Mashbuiltin
module definition and description is in mash.m. One such
module, builtins, is loaded before mash begins parsing. This
Page 5 Plan 9 (printed 10/27/25)
MASH(1) MASH(1)
module defines the following commands
env
Print global and local variables. Global variables are
displayed using a name=value format, and local vari-
ables using a name:=value format.
eval
Concatenate arguments and use as mash input.
exit
Cause mash to raise an exit exception.
load file
Load a builtin module. The file must be a module with
type Mashbuiltin. The argument file is assumed to con-
tain a path to the loadable module. If no such module
is found then the string /dis/lib/mash/ is prepended to
file and the load is retried.
prompt
prompttext
prompttext contin
When called with no arguments causes the current value
of the mash prompt to be printed to standard output.
The default value is mash%. The second form sets a new
prompt. The final form sets a new prompt and addition-
ally a continuation string. Initially the continuation
string is set to a single tab character. Mash uses the
continuation string in place of the prompt string to
indicate that the preceding line has been continued by
escaping with a final backslash (\) character.
quoteargs...
Print arguments quoted as input for mash.
run -[denx] file [arg...]
Interpret a file as input to mash.
timecmd [arg...]
Time the execution of a command. The total execution
time is reported in seconds and on standard error when
the command completes.
whatisname
Print variable, function or builtin. The object given
by name is described on standard output in a format
that reflects its type.
The make loadable builtin provides `make` functionality.
The tk loadable builtin provides control over some of the
visual elements of a mash window.
Adding Builtins
New builtins can be added to mash by creating a Dis module
that can be loaded with a Mashbuiltin module interface
(defined in mash.m). The new module is loaded with the
builtin load command which calls its mashinit function to
initialise it with an argument containing the load command
line. The function should use this call to register the set
of builtins that the module will provide using the
Page 6 Plan 9 (printed 10/27/25)
MASH(1) MASH(1)
Env.defbuiltin function. Thereafter, each time one of the
registered builtins is invoked the module's mashcmd function
is called passing as an argument a list containing the
invoked builtin name and its arguments. See the examples in
mash/builtins.b, mash/make.b, and mash/tk.b.
FILES
/lib/mashinit
/dis/lib/mash
SOURCE
/appl/cmd/mash
SEE ALSO
mash-tk(1), mash-make(1), regex(2)
Tom Duff, ``Rc - The Plan 9 Shell'', in the Plan 9
Programmer's Manual , Second Edition, Volume 2.
Page 7 Plan 9 (printed 10/27/25)