Welcome to mirror list, hosted at ThFree Co, Russian Federation.

cygwin.com/git/newlib-cygwin.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorYaakov Selkowitz <yselkowi@redhat.com>2011-10-12 01:53:57 +0400
committerYaakov Selkowitz <yselkowi@redhat.com>2011-10-12 01:53:57 +0400
commit14b9008cca69dc6aaa2dec9954d8687437a25fbb (patch)
treec12d444bf19b6bd75af67ff8a61be46e3956a24e /winsup/utils
parent1e5bcae135c44a5468138db0a53419a0d7d69d10 (diff)
* utils.sgml (getconf): Expand documentation.
Diffstat (limited to 'winsup/utils')
-rw-r--r--winsup/utils/ChangeLog4
-rw-r--r--winsup/utils/utils.sgml24
2 files changed, 24 insertions, 4 deletions
diff --git a/winsup/utils/ChangeLog b/winsup/utils/ChangeLog
index ff7017866..9341396df 100644
--- a/winsup/utils/ChangeLog
+++ b/winsup/utils/ChangeLog
@@ -1,3 +1,7 @@
+2011-10-11 Yaakov Selkowitz <yselkowitz@users.sourceforge.net>
+
+ * utils.sgml (getconf): Expand documentation.
+
2011-10-10 Corinna Vinschen <corinna@vinschen.de>
* ldd.cc (VERSION): Remove.
diff --git a/winsup/utils/utils.sgml b/winsup/utils/utils.sgml
index 0411cb93a..a5752e841 100644
--- a/winsup/utils/utils.sgml
+++ b/winsup/utils/utils.sgml
@@ -484,15 +484,31 @@ Other options:
<para>The <command>getconf</command> utility prints the value of the
configuration variable specified by <literal>variable_name</literal>.
-If <literal>pathname</literal> is given, <command>getconf</command> prints
-the value of the configuration variable for the specified pathname.</para>
+If no <literal>pathname</literal> is given, <command>getconf</command>
+serves as a wrapper for the <literal>confstr</literal> and
+<literal>sysconf</literal> functions, supporting the symbolic constants
+defined in the <literal>limits.h</literal> and <literal>unistd.h</literal>
+headers, without their respective <literal>_CS_</literal> or
+<literal>_SC_</literal> prefixes.
+</para>
+
+<para>If <literal>pathname</literal> is given, <command>getconf</command>
+prints the value of the configuration variable for the specified pathname.
+In this form, <command>getconf</command> serves as a wrapper for the
+<literal>pathconf</literal> function, supporting the symbolic constants defined
+in the <literal>unistd.h</literal> header, without the <literal>_PC_</literal>
+prefix. </para>
<para>If you specify the <literal>-v</literal> option, the parameter
denotes a specification for which the value of the configuration variable
-should be printed.</para>
+should be printed. Note that the only specifications supported by Cygwin
+are <literal>POSIX_V7_ILP32_OFFBIG</literal> and the legacy
+<literal>POSIX_V6_ILP32_OFFBIG</literal> and
+<literal>XBS5_ILP32_OFFBIG</literal> equivalents.</para>
<para>Use the <literal>-a</literal> option to print a list of all available
-configuration variables.</para>
+configuration variables for the system, or given <literal>pathname</literal>,
+and their values.</para>
</sect2>