1/* Program name management.
2 Copyright (C) 2001-2004, 2006, 2009-2019 Free Software Foundation, Inc.
3 Written by Bruno Haible <bruno@clisp.org>, 2001.
4
5 This program is free software: you can redistribute it and/or modify
6 it under the terms of the GNU General Public License as published by
7 the Free Software Foundation; either version 3 of the License, or
8 (at your option) any later version.
9
10 This program is distributed in the hope that it will be useful,
11 but WITHOUT ANY WARRANTY; without even the implied warranty of
12 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
13 GNU General Public License for more details.
14
15 You should have received a copy of the GNU General Public License
16 along with this program. If not, see <https://www.gnu.org/licenses/>. */
17
18#ifndef _PROGNAME_H
19#define _PROGNAME_H
20
21/* Programs using this file should do the following in main():
22 set_program_name (argv[0]);
23 */
24
25
26#ifdef __cplusplus
27extern "C" {
28#endif
29
30
31/* String containing name the program is called with. */
32extern const char *program_name;
33
34/* Set program_name, based on argv[0].
35 argv0 must be a string allocated with indefinite extent, and must not be
36 modified after this call. */
37extern void set_program_name (const char *argv0);
38
39#if ENABLE_RELOCATABLE
40
41/* Set program_name, based on argv[0], and original installation prefix and
42 directory, for relocatability. */
43extern void set_program_name_and_installdir (const char *argv0,
44 const char *orig_installprefix,
45 const char *orig_installdir);
46#undef set_program_name
47#define set_program_name(ARG0) \
48 set_program_name_and_installdir (ARG0, INSTALLPREFIX, INSTALLDIR)
49
50/* Return the full pathname of the current executable, based on the earlier
51 call to set_program_name_and_installdir. Return NULL if unknown. */
52extern char *get_full_program_name (void);
53
54#endif
55
56
57#ifdef __cplusplus
58}
59#endif
60
61
62#endif /* _PROGNAME_H */
63