Take the 2-minute tour ×
Unix & Linux Stack Exchange is a question and answer site for users of Linux, FreeBSD and other Un*x-like operating systems.. It's 100% free, no registration required.

I know using the command ls will list all the directories. But what does the ls * command do ? I used it and it just lists the directories. Is the star in front of ls means how deep it can list the directories?

share|improve this question
add comment

6 Answers 6

up vote 83 down vote accepted

ls lists the files and content of directories it is being passed as arguments, and if no argument is given, it lists the current directory. It can also be passed a number of options that affect its behaviour (see man ls for details).

If ls is being passed an argument called *, it will look for a file or directory called * in the current directory and list it just like any other. ls doesn't treat the * character in any other way than any other one.

However if ls * is a shell command line, then the shell will expand that * according to the corresponding shell's globbing (also referred to as Filename Generation or Filename Expansion) rules.

While different shells support different globbing operators, most of them agree on the simplest one *. * as a pattern means any number of characters, so * as a glob will expand to the list of files in the current directories that match that pattern. There's an exception however that a leading dot (.) character in a file name has to be matched explicitly, so * actually expands to the list of files and directories not starting with . (in lexicographical order).

For instance, if the current directory contains the files called ., .., .foo, -l and foo bar, * will be expanded by the shell to two arguments to pass to ls: -l and foo bar, so it will be as if you had typed:

ls -l "foo bar"

or

'ls' "-l" foo\ bar

Which are three ways to run exactly the same command. In all 3 cases, the ls command (which will probably be executed from /bin/ls from a lookup of directories mentioned in $PATH) will be passed those 3 arguments: "ls", "-l" and "foo bar".

Incidentally, in this case, ls will treat the first (strictly speaking second) one as an option.

Now, as I said, different shells have different globbing operators. A few decades ago, zsh introduced the **/ operator¹ which means to match any level of subdirectories, short for (*/)# and ***/ which is the same except that it follows symlinks while descending the directories.

A few years ago (July 2003, ksh93o+), ksh93 decided to copy that behaviour but decided to make it optional, and only covered the ** case (not ***). Also, while ** alone was not special in zsh (just meant the same as * like in other traditional shells since ** means any number of character followed by any number of characters), in ksh93, ** meant the same as **/* (so any file or directory below the current one (excluding hidden files). bash copied ksh93 a few years later (February 2009, bash 4.0), with the same syntax but an unfortunate difference: bash's ** is like zsh's ***, that is it follows symlinks when recursing into sub-directories which is generally not what you want it do and can have nasty side effects (that has later been fixed in bash-4.3). The fish shell also supports ** the same way as bash with the same caveat. tcsh also added a globstar option in V6.17.01 (May 2010) and supports both ** and ***.

So in bash and ksh93, when the corresponding option is enabled (globstar), ** expands all the files and directories below the current one, and *** is the same as * though it's not impossible that future versions of those shells will adapt the zsh behaviour to also mean any file and directory below the current one, traversing the symbolic links.

Above, you'll have noticed the need to make sure none of the expansions is interpreted as an options. For that, you'd do:

ls -- *

Or:

ls ./*

There are some commands (it doesn't matter for ls) where the second is preferable since even with the -- some filenames may be treated specially. It's the case of - for most text utilities, cd and pushd and filenames that contain the = character for awk for instance. Prepending ./ to all the arguments removes their special meaning (at least for the cases mentioned above).

It should also be noted that most shells have a number of options that affect the globbing behaviour (like whether dot files are ignored or not, the sorting order, what to do if there's no match...), see also the $FIGNORE parameter in ksh

Also, in every shell but csh, tcsh, fish and zsh, if the globbing pattern doesn't match any file, the pattern is passed as an unexpanded argument which causes confusion and possibly bugs. For instance, if there's no non-hidden file in the current directory

ls *

Will actually call ls with the two arguments ls and *. And as there's no file at all, so none called * either, you'll see an error message from ls (not the shell) like: ls: cannot access *: No such file or directory, which has been known to make people think that it was ls that was actually expanding the globs.

The problem is even worse in cases like:

rm -- *.[ab]

If there's no *.a nor *.b file in the current directory, then you might end up deleting a file called *.[ab] by mistake (csh, tcsh, fish and zsh would report a no match error and wouldn't call rm).

If you do want to pass a literal * to ls, you have to quote that * character in some way as in ls \* or ls '*' or ls "*". In Bourne-like shells, globbing can disabled altogether using set -f.


¹ While (*/)# was always supported, it was first short-handed as ..../ in zsh-2.0 (and potentially before), then ****/ in 2.1 before getting its definitive form **/ in 2.2 (early 1992)

