home   contributing   bugs   download   online pages  

NAME | SYNOPSIS | DESCRIPTION | CONFORMING TO | NOTES | SEE ALSO | COLOPHON


INVOCATION_NAME(3)            Linux Programmer's Manual            INVOCATION_NAME(3)

NAME         top

       program_invocation_name,  program_invocation_short_name  - obtain name used to
       invoke calling program

SYNOPSIS         top

       #define _GNU_SOURCE
       #include <errno.h>

       extern char *program_invocation_name;
       extern char *program_invocation_short_name;

DESCRIPTION         top

       program_invocation_name contains the name that was used to invoke the calling
       program.  This is the same as the value of argv[0] in main(), with the
       difference that the scope of program_invocation_name is global.

       program_invocation_short_name contains the basename component of name that was
       used to invoke the calling program.  That is, it is the same value as
       program_invocation_name, with all text up to and including the final slash
       (/), if any, removed.

       These variables are automatically initialized by the glibc run-time startup
       code.

CONFORMING TO         top

       These variables are GNU extensions, and should not be used in programs
       intended to be portable.

NOTES         top

       The Linux-specific /proc/[number]/cmdline file provides access to similar
       information.

SEE ALSO         top

       proc(5), feature_test_macros(7)

COLOPHON         top

       This page is part of release 3.23 of the Linux man-pages project.  A
       description of the project, and information about reporting bugs, can be found
       at http://www.kernel.org/doc/man-pages/.

GNU                                   2006-04-29                   INVOCATION_NAME(3)