suckless
/
sbase
mirror of git://git.suckless.org/sbase
1
0
Fork 0
Code Issues Projects Releases Wiki Activity
sbase/getconf.1

61 lines
844 B
Groff
Raw Normal View History

Use ISO-date-format in manpages The one specified by mdoc is hard to read for non-native speakers from countries which read the date day-first (like Germany, Greece, North-Korea, Swamp,...). This is also consistent with how we generally specify dates at suckless.org.
2015-10-08 15:15:08 +00:00
.Dd 2015-10-08
Add getconf(1) The logic is simple, it's just a pain in the ass to fill the data-structures. Some lines had to be commented out, as glibc/musl apparently have not fully implemented the mandatory variables for the 2013 corrigendum of POSIX 2008. Also added a manpage and the necessary entries in README. I also removed it from the TODO.
2015-09-30 22:59:40 +00:00
.Dt GETCONF 1
.Os sbase
.Sh NAME
.Nm getconf
.Nd get configuration values
.Sh SYNOPSIS
.Nm
.Op Fl v Ar spec
.Ar var
.Ar [path]
.Sh DESCRIPTION
.Nm
writes the value of the variable
.Ar var
to stdout.
.sp
If
.Ar path
is given,
.Ar var
is matched against configuration values from
.Xr pathconf 3 .
If
.Ar path
is not given,
.Ar var
is matched against configuration values from
.Xr sysconf 3 ,
.Xr confstr 3
and limits.h (Minimum and Maximum).
.sp
If
.Ar var
getconf: Report invalid variables as errors Printing `undefined` to stdout means that the variable is valid but not set. Instead, report an error in this case. linux 4.13 appends the result of `getconf LFS_CFLAGS` to HOSTCFLAGS, even if it prints `undefined`. This is arguably a bug in the Makefile, but even so, getconf shouldn't report that unsupported variables are valid.
2017-09-03 22:39:47 +00:00
is not defined,
Add getconf(1) The logic is simple, it's just a pain in the ass to fill the data-structures. Some lines had to be commented out, as glibc/musl apparently have not fully implemented the mandatory variables for the 2013 corrigendum of POSIX 2008. Also added a manpage and the necessary entries in README. I also removed it from the TODO.
2015-09-30 22:59:40 +00:00
.Nm
writes "undefined" to stdout.
.Sh OPTIONS
.Bl -tag -width Ds
.It Fl v Ar spec
Ignored.
.El
.Sh EXIT STATUS
.Bl -tag -width Ds
.It 0
.Ar var
was matched and its value written successfully.
.It 1
An error occured or
.Ar var
getconf: Report invalid variables as errors Printing `undefined` to stdout means that the variable is valid but not set. Instead, report an error in this case. linux 4.13 appends the result of `getconf LFS_CFLAGS` to HOSTCFLAGS, even if it prints `undefined`. This is arguably a bug in the Makefile, but even so, getconf shouldn't report that unsupported variables are valid.
2017-09-03 22:39:47 +00:00
was invalid.
getconf.1: fix: end list (El)
2015-10-09 23:18:24 +00:00
.El
Add getconf(1) The logic is simple, it's just a pain in the ass to fill the data-structures. Some lines had to be commented out, as glibc/musl apparently have not fully implemented the mandatory variables for the 2013 corrigendum of POSIX 2008. Also added a manpage and the necessary entries in README. I also removed it from the TODO.
2015-09-30 22:59:40 +00:00
.Sh STANDARDS
The
.Nm
utility is compliant with the
.St -p1003.1-2013
specification except from the
.Op Fl v
flag.