d/freebsd-skq
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases Wiki Activity

getprogname.3: Add an example

Browse Source 
It shows the difference between getprogname() and argv[0].

Reviewed by:	yuripv
Approved by:	yuripv (src)
MFC after:	2 weeks
Differential Revision:	https://reviews.freebsd.org/D27204
This commit is contained in:
Mateusz Piotrowski 2021-04-17 23:26:54 +02:00
parent 40277af7f2
commit 1ffdcdadf6
1 changed files with 27 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

28
lib/libc/gen/getprogname.3
View File

@ -31,7 +31,7 @@
.\" .\"
.\" $FreeBSD$ .\" $FreeBSD$
.\" .\"
.Dd May 1, 2001 .Dd April 18, 2021
.Dt GETPROGNAME 3 .Dt GETPROGNAME 3
.Os .Os
.Sh NAME .Sh NAME
@ -84,6 +84,32 @@ Calling
.Fn setprogname .Fn setprogname
allows the aforementioned library to learn the program name without allows the aforementioned library to learn the program name without
modifications to the start-up code. modifications to the start-up code.
.Sh EXAMPLES
The following example presents a simple program, which shows the difference
between
.Fn getprogname
and
.Va "argv[0]" .
.Bd -literal -offset indent
#include <stdio.h>
#include <stdlib.h>
int
main(int argc, char** argv)
{
printf("getprogname(): %s\en", getprogname());
printf("argv[0]: %s\en", argv[0]);
return (0);
}
.Ed
.Pp
When compiled and executed (e.g., with
.Ql ./a.out )
the output of the program is going to look like this:
.Bd -literal -offset indent
getprogname(): a.out
argv[0]: ./a.out
.Ed
.Sh SEE ALSO .Sh SEE ALSO
.Xr err 3 , .Xr err 3 ,
.Xr setproctitle 3 .Xr setproctitle 3