45.4 Fun with #!

[You might think that the "magic" characters #! are only for shell scripts. Not true ( 45.5 , 45.3 ) ! Here are some fun examples. Study them and (if your UNIX system understands #! ) try them; I hope they'll help you see what #! really does. -JP]

In fact, the script:

#! /bin/mv

will rename itself. Place it in a file called zap , and type zap zup , and now you have a shell script called zup . Your shell tried to exec the program with the argument zup . This succeeded, but actually ran /bin/mv with the arguments zap zup .

You can make self-removing scripts:

#! /bin/rm

Or self-printing scripts:

#! /bin/awk NR>1{print}
text...

This last one works because the kernel is willing to do more than insert the filename in the argument list: it will insert an optional argument. Some systems allow only one such argument (which can then contain blanks), while others allow multiple blank (space or TAB) separated arguments. Note that, in the latter case, there is probably no way to embed blanks (the kernel is unlikely to provide shell-like quoting mechanisms); the safest course is to avoid them entirely.

Normally, this is used for things like the -f option to the C shell ("fast", don't read .cshrc s), but it works well enough for awk too.

#! is described, though not completely, in the execve (2) manual page. Note that there may be a small limit on the number of characters in the #! line, typically 32. (32 is "magic" because it equals sizeof(struct exec) .)