share|improve this answer
14  
Really great answer! –  Andrea Corbellini Jan 26 '13 at 17:57
4  
Another nice example is find -name *. Especially with more complex patterns, if there is exactly one match in the current directory, people will often not realize they're not passing the asterisk to find. –  njsg Jan 27 '13 at 10:57
    
I continue to give +1, I'm really happy to see Stephane Chazelas active here on unix.stackexchange.com! Great contributions, Stephane, as always! –  Dimitre Radoulov Jan 27 '13 at 17:04
1  
In fish, *.[ab] would try to delete everything ending with .[ab]. [ is not special in fish. –  xfix Apr 17 at 9:26
add comment

The command ls defaults to ls .: List all entries in the current directory.

The command ls * means 'run ls on the expansion of the * shell pattern'

The * pattern is processed by the shell, and expands to all entries in the current directory, except those that start with a .. It will go one level deep.

The interpretation of double or triple * patterns depend on the actual shell used.

* is a wildcard that matches 0 or more characters. Some modern shells will recurse into subdirectories on seeing the ** pattern.

share|improve this answer
    
Thank you for the clear explanation –  John Smith Jan 26 '13 at 17:11
14  
Except that extra * do add something, see the other answer explaining the globstar. It should also be made clear that ls has nothing to do with the asterisks, it's never passed any of these asterisks at all. Run echo ls * to see what would be executed when you write ls *. –  njsg Jan 26 '13 at 21:49
add comment

In some shells, including bash 4.x with the globstar option enabled, ** will perform a recursive glob, descending matched directories. Additional asterisks don't further modify this operation.

share|improve this answer
1  
As I said in my answer though, beware that contrary to ksh93 and zsh, bash does traverse symlinks in the recursion which is generally unwanted. –  Stéphane Chazelas Jan 26 '13 at 21:12
    
That has now been fixed in bash 4.3 –  Stéphane Chazelas Mar 18 at 13:47
add comment

You can demystify the whole process by typing echo instead of ls first, to see what the command expands to:

$ echo *
Applications Downloads Documents tmp.html

So in this case, ls * expands to ls Applications Downloads Documents tmp.html

$ echo **
Applications Downloads Documents tmp.html

$ echo ***
Applications Downloads Documents tmp.html

So no change. This assumes you're using bash as your shell -- most people are, and different shells have different behavior. If you're using ash or csh or ksh or zsh, you may expect things to work differently. That's the point of having different shells.

So lets try something different (still with bash) so we get an idea of the the globbing (*) operator can do for us. For example, we can filter by part of the name:

$ echo D*
Downloads Documents

And interestingly, a trailing slash is an implicitly part of any directory name. So */ will yield only the directories (and symbolic links to directories):

$ echo */
Applications/ Downloads/ Documents/

And we can do some filtering at multiple levels by putting slashes in the middle:

$ echo D*/*/
Documents/Work/ /Documents/unfinished/

Since the Downloads directory doesn't contain any subdirectories, it does not end up in the output. This is very useful for just examining the files you want. I use commands like this all the time:

$ ls -l /home/*/public_html/wp-config.php

This lists, if there are any, all the wp-config.php files that exist at the base level of any user's public_html directory. Or perhaps to be more complete:

$ find /home/*/public_html/ -name wp-config.php

This will find any wp-config.php files in any user's public_html directories or any of their subdirectories, but it will operate more efficiently than just find /home/ -name wp-config.php because it won't examine anything but the public_html directories for each of the users.

share|improve this answer
    
"This assumes you're using bash as your shell" ← and that the globstar is not enabled. shopt -s globstar and try it again... –  njsg Jan 27 '13 at 17:53
add comment

If you want to "dive deep", use ls -R (recursive) option, or use find, like so:

find . -ls

"find" will dive down to the bottom of the directory tree (as will 'ls -R'), and has many more options, like listing directories (-type d), files only (-type f) or showing files having other characteristics (no user in /etc/passwd, specific permissions, and a whole lot more). "find" is also somewhat safer in scripting (due to inconsistent globbing rules between shells, as well as special escapes for files having dashes, etc).

shell wildcard globbing won't work with just an asterisk '*' on dotfiles. To list dotfiles only, use:

ls .??*

share|improve this answer
add comment

Extra * doesn't add depth level. But if you try

 ls */*/*

- you will get list of subfolders of subfolders in folders in current folder...

share|improve this answer
    
Wrong. Depending on the shell, extra *s will add depth level. –  njsg Jan 27 '13 at 17:55
    
so what shell will add depth level on extra stars? –  VB9-UANIC Jan 27 '13 at 21:47
    
Several. Including GNU bash with the globstar option, the korn shell and zsh. And possibly others, I'd guess. unix.stackexchange.com/a/62665/14831 –  njsg Jan 27 '13 at 22:01
add comment

Your Answer

 
discard

By posting your answer, you agree to the privacy policy and terms of service.

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