whocalls(1)							   User Commands						       whocalls(1)

NAME

       whocalls - report on the calls to a specific procedure

SYNOPSIS

       whocalls [-l wholib] [-s] funcname executable
		 [arguments]...

DESCRIPTION

       whocalls is a simple example of a utility based on the Link-Auditing functionality of ld.so.1(1) that permits the tracking of a given func-
       tion call. See the Linker and Libraries Guide for a detailed description of the Link-Auditing mechanism. The executable is  run	as  normal
       with  any associated arguments. Each time the procedure funcname is called, both the arguments to that procedure and a stack trace are dis-
       played on standard output.

OPTIONS

       The following options are supported:

       -l wholib    Specifies an alternate who.so Link-Auditing library to use.

       -s	    When available, examines and uses the .symtab symbol table for local symbols. This is a little more expensive than	using  the
		    .dynsym symbol table, but can produce more detailed stack trace information.

EXAMPLES

       Example 1 Tracking Function Calls

       The following example tracks the calls to printf() made by a simple helloworld program:

	 example% whocalls printf helloworld
	 printf(0x106e4, 0xef625310, 0xef621ba8)
		 helloworld:main+0x10
		 helloworld:_start+0x5c
	 Hello World

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWtoo			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       ld.so.1(1), sotruss(1), attributes(5)

       Linker and Libraries Guide

SunOS 5.11							    3 Jul 2007							       whocalls(1)