Tcl_FindExecutable(3)

_________________________________________________________________

NAME
       Tcl_FindExecutable  -  identify the binary file containing
       the application

SYNOPSIS
       #include <<tcl.h>>

       char *
       Tcl_FindExecutable(argv0)

ARGUMENTS
       char   *argv0   (in)      The first command-line  argument
                                 to  the program, which gives the
                                 application's name.
_________________________________________________________________

DESCRIPTION
       This procedure computes the full path  name  of  the  exe-
       cutable  file  from  which the application was invoked and
       saves it for Tcl's internal use.   The  executable's  path
       name  is needed for several purposes in Tcl.  For example,
       it is needed on some platforms in  the  implementation  of
       the  load  command.  It is also returned by the info name-
       ofexecutable command.

       On UNIX platforms this procedure is typically  invoked  as
       the  very  first  thing in the application's main program;
       it must be passed argv[0] as its  argument.   Tcl_FindExe-
       cutable  uses  argv0 along with the PATH environment vari-
       able to find the application's  executable,  if  possible.
       If  it fails to find the binary, then future calls to info
       nameofexecutable will return an empty string.

KEYWORDS
       binary, executable file