]> git.cworth.org Git - tar/blob - gnu/save-cwd.c
6cb3c36bbe8dc7b71d01d42f8ade5652b93f59af
[tar] / gnu / save-cwd.c
1 /* -*- buffer-read-only: t -*- vi: set ro: */
2 /* DO NOT EDIT! GENERATED AUTOMATICALLY! */
3 /* save-cwd.c -- Save and restore current working directory.
4
5    Copyright (C) 1995, 1997-1998, 2003-2006, 2009-2010 Free Software
6    Foundation, Inc.
7
8    This program is free software: you can redistribute it and/or modify
9    it under the terms of the GNU General Public License as published by
10    the Free Software Foundation; either version 3 of the License, or
11    (at your option) any later version.
12
13    This program is distributed in the hope that it will be useful,
14    but WITHOUT ANY WARRANTY; without even the implied warranty of
15    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
16    GNU General Public License for more details.
17
18    You should have received a copy of the GNU General Public License
19    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
20
21 /* Written by Jim Meyering.  */
22
23 #include <config.h>
24
25 #include "save-cwd.h"
26
27 #include <errno.h>
28 #include <fcntl.h>
29 #include <stdbool.h>
30 #include <stdio.h>
31 #include <stdlib.h>
32
33 #include "chdir-long.h"
34 #include "unistd--.h"
35 #include "xgetcwd.h"
36
37 #if GNULIB_FCNTL_SAFER
38 # include "fcntl--.h"
39 #else
40 # define GNULIB_FCNTL_SAFER 0
41 #endif
42
43 /* On systems without the fchdir function (WOE), pretend that open
44    always returns -1 so that save_cwd resorts to using xgetcwd.
45    Since chdir_long requires fchdir, use chdir instead.  */
46 #if !HAVE_FCHDIR
47 # undef open
48 # define open(File, Flags) (-1)
49 # undef fchdir
50 # define fchdir(Fd) (abort (), -1)
51 # undef chdir_long
52 # define chdir_long(Dir) chdir (Dir)
53 #endif
54
55 /* Record the location of the current working directory in CWD so that
56    the program may change to other directories and later use restore_cwd
57    to return to the recorded location.  This function may allocate
58    space using malloc (via xgetcwd) or leave a file descriptor open;
59    use free_cwd to perform the necessary free or close.  Upon failure,
60    no memory is allocated, any locally opened file descriptors are
61    closed;  return non-zero -- in that case, free_cwd need not be
62    called, but doing so is ok.  Otherwise, return zero.
63
64    The `raison d'etre' for this interface is that the working directory
65    is sometimes inaccessible, and getcwd is not robust or as efficient.
66    So, we prefer to use the open/fchdir approach, but fall back on
67    getcwd if necessary.
68
69    Some systems lack fchdir altogether: e.g., OS/2, pre-2001 Cygwin,
70    SCO Xenix.  Also, SunOS 4 and Irix 5.3 provide the function, yet it
71    doesn't work for partitions on which auditing is enabled.  If
72    you're still using an obsolete system with these problems, please
73    send email to the maintainer of this code.  */
74
75 int
76 save_cwd (struct saved_cwd *cwd)
77 {
78   cwd->name = NULL;
79
80   cwd->desc = open (".", O_RDONLY);
81   if (!GNULIB_FCNTL_SAFER)
82     cwd->desc = fd_safer (cwd->desc);
83   if (cwd->desc < 0)
84     {
85       cwd->name = xgetcwd ();
86       return cwd->name ? 0 : -1;
87     }
88
89   return 0;
90 }
91
92 /* Change to recorded location, CWD, in directory hierarchy.
93    Upon failure, return -1 (errno is set by chdir or fchdir).
94    Upon success, return zero.  */
95
96 int
97 restore_cwd (const struct saved_cwd *cwd)
98 {
99   if (0 <= cwd->desc)
100     return fchdir (cwd->desc);
101   else
102     return chdir_long (cwd->name);
103 }
104
105 void
106 free_cwd (struct saved_cwd *cwd)
107 {
108   if (cwd->desc >= 0)
109     close (cwd->desc);
110   free (cwd->name);
111 }