Print this page
452 /usr/@(|xpg4/|xpg6/)bin/getconf need to support NPROCESSORS_*
Reviewed by: Garrett D'Amore <garrett@damore.org>
| 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 "Sep 1, 2009"
13 +.TH GETCONF 1 "Jan 16, 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
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 411 LINK_MAX NAME_MAX _POSIX_CHOWN_RESTRICTED
412 412 MAX_CANON PATH_MAX _POSIX_NO_TRUNC
413 413 MAX_INPUT PIPE_BUF _POSIX_VDISABLE
414 414 .TE
415 415
416 416 .sp
417 417 .ne 2
418 418 .na
419 419 \fB\fIpathname\fR\fR
420 420 .ad
421 421 .RS 14n
422 422 A path name for which the variable specified by \fIpath_var\fR is to be
423 423 determined.
424 424 .RE
425 425
426 426 .sp
427 427 .ne 2
428 428 .na
429 429 \fB\fIsystem_var\fR\fR
430 430 .ad
431 431 .RS 14n
432 432 A name of a configuration variable whose value is available from
433 433 \fBconfstr\fR(3C) or \fBsysconf\fR(3C). All of the values in the following
434 434 table are supported:
435 435 .RE
436 436
437 437 .sp
438 438
439 439 .sp
440 440 .TS
441 441 l l
442 442 l l .
443 443 ARG_MAX BC_BASE_MAX
444 444 BC_DIM_MAX BC_SCALE_MAX
445 445 BC_STRING_MAX CHAR_BIT
446 446 CHARCLASS_NAME_MAX CHAR_MAX
447 447 CHAR_MIN CHILD_MAX
448 448 CLK_TCK COLL_WEIGHTS_MAX
449 449 CS_PATH EXPR_NEST_MAX
450 450 HOST_NAME_MAX INT_MAX
|
↓ open down ↓ |
427 lines elided |
↑ open up ↑ |
451 451 INT_MIN LFS64_CFLAGS
452 452 LFS64_LDFLAGS LFS64_LIBS
453 453 LFS64_LINTFLAGS LFS_CFLAGS
454 454 LFS_LDFLAGS LFS_LIBS
455 455 LFS_LINTFLAGS LINE_MAX
456 456 LONG_BIT LONG_MAX
457 457 LONG_MIN MB_LEN_MAX
458 458 NGROUPS_MAX NL_ARGMAX
459 459 NL_LANGMAX NL_MSGMAX
460 460 NL_NMAX NL_SETMAX
461 -NL_TEXTMAX NZERO
462 -OPEN_MAX POSIX2_BC_BASE_MAX
463 -POSIX2_BC_DIM_MAX POSIX2_BC_SCALE_MAX
464 -POSIX2_BC_STRING_MAX POSIX2_C_BIND
465 -POSIX2_C_DEV POSIX2_CHAR_TERM
466 -POSIX2_COLL_WEIGHTS_MAX POSIX2_C_VERSION
467 -POSIX2_EXPR_NEST_MAX POSIX2_FORT_DEV
468 -POSIX2_FORT_RUN POSIX2_LINE_MAX
469 -POSIX2_LOCALEDEF POSIX2_RE_DUP_MAX
470 -POSIX2_SW_DEV POSIX2_SYMLINKS
471 -POSIX2_UPE POSIX2_VERSION
472 -POSIX_ALLOC_SIZE_MIN POSIX_REC_INCR_XFER_SIZE
473 -POSIX_REC_MAX_XFER_SIZE POSIX_REC_MIN_XFER_SIZE
474 -POSIX_REC_XFER_ALIGN POSIX_V6_ILP32_OFF32
475 -POSIX_V6_ILP32_OFF32_CFLAGS POSIX_V6_ILP32_OFF32_LDFLAGS
476 -POSIX_V6_ILP32_OFF32_LIBS POSIX_V6_ILP32_OFFBIG
477 -POSIX_V6_ILP32_OFFBIG_CFLAGS POSIX_V6_ILP32_OFFBIG_LDFLAGS
478 -POSIX_V6_ILP32_OFFBIG_LIBS POSIX_V6_LP64_OFF64
479 -POSIX_V6_LP64_OFF64_CFLAGS POSIX_V6_LP64_OFF64_LDFLAGS
480 -POSIX_V6_LP64_OFF64_LIBS POSIX_V6_LPBIG_OFFBIG
481 -POSIX_V6_LPBIG_OFFBIG_CFLAGS POSIX_V6_LPBIG_OFFBIG_LDFLAGS
482 -POSIX_V6_LPBIG_OFFBIG_LIBS POSIX_V6_WIDTH_RESTRICTED_ENVS
483 -SYMLINK_MAX SYMLOOP_MAX
484 -_POSIX2_BC_BASE_MAX _POSIX2_BC_DIM_MAX
485 -_POSIX2_BC_SCALE_MAX _POSIX2_BC_STRING_MAX
486 -_POSIX2_CHARCLASS_NAME_MAX _POSIX2_CHAR_TERM
487 -_POSIX2_COLL_WEIGHTS_MAX _POSIX2_C_BIND
488 -_POSIX2_C_DEV _POSIX2_C_VERSION
489 -_POSIX2_EXPR_NEST_MAX _POSIX2_FORT_DEV
490 -_POSIX2_FORT_RUN _POSIX2_LINE_MAX
491 -_POSIX2_LOCALEDEF _POSIX2_PBS
492 -_POSIX2_PBS_ACCOUNTING _POSIX2_PBS_CHECKPOINT
493 -_POSIX2_PBS_LOCATE _POSIX2_PBS_MESSAGE
494 -_POSIX2_PBS_TRACK _POSIX2_RE_DUP_MAX
495 -_POSIX2_SW_DEV _POSIX2_UPE
496 -_POSIX2_VERSION _POSIX_ADVISORY_INFO
497 -_POSIX_AIO_LISTIO_MAX _POSIX_AIO_MAX
498 -_POSIX_ARG_MAX _POSIX_ASYNC_IO
499 -_POSIX_BARRIERS _POSIX_CHILD_MAX
500 -_POSIX_CLOCKRES_MIN _POSIX_CLOCK_SELECTION
501 -_POSIX_CPUTIME _POSIX_DELAYTIMER_MAX
502 -_POSIX_HOST_NAME_MAX _POSIX_IPV6
503 -_POSIX_JOB_CONTROL _POSIX_LINK_MAX
504 -_POSIX_LOGIN_NAME_MAX _POSIX_MAX_CANON
505 -_POSIX_MAX_INPUT _POSIX_MONOTONIC_CLOCK
506 -_POSIX_MQ_OPEN_MAX _POSIX_MQ_PRIO_MAX
507 -_POSIX_NAME_MAX _POSIX_NGROUPS_MAX
508 -_POSIX_OPEN_MAX _POSIX_PATH_MAX
509 -_POSIX_PIPE_BUF _POSIX_PRIO_IO
510 -_POSIX_RAW_SOCKETS _POSIX_READER_WRITER_LOCKS
511 -_POSIX_REGEXP _POSIX_RE_DUP_MAX
512 -_POSIX_RTSIG_MAX _POSIX_SAVED_IDS
513 -_POSIX_SEM_NSEMS_MAX _POSIX_SEM_VALUE_MAX
514 -_POSIX_SHELL _POSIX_SIGQUEUE_MAX
515 -_POSIX_SPAWN _POSIX_SPIN_LOCKS
516 -_POSIX_SPORADIC_SERVER _POSIX_SSIZE_MAX
517 -_POSIX_SS_REPL_MAX _POSIX_STREAM_MAX
518 -_POSIX_SYMLINK_MAX _POSIX_SYMLOOP_MAX
519 -_POSIX_SYNC_IO _POSIX_THREAD_ATTR_STACKADDR
520 -_POSIX_THREAD_ATTR_STACKSIZE _POSIX_THREAD_CPUTIME
521 -_POSIX_THREAD_DESTRUCTOR_ITERATIONS _POSIX_THREAD_KEYS_MAX
522 -_POSIX_THREAD_PRIORITY_SCHEDULING _POSIX_THREAD_PRIO_INHERIT
523 -_POSIX_THREAD_PRIO_PROTECT _POSIX_THREAD_PROCESS_SHARED
524 -_POSIX_THREAD_SAFE_FUNCTIONS _POSIX_THREAD_SPORADIC_SERVER
525 -_POSIX_THREAD_THREADS_MAX _POSIX_TIMEOUTS
526 -_POSIX_TIMER_MAX _POSIX_TRA_POSIX_TIMER_MAXCE
527 -_POSIX_TIMESTAMP_RESOLUTION
461 +NL_TEXTMAX NPROCESSORS_CONF
462 +NPROCESSORS_MAX NPROCESSORS_ONLN
463 +NZERO OPEN_MAX
464 +POSIX2_BC_BASE_MAX POSIX2_BC_DIM_MAX
465 +POSIX2_BC_SCALE_MAX POSIX2_BC_STRING_MAX
466 +POSIX2_C_BIND POSIX2_C_DEV
467 +POSIX2_CHAR_TERM POSIX2_COLL_WEIGHTS_MAX
468 +POSIX2_C_VERSION POSIX2_EXPR_NEST_MAX
469 +POSIX2_FORT_DEV POSIX2_FORT_RUN
470 +POSIX2_LINE_MAX POSIX2_LOCALEDEF
471 +POSIX2_RE_DUP_MAX POSIX2_SW_DEV
472 +POSIX2_SYMLINKS POSIX2_UPE
473 +POSIX2_VERSION POSIX_ALLOC_SIZE_MIN
474 +POSIX_REC_INCR_XFER_SIZE POSIX_REC_MAX_XFER_SIZE
475 +POSIX_REC_MIN_XFER_SIZE POSIX_REC_XFER_ALIGN
476 +POSIX_V6_ILP32_OFF32 POSIX_V6_ILP32_OFF32_CFLAGS
477 +POSIX_V6_ILP32_OFF32_LDFLAGS POSIX_V6_ILP32_OFF32_LIBS
478 +POSIX_V6_ILP32_OFFBIG POSIX_V6_ILP32_OFFBIG_CFLAGS
479 +POSIX_V6_ILP32_OFFBIG_LDFLAGS POSIX_V6_ILP32_OFFBIG_LIBS
480 +POSIX_V6_LP64_OFF64 POSIX_V6_LP64_OFF64_CFLAGS
481 +POSIX_V6_LP64_OFF64_LDFLAGS POSIX_V6_LP64_OFF64_LIBS
482 +POSIX_V6_LPBIG_OFFBIG POSIX_V6_LPBIG_OFFBIG_CFLAGS
483 +POSIX_V6_LPBIG_OFFBIG_LDFLAGS POSIX_V6_LPBIG_OFFBIG_LIBS
484 +POSIX_V6_WIDTH_RESTRICTED_ENVS SYMLINK_MAX
485 +SYMLOOP_MAX _POSIX2_BC_BASE_MAX
486 +_POSIX2_BC_DIM_MAX _POSIX2_BC_SCALE_MAX
487 +_POSIX2_BC_STRING_MAX _POSIX2_CHARCLASS_NAME_MAX
488 +_POSIX2_CHAR_TERM _POSIX2_COLL_WEIGHTS_MAX
489 +_POSIX2_C_BIND _POSIX2_C_DEV
490 +_POSIX2_C_VERSION _POSIX2_EXPR_NEST_MAX
491 +_POSIX2_FORT_DEV _POSIX2_FORT_RUN
492 +_POSIX2_LINE_MAX _POSIX2_LOCALEDEF
493 +_POSIX2_PBS _POSIX2_PBS_ACCOUNTING
494 +_POSIX2_PBS_CHECKPOINT _POSIX2_PBS_LOCATE
495 +_POSIX2_PBS_MESSAGE _POSIX2_PBS_TRACK
496 +_POSIX2_RE_DUP_MAX _POSIX2_SW_DEV
497 +_POSIX2_UPE _POSIX2_VERSION
498 +_POSIX_ADVISORY_INFO _POSIX_AIO_LISTIO_MAX
499 +_POSIX_AIO_MAX _POSIX_ARG_MAX
500 +_POSIX_ASYNC_IO _POSIX_BARRIERS
501 +_POSIX_CHILD_MAX _POSIX_CLOCKRES_MIN
502 +_POSIX_CLOCK_SELECTION _POSIX_CPUTIME
503 +_POSIX_DELAYTIMER_MAX _POSIX_HOST_NAME_MAX
504 +_POSIX_IPV6 _POSIX_JOB_CONTROL
505 +_POSIX_LINK_MAX _POSIX_LOGIN_NAME_MAX
506 +_POSIX_MAX_CANON _POSIX_MAX_INPUT
507 +_POSIX_MONOTONIC_CLOCK _POSIX_MQ_OPEN_MAX
508 +_POSIX_MQ_PRIO_MAX _POSIX_NAME_MAX
509 +_POSIX_NGROUPS_MAX _POSIX_OPEN_MAX
510 +_POSIX_PATH_MAX _POSIX_PIPE_BUF
511 +_POSIX_PRIO_IO _POSIX_RAW_SOCKETS
512 +_POSIX_READER_WRITER_LOCKS _POSIX_REGEXP
513 +_POSIX_RE_DUP_MAX _POSIX_RTSIG_MAX
514 +_POSIX_SAVED_IDS _POSIX_SEM_NSEMS_MAX
515 +_POSIX_SEM_VALUE_MAX _POSIX_SHELL
516 +_POSIX_SIGQUEUE_MAX _POSIX_SPAWN
517 +_POSIX_SPIN_LOCKS _POSIX_SPORADIC_SERVER
518 +_POSIX_SSIZE_MAX _POSIX_SS_REPL_MAX
519 +_POSIX_STREAM_MAX _POSIX_SYMLINK_MAX
520 +_POSIX_SYMLOOP_MAX _POSIX_SYNC_IO
521 +_POSIX_THREAD_ATTR_STACKADDR _POSIX_THREAD_ATTR_STACKSIZE
522 +_POSIX_THREAD_CPUTIME _POSIX_THREAD_DESTRUCTOR_ITERATIONS
523 +_POSIX_THREAD_KEYS_MAX _POSIX_THREAD_PRIORITY_SCHEDULING
524 +_POSIX_THREAD_PRIO_INHERIT _POSIX_THREAD_PRIO_PROTECT
525 +_POSIX_THREAD_PROCESS_SHARED _POSIX_THREAD_SAFE_FUNCTIONS
526 +_POSIX_THREAD_SPORADIC_SERVER _POSIX_THREAD_THREADS_MAX
527 +_POSIX_TIMEOUTS _POSIX_TIMER_MAX
528 +_POSIX_TRA_POSIX_TIMER_MAXCE _POSIX_TIMESTAMP_RESOLUTION
528 529 _POSIX_TRACE_EVENT_FILTER _POSIX_TRACE_EVENT_NAME_MAX
529 530 _POSIX_TRACE_INHERIT _POSIX_TRACE_LOG
530 531 _POSIX_TRACE_NAME_MAX _POSIX_TRACE_SYS_MAX
531 532 _POSIX_TRACE_USER_EVENT_MAX _POSIX_TTY_NAME_MAX
532 533 _POSIX_TYPED_MEMORY_OBJECTS _POSIX_TZNAME_MAX
533 534 _POSIX_VERSION _POSIX_V6_ILP32_OFF32
534 535 _POSIX_V6_ILP32_OFFBIG _POSIX_V6_LP64_OFF64
535 536 _POSIX_V6_LPBIG_OFFBIG _V6_ILP32_OFF32
536 537 _V6_ILP32_OFFBIG _V6_LP64_OFF64
537 538 _V6_LPBIG_OFFBIG RE_DUP_MAX
538 539 SCHAR_MAX SCHAR_MIN
539 540 SHRT_MAX SHRT_MIN
540 541 SSIZE_MAX STREAM_MAX
541 542 TMP_MAX TZNAME_MAX
542 543 UCHAR_MAX UINT_MAX
543 544 ULONG_MAX USHRT_MAX
544 545 WORD_BIT XBS5_ILP32_OFF32
545 546 XBS5_ILP32_OFF32_CFLAGS XBS5_ILP32_OFF32_LDFLAGS
546 547 XBS5_ILP32_OFF32_LIBS XBS5_ILP32_OFF32_LINTFLAGS
547 548 XBS5_ILP32_OFFBIG XBS5_ILP32_OFFBIG_CFLAGS
548 549 XBS5_ILP32_OFFBIG_LDFLAGS XBS5_ILP32_OFFBIG_LIBS
549 550 XBS5_ILP32_OFFBIG_LINTFLAGS XBS5_LP64_OFF64
550 551 XBS5_LP64_OFF64_CFLAGS XBS5_LP64_OFF64_LDFLAGS
551 552 XBS5_LP64_OFF64_LIBS XBS5_LP64_OFF64_LINTFLAGS
552 553 XBS5_LPBIG_OFFBIG XBS5_LPBIG_OFFBIG_CFLAGS
553 554 XBS5_LPBIG_OFFBIG_LDFLAGS XBS5_LPBIG_OFFBIG_LIBS
554 555 XBS5_LPBIG_OFFBIG_LINTFLAGS _XOPEN_CRYPT
555 556 _XOPEN_ENH_I18N _XOPEN_IOV_MAX
556 557 _XOPEN_LEGACY _XOPEN_NAME_MAX
557 558 _XOPEN_PATH_MAX _XOPEN_SHM
558 559 _XOPEN_STREAMS _XOPEN_VERSION
559 560 _XOPEN_XCU_VERSION _XOPEN_XPG2
560 561 _XOPEN_XPG3 _XOPEN_XPG4
561 562 .TE
562 563
563 564 .sp
564 565 .LP
565 566 The symbol \fBPATH\fR also is recognized, yielding the same value as the
566 567 \fBconfstr()\fR name value \fBCS_PATH\fR.
567 568 .SH USAGE
568 569 .sp
569 570 .LP
570 571 See \fBlargefile\fR(5) for the description of the behavior of
571 572 \fB/usr/bin/getconf\fR when encountering files greater than or equal to 2 Gbyte
572 573 ( 2^31 bytes).
573 574 .SH EXAMPLES
574 575 .LP
575 576 \fBExample 1 \fRWriting the Value of a Variable
576 577 .sp
577 578 .LP
578 579 This example illustrates the value of \fB{NGROUPS_MAX}:\fR
579 580
580 581 .sp
581 582 .in +2
582 583 .nf
583 584 example% \fBgetconf NGROUPS_MAX\fR
584 585 .fi
585 586 .in -2
586 587 .sp
587 588
588 589 .LP
589 590 \fBExample 2 \fRWriting the Value of a Variable for a Specific Directory
590 591 .sp
591 592 .LP
592 593 This example illustrates the value of \fBNAME_MAX\fR for a specific directory:
593 594
594 595 .sp
595 596 .in +2
596 597 .nf
597 598 example% \fBgetconf NAME_MAX /usr\fR
598 599 .fi
599 600 .in -2
600 601 .sp
601 602
602 603 .LP
603 604 \fBExample 3 \fRDealing with Unspecified Results
604 605 .sp
605 606 .LP
606 607 This example shows how to deal more carefully with results that might be
607 608 unspecified:
608 609
609 610 .sp
610 611 .in +2
611 612 .nf
612 613 \fBif value=$(getconf PATH_MAX /usr); then
613 614 if [ "$value" = "undefined" ]; then
614 615 echo PATH_MAX in /usr is infinite.
615 616 else
616 617 echo PATH_MAX in /usr is $value.
617 618 fi
618 619 else
619 620 echo Error in getconf.
620 621 fi\fR
621 622 .fi
622 623 .in -2
623 624
624 625 .sp
625 626 .LP
626 627 For example:
627 628
628 629 .sp
629 630 .in +2
630 631 .nf
631 632 \fBsysconf(_SC_POSIX_C_BIND);\fR
632 633 .fi
633 634 .in -2
634 635
635 636 .sp
636 637 .LP
637 638 and
638 639
639 640 .sp
640 641 .in +2
641 642 .nf
642 643 \fBsystem("getconf POSIX2_C_BIND");\fR
643 644 .fi
644 645 .in -2
645 646
646 647 .sp
647 648 .LP
648 649 in a C program could give different answers. The \fBsysconf\fR call supplies a
649 650 value that corresponds to the conditions when the program was either compiled
650 651 or executed, depending on the implementation. The \fBsystem\fR call to
651 652 \fBgetconf\fR always supplies a value corresponding to conditions when the
652 653 program is executed.
653 654
654 655 .SH ENVIRONMENT VARIABLES
655 656 .sp
656 657 .LP
657 658 See \fBenviron\fR(5) for descriptions of the following environment variables
658 659 that affect the execution of \fBgetconf\fR: \fBLANG\fR, \fBLC_ALL\fR,
659 660 \fBLC_CTYPE\fR, \fBLC_MESSAGES\fR, and \fBNLSPATH\fR.
660 661 .sp
661 662 .LP
662 663 The following environment variable is supported by the \fBksh93\fR built-in
663 664 \fBgetconf\fR command:
664 665 .sp
665 666 .ne 2
666 667 .na
667 668 \fB\fB_AST_FEATURES\fR\fR
668 669 .ad
669 670 .RS 17n
670 671 Local writable values that are different from the default are stored in the
671 672 \fB_AST_FEATURES\fR environment variable. The \fB_AST_FEATURES\fR value is a
672 673 space-separated list of \fIname path value\fR 3-tuples, where \fIname\fR is the
673 674 system configuration name, \fIpath\fR is the corresponding path, \fB-\fR if no
674 675 path is applicable, and \fIvalue\fR is the system configuration value.
675 676 .RE
676 677
677 678 .SH EXIT STATUS
678 679 .sp
679 680 .LP
680 681 The following exit values are returned:
681 682 .sp
682 683 .ne 2
683 684 .na
684 685 \fB\fB0\fR\fR
685 686 .ad
686 687 .RS 6n
687 688 The specified variable is valid and information about its current state was
688 689 written successfully.
689 690 .RE
690 691
691 692 .sp
692 693 .ne 2
693 694 .na
694 695 \fB\fB>0\fR\fR
695 696 .ad
696 697 .RS 6n
697 698 An error occurred.
698 699 .RE
699 700
700 701 .SH ATTRIBUTES
701 702 .sp
702 703 .LP
703 704 See \fBattributes\fR(5) for descriptions of the following attributes:
704 705 .SS "/usr/bin/getconf, /usr/xpg4/bin/getconf, /usr/xpg6/bin/getconf"
705 706 .sp
706 707
707 708 .sp
708 709 .TS
709 710 box;
710 711 c | c
711 712 l | l .
712 713 ATTRIBUTE TYPE ATTRIBUTE VALUE
713 714 _
714 715 Interface Stability Committed
715 716 _
716 717 Standard See \fBstandards\fR(5).
717 718 .TE
718 719
719 720 .SS "ksh93"
720 721 .sp
721 722
722 723 .sp
723 724 .TS
724 725 box;
725 726 c | c
726 727 l | l .
727 728 ATTRIBUTE TYPE ATTRIBUTE VALUE
728 729 _
729 730 Interface Stability See below.
730 731 .TE
731 732
732 733 .sp
733 734 .LP
734 735 The \fBksh93\fR built-in binding to \fB/bin\fR and \fB/usr/bin\fR is Volatile.
735 736 The built-in command-line interface is Committed.
736 737 .SH SEE ALSO
737 738 .sp
738 739 .LP
739 740 \fBksh93\fR(1), \fBsh\fR(1), \fBpathconf\fR(2), \fBsysinfo\fR(2),
740 741 \fBconfstr\fR(3C), \fBsysconf\fR(3C), \fBattributes\fR(5), \fBenviron\fR(5),
741 742 \fBlargefile\fR(5), \fBstandards\fR(5)
|
↓ open down ↓ |
204 lines elided |
↑ open up ↑ |
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX