Unix & Linux Stack Exchange is a question and answer site for users of Linux, FreeBSD and other Un*x-like operating systems. Join them; it only takes a minute:

Sign up
Here's how it works:
  1. Anybody can ask a question
  2. Anybody can answer
  3. The best answers are voted up and rise to the top

This question already has an answer here:

What does $* mean in shell?

I have code two function, run_command and run_test, they are called like this:

if [ -n "`echo ${GOAT_COMMANDS} | grep $1`" ]; then
  run_command $*
  run_test $*

I want to understand what $* means, but Google search is very bad for searching these kinds of things.

share|improve this question

marked as duplicate by cuonglm, Flup, Anthon, slm Jul 8 '14 at 11:43

This question has been asked before and already has an answer. If those answers do not fully address your question, please ask a new question.

up vote 7 down vote accepted

$* is all the parameters to the script or function, split into separate arguments on whitespace.

If you have a function:

foo() {
    for x in $*
        echo $x

then running foo 1 "2 3 4" 5 will output:


That is, the quoted string "2 3 4" will be split into three separate "words".

When you don't want to split the arguments into separate words like that, you can use $@. If the same function used "$@" in place of $*, it would output:

2 3 4

That is, the quoted string would not be split into separate words. This is like listing all the positional parameters out explicitly: "$1" "$2" "$3" "$4" .... In general, this is probably the one you want to use - the word-splitting will often lead to nasty bugs that are hard to track down.

At the top level of a script (not inside a function), these refer to the arguments given to the script itself.

Your example is calling either run_command or run_test with all of the arguments to this script or function, split into separate words. If the script were run as script.sh "hello world" 2 3 then it would have the effect of running:

run_command hello world 2 3
share|improve this answer
Some related related reading material for the OP. – HalosGhost Jul 8 '14 at 8:31
Does $* remove the "? I.e. does the first version output 1,2,3,4,5, and not 1,"2,3,4",5? – Svish Jul 8 '14 at 9:57
@Svish: Quotes "2 3 4" are removed by the shell right at the start - they make the whole thing a single "word", rather than splitting it into three the way it usually would. – Michael Homer Jul 8 '14 at 10:03

$* means the all positional parameters.

share|improve this answer

$* is the list of the positional parameters, but with word splitting. For instance, on

your_script ab "cd ef"

$* will give you 3 arguments: ab, cd and ef. Using "$@" is much safer (unless you want word splitting).

share|improve this answer

$* means pass all parameters to the function as a single 'parameter'. It's also advised to have double quotes around such variable "$*".

Some doc on this here section 3.2.5

On the other hand, if you need to iterate through each one of the parameters contained in the argument list, use $@ instead, like in this ex:

for var in "$@"
    echo "$var"

Here's another example: foo.sh

        for x in "$@"
                echo "f1: $x"

        for x in "$*"
                echo "f2: $x"

foo1 1 2 "3 4 5" 6 7
foo2 1 2 "3 4 5" 6 7


$  ./foo.sh 
f1: 1
f1: 2
f1: 3 4 5
f1: 6
f1: 7

f2: 1 2 3 4 5 6 7
share|improve this answer
$* passes the parameters as a single parameter only when you use double quotes: "$*". I believe that's the main use of $*, with double quotes. Otherwise, for a list of parameters, "$@" is chosen. – vinc17 Jul 8 '14 at 8:38

Not the answer you're looking for? Browse other questions tagged or ask your own question.