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