#, fuzzy msgid "" msgstr "" "Project-Id-Version: man-pages-l10n VERSION\n" "POT-Creation-Date: 2014-07-17 17:58+0900\n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=UTF-8\n" "Content-Transfer-Encoding: 8bit\n" #. type: TH #: man-pages-posix/man3p/confstr.3p:2 #, no-wrap msgid "CONFSTR" msgstr "" #. type: TH #: man-pages-posix/man3p/confstr.3p:2 #, no-wrap msgid "2013" msgstr "" #. type: TH #: man-pages-posix/man3p/confstr.3p:2 #, no-wrap msgid "IEEE/The Open Group" msgstr "" #. type: TH #: man-pages-posix/man3p/confstr.3p:2 #, no-wrap msgid "POSIX Programmer's Manual" msgstr "" #. type: SH #: man-pages-posix/man3p/confstr.3p:3 #, no-wrap msgid "PROLOG" msgstr "" #. type: Plain text #: man-pages-posix/man3p/confstr.3p:8 msgid "" "This manual page is part of the POSIX Programmer's Manual. The Linux " "implementation of this interface may differ (consult the corresponding Linux " "manual page for details of Linux behavior), or the interface may not be " "implemented on Linux." msgstr "" #. type: SH #: man-pages-posix/man3p/confstr.3p:9 #, no-wrap msgid "NAME" msgstr "" #. type: Plain text #: man-pages-posix/man3p/confstr.3p:12 msgid "confstr \\(em get configurable variables" msgstr "" #. type: SH #: man-pages-posix/man3p/confstr.3p:12 #, no-wrap msgid "SYNOPSIS" msgstr "" #. type: Plain text #: man-pages-posix/man3p/confstr.3p:16 #, no-wrap msgid "#include Eunistd.hE\n" msgstr "" #. type: Plain text #: man-pages-posix/man3p/confstr.3p:18 #, no-wrap msgid "size_t confstr(int I, char *I, size_t I);\n" msgstr "" #. type: SH #: man-pages-posix/man3p/confstr.3p:19 #, no-wrap msgid "DESCRIPTION" msgstr "" #. type: Plain text #: man-pages-posix/man3p/confstr.3p:27 msgid "" "The I() function shall return configuration-defined string values. " "Its use and purpose are similar to I(), but it is used where string " "values rather than numeric values are returned." msgstr "" #. type: Plain text #: man-pages-posix/man3p/confstr.3p:34 msgid "" "The I argument represents the system variable to be queried. The " "implementation shall support the following name values, defined in " "Iunistd.hE>. It may support others:" msgstr "" #. type: Plain text #: man-pages-posix/man3p/confstr.3p:67 #, no-wrap msgid "" "_CS_PATH\n" "_CS_POSIX_V7_ILP32_OFF32_CFLAGS\n" "_CS_POSIX_V7_ILP32_OFF32_LDFLAGS\n" "_CS_POSIX_V7_ILP32_OFF32_LIBS\n" "_CS_POSIX_V7_ILP32_OFFBIG_CFLAGS\n" "_CS_POSIX_V7_ILP32_OFFBIG_LDFLAGS\n" "_CS_POSIX_V7_ILP32_OFFBIG_LIBS\n" "_CS_POSIX_V7_LP64_OFF64_CFLAGS\n" "_CS_POSIX_V7_LP64_OFF64_LDFLAGS\n" "_CS_POSIX_V7_LP64_OFF64_LIBS\n" "_CS_POSIX_V7_LPBIG_OFFBIG_CFLAGS\n" "_CS_POSIX_V7_LPBIG_OFFBIG_LDFLAGS\n" "_CS_POSIX_V7_LPBIG_OFFBIG_LIBS\n" "_CS_POSIX_V7_THREADS_CFLAGS\n" "_CS_POSIX_V7_THREADS_LDFLAGS\n" "_CS_POSIX_V7_WIDTH_RESTRICTED_ENVS\n" "_CS_V7_ENV\n" "_CS_POSIX_V6_ILP32_OFF32_CFLAGS\n" "_CS_POSIX_V6_ILP32_OFF32_LDFLAGS\n" "_CS_POSIX_V6_ILP32_OFF32_LIBS\n" "_CS_POSIX_V6_ILP32_OFFBIG_CFLAGS\n" "_CS_POSIX_V6_ILP32_OFFBIG_LDFLAGS\n" "_CS_POSIX_V6_ILP32_OFFBIG_LIBS\n" "_CS_POSIX_V6_LP64_OFF64_CFLAGS\n" "_CS_POSIX_V6_LP64_OFF64_LDFLAGS\n" "_CS_POSIX_V6_LP64_OFF64_LIBS\n" "_CS_POSIX_V6_LPBIG_OFFBIG_CFLAGS\n" "_CS_POSIX_V6_LPBIG_OFFBIG_LDFLAGS\n" "_CS_POSIX_V6_LPBIG_OFFBIG_LIBS\n" "_CS_POSIX_V6_WIDTH_RESTRICTED_ENVS\n" "_CS_V6_ENV\n" msgstr "" #. type: Plain text #: man-pages-posix/man3p/confstr.3p:90 msgid "" "If I is not 0, and if I has a configuration-defined value, " "I() shall copy that value into the I-byte buffer pointed to " "by I. If the string to be returned is longer than I bytes, " "including the terminating null, then I() shall truncate the string " "to I\\(mi1 bytes and null-terminate the result. The application can " "detect that the string was truncated by comparing the value returned by " "I() with I." msgstr "" #. type: Plain text #: man-pages-posix/man3p/confstr.3p:103 msgid "" "If I is 0 and I is a null pointer, then I() shall still " "return the integer value as defined below, but shall not return a string. If " "I is 0 but I is not a null pointer, the result is unspecified." msgstr "" #. type: Plain text #: man-pages-posix/man3p/confstr.3p:105 msgid "After a call to:" msgstr "" #. type: Plain text #: man-pages-posix/man3p/confstr.3p:110 #, no-wrap msgid "B<\n" "confstr(_CS_V7_ENV, buf, sizeof(buf))>\n" msgstr "" #. type: Plain text #: man-pages-posix/man3p/confstr.3p:121 msgid "" "the string stored in I will contain the EspaceE-separated list " "of variable=value environment variable pairs required by the implementation " "to create a conforming environment, as described in the implementations' " "conformance documentation." msgstr "" #. type: Plain text #: man-pages-posix/man3p/confstr.3p:126 msgid "" "If the implementation supports the POSIX shell option, the string stored in " "I after a call to:" msgstr "" #. type: Plain text #: man-pages-posix/man3p/confstr.3p:131 #, no-wrap msgid "B<\n" "confstr(_CS_PATH, buf, sizeof(buf))>\n" msgstr "" #. type: Plain text #: man-pages-posix/man3p/confstr.3p:141 msgid "" "can be used as a value of the I environment variable that accesses all " "of the standard utilities of POSIX.1\\(hy2008, if the return value is less " "than or equal to I(I)." msgstr "" #. type: SH #: man-pages-posix/man3p/confstr.3p:141 #, no-wrap msgid "RETURN VALUE" msgstr "" #. type: Plain text #: man-pages-posix/man3p/confstr.3p:153 msgid "" "If I has a configuration-defined value, I() shall return the " "size of buffer that would be needed to hold the entire configuration-defined " "value including the terminating null. If this return value is greater than " "I, the string returned in I is truncated." msgstr "" #. type: Plain text #: man-pages-posix/man3p/confstr.3p:161 msgid "" "If I is invalid, I() shall return 0 and set I to " "indicate the error." msgstr "" #. type: Plain text #: man-pages-posix/man3p/confstr.3p:169 msgid "" "If I does not have a configuration-defined value, I() shall " "return 0 and leave I unchanged." msgstr "" #. type: SH #: man-pages-posix/man3p/confstr.3p:169 #, no-wrap msgid "ERRORS" msgstr "" #. type: Plain text #: man-pages-posix/man3p/confstr.3p:173 msgid "The I() function shall fail if:" msgstr "" #. type: TP #: man-pages-posix/man3p/confstr.3p:173 #, no-wrap msgid "B" msgstr "" #. type: Plain text #: man-pages-posix/man3p/confstr.3p:178 msgid "The value of the I argument is invalid." msgstr "" #. type: Plain text #: man-pages-posix/man3p/confstr.3p:180 msgid "I" msgstr "" #. type: SH #: man-pages-posix/man3p/confstr.3p:180 #, no-wrap msgid "EXAMPLES" msgstr "" #. type: Plain text #: man-pages-posix/man3p/confstr.3p:182 man-pages-posix/man3p/confstr.3p:252 msgid "None." msgstr "" #. type: SH #: man-pages-posix/man3p/confstr.3p:182 #, no-wrap msgid "APPLICATION USAGE" msgstr "" #. type: Plain text #: man-pages-posix/man3p/confstr.3p:190 msgid "" "An application can distinguish between an invalid I parameter value " "and one that corresponds to a configurable variable that has no " "configuration-defined value by checking if I is modified. This " "mirrors the behavior of I()." msgstr "" #. type: Plain text #: man-pages-posix/man3p/confstr.3p:202 msgid "" "The original need for this function was to provide a way of finding the " "configuration-defined default value for the environment variable I. " "Since I can be modified by the user to include directories that could " "contain utilities replacing the standard utilities in the Shell and " "Utilities volume of POSIX.1\\(hy2008, applications need a way to determine " "the system-supplied I environment variable value that contains the " "correct search path for the standard utilities." msgstr "" #. type: Plain text #: man-pages-posix/man3p/confstr.3p:204 msgid "An application could use:" msgstr "" #. type: Plain text #: man-pages-posix/man3p/confstr.3p:209 #, no-wrap msgid "B<\n" "confstr(name, (char *)NULL, (size_t)0)>\n" msgstr "" #. type: Plain text #: man-pages-posix/man3p/confstr.3p:222 msgid "" "to find out how big a buffer is needed for the string value; use I() " " to allocate a buffer to hold the string; and call I() again to " "get the string. Alternately, it could allocate a fixed, static buffer that " "is big enough to hold most answers (perhaps 512 or 1\\|024 bytes), but then " "use I() to allocate a larger buffer if it finds that this is too " "small." msgstr "" #. type: SH #: man-pages-posix/man3p/confstr.3p:222 #, no-wrap msgid "RATIONALE" msgstr "" #. type: Plain text #: man-pages-posix/man3p/confstr.3p:225 msgid "" "Application developers can normally determine any configuration variable by " "means of reading from the stream opened by a call to:" msgstr "" #. type: Plain text #: man-pages-posix/man3p/confstr.3p:230 #, no-wrap msgid "B<\n" "popen(\"command -p getconf variable\", \"r\");>\n" msgstr "" #. type: Plain text #: man-pages-posix/man3p/confstr.3p:242 msgid "" "The I() function with a I argument of _CS_PATH returns a " "string that can be used as a I environment variable setting that will " "reference the standard shell and utilities as described in the Shell and " "Utilities volume of POSIX.1\\(hy2008." msgstr "" #. type: Plain text #: man-pages-posix/man3p/confstr.3p:250 msgid "" "The I() function copies the returned string into a buffer supplied " "by the application instead of returning a pointer to a string. This allows a " "cleaner function in some implementations (such as those with lightweight " "threads) and resolves questions about when the application must copy the " "string returned." msgstr "" #. type: SH #: man-pages-posix/man3p/confstr.3p:250 #, no-wrap msgid "FUTURE DIRECTIONS" msgstr "" #. type: SH #: man-pages-posix/man3p/confstr.3p:252 #, no-wrap msgid "SEE ALSO" msgstr "" #. type: Plain text #: man-pages-posix/man3p/confstr.3p:256 msgid "I\\^, I\\^(\\|), I\\^(\\|)" msgstr "" #. type: Plain text #: man-pages-posix/man3p/confstr.3p:259 msgid "The Base Definitions volume of POSIX.1\\(hy2008, Bunistd.hE>" msgstr "" #. type: Plain text #: man-pages-posix/man3p/confstr.3p:262 msgid "The Shell and Utilities volume of POSIX.1\\(hy2008, I\\^" msgstr "" #. type: SH #: man-pages-posix/man3p/confstr.3p:262 #, no-wrap msgid "COPYRIGHT" msgstr "" #. type: Plain text #: man-pages-posix/man3p/confstr.3p:273 msgid "" "Portions of this text are reprinted and reproduced in electronic form from " "IEEE Std 1003.1, 2013 Edition, Standard for Information Technology -- " "Portable Operating System Interface (POSIX), The Open Group Base " "Specifications Issue 7, Copyright (C) 2013 by the Institute of Electrical " "and Electronics Engineers, Inc and The Open Group. (This is POSIX.1-2008 " "with the 2013 Technical Corrigendum 1 applied.) In the event of any " "discrepancy between this version 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.unix." "org/online.html ." msgstr "" #. type: Plain text #: man-pages-posix/man3p/confstr.3p:278 msgid "" "Any typographical or formatting errors that appear in this page are most " "likely to have been introduced during the conversion of the source files to " "man page format. To report such errors, see https://www.kernel.org/doc/man-" "pages/reporting_bugs.html ." msgstr ""