aboutsummaryrefslogtreecommitdiff
path: root/gcc/fortran/gfortran.texi
diff options
context:
space:
mode:
authorfxcoudert <fxcoudert@138bc75d-0d04-0410-961f-82ee72b054a4>2015-08-16 12:47:15 +0000
committerfxcoudert <fxcoudert@138bc75d-0d04-0410-961f-82ee72b054a4>2015-08-16 12:47:15 +0000
commit9be7a73d6b1ddad9470ebe8185ce0b6360209359 (patch)
tree52f15c7271e59ee899d292f93267112ed4ade3b7 /gcc/fortran/gfortran.texi
parent2b8d68a94f8fe45eaec9fa00bf6774f6d04bc322 (diff)
PR fortran/41387
* gfortran.texi: New section "File operations on symbolic links". git-svn-id: svn+ssh://gcc.gnu.org/svn/gcc/trunk@226923 138bc75d-0d04-0410-961f-82ee72b054a4
Diffstat (limited to 'gcc/fortran/gfortran.texi')
-rw-r--r--gcc/fortran/gfortran.texi28
1 files changed, 28 insertions, 0 deletions
diff --git a/gcc/fortran/gfortran.texi b/gcc/fortran/gfortran.texi
index a06c5fc4246..e15d6e6605b 100644
--- a/gcc/fortran/gfortran.texi
+++ b/gcc/fortran/gfortran.texi
@@ -1140,6 +1140,7 @@ might in some way or another become visible to the programmer.
* Thread-safety of the runtime library::
* Data consistency and durability::
* Files opened without an explicit ACTION= specifier::
+* File operations on symbolic links::
@end menu
@@ -1345,6 +1346,33 @@ processor dependent. GNU Fortran behaves as follows:
@end enumerate
+@node File operations on symbolic links
+@section File operations on symbolic links
+@cindex file, symbolic link
+
+This section documents the behavior of GNU Fortran for file operations on
+symbolic links, on systems that support them.
+
+@itemize
+
+@item Results of INQUIRE statements of the ``inquire by file'' form will
+relate to the target of the symbolic link. For example,
+@code{INQUIRE(FILE="foo",EXIST=ex)} will set @var{ex} to @var{.true.} if
+@var{foo} is a symbolic link pointing to an existing file, and @var{.false.}
+if @var{foo} points to an non-existing file (``dangling'' symbolic link).
+
+@item Using the @code{OPEN} statement with a @code{STATUS="NEW"} specifier
+on a symbolic link will result in an error condition, whether the symbolic
+link points to an existing target or is dangling.
+
+@item If a symbolic link was connected, using the @code{CLOSE} statement
+with a @code{STATUS="DELETE"} specifier will cause the symbolic link itself
+to be deleted, not its target.
+
+@end itemize
+
+
+
@c ---------------------------------------------------------------------
@c Extensions
@c ---------------------------------------------------------------------