chiark / gitweb /
Abolish some trivial tests and fold them into dbversion.py; the setup
[disorder] / server / trackdb.c
1 /*
2  * This file is part of DisOrder
3  * Copyright (C) 2005, 2006, 2007 Richard Kettlewell
4  *
5  * This program is free software; you can redistribute it and/or modify
6  * it under the terms of the GNU General Public License as published by
7  * the Free Software Foundation; either version 2 of the License, or
8  * (at your option) any later version.
9  *
10  * This program is distributed in the hope that it will be useful, but
11  * WITHOUT ANY WARRANTY; without even the implied warranty of
12  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
13  * General Public License for more details.
14  *
15  * You should have received a copy of the GNU General Public License
16  * along with this program; if not, write to the Free Software
17  * Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307
18  * USA
19  */
20 /** @file server/trackdb.c
21  * @brief Track database */
22
23 #include <config.h>
24 #include "types.h"
25
26 #include <string.h>
27 #include <stdio.h>
28 #include <db.h>
29 #include <sys/socket.h>
30 #include <pcre.h>
31 #include <assert.h>
32 #include <unistd.h>
33 #include <errno.h>
34 #include <stddef.h>
35 #include <sys/time.h>
36 #include <sys/resource.h>
37 #include <time.h>
38 #include <arpa/inet.h>
39 #include <sys/wait.h>
40
41 #include "event.h"
42 #include "mem.h"
43 #include "kvp.h"
44 #include "log.h"
45 #include "vector.h"
46 #include "trackdb.h"
47 #include "configuration.h"
48 #include "syscalls.h"
49 #include "wstat.h"
50 #include "printf.h"
51 #include "filepart.h"
52 #include "trackname.h"
53 #include "trackdb-int.h"
54 #include "logfd.h"
55 #include "cache.h"
56 #include "eventlog.h"
57 #include "hash.h"
58 #include "unicode.h"
59 #include "unidata.h"
60
61 #define RESCAN "disorder-rescan"
62 #define DEADLOCK "disorder-deadlock"
63
64 static const char *getpart(const char *track,
65                            const char *context,
66                            const char *part,
67                            const struct kvp *p,
68                            int *used_db);
69 static int trackdb_alltags_tid(DB_TXN *tid, char ***taglistp);
70 static char **trackdb_new_tid(int *ntracksp,
71                               int maxtracks,
72                               DB_TXN *tid);
73 static int trackdb_expire_noticed_tid(time_t earliest, DB_TXN *tid);
74
75 const struct cache_type cache_files_type = { 86400 };
76 unsigned long cache_files_hits, cache_files_misses;
77
78 /** @brief Set by trackdb_open() */
79 int trackdb_existing_database;
80
81 /* setup and teardown ********************************************************/
82
83 static const char *home;                /* home had better not change */
84 DB_ENV *trackdb_env;                    /* db environment */
85
86 /** @brief The tracks database
87  * - Keys are UTF-8(NFC(unicode(path name)))
88  * - Values are encoded key-value pairs
89  * - Data is reconstructable data about tracks that currently exist
90  */
91 DB *trackdb_tracksdb;
92
93 /** @brief The preferences database
94  *
95  * - Keys are UTF-8(NFC(unicode(path name)))
96  * - Values are encoded key-value pairs
97  * - Data is user data about tracks (that might not exist any more)
98  * and cannot be reconstructed
99  */
100 DB *trackdb_prefsdb;
101
102 /** @brief The search database
103  *
104  * - Keys are UTF-8(NFKC(casefold(search term)))
105  * - Values are UTF-8(NFC(unicode(path name)))
106  * - There can be more than one value per key
107  * - Presence of key,value means that path matches the search terms
108  * - Only tracks fond in @ref tracks_tracksdb are represented here
109  * - This database can be reconstructed, it contains no user data
110  */
111 DB *trackdb_searchdb;
112
113 /** @brief The tags database
114  *
115  * - Keys are UTF-8(NFKC(casefold(tag)))
116  * - Values are UTF-8(NFC(unicode(path name)))
117  * - There can be more than one value per key
118  * - Presence of key,value means that path matches the tag
119  * - This is always in sync with the tags preference
120  * - This database can be reconstructed, it contains no user data
121  */
122 DB *trackdb_tagsdb;                     /* the tags database */
123
124 /** @brief The global preferences database
125  * - Keys are UTF-8(NFC(preference))
126  * - Values are global preference values
127  * - Data is user data and cannot be reconstructed
128  */
129 DB *trackdb_globaldb;                   /* global preferences */
130
131 /** @brief The noticed database
132  * - Keys are 64-bit big-endian timestamps
133  * - Values are UTF-8(NFC(unicode(path name)))
134  * - There can be more than one value per key
135  * - Presence of key,value means that path was added at the given time
136  * - Data cannot be reconstructed (but isn't THAT important)
137  */
138 DB *trackdb_noticeddb;                   /* when track noticed */
139 static pid_t db_deadlock_pid = -1;      /* deadlock manager PID */
140 static pid_t rescan_pid = -1;           /* rescanner PID */
141 static int initialized, opened;         /* state */
142
143 /* tracks matched by required_tags */
144 static char **reqtracks;
145 static size_t nreqtracks;
146
147 /* comparison function for keys */
148 static int compare(DB attribute((unused)) *db_,
149                    const DBT *a, const DBT *b) {
150   return compare_path_raw(a->data, a->size, b->data, b->size);
151 }
152
153 /** @brief Open database environment
154  * @param flags Flags word
155  *
156  * Flags should be one of:
157  * - @ref TRACKDB_NO_RECOVER
158  * - @ref TRACKDB_NORMAL_RECOVER
159  * - @ref TRACKDB_FATAL_RECOVER
160  */
161 void trackdb_init(int flags) {
162   int err;
163   const int recover = flags & TRACKDB_RECOVER_MASK;
164   static int recover_type[] = { 0, DB_RECOVER, DB_RECOVER_FATAL };
165
166   /* sanity checks */
167   assert(initialized == 0);
168   ++initialized;
169   if(home) {
170     if(strcmp(home, config->home))
171       fatal(0, "cannot change db home without server restart");
172     home = config->home;
173   }
174
175   /* create environment */
176   if((err = db_env_create(&trackdb_env, 0))) fatal(0, "db_env_create: %s",
177                                                    db_strerror(err));
178   if((err = trackdb_env->set_alloc(trackdb_env,
179                                    xmalloc_noptr, xrealloc_noptr, xfree)))
180     fatal(0, "trackdb_env->set_alloc: %s", db_strerror(err));
181   if((err = trackdb_env->set_lk_max_locks(trackdb_env, 10000)))
182     fatal(0, "trackdb_env->set_lk_max_locks: %s", db_strerror(err));
183   if((err = trackdb_env->set_lk_max_objects(trackdb_env, 10000)))
184     fatal(0, "trackdb_env->set_lk_max_objects: %s", db_strerror(err));
185   if((err = trackdb_env->open(trackdb_env, config->home,
186                               DB_INIT_LOG
187                               |DB_INIT_LOCK
188                               |DB_INIT_MPOOL
189                               |DB_INIT_TXN
190                               |DB_CREATE
191                               |recover_type[recover],
192                               0666)))
193     fatal(0, "trackdb_env->open %s: %s", config->home, db_strerror(err));
194   trackdb_env->set_errpfx(trackdb_env, "DB");
195   trackdb_env->set_errfile(trackdb_env, stderr);
196   trackdb_env->set_verbose(trackdb_env, DB_VERB_DEADLOCK, 1);
197   trackdb_env->set_verbose(trackdb_env, DB_VERB_RECOVERY, 1);
198   trackdb_env->set_verbose(trackdb_env, DB_VERB_REPLICATION, 1);
199   D(("initialized database environment"));
200 }
201
202 /* called when deadlock manager terminates */
203 static int reap_db_deadlock(ev_source attribute((unused)) *ev,
204                             pid_t attribute((unused)) pid,
205                             int status,
206                             const struct rusage attribute((unused)) *rusage,
207                             void attribute((unused)) *u) {
208   db_deadlock_pid = -1;
209   if(initialized)
210     fatal(0, "deadlock manager unexpectedly terminated: %s",
211           wstat(status));
212   else
213     D(("deadlock manager terminated: %s", wstat(status)));
214   return 0;
215 }
216
217 static pid_t subprogram(ev_source *ev, const char *prog,
218                         int outputfd) {
219   pid_t pid;
220
221   /* If we're in the background then trap subprocess stdout/stderr */
222   if(!(pid = xfork())) {
223     exitfn = _exit;
224     if(ev)
225       ev_signal_atfork(ev);
226     signal(SIGPIPE, SIG_DFL);
227     if(outputfd != -1) {
228       xdup2(outputfd, 1);
229       xclose(outputfd);
230     }
231     /* If we were negatively niced, undo it.  We don't bother checking for
232      * error, it's not that important. */
233     setpriority(PRIO_PROCESS, 0, 0);
234     execlp(prog, prog, "--config", configfile,
235            debugging ? "--debug" : "--no-debug",
236            log_default == &log_syslog ? "--syslog" : "--no-syslog",
237            (char *)0);
238     fatal(errno, "error invoking %s", prog);
239   }
240   return pid;
241 }
242
243 /* start deadlock manager */
244 void trackdb_master(ev_source *ev) {
245   assert(db_deadlock_pid == -1);
246   db_deadlock_pid = subprogram(ev, DEADLOCK, -1);
247   ev_child(ev, db_deadlock_pid, 0, reap_db_deadlock, 0);
248   D(("started deadlock manager"));
249 }
250
251 /* close environment */
252 void trackdb_deinit(void) {
253   int err;
254
255   /* sanity checks */
256   assert(initialized == 1);
257   --initialized;
258
259   /* close the environment */
260   if((err = trackdb_env->close(trackdb_env, 0)))
261     fatal(0, "trackdb_env->close: %s", db_strerror(err));
262
263   if(rescan_pid != -1 && kill(rescan_pid, SIGTERM) < 0)
264     fatal(errno, "error killing rescanner");
265
266   /* terminate the deadlock manager */
267   if(db_deadlock_pid != -1 && kill(db_deadlock_pid, SIGTERM) < 0)
268     fatal(errno, "error killing deadlock manager");
269   db_deadlock_pid = -1;
270
271   D(("deinitialized database environment"));
272 }
273
274 /* open a specific database */
275 static DB *open_db(const char *path,
276                    u_int32_t dbflags,
277                    DBTYPE dbtype,
278                    u_int32_t openflags,
279                    int mode) {
280   int err;
281   DB *db;
282
283   D(("open %s", path));
284   path = config_get_file(path);
285   if((err = db_create(&db, trackdb_env, 0)))
286     fatal(0, "db_create %s: %s", path, db_strerror(err));
287   if(dbflags)
288     if((err = db->set_flags(db, dbflags)))
289       fatal(0, "db->set_flags %s: %s", path, db_strerror(err));
290   if(dbtype == DB_BTREE)
291     if((err = db->set_bt_compare(db, compare)))
292       fatal(0, "db->set_bt_compare %s: %s", path, db_strerror(err));
293   if((err = db->open(db, 0, path, 0, dbtype,
294                      openflags | DB_AUTO_COMMIT, mode))) {
295     if((openflags & DB_CREATE) || errno != ENOENT)
296       fatal(0, "db->open %s: %s", path, db_strerror(err));
297     db->close(db, 0);
298     db = 0;
299   }
300   return db;
301 }
302
303 /** @brief Open track databases
304  * @param Flags flags word
305  *
306  * @p flags should be one of:
307  * - @p TRACKDB_NO_UPGRADE, if no upgrade should be attempted
308  * - @p TRACKDB_CAN_UPGRADE, if an upgrade may be attempted
309  * - @p TRACKDB_OPEN_FOR_UPGRADE, if this is disorder-dbupgrade
310  */
311 void trackdb_open(int flags) {
312   int err;
313   pid_t pid;
314
315   /* sanity checks */
316   assert(opened == 0);
317   ++opened;
318   /* check the database version first */
319   trackdb_globaldb = open_db("global.db", 0, DB_HASH, 0, 0666);
320   if(trackdb_globaldb) {
321     /* This is an existing database */
322     const char *s;
323     long oldversion;
324
325     s = trackdb_get_global("_dbversion");
326     /* Close the database again,  we'll open it property below */
327     if((err = trackdb_globaldb->close(trackdb_globaldb, 0)))
328       fatal(0, "error closing global.db: %s", db_strerror(err));
329     trackdb_globaldb = 0;
330     /* Convert version string to an integer */
331     oldversion = s ? atol(s) : 1;
332     if(oldversion > config->dbversion) {
333       /* Database is from the future; we never allow this. */
334       fatal(0, "this version of DisOrder is too old for database version %ld",
335             oldversion);
336     }
337     if(oldversion < config->dbversion) {
338       /* Database version is out of date */
339       switch(flags & TRACKDB_UPGRADE_MASK) {
340       case TRACKDB_NO_UPGRADE:
341         /* This database needs upgrading but this is not permitted */
342         fatal(0, "database needs upgrading from %ld to %ld",
343               oldversion, config->dbversion);
344       case TRACKDB_CAN_UPGRADE:
345         /* This database needs upgrading */
346         info("invoking disorder-dbupgrade to upgrade from %ld to %ld",
347              oldversion, config->dbversion);
348         pid = subprogram(0, "disorder-dbupgrade", -1);
349         while(waitpid(pid, &err, 0) == -1 && errno == EINTR)
350           ;
351         if(err)
352           fatal(0, "disorder-dbupgrade %s", wstat(err));
353         info("disorder-dbupgrade succeeded");
354         break;
355       case TRACKDB_OPEN_FOR_UPGRADE:
356         break;
357       default:
358         abort();
359       }
360     }
361     if(oldversion == config->dbversion && (flags & TRACKDB_OPEN_FOR_UPGRADE)) {
362       /* This doesn't make any sense */
363       fatal(0, "database is already at current version");
364     }
365     trackdb_existing_database = 1;
366   } else {
367     if(flags & TRACKDB_OPEN_FOR_UPGRADE) {
368       /* Cannot upgrade a new database */
369       fatal(0, "cannot upgrade a database that does not exist");
370     }
371     /* This is a brand new database */
372     trackdb_existing_database = 0;
373   }
374   /* open the databases */
375   trackdb_tracksdb = open_db("tracks.db",
376                              DB_RECNUM, DB_BTREE, DB_CREATE, 0666);
377   trackdb_searchdb = open_db("search.db",
378                              DB_DUP|DB_DUPSORT, DB_HASH, DB_CREATE, 0666);
379   trackdb_tagsdb = open_db("tags.db",
380                            DB_DUP|DB_DUPSORT, DB_HASH, DB_CREATE, 0666);
381   trackdb_prefsdb = open_db("prefs.db", 0, DB_HASH, DB_CREATE, 0666);
382   trackdb_globaldb = open_db("global.db", 0, DB_HASH, DB_CREATE, 0666);
383   trackdb_noticeddb = open_db("noticed.db",
384                              DB_DUPSORT, DB_BTREE, DB_CREATE, 0666);
385   if(!trackdb_existing_database) {
386     /* Stash the database version */
387     char buf[32];
388
389     assert(!(flags & TRACKDB_OPEN_FOR_UPGRADE));
390     snprintf(buf, sizeof buf, "%ld", config->dbversion);
391     trackdb_set_global("_dbversion", buf, 0);
392   }
393   D(("opened databases"));
394 }
395
396 /* close track databases */
397 void trackdb_close(void) {
398   int err;
399   
400   /* sanity checks */
401   assert(opened == 1);
402   --opened;
403   if((err = trackdb_tracksdb->close(trackdb_tracksdb, 0)))
404     fatal(0, "error closing tracks.db: %s", db_strerror(err));
405   if((err = trackdb_searchdb->close(trackdb_searchdb, 0)))
406     fatal(0, "error closing search.db: %s", db_strerror(err));
407   if((err = trackdb_tagsdb->close(trackdb_tagsdb, 0)))
408     fatal(0, "error closing tags.db: %s", db_strerror(err));
409   if((err = trackdb_prefsdb->close(trackdb_prefsdb, 0)))
410     fatal(0, "error closing prefs.db: %s", db_strerror(err));
411   if((err = trackdb_globaldb->close(trackdb_globaldb, 0)))
412     fatal(0, "error closing global.db: %s", db_strerror(err));
413   if((err = trackdb_noticeddb->close(trackdb_noticeddb, 0)))
414     fatal(0, "error closing noticed.db: %s", db_strerror(err));
415   trackdb_tracksdb = trackdb_searchdb = trackdb_prefsdb = 0;
416   trackdb_tagsdb = trackdb_globaldb = 0;
417   D(("closed databases"));
418 }
419
420 /* generic db routines *******************************************************/
421
422 /* fetch and decode a database entry.  Returns 0, DB_NOTFOUND or
423  * DB_LOCK_DEADLOCK. */
424 int trackdb_getdata(DB *db,
425                     const char *track,
426                     struct kvp **kp,
427                     DB_TXN *tid) {
428   int err;
429   DBT key, data;
430
431   switch(err = db->get(db, tid, make_key(&key, track),
432                        prepare_data(&data), 0)) {
433   case 0:
434     *kp = kvp_urldecode(data.data, data.size);
435     return 0;
436   case DB_NOTFOUND:
437     *kp = 0;
438     return err;
439   case DB_LOCK_DEADLOCK:
440     error(0, "error querying database: %s", db_strerror(err));
441     return err;
442   default:
443     fatal(0, "error querying database: %s", db_strerror(err));
444   }
445 }
446
447 /* encode and store a database entry.  Returns 0, DB_KEYEXIST or
448  * DB_LOCK_DEADLOCK. */
449 int trackdb_putdata(DB *db,
450                     const char *track,
451                     const struct kvp *k,
452                     DB_TXN *tid,
453                     u_int32_t flags) {
454   int err;
455   DBT key, data;
456
457   switch(err = db->put(db, tid, make_key(&key, track),
458                        encode_data(&data, k), flags)) {
459   case 0:
460   case DB_KEYEXIST:
461     return err;
462   case DB_LOCK_DEADLOCK:
463     error(0, "error updating database: %s", db_strerror(err));
464     return err;
465   default:
466     fatal(0, "error updating database: %s", db_strerror(err));
467   }
468 }
469
470 /* delete a database entry */
471 int trackdb_delkey(DB *db,
472                    const char *track,
473                    DB_TXN *tid) {
474   int err;
475
476   DBT key;
477   switch(err = db->del(db, tid, make_key(&key, track), 0)) {
478   case 0:
479   case DB_NOTFOUND:
480     return 0;
481   case DB_LOCK_DEADLOCK:
482     error(0, "error updating database: %s", db_strerror(err));
483     return err;
484   default:
485     fatal(0, "error updating database: %s", db_strerror(err));
486   }
487 }
488
489 /* open a database cursor */
490 DBC *trackdb_opencursor(DB *db, DB_TXN *tid) {
491   int err;
492   DBC *c;
493
494   switch(err = db->cursor(db, tid, &c, 0)) {
495   case 0: break;
496   default: fatal(0, "error creating cursor: %s", db_strerror(err));
497   }
498   return c;
499 }
500
501 /* close a database cursor; returns 0 or DB_LOCK_DEADLOCK */
502 int trackdb_closecursor(DBC *c) {
503   int err;
504
505   if(!c) return 0;
506   switch(err = c->c_close(c)) {
507   case 0:
508     return err;
509   case DB_LOCK_DEADLOCK:
510     error(0, "error closing cursor: %s", db_strerror(err));
511     return err;
512   default:
513     fatal(0, "error closing cursor: %s", db_strerror(err));
514   }
515 }
516
517 /* delete a (key,data) pair.  Returns 0, DB_NOTFOUND or DB_LOCK_DEADLOCK. */
518 int trackdb_delkeydata(DB *db,
519                        const char *word,
520                        const char *track,
521                        DB_TXN *tid) {
522   int err;
523   DBC *c;
524   DBT key, data;
525
526   c = trackdb_opencursor(db, tid);
527   switch(err = c->c_get(c, make_key(&key, word),
528                         make_key(&data, track), DB_GET_BOTH)) {
529   case 0:
530     switch(err = c->c_del(c, 0)) {
531     case 0:
532       break;
533     case DB_KEYEMPTY:
534       err = 0;
535       break;
536     case DB_LOCK_DEADLOCK:
537       error(0, "error updating database: %s", db_strerror(err));
538       break;
539     default:
540       fatal(0, "c->c_del: %s", db_strerror(err));
541     }
542     break;
543   case DB_NOTFOUND:
544     break;
545   case DB_LOCK_DEADLOCK:
546     error(0, "error updating database: %s", db_strerror(err));
547     break;
548   default:
549     fatal(0, "c->c_get: %s", db_strerror(err));
550   }
551   if(trackdb_closecursor(c)) err = DB_LOCK_DEADLOCK;
552   return err;
553 }
554
555 /* start a transaction */
556 DB_TXN *trackdb_begin_transaction(void) {
557   DB_TXN *tid;
558   int err;
559
560   if((err = trackdb_env->txn_begin(trackdb_env, 0, &tid, 0)))
561     fatal(0, "trackdb_env->txn_begin: %s", db_strerror(err));
562   return tid;
563 }
564
565 /* abort transaction */
566 void trackdb_abort_transaction(DB_TXN *tid) {
567   int err;
568
569   if(tid)
570     if((err = tid->abort(tid)))
571       fatal(0, "tid->abort: %s", db_strerror(err));
572 }
573
574 /* commit transaction */
575 void trackdb_commit_transaction(DB_TXN *tid) {
576   int err;
577
578   if((err = tid->commit(tid, 0)))
579     fatal(0, "tid->commit: %s", db_strerror(err));
580 }
581
582 /* search/tags shared code ***************************************************/
583
584 /* comparison function used by dedupe() */
585 static int wordcmp(const void *a, const void *b) {
586   return strcmp(*(const char **)a, *(const char **)b);
587 }
588
589 /* sort and de-dupe VEC */
590 static char **dedupe(char **vec, int nvec) {
591   int m, n;
592
593   qsort(vec, nvec, sizeof (char *), wordcmp);
594   m = n = 0;
595   if(nvec) {
596     vec[m++] = vec[0];
597     for(n = 1; n < nvec; ++n)
598       if(strcmp(vec[n], vec[m - 1]))
599         vec[m++] = vec[n];
600   }
601   vec[m] = 0;
602   return vec;
603 }
604
605 /* update a key/track database.  Returns 0 or DB_DEADLOCK. */
606 static int register_word(DB *db, const char *what,
607                          const char *track, const char *word,
608                          DB_TXN *tid) {
609   int err;
610   DBT key, data;
611
612   switch(err = db->put(db, tid, make_key(&key, word),
613                        make_key(&data, track), DB_NODUPDATA)) {
614   case 0:
615   case DB_KEYEXIST:
616     return 0;
617   case DB_LOCK_DEADLOCK:
618     error(0, "error updating %s.db: %s", what, db_strerror(err));
619     return err;
620   default:
621     fatal(0, "error updating %s.db: %s", what,  db_strerror(err));
622   }
623 }
624
625 /* search primitives *********************************************************/
626
627 /* return true iff NAME is a trackname_display_ pref */
628 static int is_display_pref(const char *name) {
629   static const char prefix[] = "trackname_display_";
630   return !strncmp(name, prefix, (sizeof prefix) - 1);
631 }
632
633 /** @brief Word_Break property tailor that treats underscores as spaces */
634 static int tailor_underscore_Word_Break_Other(uint32_t c) {
635   switch(c) {
636   default:
637     return -1;
638   case 0x005F: /* LOW LINE (SPACING UNDERSCORE) */
639     return unicode_Word_Break_Other;
640   }
641 }
642
643 /** @brief Remove all combining characters in-place
644  * @param s Pointer to start of string
645  * @param ns Length of string
646  * @return New, possiblby reduced, length
647  */
648 static size_t remove_combining_chars(uint32_t *s, size_t ns) {
649   uint32_t *start = s, *t = s, *end = s + ns;
650
651   while(s < end) {
652     const uint32_t c = *s++;
653     if(!utf32_combining_class(c))
654       *t++ = c;
655   }
656   return t - start;
657 }
658
659 /** @brief Normalize and split a string using a given tailoring */
660 static void word_split(struct vector *v,
661                        const char *s,
662                        unicode_property_tailor *pt) {
663   size_t nw, nt32, i;
664   uint32_t *t32, **w32;
665
666   /* Convert to UTF-32 */
667   if(!(t32 = utf8_to_utf32(s, strlen(s), &nt32)))
668     return;
669   /* Erase case distinctions */
670   if(!(t32 = utf32_casefold_compat(t32, nt32, &nt32)))
671     return;
672   /* Drop combining characters */
673   nt32 = remove_combining_chars(t32, nt32);
674   /* Split into words, treating _ as a space */
675   w32 = utf32_word_split(t32, nt32, &nw, pt);
676   /* Convert words back to UTF-8 and append to result */
677   for(i = 0; i < nw; ++i)
678     vector_append(v, utf32_to_utf8(w32[i], utf32_len(w32[i]), 0));
679 }
680
681 /* compute the words of a track name */
682 static char **track_to_words(const char *track,
683                              const struct kvp *p) {
684   struct vector v;
685   const char *rootless = track_rootless(track);
686
687   if(!rootless)
688     rootless = track;                   /* bodge */
689   vector_init(&v);
690   rootless = strip_extension(rootless);
691   word_split(&v, strip_extension(rootless), tailor_underscore_Word_Break_Other);
692   for(; p; p = p->next)
693     if(is_display_pref(p->name))
694       word_split(&v, p->value, 0);
695   vector_terminate(&v);
696   return dedupe(v.vec, v.nvec);
697 }
698
699 /* return nonzero iff WORD is a stopword */
700 static int stopword(const char *word) {
701   int n;
702
703   for(n = 0; n < config->stopword.n
704         && strcmp(word, config->stopword.s[n]); ++n)
705     ;
706   return n < config->stopword.n;
707 }
708
709 /* record that WORD appears in TRACK.  Returns 0 or DB_LOCK_DEADLOCK. */
710 static int register_search_word(const char *track, const char *word,
711                                 DB_TXN *tid) {
712   if(stopword(word)) return 0;
713   return register_word(trackdb_searchdb, "search", track, word, tid);
714 }
715
716 /* Tags **********************************************************************/
717
718 /* Return nonzero if C is a valid tag character */
719 static int tagchar(int c) {
720   switch(c) {
721   case ',':
722     return 0;
723   default:
724     return c >= ' ';
725   }
726 }
727
728 /* Parse and de-dupe a tag list.  If S=0 then assumes "". */
729 static char **parsetags(const char *s) {
730   const char *t;
731   struct vector v;
732
733   vector_init(&v);
734   if(s) {
735     /* skip initial separators */
736     while(*s && (!tagchar(*s) || *s == ' '))
737       ++s;
738     while(*s) {
739       /* find the extent of the tag */
740       t = s;
741       while(*s && tagchar(*s))
742         ++s;
743       /* strip trailing spaces */
744       while(s > t && s[-1] == ' ')
745         --s;
746       vector_append(&v, xstrndup(t, s - t));
747       /* skip intermediate and trailing separators */
748       while(*s && (!tagchar(*s) || *s == ' '))
749         ++s;
750     }
751   }
752   vector_terminate(&v);
753   return dedupe(v.vec, v.nvec);
754 }
755
756 /* Record that TRACK has TAG.  Returns 0 or DB_LOCK_DEADLOCK. */
757 static int register_tag(const char *track, const char *tag, DB_TXN *tid) {
758   return register_word(trackdb_tagsdb, "tags", track, tag, tid);
759 }
760
761 /* aliases *******************************************************************/
762
763 /* compute the alias and store at aliasp.  Returns 0 or DB_LOCK_DEADLOCK.  If
764  * there is no alias sets *aliasp to 0. */
765 static int compute_alias(char **aliasp,
766                          const char *track,
767                          const struct kvp *p,
768                          DB_TXN *tid) {
769   struct dynstr d;
770   const char *s = config->alias, *t, *expansion, *part;
771   int c, used_db = 0, slash_prefix, err;
772   struct kvp *at;
773   const char *const root = find_track_root(track);
774
775   if(!root) {
776     /* Bodge for tracks with no root */
777     *aliasp = 0;
778     return 0;
779   }
780   dynstr_init(&d);
781   dynstr_append_string(&d, root);
782   while((c = (unsigned char)*s++)) {
783     if(c != '{') {
784       dynstr_append(&d, c);
785       continue;
786     }
787     if((slash_prefix = (*s == '/')))
788       s++;
789     t = strchr(s, '}');
790     assert(t != 0);                     /* validated at startup */
791     part = xstrndup(s, t - s);
792     expansion = getpart(track, "display", part, p, &used_db);
793     if(*expansion) {
794       if(slash_prefix) dynstr_append(&d, '/');
795       dynstr_append_string(&d, expansion);
796     }
797     s = t + 1;                          /* skip {part} */
798   }
799   /* only admit to the alias if we used the db... */
800   if(!used_db) {
801     *aliasp = 0;
802     return 0;
803   }
804   dynstr_terminate(&d);
805   /* ...and the answer differs from the original... */
806   if(!strcmp(track, d.vec)) {
807     *aliasp = 0;
808     return 0;
809   }
810   /* ...and there isn't already a different track with that name (including as
811    * an alias) */
812   switch(err = trackdb_getdata(trackdb_tracksdb, d.vec, &at, tid)) {
813   case 0:
814     if((s = kvp_get(at, "_alias_for"))
815        && !strcmp(s, track)) {
816     case DB_NOTFOUND:
817       *aliasp = d.vec;
818     } else {
819       *aliasp = 0;
820     }
821     return 0;
822   default:
823     return err;
824   }
825 }
826
827 /* get track and prefs data (if tp/pp not null pointers).  Returns 0 on
828  * success, DB_NOTFOUND if the track does not exist or DB_LOCK_DEADLOCK.
829  * Always sets the return values, even if only to null pointers. */
830 static int gettrackdata(const char *track,
831                         struct kvp **tp,
832                         struct kvp **pp,
833                         const char **actualp,
834                         unsigned flags,
835 #define GTD_NOALIAS 0x0001
836                         DB_TXN *tid) {
837   int err;
838   const char *actual = track;
839   struct kvp *t = 0, *p = 0;
840   
841   if((err = trackdb_getdata(trackdb_tracksdb, track, &t, tid))) goto done;
842   if((actual = kvp_get(t, "_alias_for"))) {
843     if(flags & GTD_NOALIAS) {
844       error(0, "alias passed to gettrackdata where real path required");
845       abort();
846     }
847     if((err = trackdb_getdata(trackdb_tracksdb, actual, &t, tid))) goto done;
848   } else
849     actual = track;
850   assert(actual != 0);
851   if(pp) {
852     if((err = trackdb_getdata(trackdb_prefsdb, actual, &p, tid)) == DB_LOCK_DEADLOCK)
853       goto done;
854   }
855   err = 0;
856 done:
857   if(actualp) *actualp = actual;
858   if(tp) *tp = t;
859   if(pp) *pp = p;
860   return err;
861 }
862
863 /* trackdb_notice() **********************************************************/
864
865 /** @brief notice a possibly new track
866  * @return @c DB_NOTFOUND if new, 0 if already known
867  */
868 int trackdb_notice(const char *track,
869                    const char *path) {
870   int err;
871   DB_TXN *tid;
872   
873   for(;;) {
874     tid = trackdb_begin_transaction();
875     err = trackdb_notice_tid(track, path, tid);
876     if((err == DB_LOCK_DEADLOCK)) goto fail;
877     break;
878   fail:
879     trackdb_abort_transaction(tid);
880   }
881   trackdb_commit_transaction(tid);
882   return err;
883 }
884
885 /** @brief notice a possibly new track
886  * @param track NFC UTF-8 track name
887  * @param path Raw path name
888  * @param tid Transaction ID
889  * @return @c DB_NOTFOUND if new, 0 if already known, @c DB_LOCK_DEADLOCK also
890  */
891 int trackdb_notice_tid(const char *track,
892                        const char *path,
893                        DB_TXN *tid) {
894   int err, n;
895   struct kvp *t, *a, *p;
896   int t_changed, ret;
897   char *alias, **w;
898
899   /* notice whether the tracks.db entry changes */
900   t_changed = 0;
901   /* get any existing tracks entry */
902   if((err = gettrackdata(track, &t, &p, 0, 0, tid)) == DB_LOCK_DEADLOCK)
903     return err;
904   ret = err;                            /* 0 or DB_NOTFOUND */
905   /* this is a real track */
906   t_changed += kvp_set(&t, "_alias_for", 0);
907   t_changed += kvp_set(&t, "_path", path);
908   /* if we have an alias record it in the database */
909   if((err = compute_alias(&alias, track, p, tid))) return err;
910   if(alias) {
911     /* won't overwrite someone else's alias as compute_alias() checks */
912     D(("%s: alias %s", track, alias));
913     a = 0;
914     kvp_set(&a, "_alias_for", track);
915     if((err = trackdb_putdata(trackdb_tracksdb, alias, a, tid, 0))) return err;
916   }
917   /* update search.db */
918   w = track_to_words(track, p);
919   for(n = 0; w[n]; ++n)
920     if((err = register_search_word(track, w[n], tid)))
921       return err;
922   /* update tags.db */
923   w = parsetags(kvp_get(p, "tags"));
924   for(n = 0; w[n]; ++n)
925     if((err = register_tag(track, w[n], tid)))
926       return err;
927   reqtracks = 0;
928   /* only store the tracks.db entry if it has changed */
929   if(t_changed && (err = trackdb_putdata(trackdb_tracksdb, track, t, tid, 0)))
930     return err;
931   if(ret == DB_NOTFOUND) {
932     uint32_t timestamp[2];
933     time_t now;
934     DBT key, data;
935
936     time(&now);
937     timestamp[0] = htonl((uint64_t)now >> 32);
938     timestamp[1] = htonl((uint32_t)now);
939     memset(&key, 0, sizeof key);
940     key.data = timestamp;
941     key.size = sizeof timestamp;
942     switch(err = trackdb_noticeddb->put(trackdb_noticeddb, tid, &key,
943                                         make_key(&data, track), 0)) {
944     case 0: break;
945     case DB_LOCK_DEADLOCK: return err;
946     default: fatal(0, "error updating noticed.db: %s", db_strerror(err));
947     }
948   }
949   return ret;
950 }
951
952 /* trackdb_obsolete() ********************************************************/
953
954 /* obsolete a track */
955 int trackdb_obsolete(const char *track, DB_TXN *tid) {
956   int err, n;
957   struct kvp *p;
958   char *alias, **w;
959
960   if((err = gettrackdata(track, 0, &p, 0,
961                          GTD_NOALIAS, tid)) == DB_LOCK_DEADLOCK)
962     return err;
963   else if(err == DB_NOTFOUND) return 0;
964   /* compute the alias, if any, and delete it */
965   if(compute_alias(&alias, track, p, tid)) return err;
966   if(alias) {
967     /* if the alias points to some other track then compute_alias won't
968      * return it */
969     if(trackdb_delkey(trackdb_tracksdb, alias, tid))
970       return err;
971   }
972   /* update search.db */
973   w = track_to_words(track, p);
974   for(n = 0; w[n]; ++n)
975     if(trackdb_delkeydata(trackdb_searchdb,
976                           w[n], track, tid) == DB_LOCK_DEADLOCK)
977       return err;
978   /* update tags.db */
979   w = parsetags(kvp_get(p, "tags"));
980   for(n = 0; w[n]; ++n)
981     if(trackdb_delkeydata(trackdb_tagsdb,
982                           w[n], track, tid) == DB_LOCK_DEADLOCK)
983       return err;
984   reqtracks = 0;
985   /* update tracks.db */
986   if(trackdb_delkey(trackdb_tracksdb, track, tid) == DB_LOCK_DEADLOCK)
987     return err;
988   /* We don't delete the prefs, so they survive temporary outages of the
989    * (possibly virtual) track filesystem */
990   return 0;
991 }
992
993 /* trackdb_stats() ***********************************************************/
994
995 #define H(name) { #name, offsetof(DB_HASH_STAT, name) }
996 #define B(name) { #name, offsetof(DB_BTREE_STAT, name) }
997
998 static const struct statinfo {
999   const char *name;
1000   size_t offset;
1001 } statinfo_hash[] = {
1002   H(hash_magic),
1003   H(hash_version),
1004   H(hash_nkeys),
1005   H(hash_ndata),
1006   H(hash_pagesize),
1007   H(hash_ffactor),
1008   H(hash_buckets),
1009   H(hash_free),
1010   H(hash_bfree),
1011   H(hash_bigpages),
1012   H(hash_big_bfree),
1013   H(hash_overflows),
1014   H(hash_ovfl_free),
1015   H(hash_dup),
1016   H(hash_dup_free),
1017 }, statinfo_btree[] = {
1018   B(bt_magic),
1019   B(bt_version),
1020   B(bt_nkeys),
1021   B(bt_ndata),
1022   B(bt_pagesize),
1023   B(bt_minkey),
1024   B(bt_re_len),
1025   B(bt_re_pad),
1026   B(bt_levels),
1027   B(bt_int_pg),
1028   B(bt_leaf_pg),
1029   B(bt_dup_pg),
1030   B(bt_over_pg),
1031   B(bt_free),
1032   B(bt_int_pgfree),
1033   B(bt_leaf_pgfree),
1034   B(bt_dup_pgfree),
1035   B(bt_over_pgfree),
1036 };
1037
1038 /* look up stats for DB */
1039 static int get_stats(struct vector *v,
1040                      DB *database,
1041                      const struct statinfo *si,
1042                      size_t nsi,
1043                      DB_TXN *tid) {
1044   void *sp;
1045   size_t n;
1046   char *str;
1047   int err;
1048
1049   if(database) {
1050     switch(err = database->stat(database, tid, &sp, 0)) {
1051     case 0:
1052       break;
1053     case DB_LOCK_DEADLOCK:
1054       error(0, "error querying database: %s", db_strerror(err));
1055       return err;
1056     default:
1057       fatal(0, "error querying database: %s", db_strerror(err));
1058     }
1059     for(n = 0; n < nsi; ++n) {
1060       byte_xasprintf(&str, "%s=%"PRIuMAX, si[n].name,
1061                      (uintmax_t)*(u_int32_t *)((char *)sp + si[n].offset));
1062       vector_append(v, str);
1063     }
1064   }
1065   return 0;
1066 }
1067
1068 /** @brief One entry in the search league */
1069 struct search_entry {
1070   char *word;
1071   int n;
1072 };
1073
1074 /** @brief Add a word to the search league
1075  * @param se Pointer to search league
1076  * @param count Maximum size for search league
1077  * @param nse Current size of search league
1078  * @param word New word, or NULL
1079  * @param n How often @p word appears
1080  * @return New size of search league
1081  */
1082 static int register_search_entry(struct search_entry *se,
1083                                  int count,
1084                                  int nse,
1085                                  char *word,
1086                                  int n) {
1087   int i;
1088
1089   if(word && (nse < count || n > se[nse - 1].n)) {
1090     /* Find the starting point */
1091     if(nse == count)
1092       i = nse - 1;
1093     else
1094       i = nse++;
1095     /* Find the insertion point */
1096     while(i > 0 && n > se[i - 1].n)
1097       --i;
1098     memmove(&se[i + 1], &se[i], (nse - i - 1) * sizeof *se);
1099     se[i].word = word;
1100     se[i].n = n;
1101   }
1102   return nse;
1103 }
1104
1105 /* find the top COUNT words in the search database */
1106 static int search_league(struct vector *v, int count, DB_TXN *tid) {
1107   struct search_entry *se;
1108   DBT k, d;
1109   DBC *cursor;
1110   int err, n = 0, nse = 0, i;
1111   char *word = 0;
1112   size_t wl = 0;
1113   char *str;
1114
1115   cursor = trackdb_opencursor(trackdb_searchdb, tid);
1116   se = xmalloc(count * sizeof *se);
1117   /* Walk across the whole database counting up the number of times each
1118    * word appears. */
1119   while(!(err = cursor->c_get(cursor, prepare_data(&k), prepare_data(&d),
1120                               DB_NEXT))) {
1121     if(word && wl == k.size && !strncmp(word, k.data, wl))
1122       ++n;                              /* same word again */
1123     else {
1124       nse = register_search_entry(se, count, nse, word, n);
1125       word = xstrndup(k.data, wl = k.size);
1126       n = 1;
1127     }
1128   }
1129   switch(err) {
1130   case DB_NOTFOUND:
1131     err = 0;
1132     break;
1133   case DB_LOCK_DEADLOCK:
1134     error(0, "error querying search database: %s", db_strerror(err));
1135     break;
1136   default:
1137     fatal(0, "error querying search database: %s", db_strerror(err));
1138   }
1139   if(trackdb_closecursor(cursor)) err = DB_LOCK_DEADLOCK;
1140   if(err) return err;
1141   nse = register_search_entry(se, count, nse, word, n);
1142   byte_xasprintf(&str, "Top %d search words:", nse);
1143   vector_append(v, str);
1144   for(i = 0; i < nse; ++i) {
1145     byte_xasprintf(&str, "%4d: %5d %s", i + 1, se[i].n, se[i].word);
1146     vector_append(v, str);
1147   }
1148   return 0;
1149 }
1150
1151 #define SI(what) statinfo_##what, \
1152                  sizeof statinfo_##what / sizeof (struct statinfo)
1153
1154 /* return a list of database stats */
1155 char **trackdb_stats(int *nstatsp) {
1156   DB_TXN *tid;
1157   struct vector v;
1158   
1159   vector_init(&v);
1160   for(;;) {
1161     tid = trackdb_begin_transaction();
1162     v.nvec = 0;
1163     vector_append(&v, (char *)"Tracks database stats:");
1164     if(get_stats(&v, trackdb_tracksdb, SI(btree), tid)) goto fail;
1165     vector_append(&v, (char *)"");
1166     vector_append(&v, (char *)"Search database stats:");
1167     if(get_stats(&v, trackdb_searchdb, SI(hash), tid)) goto fail;
1168     vector_append(&v, (char *)"");
1169     vector_append(&v, (char *)"Prefs database stats:");
1170     if(get_stats(&v, trackdb_prefsdb, SI(hash), tid)) goto fail;
1171     vector_append(&v, (char *)"");
1172     if(search_league(&v, 10, tid)) goto fail;
1173     vector_terminate(&v);
1174     break;
1175 fail:
1176     trackdb_abort_transaction(tid);
1177   }
1178   trackdb_commit_transaction(tid);
1179   if(nstatsp) *nstatsp = v.nvec;
1180   return v.vec;
1181 }
1182
1183 struct stats_details {
1184   void (*done)(char *data, void *u);
1185   void *u;
1186   int exited;                           /* subprocess exited */
1187   int closed;                           /* pipe close */
1188   int wstat;                            /* wait status from subprocess */
1189   struct dynstr data[1];                /* data read from pipe */
1190 };
1191
1192 static void stats_complete(struct stats_details *d) {
1193   char *s;
1194
1195   if(!(d->exited && d->closed))
1196     return;
1197   byte_xasprintf(&s, "\n"
1198                  "Server stats:\n"
1199                  "track lookup cache hits: %lu\n"
1200                  "track lookup cache misses: %lu\n",
1201                  cache_files_hits,
1202                  cache_files_misses);
1203   dynstr_append_string(d->data, s);
1204   dynstr_terminate(d->data);
1205   d->done(d->data->vec, d->u);
1206 }
1207
1208 static int stats_finished(ev_source attribute((unused)) *ev,
1209                           pid_t attribute((unused)) pid,
1210                           int status,
1211                           const struct rusage attribute((unused)) *rusage,
1212                           void *u) {
1213   struct stats_details *const d = u;
1214
1215   d->exited = 1;
1216   if(status)
1217     error(0, "disorder-stats %s", wstat(status));
1218   stats_complete(d);
1219   return 0;
1220 }
1221
1222 static int stats_read(ev_source attribute((unused)) *ev,
1223                       ev_reader *reader,
1224                       void *ptr,
1225                       size_t bytes,
1226                       int eof,
1227                       void *u) {
1228   struct stats_details *const d = u;
1229
1230   dynstr_append_bytes(d->data, ptr, bytes);
1231   ev_reader_consume(reader, bytes);
1232   if(eof)
1233     d->closed = 1;
1234   stats_complete(d);
1235   return 0;
1236 }
1237
1238 static int stats_error(ev_source attribute((unused)) *ev,
1239                        int errno_value,
1240                        void *u) {
1241   struct stats_details *const d = u;
1242
1243   error(errno_value, "error reading from pipe to disorder-stats");
1244   d->closed = 1;
1245   stats_complete(d);
1246   return 0;
1247 }
1248
1249 void trackdb_stats_subprocess(ev_source *ev,
1250                               void (*done)(char *data, void *u),
1251                               void *u) {
1252   int p[2];
1253   pid_t pid;
1254   struct stats_details *d = xmalloc(sizeof *d);
1255
1256   dynstr_init(d->data);
1257   d->done = done;
1258   d->u = u;
1259   xpipe(p);
1260   pid = subprogram(ev, "disorder-stats", p[1]);
1261   xclose(p[1]);
1262   ev_child(ev, pid, 0, stats_finished, d);
1263   ev_reader_new(ev, p[0], stats_read, stats_error, d, "disorder-stats reader");
1264 }
1265
1266 /* set a pref (remove if value=0) */
1267 int trackdb_set(const char *track,
1268                 const char *name,
1269                 const char *value) {
1270   struct kvp *t, *p, *a;
1271   DB_TXN *tid;
1272   int err, cmp;
1273   char *oldalias, *newalias, **oldtags = 0, **newtags;
1274
1275   if(value) {
1276     /* TODO: if value matches default then set value=0 */
1277   }
1278   
1279   for(;;) {
1280     tid = trackdb_begin_transaction();
1281     if((err = gettrackdata(track, &t, &p, 0,
1282                            0, tid)) == DB_LOCK_DEADLOCK)
1283       goto fail;
1284     if(err == DB_NOTFOUND) break;
1285     if(name[0] == '_') {
1286       if(kvp_set(&t, name, value))
1287         if(trackdb_putdata(trackdb_tracksdb, track, t, tid, 0))
1288           goto fail;
1289     } else {
1290       /* get the old alias name */
1291       if(compute_alias(&oldalias, track, p, tid)) goto fail;
1292       /* get the old tags */
1293       if(!strcmp(name, "tags"))
1294         oldtags = parsetags(kvp_get(p, "tags"));
1295       /* set the value */
1296       if(kvp_set(&p, name, value))
1297         if(trackdb_putdata(trackdb_prefsdb, track, p, tid, 0))
1298           goto fail;
1299       /* compute the new alias name */
1300       if((err = compute_alias(&newalias, track, p, tid))) goto fail;
1301       /* check whether alias has changed */
1302       if(!(oldalias == newalias
1303            || (oldalias && newalias && !strcmp(oldalias, newalias)))) {
1304         /* adjust alias records to fit change */
1305         if(oldalias
1306            && trackdb_delkey(trackdb_tracksdb, oldalias, tid)) goto fail;
1307         if(newalias) {
1308           a = 0;
1309           kvp_set(&a, "_alias_for", track);
1310           if(trackdb_putdata(trackdb_tracksdb, newalias, a, tid, 0)) goto fail;
1311         }
1312       }
1313       /* check whether tags have changed */
1314       if(!strcmp(name, "tags")) {
1315         newtags = parsetags(value);
1316         while(*oldtags || *newtags) {
1317           if(*oldtags && *newtags) {
1318             cmp = strcmp(*oldtags, *newtags);
1319             if(!cmp) {
1320               /* keeping this tag */
1321               ++oldtags;
1322               ++newtags;
1323             } else if(cmp < 0)
1324               /* old tag fits into a gap in the new list, so delete old */
1325               goto delete_old;
1326             else
1327               /* new tag fits into a gap in the old list, so insert new */
1328               goto insert_new;
1329           } else if(*oldtags) {
1330             /* we've run out of new tags, so remaining old ones are to be
1331              * deleted */
1332           delete_old:
1333             if(trackdb_delkeydata(trackdb_tagsdb,
1334                                   *oldtags, track, tid) == DB_LOCK_DEADLOCK)
1335               goto fail;
1336             ++oldtags;
1337           } else {
1338             /* we've run out of old tags, so remainig new ones are to be
1339              * inserted */
1340           insert_new:
1341             if(register_tag(track, *newtags, tid)) goto fail;
1342             ++newtags;
1343           }
1344         }
1345         reqtracks = 0;
1346       }
1347     }
1348     err = 0;
1349     break;
1350 fail:
1351     trackdb_abort_transaction(tid);
1352   }
1353   trackdb_commit_transaction(tid);
1354   return err == 0 ? 0 : -1;
1355 }
1356
1357 /* get a pref */
1358 const char *trackdb_get(const char *track,
1359                         const char *name) {
1360   return kvp_get(trackdb_get_all(track), name);
1361 }
1362
1363 /* get all prefs as a 0-terminated array */
1364 struct kvp *trackdb_get_all(const char *track) {
1365   struct kvp *t, *p, **pp;
1366   DB_TXN *tid;
1367
1368   for(;;) {
1369     tid = trackdb_begin_transaction();
1370     if(gettrackdata(track, &t, &p, 0, 0, tid) == DB_LOCK_DEADLOCK)
1371       goto fail;
1372     break;
1373 fail:
1374     trackdb_abort_transaction(tid);
1375   }
1376   trackdb_commit_transaction(tid);
1377   for(pp = &p; *pp; pp = &(*pp)->next)
1378     ;
1379   *pp = t;
1380   return p;
1381 }
1382
1383 /* resolve alias */
1384 const char *trackdb_resolve(const char *track) {
1385   DB_TXN *tid;
1386   const char *actual;
1387   
1388   for(;;) {
1389     tid = trackdb_begin_transaction();
1390     if(gettrackdata(track, 0, 0, &actual, 0, tid) == DB_LOCK_DEADLOCK)
1391       goto fail;
1392     break;
1393 fail:
1394     trackdb_abort_transaction(tid);
1395   }
1396   trackdb_commit_transaction(tid);
1397   return actual;
1398 }
1399
1400 int trackdb_isalias(const char *track) {
1401   const char *actual = trackdb_resolve(track);
1402
1403   return strcmp(actual, track);
1404 }
1405
1406 /* test whether a track exists (perhaps an alias) */
1407 int trackdb_exists(const char *track) {
1408   DB_TXN *tid;
1409   int err;
1410
1411   for(;;) {
1412     tid = trackdb_begin_transaction();
1413     /* unusually, here we want the return value */
1414     if((err = gettrackdata(track, 0, 0, 0, 0, tid)) == DB_LOCK_DEADLOCK)
1415       goto fail;
1416     break;
1417 fail:
1418     trackdb_abort_transaction(tid);
1419   }
1420   trackdb_commit_transaction(tid);
1421   return (err == 0);
1422 }
1423
1424 /* return the list of tags */
1425 char **trackdb_alltags(void) {
1426   DB_TXN *tid;
1427   int err;
1428   char **taglist;
1429
1430   for(;;) {
1431     tid = trackdb_begin_transaction();
1432     err = trackdb_alltags_tid(tid, &taglist);
1433     if(!err) break;
1434     trackdb_abort_transaction(tid);
1435   }
1436   trackdb_commit_transaction(tid);
1437   return taglist;
1438 }
1439
1440 static int trackdb_alltags_tid(DB_TXN *tid, char ***taglistp) {
1441   struct vector v;
1442   DBC *c;
1443   DBT k, d;
1444   int err;
1445
1446   vector_init(&v);
1447   c = trackdb_opencursor(trackdb_tagsdb, tid);
1448   memset(&k, 0, sizeof k);
1449   while(!(err = c->c_get(c, &k, prepare_data(&d), DB_NEXT_NODUP)))
1450     vector_append(&v, xstrndup(k.data, k.size));
1451   switch(err) {
1452   case DB_NOTFOUND:
1453     break;
1454   case DB_LOCK_DEADLOCK:
1455       return err;
1456   default:
1457     fatal(0, "c->c_get: %s", db_strerror(err));
1458   }
1459   if((err = trackdb_closecursor(c))) return err;
1460   vector_terminate(&v);
1461   *taglistp = v.vec;
1462   return 0;
1463 }
1464
1465 /* return 1 iff sorted tag lists A and B have at least one member in common */
1466 static int tag_intersection(char **a, char **b) {
1467   int cmp;
1468
1469   /* Same sort of logic as trackdb_set() above */
1470   while(*a && *b) {
1471     if(!(cmp = strcmp(*a, *b))) return 1;
1472     else if(cmp < 0) ++a;
1473     else ++b;
1474   }
1475   return 0;
1476 }
1477
1478 /* Check whether a track is suitable for random play.  Returns 0 if it is,
1479  * DB_NOTFOUND if it is not or DB_LOCK_DEADLOCK if the database gave us
1480  * that. */
1481 static int check_suitable(const char *track,
1482                           DB_TXN *tid,
1483                           char **required_tags,
1484                           char **prohibited_tags) {
1485   char **track_tags;
1486   time_t last, now;
1487   struct kvp *p, *t;
1488   const char *pick_at_random, *played_time;
1489
1490   /* don't pick tracks that aren't in any surviving collection (for instance
1491    * you've edited the config but the rescan hasn't done its job yet) */
1492   if(!find_track_root(track)) {
1493     info("found track not in any collection: %s", track);
1494     return DB_NOTFOUND;
1495   }
1496   /* don't pick aliases - only pick the canonical form */
1497   if(gettrackdata(track, &t, &p, 0, 0, tid) == DB_LOCK_DEADLOCK)
1498     return DB_LOCK_DEADLOCK;
1499   if(kvp_get(t, "_alias_for"))
1500     return DB_NOTFOUND;
1501   /* check that random play is not suppressed for this track */
1502   if((pick_at_random = kvp_get(p, "pick_at_random"))
1503      && !strcmp(pick_at_random, "0"))
1504     return DB_NOTFOUND;
1505   /* don't pick a track that's been played in the last 8 hours */
1506   if((played_time = kvp_get(p, "played_time"))) {
1507     last = atoll(played_time);
1508     now = time(0);
1509     if(now < last + 8 * 3600)       /* TODO configurable */
1510       return DB_NOTFOUND;
1511   }
1512   track_tags = parsetags(kvp_get(p, "tags"));
1513   /* check that no prohibited tag is present for this track */
1514   if(prohibited_tags && tag_intersection(track_tags, prohibited_tags))
1515     return DB_NOTFOUND;
1516   /* check that at least one required tags is present for this track */
1517   if(*required_tags && !tag_intersection(track_tags, required_tags))
1518     return DB_NOTFOUND;
1519   return 0;
1520 }
1521
1522 /* attempt to pick a random non-alias track */
1523 const char *trackdb_random(int tries) {
1524   DBT key, data;
1525   DB_BTREE_STAT *sp;
1526   int err, n;
1527   DB_TXN *tid;
1528   const char *track, *candidate;
1529   db_recno_t r;
1530   const char *tags;
1531   char **required_tags, **prohibited_tags, **tp;
1532   hash *h;
1533   DBC *c = 0;
1534
1535   for(;;) {
1536     tid = trackdb_begin_transaction();
1537     if((err = trackdb_get_global_tid("required-tags", tid, &tags)))
1538       goto fail;
1539     required_tags = parsetags(tags);
1540     if((err = trackdb_get_global_tid("prohibited-tags", tid, &tags)))
1541       goto fail;
1542     prohibited_tags = parsetags(tags);
1543     track = 0;
1544     if(*required_tags) {
1545       /* Bung all the suitable tracks into a hash and convert to a list of keys
1546        * (to eliminate duplicates).  We cache this list since it is possible
1547        * that it will be very large. */
1548       if(!reqtracks) {
1549         h = hash_new(0);
1550         for(tp = required_tags; *tp; ++tp) {
1551           c = trackdb_opencursor(trackdb_tagsdb, tid);
1552           memset(&key, 0, sizeof key);
1553           key.data = *tp;
1554           key.size = strlen(*tp);
1555           n = 0;
1556           err = c->c_get(c, &key, prepare_data(&data), DB_SET);
1557           while(err == 0) {
1558             hash_add(h, xstrndup(data.data, data.size), 0,
1559                      HASH_INSERT_OR_REPLACE);
1560             ++n;
1561             err = c->c_get(c, &key, prepare_data(&data), DB_NEXT_DUP);
1562           }
1563           switch(err) {
1564           case 0:
1565           case DB_NOTFOUND:
1566             break;
1567           case DB_LOCK_DEADLOCK:
1568             goto fail;
1569           default:
1570             fatal(0, "error querying tags.db: %s", db_strerror(err));
1571           }
1572           trackdb_closecursor(c);
1573           c = 0;
1574           if(!n)
1575             error(0, "required tag %s does not match any tracks", *tp);
1576         }
1577         nreqtracks = hash_count(h);
1578         reqtracks = hash_keys(h);
1579       }
1580       while(nreqtracks && !track && tries-- > 0) {
1581         r = (rand() * (double)nreqtracks / (RAND_MAX + 1.0));
1582         candidate = reqtracks[r];
1583         switch(check_suitable(candidate, tid,
1584                               required_tags, prohibited_tags)) {
1585         case 0:
1586           track = candidate;
1587           break;
1588         case DB_NOTFOUND:
1589           break;
1590         case DB_LOCK_DEADLOCK:
1591           goto fail;
1592         }
1593       }
1594     } else {
1595       /* No required tags.  We pick random record numbers in the database
1596        * instead. */
1597       switch(err = trackdb_tracksdb->stat(trackdb_tracksdb, tid, &sp, 0)) {
1598       case 0:
1599         break;
1600       case DB_LOCK_DEADLOCK:
1601         error(0, "error querying tracks.db: %s", db_strerror(err));
1602         goto fail;
1603       default:
1604         fatal(0, "error querying tracks.db: %s", db_strerror(err));
1605       }
1606       if(!sp->bt_nkeys)
1607         error(0, "cannot pick tracks at random from an empty database");
1608       while(sp->bt_nkeys && !track && tries-- > 0) {
1609         /* record numbers count from 1 upwards */
1610         r = 1 + (rand() * (double)sp->bt_nkeys / (RAND_MAX + 1.0));
1611         memset(&key, sizeof key, 0);
1612         key.flags = DB_DBT_MALLOC;
1613         key.size = sizeof r;
1614         key.data = &r;
1615         switch(err = trackdb_tracksdb->get(trackdb_tracksdb, tid, &key, prepare_data(&data),
1616                                            DB_SET_RECNO)) {
1617         case 0:
1618           break;
1619         case DB_LOCK_DEADLOCK:
1620           error(0, "error querying tracks.db: %s", db_strerror(err));
1621           goto fail;
1622         default:
1623           fatal(0, "error querying tracks.db: %s", db_strerror(err));
1624         }
1625         candidate = xstrndup(key.data, key.size);
1626         switch(check_suitable(candidate, tid,
1627                               required_tags, prohibited_tags)) {
1628         case 0:
1629           track = candidate;
1630           break;
1631         case DB_NOTFOUND:
1632           break;
1633         case DB_LOCK_DEADLOCK:
1634           goto fail;
1635         }
1636       }
1637     }
1638     break;
1639 fail:
1640     trackdb_closecursor(c);
1641     c = 0;
1642     trackdb_abort_transaction(tid);
1643   }
1644   trackdb_commit_transaction(tid);
1645   if(!track)
1646     error(0, "could not pick a random track");
1647   return track;
1648 }
1649
1650 /* get a track name given the prefs.  Set *used_db to 1 if we got the answer
1651  * from the prefs. */
1652 static const char *getpart(const char *track,
1653                            const char *context,
1654                            const char *part,
1655                            const struct kvp *p,
1656                            int *used_db) {
1657   const char *result;
1658   char *pref;
1659
1660   byte_xasprintf(&pref, "trackname_%s_%s", context, part);
1661   if((result = kvp_get(p, pref)))
1662     *used_db = 1;
1663   else
1664     result = trackname_part(track, context, part);
1665   assert(result != 0);
1666   return result;
1667 }
1668
1669 /* get a track name part, like trackname_part(), but taking the database into
1670  * account. */
1671 const char *trackdb_getpart(const char *track,
1672                             const char *context,
1673                             const char *part) {
1674   struct kvp *p;
1675   DB_TXN *tid;
1676   char *pref;
1677   const char *actual;
1678   int used_db, err;
1679
1680   /* construct the full pref */
1681   byte_xasprintf(&pref, "trackname_%s_%s", context, part);
1682   for(;;) {
1683     tid = trackdb_begin_transaction();
1684     if((err = gettrackdata(track, 0, &p, &actual, 0, tid)) == DB_LOCK_DEADLOCK)
1685       goto fail;
1686     break;
1687 fail:
1688     trackdb_abort_transaction(tid);
1689   }
1690   trackdb_commit_transaction(tid);
1691   return getpart(actual, context, part, p, &used_db);
1692 }
1693
1694 /* get the raw path name for @track@ (might be an alias) */
1695 const char *trackdb_rawpath(const char *track) {
1696   DB_TXN *tid;
1697   struct kvp *t;
1698   const char *path;
1699
1700   for(;;) {
1701     tid = trackdb_begin_transaction();
1702     if(gettrackdata(track, &t, 0, 0, 0, tid) == DB_LOCK_DEADLOCK)
1703       goto fail;
1704     break;
1705 fail:
1706     trackdb_abort_transaction(tid);
1707   }
1708   trackdb_commit_transaction(tid);
1709   if(!(path = kvp_get(t, "_path"))) path = track;
1710   return path;
1711 }
1712
1713 /* trackdb_list **************************************************************/
1714
1715 /* this is incredibly ugly, sorry, perhaps it will be rewritten to be actually
1716  * readable at some point */
1717
1718 /* return true if the basename of TRACK[0..TL-1], as defined by DL, matches RE.
1719  * If RE is a null pointer then it matches everything. */
1720 static int track_matches(size_t dl, const char *track, size_t tl,
1721                          const pcre *re) {
1722   int ovec[3], rc;
1723
1724   if(!re)
1725     return 1;
1726   track += dl + 1;
1727   tl -= (dl + 1);
1728   switch(rc = pcre_exec(re, 0, track, tl, 0, 0, ovec, 3)) {
1729   case PCRE_ERROR_NOMATCH: return 0;
1730   default:
1731     if(rc < 0) {
1732       error(0, "pcre_exec returned %d, subject '%s'", rc, track);
1733       return 0;
1734     }
1735     return 1;
1736   }
1737 }
1738
1739 static int do_list(struct vector *v, const char *dir,
1740                    enum trackdb_listable what, const pcre *re, DB_TXN *tid) {
1741   DBC *cursor;
1742   DBT k, d;
1743   size_t dl;
1744   char *ptr;
1745   int err;
1746   size_t l, last_dir_len = 0;
1747   char *last_dir = 0, *track, *alias;
1748   struct kvp *p;
1749   
1750   dl = strlen(dir);
1751   cursor = trackdb_opencursor(trackdb_tracksdb, tid);
1752   make_key(&k, dir);
1753   prepare_data(&d);
1754   /* find the first key >= dir */
1755   err = cursor->c_get(cursor, &k, &d, DB_SET_RANGE);
1756   /* keep going while we're dealing with <dir/anything> */
1757   while(err == 0
1758         && k.size > dl
1759         && ((char *)k.data)[dl] == '/'
1760         && !memcmp(k.data, dir, dl)) {
1761     ptr = memchr((char *)k.data + dl + 1, '/', k.size - (dl + 1));
1762     if(ptr) {
1763       /* we have <dir/component/anything>, so <dir/component> is a directory */
1764       l = ptr - (char *)k.data;
1765       if(what & trackdb_directories)
1766         if(!(last_dir
1767              && l == last_dir_len
1768              && !memcmp(last_dir, k.data, l))) {
1769           last_dir = xstrndup(k.data, last_dir_len = l);
1770           if(track_matches(dl, k.data, l, re))
1771             vector_append(v, last_dir);
1772         }
1773     } else {
1774       /* found a plain file */
1775       if((what & trackdb_files)) {
1776         track = xstrndup(k.data, k.size);
1777         if((err = trackdb_getdata(trackdb_prefsdb,
1778                                   track, &p, tid)) == DB_LOCK_DEADLOCK)
1779           goto deadlocked;
1780         /* if this file has an alias in the same directory then we skip it */
1781         if((err = compute_alias(&alias, track, p, tid)))
1782           goto deadlocked;
1783         if(!(alias && !strcmp(d_dirname(alias), d_dirname(track))))
1784           if(track_matches(dl, k.data, k.size, re))
1785             vector_append(v, track);
1786       }
1787     }
1788     err = cursor->c_get(cursor, &k, &d, DB_NEXT);
1789   }
1790   switch(err) {
1791   case 0:
1792     break;
1793   case DB_NOTFOUND:
1794     err = 0;
1795     break;
1796   case DB_LOCK_DEADLOCK:
1797     error(0, "error querying database: %s", db_strerror(err));
1798     break;
1799   default:
1800     fatal(0, "error querying database: %s", db_strerror(err));
1801   }
1802 deadlocked:
1803   if(trackdb_closecursor(cursor)) err = DB_LOCK_DEADLOCK;
1804   return err;
1805 }
1806
1807 /* return the directories or files below @dir@ */
1808 char **trackdb_list(const char *dir, int *np, enum trackdb_listable what,
1809                     const pcre *re) {
1810   DB_TXN *tid;
1811   int n;
1812   struct vector v;
1813
1814   vector_init(&v);
1815   for(;;) {
1816     tid = trackdb_begin_transaction();
1817     v.nvec = 0;
1818     if(dir) {
1819       if(do_list(&v, dir, what, re, tid))
1820         goto fail;
1821     } else {
1822       for(n = 0; n < config->collection.n; ++n)
1823         if(do_list(&v, config->collection.s[n].root, what, re, tid))
1824           goto fail;
1825     }
1826     break;
1827 fail:
1828     trackdb_abort_transaction(tid);
1829   }
1830   trackdb_commit_transaction(tid);
1831   vector_terminate(&v);
1832   if(np)
1833     *np = v.nvec;
1834   return v.vec;
1835 }  
1836
1837 /* If S is tag:something, return something.  Else return 0. */
1838 static const char *checktag(const char *s) {
1839   if(!strncmp(s, "tag:", 4))
1840     return s + 4;
1841   else
1842     return 0;
1843 }
1844
1845 /* return a list of tracks containing all of the words given.  If you
1846  * ask for only stopwords you get no tracks. */
1847 char **trackdb_search(char **wordlist, int nwordlist, int *ntracks) {
1848   const char **w, *best = 0, *tag;
1849   char **twords, **tags;
1850   int i, j, n, err, what;
1851   DBC *cursor = 0;
1852   DBT k, d;
1853   struct vector u, v;
1854   DB_TXN *tid;
1855   struct kvp *p;
1856   int ntags = 0;
1857   DB *db;
1858   const char *dbname;
1859
1860   *ntracks = 0;                         /* for early returns */
1861   /* normalize all the words */
1862   w = xmalloc(nwordlist * sizeof (char *));
1863   for(n = 0; n < nwordlist; ++n) {
1864     uint32_t *w32;
1865     size_t nw32;
1866     
1867     w[n] = utf8_casefold_compat(wordlist[n], strlen(wordlist[n]), 0);
1868     if(checktag(w[n])) ++ntags;         /* count up tags */
1869     /* Strip out combining characters (AFTER checking whether it's a tag) */
1870     if(!(w32 = utf8_to_utf32(w[n], strlen(w[n]), &nw32)))
1871       return 0;
1872     nw32 = remove_combining_chars(w32, nw32);
1873     if(!(w[n] = utf32_to_utf8(w32, nw32, 0)))
1874       return 0;
1875   }
1876   /* find the longest non-stopword */
1877   for(n = 0; n < nwordlist; ++n)
1878     if(!stopword(w[n]) && !checktag(w[n]))
1879       if(!best || strlen(w[n]) > strlen(best))
1880         best = w[n];
1881   /* TODO: we should at least in principal be able to identify the word or tag
1882    * with the least matches in log time, and choose that as our primary search
1883    * term. */
1884   if(ntags && !best) {
1885     /* Only tags are listed.  We limit to the first and narrow down with the
1886      * rest. */
1887     best = checktag(w[0]);
1888     db = trackdb_tagsdb;
1889     dbname = "tags";
1890   } else if(best) {
1891     /* We can limit to some word. */
1892     db = trackdb_searchdb;
1893     dbname = "search";
1894   } else {
1895     /* Only stopwords */
1896     return 0;
1897   }
1898   vector_init(&u);
1899   vector_init(&v);
1900   for(;;) {
1901     tid = trackdb_begin_transaction();
1902     /* find all the tracks that have that word */
1903     make_key(&k, best);
1904     prepare_data(&d);
1905     what = DB_SET;
1906     v.nvec = 0;
1907     cursor = trackdb_opencursor(db, tid);
1908     while(!(err = cursor->c_get(cursor, &k, &d, what))) {
1909       vector_append(&v, xstrndup(d.data, d.size));
1910       what = DB_NEXT_DUP;
1911     }
1912     switch(err) {
1913     case DB_NOTFOUND:
1914       err = 0;
1915       break;
1916     case DB_LOCK_DEADLOCK:
1917       error(0, "error querying %s database: %s", dbname, db_strerror(err));
1918       break;
1919     default:
1920       fatal(0, "error querying %s database: %s", dbname, db_strerror(err));
1921     }
1922     if(trackdb_closecursor(cursor)) err = DB_LOCK_DEADLOCK;
1923     cursor = 0;
1924     /* do a naive search over that (hopefuly fairly small) list of tracks */
1925     u.nvec = 0;
1926     for(n = 0; n < v.nvec; ++n) {
1927       if((err = gettrackdata(v.vec[n], 0, &p, 0, 0, tid) == DB_LOCK_DEADLOCK))
1928         goto fail;
1929       else if(err) {
1930         error(0, "track %s unexpected error: %s", v.vec[n], db_strerror(err));
1931         continue;
1932       }
1933       twords = track_to_words(v.vec[n], p);
1934       tags = parsetags(kvp_get(p, "tags"));
1935       for(i = 0; i < nwordlist; ++i) {
1936         if((tag = checktag(w[i]))) {
1937           /* Track must have this tag */
1938           for(j = 0; tags[j]; ++j)
1939             if(!strcmp(tag, tags[j])) break; /* tag found */
1940           if(!tags[j]) break;           /* tag not found */
1941         } else {
1942           /* Track must contain this word */
1943           for(j = 0; twords[j]; ++j)
1944             if(!strcmp(w[i], twords[j])) break; /* word found */
1945           if(!twords[j]) break;         /* word not found */
1946         }
1947       }
1948       if(i >= nwordlist)                /* all words found */
1949         vector_append(&u, v.vec[n]);
1950     }
1951     break;
1952   fail:
1953     trackdb_closecursor(cursor);
1954     cursor = 0;
1955     trackdb_abort_transaction(tid);
1956     info("retrying search");
1957   }
1958   trackdb_commit_transaction(tid);
1959   vector_terminate(&u);
1960   if(ntracks)
1961     *ntracks = u.nvec;
1962   return u.vec;
1963 }
1964
1965 /* trackdb_scan **************************************************************/
1966
1967 int trackdb_scan(const char *root,
1968                  int (*callback)(const char *track,
1969                                  struct kvp *data,
1970                                  void *u,
1971                                  DB_TXN *tid),
1972                  void *u,
1973                  DB_TXN *tid) {
1974   DBC *cursor;
1975   DBT k, d;
1976   const size_t root_len = root ? strlen(root) : 0;
1977   int err, cberr;
1978   struct kvp *data;
1979   const char *track;
1980
1981   cursor = trackdb_opencursor(trackdb_tracksdb, tid);
1982   if(root)
1983     err = cursor->c_get(cursor, make_key(&k, root), prepare_data(&d),
1984                         DB_SET_RANGE);
1985   else {
1986     memset(&k, 0, sizeof k);
1987     err = cursor->c_get(cursor, &k, prepare_data(&d),
1988                         DB_FIRST);
1989   }
1990   while(!err) {
1991     if(!root
1992        || (k.size > root_len
1993            && !strncmp(k.data, root, root_len)
1994            && ((char *)k.data)[root_len] == '/')) {
1995       data = kvp_urldecode(d.data, d.size);
1996       if(kvp_get(data, "_path")) {
1997         track = xstrndup(k.data, k.size);
1998         /* Advance to the next track before the callback so that the callback
1999          * may safely delete the track */
2000         err = cursor->c_get(cursor, &k, &d, DB_NEXT);
2001         if((cberr = callback(track, data, u, tid))) {
2002           err = cberr;
2003           break;
2004         }
2005       } else
2006         err = cursor->c_get(cursor, &k, &d, DB_NEXT);
2007     } else
2008       break;
2009   }
2010   trackdb_closecursor(cursor);
2011   switch(err) {
2012   case EINTR:
2013     return err;
2014   case 0:
2015   case DB_NOTFOUND:
2016     return 0;
2017   case DB_LOCK_DEADLOCK:
2018     error(0, "c->c_get: %s", db_strerror(err));
2019     return err;
2020   default:
2021     fatal(0, "c->c_get: %s", db_strerror(err));
2022   }
2023 }
2024
2025 /* trackdb_rescan ************************************************************/
2026
2027 /* called when the rescanner terminates */
2028 static int reap_rescan(ev_source attribute((unused)) *ev,
2029                        pid_t pid,
2030                        int status,
2031                        const struct rusage attribute((unused)) *rusage,
2032                        void attribute((unused)) *u) {
2033   if(pid == rescan_pid) rescan_pid = -1;
2034   if(status)
2035     error(0, RESCAN": %s", wstat(status));
2036   else
2037     D((RESCAN" terminated: %s", wstat(status)));
2038   /* Our cache of file lookups is out of date now */
2039   cache_clean(&cache_files_type);
2040   eventlog("rescanned", (char *)0);
2041   return 0;
2042 }
2043
2044 void trackdb_rescan(ev_source *ev) {
2045   int w;
2046
2047   if(rescan_pid != -1) {
2048     error(0, "rescan already underway");
2049     return;
2050   }
2051   rescan_pid = subprogram(ev, RESCAN, -1);
2052   if(ev) {
2053     ev_child(ev, rescan_pid, 0, reap_rescan, 0);
2054     D(("started rescanner"));
2055   } else {
2056     /* This is the first rescan, we block until it is complete */
2057     while(waitpid(rescan_pid, &w, 0) < 0 && errno == EINTR)
2058       ;
2059     reap_rescan(0, rescan_pid, w, 0, 0);
2060   }
2061 }
2062
2063 int trackdb_rescan_cancel(void) {
2064   if(rescan_pid == -1) return 0;
2065   if(kill(rescan_pid, SIGTERM) < 0)
2066     fatal(errno, "error killing rescanner");
2067   rescan_pid = -1;
2068   return 1;
2069 }
2070
2071 /* global prefs **************************************************************/
2072
2073 void trackdb_set_global(const char *name,
2074                         const char *value,
2075                         const char *who) {
2076   DB_TXN *tid;
2077   int err;
2078   int state;
2079
2080   for(;;) {
2081     tid = trackdb_begin_transaction();
2082     if(!(err = trackdb_set_global_tid(name, value, tid)))
2083       break;
2084     trackdb_abort_transaction(tid);
2085   }
2086   trackdb_commit_transaction(tid);
2087   /* log important state changes */
2088   if(!strcmp(name, "playing")) {
2089     state = !value || !strcmp(value, "yes");
2090     info("playing %s by %s",
2091          state ? "enabled" : "disabled",
2092          who ? who : "-");
2093     eventlog("state", state ? "enable_play" : "disable_play", (char *)0);
2094   }
2095   if(!strcmp(name, "random-play")) {
2096     state = !value || !strcmp(value, "yes");
2097     info("random play %s by %s",
2098          state ? "enabled" : "disabled",
2099          who ? who : "-");
2100     eventlog("state", state ? "enable_random" : "disable_random", (char *)0);
2101   }
2102   if(!strcmp(name, "required-tags"))
2103     reqtracks = 0;
2104 }
2105
2106 int trackdb_set_global_tid(const char *name,
2107                            const char *value,
2108                            DB_TXN *tid) {
2109   DBT k, d;
2110   int err;
2111
2112   memset(&k, 0, sizeof k);
2113   memset(&d, 0, sizeof d);
2114   k.data = (void *)name;
2115   k.size = strlen(name);
2116   if(value) {
2117     d.data = (void *)value;
2118     d.size = strlen(value);
2119   }
2120   if(value)
2121     err = trackdb_globaldb->put(trackdb_globaldb, tid, &k, &d, 0);
2122   else
2123     err = trackdb_globaldb->del(trackdb_globaldb, tid, &k, 0);
2124   if(err == DB_LOCK_DEADLOCK) return err;
2125   if(err)
2126     fatal(0, "error updating database: %s", db_strerror(err));
2127   return 0;
2128 }
2129
2130 const char *trackdb_get_global(const char *name) {
2131   DB_TXN *tid;
2132   int err;
2133   const char *r;
2134
2135   for(;;) {
2136     tid = trackdb_begin_transaction();
2137     if(!(err = trackdb_get_global_tid(name, tid, &r)))
2138       break;
2139     trackdb_abort_transaction(tid);
2140   }
2141   trackdb_commit_transaction(tid);
2142   return r;
2143 }
2144
2145 int trackdb_get_global_tid(const char *name,
2146                            DB_TXN *tid,
2147                            const char **rp) {
2148   DBT k, d;
2149   int err;
2150
2151   memset(&k, 0, sizeof k);
2152   k.data = (void *)name;
2153   k.size = strlen(name);
2154   switch(err = trackdb_globaldb->get(trackdb_globaldb, tid, &k,
2155                                      prepare_data(&d), 0)) {
2156   case 0:
2157     *rp = xstrndup(d.data, d.size);
2158     return 0;
2159   case DB_NOTFOUND:
2160     *rp = 0;
2161     return 0;
2162   case DB_LOCK_DEADLOCK:
2163     return err;
2164   default:
2165     fatal(0, "error reading database: %s", db_strerror(err));
2166   }
2167 }
2168
2169 /** @brief Retrieve the most recently added tracks
2170  * @param ntracksp Where to put count, or 0
2171  * @param maxtracks Maximum number of tracks to retrieve
2172  * @return null-terminated array of track names
2173  *
2174  * The most recently added track is first in the array.
2175  */
2176 char **trackdb_new(int *ntracksp,
2177                    int maxtracks) {
2178   DB_TXN *tid;
2179   char **tracks;
2180
2181   for(;;) {
2182     tid = trackdb_begin_transaction();
2183     tracks = trackdb_new_tid(ntracksp, maxtracks, tid);
2184     if(tracks)
2185       break;
2186     trackdb_abort_transaction(tid);
2187   }
2188   trackdb_commit_transaction(tid);
2189   return tracks;
2190 }
2191
2192 /** @brief Retrieve the most recently added tracks
2193  * @param ntracksp Where to put count, or 0
2194  * @param maxtracks Maximum number of tracks to retrieve, or 0 for all
2195  * @param tid Transaction ID
2196  * @return null-terminated array of track names, or NULL on deadlock
2197  *
2198  * The most recently added track is first in the array.
2199  */
2200 static char **trackdb_new_tid(int *ntracksp,
2201                               int maxtracks,
2202                               DB_TXN *tid) {
2203   DBC *c;
2204   DBT k, d;
2205   int err = 0;
2206   struct vector tracks[1];
2207
2208   vector_init(tracks);
2209   c = trackdb_opencursor(trackdb_noticeddb, tid);
2210   while((maxtracks <= 0 || tracks->nvec < maxtracks)
2211         && !(err = c->c_get(c, prepare_data(&k), prepare_data(&d), DB_PREV)))
2212     vector_append(tracks, xstrndup(d.data, d.size));
2213   switch(err) {
2214   case 0:                               /* hit maxtracks */
2215   case DB_NOTFOUND:                     /* ran out of tracks */
2216     break;
2217   case DB_LOCK_DEADLOCK:
2218     trackdb_closecursor(c);
2219     return 0;
2220   default:
2221     fatal(0, "error reading noticed.db: %s", db_strerror(err));
2222   }
2223   if((err = trackdb_closecursor(c)))
2224     return 0;                           /* deadlock */
2225   vector_terminate(tracks);
2226   if(ntracksp)
2227     *ntracksp = tracks->nvec;
2228   return tracks->vec;
2229 }
2230
2231 /** @brief Expire noticed.db
2232  * @param earliest Earliest timestamp to keep
2233  */
2234 void trackdb_expire_noticed(time_t earliest) {
2235   DB_TXN *tid;
2236
2237   for(;;) {
2238     tid = trackdb_begin_transaction();
2239     if(!trackdb_expire_noticed_tid(earliest, tid))
2240       break;
2241     trackdb_abort_transaction(tid);
2242   }
2243   trackdb_commit_transaction(tid);
2244 }
2245
2246 /** @brief Expire noticed.db
2247  * @param earliest Earliest timestamp to keep
2248  * @param tid Transaction ID
2249  * @return 0 or DB_LOCK_DEADLOCK
2250  */
2251 static int trackdb_expire_noticed_tid(time_t earliest, DB_TXN *tid) {
2252   DBC *c;
2253   DBT k, d;
2254   int err = 0, ret;
2255   time_t when;
2256   uint32_t *kk;
2257   int count = 0;
2258
2259   c = trackdb_opencursor(trackdb_noticeddb, tid);
2260   while(!(err = c->c_get(c, prepare_data(&k), prepare_data(&d), DB_NEXT))) {
2261     kk = k.data;
2262     when = (time_t)(((uint64_t)ntohl(kk[0]) << 32) + ntohl(kk[1]));
2263     if(when >= earliest)
2264       break;
2265     if((err = c->c_del(c, 0))) {
2266       if(err != DB_LOCK_DEADLOCK)
2267         fatal(0, "error deleting expired noticed.db entry: %s",
2268               db_strerror(err));
2269       break;
2270     }
2271     ++count;
2272   }
2273   if(err == DB_NOTFOUND)
2274     err = 0;
2275   if(err && err != DB_LOCK_DEADLOCK)
2276     fatal(0, "error expiring noticed.db: %s", db_strerror(err));
2277   ret = err;
2278   if((err = trackdb_closecursor(c))) {
2279     if(err != DB_LOCK_DEADLOCK)
2280       fatal(0, "error closing cursor: %s", db_strerror(err));
2281     ret = err;
2282   }
2283   if(!ret && count)
2284     info("expired %d tracks from noticed.db", count);
2285   return ret;
2286 }
2287
2288 /* tidying up ****************************************************************/
2289
2290 void trackdb_gc(void) {
2291   int err;
2292   char **logfiles;
2293
2294   if((err = trackdb_env->txn_checkpoint(trackdb_env,
2295                                         config->checkpoint_kbyte,
2296                                         config->checkpoint_min,
2297                                         0)))
2298     fatal(0, "trackdb_env->txn_checkpoint: %s", db_strerror(err));
2299   if((err = trackdb_env->log_archive(trackdb_env, &logfiles, DB_ARCH_REMOVE)))
2300     fatal(0, "trackdb_env->log_archive: %s", db_strerror(err));
2301   /* This makes catastrophic recovery impossible.  However, the user can still
2302    * preserve the important data by using disorder-dump to snapshot their
2303    * prefs, and later to restore it.  This is likely to have much small
2304    * long-term storage requirements than record the db logfiles. */
2305 }
2306
2307 /*
2308 Local Variables:
2309 c-basic-offset:2
2310 comment-column:40
2311 fill-column:79
2312 indent-tabs-mode:nil
2313 End:
2314 */