https://sourceware.org/git/gitweb.cgi?p=newlib-cygwin.git;h=2caaa810a39075cbf0eb857459a2eef95bf4463f
commit 2caaa810a39075cbf0eb857459a2eef95bf4463f
Author: Corinna Vinschen <cori...@vinschen.de>
Date: Tue Jan 28 16:10:13 2020 +0100
Cygwin: add short comments to path_conv options
Signed-off-by: Corinna Vinschen <cori...@vinschen.de>
Diff:
---
winsup/cygwin/path.h | 25 +++++++++++++------------
1 file changed, 13 insertions(+), 12 deletions(-)
diff --git a/winsup/cygwin/path.h b/winsup/cygwin/path.h
index e76157b..72f4bda 100644
--- a/winsup/cygwin/path.h
+++ b/winsup/cygwin/path.h
@@ -44,20 +44,21 @@ extern suffix_info stat_suffixes[];
below path_types. Ever. */
enum pathconv_arg
{
- PC_SYM_FOLLOW = _BIT ( 0),
- PC_SYM_NOFOLLOW = _BIT ( 1),
- PC_SYM_NOFOLLOW_REP = _BIT ( 2),
- PC_SYM_CONTENTS = _BIT ( 3),
- PC_NOFULL = _BIT ( 4),
- PC_NULLEMPTY = _BIT ( 5),
- PC_NONULLEMPTY = _BIT ( 6),
- PC_POSIX = _BIT ( 7),
- PC_NOWARN = _BIT ( 8),
+ PC_SYM_FOLLOW = _BIT ( 0), /* follow symlinks */
+ PC_SYM_NOFOLLOW = _BIT ( 1), /* don't follow symlinks (but honor
+ trailing slashes) */
+ PC_SYM_NOFOLLOW_REP = _BIT ( 2), /* don't follow dir reparse point */
+ PC_SYM_CONTENTS = _BIT ( 3), /* don't follow, return content only */
+ PC_NOFULL = _BIT ( 4), /* keep relative path */
+ PC_NULLEMPTY = _BIT ( 5), /* empty path is no error */
+ PC_NONULLEMPTY = _BIT ( 6), /* override PC_NULLEMPTY default */
+ PC_POSIX = _BIT ( 7), /* return normalized posix path */
+ PC_NOWARN = _BIT ( 8), /* don't emit ms-dos path warning */
PC_OPEN = _BIT ( 9), /* use open semantics */
PC_CTTY = _BIT (10), /* could later be used as ctty */
- PC_SYM_NOFOLLOW_PROCFD = _BIT (11),
- PC_KEEP_HANDLE = _BIT (12),
- PC_NO_ACCESS_CHECK = _BIT (13),
+ PC_SYM_NOFOLLOW_PROCFD = _BIT (11), /* allow /proc/PID/fd redirection */
+ PC_KEEP_HANDLE = _BIT (12), /* keep handle for later stat calls */
+ PC_NO_ACCESS_CHECK = _BIT (13), /* helper flag for error check */
PC_DONT_USE = _BIT (31) /* conversion to signed happens. */
};
