usr/src/man/man3c/confstr.3c

   1 '\" te
   2 .\" Copyright (c) 1992, X/Open Company Limited. All Rights Reserved.  Portions Copyright (c) 2003, Sun Microsystems, Inc.  All Rights Reserved.
   3 .\" 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
   4 .\" http://www.opengroup.org/bookstore/.
   5 .\" 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 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 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.
   6 .\"  This notice shall appear on any product containing this material.
   7 .\" 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.
   8 .\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing.  See the License for the specific language governing permissions and limitations under the License.
   9 .\" 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 the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner]
  10 .TH CONFSTR 3C "Dec 15, 2003"
  11 .SH NAME
  12 confstr \- get configurable variables
  13 .SH SYNOPSIS
  14 .LP
  15 .nf
  16 #include <unistd.h>
  17
  18 \fBsize_t\fR \fBconfstr\fR(\fBint\fR \fIname\fR, \fBchar *\fR\fIbuf\fR, \fBsize_t\fR \fIlen\fR);
  19 .fi
  20
  21 .SH DESCRIPTION
  22 .sp
  23 .LP
  24 The \fBconfstr()\fR function provides a method for applications to get
  25 configuration-defined string values.  Its use and purpose are similar to the
  26 \fBsysconf\fR(3C) function, but it is used where string values rather than
  27 numeric values are returned.
  28 .sp
  29 .LP
  30 The \fIname\fR argument represents the system variable to be queried.
  31 .sp
  32 .LP
  33 If \fIlen\fR is not \fB0\fR, and if \fIname\fR has a configuration-defined
  34 value, \fBconfstr()\fR copies that value into the  \fIlen\fR-byte buffer
  35 pointed to by \fIbuf\fR. If the string to be returned is longer than \fIlen\fR
  36 bytes, including the terminating null, then \fBconfstr()\fR truncates the
  37 string to  \fIlen\fR\(mi1 bytes and null-terminates the result. The application
  38 can detect that the string was truncated by comparing the value returned by
  39 \fBconfstr()\fR with \fIlen\fR.
  40 .sp
  41 .LP
  42 If \fIlen\fR is \fB0\fR, \fBconfstr()\fR still returns the integer value as
  43 defined below, but does not return the string.
  44 .sp
  45 .LP
  46 The \fBconfstr()\fR function supports the following values for \fIname\fR,
  47 defined in \fB<unistd.h>\fR, for both SPARC and x86:
  48 .sp
  49 .ne 2
  50 .na
  51 \fB\fB_CS_LFS64_CFLAGS\fR\fR
  52 .ad
  53 .sp .6
  54 .RS 4n
  55 If \fB_LFS64_LARGEFILE\fR is defined in \fB<unistd.h>\fR, this value is the set
  56 of initial options to be given to the \fBcc\fR and \fBc89\fR utilities to build
  57 an application using the Large File Summit transitional compilation environment
  58 (see \fBlfcompile64\fR(5)).
  59 .RE
  60
  61 .sp
  62 .ne 2
  63 .na
  64 \fB\fB_CS_LFS64_LDFLAGS\fR\fR
  65 .ad
  66 .sp .6
  67 .RS 4n
  68 If \fB_LFS64_LARGEFILE\fR is defined in \fB<unistd.h>\fR, this value is the set
  69 of final options to be given to the \fBcc\fR and \fBc89\fR utilities to build
  70 an application using the Large File Summit transitional compilation environment
  71 (see \fBlfcompile64\fR(5)).
  72 .RE
  73
  74 .sp
  75 .ne 2
  76 .na
  77 \fB\fB_CS_LFS64_LIBS\fR\fR
  78 .ad
  79 .sp .6
  80 .RS 4n
  81 If \fB_LFS64_LARGEFILE\fR is defined in \fB<unistd.h>\fR, this value is the set
  82 of libraries to be given to the \fBcc\fR and \fBc89\fR utilities to build an
  83 application using the Large File Summit transitional compilation environment
  84 (see \fBlfcompile64\fR(5)).
  85 .RE
  86
  87 .sp
  88 .ne 2
  89 .na
  90 \fB\fB_CS_LFS64_LINTFLAGS\fR\fR
  91 .ad
  92 .sp .6
  93 .RS 4n
  94 If \fB_LFS64_LARGEFILE\fR is defined in \fB<unistd.h>\fR, this value is the set
  95 of options to be given to the \fBlint\fR utility to check application source
  96 using the Large File Summit transitional compilation environment (see
  97 \fBlfcompile64\fR(5)).
  98 .RE
  99
 100 .sp
 101 .ne 2
 102 .na
 103 \fB\fB_CS_LFS_CFLAGS\fR\fR
 104 .ad
 105 .sp .6
 106 .RS 4n
 107 If \fB_LFS_LARGEFILE\fR is defined in \fB<unistd.h>\fR, this value is the set
 108 of initial options to be given to the \fBcc\fR and \fBc89\fR utilities to build
 109 an application using the Large File Summit large file compilation environment
 110 for 32-bit applications (see \fBlfcompile\fR(5)).
 111 .RE
 112
 113 .sp
 114 .ne 2
 115 .na
 116 \fB\fB_CS_LFS_LDFLAGS\fR\fR
 117 .ad
 118 .sp .6
 119 .RS 4n
 120 If \fB_LFS_LARGEFILE\fR is defined in \fB<unistd.h>\fR, this value is the set
 121 of final options to be given to the \fBcc\fR and \fBc89\fR utilities to build
 122 an application using the Large File Summit large file compilation environment
 123 for 32-bit applications (see \fBlfcompile\fR(5)).
 124 .RE
 125
 126 .sp
 127 .ne 2
 128 .na
 129 \fB\fB_CS_LFS_LIBS\fR\fR
 130 .ad
 131 .sp .6
 132 .RS 4n
 133 If \fB_LFS_LARGEFILE\fR is defined in \fB<unistd.h>\fR, this value is the set
 134 of libraries to be given to the \fBcc\fR and \fBc89\fR utilities to build an
 135 application using the Large File Summit large file compilation environment for
 136 32-bit applications (see \fBlfcompile\fR(5)).
 137 .RE
 138
 139 .sp
 140 .ne 2
 141 .na
 142 \fB\fB_CS_LFS_LINTFLAGS\fR\fR
 143 .ad
 144 .sp .6
 145 .RS 4n
 146 If \fB_LFS_LARGEFILE\fR is defined in \fB<unistd.h>\fR, this value is the set
 147 of options to be given to the \fBlint\fR utility to check application source
 148 using the Large File Summit large file compilation environment for 32-bit
 149 applications (see \fBlfcompile\fR(5)).
 150 .RE
 151
 152 .sp
 153 .ne 2
 154 .na
 155 \fB\fB_CS_PATH\fR\fR
 156 .ad
 157 .sp .6
 158 .RS 4n
 159 If the ISO POSIX.2 standard is supported, this is the value for the \fBPATH\fR
 160 environment variable that finds all standard utilities.  Otherwise the meaning
 161 of this value is unspecified.
 162 .RE
 163
 164 .sp
 165 .ne 2
 166 .na
 167 \fB\fB_CS_POSIX_V6_ILP32_OFF32_CFLAGS\fR\fR
 168 .ad
 169 .sp .6
 170 .RS 4n
 171 If \fBsysconf\fR(\fB_SC_V6_ILP32_OFF32\fR) returns -1, the meaning of this
 172 value is unspecified.  Otherwise, this value is the set of initial options to
 173 be given to the \fBc99\fR utility to build an application using a programming
 174 model with 32-bit \fBint\fR, \fBlong\fR, \fBpointer\fR, and \fBoff_t\fR types.
 175 .RE
 176
 177 .sp
 178 .ne 2
 179 .na
 180 \fB\fB_CS_POSIX_V6_ILP32_OFF32_LDFLAGS\fR\fR
 181 .ad
 182 .sp .6
 183 .RS 4n
 184 If \fBsysconf\fR(\fB_SC_V6_ILP32_OFF32\fR) returns -1, the meaning of this
 185 value is unspecified. Otherwise, this value is the set of final options to be
 186 given to the \fBc99\fR utility to build an application using a programming
 187 model with 32-bit \fBint\fR, \fBlong\fR, \fBpointer\fR, and \fBoff_t\fR types.
 188 .RE
 189
 190 .sp
 191 .ne 2
 192 .na
 193 \fB\fB_CS_POSIX_V6_ILP32_OFF32_LIBS\fR\fR
 194 .ad
 195 .sp .6
 196 .RS 4n
 197 If \fBsysconf\fR(\fB_SC_V6_ILP32_OFF32\fR) returns -1, the meaning of this
 198 value is unspecified. Otherwise, this value is the set of libraries to be given
 199 to the \fBc99\fR utility to build an application using a programming model with
 200 32-bit \fBint\fR, \fBlong\fR, \fBpointer\fR, and \fBoff_t\fR types.
 201 .RE
 202
 203 .sp
 204 .ne 2
 205 .na
 206 \fB\fB_CS_POSIX_V6_ILP32_OFFBIG_CFLAGS\fR\fR
 207 .ad
 208 .sp .6
 209 .RS 4n
 210  If \fBsysconf\fR(\fB_SC_V6_ILP32_OFFBIG\fR) returns -1, the meaning of this
 211 value is unspecified. Otherwise, this value is the set of initial options to be
 212 given to the \fBc99\fR utility to build an application using a programming
 213 model with 32-bit \fBint\fR, \fBlong\fR, and \fBpointer\fR types, and an
 214 \fBoff_t\fR type using at least 64 bits.
 215 .RE
 216
 217 .sp
 218 .ne 2
 219 .na
 220 \fB\fB_CS_POSIX_V6_ILP32_OFFBIG_LDFLAGS\fR\fR
 221 .ad
 222 .sp .6
 223 .RS 4n
 224 If \fBsysconf\fR(\fB_SC_V6_ILP32_OFFBIG\fR) returns -1, the meaning of this
 225 value is unspecified. Otherwise, this value is the set of final options to be
 226 given to the \fBc99\fR utility to build an application using a programming
 227 model with 32-bit \fBint\fR, \fBlong\fR, and \fBpointer\fR types, and an
 228 \fBoff_t\fR type using at least 64 bits.
 229 .RE
 230
 231 .sp
 232 .ne 2
 233 .na
 234 \fB\fB_CS_POSIX_V6_ILP32_OFFBIG_LIBS\fR\fR
 235 .ad
 236 .sp .6
 237 .RS 4n
 238 If \fBsysconf\fR(\fB_SC_V6_ILP32_OFFBIG\fR) returns -1, the meaning of this
 239 value is unspecified. Otherwise, this value is the set of libraries to be given
 240 to the \fBc99\fR utility to build an application using a programming model with
 241 32-bit \fBint\fR, \fBlong\fR, and \fBpointer\fR types, and an \fBoff_t\fR type
 242 using at least 64 bits.
 243 .RE
 244
 245 .sp
 246 .ne 2
 247 .na
 248 \fB\fB_CS_POSIX_V6_LP64_OFF64_CFLAGS\fR\fR
 249 .ad
 250 .sp .6
 251 .RS 4n
 252 If \fBsysconf\fR(\fB_SC_V6_LP64_OFF64\fR) returns -1, the meaning of this value
 253 is unspecified. Otherwise, this value is the set of initial options to be given
 254 to the \fBc99\fR utility to build an application using a programming model with
 255 64-bit \fBint\fR, \fBlong\fR, \fBpointer\fR, and \fBoff_t\fR types.
 256 .RE
 257
 258 .sp
 259 .ne 2
 260 .na
 261 \fB\fB_CS_POSIX_V6_LP64_OFF64_LDFLAGS\fR\fR
 262 .ad
 263 .sp .6
 264 .RS 4n
 265 If \fBsysconf\fR(\fB_SC_V6_LP64_OFF64\fR) returns -1, the meaning of this value
 266 is unspecified. Otherwise, this value is the set of final options to be given
 267 to the \fBc99\fR utility to build an application using a programming model with
 268 64-bit \fBint\fR, \fBlong\fR, \fBpointer\fR, and \fBoff_t\fR types.
 269 .RE
 270
 271 .sp
 272 .ne 2
 273 .na
 274 \fB\fB_CS_POSIX_V6_LP64_OFF64_LIBS\fR\fR
 275 .ad
 276 .sp .6
 277 .RS 4n
 278 If \fBsysconf\fR(\fB_SC_V6_LP64_OFF64\fR) returns -1, the meaning of this value
 279 is unspecified. Otherwise, this value is the set of libraries to be given to
 280 the \fBc99\fR utility to build an application using a programming model with
 281 64-bit \fBint\fR, \fBlong\fR, \fBpointer\fR, and \fBoff_t\fR types.
 282 .RE
 283
 284 .sp
 285 .ne 2
 286 .na
 287 \fB\fB_CS_POSIX_V6_LPBIG_OFFBIG_CFLAGS\fR\fR
 288 .ad
 289 .sp .6
 290 .RS 4n
 291 If \fBsysconf\fR(\fB_SC_V6_LPBIG_OFFBIG\fR) returns -1, the meaning of this
 292 value is unspecified. Otherwise, this value is the set of initial options to be
 293 given to the \fBc99\fR utility to build an application using a programming
 294 model with an \fBint\fR type using at least 32 bits and \fBlong\fR,
 295 \fBpointer\fR, and \fBoff_t\fR types using at least 64 bits.
 296 .RE
 297
 298 .sp
 299 .ne 2
 300 .na
 301 \fB\fB_CS_POSIX_V6_LPBIG_OFFBIG_LDFLAGS\fR\fR
 302 .ad
 303 .sp .6
 304 .RS 4n
 305 If \fBsysconf\fR(\fB_SC_V6_LPBIG_OFFBIG\fR) returns -1, the meaning of this
 306 value is unspecified. Otherwise, this value is the set of final options to be
 307 given to the \fBc99\fR utility to build an application using a programming
 308 model with an \fBint\fR type using at least 32 bits and \fBlong\fR,
 309 \fBpointer\fR, and \fBoff_t\fR types using at least 64 bits.
 310 .RE
 311
 312 .sp
 313 .ne 2
 314 .na
 315 \fB\fB_CS_POSIX_V6_LPBIG_OFFBIG_LIBS\fR\fR
 316 .ad
 317 .sp .6
 318 .RS 4n
 319 If \fBsysconf\fR(\fB_SC_V6_LPBIG_OFFBIG\fR) returns -1, the meaning of this
 320 value is unspecified. Otherwise, this value is the set of libraries to be given
 321 to the \fBc99\fR utility to build an application using a programming model with
 322 an \fBint\fR type using at least 32 bits and \fBlong\fR, \fBpointer\fR, and
 323 \fBoff_t\fR types using at least 64 bits.
 324 .RE
 325
 326 .sp
 327 .ne 2
 328 .na
 329 \fB\fB_CS_POSIX_V6_WIDTH_RESTRICTED_ENVS\fR\fR
 330 .ad
 331 .sp .6
 332 .RS 4n
 333 This value is a <newline>-separated list of names of programming environments
 334 supported  by the implementation in which the widths of the \fBblksize_t\fR,
 335 \fBcc_t\fR, \fBmode_t\fR, \fBnfds_t\fR, \fBpid_t\fR, \fBptrdiff_t\fR,
 336 \fBsize_t\fR, \fBspeed_t\fR, \fBssize_t\fR, \fBsuseconds_t\fR, \fBtcflag_t\fR,
 337 \fBuseconds_t\fR, \fBwchar_t\fR, and \fBwint_t\fR types are no greater than the
 338 width of type \fBlong\fR.
 339 .RE
 340
 341 .sp
 342 .ne 2
 343 .na
 344 \fB\fB_CS_XBS5_ILP32_OFF32_CFLAGS\fR\fR
 345 .ad
 346 .sp .6
 347 .RS 4n
 348 If \fBsysconf(_SC_XBS5_ILP32_OFF32)\fR returns \(mi1 the meaning of this value
 349 is unspecified.  Otherwise, this value is the set of initial options to be
 350 given to the \fBcc\fR and \fBc89\fR utilities to build an application using a
 351 programming model with 32-bit \fBint\fR, \fBlong\fR, \fBpointer\fR, and
 352 \fBoff_t\fR types.
 353 .RE
 354
 355 .sp
 356 .ne 2
 357 .na
 358 \fB\fB_CS_XBS5_ILP32_OFF32_LDFLAGS\fR\fR
 359 .ad
 360 .sp .6
 361 .RS 4n
 362 If \fBsysconf(_SC_XBS5_ILP32_OFF32)\fR returns \(mi1 the meaning of this value
 363 is unspecified.  Otherwise, this value is the set of final options to be given
 364 to the \fBcc\fR and \fBc89\fR utilities to build an application using a
 365 programming model with 32-bit \fBint\fR, \fBlong\fR, \fBpointer\fR, and
 366 \fBoff_t\fR types.
 367 .RE
 368
 369 .sp
 370 .ne 2
 371 .na
 372 \fB\fB_CS_XBS5_ILP32_OFF32_LIBS\fR\fR
 373 .ad
 374 .sp .6
 375 .RS 4n
 376 If \fBsysconf(_SC_XBS5_ILP32_OFF32)\fR returns \(mi1 the meaning of this value
 377 is unspecified.  Otherwise, this value is the set of libraries to be given to
 378 the \fBcc\fR and \fBc89\fR utilities to build an application using a
 379 programming model with 32-bit \fBint\fR, \fBlong\fR, \fBpointer\fR, and
 380 \fBoff_t\fR types.
 381 .RE
 382
 383 .sp
 384 .ne 2
 385 .na
 386 \fB\fB_CS_XBS5_ILP32_OFF32_LINTFLAGS\fR\fR
 387 .ad
 388 .sp .6
 389 .RS 4n
 390 If \fBsysconf(_SC_XBS5_ILP32_OFF32)\fR returns \(mi1 the meaning of this value
 391 is unspecified.  Otherwise, this value is the set of options to be given to the
 392 \fBlint\fR utility to check application source using a programming model with
 393 32-bit \fBint\fR, \fBlong\fR, \fBpointer\fR, and \fBoff_t\fR types.
 394 .RE
 395
 396 .sp
 397 .ne 2
 398 .na
 399 \fB\fB_CS_XBS5_ILP32_OFFBIG_CFLAGS\fR\fR
 400 .ad
 401 .sp .6
 402 .RS 4n
 403 If \fBsysconf(_SC_XBS5_ILP32_OFFBIG)\fR returns \(mi1 the meaning of this value
 404 is unspecified.  Otherwise, this value is the set of initial options to be
 405 given to the \fBcc\fR and \fBc89\fR utilities to build an application using a
 406 programming model with 32-bit \fBint\fR, \fBlong\fR, and \fBpointer\fR types,
 407 and an \fBoff_t\fR type using at least 64 bits.
 408 .RE
 409
 410 .sp
 411 .ne 2
 412 .na
 413 \fB\fB_CS_XBS5_ILP32_OFFBIG_LDFLAGS\fR\fR
 414 .ad
 415 .sp .6
 416 .RS 4n
 417 If \fBsysconf(SC_XBS5_ILP32_OFFBIG)\fR returns \(mi1 the meaning of this value
 418 is unspecified.  Otherwise, this value is the set of final options to be given
 419 to the \fBcc\fR and \fBc89\fR utilities to build an application using a
 420 programming model with 32-bit \fBint\fR, \fBlong\fR, and \fBpointer\fR types,
 421 and an \fBoff_t\fR type using at least 64 bits.
 422 .RE
 423
 424 .sp
 425 .ne 2
 426 .na
 427 \fB\fB_CS_XBS5_ILP32_OFFBIG_LIBS\fR\fR
 428 .ad
 429 .sp .6
 430 .RS 4n
 431 If \fBsysconf(_SC_XBS5_ILP32_OFFBIG)\fR returns \(mi1 the meaning of this value
 432 is unspecified.  Otherwise, this value is the set of libraries to be given to
 433 the \fBcc\fR and \fBc89\fR utilities to build an application using a
 434 programming model with 32-bit \fBint\fR, \fBlong\fR, and \fBpointer\fR types,
 435 and an \fBoff_t\fR type using at least 64 bits.
 436 .RE
 437
 438 .sp
 439 .ne 2
 440 .na
 441 \fB\fB_CS_XBS5_ILP32_OFFBIG_LINTFLAGS\fR\fR
 442 .ad
 443 .sp .6
 444 .RS 4n
 445 If \fBsysconf(_SC_XBS5_ILP32_OFFBIG)\fR returns \(mi1 the meaning of this value
 446 is unspecified.  Otherwise, this value is the set of options to be given to the
 447 \fBlint\fR utility to check an application using a programming model with
 448 32-bit \fBint\fR, \fBlong\fR, and \fBpointer\fR types, and an \fBoff_t\fR type
 449 using at least 64 bits.
 450 .RE
 451
 452 .sp
 453 .LP
 454 The \fBconfstr()\fR function supports the following values for \fIname\fR,
 455 defined in \fB<unistd.h>\fR, for SPARC only:
 456 .sp
 457 .ne 2
 458 .na
 459 \fB\fB_CS_XBS5_LP64_OFF64_CFLAGS\fR\fR
 460 .ad
 461 .sp .6
 462 .RS 4n
 463 If \fBsysconf(_SC_XBS5_LP64_OFF64)\fR returns \(mi1 the meaning of this value
 464 is unspecified.  Otherwise, this value is the set of initial options to be
 465 given to the \fBcc\fR and \fBc89\fR utilities to build an application using a
 466 programming model with 64-bit \fBint\fR, \fBlong\fR, \fBpointer\fR, and
 467 \fBoff_t\fR types.
 468 .RE
 469
 470 .sp
 471 .ne 2
 472 .na
 473 \fB\fB_CS_XBS5_LP64_OFF64_LDFLAGS\fR\fR
 474 .ad
 475 .sp .6
 476 .RS 4n
 477 If \fBsysconf(_SC_XBS5_LP64_OFF64)\fR returns \(mi1 the meaning of this value
 478 is unspecified.  Otherwise, this value is the set of final options to be given
 479 to the \fBcc\fR and \fBc89\fR utilities to build an application using a
 480 programming model with 64-bit \fBint\fR, \fBlong\fR, \fBpointer\fR, and
 481 \fBoff_t\fR types.
 482 .RE
 483
 484 .sp
 485 .ne 2
 486 .na
 487 \fB\fB_CS_XBS5_LP64_OFF64_LIBS\fR\fR
 488 .ad
 489 .sp .6
 490 .RS 4n
 491 If \fBsysconf(_SC_XBS5_LP64_OFF64)\fR returns \(mi1 the meaning of this value
 492 is unspecified.  Otherwise, this value is the set of libraries to be given to
 493 the \fBcc\fR and \fBc89\fR utilities to build an application using a
 494 programming model with 64-bit \fBint\fR, \fBlong\fR, \fBpointer\fR, and
 495 \fBoff_t\fR types.
 496 .RE
 497
 498 .sp
 499 .ne 2
 500 .na
 501 \fB\fB_CS_XBS5_LP64_OFF64_LINTFLAGS\fR\fR
 502 .ad
 503 .sp .6
 504 .RS 4n
 505 If \fBsysconf(_SC_XBS5_LP64_OFF64)\fR returns \(mi1 the meaning of this value
 506 is unspecified.  Otherwise, this value is the set of options to be given to the
 507 \fBlint\fR utility to check application source using a programming model with
 508 64-bit \fBint\fR, \fBlong\fR, \fBpointer\fR, and \fBoff_t\fR types.
 509 .RE
 510
 511 .sp
 512 .ne 2
 513 .na
 514 \fB\fB_CS_XBS5_LPBIG_OFFBIG_CFLAGS\fR\fR
 515 .ad
 516 .sp .6
 517 .RS 4n
 518 If \fBsysconf(_SC_XBS5_LPBIG_OFFBIG)\fR returns \(mi1 the meaning of this value
 519 is unspecified.  Otherwise, this value is the set of initial options to be
 520 given to the \fBcc\fR and \fBc89\fR utilities to build an application using a
 521 programming model with an \fBint\fR type using at least 32 bits and \fBlong\fR,
 522 \fBpointer\fR, and \fBoff_t\fR types using at least 64 bits.
 523 .RE
 524
 525 .sp
 526 .ne 2
 527 .na
 528 \fB\fB_CS_XBS5_LPBIG_OFFBIG_LDFLAGS\fR\fR
 529 .ad
 530 .sp .6
 531 .RS 4n
 532 If \fBsysconf(_SC_XBS5_LPBIG_OFFBIG)\fR returns \(mi1 the meaning of this value
 533 is unspecified.  Otherwise, this value is the set of final options to be given
 534 to the \fBcc\fR and \fBc89\fR utilities to build an application using a
 535 programming model with an \fBint\fR type using at least 32 bits and \fBlong\fR,
 536 \fBpointer\fR, and \fBoff_t\fR types using at least 64 bits.
 537 .RE
 538
 539 .sp
 540 .ne 2
 541 .na
 542 \fB\fB_CS_XBS5_LPBIG_OFFBIG_LIBS\fR\fR
 543 .ad
 544 .sp .6
 545 .RS 4n
 546 If \fBsysconf(_SC_XBS5_LPBIG_OFFBIG)\fR returns \(mi1 the meaning of this value
 547 is unspecified.  Otherwise, this value is the set of libraries to be given to
 548 the \fBcc\fR and \fBc89\fR utilities to build an application using a
 549 programming model with an \fBint\fR type using at least 32 bits and \fBlong\fR,
 550 \fBpointer\fR, and \fBoff_t\fR types using at least 64 bits.
 551 .RE
 552
 553 .sp
 554 .ne 2
 555 .na
 556 \fB\fB_CS_XBS5_LPBIG_OFFBIG_LINTFLAGS\fR\fR
 557 .ad
 558 .sp .6
 559 .RS 4n
 560 If \fBsysconf(_SC_XBS5_LPBIG_OFFBIG)\fR returns \(mi1 the meaning of this value
 561 is unspecified.  Otherwise, this value is the set of options to be given to the
 562 \fBlint\fR utility to check application source using a programming model with
 563 an \fBint\fR type using at least 32 bits and \fBlong\fR, \fBpointer\fR, and
 564 \fBoff_t\fR types using at least 64 bits.
 565 .RE
 566
 567 .SH RETURN VALUES
 568 .sp
 569 .LP
 570 If \fIname\fR has a configuration-defined value, the \fBconfstr()\fR function
 571 returns the size of buffer that would be needed to hold the entire
 572 configuration-defined value.  If this return value is greater than \fIlen\fR,
 573 the string returned in \fIbuf\fR is truncated.
 574 .sp
 575 .LP
 576 If \fIname\fR is invalid, \fBconfstr()\fR returns \fB0\fR and sets  \fBerrno\fR
 577 to indicate the error.
 578 .sp
 579 .LP
 580 If \fIname\fR does not have a configuration-defined value, \fBconfstr()\fR
 581 returns  \fB0\fR and leaves \fBerrno\fR unchanged.
 582 .SH ERRORS
 583 .sp
 584 .LP
 585 The \fBconfstr()\fR function will fail if:
 586 .sp
 587 .ne 2
 588 .na
 589 \fB\fBEINVAL\fR\fR
 590 .ad
 591 .RS 10n
 592 The value of the \fIname\fR argument is invalid.
 593 .RE
 594
 595 .SH ATTRIBUTES
 596 .sp
 597 .LP
 598 See \fBattributes\fR(5) for descriptions of the following attributes:
 599 .sp
 600
 601 .sp
 602 .TS
 603 box;
 604 c | c
 605 l | l .
 606 ATTRIBUTE TYPE  ATTRIBUTE VALUE
 607 _
 608 Interface Stability     Standard
 609 _
 610 MT-Level        Mt-Safe
 611 .TE
 612
 613 .SH SEE ALSO
 614 .sp
 615 .LP
 616 \fBpathconf\fR(2), \fBsysconf\fR(3C), \fBattributes\fR(5), \fBlfcompile\fR(5),
 617 \fBlfcompile64\fR(5), \fBstandards\fR(5)