NAME

       getprogname, setprogname — get and set program name

LIBRARY

       Utility functions from BSD systems (libbsd, -lbsd)

SYNOPSIS

       #include <stdlib.h>
       (See libbsd(7) for include usage.)

       const char *
       getprogname(void);

       void
       setprogname(const char *progname);

DESCRIPTION

       The getprogname() returns a string with the current program name, excluding any directory component.  The
       function will return NULL if it was unable to get the program name from any known source.

       The  setprogname() function sets the current program name, stripping any directory component prefix.  The
       function will keep a reference to the passed string pointer, so it must not be freed  or  modified  while
       these functions might be called.

       The  implementations  on  most  BSDs will try to initialize the program name at program startup time, and
       libbsd will try to infer it from various known sources depending on the target system.  But it is  not  a
       portable assumption that the program name will be set without calling setprogname(), so portable programs
       should always call it after starting up.

SEE ALSO

       setproctitle(3bsd).

HISTORY

       The  setprogname()  and  getprogname() functions first appeared in NetBSD 1.6, FreeBSD 4.4, DragonFly 2.1
       and OpenBSD 5.4.

Debian                                           August 03, 2022                               getprogname(3bsd)