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