summaryrefslogtreecommitdiff
path: root/getconf/getconf.1
blob: 35f9c13a07e66e800d5f06ecfdf57a5228887c39 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
.Dd April 9, 2016
.Dt GETCONF 1 "Base Commands Manual"
.Os "Adélie Linux"

.Sh NAME
.Nm getconf
.Nd get system configuration values

.Sh SYNOPSIS
.Nm
.Op Fl v Ar specification
.Ar system_var

.Nm
.Op Fl v Ar specification
.Ar path_var
.Ar pathname

.Sh DESCRIPTION
In the first form, the
.Nm
utility prints the value of the system variable specified by
.Ar system_var
on the currently running system, under the specification given for the
.Fl v
argument if specified.

Valid system variables are one of the following:

.Bl -bullet -offset indent -compact
.It
The variable name of a valid parameter to the
.Xr sysconf 3
function as specified in
.St -p1003.1-2008 ,
excluding braces.  The variables
.Dq _SC_CLK_TCK ,
.Dq _SC_GETGR_R_SIZE_MAX ,
and
.Dq _SC_GETPW_R_SIZE_MAX
are not supported.
.It
A valid parameter to the
.Xr confstr 3
function as specified in
.St -p1003.1-2008 ,
excluding the
.Dq _CS_
prefix.
.It
A constant listed under the
.Dq Maximum Values
or
.Dq Minimum Values
section of the
.Aq Pa limits.h
header as specified in
.St -p1003.1-2008 ,
excluding braces.
.El

In the second form, the
.Nm
utility prints the value of the path variable specified by
.Ar path_var
for the path specified by
.Ar pathname
on the currently running system, under the specification given for the
.Fl v
argument if specified.

Valid path variables are those accepted by the
.Xr fpathconf 3
function as specified in
.St -p1003.1-2008 ,
exluding braces.

.Sh OPTIONS
.Bl -tag
.It -v
Indicates the specification to use.  Currently, this option is unsupported and
will be ignored.
.El

.Sh DIAGNOSTICS
.Ex -std

.Sh SEE ALSO

.Xr confstr 3 ,
.Xr fpathconf 3 ,
.Xr sysconf 3 .

.Sh STANDARDS
The eventual goal for the
.Nm
utility is full conformance to
.St -p1003.1 2013 Edition.

.Sh AUTHORS
.An A. Wilcox
.Aq awilfox@adelielinux.org

.Sh BUGS
The
.Fl v
argument is not currently handled correctly.
.Pp
.Ar path_var
variables are not yet supported.