doc: fix 'git status --help' character quoting
[git/git-svn.git] / lockfile.c
blob2564a7f5447b904585f629f0d1233c8a59483a40
1 /*
2 * Copyright (c) 2005, Junio C Hamano
3 */
4 #include "cache.h"
5 #include "sigchain.h"
7 static struct lock_file *lock_file_list;
9 static void remove_lock_file(void)
11 pid_t me = getpid();
13 while (lock_file_list) {
14 if (lock_file_list->owner == me &&
15 lock_file_list->filename[0]) {
16 if (lock_file_list->fd >= 0)
17 close(lock_file_list->fd);
18 unlink_or_warn(lock_file_list->filename);
20 lock_file_list = lock_file_list->next;
24 static void remove_lock_file_on_signal(int signo)
26 remove_lock_file();
27 sigchain_pop(signo);
28 raise(signo);
32 * p = absolute or relative path name
34 * Return a pointer into p showing the beginning of the last path name
35 * element. If p is empty or the root directory ("/"), just return p.
37 static char *last_path_elm(char *p)
39 /* r starts pointing to null at the end of the string */
40 char *r = strchr(p, '\0');
42 if (r == p)
43 return p; /* just return empty string */
45 r--; /* back up to last non-null character */
47 /* back up past trailing slashes, if any */
48 while (r > p && *r == '/')
49 r--;
52 * then go backwards until I hit a slash, or the beginning of
53 * the string
55 while (r > p && *(r-1) != '/')
56 r--;
57 return r;
61 /* We allow "recursive" symbolic links. Only within reason, though */
62 #define MAXDEPTH 5
65 * p = path that may be a symlink
66 * s = full size of p
68 * If p is a symlink, attempt to overwrite p with a path to the real
69 * file or directory (which may or may not exist), following a chain of
70 * symlinks if necessary. Otherwise, leave p unmodified.
72 * This is a best-effort routine. If an error occurs, p will either be
73 * left unmodified or will name a different symlink in a symlink chain
74 * that started with p's initial contents.
76 * Always returns p.
79 static char *resolve_symlink(char *p, size_t s)
81 int depth = MAXDEPTH;
83 while (depth--) {
84 char link[PATH_MAX];
85 int link_len = readlink(p, link, sizeof(link));
86 if (link_len < 0) {
87 /* not a symlink anymore */
88 return p;
90 else if (link_len < sizeof(link))
91 /* readlink() never null-terminates */
92 link[link_len] = '\0';
93 else {
94 warning("%s: symlink too long", p);
95 return p;
98 if (is_absolute_path(link)) {
99 /* absolute path simply replaces p */
100 if (link_len < s)
101 strcpy(p, link);
102 else {
103 warning("%s: symlink too long", p);
104 return p;
106 } else {
108 * link is a relative path, so I must replace the
109 * last element of p with it.
111 char *r = (char *)last_path_elm(p);
112 if (r - p + link_len < s)
113 strcpy(r, link);
114 else {
115 warning("%s: symlink too long", p);
116 return p;
120 return p;
123 /* Make sure errno contains a meaningful value on error */
124 static int lock_file(struct lock_file *lk, const char *path, int flags)
127 * subtract 5 from size to make sure there's room for adding
128 * ".lock" for the lock file name
130 static const size_t max_path_len = sizeof(lk->filename) - 5;
132 if (strlen(path) >= max_path_len) {
133 errno = ENAMETOOLONG;
134 return -1;
136 strcpy(lk->filename, path);
137 if (!(flags & LOCK_NODEREF))
138 resolve_symlink(lk->filename, max_path_len);
139 strcat(lk->filename, ".lock");
140 lk->fd = open(lk->filename, O_RDWR | O_CREAT | O_EXCL, 0666);
141 if (0 <= lk->fd) {
142 if (!lock_file_list) {
143 sigchain_push_common(remove_lock_file_on_signal);
144 atexit(remove_lock_file);
146 lk->owner = getpid();
147 if (!lk->on_list) {
148 lk->next = lock_file_list;
149 lock_file_list = lk;
150 lk->on_list = 1;
152 if (adjust_shared_perm(lk->filename)) {
153 int save_errno = errno;
154 error("cannot fix permission bits on %s",
155 lk->filename);
156 errno = save_errno;
157 return -1;
160 else
161 lk->filename[0] = 0;
162 return lk->fd;
165 void unable_to_lock_message(const char *path, int err, struct strbuf *buf)
167 if (err == EEXIST) {
168 strbuf_addf(buf, "Unable to create '%s.lock': %s.\n\n"
169 "If no other git process is currently running, this probably means a\n"
170 "git process crashed in this repository earlier. Make sure no other git\n"
171 "process is running and remove the file manually to continue.",
172 absolute_path(path), strerror(err));
173 } else
174 strbuf_addf(buf, "Unable to create '%s.lock': %s",
175 absolute_path(path), strerror(err));
178 int unable_to_lock_error(const char *path, int err)
180 struct strbuf buf = STRBUF_INIT;
182 unable_to_lock_message(path, err, &buf);
183 error("%s", buf.buf);
184 strbuf_release(&buf);
185 return -1;
188 NORETURN void unable_to_lock_index_die(const char *path, int err)
190 struct strbuf buf = STRBUF_INIT;
192 unable_to_lock_message(path, err, &buf);
193 die("%s", buf.buf);
196 /* This should return a meaningful errno on failure */
197 int hold_lock_file_for_update(struct lock_file *lk, const char *path, int flags)
199 int fd = lock_file(lk, path, flags);
200 if (fd < 0 && (flags & LOCK_DIE_ON_ERROR))
201 unable_to_lock_index_die(path, errno);
202 return fd;
205 int hold_lock_file_for_append(struct lock_file *lk, const char *path, int flags)
207 int fd, orig_fd;
209 fd = lock_file(lk, path, flags);
210 if (fd < 0) {
211 if (flags & LOCK_DIE_ON_ERROR)
212 unable_to_lock_index_die(path, errno);
213 return fd;
216 orig_fd = open(path, O_RDONLY);
217 if (orig_fd < 0) {
218 if (errno != ENOENT) {
219 if (flags & LOCK_DIE_ON_ERROR)
220 die("cannot open '%s' for copying", path);
221 close(fd);
222 return error("cannot open '%s' for copying", path);
224 } else if (copy_fd(orig_fd, fd)) {
225 if (flags & LOCK_DIE_ON_ERROR)
226 exit(128);
227 close(fd);
228 return -1;
230 return fd;
233 int close_lock_file(struct lock_file *lk)
235 int fd = lk->fd;
236 lk->fd = -1;
237 return close(fd);
240 int commit_lock_file(struct lock_file *lk)
242 char result_file[PATH_MAX];
243 size_t i;
244 if (lk->fd >= 0 && close_lock_file(lk))
245 return -1;
246 strcpy(result_file, lk->filename);
247 i = strlen(result_file) - 5; /* .lock */
248 result_file[i] = 0;
249 if (rename(lk->filename, result_file))
250 return -1;
251 lk->filename[0] = 0;
252 return 0;
255 int hold_locked_index(struct lock_file *lk, int die_on_error)
257 return hold_lock_file_for_update(lk, get_index_file(),
258 die_on_error
259 ? LOCK_DIE_ON_ERROR
260 : 0);
263 void rollback_lock_file(struct lock_file *lk)
265 if (lk->filename[0]) {
266 if (lk->fd >= 0)
267 close(lk->fd);
268 unlink_or_warn(lk->filename);
270 lk->filename[0] = 0;