summaryrefslogtreecommitdiff
path: root/lib/save-cwd.c
diff options
context:
space:
mode:
authorJim Meyering <jim@meyering.net>2003-03-05 07:24:22 +0000
committerJim Meyering <jim@meyering.net>2003-03-05 07:24:22 +0000
commit998e0827e4f6a97880d7a71cf5877fc908cbd8d9 (patch)
tree855bfa93a0f1170392f82921eedc46a3fa7700b5 /lib/save-cwd.c
parent6d53130e3579f1bb6f45dc57e385c00fcaa16d22 (diff)
downloadcoreutils-998e0827e4f6a97880d7a71cf5877fc908cbd8d9.tar.xz
comments
Diffstat (limited to 'lib/save-cwd.c')
-rw-r--r--lib/save-cwd.c12
1 files 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 <meyering@na-net.ornl.gov>. */
+/* 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)