Un outil pour savoir si une commande est posix - retour accueil
git clone git://bebou.netlib.re/isposix
Log | Files | Refs | README |
cxref.html (11582B)
1 <!-- Copyright 2001-2024 IEEE and The Open Group, All Rights Reserved -->
2 <!DOCTYPE HTML>
3 <html lang="en">
4 <head>
5 <meta name="generator" content="HTML Tidy for HTML5 for Linux version 5.8.0">
6 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
7 <link type="text/css" rel="stylesheet" href="style.css"><!-- Generated by The Open Group rhtm tool v1.2.4 -->
8 <!-- Copyright (c) 2001-2024 The Open Group, All Rights Reserved -->
9 <title>cxref</title>
10 </head>
11 <body bgcolor="white">
12 <div class="NAVHEADER">
13 <table summary="Header navigation table" class="nav" width="100%" border="0" cellpadding="0" cellspacing="0">
14 <tr class="nav">
15 <td class="nav" width="15%" align="left" valign="bottom"><a href="../utilities/cut.html" accesskey="P"><<<
16 Previous</a></td>
17 <td class="nav" width="70%" align="center" valign="bottom"><a href="contents.html">Home</a></td>
18 <td class="nav" width="15%" align="right" valign="bottom"><a href="../utilities/date.html" accesskey="N">Next >>></a></td>
19 </tr>
20 </table>
21 <hr align="left" width="100%"></div>
22 <script language="JavaScript" src="../jscript/codes.js"></script><basefont size="3">
23 <center><font size="2">The Open Group Base Specifications Issue 8<br>
24 IEEE Std 1003.1-2024<br>
25 Copyright © 2001-2024 The IEEE and The Open Group</font></center>
26 <hr size="2" noshade>
27 <a name="top" id="top"></a> <a name="cxref" id="cxref"></a> <a name="tag_20_29" id="tag_20_29"></a><!-- cxref -->
28 <h4 class="mansect"><a name="tag_20_29_01" id="tag_20_29_01"></a>NAME</h4>
29 <blockquote>cxref — generate a C-language program cross-reference table (<b>DEVELOPMENT</b>)</blockquote>
30 <h4 class="mansect"><a name="tag_20_29_02" id="tag_20_29_02"></a>SYNOPSIS</h4>
31 <blockquote class="synopsis">
32 <div class="box"><code><tt><sup>[<a href="javascript:open_code('XSI')">XSI</a>]</sup> <img src="../images/opt-start.gif" alt=
33 "[Option Start]" border="0"> cxref</tt> <b>[</b><tt>-cs</tt><b>] [</b><tt>-o</tt> <i>file</i><b>] [</b><tt>-w</tt> <i>num</i><b>]
34 [</b><tt>-D</tt> <i>name</i><b>[</b><tt>=</tt><i>def</i><b>]]</b><tt>...</tt> <b>[</b><tt>-I</tt> <i>dir</i><b>]</b><tt>...<br>
35 </tt> <b>[</b><tt>-U</tt> <i>name</i><b>]</b><tt>...</tt> <i>file</i><tt>... <img src=
36 "../images/opt-end.gif" alt="[Option End]" border="0"></tt></code></div>
37 </blockquote>
38 <h4 class="mansect"><a name="tag_20_29_03" id="tag_20_29_03"></a>DESCRIPTION</h4>
39 <blockquote>
40 <p>The <i>cxref</i> utility shall analyze a collection of C-language <i>file</i>s and attempt to build a cross-reference table.
41 Information from <b>#define</b> lines shall be included in the symbol table. A sorted listing shall be written to standard output
42 of all symbols (auto, static, and global) in each <i>file</i> separately, or with the <b>-c</b> option, in combination. Each symbol
43 shall contain an <asterisk> before the declaring reference.</p>
44 </blockquote>
45 <h4 class="mansect"><a name="tag_20_29_04" id="tag_20_29_04"></a>OPTIONS</h4>
46 <blockquote>
47 <p>The <i>cxref</i> utility shall conform to XBD <a href="../basedefs/V1_chap12.html#tag_12_02"><i>12.2 Utility Syntax
48 Guidelines</i></a> , except that the order of the <b>-D</b>, <b>-I</b>, and <b>-U</b> options (which are identical to their
49 interpretation by <a href="../utilities/c17.html"><i>c17</i></a>) is significant. The following options shall be supported:</p>
50 <dl compact>
51 <dd></dd>
52 <dt><b>-c</b></dt>
53 <dd>Write a combined cross-reference of all input files.</dd>
54 <dt><b>-s</b></dt>
55 <dd>Operate silently; do not print input filenames.</dd>
56 <dt><b>-o </b><i>file</i></dt>
57 <dd>Direct output to named <i>file</i>.</dd>
58 <dt><b>-w </b><i>num</i></dt>
59 <dd>Format output no wider than <i>num</i> (decimal) columns. This option defaults to 80 if <i>num</i> is not specified or is less
60 than 51.</dd>
61 <dt><b>-D</b></dt>
62 <dd>Equivalent to <a href="../utilities/c17.html"><i>c17</i></a>.</dd>
63 <dt><b>-I</b></dt>
64 <dd>Equivalent to <a href="../utilities/c17.html"><i>c17</i></a>.</dd>
65 <dt><b>-U</b></dt>
66 <dd>Equivalent to <a href="../utilities/c17.html"><i>c17</i></a>.</dd>
67 </dl>
68 </blockquote>
69 <h4 class="mansect"><a name="tag_20_29_05" id="tag_20_29_05"></a>OPERANDS</h4>
70 <blockquote>
71 <p>The following operand shall be supported:</p>
72 <dl compact>
73 <dd></dd>
74 <dt><i>file</i></dt>
75 <dd>A pathname of a C-language source file.</dd>
76 </dl>
77 </blockquote>
78 <h4 class="mansect"><a name="tag_20_29_06" id="tag_20_29_06"></a>STDIN</h4>
79 <blockquote>
80 <p>Not used.</p>
81 </blockquote>
82 <h4 class="mansect"><a name="tag_20_29_07" id="tag_20_29_07"></a>INPUT FILES</h4>
83 <blockquote>
84 <p>The input files are C-language source files.</p>
85 </blockquote>
86 <h4 class="mansect"><a name="tag_20_29_08" id="tag_20_29_08"></a>ENVIRONMENT VARIABLES</h4>
87 <blockquote>
88 <p>The following environment variables shall affect the execution of <i>cxref</i>:</p>
89 <dl compact>
90 <dd></dd>
91 <dt><i>LANG</i></dt>
92 <dd>Provide a default value for the internationalization variables that are unset or null. (See XBD <a href=
93 "../basedefs/V1_chap08.html#tag_08_02"><i>8.2 Internationalization Variables</i></a> for the precedence of internationalization
94 variables used to determine the values of locale categories.)</dd>
95 <dt><i>LC_ALL</i></dt>
96 <dd>If set to a non-empty string value, override the values of all the other internationalization variables.</dd>
97 <dt><i>LC_COLLATE</i></dt>
98 <dd><br>
99 Determine the locale for the ordering of the output.</dd>
100 <dt><i>LC_CTYPE</i></dt>
101 <dd>Determine the locale for the interpretation of sequences of bytes of text data as characters (for example, single-byte as
102 opposed to multi-byte characters in arguments and input files).</dd>
103 <dt><i>LC_MESSAGES</i></dt>
104 <dd><br>
105 Determine the locale that should be used to affect the format and contents of diagnostic messages written to standard error.</dd>
106 <dt><i>NLSPATH</i></dt>
107 <dd>Determine the location of messages objects and message catalogs.</dd>
108 </dl>
109 </blockquote>
110 <h4 class="mansect"><a name="tag_20_29_09" id="tag_20_29_09"></a>ASYNCHRONOUS EVENTS</h4>
111 <blockquote>
112 <p>Default.</p>
113 </blockquote>
114 <h4 class="mansect"><a name="tag_20_29_10" id="tag_20_29_10"></a>STDOUT</h4>
115 <blockquote>
116 <p>The standard output shall be used for the cross-reference listing, unless the <b>-o</b> option is used to select a different
117 output file.</p>
118 <p>The format of standard output is unspecified, except that the following information shall be included:</p>
119 <ul>
120 <li>
121 <p>If the <b>-c</b> option is not specified, each portion of the listing shall start with the name of the input file on a separate
122 line.</p>
123 </li>
124 <li>
125 <p>The name line shall be followed by a sorted list of symbols, each with its associated location pathname, the name of the
126 function in which it appears (if it is not a function name itself), and line number references.</p>
127 </li>
128 <li>
129 <p>Each line number may be preceded by an <asterisk> (<tt>'*'</tt>) flag, meaning that this is the declaring reference. Other
130 single-character flags, with implementation-defined meanings, may be included.</p>
131 </li>
132 </ul>
133 </blockquote>
134 <h4 class="mansect"><a name="tag_20_29_11" id="tag_20_29_11"></a>STDERR</h4>
135 <blockquote>
136 <p>The standard error shall be used only for diagnostic messages.</p>
137 </blockquote>
138 <h4 class="mansect"><a name="tag_20_29_12" id="tag_20_29_12"></a>OUTPUT FILES</h4>
139 <blockquote>
140 <p>The output file named by the <b>-o</b> option shall be used instead of standard output.</p>
141 </blockquote>
142 <h4 class="mansect"><a name="tag_20_29_13" id="tag_20_29_13"></a>EXTENDED DESCRIPTION</h4>
143 <blockquote>
144 <p>None.</p>
145 </blockquote>
146 <h4 class="mansect"><a name="tag_20_29_14" id="tag_20_29_14"></a>EXIT STATUS</h4>
147 <blockquote>
148 <p>The following exit values shall be returned:</p>
149 <dl compact>
150 <dd></dd>
151 <dt> 0</dt>
152 <dd>Successful completion.</dd>
153 <dt>>0</dt>
154 <dd>An error occurred.</dd>
155 </dl>
156 </blockquote>
157 <h4 class="mansect"><a name="tag_20_29_15" id="tag_20_29_15"></a>CONSEQUENCES OF ERRORS</h4>
158 <blockquote>
159 <p>Default.</p>
160 </blockquote>
161 <hr>
162 <div class="box"><em>The following sections are informative.</em></div>
163 <h4 class="mansect"><a name="tag_20_29_16" id="tag_20_29_16"></a>APPLICATION USAGE</h4>
164 <blockquote>
165 <p>None.</p>
166 </blockquote>
167 <h4 class="mansect"><a name="tag_20_29_17" id="tag_20_29_17"></a>EXAMPLES</h4>
168 <blockquote>
169 <p>None.</p>
170 </blockquote>
171 <h4 class="mansect"><a name="tag_20_29_18" id="tag_20_29_18"></a>RATIONALE</h4>
172 <blockquote>
173 <p>None.</p>
174 </blockquote>
175 <h4 class="mansect"><a name="tag_20_29_19" id="tag_20_29_19"></a>FUTURE DIRECTIONS</h4>
176 <blockquote>
177 <p>If this utility is directed to display a pathname that contains any bytes that have the encoded value of a <newline>
178 character when <newline> is a terminator or separator in the output format being used, implementations are encouraged to
179 treat this as an error. A future version of this standard may require implementations to treat this as an error.</p>
180 </blockquote>
181 <h4 class="mansect"><a name="tag_20_29_20" id="tag_20_29_20"></a>SEE ALSO</h4>
182 <blockquote>
183 <p><a href="../utilities/c17.html#"><i>c17</i></a></p>
184 <p>XBD <a href="../basedefs/V1_chap08.html#tag_08"><i>8. Environment Variables</i></a> , <a href=
185 "../basedefs/V1_chap12.html#tag_12_02"><i>12.2 Utility Syntax Guidelines</i></a></p>
186 </blockquote>
187 <h4 class="mansect"><a name="tag_20_29_21" id="tag_20_29_21"></a>CHANGE HISTORY</h4>
188 <blockquote>
189 <p>First released in Issue 2.</p>
190 </blockquote>
191 <h4 class="mansect"><a name="tag_20_29_22" id="tag_20_29_22"></a>Issue 5</h4>
192 <blockquote>
193 <p>In the SYNOPSIS, [<b>-U</b> <i>dir</i>] is changed to [<b>-U</b> <i>name</i>].</p>
194 </blockquote>
195 <h4 class="mansect"><a name="tag_20_29_23" id="tag_20_29_23"></a>Issue 6</h4>
196 <blockquote>
197 <p>The APPLICATION USAGE section is added.</p>
198 </blockquote>
199 <h4 class="mansect"><a name="tag_20_29_24" id="tag_20_29_24"></a>Issue 7</h4>
200 <blockquote>
201 <p>SD5-XCU-ERN-97 is applied, updating the SYNOPSIS.</p>
202 </blockquote>
203 <h4 class="mansect"><a name="tag_20_29_25" id="tag_20_29_25"></a>Issue 8</h4>
204 <blockquote>
205 <p>Austin Group Defect 251 is applied, encouraging implementations to report an error if a utility is directed to display a
206 pathname that contains any bytes that have the encoded value of a <newline> character when <newline> is a terminator or
207 separator in the output format being used.</p>
208 <p>Austin Group Defect 1122 is applied, changing the description of <i>NLSPATH .</i></p>
209 </blockquote>
210 <div class="box"><em>End of informative text.</em></div>
211 <hr>
212 <p> </p>
213 <a href="#top"><span class="topOfPage">return to top of page</span></a><br>
214 <hr size="2" noshade>
215 <center><font size="2">UNIX® is a registered Trademark of The Open Group.<br>
216 POSIX™ is a Trademark of The IEEE.<br>
217 Copyright © 2001-2024 The IEEE and The Open Group, All Rights Reserved<br>
218 [ <a href="../mindex.html">Main Index</a> | <a href="../basedefs/contents.html">XBD</a> | <a href=
219 "../functions/contents.html">XSH</a> | <a href="../utilities/contents.html">XCU</a> | <a href="../xrat/contents.html">XRAT</a>
220 ]</font></center>
221 <hr size="2" noshade>
222 <div class="NAVHEADER">
223 <table summary="Header navigation table" class="nav" width="100%" border="0" cellpadding="0" cellspacing="0">
224 <tr class="nav">
225 <td class="nav" width="15%" align="left" valign="bottom"><a href="../utilities/cut.html" accesskey="P"><<<
226 Previous</a></td>
227 <td class="nav" width="70%" align="center" valign="bottom"><a href="contents.html">Home</a></td>
228 <td class="nav" width="15%" align="right" valign="bottom"><a href="../utilities/date.html" accesskey="N">Next >>></a></td>
229 </tr>
230 </table>
231 <hr align="left" width="100%"></div>
232 </body>
233 </html>