logo

oasis-root

Compiled tree of Oasis Linux based on own branch at <https://hacktivis.me/git/oasis/> git clone https://anongit.hacktivis.me/git/oasis-root.git

asa.1p (6035B)


  1. '\" et
  2. .TH ASA "1P" 2017 "IEEE/The Open Group" "POSIX Programmer's Manual"
  3. .\"
  4. .SH PROLOG
  5. This manual page is part of the POSIX Programmer's Manual.
  6. The Linux implementation of this interface may differ (consult
  7. the corresponding Linux manual page for details of Linux behavior),
  8. or the interface may not be implemented on Linux.
  9. .\"
  10. .SH NAME
  11. asa
  12. \(em interpret carriage-control characters
  13. .SH SYNOPSIS
  14. .LP
  15. .nf
  16. asa \fB[\fIfile\fR...\fB]\fR
  17. .fi
  18. .SH DESCRIPTION
  19. The
  20. .IR asa
  21. utility shall write its input files to standard output, mapping
  22. carriage-control characters from the text files to line-printer control
  23. sequences in an implementation-defined manner.
  24. .P
  25. The first character of every line shall be removed from the input, and
  26. the following actions are performed.
  27. .P
  28. If the character removed is:
  29. .IP <space> 10
  30. The rest of the line is output without change.
  31. .IP 0 10
  32. A
  33. <newline>
  34. is output, then the rest of the input line.
  35. .IP 1 10
  36. One or more implementation-defined characters that causes an advance
  37. to the next page shall be output, followed by the rest of the input
  38. line.
  39. .IP "\fR+\fP" 10
  40. The
  41. <newline>
  42. of the previous line shall be replaced with one or more
  43. implementation-defined characters that causes printing to return to
  44. column position 1, followed by the rest of the input line. If the
  45. .BR '\(pl'
  46. is the first character in the input, it shall be equivalent to
  47. <space>.
  48. .P
  49. The action of the
  50. .IR asa
  51. utility is unspecified upon encountering any character other than those
  52. listed above as the first character in a line.
  53. .SH OPTIONS
  54. None.
  55. .SH OPERANDS
  56. .IP "\fIfile\fR" 10
  57. A pathname of a text file used for input. If no
  58. .IR file
  59. operands are specified, the standard input shall be used.
  60. .SH STDIN
  61. The standard input shall be used if no
  62. .IR file
  63. operands are specified, and shall be used if a
  64. .IR file
  65. operand is
  66. .BR '\-'
  67. and the implementation treats the
  68. .BR '\-'
  69. as meaning standard input.
  70. Otherwise, the standard input shall not be used.
  71. See the INPUT FILES section.
  72. .SH "INPUT FILES"
  73. The input files shall be text files.
  74. .SH "ENVIRONMENT VARIABLES"
  75. The following environment variables shall affect the execution of
  76. .IR asa :
  77. .IP "\fILANG\fP" 10
  78. Provide a default value for the internationalization variables that are
  79. unset or null. (See the Base Definitions volume of POSIX.1\(hy2017,
  80. .IR "Section 8.2" ", " "Internationalization Variables"
  81. for the precedence of internationalization variables used to determine
  82. the values of locale categories.)
  83. .IP "\fILC_ALL\fP" 10
  84. If set to a non-empty string value, override the values of all the
  85. other internationalization variables.
  86. .IP "\fILC_CTYPE\fP" 10
  87. Determine the locale for the interpretation of sequences of bytes of
  88. text data as characters (for example, single-byte as opposed to
  89. multi-byte characters in arguments and input files).
  90. .IP "\fILC_MESSAGES\fP" 10
  91. .br
  92. Determine the locale that should be used to affect the format and
  93. contents of diagnostic messages written to standard error.
  94. .IP "\fINLSPATH\fP" 10
  95. Determine the location of message catalogs for the processing of
  96. .IR LC_MESSAGES .
  97. .SH "ASYNCHRONOUS EVENTS"
  98. Default.
  99. .SH STDOUT
  100. The standard output shall be the text from the input file modified as
  101. described in the DESCRIPTION section.
  102. .SH STDERR
  103. None.
  104. .SH "OUTPUT FILES"
  105. None.
  106. .SH "EXTENDED DESCRIPTION"
  107. None.
  108. .SH "EXIT STATUS"
  109. The following exit values shall be returned:
  110. .IP "\00" 6
  111. All input files were output successfully.
  112. .IP >0 6
  113. An error occurred.
  114. .SH "CONSEQUENCES OF ERRORS"
  115. Default.
  116. .LP
  117. .IR "The following sections are informative."
  118. .SH "APPLICATION USAGE"
  119. None.
  120. .SH EXAMPLES
  121. .IP " 1." 4
  122. The following command:
  123. .RS 4
  124. .sp
  125. .RS 4
  126. .nf
  127. asa \fIfile\fR
  128. .fi
  129. .P
  130. .RE
  131. .P
  132. permits the viewing of
  133. .IR file
  134. (created by a program using FORTRAN-style carriage-control characters)
  135. on a terminal.
  136. .RE
  137. .IP " 2." 4
  138. The following command:
  139. .RS 4
  140. .sp
  141. .RS 4
  142. .nf
  143. a.out | asa | lp
  144. .fi
  145. .P
  146. .RE
  147. .P
  148. formats the FORTRAN output of
  149. .BR a.out
  150. and directs it to the printer.
  151. .RE
  152. .SH RATIONALE
  153. The
  154. .IR asa
  155. utility is needed to map ``standard'' FORTRAN 77 output into a form
  156. acceptable to contemporary printers. Usually,
  157. .IR asa
  158. is used to pipe data to the
  159. .IR lp
  160. utility; see
  161. .IR lp .
  162. .P
  163. This utility is generally used only by FORTRAN programs. The
  164. standard developers decided to retain
  165. .IR asa
  166. to avoid breaking the historical large base of FORTRAN applications
  167. that put carriage-control characters in their output files. There is no
  168. requirement that a system have a FORTRAN compiler in order to run
  169. applications that need
  170. .IR asa .
  171. .P
  172. Historical implementations have used an ASCII
  173. <form-feed>
  174. in response to a 1 and an ASCII
  175. <carriage-return>
  176. in response to a
  177. .BR '\(pl' .
  178. It is suggested that implementations treat characters other than 0, 1,
  179. and
  180. .BR '\(pl'
  181. as
  182. <space>
  183. in the absence of any compelling reason to do otherwise. However, the
  184. action is listed here as ``unspecified'', permitting an implementation
  185. to provide extensions to access fast multiple-line slewing and channel
  186. seeking in a non-portable manner.
  187. .SH "FUTURE DIRECTIONS"
  188. None.
  189. .SH "SEE ALSO"
  190. .IR "\fIfort77\fR\^",
  191. .IR "\fIlp\fR\^"
  192. .P
  193. The Base Definitions volume of POSIX.1\(hy2017,
  194. .IR "Chapter 8" ", " "Environment Variables"
  195. .\"
  196. .SH COPYRIGHT
  197. Portions of this text are reprinted and reproduced in electronic form
  198. from IEEE Std 1003.1-2017, Standard for Information Technology
  199. -- Portable Operating System Interface (POSIX), The Open Group Base
  200. Specifications Issue 7, 2018 Edition,
  201. Copyright (C) 2018 by the Institute of
  202. Electrical and Electronics Engineers, Inc and The Open Group.
  203. In the event of any discrepancy between this version and the original IEEE and
  204. The Open Group Standard, the original IEEE and The Open Group Standard
  205. is the referee document. The original Standard can be obtained online at
  206. http://www.opengroup.org/unix/online.html .
  207. .PP
  208. Any typographical or formatting errors that appear
  209. in this page are most likely
  210. to have been introduced during the conversion of the source files to
  211. man page format. To report such errors, see
  212. https://www.kernel.org/doc/man-pages/reporting_bugs.html .