Introduce getprogname(3) and setprogname(3) library calls. These get
and set __progname, respectively. Discussed on: -arch (Feb 2001), -audit Reviewed by: -audit Approved by: kris Obtained from: (mostly) NetBSD
This commit is contained in:
Dima Dorfman
parent
54570134fe
commit
cd18ccdc30
@ -157,6 +157,8 @@ int cgetustr __P((char *, char *, char **));
|
||||
int daemon __P((int, int));
|
||||
char *devname __P((int, int));
|
||||
int getloadavg __P((double [], int));
|
||||
const char *
|
||||
getprogname __P((void));
|
||||
|
||||
char *group_from_gid __P((unsigned long, int));
|
||||
int heapsort __P((void *, size_t, size_t,
|
||||
@ -172,6 +174,7 @@ int rand_r __P((unsigned *));
|
||||
long random __P((void));
|
||||
void *reallocf __P((void *, size_t));
|
||||
char *realpath __P((const char *, char resolved_path[]));
|
||||
void setprogname __P((const char *));
|
||||
char *setstate __P((char *));
|
||||
void srandom __P((unsigned long));
|
||||
void sranddev __P((void));
|
||||
|
||||
@ -13,7 +13,7 @@ SRCS+= __xuname.c _pthread_stubs.c _rand48.c _spinlock_stub.c _thread_init.c \
|
||||
getcap.c getcwd.c getdomainname.c getgrent.c getgrouplist.c \
|
||||
gethostname.c getloadavg.c getlogin.c getmntinfo.c getnetgrent.c \
|
||||
getobjformat.c getosreldate.c getpagesize.c \
|
||||
getpass.c getpwent.c getttyent.c \
|
||||
getpass.c getprogname.c getpwent.c getttyent.c \
|
||||
getusershell.c getvfsbyname.c getvfsent.c glob.c \
|
||||
initgroups.c isatty.c jrand48.c lcong48.c \
|
||||
lockf.c lrand48.c mrand48.c msgctl.c \
|
||||
@ -22,7 +22,8 @@ SRCS+= __xuname.c _pthread_stubs.c _rand48.c _spinlock_stub.c _thread_init.c \
|
||||
pause.c popen.c psignal.c pw_scan.c pwcache.c raise.c readdir.c rewinddir.c \
|
||||
posixshm.c \
|
||||
scandir.c seed48.c seekdir.c semconfig.c semctl.c semget.c semop.c \
|
||||
setdomainname.c sethostname.c setjmperr.c setmode.c setproctitle.c \
|
||||
setdomainname.c sethostname.c setjmperr.c setmode.c setprogname.c \
|
||||
setproctitle.c \
|
||||
shmat.c shmctl.c shmdt.c shmget.c siginterrupt.c siglist.c signal.c \
|
||||
sigsetops.c sleep.c srand48.c stringlist.c strtofflags.c \
|
||||
sysconf.c sysctl.c sysctlbyname.c sysctlnametomib.c \
|
||||
@ -43,7 +44,7 @@ MAN+= alarm.3 arc4random.3 clock.3 \
|
||||
getdiskbyname.3 getdomainname.3 getfsent.3 \
|
||||
getgrent.3 getgrouplist.3 gethostname.3 getloadavg.3 \
|
||||
getmntinfo.3 getnetgrent.3 getobjformat.3 \
|
||||
getpagesize.3 getpass.3 getpwent.3 \
|
||||
getpagesize.3 getpass.3 getprogname.3 getpwent.3 \
|
||||
getttyent.3 getusershell.3 getvfsbyname.3 getvfsent.3 \
|
||||
glob.3 initgroups.3 isinf.3 \
|
||||
ldexp.3 lockf.3 modf.3 msgctl.3 msgget.3 msgrcv.3 msgsnd.3 \
|
||||
@ -82,6 +83,7 @@ MLINKS+=getgrent.3 endgrent.3 getgrent.3 getgrgid.3 getgrent.3 getgrnam.3 \
|
||||
MLINKS+=gethostname.3 sethostname.3
|
||||
MLINKS+=getnetgrent.3 endnetgrent.3 getnetgrent.3 innetgr.3 \
|
||||
getnetgrent.3 setnetgrent.3
|
||||
MLINKS+=getprogname.3 setprogname.3
|
||||
MLINKS+=getpwent.3 endpwent.3 getpwent.3 getpwnam.3 getpwent.3 getpwuid.3 \
|
||||
getpwent.3 setpassent.3 getpwent.3 setpwent.3 getpwent.3 setpwfile.3
|
||||
MLINKS+=getttyent.3 endttyent.3 getttyent.3 getttynam.3 \
|
||||
|
||||
92
lib/libc/gen/getprogname.3
Normal file
92
lib/libc/gen/getprogname.3
Normal file
@ -0,0 +1,92 @@
|
||||
.\"
|
||||
.\" Copyright (c) 2001 Christopher G. Demetriou
|
||||
.\" All rights reserved.
|
||||
.\"
|
||||
.\" Redistribution and use in source and binary forms, with or without
|
||||
.\" modification, are permitted provided that the following conditions
|
||||
.\" are met:
|
||||
.\" 1. Redistributions of source code must retain the above copyright
|
||||
.\" notice, this list of conditions and the following disclaimer.
|
||||
.\" 2. Redistributions in binary form must reproduce the above copyright
|
||||
.\" notice, this list of conditions and the following disclaimer in the
|
||||
.\" documentation and/or other materials provided with the distribution.
|
||||
.\" 3. All advertising materials mentioning features or use of this software
|
||||
.\" must display the following acknowledgement:
|
||||
.\" This product includes software developed for the
|
||||
.\" NetBSD Project. See http://www.netbsd.org/ for
|
||||
.\" information about NetBSD.
|
||||
.\" 4. The name of the author may not be used to endorse or promote products
|
||||
.\" derived from this software without specific prior written permission.
|
||||
.\"
|
||||
.\" THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
|
||||
.\" IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
|
||||
.\" OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
|
||||
.\" IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
|
||||
.\" INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
|
||||
.\" NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
|
||||
.\" DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
|
||||
.\" THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
|
||||
.\" (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
|
||||
.\" THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
|
||||
.\"
|
||||
.\" $FreeBSD$
|
||||
.\"
|
||||
.Dd May 1, 2001
|
||||
.Dt GETPROGNAME 3
|
||||
.Os
|
||||
.Sh NAME
|
||||
.Nm getprogname ,
|
||||
.Nm setprogname
|
||||
.Nd get or set the program name
|
||||
.Sh LIBRARY
|
||||
.Lb libc
|
||||
.Sh SYNOPSIS
|
||||
.Fd #include <stdlib.h>
|
||||
.Ft const char *
|
||||
.Fn getprogname "void"
|
||||
.Ft void
|
||||
.Fn setprogname "const char *progname"
|
||||
.Sh DESCRIPTION
|
||||
The
|
||||
.Fn getprogname
|
||||
and
|
||||
.Fn setprogname
|
||||
functions manipulate the name of the current program.
|
||||
They are used by error-reporting routines to produce
|
||||
consistent output.
|
||||
.Pp
|
||||
The
|
||||
.Fn getprogname
|
||||
function returns the name of the program.
|
||||
If the name has not been set yet, it will return
|
||||
.Dv NULL .
|
||||
.Pp
|
||||
The
|
||||
.Fn setprogname
|
||||
function sets the name of the program.
|
||||
Since a pointer to the given string is kept as the program name,
|
||||
it should not be modified for the rest of the program's lifetime.
|
||||
.Pp
|
||||
In
|
||||
.Fx ,
|
||||
the name of the program is set by the start-up code that is run before
|
||||
.Fn main ;
|
||||
thus,
|
||||
running
|
||||
.Fn setprogname
|
||||
is not necessary.
|
||||
Programs that desire maximum portability should still call it;
|
||||
on another operating system,
|
||||
these functions may be implemented in a portability library.
|
||||
Calling
|
||||
.Fn setprogname
|
||||
allows the aforementioned library to learn the program name without
|
||||
modifications to the start-up code.
|
||||
.Sh SEE ALSO
|
||||
.Xr err 3 ,
|
||||
.Xr setproctitle 3
|
||||
.Sh HISTORY
|
||||
These functions first appeared in
|
||||
.Nx 1.6 ,
|
||||
and made their way into
|
||||
.Fx 5.0 .
|
||||
13
lib/libc/gen/getprogname.c
Normal file
13
lib/libc/gen/getprogname.c
Normal file
@ -0,0 +1,13 @@
|
||||
#if defined(LIBC_RCS) && !defined(lint)
|
||||
static const char rcsid[] =
|
||||
"$FreeBSD$";
|
||||
#endif /* LIBC_RCS and not lint */
|
||||
|
||||
extern const char *__progname;
|
||||
|
||||
const char *
|
||||
getprogname(void)
|
||||
{
|
||||
|
||||
return (__progname);
|
||||
}
|
||||
13
lib/libc/gen/setprogname.c
Normal file
13
lib/libc/gen/setprogname.c
Normal file
@ -0,0 +1,13 @@
|
||||
#if defined(LIBC_RCS) && !defined(lint)
|
||||
static const char rcsid[] =
|
||||
"$FreeBSD$";
|
||||
#endif /* LIBC_RCS and not lint */
|
||||
|
||||
extern const char *__progname;
|
||||
|
||||
void
|
||||
setprogname(const char *progname)
|
||||
{
|
||||
|
||||
__progname = progname;
|
||||
}
|
||||
Loading…
x
Reference in New Issue
Block a user