dwww Home | Manual pages | Find package

getprogname(3bsd)                    LOCAL                   getprogname(3bsd)

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, exclud-
     ing any directory component.  The function will return NULL if it was un-
     able 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.

BSD                             August 03, 2022                            BSD

Generated by dwww version 1.15 on Sun Jun 16 18:43:46 CEST 2024.