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