See ChangeLog: Tue Dec 29 14:41:47 CET 1998 Werner Koch
[gnupg.git] / util / dotlock.c
1 /* dotlock.c - dotfile locking
2  *      Copyright (C) 1998 Free Software Foundation, Inc.
3  *
4  * This file is part of GnuPG.
5  *
6  * GnuPG is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License as published by
8  * the Free Software Foundation; either version 2 of the License, or
9  * (at your option) any later version.
10  *
11  * GnuPG is distributed in the hope that it will be useful,
12  * but WITHOUT ANY WARRANTY; without even the implied warranty of
13  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14  * GNU General Public License for more details.
15  *
16  * You should have received a copy of the GNU General Public License
17  * along with this program; if not, write to the Free Software
18  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA
19  */
20
21 #include <config.h>
22 #include <stdlib.h>
23 #include <string.h>
24 #include <errno.h>
25 #include <ctype.h>
26 #include <errno.h>
27 #include <unistd.h>
28 #include <sys/utsname.h>
29 #include <sys/types.h>
30 #include <sys/time.h>
31 #include <sys/stat.h>
32 #include <fcntl.h>
33 #include "types.h"
34 #include "util.h"
35 #include "memory.h"
36
37
38 static int read_lockfile( const char *name );
39
40 /****************
41  * Create a lockfile with the given name. A TIMEOUT of 0
42  * returns immediately, -1 waits forever (hopefully not), other
43  * values are timeouts in milliseconds.
44  * Returns: a char pointer used as handle for release lock
45  *          or NULL in case of an error.
46  *
47  * Notes: This function creates a lock file in the same directory
48  *        as file_to_lock with the name "file_to_lock.lock"
49  *        A temporary file ".#lk.<hostname>.pid[.threadid] is used.
50  *        This function does nothing for Windoze.
51  */
52 const char *
53 make_dotlock( const char *file_to_lock, long timeout )
54 {
55     int  fd=-1, pid;
56     char pidstr[16];
57     const char *handle = NULL;
58     char *lockname = NULL;
59     char *tname = NULL;
60     int have_tfile = 0;
61     struct utsname uts;
62     const char *dirpart;
63     int dirpartlen;
64
65     sprintf( pidstr, "%10d\n", getpid() );
66     /* fixme: add the hostname to the second line (FQDN or IP addr?) */
67
68     /* create a temporary file */
69   #if defined(SYS_NMLN) && SYS_NMLN < 8
70     #error Aiiih
71   #elif !defined(SYS_NMLN) && MAXHOSTNAMELEN < 8
72     /* (SunOS uses a structure of size MAXHOSTNAMELEN) */
73     #error Aiiih
74   #endif
75     if( uname( &uts ) )
76         strcpy( uts.nodename, "unknown" );
77
78     if( !(dirpart = strrchr( file_to_lock, '/' )) ) {
79         dirpart = ".";
80         dirpartlen = 1;
81     }
82     else {
83         dirpartlen = dirpart - file_to_lock;
84         dirpart = file_to_lock;
85     }
86
87   #ifdef _THREAD_SAFE
88     tname = m_alloc( dirpartlen + 6 + strlen(uts.nodename) + 11+ 20 );
89     sprintf( tname, "%.*s/.#lk.%s.%d.%p",
90                     dirpartlen, dirpart, uts.nodename, getpid(), &pid );
91   #else
92     tname = m_alloc( dirpartlen + 6 + strlen(uts.nodename) + 11 );
93     sprintf( tname, "%.*s/.#lk.%s.%d",
94                     dirpartlen, dirpart, uts.nodename, getpid() );
95   #endif
96     do {
97         errno = 0;
98         fd = open( tname, O_WRONLY|O_CREAT|O_EXCL,
99                           S_IRUSR|S_IRGRP|S_IROTH|S_IWUSR );
100     } while( fd == -1 && errno == EINTR );
101     if( fd == -1 ) {
102         log_error( "failed to create temporary file `%s': %s\n",
103                                               tname, strerror(errno));
104         goto leave;
105     }
106     have_tfile = 1;
107     if( write(fd, pidstr, 11 ) != 11 ) {
108         log_fatal( "error writing to `%s': %s\n", tname, strerror(errno) );
109         goto leave;
110     }
111     if( close(fd) ) {
112         log_error( "error closing `%s': %s\n", tname, strerror(errno));
113         goto leave;
114     }
115     fd = -1;
116
117     lockname = m_alloc( strlen(file_to_lock) + 6 );
118     strcpy(stpcpy(lockname, file_to_lock), ".lock");
119
120   retry:
121     if( !link(tname, lockname) ) {/* fixme: better use stat to check the link count */
122         handle = lockname;
123         lockname = NULL;
124     }
125     else if( errno == EEXIST ) {
126         if( (pid = read_lockfile(lockname)) == -1 ) {
127             if( errno == ENOENT ) {
128                 log_info( "lockfile disappeared\n");
129                 goto retry;
130             }
131             log_info("cannot read lockfile\n");
132         }
133         else if( pid == getpid() ) {
134             log_info( "Oops: lock already hold by us\n");
135             handle = lockname;
136             lockname = NULL;
137         }
138       #if 0 /* we should not do this without checking the permissions */
139             /* and the hostname */
140         else if( kill(pid, 0) && errno == ESRCH ) {
141             log_info( "removing stale lockfile (created by %d)", pid );
142             remove( lockname );
143             goto retry;
144         }
145       #endif
146         if( timeout == -1 ) {
147             struct timeval tv;
148             log_info( "waiting for lock (hold by %d) ...\n", pid );
149             /* can't use sleep, cause signals may be blocked */
150             tv.tv_sec = 1;
151             tv.tv_usec = 0;
152             select(0, NULL, NULL, NULL, &tv);
153             goto retry;
154         }
155         /* fixme: implement timeouts */
156     }
157     else
158         log_error( "lock not made: link() failed: %s\n", strerror(errno) );
159
160   leave:
161     if( fd != -1 )
162         close(fd);
163     if( have_tfile )
164         remove(tname);
165     m_free(tname);
166     m_free(lockname);
167     return handle;
168 }
169
170 /****************
171  * Create a lockfile for a existing file
172  * Returns: a char pointer used as handle for release lock
173  *          or NULL in case of an error.
174  *
175  * Notes: This function creates a lock file in the same directory
176  *        as file_to_lock with the name "lock.<inode-no>"
177  *
178  * int
179  * make_inodelock( const char *file_to_lock )
180  *
181  */
182
183
184
185
186 /****************
187  * release a lock
188  * Returns: 0 := success
189  */
190 int
191 release_dotlock( const char *lockfile )
192 {
193     int pid = read_lockfile( lockfile );
194     if( pid == -1 ) {
195         log_error( "release_dotlock: lockfile error");
196         return -1;
197     }
198     if( pid != getpid() ) {
199         log_error( "release_dotlock: not our lock (pid=%d)", pid);
200         return -1;
201     }
202     if( remove( lockfile ) ) {
203         log_error( "release_dotlock: error removing lockfile `%s'",
204                                                             lockfile);
205         return -1;
206     }
207     m_free( (char*)lockfile );
208     return 0;
209 }
210
211
212 /****************
213  * Read the lock file and return the pid, returns -1 on error.
214  */
215 static int
216 read_lockfile( const char *name )
217 {
218     int fd, pid;
219     char pidstr[16];
220
221     if( (fd = open(name, O_RDONLY)) == -1 ) {
222         int e = errno;
223         log_debug("error opening lockfile `%s': %s\n", name, strerror(errno) );
224         errno = e;
225         return -1;
226     }
227     if( read(fd, pidstr, 10 ) != 10 ) {
228         log_debug("error reading lockfile `%s'", name );
229         close(fd);
230         errno = 0;
231         return -1;
232     }
233     close(fd);
234     pid = atoi(pidstr);
235     if( !pid || pid == -1 ) {
236         log_error("invalid pid %d in lockfile `%s'", pid, name );
237         errno = 0;
238         return -1;
239     }
240     return pid;
241 }
242