Man Page perror.3f
NAME
perror, gerror, ierrno - get system error messages
DESCRIPTION
perror - write a message to FORTRAN logical unit 0
The message is for the last detected system error.
string is a character input argument.
It is written preceding the standard error message.
Example 1: perror:
...
CALL perror ( "file is for formated I/O" )
...
gerror - return system error message
string is a character output argument.
Example 2: gerror, used as a subroutine:
CHARACTER string*30
...
CALL gerror ( string )
WRITE(*,*) string
END
Example 3: gerror, used as a function; in this case,
string is not used:
CHARACTER gerror*30, z*30
...
z = gerror( )
WRITE(*,*) z
END
ierrno - return the error number of the last detected system
error
This number is updated only when an error actually
occurs. Most routines and I/O statements that might
generate such errors return an error code after the
call; that value is a more reliable indicator of what
caused the error condition.
Example 4: ierrno:
INTEGER ierrno, n
...
n = ierrno ( )
WRITE(*,*) n
END
FILES
libF77.a
SEE ALSO
intro(2), perror(3)
RESTRICTIONS
string in the call to perror cannot be longer than 127 char-
acters.
The length of the string returned by gerror is determined by
the calling program.
NOTES
If the error code is greater than or equal to 1000, it is a
f77 I/O error.
If the error code is less than 1000, it is a system error.
See intro(2).
The f77 I/O error codes and their meanings are:
1000 error in format
1001 illegal unit number
1002 formatted io not allowed
1003 unformatted io not allowed
1004 direct io not allowed
1005 sequential io not allowed
1006 can't backspace file
1007 off beginning of record
1008 can't stat file
1009 no * after repeat count
1010 off end of record
1011 <not used>
1012 incomprehensible list input
1013 out of free space
1014 unit not connected
1015 read unexpected character
1016 illegal logical input field
1017 'new' file exists
1018 can't find 'old' file
1019 unknown system error
1020 requires seek ability
1021 illegal argument
1022 negative repeat count
1023 illegal operation for unit
1024 <not used>
1025 incompatible specifiers in open
1026 illegal input for namelist
1027 error in FILEOPT parameter