How can I find where certain bash function is defined?
772
There are many functions that can be used in Bash shell. Their definitions can be listed by set, but how to find in which files certain user defined functions are defined?
If set at shell invocation, or in a shell startup file, arrange to
execute the debugger profile before the shell starts, identical to the
--debugger option. If set after invocation, behavior intended for
use by debuggers is enabled:
The -F option to the declare builtin (see Bash Builtins) displays the source file name and line number corresponding to each
function name supplied as an argument.
This is actually more complicated than it appears at first. Which files are read by your shell depends on what type of shell you are currently running. Whether it is interactive or not, whether it is a login or a non-login shell and what combination of the above. To search through all the default files that can be read by the different shells, you can do (change $functionName to the actual name of the function you are looking for):
That probably needs some explanation. The -P enables Perl Compatible Regular Expressions (PCRE) which let us use some fancier regex syntax. Specifically:
(^|\s): match either the beginning of a line (^) or whitespace (\s).
(\.|source)\s+ : match either a literal . character (\.) or the word source, but only if they are followed by one or more whitespace characters.
As you can see, however, this will print the entire matched line. What we are really interested in is the list of file names called, not the line that is calling them. You can get those with this, more complicated, regex:
The -h flag suppresses the printing of the file names where a match was found, which grep does by default when told to search through multiple files. The -o means "only print the matching portion of the line". The extra stuff added to the regex are:
\K : ignore anything matched up to this point. This is a PCRE trick that lets you use a complex regex to find your match but not include that matched portion when using grep's -o flag.
Note that I happen to have a use of . followed by a space which is not used for sourcing but that's because I have an alias that is calling another language, not bash. That's what gives the weird $a*100/$c and ")\n"' in the output above. But that can be ignored.
Finally, here's how to put all of that together and search for a function name in all default files and all files your default files are sourcing:
grep_function(){
target="$@"
files=( ~/.bashrc ~/.profile ~/.bash_profile ~/.bash.login
~/.bash_aliases /etc/bash.bashrc /etc/profile
/etc/profile.d/* /etc/environment)
while IFS= read -r file; do
files+=( "$file" )
done < <(grep -hPo '(^|\s)(\.|source)\s+\K\S+' "${files[@]}" 2>/dev/null)
for file in "${files[@]}"; do
## The tilde of ~/ can break this
file=$(sed 's|~/|'"$HOME"'/|g' <<<"$file")
if [[ -e $file ]]; then
grep -H "$target" -- "$file"
fi
done
}
Add those lines to your ~/.bashrc and you can then run (I am using fooBar as an example function name):
The usual per-user dotfile bash reads is ~/.bashrc. However, it may very well source other files, I for instance like to keep aliases and functions in separate files called ~/.bash_aliases and ~/.bash_functions, which makes finding them much easier. You can search the .bashrc for source commands with:
Turn on debugging. From the Bash manual:
Example:
And indeed:
This is actually more complicated than it appears at first. Which files are read by your shell depends on what type of shell you are currently running. Whether it is interactive or not, whether it is a login or a non-login shell and what combination of the above. To search through all the default files that can be read by the different shells, you can do (change
$functionName
to the actual name of the function you are looking for):If that doesn't work, you may be calling a non-default file using
.
or its aliassource
. To find such cases, run:That probably needs some explanation. The
-P
enables Perl Compatible Regular Expressions (PCRE) which let us use some fancier regex syntax. Specifically:(^|\s)
: match either the beginning of a line (^
) or whitespace (\s
).(\.|source)\s+
: match either a literal.
character (\.
) or the wordsource
, but only if they are followed by one or more whitespace characters.Here's what that gives me on my system:
As you can see, however, this will print the entire matched line. What we are really interested in is the list of file names called, not the line that is calling them. You can get those with this, more complicated, regex:
The
-h
flag suppresses the printing of the file names where a match was found, whichgrep
does by default when told to search through multiple files. The-o
means "only print the matching portion of the line". The extra stuff added to the regex are:\K
: ignore anything matched up to this point. This is a PCRE trick that lets you use a complex regex to find your match but not include that matched portion when using grep's-o
flag.On my system, the above command will return:
Note that I happen to have a use of
.
followed by a space which is not used for sourcing but that's because I have an alias that is calling another language, not bash. That's what gives the weird$a*100/$c
and")\n"'
in the output above. But that can be ignored.Finally, here's how to put all of that together and search for a function name in all default files and all files your default files are sourcing:
Add those lines to your
~/.bashrc
and you can then run (I am usingfooBar
as an example function name):For example, if I have this line in my
~/.bashrc
:And the file
~/a
is:I should find it with:
The usual per-user dotfile
bash
reads is~/.bashrc
. However, it may very well source other files, I for instance like to keep aliases and functions in separate files called~/.bash_aliases
and~/.bash_functions
, which makes finding them much easier. You can search the.bashrc
forsource
commands with:Once you have the list of user-created files you can search them and the user’s
.bashrc
with a singlegrep
call, e.g. for functionfoo
for my setup: