Print this page
4146 getconf(1) does not support XATTR_ENABLED, XATTR_EXISTS, SATTR_ENABLED, SATTR_EXISTS keys
Reviewed by: Cedric Blancher <cedric.blancher@gmail.com>
Split |
Close |
Expand all |
Collapse all |
--- old/usr/src/man/man1/getconf.1
+++ new/usr/src/man/man1/getconf.1
1 1 '\" te
2 2 .\" Copyright (c) 1992, X/Open Company Limited All Rights Reserved
↓ open down ↓ |
2 lines elided |
↑ open up ↑ |
3 3 .\" Portions Copyright (c) 2009, Sun Microsystems, Inc. All Rights Reserved
4 4 .\" Portions Copyright (c) 1982-2007 AT&T Knowledge Ventures
5 5 .\" Sun Microsystems, Inc. gratefully acknowledges The Open Group for permission to reproduce portions of its copyrighted documentation. Original documentation from The Open Group can be obtained online at http://www.opengroup.org/bookstore/.
6 6 .\" The Institute of Electrical and Electronics Engineers and The Open Group, have given us permission to reprint portions of their documentation. In the following statement, the phrase "this text" refers to portions of the system documentation. Portions of this text
7 7 .\" are reprinted and reproduced in electronic form in the Sun OS Reference Manual, from IEEE Std 1003.1, 2004 Edition, Standard for Information Technology -- Portable Operating System Interface (POSIX), The Open Group Base Specifications Issue 6, Copyright (C) 2001-2004 by the Institute of Electrical
8 8 .\" and Electronics Engineers, Inc and The Open Group. In the event of any discrepancy between these versions and the original IEEE and The Open Group Standard, the original IEEE and The Open Group Standard is the referee document. The original Standard can be obtained online at http://www.opengroup.org/unix/online.html.
9 9 .\" This notice shall appear on any product containing this material.
10 10 .\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.
11 11 .\" See the License for the specific language governing permissions and limitations under the License. When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with
12 12 .\" the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
13 -.TH GETCONF 1 "Jan 16, 2013"
13 +.TH GETCONF 1 "Sep 27, 2013"
14 14 .SH NAME
15 15 getconf \- get configuration values
16 16 .SH SYNOPSIS
17 17 .SS "/usr/bin/getconf, /usr/xpg4/bin/getconf, /usr/xpg6/bin/getconf"
18 18 .LP
19 19 .nf
20 20 \fB/usr/bin/getconf\fR [\fB-v\fR \fIspecification\fR] \fIsystem_var\fR
21 21 .fi
22 22
23 23 .LP
24 24 .nf
25 25 \fB/usr/bin/getconf\fR [\fB-v\fR \fIspecification\fR] \fIpath_var\fR \fIpathname\fR
26 26 .fi
27 27
28 28 .LP
29 29 .nf
30 30 \fB/usr/bin/getconf\fR \fB-a\fR
31 31 .fi
32 32
33 33 .LP
34 34 .nf
35 35 \fB/usr/xpg4/bin/getconf\fR [\fB-v\fR \fIspecification\fR] \fIsystem_var\fR
36 36 .fi
37 37
38 38 .LP
39 39 .nf
40 40 \fB/usr/xpg4/bin/getconf\fR [\fB-v\fR \fIspecification\fR] \fIpath_var\fR \fIpathname\fR
41 41 .fi
42 42
43 43 .LP
44 44 .nf
45 45 \fB/usr/xpg4/bin/getconf\fR \fB-a\fR
46 46 .fi
47 47
48 48 .LP
49 49 .nf
50 50 \fB/usr/xpg6/bin/getconf\fR [\fB-v\fR \fIspecification\fR] \fIsystem_var\fR
51 51 .fi
52 52
53 53 .LP
54 54 .nf
55 55 \fB/usr/xpg6/bin/getconf\fR [\fB-v\fR \fIspecification\fR] \fIpath_var\fR \fIpathname\fR
56 56 .fi
57 57
58 58 .LP
59 59 .nf
60 60 \fB/usr/xpg6/bin/getconf\fR \fB-a\fR
61 61 .fi
62 62
63 63 .SS "ksh93"
64 64 .LP
65 65 .nf
66 66 \fBgetconf\fR [\fB-abdlpqrtw\fR] [\fB-c\fR RE] [\fB-n\fR RE] [\fB-s\fR RE] [\fB-v\fR \fIname\fR][\fIname\fR [\fIpath\fR [\fIvalue\fR]] ...]
67 67 .fi
68 68
69 69 .SH DESCRIPTION
70 70 .SS "/usr/bin/getconf, /usr/xpg4/bin/getconf, /usr/xpg6/bin/getconf"
71 71 .sp
72 72 .LP
73 73 In the first synopsis form, the \fBgetconf\fR utility writes to the standard
74 74 output the value of the variable specified by \fIsystem_var\fR, in accordance
75 75 with \fIspecification\fR if the \fB-v\fR option is used.
76 76 .sp
77 77 .LP
78 78 In the second synopsis form, \fBgetconf\fR writes to the standard output the
79 79 value of the variable specified by \fIpath_var\fR for the path specified by
80 80 \fIpathname\fR, in accordance with \fIspecification\fR if the \fB-v\fR option
81 81 is used.
82 82 .sp
83 83 .LP
84 84 In the third synopsis form, \fBconfig\fR writes to the standard output the
85 85 names of the current system configuration variables.
86 86 .sp
87 87 .LP
88 88 The value of each configuration variable is determined as if it were obtained
89 89 by calling the function from which it is defined to be available. The value
90 90 reflects conditions in the current operating environment.
91 91 .SS "ksh93"
92 92 .sp
93 93 .LP
94 94 The \fBgetconf\fR built-in in \fBksh93\fR is associated with the \fB/bin\fR and
95 95 \fB/usr/bin\fR paths. It is invoked when \fBgetconf\fR is executed without a
96 96 pathname prefix and the pathname search finds a \fB/bin/getconf\fR or
97 97 \fB/usr/bin/getconf\fR executable.
98 98 .sp
99 99 .LP
100 100 \fBgetconf\fR displays the system configuration value for \fIname\fR. If
101 101 \fIname\fR is a filesystem specific variable, the value is determined relative
102 102 to path, or, the current directory, if path is omitted. If \fIvalue\fR is
103 103 specified, \fBgetconf\fR attempts to change the process local value to
104 104 \fIvalue\fR. \fB-\fR can be used in place of path when it is not relevant. Only
105 105 writable variables can be set. \fBreadonly\fR variables cannot be changed.
106 106 .sp
107 107 .LP
108 108 The current value for \fIname\fR is written to the standard output. If
109 109 \fIname\fR is valid but undefined, \fBundefined\fR is written to the standard
110 110 output. If \fIname\fR is invalid or an error occurs in determining its value, a
111 111 diagnostic is written to standard error and \fBgetconf\fR exits with a
112 112 \fBnon-zero\fR exit status.
113 113 .sp
114 114 .LP
115 115 More than one variable can be set or queried by providing the \fIname path
116 116 value\fR 3-tuple for each variable, specifying \fB-\fR for value when querying.
117 117 .sp
118 118 .LP
119 119 If no operands are specified, all known variables are written in
120 120 \fIname\fR\fB=\fR\fIvalue\fR form to the standard output, one per line. Only
121 121 one of \fB--call\fR, \fB--name\fR or \fB--standard\fR can be specified.
122 122 .SH OPTIONS
123 123 .SS "/usr/bin/getconf, /usr/xpg4/bin/getconf, /usr/xpg6/bin/getconf"
124 124 .sp
125 125 .LP
126 126 The following options are supported by \fB/usr/bin/getconf\fR,
127 127 \fB/usr/xpg4/bin/getconf\fR, and \fB/usr/xpg6/bin/getconf\fR
128 128 .sp
129 129 .ne 2
130 130 .na
131 131 \fB\fB-a\fR\fR
132 132 .ad
133 133 .RS 19n
134 134 Writes the names of the current system configuration variables to the standard
135 135 output.
136 136 .RE
137 137
138 138 .sp
139 139 .ne 2
140 140 .na
141 141 \fB\fB-v\fR\fIspecification\fR\fR
142 142 .ad
143 143 .RS 19n
144 144 Gives the specification which governs the selection of values for configuration
145 145 variables.
146 146 .RE
147 147
148 148 .SS "ksh93"
149 149 .sp
150 150 .LP
151 151 The following options are supported by the \fBgetconf\fR built-in command in
152 152 \fBksh93\fR:
153 153 .sp
154 154 .ne 2
155 155 .na
156 156 \fB\fB-a\fR\fR
157 157 .ad
158 158 .br
159 159 .na
160 160 \fB\fB--all\fR\fR
161 161 .ad
162 162 .RS 24n
163 163 Call the native \fBgetconf -a\fR.
164 164 .RE
165 165
166 166 .sp
167 167 .ne 2
168 168 .na
169 169 \fB\fB-b\fR\fR
170 170 .ad
171 171 .br
172 172 .na
173 173 \fB\fB--base\fR\fR
174 174 .ad
175 175 .RS 24n
176 176 List base variable name without \fBcall\fR and standard prefixes.
177 177 .RE
178 178
179 179 .sp
180 180 .ne 2
181 181 .na
182 182 \fB\fB-c\fR\fR
183 183 .ad
184 184 .br
185 185 .na
186 186 \fB\fB--call=\fR\fIRE\fR\fR
187 187 .ad
188 188 .RS 24n
189 189 Display variables with \fBcall\fR prefix that matches \fIRE\fR. The \fBcall\fR
190 190 prefixes are:
191 191 .RS +4
192 192 .TP
193 193 .ie t \(bu
194 194 .el o
195 195 \fBCS\fR
196 196 .sp
197 197 \fBconfstr\fR(3C),
198 198 .RE
199 199 .RS +4
200 200 .TP
201 201 .ie t \(bu
202 202 .el o
203 203 \fBPC\fR
204 204 .sp
205 205 \fBpathconf\fR(2)
206 206 .RE
207 207 .RS +4
208 208 .TP
209 209 .ie t \(bu
210 210 .el o
211 211 \fBSC\fR
212 212 .sp
213 213 \fBsysconf\fR(3C)
214 214 .RE
215 215 .RS +4
216 216 .TP
217 217 .ie t \(bu
218 218 .el o
219 219 \fBSI\fR
220 220 .sp
221 221 \fBsysinfo\fR(2)
222 222 .RE
223 223 .RS +4
224 224 .TP
225 225 .ie t \(bu
226 226 .el o
227 227 \fBXX\fR
228 228 .sp
229 229 Constant value
230 230 .RE
231 231 .RE
232 232
233 233 .sp
234 234 .ne 2
235 235 .na
236 236 \fB\fB-d\fR\fR
237 237 .ad
238 238 .br
239 239 .na
240 240 \fB\fB--defined\fR\fR
241 241 .ad
242 242 .RS 24n
243 243 Only display defined values when no operands are specified.
244 244 .RE
245 245
246 246 .sp
247 247 .ne 2
248 248 .na
249 249 \fB\fB-l\fR\fR
250 250 .ad
251 251 .br
252 252 .na
253 253 \fB\fB--lowercase\fR\fR
254 254 .ad
255 255 .RS 24n
256 256 List variable names in lower case.
257 257 .RE
258 258
259 259 .sp
260 260 .ne 2
261 261 .na
262 262 \fB\fB-n\fR\fR
263 263 .ad
264 264 .br
265 265 .na
266 266 \fB\fB--name=\fR\fIRE\fR\fR
267 267 .ad
268 268 .RS 24n
269 269 Display variables with names that match \fIRE\fR.
270 270 .RE
271 271
272 272 .sp
273 273 .ne 2
274 274 .na
275 275 \fB\fB-p\fR\fR
276 276 .ad
277 277 .br
278 278 .na
279 279 \fB\fB--portable\fR\fR
280 280 .ad
281 281 .RS 24n
282 282 Display the named writable variables and values in a form that can be directly
283 283 executed by \fBksh93\fR(1) to set the values. If \fIname\fR is omitted, lists
284 284 all writable variables.
285 285 .RE
286 286
287 287 .sp
288 288 .ne 2
289 289 .na
290 290 \fB\fB-q\fR\fR
291 291 .ad
292 292 .br
293 293 .na
294 294 \fB\fB--quote\fR\fR
295 295 .ad
296 296 .RS 24n
297 297 Quote values (\fB"..."\fR).
298 298 .RE
299 299
300 300 .sp
301 301 .ne 2
302 302 .na
303 303 \fB\fB-r\fR\fR
304 304 .ad
305 305 .br
306 306 .na
307 307 \fB\fB--readonly\fR\fR
308 308 .ad
309 309 .RS 24n
310 310 Display the named \fBreadonly\fR variables in \fIname\fR\fB=\fR\fIvalue\fR
311 311 form. If \fIname\fR is omitted, lists all \fBreadonly\fR variables.
312 312 .RE
313 313
314 314 .sp
315 315 .ne 2
316 316 .na
317 317 \fB\fB-s\fR\fR
318 318 .ad
319 319 .br
320 320 .na
321 321 \fB\fB--standard=\fR\fIRE\fR\fR
322 322 .ad
323 323 .RS 24n
324 324 Display variables with standard prefix that matches \fIRE\fR. Use the
325 325 \fB--table\fR option to view all standard prefixes, including local additions.
326 326 .sp
327 327 The standard prefixes available on all systems are:
328 328 .sp
329 329 .in +2
330 330 .nf
331 331
332 332 AES
333 333 AST
334 334 C
335 335 GNU
336 336 POSIX
337 337 SVID
338 338 XBS5
339 339 XOPEN
340 340 XPG
341 341 .fi
342 342 .in -2
343 343 .sp
344 344
345 345 .RE
346 346
347 347 .sp
348 348 .ne 2
349 349 .na
350 350 \fB\fB-t\fR\fR
351 351 .ad
352 352 .br
353 353 .na
354 354 \fB\fB--table\fR\fR
355 355 .ad
356 356 .RS 24n
357 357 Display the internal table that contains the name, standard, standard section,
358 358 and system call symbol prefix for each variable.
359 359 .RE
360 360
361 361 .sp
362 362 .ne 2
363 363 .na
364 364 \fB\fB-w\fR\fR
365 365 .ad
366 366 .br
367 367 .na
368 368 \fB\fB--writable\fR\fR
369 369 .ad
370 370 .RS 24n
371 371 Display the named writable variables in \fIname\fR\fB=\fR\fIvalue\fR form. If
372 372 \fIname\fR is omitted, lists all writable variables.
373 373 .RE
374 374
375 375 .sp
376 376 .ne 2
377 377 .na
378 378 \fB\fB-v\fR\fR
379 379 .ad
380 380 .br
381 381 .na
382 382 \fB\fB--specification=name\fR\fR
383 383 .ad
384 384 .RS 24n
385 385 Call the native \fBgetconf -v\fR \fIname\fR.
386 386 .RE
387 387
388 388 .SH OPERANDS
389 389 .SS "/usr/bin/getconf, /usr/xpg4/bin/getconf, /usr/xpg6/bin/getconf"
390 390 .sp
391 391 .LP
392 392 The following operands are supported by \fB/usr/bin/getconf\fR,
393 393 \fB/usr/xpg4/bin/getconf\fR, and \fB/usr/xpg6/bin/getconf\fR:
394 394 .sp
395 395 .ne 2
396 396 .na
397 397 \fB\fIpath_var\fR\fR
398 398 .ad
399 399 .RS 12n
400 400 A name of a configuration variable whose value is available from the
↓ open down ↓ |
377 lines elided |
↑ open up ↑ |
401 401 \fBpathconf\fR(2) function. All of the values in the following table are
402 402 supported:
403 403 .RE
404 404
405 405 .sp
406 406
407 407 .sp
408 408 .TS
409 409 l l l
410 410 l l l .
411 -LINK_MAX NAME_MAX _POSIX_CHOWN_RESTRICTED
412 -MAX_CANON PATH_MAX _POSIX_NO_TRUNC
413 -MAX_INPUT PIPE_BUF _POSIX_VDISABLE
411 +ACL_ENABLED NAME_MAX XATTR_ENABLED
412 +LINK_MAX PATH_MAX XATTR_EXISTS
413 +MAX_CANON PIPE_BUF _POSIX_CHOWN_RESTRICTED
414 +MAX_INPUT SATTR_ENABLED _POSIX_NO_TRUNC
415 +MIN_HOLE_SIZE SATTR_EXISTS _POSIX_VDISABLE
414 416 .TE
415 417
416 418 .sp
417 419 .ne 2
418 420 .na
419 421 \fB\fIpathname\fR\fR
420 422 .ad
421 423 .RS 14n
422 424 A path name for which the variable specified by \fIpath_var\fR is to be
423 425 determined.
424 426 .RE
425 427
426 428 .sp
427 429 .ne 2
428 430 .na
429 431 \fB\fIsystem_var\fR\fR
430 432 .ad
431 433 .RS 14n
432 434 A name of a configuration variable whose value is available from
433 435 \fBconfstr\fR(3C) or \fBsysconf\fR(3C). All of the values in the following
434 436 table are supported:
435 437 .RE
436 438
437 439 .sp
438 440
439 441 .sp
440 442 .TS
441 443 l l
442 444 l l .
443 445 ARG_MAX BC_BASE_MAX
444 446 BC_DIM_MAX BC_SCALE_MAX
445 447 BC_STRING_MAX CHAR_BIT
446 448 CHARCLASS_NAME_MAX CHAR_MAX
447 449 CHAR_MIN CHILD_MAX
448 450 CLK_TCK COLL_WEIGHTS_MAX
449 451 CS_PATH EXPR_NEST_MAX
450 452 HOST_NAME_MAX INT_MAX
451 453 INT_MIN LFS64_CFLAGS
452 454 LFS64_LDFLAGS LFS64_LIBS
453 455 LFS64_LINTFLAGS LFS_CFLAGS
454 456 LFS_LDFLAGS LFS_LIBS
455 457 LFS_LINTFLAGS LINE_MAX
456 458 LONG_BIT LONG_MAX
457 459 LONG_MIN MB_LEN_MAX
458 460 NGROUPS_MAX NL_ARGMAX
459 461 NL_LANGMAX NL_MSGMAX
460 462 NL_NMAX NL_SETMAX
461 463 NL_TEXTMAX NPROCESSORS_CONF
462 464 NPROCESSORS_MAX NPROCESSORS_ONLN
463 465 NZERO OPEN_MAX
464 466 POSIX2_BC_BASE_MAX POSIX2_BC_DIM_MAX
465 467 POSIX2_BC_SCALE_MAX POSIX2_BC_STRING_MAX
466 468 POSIX2_C_BIND POSIX2_C_DEV
467 469 POSIX2_CHAR_TERM POSIX2_COLL_WEIGHTS_MAX
468 470 POSIX2_C_VERSION POSIX2_EXPR_NEST_MAX
469 471 POSIX2_FORT_DEV POSIX2_FORT_RUN
470 472 POSIX2_LINE_MAX POSIX2_LOCALEDEF
471 473 POSIX2_RE_DUP_MAX POSIX2_SW_DEV
472 474 POSIX2_SYMLINKS POSIX2_UPE
473 475 POSIX2_VERSION POSIX_ALLOC_SIZE_MIN
474 476 POSIX_REC_INCR_XFER_SIZE POSIX_REC_MAX_XFER_SIZE
475 477 POSIX_REC_MIN_XFER_SIZE POSIX_REC_XFER_ALIGN
476 478 POSIX_V6_ILP32_OFF32 POSIX_V6_ILP32_OFF32_CFLAGS
477 479 POSIX_V6_ILP32_OFF32_LDFLAGS POSIX_V6_ILP32_OFF32_LIBS
478 480 POSIX_V6_ILP32_OFFBIG POSIX_V6_ILP32_OFFBIG_CFLAGS
479 481 POSIX_V6_ILP32_OFFBIG_LDFLAGS POSIX_V6_ILP32_OFFBIG_LIBS
480 482 POSIX_V6_LP64_OFF64 POSIX_V6_LP64_OFF64_CFLAGS
481 483 POSIX_V6_LP64_OFF64_LDFLAGS POSIX_V6_LP64_OFF64_LIBS
482 484 POSIX_V6_LPBIG_OFFBIG POSIX_V6_LPBIG_OFFBIG_CFLAGS
483 485 POSIX_V6_LPBIG_OFFBIG_LDFLAGS POSIX_V6_LPBIG_OFFBIG_LIBS
484 486 POSIX_V6_WIDTH_RESTRICTED_ENVS SYMLINK_MAX
485 487 SYMLOOP_MAX _POSIX2_BC_BASE_MAX
486 488 _POSIX2_BC_DIM_MAX _POSIX2_BC_SCALE_MAX
487 489 _POSIX2_BC_STRING_MAX _POSIX2_CHARCLASS_NAME_MAX
488 490 _POSIX2_CHAR_TERM _POSIX2_COLL_WEIGHTS_MAX
489 491 _POSIX2_C_BIND _POSIX2_C_DEV
490 492 _POSIX2_C_VERSION _POSIX2_EXPR_NEST_MAX
491 493 _POSIX2_FORT_DEV _POSIX2_FORT_RUN
492 494 _POSIX2_LINE_MAX _POSIX2_LOCALEDEF
493 495 _POSIX2_PBS _POSIX2_PBS_ACCOUNTING
494 496 _POSIX2_PBS_CHECKPOINT _POSIX2_PBS_LOCATE
495 497 _POSIX2_PBS_MESSAGE _POSIX2_PBS_TRACK
496 498 _POSIX2_RE_DUP_MAX _POSIX2_SW_DEV
497 499 _POSIX2_UPE _POSIX2_VERSION
498 500 _POSIX_ADVISORY_INFO _POSIX_AIO_LISTIO_MAX
499 501 _POSIX_AIO_MAX _POSIX_ARG_MAX
500 502 _POSIX_ASYNC_IO _POSIX_BARRIERS
501 503 _POSIX_CHILD_MAX _POSIX_CLOCKRES_MIN
502 504 _POSIX_CLOCK_SELECTION _POSIX_CPUTIME
503 505 _POSIX_DELAYTIMER_MAX _POSIX_HOST_NAME_MAX
504 506 _POSIX_IPV6 _POSIX_JOB_CONTROL
505 507 _POSIX_LINK_MAX _POSIX_LOGIN_NAME_MAX
506 508 _POSIX_MAX_CANON _POSIX_MAX_INPUT
507 509 _POSIX_MONOTONIC_CLOCK _POSIX_MQ_OPEN_MAX
508 510 _POSIX_MQ_PRIO_MAX _POSIX_NAME_MAX
509 511 _POSIX_NGROUPS_MAX _POSIX_OPEN_MAX
510 512 _POSIX_PATH_MAX _POSIX_PIPE_BUF
511 513 _POSIX_PRIO_IO _POSIX_RAW_SOCKETS
512 514 _POSIX_READER_WRITER_LOCKS _POSIX_REGEXP
513 515 _POSIX_RE_DUP_MAX _POSIX_RTSIG_MAX
514 516 _POSIX_SAVED_IDS _POSIX_SEM_NSEMS_MAX
515 517 _POSIX_SEM_VALUE_MAX _POSIX_SHELL
516 518 _POSIX_SIGQUEUE_MAX _POSIX_SPAWN
517 519 _POSIX_SPIN_LOCKS _POSIX_SPORADIC_SERVER
518 520 _POSIX_SSIZE_MAX _POSIX_SS_REPL_MAX
519 521 _POSIX_STREAM_MAX _POSIX_SYMLINK_MAX
520 522 _POSIX_SYMLOOP_MAX _POSIX_SYNC_IO
521 523 _POSIX_THREAD_ATTR_STACKADDR _POSIX_THREAD_ATTR_STACKSIZE
522 524 _POSIX_THREAD_CPUTIME _POSIX_THREAD_DESTRUCTOR_ITERATIONS
523 525 _POSIX_THREAD_KEYS_MAX _POSIX_THREAD_PRIORITY_SCHEDULING
524 526 _POSIX_THREAD_PRIO_INHERIT _POSIX_THREAD_PRIO_PROTECT
525 527 _POSIX_THREAD_PROCESS_SHARED _POSIX_THREAD_SAFE_FUNCTIONS
526 528 _POSIX_THREAD_SPORADIC_SERVER _POSIX_THREAD_THREADS_MAX
527 529 _POSIX_TIMEOUTS _POSIX_TIMER_MAX
528 530 _POSIX_TRA_POSIX_TIMER_MAXCE _POSIX_TIMESTAMP_RESOLUTION
529 531 _POSIX_TRACE_EVENT_FILTER _POSIX_TRACE_EVENT_NAME_MAX
530 532 _POSIX_TRACE_INHERIT _POSIX_TRACE_LOG
531 533 _POSIX_TRACE_NAME_MAX _POSIX_TRACE_SYS_MAX
532 534 _POSIX_TRACE_USER_EVENT_MAX _POSIX_TTY_NAME_MAX
533 535 _POSIX_TYPED_MEMORY_OBJECTS _POSIX_TZNAME_MAX
534 536 _POSIX_VERSION _POSIX_V6_ILP32_OFF32
535 537 _POSIX_V6_ILP32_OFFBIG _POSIX_V6_LP64_OFF64
536 538 _POSIX_V6_LPBIG_OFFBIG _V6_ILP32_OFF32
537 539 _V6_ILP32_OFFBIG _V6_LP64_OFF64
538 540 _V6_LPBIG_OFFBIG RE_DUP_MAX
539 541 SCHAR_MAX SCHAR_MIN
540 542 SHRT_MAX SHRT_MIN
541 543 SSIZE_MAX STREAM_MAX
542 544 TMP_MAX TZNAME_MAX
543 545 UCHAR_MAX UINT_MAX
544 546 ULONG_MAX USHRT_MAX
545 547 WORD_BIT XBS5_ILP32_OFF32
546 548 XBS5_ILP32_OFF32_CFLAGS XBS5_ILP32_OFF32_LDFLAGS
547 549 XBS5_ILP32_OFF32_LIBS XBS5_ILP32_OFF32_LINTFLAGS
548 550 XBS5_ILP32_OFFBIG XBS5_ILP32_OFFBIG_CFLAGS
549 551 XBS5_ILP32_OFFBIG_LDFLAGS XBS5_ILP32_OFFBIG_LIBS
550 552 XBS5_ILP32_OFFBIG_LINTFLAGS XBS5_LP64_OFF64
551 553 XBS5_LP64_OFF64_CFLAGS XBS5_LP64_OFF64_LDFLAGS
552 554 XBS5_LP64_OFF64_LIBS XBS5_LP64_OFF64_LINTFLAGS
553 555 XBS5_LPBIG_OFFBIG XBS5_LPBIG_OFFBIG_CFLAGS
554 556 XBS5_LPBIG_OFFBIG_LDFLAGS XBS5_LPBIG_OFFBIG_LIBS
555 557 XBS5_LPBIG_OFFBIG_LINTFLAGS _XOPEN_CRYPT
556 558 _XOPEN_ENH_I18N _XOPEN_IOV_MAX
557 559 _XOPEN_LEGACY _XOPEN_NAME_MAX
558 560 _XOPEN_PATH_MAX _XOPEN_SHM
559 561 _XOPEN_STREAMS _XOPEN_VERSION
560 562 _XOPEN_XCU_VERSION _XOPEN_XPG2
561 563 _XOPEN_XPG3 _XOPEN_XPG4
562 564 .TE
563 565
564 566 .sp
565 567 .LP
566 568 The symbol \fBPATH\fR also is recognized, yielding the same value as the
567 569 \fBconfstr()\fR name value \fBCS_PATH\fR.
568 570 .SH USAGE
569 571 .sp
570 572 .LP
571 573 See \fBlargefile\fR(5) for the description of the behavior of
572 574 \fB/usr/bin/getconf\fR when encountering files greater than or equal to 2 Gbyte
573 575 ( 2^31 bytes).
574 576 .SH EXAMPLES
575 577 .LP
576 578 \fBExample 1 \fRWriting the Value of a Variable
577 579 .sp
578 580 .LP
579 581 This example illustrates the value of \fB{NGROUPS_MAX}:\fR
580 582
581 583 .sp
582 584 .in +2
583 585 .nf
584 586 example% \fBgetconf NGROUPS_MAX\fR
585 587 .fi
586 588 .in -2
587 589 .sp
588 590
589 591 .LP
590 592 \fBExample 2 \fRWriting the Value of a Variable for a Specific Directory
591 593 .sp
592 594 .LP
593 595 This example illustrates the value of \fBNAME_MAX\fR for a specific directory:
594 596
595 597 .sp
596 598 .in +2
597 599 .nf
598 600 example% \fBgetconf NAME_MAX /usr\fR
599 601 .fi
600 602 .in -2
601 603 .sp
602 604
603 605 .LP
604 606 \fBExample 3 \fRDealing with Unspecified Results
605 607 .sp
606 608 .LP
607 609 This example shows how to deal more carefully with results that might be
608 610 unspecified:
609 611
610 612 .sp
611 613 .in +2
612 614 .nf
613 615 \fBif value=$(getconf PATH_MAX /usr); then
614 616 if [ "$value" = "undefined" ]; then
615 617 echo PATH_MAX in /usr is infinite.
616 618 else
617 619 echo PATH_MAX in /usr is $value.
618 620 fi
619 621 else
620 622 echo Error in getconf.
621 623 fi\fR
622 624 .fi
623 625 .in -2
624 626
625 627 .sp
626 628 .LP
627 629 For example:
628 630
629 631 .sp
630 632 .in +2
631 633 .nf
632 634 \fBsysconf(_SC_POSIX_C_BIND);\fR
633 635 .fi
634 636 .in -2
635 637
636 638 .sp
637 639 .LP
638 640 and
639 641
640 642 .sp
641 643 .in +2
642 644 .nf
643 645 \fBsystem("getconf POSIX2_C_BIND");\fR
644 646 .fi
645 647 .in -2
646 648
647 649 .sp
648 650 .LP
649 651 in a C program could give different answers. The \fBsysconf\fR call supplies a
650 652 value that corresponds to the conditions when the program was either compiled
651 653 or executed, depending on the implementation. The \fBsystem\fR call to
652 654 \fBgetconf\fR always supplies a value corresponding to conditions when the
653 655 program is executed.
654 656
655 657 .SH ENVIRONMENT VARIABLES
656 658 .sp
657 659 .LP
658 660 See \fBenviron\fR(5) for descriptions of the following environment variables
659 661 that affect the execution of \fBgetconf\fR: \fBLANG\fR, \fBLC_ALL\fR,
660 662 \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR.
661 663 .sp
662 664 .LP
663 665 The following environment variable is supported by the \fBksh93\fR built-in
664 666 \fBgetconf\fR command:
665 667 .sp
666 668 .ne 2
667 669 .na
668 670 \fB\fB_AST_FEATURES\fR\fR
669 671 .ad
670 672 .RS 17n
671 673 Local writable values that are different from the default are stored in the
672 674 \fB_AST_FEATURES\fR environment variable. The \fB_AST_FEATURES\fR value is a
673 675 space-separated list of \fIname path value\fR 3-tuples, where \fIname\fR is the
674 676 system configuration name, \fIpath\fR is the corresponding path, \fB-\fR if no
675 677 path is applicable, and \fIvalue\fR is the system configuration value.
676 678 .RE
677 679
678 680 .SH EXIT STATUS
679 681 .sp
680 682 .LP
681 683 The following exit values are returned:
682 684 .sp
683 685 .ne 2
684 686 .na
685 687 \fB\fB0\fR\fR
686 688 .ad
687 689 .RS 6n
688 690 The specified variable is valid and information about its current state was
689 691 written successfully.
690 692 .RE
691 693
692 694 .sp
693 695 .ne 2
694 696 .na
695 697 \fB\fB>0\fR\fR
696 698 .ad
697 699 .RS 6n
698 700 An error occurred.
699 701 .RE
700 702
701 703 .SH ATTRIBUTES
702 704 .sp
703 705 .LP
704 706 See \fBattributes\fR(5) for descriptions of the following attributes:
705 707 .SS "/usr/bin/getconf, /usr/xpg4/bin/getconf, /usr/xpg6/bin/getconf"
706 708 .sp
707 709
708 710 .sp
709 711 .TS
710 712 box;
711 713 c | c
712 714 l | l .
713 715 ATTRIBUTE TYPE ATTRIBUTE VALUE
714 716 _
715 717 Interface Stability Committed
716 718 _
717 719 Standard See \fBstandards\fR(5).
718 720 .TE
719 721
720 722 .SS "ksh93"
721 723 .sp
722 724
723 725 .sp
724 726 .TS
725 727 box;
726 728 c | c
727 729 l | l .
728 730 ATTRIBUTE TYPE ATTRIBUTE VALUE
729 731 _
730 732 Interface Stability See below.
731 733 .TE
732 734
733 735 .sp
734 736 .LP
735 737 The \fBksh93\fR built-in binding to \fB/bin\fR and \fB/usr/bin\fR is Volatile.
736 738 The built-in command-line interface is Committed.
737 739 .SH SEE ALSO
738 740 .sp
739 741 .LP
740 742 \fBksh93\fR(1), \fBsh\fR(1), \fBpathconf\fR(2), \fBsysinfo\fR(2),
741 743 \fBconfstr\fR(3C), \fBsysconf\fR(3C), \fBattributes\fR(5), \fBenviron\fR(5),
742 744 \fBlargefile\fR(5), \fBstandards\fR(5)
↓ open down ↓ |
319 lines elided |
↑ open up ↑ |
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX