|
|
1.1 root 1: .TH PERROR 3F "13 June 1983"
2: .UC 4
3: .SH NAME
4: perror, gerror, ierrno \- get system error messages
5: .SH SYNOPSIS
6: .B subroutine perror (string)
7: .br
8: .B character*(*) string
9: .sp 1
10: .B subroutine gerror (string)
11: .br
12: .B character*(*) string
13: .sp 1
14: .B character*(*) function gerror()
15: .sp 1
16: .B function ierrno()
17: .SH DESCRIPTION
18: .I Perror
19: will write a message to fortran logical unit 0
20: appropriate to the last detected system error.
21: .I String
22: will be written preceding the standard error message.
23: .PP
24: .I Gerror
25: returns the system error message in character variable
26: .I string.
27: .I Gerror
28: may be called either as a subroutine or as a function.
29: .PP
30: .I Ierrno
31: will return the error number of the last detected system error.
32: This number is updated only when an error actually occurs.
33: Most routines and I/O statements that might generate such errors
34: return an error code after the call;
35: that value is a more reliable indicator of what caused the error condition.
36: .SH FILES
37: .ie \nM /usr/ucb/lib/libU77.a
38: .el /usr/lib/libU77.a
39: .SH "SEE ALSO"
40: intro(2), perror(3)
41: .br
42: D. L. Wasley, \fIIntroduction to the f77 I/O Library\fR
43: .SH BUGS
44: .I String
45: in the call to
46: .I perror
47: can be no longer than 127 characters.
48: .PP
49: The length of the string returned by
50: .I gerror
51: is determined by the calling program.
52: .SH NOTES
53: UNIX system error codes are described in
54: .IR intro (2).
55: The f77 I/O error codes and their meanings are:
56: .sp 1
57: .in +5
58: 100 ``error in format''
59: .br
60: 101 ``illegal unit number''
61: .br
62: 102 ``formatted io not allowed''
63: .br
64: 103 ``unformatted io not allowed''
65: .br
66: 104 ``direct io not allowed''
67: .br
68: 105 ``sequential io not allowed''
69: .br
70: 106 ``can't backspace file''
71: .br
72: 107 ``off beginning of record''
73: .br
74: 108 ``can't stat file''
75: .br
76: 109 ``no * after repeat count''
77: .br
78: 110 ``off end of record''
79: .br
80: 111 ``truncation failed''
81: .br
82: 112 ``incomprehensible list input''
83: .br
84: 113 ``out of free space''
85: .br
86: 114 ``unit not connected''
87: .br
88: 115 ``read unexpected character''
89: .br
90: 116 ``blank logical input field''
91: .br
92: 117 ``'new' file exists''
93: .br
94: 118 ``can't find 'old' file''
95: .br
96: 119 ``unknown system error''
97: .br
98: 120 ``requires seek ability''
99: .br
100: 121 ``illegal argument''
101: .br
102: 122 ``negative repeat count''
103: .br
104: 123 ``illegal operation for unit''
This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.