Un outil pour savoir si une commande est posix - retour accueil
git clone git://bebou.netlib.re/isposix
Log | Files | Refs | README |
asa.html (11194B)
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>asa</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/ar.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/at.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="asa" id="asa"></a> <a name="tag_20_04" id="tag_20_04"></a><!-- asa -->
28 <h4 class="mansect"><a name="tag_20_04_01" id="tag_20_04_01"></a>NAME</h4>
29 <blockquote>asa — interpret carriage-control characters</blockquote>
30 <h4 class="mansect"><a name="tag_20_04_02" id="tag_20_04_02"></a>SYNOPSIS</h4>
31 <blockquote class="synopsis">
32 <div class="box"><code><tt><sup>[<a href="javascript:open_code('FR')">FR</a>]</sup> <img src="../images/opt-start.gif" alt=
33 "[Option Start]" border="0"> asa</tt> <b>[</b><i>file</i><tt>...</tt><b>]</b> <tt><img src="../images/opt-end.gif" alt=
34 "[Option End]" border="0"></tt></code></div>
35 </blockquote>
36 <h4 class="mansect"><a name="tag_20_04_03" id="tag_20_04_03"></a>DESCRIPTION</h4>
37 <blockquote>
38 <p>The <i>asa</i> utility shall write its input files to standard output, mapping carriage-control characters from the text files
39 to line-printer control sequences in an implementation-defined manner.</p>
40 <p>The first character of every line shall be removed from the input, and the following actions are performed.</p>
41 <p>If the character removed is:</p>
42 <dl compact>
43 <dd></dd>
44 <dt><space></dt>
45 <dd>The rest of the line is output without change.</dd>
46 <dt>0</dt>
47 <dd>A <newline> is output, then the rest of the input line.</dd>
48 <dt>1</dt>
49 <dd>One or more implementation-defined characters that causes an advance to the next page shall be output, followed by the rest of
50 the input line.</dd>
51 <dt><tt>+</tt></dt>
52 <dd>The <newline> of the previous line shall be replaced with one or more implementation-defined characters that causes
53 printing to return to column position 1, followed by the rest of the input line. If the <tt>'+'</tt> is the first character in the
54 input, it shall be equivalent to <space>.</dd>
55 </dl>
56 <p>The action of the <i>asa</i> utility is unspecified upon encountering any character other than those listed above as the first
57 character in a line.</p>
58 </blockquote>
59 <h4 class="mansect"><a name="tag_20_04_04" id="tag_20_04_04"></a>OPTIONS</h4>
60 <blockquote>
61 <p>None.</p>
62 </blockquote>
63 <h4 class="mansect"><a name="tag_20_04_05" id="tag_20_04_05"></a>OPERANDS</h4>
64 <blockquote>
65 <dl compact>
66 <dd></dd>
67 <dt><i>file</i></dt>
68 <dd>A pathname of a text file used for input. If no <i>file</i> operands are specified, the standard input shall be used.</dd>
69 </dl>
70 </blockquote>
71 <h4 class="mansect"><a name="tag_20_04_06" id="tag_20_04_06"></a>STDIN</h4>
72 <blockquote>
73 <p>The standard input shall be used if no <i>file</i> operands are specified, and shall be used if a <i>file</i> operand is
74 <tt>'-'</tt> and the implementation treats the <tt>'-'</tt> as meaning standard input. Otherwise, the standard input shall not be
75 used. See the INPUT FILES section.</p>
76 </blockquote>
77 <h4 class="mansect"><a name="tag_20_04_07" id="tag_20_04_07"></a>INPUT FILES</h4>
78 <blockquote>
79 <p>The input files shall be text files.</p>
80 </blockquote>
81 <h4 class="mansect"><a name="tag_20_04_08" id="tag_20_04_08"></a>ENVIRONMENT VARIABLES</h4>
82 <blockquote>
83 <p>The following environment variables shall affect the execution of <i>asa</i>:</p>
84 <dl compact>
85 <dd></dd>
86 <dt><i>LANG</i></dt>
87 <dd>Provide a default value for the internationalization variables that are unset or null. (See XBD <a href=
88 "../basedefs/V1_chap08.html#tag_08_02"><i>8.2 Internationalization Variables</i></a> for the precedence of internationalization
89 variables used to determine the values of locale categories.)</dd>
90 <dt><i>LC_ALL</i></dt>
91 <dd>If set to a non-empty string value, override the values of all the other internationalization variables.</dd>
92 <dt><i>LC_CTYPE</i></dt>
93 <dd>Determine the locale for the interpretation of sequences of bytes of text data as characters (for example, single-byte as
94 opposed to multi-byte characters in arguments and input files).</dd>
95 <dt><i>LC_MESSAGES</i></dt>
96 <dd><br>
97 Determine the locale that should be used to affect the format and contents of diagnostic messages written to standard error.</dd>
98 <dt><i>NLSPATH</i></dt>
99 <dd><sup>[<a href="javascript:open_code('XSI')">XSI</a>]</sup> <img src="../images/opt-start.gif" alt="[Option Start]" border="0">
100 Determine the location of messages objects and message catalogs. <img src="../images/opt-end.gif" alt="[Option End]" border=
101 "0"></dd>
102 </dl>
103 </blockquote>
104 <h4 class="mansect"><a name="tag_20_04_09" id="tag_20_04_09"></a>ASYNCHRONOUS EVENTS</h4>
105 <blockquote>
106 <p>Default.</p>
107 </blockquote>
108 <h4 class="mansect"><a name="tag_20_04_10" id="tag_20_04_10"></a>STDOUT</h4>
109 <blockquote>
110 <p>The standard output shall be the text from the input file modified as described in the DESCRIPTION section.</p>
111 </blockquote>
112 <h4 class="mansect"><a name="tag_20_04_11" id="tag_20_04_11"></a>STDERR</h4>
113 <blockquote>
114 <p>None.</p>
115 </blockquote>
116 <h4 class="mansect"><a name="tag_20_04_12" id="tag_20_04_12"></a>OUTPUT FILES</h4>
117 <blockquote>
118 <p>None.</p>
119 </blockquote>
120 <h4 class="mansect"><a name="tag_20_04_13" id="tag_20_04_13"></a>EXTENDED DESCRIPTION</h4>
121 <blockquote>
122 <p>None.</p>
123 </blockquote>
124 <h4 class="mansect"><a name="tag_20_04_14" id="tag_20_04_14"></a>EXIT STATUS</h4>
125 <blockquote>
126 <p>The following exit values shall be returned:</p>
127 <dl compact>
128 <dd></dd>
129 <dt> 0</dt>
130 <dd>All input files were output successfully.</dd>
131 <dt>>0</dt>
132 <dd>An error occurred.</dd>
133 </dl>
134 </blockquote>
135 <h4 class="mansect"><a name="tag_20_04_15" id="tag_20_04_15"></a>CONSEQUENCES OF ERRORS</h4>
136 <blockquote>
137 <p>Default.</p>
138 </blockquote>
139 <hr>
140 <div class="box"><em>The following sections are informative.</em></div>
141 <h4 class="mansect"><a name="tag_20_04_16" id="tag_20_04_16"></a>APPLICATION USAGE</h4>
142 <blockquote>
143 <p>None.</p>
144 </blockquote>
145 <h4 class="mansect"><a name="tag_20_04_17" id="tag_20_04_17"></a>EXAMPLES</h4>
146 <blockquote>
147 <ol>
148 <li>
149 <p>The following command:</p>
150 <pre>
151 <tt>asa </tt><i>file</i><tt>
152 </tt></pre>
153 <p>permits the viewing of <i>file</i> (created by a program using FORTRAN-style carriage-control characters) on a terminal.</p>
154 </li>
155 <li>
156 <p>The following command:</p>
157 <pre>
158 <tt>a.out | asa | lp
159 </tt></pre>
160 <p>formats the FORTRAN output of <b>a.out</b> and directs it to the printer.</p>
161 </li>
162 </ol>
163 </blockquote>
164 <h4 class="mansect"><a name="tag_20_04_18" id="tag_20_04_18"></a>RATIONALE</h4>
165 <blockquote>
166 <p>The <i>asa</i> utility is needed to map "standard" FORTRAN 77 output into a form acceptable to contemporary printers. Usually,
167 <i>asa</i> is used to pipe data to the <a href="../utilities/lp.html"><i>lp</i></a> utility; see <a href=
168 "../utilities/lp.html"><i>lp</i></a>.</p>
169 <p>This utility is generally used only by FORTRAN programs. The standard developers decided to retain <i>asa</i> to avoid breaking
170 the historical large base of FORTRAN applications that put carriage-control characters in their output files. There is no
171 requirement that a system have a FORTRAN compiler in order to run applications that need <i>asa</i>.</p>
172 <p>Historical implementations have used an ASCII <form-feed> in response to a 1 and an ASCII <carriage-return> in
173 response to a <tt>'+'</tt>. It is suggested that implementations treat characters other than 0, 1, and <tt>'+'</tt> as
174 <space> in the absence of any compelling reason to do otherwise. However, the action is listed here as "unspecified",
175 permitting an implementation to provide extensions to access fast multiple-line slewing and channel seeking in a non-portable
176 manner.</p>
177 </blockquote>
178 <h4 class="mansect"><a name="tag_20_04_19" id="tag_20_04_19"></a>FUTURE DIRECTIONS</h4>
179 <blockquote>
180 <p>None.</p>
181 </blockquote>
182 <h4 class="mansect"><a name="tag_20_04_20" id="tag_20_04_20"></a>SEE ALSO</h4>
183 <blockquote>
184 <p><a href="../utilities/lp.html#"><i>lp</i></a></p>
185 <p>XBD <a href="../basedefs/V1_chap08.html#tag_08"><i>8. Environment Variables</i></a></p>
186 </blockquote>
187 <h4 class="mansect"><a name="tag_20_04_21" id="tag_20_04_21"></a>CHANGE HISTORY</h4>
188 <blockquote>
189 <p>First released in Issue 4.</p>
190 </blockquote>
191 <h4 class="mansect"><a name="tag_20_04_22" id="tag_20_04_22"></a>Issue 6</h4>
192 <blockquote>
193 <p>This utility is marked as part of the FORTRAN Runtime Utilities option.</p>
194 <p>The normative text is reworded to avoid use of the term "must" for application requirements.</p>
195 </blockquote>
196 <h4 class="mansect"><a name="tag_20_04_23" id="tag_20_04_23"></a>Issue 7</h4>
197 <blockquote>
198 <p>Austin Group Interpretation 1003.1-2001 #092 is applied.</p>
199 <p>SD5-XCU-ERN-97 is applied, updating the SYNOPSIS.</p>
200 </blockquote>
201 <h4 class="mansect"><a name="tag_20_04_24" id="tag_20_04_24"></a>Issue 8</h4>
202 <blockquote>
203 <p>Austin Group Defect 1122 is applied, changing the description of <i>NLSPATH .</i></p>
204 </blockquote>
205 <div class="box"><em>End of informative text.</em></div>
206 <hr>
207 <p> </p>
208 <a href="#top"><span class="topOfPage">return to top of page</span></a><br>
209 <hr size="2" noshade>
210 <center><font size="2">UNIX® is a registered Trademark of The Open Group.<br>
211 POSIX™ is a Trademark of The IEEE.<br>
212 Copyright © 2001-2024 The IEEE and The Open Group, All Rights Reserved<br>
213 [ <a href="../mindex.html">Main Index</a> | <a href="../basedefs/contents.html">XBD</a> | <a href=
214 "../functions/contents.html">XSH</a> | <a href="../utilities/contents.html">XCU</a> | <a href="../xrat/contents.html">XRAT</a>
215 ]</font></center>
216 <hr size="2" noshade>
217 <div class="NAVHEADER">
218 <table summary="Header navigation table" class="nav" width="100%" border="0" cellpadding="0" cellspacing="0">
219 <tr class="nav">
220 <td class="nav" width="15%" align="left" valign="bottom"><a href="../utilities/ar.html" accesskey="P"><<<
221 Previous</a></td>
222 <td class="nav" width="70%" align="center" valign="bottom"><a href="contents.html">Home</a></td>
223 <td class="nav" width="15%" align="right" valign="bottom"><a href="../utilities/at.html" accesskey="N">Next >>></a></td>
224 </tr>
225 </table>
226 <hr align="left" width="100%"></div>
227 </body>
228 </html>