git: a1b159bb3e78 - stable/14 - symlink.2: document EOPNOTSUPP

From: Michael Tuexen <tuexen_at_FreeBSD.org>
Date: Thu, 01 May 2025 19:01:26 UTC
The branch stable/14 has been updated by tuexen:

URL: https://cgit.FreeBSD.org/src/commit/?id=a1b159bb3e7892a51d54aeb699e2c6284924323a

commit a1b159bb3e7892a51d54aeb699e2c6284924323a
Author:     Michael Tuexen <tuexen@FreeBSD.org>
AuthorDate: 2025-04-14 22:03:19 +0000
Commit:     Michael Tuexen <tuexen@FreeBSD.org>
CommitDate: 2025-05-01 19:00:52 +0000

    symlink.2: document EOPNOTSUPP
    
    When the file system does not support symbolic links (like in the case
    of MSDOS), symlink() returns -1 and sets errno to EOPNOTSUPP.
    Document this behavior.
    
    Reviewed by:            glebius, markj
    Sponsored by:           Netflix, Inc.
    Differential Revision:  https://reviews.freebsd.org/D49803
    
    (cherry picked from commit dd9e59beebbb346f329dfd1de26a84da8afdcb1d)
---
 lib/libc/sys/symlink.2 | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/lib/libc/sys/symlink.2 b/lib/libc/sys/symlink.2
index bae615be5069..48d5cdeec11e 100644
--- a/lib/libc/sys/symlink.2
+++ b/lib/libc/sys/symlink.2
@@ -27,7 +27,7 @@
 .\"
 .\"     @(#)symlink.2	8.1 (Berkeley) 6/4/93
 .\"
-.Dd March 30, 2020
+.Dd April 15, 2025
 .Dt SYMLINK 2
 .Os
 .Sh NAME
@@ -94,6 +94,10 @@ or the entire length of either path name exceeded 1023 characters.
 A component of the
 .Fa name2
 path prefix does not exist.
+.It Bq Er EOPNOTSUPP
+The file system containing the file named by
+.Fa name2
+does not support symbolic links.
 .It Bq Er EACCES
 A component of the
 .Fa name2