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 Tue Jun 25 20:41:12 CEST 2024.