Tcl_FindExecutable(3)

NAME
Tcl_FindExecutable - identify the binary file containing the application

SYNOPSIS
#include <tcl.h>

char *
Tcl_FindExecutable(argv0)

ARGUMENTS
The first command-line argument to the program, which gives the application's name.

DESCRIPTION

This procedure computes the full path name of the executable 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, is is needed on some platforms in the implementation of the load command. It is also returned by the info nameofexecutable 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_FindExecutable uses argv0 along with the PATH environment variable 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