* scripts/config.guess: Update from master, timestamp='2006-02-27'.
[glibc.git] / elf / ldd.bash.in
blob100d2335d2be2519229800e9328027e0be07c1eb
1 #! @BASH@
2 # Copyright (C) 1996-2004, 2005, 2006 Free Software Foundation, Inc.
3 # This file is part of the GNU C Library.
5 # The GNU C Library is free software; you can redistribute it and/or
6 # modify it under the terms of the GNU Lesser General Public
7 # License as published by the Free Software Foundation; either
8 # version 2.1 of the License, or (at your option) any later version.
10 # The GNU C Library is distributed in the hope that it will be useful,
11 # but WITHOUT ANY WARRANTY; without even the implied warranty of
12 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
13 # Lesser General Public License for more details.
15 # You should have received a copy of the GNU Lesser General Public
16 # License along with the GNU C Library; if not, write to the Free
17 # Software Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA
18 # 02111-1307 USA.
21 # This is the `ldd' command, which lists what shared libraries are
22 # used by given dynamically-linked executables. It works by invoking the
23 # run-time dynamic linker as a command and setting the environment
24 # variable LD_TRACE_LOADED_OBJECTS to a non-empty value.
26 # We should be able to find the translation right at the beginning.
27 TEXTDOMAIN=libc
28 TEXTDOMAINDIR=@TEXTDOMAINDIR@
30 RTLDLIST=@RTLD@
31 warn=
32 bind_now=
33 verbose=
35 while test $# -gt 0; do
36 case "$1" in
37 --vers | --versi | --versio | --version)
38 echo 'ldd (GNU libc) @VERSION@'
39 printf $"Copyright (C) %s Free Software Foundation, Inc.
40 This is free software; see the source for copying conditions. There is NO
41 warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
42 " "2006"
43 printf $"Written by %s and %s.
44 " "Roland McGrath" "Ulrich Drepper"
45 exit 0
47 --h | --he | --hel | --help)
48 echo $"Usage: ldd [OPTION]... FILE...
49 --help print this help and exit
50 --version print version information and exit
51 -d, --data-relocs process data relocations
52 -r, --function-relocs process data and function relocations
53 -u, --unused print unused direct dependencies
54 -v, --verbose print all information
55 For bug reporting instructions, please see:
56 <http://www.gnu.org/software/libc/bugs.html>."
57 exit 0
59 -d | --d | --da | --dat | --data | --data- | --data-r | --data-re | \
60 --data-rel | --data-relo | --data-reloc | --data-relocs)
61 warn=yes
62 shift
64 -r | --f | --fu | --fun | --func | --funct | --functi | --functio | \
65 --function | --function- | --function-r | --function-re | --function-rel | \
66 --function-relo | --function-reloc | --function-relocs)
67 warn=yes
68 bind_now=yes
69 shift
71 -v | --verb | --verbo | --verbos | --verbose)
72 verbose=yes
73 shift
75 -u | --u | --un | --unu | --unus | --unuse | --unused)
76 unused=yes
77 shift
79 --v | --ve | --ver)
80 echo >&2 $"ldd: option \`$1' is ambiguous"
81 exit 1
83 --) # Stop option processing.
84 shift; break
86 -*)
87 echo >&2 'ldd:' $"unrecognized option" "\`$1'"
88 echo >&2 $"Try \`ldd --help' for more information."
89 exit 1
92 break
94 esac
95 done
97 nonelf ()
99 # Maybe extra code for non-ELF binaries.
100 return 1;
103 add_env="LD_TRACE_LOADED_OBJECTS=1 LD_WARN=$warn LD_BIND_NOW=$bind_now"
104 add_env="$add_env LD_VERBOSE=$verbose"
105 if test "$unused" = yes; then
106 add_env="$add_env LD_DEBUG=\"$LD_DEBUG${LD_DEBUG:+,}unused\""
109 # The following use of cat is needed to make ldd work in SELinux
110 # environments where the executed program might not have permissions
111 # to write to the console/tty. But only bash 3.x supports the pipefail
112 # option, and we don't bother to handle the case for older bash versions.
113 if set -o pipefail 2> /dev/null; then
114 try_trace() {
115 eval $add_env '"$@"' | cat
117 else
118 try_trace() {
119 eval $add_env '"$@"'
123 case $# in
125 echo >&2 'ldd:' $"missing file arguments"
126 echo >&2 $"Try \`ldd --help' for more information."
127 exit 1
130 single_file=t
133 single_file=f
135 esac
137 result=0
138 for file do
139 # We don't list the file name when there is only one.
140 test $single_file = t || echo "${file}:"
141 case $file in
142 */*) :
144 *) file=./$file
146 esac
147 if test ! -f "$file"; then
148 echo "ldd: ${file}:" $"No such file or directory" >&2
149 result=1
150 elif test -r "$file"; then
151 test -x "$file" || echo 'ldd:' $"\
152 warning: you do not have execution permission for" "\`$file'" >&2
153 RTLD=
154 for rtld in ${RTLDLIST}; do
155 if test -x $rtld; then
156 verify_out=`${rtld} --verify "$file"`
157 ret=$?
158 case $ret in
159 [02]) RTLD=${rtld}; break;;
160 esac
162 done
163 if test -z "${RTLD}"; then
164 set ${RTLDLIST}
165 RTLD=$1
166 verify_out=`${RTLD} --verify "$file"`
167 ret=$?
169 case $ret in
171 # If the program exits with exit code 5, it means the process has been
172 # invoked with __libc_enable_secure. Fall back to running it through
173 # the dynamic linker.
174 try_trace "$file"
175 rc=$?
176 if [ $rc = 5 ]; then
177 try_trace "$RTLD" "$file"
178 rc=$?
180 [ $rc = 0 ] || result=1
183 # This can be a non-ELF binary or no binary at all.
184 nonelf "$file" || {
185 echo $" not a dynamic executable"
186 result=1
190 try_trace "$RTLD" "$file" || result=1
193 echo 'ldd:' ${RTLD} $"exited with unknown exit code" "($ret)" >&2
194 exit 1
196 esac
197 else
198 echo 'ldd:' $"error: you do not have read permission for" "\`$file'" >&2
199 result=1
201 done
203 exit $result
204 # Local Variables:
205 # mode:ksh
206 # End: