From 998e0827e4f6a97880d7a71cf5877fc908cbd8d9 Mon Sep 17 00:00:00 2001 From: Jim Meyering Date: Wed, 5 Mar 2003 07:24:22 +0000 Subject: comments --- lib/save-cwd.c | 12 ++++++++++-- 1 file changed, 10 insertions(+), 2 deletions(-) diff --git a/lib/save-cwd.c b/lib/save-cwd.c index d7045b3e7..bd75ef745 100644 --- a/lib/save-cwd.c +++ b/lib/save-cwd.c @@ -15,7 +15,7 @@ along with this program; if not, write to the Free Software Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. */ -/* Written by Jim Meyering . */ +/* Written by Jim Meyering. */ #if HAVE_CONFIG_H # include "config.h" @@ -57,7 +57,15 @@ extern int errno; use free_cwd to perform the necessary free or close. Upon failure, no memory is allocated, any locally opened file descriptors are closed; return non-zero -- in that case, free_cwd need not be - called, but doing so is ok. Otherwise, return zero. */ + called, but doing so is ok. Otherwise, return zero. + + The `raison d'etre' for this interface is that some systems lack + support for fchdir, and getcwd is not robust or as efficient. + So, we prefer to use the open/fchdir approach, but fall back on + getcwd if necessary. Some systems lack fchdir altogether: OS/2, + Cygwin (as of March 2003), SCO Xenix. At least SunOS4 and Irix 5.3 + provide the function, yet it doesn't work for partitions on which + auditing is enabled. */ int save_cwd (struct saved_cwd *cwd) -- cgit v1.2.3-70-g09d2