Un outil pour savoir si une commande est posix - retour accueil
git clone git://bebou.netlib.re/isposix
Log | Files | Refs | README |
prs.html (32214B)
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>prs</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/printf.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/ps.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="prs" id="prs"></a> <a name="tag_20_97" id="tag_20_97"></a><!-- prs -->
28 <h4 class="mansect"><a name="tag_20_97_01" id="tag_20_97_01"></a>NAME</h4>
29 <blockquote>prs — print an SCCS file (<b>DEVELOPMENT</b>)</blockquote>
30 <h4 class="mansect"><a name="tag_20_97_02" id="tag_20_97_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"> prs</tt> <b>[</b><tt>-a</tt><b>] [</b><tt>-d</tt> <i>dataspec</i><b>]
34 [</b><tt>-r</tt><b>[</b><i>SID</i><b>]]</b> <i>file</i><tt>...<br>
35 <br>
36 prs</tt> <b>[</b><tt>-e|-l</tt><b>]</b> <tt>-c</tt> <i>cutoff</i> <b>[</b><tt>-d</tt> <i>dataspec</i><b>]</b>
37 <i>file</i><tt>...<br>
38 <br>
39 prs</tt> <b>[</b><tt>-e|-l</tt><b>]</b> <tt>-r</tt><b>[</b><i>SID</i><b>] [</b><tt>-d</tt> <i>dataspec</i><b>]</b>
40 <i>file</i><tt>... <img src="../images/opt-end.gif" alt="[Option End]" border="0"></tt></code></div>
41 <tt><br></tt></blockquote>
42 <h4 class="mansect"><a name="tag_20_97_03" id="tag_20_97_03"></a>DESCRIPTION</h4>
43 <blockquote>
44 <p>The <i>prs</i> utility shall write to standard output parts or all of an SCCS file in a user-supplied format.</p>
45 </blockquote>
46 <h4 class="mansect"><a name="tag_20_97_04" id="tag_20_97_04"></a>OPTIONS</h4>
47 <blockquote>
48 <p>The <i>prs</i> utility shall conform to XBD <a href="../basedefs/V1_chap12.html#tag_12_02"><i>12.2 Utility Syntax
49 Guidelines</i></a> , except that the <b>-r</b> option has an optional option-argument. This optional option-argument cannot be
50 presented as a separate argument. The following options shall be supported:</p>
51 <dl compact>
52 <dd></dd>
53 <dt><b>-d </b><i>dataspec</i></dt>
54 <dd>Specify the output data specification. The <i>dataspec</i> shall be a string consisting of SCCS file <i>data</i>
55 <i>keywords</i> (see <a href="#tag_20_97_10_01">Data Keywords</a> ) interspersed with optional user-supplied text.</dd>
56 <dt><b>-r[</b><i>SID</i><b>]</b></dt>
57 <dd>Specify the SCCS identification string (SID) of a delta for which information is desired. If no <i>SID</i> option-argument is
58 specified, the SID of the most recently created delta shall be assumed.</dd>
59 <dt><b>-e</b></dt>
60 <dd>Request information for all deltas created earlier than and including the delta designated via the <b>-r</b> option or the
61 date-time given by the <b>-c</b> option.</dd>
62 <dt><b>-l</b></dt>
63 <dd>Request information for all deltas created later than and including the delta designated via the <b>-r</b> option or the
64 date-time given by the <b>-c</b> option.</dd>
65 <dt><b>-c </b><i>cutoff</i></dt>
66 <dd>Indicate the <i>cutoff</i> date-time, in the form:
67 <pre>
68 <i>YY</i><b>[</b><i>MM</i><b>[</b><i>DD</i><b>[</b><i>HH</i><b>[</b><i>MM</i><b>[</b><i>SS</i><b>]]]]]</b><tt>
69 </tt></pre>
70 <p>For the <i>YY</i> component, values in the range [69,99] shall refer to years 1969 to 1999 inclusive, and values in the range
71 [00,68] shall refer to years 2000 to 2068 inclusive. <basefont size="2"></p>
72 <dl>
73 <dt><b>Note:</b></dt>
74 <dd>It is expected that in a future version of this standard the default century inferred from a 2-digit year will change. (This
75 would apply to all commands accepting a 2-digit year as input.)</dd>
76 </dl>
77 <basefont size="3">
78 <p>No changes (deltas) to the SCCS file that were created after the specified <i>cutoff</i> date-time shall be included in the
79 output. Units omitted from the date-time default to their maximum possible values; for example, <b>-c 7502</b> is equivalent
80 to <b>-c 750228235959</b>.</p>
81 </dd>
82 <dt><b>-a</b></dt>
83 <dd>Request writing of information for both removed—that is, <a href="../utilities/delta.html"><i>delta</i></a>
84 <i>type</i>=<i>R</i> (see <a href="../utilities/rmdel.html#"><i>rmdel</i></a> )—and existing—that is, <a href=
85 "../utilities/delta.html"><i>delta</i></a> <i>type</i>=<i>D</i>,—deltas. If the <b>-a</b> option is not specified, information for
86 existing deltas only shall be provided.</dd>
87 </dl>
88 </blockquote>
89 <h4 class="mansect"><a name="tag_20_97_05" id="tag_20_97_05"></a>OPERANDS</h4>
90 <blockquote>
91 <p>The following operand shall be supported:</p>
92 <dl compact>
93 <dd></dd>
94 <dt><i>file</i></dt>
95 <dd>A pathname of an existing SCCS file or a directory. If <i>file</i> is a directory, the <i>prs</i> utility shall behave as
96 though each file in the directory were specified as a named file, except that non-SCCS files (last component of the pathname does
97 not begin with <b>s.</b>) and unreadable files shall be silently ignored.
98 <p>If exactly one <i>file</i> operand appears, and it is <tt>'-'</tt>, the standard input shall be read; each line of the standard
99 input shall be taken to be the name of an SCCS file to be processed. Non-SCCS files and unreadable files shall be silently
100 ignored.</p>
101 </dd>
102 </dl>
103 </blockquote>
104 <h4 class="mansect"><a name="tag_20_97_06" id="tag_20_97_06"></a>STDIN</h4>
105 <blockquote>
106 <p>The standard input shall be a text file used only when the <i>file</i> operand is specified as <tt>'-'</tt>. Each line of the
107 text file shall be interpreted as an SCCS pathname.</p>
108 </blockquote>
109 <h4 class="mansect"><a name="tag_20_97_07" id="tag_20_97_07"></a>INPUT FILES</h4>
110 <blockquote>
111 <p>Any SCCS files displayed are files of an unspecified format.</p>
112 </blockquote>
113 <h4 class="mansect"><a name="tag_20_97_08" id="tag_20_97_08"></a>ENVIRONMENT VARIABLES</h4>
114 <blockquote>
115 <p>The following environment variables shall affect the execution of <i>prs</i>:</p>
116 <dl compact>
117 <dd></dd>
118 <dt><i>LANG</i></dt>
119 <dd>Provide a default value for the internationalization variables that are unset or null. (See XBD <a href=
120 "../basedefs/V1_chap08.html#tag_08_02"><i>8.2 Internationalization Variables</i></a> the precedence of internationalization
121 variables used to determine the values of locale categories.)</dd>
122 <dt><i>LC_ALL</i></dt>
123 <dd>If set to a non-empty string value, override the values of all the other internationalization variables.</dd>
124 <dt><i>LC_CTYPE</i></dt>
125 <dd>Determine the locale for the interpretation of sequences of bytes of text data as characters (for example, single-byte as
126 opposed to multi-byte characters in arguments and input files).</dd>
127 <dt><i>LC_MESSAGES</i></dt>
128 <dd><br>
129 Determine the locale that should be used to affect the format and contents of diagnostic messages written to standard error.</dd>
130 <dt><i>NLSPATH</i></dt>
131 <dd>Determine the location of messages objects and message catalogs.</dd>
132 </dl>
133 </blockquote>
134 <h4 class="mansect"><a name="tag_20_97_09" id="tag_20_97_09"></a>ASYNCHRONOUS EVENTS</h4>
135 <blockquote>
136 <p>Default.</p>
137 </blockquote>
138 <h4 class="mansect"><a name="tag_20_97_10" id="tag_20_97_10"></a>STDOUT</h4>
139 <blockquote>
140 <p>The standard output shall be a text file whose format is dependent on the data keywords specified with the <b>-d</b> option.</p>
141 <h5><a name="tag_20_97_10_01" id="tag_20_97_10_01"></a>Data Keywords</h5>
142 <p>Data keywords specify which parts of an SCCS file shall be retrieved and output. All parts of an SCCS file have an associated
143 data keyword. A data keyword may appear in a <i>dataspec</i> multiple times.</p>
144 <p>The information written by <i>prs</i> shall consist of:</p>
145 <ol>
146 <li>
147 <p>The user-supplied text</p>
148 </li>
149 <li>
150 <p>Appropriate values (extracted from the SCCS file) substituted for the recognized data keywords in the order of appearance in the
151 <i>dataspec</i></p>
152 </li>
153 </ol>
154 <p>The format of a data keyword value shall either be simple (<tt>'S'</tt>), in which keyword substitution is direct, or multi-line
155 (<tt>'M'</tt>).</p>
156 <p>User-supplied text shall be any text other than recognized data keywords. A <tab> shall be specified by <tt>'\t'</tt> and
157 <newline> by <tt>'\n'</tt>. When the <b>-r</b> option is not specified, the default <i>dataspec</i> shall be:</p>
158 <pre>
159 <tt>:PN::\n\n
160 </tt></pre>
161 <p>and the following <i>dataspec</i> shall be used for each selected delta:</p>
162 <pre>
163 <tt>:Dt:\t:DL:\nMRs:\n:MR:COMMENTS:\n:C:
164 </tt></pre>
165 <center>
166 <table border="1" cellpadding="3" align="center">
167 <tr valign="top">
168 <th colspan="5" align="center">
169 <p class="tent"><b>SCCS File Data Keywords</b></p>
170 </th>
171 </tr>
172 <tr valign="top">
173 <th align="center">
174 <p class="tent"><b>Keyword</b></p>
175 </th>
176 <th align="center">
177 <p class="tent"><b>Data Item</b></p>
178 </th>
179 <th align="center">
180 <p class="tent"><b>File Section</b></p>
181 </th>
182 <th align="center">
183 <p class="tent"><b>Value</b></p>
184 </th>
185 <th align="center">
186 <p class="tent"><b>Format</b></p>
187 </th>
188 </tr>
189 <tr valign="top">
190 <td align="left">
191 <p class="tent"><b>:Dt:</b></p>
192 </td>
193 <td align="left">
194 <p class="tent">Delta information</p>
195 </td>
196 <td align="center">
197 <p class="tent">Delta Table</p>
198 </td>
199 <td align="left">
200 <p class="tent"><b>See below*</b></p>
201 </td>
202 <td align="center">
203 <p class="tent">S</p>
204 </td>
205 </tr>
206 <tr valign="top">
207 <td align="left">
208 <p class="tent"><b>:DL:</b></p>
209 </td>
210 <td align="left">
211 <p class="tent">Delta line statistics</p>
212 </td>
213 <td align="center">
214 <p class="tent">"</p>
215 </td>
216 <td align="left">
217 <p class="tent"><b>:Li:/:Ld:/:Lu:</b></p>
218 </td>
219 <td align="center">
220 <p class="tent">S</p>
221 </td>
222 </tr>
223 <tr valign="top">
224 <td align="left">
225 <p class="tent"><b>:Li:</b></p>
226 </td>
227 <td align="left">
228 <p class="tent">Lines inserted by Delta</p>
229 </td>
230 <td align="center">
231 <p class="tent">"</p>
232 </td>
233 <td align="left">
234 <p class="tent"><b><i>nnnnn</i>***</b></p>
235 </td>
236 <td align="center">
237 <p class="tent">S</p>
238 </td>
239 </tr>
240 <tr valign="top">
241 <td align="left">
242 <p class="tent"><b>:Ld:</b></p>
243 </td>
244 <td align="left">
245 <p class="tent">Lines deleted by Delta</p>
246 </td>
247 <td align="center">
248 <p class="tent">"</p>
249 </td>
250 <td align="left">
251 <p class="tent"><b><i>nnnnn</i>***</b></p>
252 </td>
253 <td align="center">
254 <p class="tent">S</p>
255 </td>
256 </tr>
257 <tr valign="top">
258 <td align="left">
259 <p class="tent"><b>:Lu:</b></p>
260 </td>
261 <td align="left">
262 <p class="tent">Lines unchanged by Delta</p>
263 </td>
264 <td align="center">
265 <p class="tent">"</p>
266 </td>
267 <td align="left">
268 <p class="tent"><b><i>nnnnn</i>***</b></p>
269 </td>
270 <td align="center">
271 <p class="tent">S</p>
272 </td>
273 </tr>
274 <tr valign="top">
275 <td align="left">
276 <p class="tent"><b>:DT:</b></p>
277 </td>
278 <td align="left">
279 <p class="tent">Delta type</p>
280 </td>
281 <td align="center">
282 <p class="tent">"</p>
283 </td>
284 <td align="left">
285 <p class="tent"><b>D or R</b></p>
286 </td>
287 <td align="center">
288 <p class="tent">S</p>
289 </td>
290 </tr>
291 <tr valign="top">
292 <td align="left">
293 <p class="tent"><b>:I:</b></p>
294 </td>
295 <td align="left">
296 <p class="tent">SCCS ID string (SID)</p>
297 </td>
298 <td align="center">
299 <p class="tent">"</p>
300 </td>
301 <td align="left">
302 <p class="tent"><b>See below**</b></p>
303 </td>
304 <td align="center">
305 <p class="tent">S</p>
306 </td>
307 </tr>
308 <tr valign="top">
309 <td align="left">
310 <p class="tent"><b>:R:</b></p>
311 </td>
312 <td align="left">
313 <p class="tent">Release number</p>
314 </td>
315 <td align="center">
316 <p class="tent">"</p>
317 </td>
318 <td align="left">
319 <p class="tent"><b><i>nnnn</i></b></p>
320 </td>
321 <td align="center">
322 <p class="tent">S</p>
323 </td>
324 </tr>
325 <tr valign="top">
326 <td align="left">
327 <p class="tent"><b>:L:</b></p>
328 </td>
329 <td align="left">
330 <p class="tent">Level number</p>
331 </td>
332 <td align="center">
333 <p class="tent">"</p>
334 </td>
335 <td align="left">
336 <p class="tent"><b><i>nnnn</i></b></p>
337 </td>
338 <td align="center">
339 <p class="tent">S</p>
340 </td>
341 </tr>
342 <tr valign="top">
343 <td align="left">
344 <p class="tent"><b>:B:</b></p>
345 </td>
346 <td align="left">
347 <p class="tent">Branch number</p>
348 </td>
349 <td align="center">
350 <p class="tent">"</p>
351 </td>
352 <td align="left">
353 <p class="tent"><b><i>nnnn</i></b></p>
354 </td>
355 <td align="center">
356 <p class="tent">S</p>
357 </td>
358 </tr>
359 <tr valign="top">
360 <td align="left">
361 <p class="tent"><b>:S:</b></p>
362 </td>
363 <td align="left">
364 <p class="tent">Sequence number</p>
365 </td>
366 <td align="center">
367 <p class="tent">"</p>
368 </td>
369 <td align="left">
370 <p class="tent"><b><i>nnnn</i></b></p>
371 </td>
372 <td align="center">
373 <p class="tent">S</p>
374 </td>
375 </tr>
376 <tr valign="top">
377 <td align="left">
378 <p class="tent"><b>:D:</b></p>
379 </td>
380 <td align="left">
381 <p class="tent">Date delta created</p>
382 </td>
383 <td align="center">
384 <p class="tent">"</p>
385 </td>
386 <td align="left">
387 <p class="tent"><b>:Dy:/:Dm:/:Dd:</b></p>
388 </td>
389 <td align="center">
390 <p class="tent">S</p>
391 </td>
392 </tr>
393 <tr valign="top">
394 <td align="left">
395 <p class="tent"><b>:Dy:</b></p>
396 </td>
397 <td align="left">
398 <p class="tent">Year delta created</p>
399 </td>
400 <td align="center">
401 <p class="tent">"</p>
402 </td>
403 <td align="left">
404 <p class="tent"><b><i>nn</i></b></p>
405 </td>
406 <td align="center">
407 <p class="tent">S</p>
408 </td>
409 </tr>
410 <tr valign="top">
411 <td align="left">
412 <p class="tent"><b>:Dm:</b></p>
413 </td>
414 <td align="left">
415 <p class="tent">Month delta created</p>
416 </td>
417 <td align="center">
418 <p class="tent">"</p>
419 </td>
420 <td align="left">
421 <p class="tent"><b><i>nn</i></b></p>
422 </td>
423 <td align="center">
424 <p class="tent">S</p>
425 </td>
426 </tr>
427 <tr valign="top">
428 <td align="left">
429 <p class="tent"><b>:Dd:</b></p>
430 </td>
431 <td align="left">
432 <p class="tent">Day delta created</p>
433 </td>
434 <td align="center">
435 <p class="tent">"</p>
436 </td>
437 <td align="left">
438 <p class="tent"><b><i>nn</i></b></p>
439 </td>
440 <td align="center">
441 <p class="tent">S</p>
442 </td>
443 </tr>
444 <tr valign="top">
445 <td align="left">
446 <p class="tent"><b>:T:</b></p>
447 </td>
448 <td align="left">
449 <p class="tent">Time delta created</p>
450 </td>
451 <td align="center">
452 <p class="tent">"</p>
453 </td>
454 <td align="left">
455 <p class="tent"><b>:Th:::Tm:::Ts:</b></p>
456 </td>
457 <td align="center">
458 <p class="tent">S</p>
459 </td>
460 </tr>
461 <tr valign="top">
462 <td align="left">
463 <p class="tent"><b>:Th:</b></p>
464 </td>
465 <td align="left">
466 <p class="tent">Hour delta created</p>
467 </td>
468 <td align="center">
469 <p class="tent">"</p>
470 </td>
471 <td align="left">
472 <p class="tent"><b><i>nn</i></b></p>
473 </td>
474 <td align="center">
475 <p class="tent">S</p>
476 </td>
477 </tr>
478 <tr valign="top">
479 <td align="left">
480 <p class="tent"><b>:Tm:</b></p>
481 </td>
482 <td align="left">
483 <p class="tent">Minutes delta created</p>
484 </td>
485 <td align="center">
486 <p class="tent">"</p>
487 </td>
488 <td align="left">
489 <p class="tent"><b><i>nn</i></b></p>
490 </td>
491 <td align="center">
492 <p class="tent">S</p>
493 </td>
494 </tr>
495 <tr valign="top">
496 <td align="left">
497 <p class="tent"><b>:Ts:</b></p>
498 </td>
499 <td align="left">
500 <p class="tent">Seconds delta created</p>
501 </td>
502 <td align="center">
503 <p class="tent">"</p>
504 </td>
505 <td align="left">
506 <p class="tent"><b><i>nn</i></b></p>
507 </td>
508 <td align="center">
509 <p class="tent">S</p>
510 </td>
511 </tr>
512 <tr valign="top">
513 <td align="left">
514 <p class="tent"><b>:P:</b></p>
515 </td>
516 <td align="left">
517 <p class="tent">Programmer who created Delta</p>
518 </td>
519 <td align="center">
520 <p class="tent">"</p>
521 </td>
522 <td align="left">
523 <p class="tent"><b><i>logname</i></b></p>
524 </td>
525 <td align="center">
526 <p class="tent">S</p>
527 </td>
528 </tr>
529 <tr valign="top">
530 <td align="left">
531 <p class="tent"><b>:DS:</b></p>
532 </td>
533 <td align="left">
534 <p class="tent">Delta sequence number</p>
535 </td>
536 <td align="center">
537 <p class="tent">"</p>
538 </td>
539 <td align="left">
540 <p class="tent"><b><i>nnnn</i></b></p>
541 </td>
542 <td align="center">
543 <p class="tent">S</p>
544 </td>
545 </tr>
546 <tr valign="top">
547 <td align="left">
548 <p class="tent"><b>:DP:</b></p>
549 </td>
550 <td align="left">
551 <p class="tent">Predecessor Delta sequence number</p>
552 </td>
553 <td align="center">
554 <p class="tent">"</p>
555 </td>
556 <td align="left">
557 <p class="tent"><b><i>nnnn</i></b></p>
558 </td>
559 <td align="center">
560 <p class="tent">S</p>
561 </td>
562 </tr>
563 <tr valign="top">
564 <td align="left">
565 <p class="tent"><b>:DI:</b></p>
566 </td>
567 <td align="left">
568 <p class="tent">Sequence number of deltas included, excluded, or ignored</p>
569 </td>
570 <td align="center">
571 <p class="tent">"</p>
572 </td>
573 <td align="left">
574 <p class="tent"><b>:Dn:/:Dx:/:Dg:</b></p>
575 </td>
576 <td align="center">
577 <p class="tent">S</p>
578 </td>
579 </tr>
580 <tr valign="top">
581 <td align="left">
582 <p class="tent"><b>:Dn:</b></p>
583 </td>
584 <td align="left">
585 <p class="tent">Deltas included (sequence #)</p>
586 </td>
587 <td align="center">
588 <p class="tent">"</p>
589 </td>
590 <td align="left">
591 <p class="tent"><b>:DS: :DS: ...</b></p>
592 </td>
593 <td align="center">
594 <p class="tent">S</p>
595 </td>
596 </tr>
597 <tr valign="top">
598 <td align="left">
599 <p class="tent"><b>:Dx:</b></p>
600 </td>
601 <td align="left">
602 <p class="tent">Deltas excluded (sequence #)</p>
603 </td>
604 <td align="center">
605 <p class="tent">"</p>
606 </td>
607 <td align="left">
608 <p class="tent"><b>:DS: :DS: ...</b></p>
609 </td>
610 <td align="center">
611 <p class="tent">S</p>
612 </td>
613 </tr>
614 <tr valign="top">
615 <td align="left">
616 <p class="tent"><b>:Dg:</b></p>
617 </td>
618 <td align="left">
619 <p class="tent">Deltas ignored (sequence #)</p>
620 </td>
621 <td align="center">
622 <p class="tent">"</p>
623 </td>
624 <td align="left">
625 <p class="tent"><b>:DS: :DS: ...</b></p>
626 </td>
627 <td align="center">
628 <p class="tent">S</p>
629 </td>
630 </tr>
631 <tr valign="top">
632 <td align="left">
633 <p class="tent"><b>:MR:</b></p>
634 </td>
635 <td align="left">
636 <p class="tent">MR numbers for delta</p>
637 </td>
638 <td align="center">
639 <p class="tent">"</p>
640 </td>
641 <td align="left">
642 <p class="tent"><b><i>text</i></b></p>
643 </td>
644 <td align="center">
645 <p class="tent">M</p>
646 </td>
647 </tr>
648 <tr valign="top">
649 <td align="left">
650 <p class="tent"><b>:C:</b></p>
651 </td>
652 <td align="left">
653 <p class="tent">Comments for delta</p>
654 </td>
655 <td align="center">
656 <p class="tent">"</p>
657 </td>
658 <td align="left">
659 <p class="tent"><b><i>text</i></b></p>
660 </td>
661 <td align="center">
662 <p class="tent">M</p>
663 </td>
664 </tr>
665 <tr valign="top">
666 <td align="left">
667 <p class="tent"><b>:UN:</b></p>
668 </td>
669 <td align="left">
670 <p class="tent">User names</p>
671 </td>
672 <td align="center">
673 <p class="tent">User Names</p>
674 </td>
675 <td align="left">
676 <p class="tent"><b><i>text</i></b></p>
677 </td>
678 <td align="center">
679 <p class="tent">M</p>
680 </td>
681 </tr>
682 <tr valign="top">
683 <td align="left">
684 <p class="tent"><b>:FL:</b></p>
685 </td>
686 <td align="left">
687 <p class="tent">Flag list</p>
688 </td>
689 <td align="center">
690 <p class="tent">Flags</p>
691 </td>
692 <td align="left">
693 <p class="tent"><b><i>text</i></b></p>
694 </td>
695 <td align="center">
696 <p class="tent">M</p>
697 </td>
698 </tr>
699 <tr valign="top">
700 <td align="left">
701 <p class="tent"><b>:Y:</b></p>
702 </td>
703 <td align="left">
704 <p class="tent">Module type flag</p>
705 </td>
706 <td align="center">
707 <p class="tent">"</p>
708 </td>
709 <td align="left">
710 <p class="tent"><b><i>text</i></b></p>
711 </td>
712 <td align="center">
713 <p class="tent">S</p>
714 </td>
715 </tr>
716 <tr valign="top">
717 <td align="left">
718 <p class="tent"><b>:MF:</b></p>
719 </td>
720 <td align="left">
721 <p class="tent">MR validation flag</p>
722 </td>
723 <td align="center">
724 <p class="tent">"</p>
725 </td>
726 <td align="left">
727 <p class="tent"><b>yes or no</b></p>
728 </td>
729 <td align="center">
730 <p class="tent">S</p>
731 </td>
732 </tr>
733 <tr valign="top">
734 <td align="left">
735 <p class="tent"><b>:MP:</b></p>
736 </td>
737 <td align="left">
738 <p class="tent">MR validation program name</p>
739 </td>
740 <td align="center">
741 <p class="tent">"</p>
742 </td>
743 <td align="left">
744 <p class="tent"><b><i>text</i></b></p>
745 </td>
746 <td align="center">
747 <p class="tent">S</p>
748 </td>
749 </tr>
750 <tr valign="top">
751 <td align="left">
752 <p class="tent"><b>:KF:</b></p>
753 </td>
754 <td align="left">
755 <p class="tent">Keyword error, warning flag</p>
756 </td>
757 <td align="center">
758 <p class="tent">"</p>
759 </td>
760 <td align="left">
761 <p class="tent"><b>yes or no</b></p>
762 </td>
763 <td align="center">
764 <p class="tent">S</p>
765 </td>
766 </tr>
767 <tr valign="top">
768 <td align="left">
769 <p class="tent"><b>:BF:</b></p>
770 </td>
771 <td align="left">
772 <p class="tent">Branch flag</p>
773 </td>
774 <td align="center">
775 <p class="tent">"</p>
776 </td>
777 <td align="left">
778 <p class="tent"><b>yes or no</b></p>
779 </td>
780 <td align="center">
781 <p class="tent">S</p>
782 </td>
783 </tr>
784 <tr valign="top">
785 <td align="left">
786 <p class="tent"><b>:J:</b></p>
787 </td>
788 <td align="left">
789 <p class="tent">Joint edit flag</p>
790 </td>
791 <td align="center">
792 <p class="tent">"</p>
793 </td>
794 <td align="left">
795 <p class="tent"><b>yes or no</b></p>
796 </td>
797 <td align="center">
798 <p class="tent">S</p>
799 </td>
800 </tr>
801 <tr valign="top">
802 <td align="left">
803 <p class="tent"><b>:LK:</b></p>
804 </td>
805 <td align="left">
806 <p class="tent">Locked releases</p>
807 </td>
808 <td align="center">
809 <p class="tent">"</p>
810 </td>
811 <td align="left">
812 <p class="tent"><b>:R: ...</b></p>
813 </td>
814 <td align="center">
815 <p class="tent">S</p>
816 </td>
817 </tr>
818 <tr valign="top">
819 <td align="left">
820 <p class="tent"><b>:Q:</b></p>
821 </td>
822 <td align="left">
823 <p class="tent">User-defined keyword</p>
824 </td>
825 <td align="center">
826 <p class="tent">"</p>
827 </td>
828 <td align="left">
829 <p class="tent"><b><i>text</i></b></p>
830 </td>
831 <td align="center">
832 <p class="tent">S</p>
833 </td>
834 </tr>
835 <tr valign="top">
836 <td align="left">
837 <p class="tent"><b>:M:</b></p>
838 </td>
839 <td align="left">
840 <p class="tent">Module name</p>
841 </td>
842 <td align="center">
843 <p class="tent">"</p>
844 </td>
845 <td align="left">
846 <p class="tent"><b><i>text</i></b></p>
847 </td>
848 <td align="center">
849 <p class="tent">S</p>
850 </td>
851 </tr>
852 <tr valign="top">
853 <td align="left">
854 <p class="tent"><b>:FB:</b></p>
855 </td>
856 <td align="left">
857 <p class="tent">Floor boundary</p>
858 </td>
859 <td align="center">
860 <p class="tent">"</p>
861 </td>
862 <td align="left">
863 <p class="tent"><b>:R:</b></p>
864 </td>
865 <td align="center">
866 <p class="tent">S</p>
867 </td>
868 </tr>
869 <tr valign="top">
870 <td align="left">
871 <p class="tent"><b>:CB:</b></p>
872 </td>
873 <td align="left">
874 <p class="tent">Ceiling boundary</p>
875 </td>
876 <td align="center">
877 <p class="tent">"</p>
878 </td>
879 <td align="left">
880 <p class="tent"><b>:R:</b></p>
881 </td>
882 <td align="center">
883 <p class="tent">S</p>
884 </td>
885 </tr>
886 <tr valign="top">
887 <td align="left">
888 <p class="tent"><b>:Ds:</b></p>
889 </td>
890 <td align="left">
891 <p class="tent">Default SID</p>
892 </td>
893 <td align="center">
894 <p class="tent">"</p>
895 </td>
896 <td align="left">
897 <p class="tent"><b>:I:</b></p>
898 </td>
899 <td align="center">
900 <p class="tent">S</p>
901 </td>
902 </tr>
903 <tr valign="top">
904 <td align="left">
905 <p class="tent"><b>:ND:</b></p>
906 </td>
907 <td align="left">
908 <p class="tent">Null delta flag</p>
909 </td>
910 <td align="center">
911 <p class="tent">"</p>
912 </td>
913 <td align="left">
914 <p class="tent"><b>yes or no</b></p>
915 </td>
916 <td align="center">
917 <p class="tent">S</p>
918 </td>
919 </tr>
920 <tr valign="top">
921 <td align="left">
922 <p class="tent"><b>:FD:</b></p>
923 </td>
924 <td align="left">
925 <p class="tent">File descriptive text</p>
926 </td>
927 <td align="center">
928 <p class="tent">Comments</p>
929 </td>
930 <td align="left">
931 <p class="tent"><b><i>text</i></b></p>
932 </td>
933 <td align="center">
934 <p class="tent">M</p>
935 </td>
936 </tr>
937 <tr valign="top">
938 <td align="left">
939 <p class="tent"><b>:BD:</b></p>
940 </td>
941 <td align="left">
942 <p class="tent">Body</p>
943 </td>
944 <td align="center">
945 <p class="tent">Body</p>
946 </td>
947 <td align="left">
948 <p class="tent"><b><i>text</i></b></p>
949 </td>
950 <td align="center">
951 <p class="tent">M</p>
952 </td>
953 </tr>
954 <tr valign="top">
955 <td align="left">
956 <p class="tent"><b>:GB:</b></p>
957 </td>
958 <td align="left">
959 <p class="tent">Gotten body</p>
960 </td>
961 <td align="center">
962 <p class="tent">"</p>
963 </td>
964 <td align="left">
965 <p class="tent"><b><i>text</i></b></p>
966 </td>
967 <td align="center">
968 <p class="tent">M</p>
969 </td>
970 </tr>
971 <tr valign="top">
972 <td align="left">
973 <p class="tent"><b>:W:</b></p>
974 </td>
975 <td align="left">
976 <p class="tent">A form of <i>what</i> string</p>
977 </td>
978 <td align="center">
979 <p class="tent">N/A</p>
980 </td>
981 <td align="left">
982 <p class="tent"><b>:Z::M:\t:I:</b></p>
983 </td>
984 <td align="center">
985 <p class="tent">S</p>
986 </td>
987 </tr>
988 <tr valign="top">
989 <td align="left">
990 <p class="tent"><b>:A:</b></p>
991 </td>
992 <td align="left">
993 <p class="tent">A form of <i>what</i> string</p>
994 </td>
995 <td align="center">
996 <p class="tent">N/A</p>
997 </td>
998 <td align="left">
999 <p class="tent"><b>:Z::Y: :M: :I::Z:</b></p>
1000 </td>
1001 <td align="center">
1002 <p class="tent">S</p>
1003 </td>
1004 </tr>
1005 <tr valign="top">
1006 <td align="left">
1007 <p class="tent"><b>:Z:</b></p>
1008 </td>
1009 <td align="left">
1010 <p class="tent"><i>what</i> string delimiter</p>
1011 </td>
1012 <td align="center">
1013 <p class="tent">N/A</p>
1014 </td>
1015 <td align="left">
1016 <p class="tent"><b><tt>@(#)</tt></b></p>
1017 </td>
1018 <td align="center">
1019 <p class="tent">S</p>
1020 </td>
1021 </tr>
1022 <tr valign="top">
1023 <td align="left">
1024 <p class="tent"><b>:F:</b></p>
1025 </td>
1026 <td align="left">
1027 <p class="tent">SCCS filename</p>
1028 </td>
1029 <td align="center">
1030 <p class="tent">N/A</p>
1031 </td>
1032 <td align="left">
1033 <p class="tent"><b><i>text</i></b></p>
1034 </td>
1035 <td align="center">
1036 <p class="tent">S</p>
1037 </td>
1038 </tr>
1039 <tr valign="top">
1040 <td align="left">
1041 <p class="tent"><b>:PN:</b></p>
1042 </td>
1043 <td align="left">
1044 <p class="tent">SCCS file pathname</p>
1045 </td>
1046 <td align="center">
1047 <p class="tent">N/A</p>
1048 </td>
1049 <td align="left">
1050 <p class="tent"><b><i>text</i></b></p>
1051 </td>
1052 <td align="center">
1053 <p class="tent">S</p>
1054 </td>
1055 </tr>
1056 </table>
1057 </center>
1058 <dl compact>
1059 <dd></dd>
1060 <dt>*</dt>
1061 <dd><b>:Dt:</b>=<b>:DT: :I: :D: :T: :P: :DS: :DP:</b></dd>
1062 <dt>**</dt>
1063 <dd><b>:R:.:L:.:B:.:S:</b> if the delta is a branch delta (<b>:BF:</b>==<b>yes</b>)<br>
1064 <b>:R:.:L:</b> if the delta is not a branch delta (<b>:BF:</b>==<b>no</b>)</dd>
1065 <dt>***</dt>
1066 <dd>The line statistics are capped at 99999. For example, if 100000 lines were unchanged in a certain revision, <b>:Lu:</b> shall
1067 produce the value 99999.</dd>
1068 </dl>
1069 </blockquote>
1070 <h4 class="mansect"><a name="tag_20_97_11" id="tag_20_97_11"></a>STDERR</h4>
1071 <blockquote>
1072 <p>The standard error shall be used only for diagnostic messages.</p>
1073 </blockquote>
1074 <h4 class="mansect"><a name="tag_20_97_12" id="tag_20_97_12"></a>OUTPUT FILES</h4>
1075 <blockquote>
1076 <p>None.</p>
1077 </blockquote>
1078 <h4 class="mansect"><a name="tag_20_97_13" id="tag_20_97_13"></a>EXTENDED DESCRIPTION</h4>
1079 <blockquote>
1080 <p>None.</p>
1081 </blockquote>
1082 <h4 class="mansect"><a name="tag_20_97_14" id="tag_20_97_14"></a>EXIT STATUS</h4>
1083 <blockquote>
1084 <p>The following exit values shall be returned:</p>
1085 <dl compact>
1086 <dd></dd>
1087 <dt> 0</dt>
1088 <dd>Successful completion.</dd>
1089 <dt>>0</dt>
1090 <dd>An error occurred.</dd>
1091 </dl>
1092 </blockquote>
1093 <h4 class="mansect"><a name="tag_20_97_15" id="tag_20_97_15"></a>CONSEQUENCES OF ERRORS</h4>
1094 <blockquote>
1095 <p>Default.</p>
1096 </blockquote>
1097 <hr>
1098 <div class="box"><em>The following sections are informative.</em></div>
1099 <h4 class="mansect"><a name="tag_20_97_16" id="tag_20_97_16"></a>APPLICATION USAGE</h4>
1100 <blockquote>
1101 <p>None.</p>
1102 </blockquote>
1103 <h4 class="mansect"><a name="tag_20_97_17" id="tag_20_97_17"></a>EXAMPLES</h4>
1104 <blockquote>
1105 <ol>
1106 <li class="tent">The following example:
1107 <pre>
1108 <tt>prs -d "User Names for :F: are:\n:UN:" s.file
1109 </tt></pre>
1110 <p class="tent">might write to standard output:</p>
1111 <pre>
1112 <tt>User Names for s.file are:
1113 xyz
1114 131
1115 abc
1116 </tt></pre></li>
1117 <li class="tent">The following example:
1118 <pre>
1119 <tt>prs -d "Delta for pgm :M:: :I: - :D: By :P:" -r s.file
1120 </tt></pre>
1121 <p class="tent">might write to standard output:</p>
1122 <pre>
1123 <tt>Delta for pgm main.c: 3.7 - 77/12/01 By cas
1124 </tt></pre></li>
1125 <li class="tent">As a special case:
1126 <pre>
1127 <tt>prs s.file
1128 </tt></pre>
1129 <p class="tent">might write to standard output:</p>
1130 <pre>
1131 <tt>s.file:
1132 <</tt><i>blank line</i><tt>>
1133 D 1.1 77/12/01 00:00:00 cas 1 000000/00000/00000
1134 MRs:
1135 bl78-12345
1136 bl79-54321
1137 COMMENTS:
1138 this is the comment line for s.file initial delta
1139 <</tt><i>blank line</i><tt>>
1140 </tt></pre>
1141 <p class="tent">for each delta table entry of the <b>D</b> type. The only option allowed to be used with this special case is the
1142 <b>-a</b> option.</p>
1143 </li>
1144 </ol>
1145 </blockquote>
1146 <h4 class="mansect"><a name="tag_20_97_18" id="tag_20_97_18"></a>RATIONALE</h4>
1147 <blockquote>
1148 <p>None.</p>
1149 </blockquote>
1150 <h4 class="mansect"><a name="tag_20_97_19" id="tag_20_97_19"></a>FUTURE DIRECTIONS</h4>
1151 <blockquote>
1152 <p>If this utility is directed to display a pathname that contains any bytes that have the encoded value of a <newline>
1153 character when <newline> is a terminator or separator in the output format being used, implementations are encouraged to
1154 treat this as an error. A future version of this standard may require implementations to treat this as an error.</p>
1155 </blockquote>
1156 <h4 class="mansect"><a name="tag_20_97_20" id="tag_20_97_20"></a>SEE ALSO</h4>
1157 <blockquote>
1158 <p><a href="../utilities/admin.html#"><i>admin</i></a> , <a href="../utilities/delta.html#"><i>delta</i></a> , <a href=
1159 "../utilities/get.html#"><i>get</i></a> , <a href="../utilities/what.html#"><i>what</i></a></p>
1160 <p class="tent">XBD <a href="../basedefs/V1_chap08.html#tag_08"><i>8. Environment Variables</i></a> , <a href=
1161 "../basedefs/V1_chap12.html#tag_12_02"><i>12.2 Utility Syntax Guidelines</i></a></p>
1162 </blockquote>
1163 <h4 class="mansect"><a name="tag_20_97_21" id="tag_20_97_21"></a>CHANGE HISTORY</h4>
1164 <blockquote>
1165 <p>First released in Issue 2.</p>
1166 </blockquote>
1167 <h4 class="mansect"><a name="tag_20_97_22" id="tag_20_97_22"></a>Issue 5</h4>
1168 <blockquote>
1169 <p>The phrase "in which keyword substitution is followed by a <newline>" is deleted from the end of the second paragraph of
1170 <a href="#tag_20_97_10_01">Data Keywords</a> .</p>
1171 <p class="tent">The interpretation of the <i>YY</i> component of the <b>-c</b> <i>cutoff</i> argument is noted.</p>
1172 </blockquote>
1173 <h4 class="mansect"><a name="tag_20_97_23" id="tag_20_97_23"></a>Issue 6</h4>
1174 <blockquote>
1175 <p>The normative text is reworded to emphasize the term "shall" for implementation requirements.</p>
1176 <p class="tent">The Open Group Base Resolution bwg2001-007 is applied, updating the table in STDOUT with a note that line
1177 statistics are capped at 99999 for the <b>:Li:</b>, <b>:Ld:</b>, <b>:Lu:</b>, and <b>:DL:</b> keywords.</p>
1178 <p class="tent">The Open Group Interpretation PIN4C.00009 is applied.</p>
1179 </blockquote>
1180 <h4 class="mansect"><a name="tag_20_97_24" id="tag_20_97_24"></a>Issue 7</h4>
1181 <blockquote>
1182 <p>SD5-XCU-ERN-97 is applied, updating the SYNOPSIS.</p>
1183 </blockquote>
1184 <h4 class="mansect"><a name="tag_20_97_25" id="tag_20_97_25"></a>Issue 8</h4>
1185 <blockquote>
1186 <p>Austin Group Defect 251 is applied, encouraging implementations to report an error if a utility is directed to display a
1187 pathname that contains any bytes that have the encoded value of a <newline> character when <newline> is a terminator or
1188 separator in the output format being used.</p>
1189 <p class="tent">Austin Group Defect 1122 is applied, changing the description of <i>NLSPATH .</i></p>
1190 <p class="tent">Austin Group Defect 1452 is applied, deleting <b>:KV:</b> from the list of keywords.</p>
1191 <p class="tent">Austin Group Defect 1570 is applied, removing extra spacing in <tt>"=="</tt>.</p>
1192 </blockquote>
1193 <div class="box"><em>End of informative text.</em></div>
1194 <hr>
1195 <p> </p>
1196 <a href="#top"><span class="topOfPage">return to top of page</span></a><br>
1197 <hr size="2" noshade>
1198 <center><font size="2">UNIX® is a registered Trademark of The Open Group.<br>
1199 POSIX™ is a Trademark of The IEEE.<br>
1200 Copyright © 2001-2024 The IEEE and The Open Group, All Rights Reserved<br>
1201 [ <a href="../mindex.html">Main Index</a> | <a href="../basedefs/contents.html">XBD</a> | <a href=
1202 "../functions/contents.html">XSH</a> | <a href="../utilities/contents.html">XCU</a> | <a href="../xrat/contents.html">XRAT</a>
1203 ]</font></center>
1204 <hr size="2" noshade>
1205 <div class="NAVHEADER">
1206 <table summary="Header navigation table" class="nav" width="100%" border="0" cellpadding="0" cellspacing="0">
1207 <tr class="nav">
1208 <td class="nav" width="15%" align="left" valign="bottom"><a href="../utilities/printf.html" accesskey="P"><<<
1209 Previous</a></td>
1210 <td class="nav" width="70%" align="center" valign="bottom"><a href="contents.html">Home</a></td>
1211 <td class="nav" width="15%" align="right" valign="bottom"><a href="../utilities/ps.html" accesskey="N">Next >>></a></td>
1212 </tr>
1213 </table>
1214 <hr align="left" width="100%"></div>
1215 </body>
1216 </html>