summaryrefslogtreecommitdiff
path: root/doc/progname.texi
blob: 13c9c7ba9792fe488a996495fd5211ec6a1340a0 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
@node progname and getprogname
@section progname and getprogname

@c Copyright (C) 2007, 2009-2019 Free Software Foundation, Inc.

@c Permission is granted to copy, distribute and/or modify this document
@c under the terms of the GNU Free Documentation License, Version 1.3 or
@c any later version published by the Free Software Foundation; with no
@c Invariant Sections, no Front-Cover Texts, and no Back-Cover
@c Texts.  A copy of the license is included in the ``GNU Free
@c Documentation License'' file as part of this distribution.

Gnulib has two modules for retrieving the name of the currently executing
program: @code{progname} and @code{getprogname}.

@findex progname
@vindex program_name
The @code{progname} module defines a variable @code{program_name}.
It contains the name of the currently executing program, on all platforms.
But it cannot be used implicitly:  It requires that every @code{main}
function be modified to invoke @code{set_program_name (argv[0])} as one
of its first actions.

@findex getprogname
The @code{getprogname} module defines a function @code{getprogname()}.
It returns the name of the currently executing program, on most platforms.
The advantage of this module is that it can be used without prior
initializations.  But it has limitations:  In some rare situations, it
cannot determine the name; then it returns @code{"?"} instead.  And on
some platforms, it returns a truncated program name.

@findex error
The @code{error} function uses the @code{getprogname} module.