1/* Program name management.
2   Copyright (C) 2001-2004, 2006, 2009-2012 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 <http://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