Unix/Linux Go Back    


CentOS 7.0 - man page for tcl_findexecutable (centos section 3)

Linux & Unix Commands - Search Man Pages
Man Page or Keyword Search:   man
Select Man Page Set:       apropos Keyword Search (sections above)


Tcl_FindExecutable(3)		      Tcl Library Procedures		    Tcl_FindExecutable(3)

_________________________________________________________________________________________________

NAME
       Tcl_FindExecutable,  Tcl_GetNameOfExecutable  -	identify or return the name of the binary
       file containing the application

SYNOPSIS
       #include <tcl.h>

       void
       Tcl_FindExecutable(argv0)

       const char *
       Tcl_GetNameOfExecutable()

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

DESCRIPTION
       The  Tcl_FindExecutable	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, it is needed on some plat-
       forms 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.	It  is	important
       not  to change the working directory before the invocation.  Tcl_FindExecutable uses argv0
       along with the PATH environment variable to find the application's executable,  if  possi-
       ble.   If  it  fails  to  find the binary, then future calls to info nameofexecutable will
       return an empty string.

       Tcl_GetNameOfExecutable simply returns a pointer to the internal full  path  name  of  the
       executable  file  as  computed  by  Tcl_FindExecutable.	 This procedure call is the C API
       equivalent to the info nameofexecutable command.  NULL is returned if  the  internal  full
       path name has not been computed or unknown.

KEYWORDS
       binary, executable file

Tcl					       8.1			    Tcl_FindExecutable(3)
Unix & Linux Commands & Man Pages : ©2000 - 2018 Unix and Linux Forums


All times are GMT -4. The time now is 07:49 PM.