afh_recv: Improve documentation of --begin-chunk.
[paraslash.git] / aft.c
1 /*
2  * Copyright (C) 2007 Andre Noll <maan@tuebingen.mpg.de>
3  *
4  * Licensed under the GPL v2. For licencing details see COPYING.
5  */
6
7 /** \file aft.c Audio file table functions. */
8
9 #include <regex.h>
10 #include <sys/mman.h>
11 #include <fnmatch.h>
12 #include <sys/shm.h>
13 #include <osl.h>
14
15 #include "para.h"
16 #include "error.h"
17 #include "crypt.h"
18 #include "string.h"
19 #include "afh.h"
20 #include "afs.h"
21 #include "fd.h"
22 #include "ipc.h"
23 #include "portable_io.h"
24 #include "sideband.h"
25 #include "command.h"
26
27 static struct osl_table *audio_file_table;
28 static char *status_items;
29 static char *parser_friendly_status_items;
30
31 /** The different sorting methods of the ls command. */
32 enum ls_sorting_method {
33         /** -sp (default) */
34         LS_SORT_BY_PATH,
35         /** -ss */
36         LS_SORT_BY_SCORE,
37         /** -sl */
38         LS_SORT_BY_LAST_PLAYED,
39         /** -sn */
40         LS_SORT_BY_NUM_PLAYED,
41         /** -sf */
42         LS_SORT_BY_FREQUENCY,
43         /** -sc */
44         LS_SORT_BY_CHANNELS,
45         /** -si */
46         LS_SORT_BY_IMAGE_ID,
47         /** -sy */
48         LS_SORT_BY_LYRICS_ID,
49         /** -sb */
50         LS_SORT_BY_BITRATE,
51         /** -sd */
52         LS_SORT_BY_DURATION,
53         /** -sa */
54         LS_SORT_BY_AUDIO_FORMAT,
55         /** -sh */
56         LS_SORT_BY_HASH,
57 };
58
59 /** The different listing modes of the ls command. */
60 enum ls_listing_mode {
61         /** Default listing mode. */
62         LS_MODE_SHORT,
63         /** -l or -ll */
64         LS_MODE_LONG,
65         /** -lv */
66         LS_MODE_VERBOSE,
67         /** -lm */
68         LS_MODE_MBOX,
69         /** -lc */
70         LS_MODE_CHUNKS,
71         /** -lp */
72         LS_MODE_PARSER,
73 };
74
75 /* Data about one audio file. Needed for ls and stat output. */
76 struct ls_data {
77         /* Usual audio format handler information. */
78         struct afh_info afhi;
79         /* Audio file selector information. */
80         struct afs_info afsi;
81         /* The full path of the audio file. */
82         char *path;
83         /* The score value (if -a was given). */
84         long score;
85         /* The hash value of the audio file data. */
86         unsigned char *hash;
87 };
88
89 /** The flags accepted by the ls command. */
90 enum ls_flags {
91         /** -p */
92         LS_FLAG_FULL_PATH = 1,
93         /** -a */
94         LS_FLAG_ADMISSIBLE_ONLY = 2,
95         /** -r */
96         LS_FLAG_REVERSE = 4,
97         /** -d */
98         LS_FLAG_UNIXDATE = 8,
99 };
100
101 /**
102  * The size of the individual output fields of the ls command.
103  *
104  * These depend on the content being listed. For example, if each listed file
105  * is shorter than an hour, the duration format is set to mm:ss. Otherwise it
106  * is set to hh:mm:ss.
107  */
108 struct ls_widths {
109         /** size of the score field. */
110         unsigned short score_width;
111         /** size of the image id field. */
112         unsigned short image_id_width;
113         /** size of the lyrics id field. */
114         unsigned short lyrics_id_width;
115         /** size of the bitrate field. */
116         unsigned short bitrate_width;
117         /** size of the frequency field. */
118         unsigned short frequency_width;
119         /** size of the duration field. */
120         unsigned short duration_width;
121         /** size of the num played field. */
122         unsigned short num_played_width;
123         /** size of the amp field. */
124         unsigned short amp_width;
125         /** size of the audio format field. */
126         unsigned short audio_format_width;
127 };
128
129 /** Data passed from the ls command handler to its callback function. */
130 struct ls_options {
131         /** The given command line flags. */
132         unsigned flags;
133         /** The sorting method given at the command line. */
134         enum ls_sorting_method sorting;
135         /** The given listing mode (short, long, verbose, mbox). */
136         enum ls_listing_mode mode;
137         /** The arguments passed to the ls command. */
138         char **patterns;
139         /** Number of non-option arguments. */
140         int num_patterns;
141         /** Used for long listing mode to align the output fields. */
142         struct ls_widths widths;
143         /** Size of the \a data array. */
144         uint32_t array_size;
145         /** Number of used entries in the data array. */
146         uint32_t num_matching_paths;
147         /** Array of matching entries. */
148         struct ls_data *data;
149         /** Used to sort the array. */
150         struct ls_data **data_ptr;
151 };
152
153 /**
154  * Describes the layout of the mmapped-afs info struct.
155  *
156  * \sa struct afs_info.
157  */
158 enum afsi_offsets {
159         /** Where .last_played is stored. */
160         AFSI_LAST_PLAYED_OFFSET = 0,
161         /** Storage position of the attributes bitmap. */
162         AFSI_ATTRIBUTES_OFFSET = 8,
163         /** Storage position of the .num_played field. */
164         AFSI_NUM_PLAYED_OFFSET = 16,
165         /** Storage position of the .image_id field. */
166         AFSI_IMAGE_ID_OFFSET = 20,
167         /** Storage position of the .lyrics_id field. */
168         AFSI_LYRICS_ID_OFFSET = 24,
169         /** Storage position of the .audio_format_id field. */
170         AFSI_AUDIO_FORMAT_ID_OFFSET = 28,
171         /** Storage position of the amplification field. */
172         AFSI_AMP_OFFSET = 29,
173         /** 2 bytes reserved space for future usage. */
174         AFSI_AUDIO_FORMAT_UNUSED_OFFSET = 30,
175         /** On-disk storage space needed. */
176         AFSI_SIZE = 32
177 };
178
179 /*
180  * Convert a struct afs_info to an osl object.
181  *
182  * \param afsi Pointer to the audio file info to be converted.
183  * \param obj Result pointer.
184  *
185  * \sa load_afsi().
186  */
187 static void save_afsi(struct afs_info *afsi, struct osl_object *obj)
188 {
189         char *buf = obj->data;
190
191         write_u64(buf + AFSI_LAST_PLAYED_OFFSET, afsi->last_played);
192         write_u64(buf + AFSI_ATTRIBUTES_OFFSET, afsi->attributes);
193         write_u32(buf + AFSI_NUM_PLAYED_OFFSET, afsi->num_played);
194         write_u32(buf + AFSI_IMAGE_ID_OFFSET, afsi->image_id);
195         write_u32(buf + AFSI_LYRICS_ID_OFFSET, afsi->lyrics_id);
196         write_u8(buf + AFSI_AUDIO_FORMAT_ID_OFFSET,
197                 afsi->audio_format_id);
198         write_u8(buf + AFSI_AMP_OFFSET, afsi->amp);
199         memset(buf + AFSI_AUDIO_FORMAT_UNUSED_OFFSET, 0, 2);
200 }
201
202 /*
203  * Get the audio file selector info struct stored in an osl object.
204  *
205  * \param afsi Points to the audio_file info structure to be filled in.
206  * \param obj The osl object holding the data.
207  *
208  * \return Standard.
209  *
210  * \sa save_afsi().
211  */
212 static int load_afsi(struct afs_info *afsi, struct osl_object *obj)
213 {
214         char *buf = obj->data;
215         if (obj->size < AFSI_SIZE)
216                 return -E_BAD_AFSI;
217         afsi->last_played = read_u64(buf + AFSI_LAST_PLAYED_OFFSET);
218         afsi->attributes = read_u64(buf + AFSI_ATTRIBUTES_OFFSET);
219         afsi->num_played = read_u32(buf + AFSI_NUM_PLAYED_OFFSET);
220         afsi->image_id = read_u32(buf + AFSI_IMAGE_ID_OFFSET);
221         afsi->lyrics_id = read_u32(buf + AFSI_LYRICS_ID_OFFSET);
222         afsi->audio_format_id = read_u8(buf +
223                 AFSI_AUDIO_FORMAT_ID_OFFSET);
224         afsi->amp = read_u8(buf + AFSI_AMP_OFFSET);
225         return 1;
226 }
227
228 /** The columns of the audio file table. */
229 enum audio_file_table_columns {
230         /** The hash on the content of the audio file. */
231         AFTCOL_HASH,
232         /** The full path in the filesystem. */
233         AFTCOL_PATH,
234         /** The audio file selector info. */
235         AFTCOL_AFSI,
236         /** The audio format handler info. */
237         AFTCOL_AFHI,
238         /** The chunk table info and the chunk table of the audio file. */
239         AFTCOL_CHUNKS,
240         /** The number of columns of this table. */
241         NUM_AFT_COLUMNS
242 };
243
244 /* compare function for the hash column */
245 static int aft_hash_compare(const struct osl_object *obj1,
246                 const struct osl_object *obj2)
247 {
248         return hash_compare((unsigned char *)obj1->data,
249                 (unsigned char *)obj2->data);
250 }
251
252 static struct osl_column_description aft_cols[] = {
253         [AFTCOL_HASH] = {
254                 .storage_type = OSL_MAPPED_STORAGE,
255                 .storage_flags = OSL_RBTREE | OSL_FIXED_SIZE | OSL_UNIQUE,
256                 .name = "hash",
257                 .compare_function = aft_hash_compare,
258                 .data_size = HASH_SIZE
259         },
260         [AFTCOL_PATH] = {
261                 .storage_type = OSL_MAPPED_STORAGE,
262                 .storage_flags = OSL_RBTREE | OSL_UNIQUE,
263                 .name = "path",
264                 .compare_function = string_compare,
265         },
266         [AFTCOL_AFSI] = {
267                 .storage_type = OSL_MAPPED_STORAGE,
268                 .storage_flags = OSL_FIXED_SIZE,
269                 .name = "afs_info",
270                 .data_size = AFSI_SIZE
271         },
272         [AFTCOL_AFHI] = {
273                 .storage_type = OSL_MAPPED_STORAGE,
274                 .name = "afh_info",
275         },
276         [AFTCOL_CHUNKS] = {
277                 .storage_type = OSL_DISK_STORAGE,
278                 .name = "chunks",
279         }
280 };
281
282 static struct osl_table_description audio_file_table_desc = {
283         .name = "audio_files",
284         .num_columns = NUM_AFT_COLUMNS,
285         .flags = OSL_LARGE_TABLE,
286         .column_descriptions = aft_cols
287 };
288
289 /*
290  * Produce a canonicalized absolute pathname.
291  *
292  * Returns one if the resolved path a directory, zero if it is a regular file,
293  * negative on errors.
294  */
295 static int verify_path(const char *orig_path, char **resolved_path)
296 {
297         int ret;
298         char *path = NULL;
299         struct stat statbuf;
300
301         if (*orig_path != '/') /* we only accept absolute paths */
302                 goto fail;
303         path = realpath(orig_path, NULL);
304         if (!path)
305                 goto fail;
306         if (stat(path, &statbuf) < 0)
307                 goto fail;
308         if (S_ISREG(statbuf.st_mode))
309                 ret = 0;
310         else if (S_ISDIR(statbuf.st_mode))
311                 ret = 1;
312         else
313                 goto fail;
314         *resolved_path = path;
315         return ret;
316 fail:
317         *resolved_path = NULL;
318         free(path);
319         return -E_BAD_PATH;
320 }
321
322 /** The on-disk layout of a afhi struct. */
323 enum afhi_offsets {
324         /** Where the number of seconds is stored. */
325         AFHI_SECONDS_TOTAL_OFFSET = 0,
326         /** Position of the bitrate. */
327         AFHI_BITRATE_OFFSET = 4,
328         /** Position of the frequency. */
329         AFHI_FREQUENCY_OFFSET = 8,
330         /** Was: Location of the audio file header. */
331         AFHI_UNUSED1_OFFSET = 12,
332         /* Length of the audio file header. Zero means: No header. */
333         AFHI_HEADER_LEN_OFFSET = 16,
334         /** The total number of chunks (4 bytes). */
335         CHUNKS_TOTAL_OFFSET = 20,
336         /** The length of the audio file header (4 bytes). */
337         HEADER_LEN_OFFSET = 24,
338         /** Was: The start of the audio file header (4 bytes). */
339         AFHI_UNUSED2_OFFSET = 28,
340         /** The seconds part of the chunk time (4 bytes). */
341         CHUNK_TV_TV_SEC_OFFSET = 32,
342         /** The microseconds part of the chunk time (4 bytes). */
343         CHUNK_TV_TV_USEC_OFFSET = 36,
344         /** Number of channels is stored here. (1 byte) */
345         AFHI_CHANNELS_OFFSET = 40,
346         /** The tag info position. */
347         AFHI_INFO_STRING_OFFSET = 41,
348         /** Minimal on-disk size of a valid afhi struct. */
349         MIN_AFHI_SIZE = 47, /* at least 6 null bytes for techinfo/tags */
350 };
351
352 static unsigned sizeof_afhi_buf(const struct afh_info *afhi)
353 {
354         if (!afhi)
355                 return 0;
356         return MIN_AFHI_SIZE
357                 + strlen(afhi->techinfo)
358                 + strlen(afhi->tags.artist)
359                 + strlen(afhi->tags.title)
360                 + strlen(afhi->tags.year)
361                 + strlen(afhi->tags.album)
362                 + strlen(afhi->tags.comment);
363 }
364
365 static void save_afhi(struct afh_info *afhi, char *buf)
366 {
367         char *p;
368
369         if (!afhi)
370                 return;
371         write_u32(buf + AFHI_SECONDS_TOTAL_OFFSET, afhi->seconds_total);
372         write_u32(buf + AFHI_BITRATE_OFFSET, afhi->bitrate);
373         write_u32(buf + AFHI_FREQUENCY_OFFSET, afhi->frequency);
374         write_u32(buf + AFHI_UNUSED1_OFFSET, 0);
375         write_u32(buf + AFHI_HEADER_LEN_OFFSET, afhi->header_len);
376         write_u8(buf + AFHI_CHANNELS_OFFSET, afhi->channels);
377         write_u32(buf + CHUNKS_TOTAL_OFFSET, afhi->chunks_total);
378         write_u32(buf + HEADER_LEN_OFFSET, afhi->header_len);
379         write_u32(buf + AFHI_UNUSED2_OFFSET, 0);
380         write_u32(buf + CHUNK_TV_TV_SEC_OFFSET, afhi->chunk_tv.tv_sec);
381         write_u32(buf + CHUNK_TV_TV_USEC_OFFSET, afhi->chunk_tv.tv_usec);
382         p = buf + AFHI_INFO_STRING_OFFSET;
383         /* The sprintf's below are OK as our caller made sure that buf is large enough */
384         p += sprintf(p, "%s", afhi->techinfo) + 1;
385         p += sprintf(p, "%s", afhi->tags.artist) + 1;
386         p += sprintf(p, "%s", afhi->tags.title) + 1;
387         p += sprintf(p, "%s", afhi->tags.year) + 1;
388         p += sprintf(p, "%s", afhi->tags.album) + 1;
389         sprintf(p, "%s", afhi->tags.comment);
390 }
391
392 static void load_afhi(const char *buf, struct afh_info *afhi)
393 {
394         afhi->seconds_total = read_u32(buf + AFHI_SECONDS_TOTAL_OFFSET);
395         afhi->bitrate = read_u32(buf + AFHI_BITRATE_OFFSET);
396         afhi->frequency = read_u32(buf + AFHI_FREQUENCY_OFFSET);
397         afhi->header_len = read_u32(buf + AFHI_HEADER_LEN_OFFSET);
398         afhi->channels = read_u8(buf + AFHI_CHANNELS_OFFSET);
399         afhi->chunks_total = read_u32(buf + CHUNKS_TOTAL_OFFSET);
400         afhi->header_len = read_u32(buf + HEADER_LEN_OFFSET);
401         afhi->chunk_tv.tv_sec = read_u32(buf + CHUNK_TV_TV_SEC_OFFSET);
402         afhi->chunk_tv.tv_usec = read_u32(buf + CHUNK_TV_TV_USEC_OFFSET);
403         afhi->techinfo = (char *)buf + AFHI_INFO_STRING_OFFSET;
404         afhi->tags.artist = afhi->techinfo + strlen(afhi->techinfo) + 1;
405         afhi->tags.title = afhi->tags.artist + strlen(afhi->tags.artist) + 1;
406         afhi->tags.year = afhi->tags.title + strlen(afhi->tags.title) + 1;
407         afhi->tags.album = afhi->tags.year + strlen(afhi->tags.year) + 1;
408         afhi->tags.comment = afhi->tags.album + strlen(afhi->tags.album) + 1;
409 }
410
411 static unsigned sizeof_chunk_table(struct afh_info *afhi)
412 {
413         if (!afhi)
414                 return 0;
415         return 4 * (afhi->chunks_total + 1);
416 }
417
418 static uint32_t save_chunk_table(struct afh_info *afhi, char *buf)
419 {
420         int i;
421         uint32_t max = 0, old = 0;
422
423         for (i = 0; i <= afhi->chunks_total; i++) {
424                 uint32_t val = afhi->chunk_table[i];
425                 write_u32(buf + 4 * i, val);
426                 /*
427                  * If the first chunk is the header, do not consider it for the
428                  * calculation of the largest chunk size.
429                  */
430                 if (i == 0 || (i == 1 && afhi->header_len > 0)) {
431                         old = val;
432                         continue;
433                 }
434                 max = PARA_MAX(max, val - old);
435                 old = val;
436         }
437         return max;
438 }
439
440 static void load_chunk_table(struct afh_info *afhi, char *buf)
441 {
442         int i;
443
444         afhi->chunk_table = para_malloc(sizeof_chunk_table(afhi));
445         for (i = 0; i <= afhi->chunks_total; i++)
446                 afhi->chunk_table[i] = read_u32(buf + 4 * i);
447 }
448
449 /**
450  * Get the row of the audio file table corresponding to the given path.
451  *
452  * \param path The full path of the audio file.
453  * \param row Result pointer.
454  *
455  * \return Standard.
456  */
457 int aft_get_row_of_path(const char *path, struct osl_row **row)
458 {
459         struct osl_object obj = {.data = (char *)path, .size = strlen(path) + 1};
460
461         return osl(osl_get_row(audio_file_table, AFTCOL_PATH, &obj, row));
462 }
463
464 /**
465  * Get the row of the audio file table corresponding to the given hash value.
466  *
467  * \param hash The hash value of the desired audio file.
468  * \param row Result pointer.
469  *
470  * \return Standard.
471  */
472 static int aft_get_row_of_hash(unsigned char *hash, struct osl_row **row)
473 {
474         const struct osl_object obj = {.data = hash, .size = HASH_SIZE};
475         return osl(osl_get_row(audio_file_table, AFTCOL_HASH, &obj, row));
476 }
477
478 /*
479  * Get the audio file selector info object of a row.
480  *
481  * \param row Pointer to a row in the audio file table.
482  * \param obj Result pointer.
483  *
484  * \return Standard.
485  */
486 static int get_afsi_object_of_row(const struct osl_row *row,
487                 struct osl_object *obj)
488 {
489         return osl(osl_get_object(audio_file_table, row, AFTCOL_AFSI, obj));
490 }
491
492 /**
493  * Get the osl object holding the audio file selector info, given a path.
494  *
495  *
496  * \param path The full path of the audio file.
497  * \param obj Result pointer.
498  *
499  * \return Positive on success, negative on errors.
500  */
501 static int get_afsi_object_of_path(const char *path, struct osl_object *obj)
502 {
503         struct osl_row *row;
504         int ret = aft_get_row_of_path(path, &row);
505         if (ret < 0)
506                 return ret;
507         return get_afsi_object_of_row(row, obj);
508 }
509
510 /**
511  * Get the audio file selector info, given a row of the audio file table.
512  *
513  * \param row Pointer to a row in the audio file table.
514  * \param afsi Result pointer.
515  *
516  * \return Positive on success, negative on errors.
517  */
518 int get_afsi_of_row(const struct osl_row *row, struct afs_info *afsi)
519 {
520         struct osl_object obj;
521         int ret = get_afsi_object_of_row(row, &obj);
522         if (ret < 0)
523                 return ret;
524         return load_afsi(afsi, &obj);
525 }
526
527 /*
528  * Get the audio file selector info, given the path of an audio table.
529  *
530  * \param path The full path of the audio file.
531  * \param afsi Result pointer.
532  *
533  * \return Standard.
534  */
535 static int get_afsi_of_path(const char *path, struct afs_info *afsi)
536 {
537         struct osl_object obj;
538         int ret = get_afsi_object_of_path(path, &obj);
539         if (ret < 0)
540                 return ret;
541         return load_afsi(afsi, &obj);
542 }
543
544 /**
545  * Get the path of an audio file, given a row of the audio file table.
546  *
547  * \param row Pointer to a row in the audio file table.
548  * \param path Result pointer.
549  *
550  * The result is a pointer to mmapped data. The caller must not attempt
551  * to free it.
552  *
553  * \return Standard.
554  */
555 int get_audio_file_path_of_row(const struct osl_row *row, char **path)
556 {
557         struct osl_object path_obj;
558         int ret = osl(osl_get_object(audio_file_table, row, AFTCOL_PATH,
559                 &path_obj));
560         if (ret < 0)
561                 return ret;
562         *path = path_obj.data;
563         return 1;
564 }
565
566 /**
567  * Get the object containing the hash value of an audio file, given a row.
568  *
569  * \param row Pointer to a row of the audio file table.
570  * \param obj Result pointer.
571  *
572  * \return The return value of the underlying call to osl_get_object().
573  *
574  * \sa get_hash_of_row().
575  */
576 static int get_hash_object_of_aft_row(const struct osl_row *row,
577                 struct osl_object *obj)
578 {
579         return osl(osl_get_object(audio_file_table, row, AFTCOL_HASH, obj));
580 }
581
582 /**
583  * Get the hash value of an audio file, given a row of the audio file table.
584  *
585  * \param row Pointer to a row of the audio file table.
586  * \param hash Result pointer.
587  *
588  * \a hash points to mapped data and must not be freed by the caller.
589  *
590  * \return The return value of the underlying call to
591  * get_hash_object_of_aft_row().
592  */
593 static int get_hash_of_row(const struct osl_row *row, unsigned char **hash)
594 {
595         struct osl_object obj;
596         int ret = get_hash_object_of_aft_row(row, &obj);
597
598         if (ret < 0)
599                 return ret;
600         *hash = obj.data;
601         return 1;
602 }
603
604 /**
605  * Get the audio format handler info, given a row of the audio file table.
606  *
607  * \param row Pointer to a row of the audio file table.
608  * \param afhi Result pointer.
609  *
610  * \return The return value of the underlying call to osl_get_object().
611  *
612  * \sa get_chunk_table_of_row().
613  */
614 int get_afhi_of_row(const struct osl_row *row, struct afh_info *afhi)
615 {
616         struct osl_object obj;
617         int ret = osl(osl_get_object(audio_file_table, row, AFTCOL_AFHI,
618                 &obj));
619         if (ret < 0)
620                 return ret;
621         load_afhi(obj.data, afhi);
622         return 1;
623 }
624
625 /* returns shmid on success */
626 static int save_afd(struct audio_file_data *afd)
627 {
628         size_t size = sizeof(*afd) + sizeof_chunk_table(&afd->afhi);
629         int shmid, ret = shm_new(size);
630         void *shm_afd;
631         char *buf;
632
633         if (ret < 0)
634                 return ret;
635         shmid = ret;
636         ret = shm_attach(shmid, ATTACH_RW, &shm_afd);
637         if (ret < 0)
638                 goto err;
639         buf = shm_afd;
640         buf += sizeof(*afd);
641         afd->max_chunk_size = save_chunk_table(&afd->afhi, buf);
642         *(struct audio_file_data *)shm_afd = *afd;
643         shm_detach(shm_afd);
644         return shmid;
645 err:
646         shm_destroy(shmid);
647         return ret;
648 }
649
650 /**
651  * Extract a afd stored in a shared memory area.
652  *
653  * Attach the shared memory area given by \a shmid, load the audio file data
654  * stored therein and detach the area afterwards.  Called by vss, after
655  * receiving a positive response to the request for the next audio file.
656  +
657  * \param shmid The identifier of the shared memory area containing the afd.
658  * \param afd Result pointer.
659  *
660  * \return Standard.
661  */
662 int load_afd(int shmid, struct audio_file_data *afd)
663 {
664         void *shm_afd;
665         int ret;
666
667         ret = shm_attach(shmid, ATTACH_RO, &shm_afd);
668         if (ret < 0)
669                 return ret;
670         *afd = *(struct audio_file_data *)shm_afd;
671         load_chunk_table(&afd->afhi, shm_afd + sizeof(*afd));
672         shm_detach(shm_afd);
673         return 1;
674 }
675
676 static int get_local_time(uint64_t *seconds, char *buf, size_t size,
677         time_t current_time, enum ls_listing_mode lm)
678 {
679         struct tm *tm;
680         /*
681          * Omit year but show time if the given value is closer to the current
682          * time than this many seconds.
683          */
684         const time_t m = 6 * 30 * 24 * 3600; /* six months */
685
686         tm = localtime((time_t *)seconds);
687         if (!tm)
688                 return -E_LOCALTIME;
689         if (lm == LS_MODE_MBOX) {
690                 if (!strftime(buf, size, "%c", tm))
691                         return -E_STRFTIME;
692                 return 1;
693         }
694         if (*seconds > current_time - m && *seconds < current_time + m) {
695                 if (!strftime(buf, size, "%b %e %k:%M", tm))
696                         return -E_STRFTIME;
697                 return 1;
698         }
699         if (!strftime(buf, size, "%b %e %Y", tm))
700                 return -E_STRFTIME;
701         return 1;
702 }
703
704 /** Compute the number of (decimal) digits of a number. */
705 #define GET_NUM_DIGITS(x, num) { \
706         typeof((x)) _tmp = PARA_ABS(x); \
707         *num = 1; \
708         if ((_tmp)) \
709                 while ((_tmp) > 9) { \
710                         (_tmp) /= 10; \
711                         (*num)++; \
712                 } \
713         }
714
715 __a_const static short unsigned get_duration_width(int seconds)
716 {
717         short unsigned width;
718         unsigned hours = seconds / 3600, mins = (seconds % 3600) / 60;
719
720         if (!hours) /* less than one hour => m:ss or mm:ss => 4 or 5 digits */
721                 return 4 + (mins > 9);
722         /* more than one hour => h:mm:ss, hh:mm:ss, hhh:mm:ss, ... */
723         GET_NUM_DIGITS(hours, &width);
724         return width + 6;
725 }
726
727 static void get_duration_buf(int seconds, char *buf, struct ls_options *opts)
728 {
729         unsigned hours = seconds / 3600, mins = (seconds % 3600) / 60;
730         short unsigned max_width;
731
732         if (!hours) { /* m:ss or mm:ss */
733                 max_width = opts->mode == LS_MODE_LONG?
734                         opts->widths.duration_width : 4;
735                 sprintf(buf, "%*u:%02u", max_width - 3, mins, seconds % 60);
736         } else { /* more than one hour => h:mm:ss, hh:mm:ss, hhh:mm:ss, ... */
737                 max_width = opts->mode == LS_MODE_LONG?
738                         opts->widths.duration_width : 7;
739                 sprintf(buf, "%*u:%02u:%02u", max_width - 6, hours, mins,
740                         seconds % 60);
741         }
742 }
743
744 static int write_attribute_items(struct para_buffer *b,
745                 const char *att_bitmap, struct afs_info *afsi)
746 {
747         char *att_text;
748         int ret;
749
750         WRITE_STATUS_ITEM(b, SI_ATTRIBUTES_BITMAP, "%s\n", att_bitmap);
751         ret = get_attribute_text(&afsi->attributes, " ", &att_text);
752         if (ret < 0)
753                 return ret;
754         WRITE_STATUS_ITEM(b, SI_ATTRIBUTES_TXT, "%s\n", att_text);
755         free(att_text);
756         return ret;
757 }
758
759 static void write_lyrics_items(struct para_buffer *b, struct afs_info *afsi)
760 {
761         char *lyrics_name;
762
763         WRITE_STATUS_ITEM(b, SI_LYRICS_ID, "%u\n", afsi->lyrics_id);
764         lyr_get_name_by_id(afsi->lyrics_id, &lyrics_name);
765         WRITE_STATUS_ITEM(b, SI_LYRICS_NAME, "%s\n", lyrics_name?
766                 lyrics_name : "(none)");
767 }
768
769 static void write_image_items(struct para_buffer *b, struct afs_info *afsi)
770 {
771         char *image_name;
772
773         WRITE_STATUS_ITEM(b, SI_IMAGE_ID, "%u\n", afsi->image_id);
774         img_get_name_by_id(afsi->image_id, &image_name);
775         WRITE_STATUS_ITEM(b, SI_IMAGE_NAME, "%s\n", image_name?
776                 image_name : "(none)");
777 }
778
779 static void write_filename_items(struct para_buffer *b, const char *path,
780                 unsigned flags)
781 {
782         char *val;
783
784         if (!(flags & LS_FLAG_FULL_PATH)) {
785                 WRITE_STATUS_ITEM(b, SI_BASENAME, "%s\n", path);
786                 return;
787         }
788         WRITE_STATUS_ITEM(b, SI_PATH, "%s\n", path);
789         val = para_basename(path);
790         WRITE_STATUS_ITEM(b, SI_BASENAME, "%s\n", val? val : "");
791         val = para_dirname(path);
792         WRITE_STATUS_ITEM(b, SI_DIRECTORY, "%s\n", val? val : "");
793         free(val);
794 }
795
796 static int print_chunk_table(struct ls_data *d, struct para_buffer *b)
797 {
798         struct osl_object chunk_table_obj;
799         struct osl_row *aft_row;
800         int ret, i;
801         char *buf;
802
803         ret = aft_get_row_of_hash(d->hash, &aft_row);
804         if (ret < 0)
805                 return ret;
806         ret = osl(osl_open_disk_object(audio_file_table, aft_row,
807                 AFTCOL_CHUNKS, &chunk_table_obj));
808         if (ret < 0)
809                 return ret;
810         para_printf(b, "%s\n"
811                 "chunk_time: %lu:%lu\nchunk_offsets: ",
812                 d->path,
813                 (long unsigned) d->afhi.chunk_tv.tv_sec,
814                 (long unsigned) d->afhi.chunk_tv.tv_usec
815         );
816         buf = chunk_table_obj.data;
817         for (i = 0; i <= d->afhi.chunks_total; i++)
818                 para_printf(b, "%u ", (unsigned) read_u32(buf + 4 * i));
819         para_printf(b, "\n");
820         ret = 1;
821         osl_close_disk_object(&chunk_table_obj);
822         return ret;
823 }
824
825 static void write_score(struct para_buffer *b, struct ls_data *d,
826                 struct ls_options *opts)
827 {
828         if (!(opts->flags & LS_FLAG_ADMISSIBLE_ONLY)) /* no score*/
829                 return;
830         WRITE_STATUS_ITEM(b, SI_SCORE, "%li\n", d->score);
831 }
832
833 static int print_list_item(struct ls_data *d, struct ls_options *opts,
834         struct para_buffer *b, time_t current_time)
835 {
836         int ret;
837         char att_buf[65];
838         char last_played_time[30];
839         char duration_buf[30]; /* nobody has an audio file long enough to overflow this */
840         struct afs_info *afsi = &d->afsi;
841         struct afh_info *afhi = &d->afhi;
842         char asc_hash[2 * HASH_SIZE + 1];
843
844         if (opts->mode == LS_MODE_SHORT) {
845                 para_printf(b, "%s\n", d->path);
846                 ret = 1;
847                 goto out;
848         }
849         if (opts->mode == LS_MODE_CHUNKS) {
850                 ret = print_chunk_table(d, b);
851                 goto out;
852         }
853         get_attribute_bitmap(&afsi->attributes, att_buf);
854         if (opts->flags & LS_FLAG_UNIXDATE)
855                 sprintf(last_played_time, "%llu",
856                         (long long unsigned)afsi->last_played);
857         else {
858                 ret = get_local_time(&afsi->last_played, last_played_time,
859                         sizeof(last_played_time), current_time, opts->mode);
860                 if (ret < 0)
861                         goto out;
862         }
863         get_duration_buf(afhi->seconds_total, duration_buf, opts);
864         if (opts->mode == LS_MODE_LONG) {
865                 struct ls_widths *w = &opts->widths;
866                 if (opts->flags & LS_FLAG_ADMISSIBLE_ONLY) {
867                         para_printf(b, "%*li ", opts->widths.score_width,
868                                 d->score);
869                 }
870                 para_printf(b,
871                         "%s "   /* attributes */
872                         "%*u "  /* amp */
873                         "%*d "  /* image_id  */
874                         "%*d "  /* lyrics_id */
875                         "%*d "  /* bitrate */
876                         "%*s "  /* audio format */
877                         "%*d "  /* frequency */
878                         "%d "   /* channels */
879                         "%s "   /* duration */
880                         "%*d "  /* num_played */
881                         "%s "   /* last_played */
882                         "%s\n", /* path */
883                         att_buf,
884                         w->amp_width, afsi->amp,
885                         w->image_id_width, afsi->image_id,
886                         w->lyrics_id_width, afsi->lyrics_id,
887                         w->bitrate_width, afhi->bitrate,
888                         w->audio_format_width,
889                         audio_format_name(afsi->audio_format_id),
890                         w->frequency_width, afhi->frequency,
891                         afhi->channels,
892                         duration_buf,
893                         w->num_played_width, afsi->num_played,
894                         last_played_time,
895                         d->path
896                 );
897                 ret = 1;
898                 goto out;
899         }
900         if (opts->mode == LS_MODE_MBOX) {
901                 const char *bn = para_basename(d->path);
902                 para_printf(b,
903                         "From foo@localhost %s\n"
904                         "Received: from\nTo: bar\nFrom: a\n"
905                         "Subject: %s\n\n",
906                         last_played_time,
907                         bn? bn : "?");
908         }
909         write_filename_items(b, d->path, opts->flags);
910         write_score(b, d, opts);
911         ret = write_attribute_items(b, att_buf, afsi);
912         if (ret < 0)
913                 goto out;
914         write_image_items(b, afsi);
915         write_lyrics_items(b, afsi);
916         hash_to_asc(d->hash, asc_hash);
917         WRITE_STATUS_ITEM(b, SI_HASH, "%s\n", asc_hash);
918         WRITE_STATUS_ITEM(b, SI_BITRATE, "%dkbit/s\n", afhi->bitrate);
919         WRITE_STATUS_ITEM(b, SI_FORMAT, "%s\n",
920                 audio_format_name(afsi->audio_format_id));
921         WRITE_STATUS_ITEM(b, SI_FREQUENCY, "%dHz\n", afhi->frequency);
922         WRITE_STATUS_ITEM(b, SI_CHANNELS, "%d\n", afhi->channels);
923         WRITE_STATUS_ITEM(b, SI_DURATION, "%s\n", duration_buf);
924         WRITE_STATUS_ITEM(b, SI_SECONDS_TOTAL, "%" PRIu32 "\n",
925                 afhi->seconds_total);
926         WRITE_STATUS_ITEM(b, SI_LAST_PLAYED, "%s\n", last_played_time);
927         WRITE_STATUS_ITEM(b, SI_NUM_PLAYED, "%d\n", afsi->num_played);
928         WRITE_STATUS_ITEM(b, SI_AMPLIFICATION, "%u\n", afsi->amp);
929         WRITE_STATUS_ITEM(b, SI_CHUNK_TIME, "%lu\n", tv2ms(&afhi->chunk_tv));
930         WRITE_STATUS_ITEM(b, SI_NUM_CHUNKS, "%" PRIu32 "\n",
931                 afhi->chunks_total);
932         WRITE_STATUS_ITEM(b, SI_TECHINFO, "%s\n", afhi->techinfo);
933         WRITE_STATUS_ITEM(b, SI_ARTIST, "%s\n", afhi->tags.artist);
934         WRITE_STATUS_ITEM(b, SI_TITLE, "%s\n", afhi->tags.title);
935         WRITE_STATUS_ITEM(b, SI_YEAR, "%s\n", afhi->tags.year);
936         WRITE_STATUS_ITEM(b, SI_ALBUM, "%s\n", afhi->tags.album);
937         WRITE_STATUS_ITEM(b, SI_COMMENT, "%s\n", afhi->tags.comment);
938         if (opts->mode == LS_MODE_MBOX) {
939                 struct osl_object lyrics_def;
940                 lyr_get_def_by_id(afsi->lyrics_id, &lyrics_def);
941                 if (lyrics_def.data) {
942                         para_printf(b, "Lyrics:\n~~~~~~~\n%s",
943                                 (char *)lyrics_def.data);
944                         osl_close_disk_object(&lyrics_def);
945                 }
946         }
947 out:
948         return ret;
949 }
950
951 static struct ls_data status_item_ls_data;
952 static struct osl_row *current_aft_row;
953
954 static void make_inode_status_items(struct para_buffer *pb)
955 {
956         struct stat statbuf = {.st_size = 0};
957         char *path, mtime_str[30] = "\0";
958         struct tm mtime_tm;
959         int ret;
960
961         ret = get_audio_file_path_of_row(current_aft_row, &path);
962         if (ret < 0)
963                 goto out;
964         ret = stat(path, &statbuf);
965         if (ret < 0)
966                 goto out;
967         localtime_r(&statbuf.st_mtime, &mtime_tm);
968         ret = strftime(mtime_str, 29, "%b %d %Y", &mtime_tm);
969         assert(ret > 0); /* number of bytes placed in mtime_str */
970 out:
971         WRITE_STATUS_ITEM(pb, SI_MTIME, "%s\n", mtime_str);
972         WRITE_STATUS_ITEM(pb, SI_FILE_SIZE, "%ld\n", statbuf.st_size / 1024);
973 }
974
975 static int make_status_items(void)
976 {
977         struct ls_options opts = {
978                 .flags = LS_FLAG_FULL_PATH | LS_FLAG_ADMISSIBLE_ONLY,
979                 .mode = LS_MODE_VERBOSE,
980         };
981         struct para_buffer pb = {.max_size = shm_get_shmmax() - 1};
982         time_t current_time;
983         int ret;
984
985         time(&current_time);
986         ret = print_list_item(&status_item_ls_data, &opts, &pb, current_time);
987         if (ret < 0)
988                 return ret;
989         make_inode_status_items(&pb);
990         free(status_items);
991         status_items = pb.buf;
992         memset(&pb, 0, sizeof(pb));
993         pb.max_size = shm_get_shmmax() - 1;
994         pb.flags = PBF_SIZE_PREFIX;
995         ret = print_list_item(&status_item_ls_data, &opts, &pb, current_time);
996         if (ret < 0) {
997                 free(status_items);
998                 status_items = NULL;
999                 return ret;
1000         }
1001         make_inode_status_items(&pb);
1002         free(parser_friendly_status_items);
1003         parser_friendly_status_items = pb.buf;
1004         return 1;
1005 }
1006
1007 /**
1008  * Open the audio file with highest score and set up an afd structure.
1009  *
1010  * \param afd Result pointer.
1011  *
1012  * On success, the numplayed field of the audio file selector info is increased
1013  * and the lastplayed time is set to the current time. Finally, the score of
1014  * the audio file is updated.
1015  *
1016  * \return Positive shmid on success, negative on errors.
1017  */
1018 int open_and_update_audio_file(struct audio_file_data *afd)
1019 {
1020         unsigned char file_hash[HASH_SIZE];
1021         struct osl_object afsi_obj;
1022         struct afs_info new_afsi;
1023         int ret;
1024         struct afsi_change_event_data aced;
1025         struct osl_object map, chunk_table_obj;
1026         struct ls_data *d = &status_item_ls_data;
1027 again:
1028         ret = score_get_best(&current_aft_row, &d->score);
1029         if (ret < 0)
1030                 return ret;
1031         ret = get_hash_of_row(current_aft_row, &d->hash);
1032         if (ret < 0)
1033                 return ret;
1034         ret = get_audio_file_path_of_row(current_aft_row, &d->path);
1035         if (ret < 0)
1036                 return ret;
1037         PARA_NOTICE_LOG("%s\n", d->path);
1038         ret = get_afsi_object_of_row(current_aft_row, &afsi_obj);
1039         if (ret < 0)
1040                 return ret;
1041         ret = load_afsi(&d->afsi, &afsi_obj);
1042         if (ret < 0)
1043                 return ret;
1044         ret = get_afhi_of_row(current_aft_row, &afd->afhi);
1045         if (ret < 0)
1046                 return ret;
1047         d->afhi = afd->afhi;
1048         d->afhi.chunk_table = afd->afhi.chunk_table = NULL;
1049         ret = osl(osl_open_disk_object(audio_file_table, current_aft_row,
1050                 AFTCOL_CHUNKS, &chunk_table_obj));
1051         if (ret < 0)
1052                 return ret;
1053         ret = mmap_full_file(d->path, O_RDONLY, &map.data, &map.size, &afd->fd);
1054         if (ret < 0)
1055                 goto out;
1056         hash_function(map.data, map.size, file_hash);
1057         ret = hash_compare(file_hash, d->hash);
1058         para_munmap(map.data, map.size);
1059         if (ret) {
1060                 ret = -E_HASH_MISMATCH;
1061                 goto out;
1062         }
1063         new_afsi = d->afsi;
1064         new_afsi.num_played++;
1065         new_afsi.last_played = time(NULL);
1066         save_afsi(&new_afsi, &afsi_obj); /* in-place update */
1067
1068         afd->audio_format_id = d->afsi.audio_format_id;
1069         load_chunk_table(&afd->afhi, chunk_table_obj.data);
1070         aced.aft_row = current_aft_row;
1071         aced.old_afsi = &d->afsi;
1072         /*
1073          * No need to update the status items as the AFSI_CHANGE event will
1074          * recreate them.
1075          */
1076         ret = afs_event(AFSI_CHANGE, NULL, &aced);
1077         if (ret < 0)
1078                 goto out;
1079         ret = save_afd(afd);
1080 out:
1081         free(afd->afhi.chunk_table);
1082         osl_close_disk_object(&chunk_table_obj);
1083         if (ret < 0) {
1084                 PARA_ERROR_LOG("%s: %s\n", d->path, para_strerror(-ret));
1085                 ret = score_delete(current_aft_row);
1086                 if (ret >= 0)
1087                         goto again;
1088         }
1089         return ret;
1090 }
1091
1092 static int ls_audio_format_compare(const void *a, const void *b)
1093 {
1094         struct ls_data *d1 = *(struct ls_data **)a, *d2 = *(struct ls_data **)b;
1095         return NUM_COMPARE(d1->afsi.audio_format_id, d2->afsi.audio_format_id);
1096 }
1097
1098 static int ls_duration_compare(const void *a, const void *b)
1099 {
1100         struct ls_data *d1 = *(struct ls_data **)a, *d2 = *(struct ls_data **)b;
1101         return NUM_COMPARE(d1->afhi.seconds_total, d2->afhi.seconds_total);
1102 }
1103
1104 static int ls_bitrate_compare(const void *a, const void *b)
1105 {
1106         struct ls_data *d1 = *(struct ls_data **)a, *d2 = *(struct ls_data **)b;
1107         return NUM_COMPARE(d1->afhi.bitrate, d2->afhi.bitrate);
1108 }
1109
1110 static int ls_lyrics_id_compare(const void *a, const void *b)
1111 {
1112         struct ls_data *d1 = *(struct ls_data **)a, *d2 = *(struct ls_data **)b;
1113         return NUM_COMPARE(d1->afsi.lyrics_id, d2->afsi.lyrics_id);
1114 }
1115
1116 static int ls_image_id_compare(const void *a, const void *b)
1117 {
1118         struct ls_data *d1 = *(struct ls_data **)a, *d2 = *(struct ls_data **)b;
1119         return NUM_COMPARE(d1->afsi.image_id, d2->afsi.image_id);
1120 }
1121
1122 static int ls_channels_compare(const void *a, const void *b)
1123 {
1124         struct ls_data *d1 = *(struct ls_data **)a, *d2 = *(struct ls_data **)b;
1125         return NUM_COMPARE(d1->afhi.channels, d2->afhi.channels);
1126 }
1127
1128 static int ls_frequency_compare(const void *a, const void *b)
1129 {
1130         struct ls_data *d1 = *(struct ls_data **)a, *d2 = *(struct ls_data **)b;
1131         return NUM_COMPARE(d1->afhi.frequency, d2->afhi.frequency);
1132 }
1133
1134 static int ls_num_played_compare(const void *a, const void *b)
1135 {
1136         struct ls_data *d1 = *(struct ls_data **)a, *d2 = *(struct ls_data **)b;
1137         return NUM_COMPARE(d1->afsi.num_played, d2->afsi.num_played);
1138 }
1139
1140 static int ls_last_played_compare(const void *a, const void *b)
1141 {
1142         struct ls_data *d1 = *(struct ls_data **)a, *d2 = *(struct ls_data **)b;
1143         return NUM_COMPARE(d1->afsi.last_played, d2->afsi.last_played);
1144 }
1145
1146 static int ls_score_compare(const void *a, const void *b)
1147 {
1148         struct ls_data *d1 = *(struct ls_data **)a, *d2 = *(struct ls_data **)b;
1149         return NUM_COMPARE(d1->score, d2->score);
1150 }
1151
1152 static int ls_path_compare(const void *a, const void *b)
1153 {
1154         struct ls_data *d1 = *(struct ls_data **)a, *d2 = *(struct ls_data **)b;
1155         return strcmp(d1->path, d2->path);
1156 }
1157
1158 static int sort_matching_paths(struct ls_options *options)
1159 {
1160         size_t nmemb = options->num_matching_paths;
1161         size_t size = sizeof(*options->data_ptr);
1162         int (*compar)(const void *, const void *);
1163         int i;
1164
1165         options->data_ptr = para_malloc(nmemb * sizeof(*options->data_ptr));
1166         for (i = 0; i < nmemb; i++)
1167                 options->data_ptr[i] = options->data + i;
1168
1169         /* In these cases the array is already sorted */
1170         if (options->sorting == LS_SORT_BY_PATH
1171                 && !(options->flags & LS_FLAG_ADMISSIBLE_ONLY)
1172                 && (options->flags & LS_FLAG_FULL_PATH))
1173                 return 1;
1174         if (options->sorting == LS_SORT_BY_SCORE &&
1175                         options->flags & LS_FLAG_ADMISSIBLE_ONLY)
1176                 return 1;
1177
1178         switch (options->sorting) {
1179         case LS_SORT_BY_PATH:
1180                 compar = ls_path_compare; break;
1181         case LS_SORT_BY_SCORE:
1182                 compar = ls_score_compare; break;
1183         case LS_SORT_BY_LAST_PLAYED:
1184                 compar = ls_last_played_compare; break;
1185         case LS_SORT_BY_NUM_PLAYED:
1186                 compar = ls_num_played_compare; break;
1187         case LS_SORT_BY_FREQUENCY:
1188                 compar = ls_frequency_compare; break;
1189         case LS_SORT_BY_CHANNELS:
1190                 compar = ls_channels_compare; break;
1191         case LS_SORT_BY_IMAGE_ID:
1192                 compar = ls_image_id_compare; break;
1193         case LS_SORT_BY_LYRICS_ID:
1194                 compar = ls_lyrics_id_compare; break;
1195         case LS_SORT_BY_BITRATE:
1196                 compar = ls_bitrate_compare; break;
1197         case LS_SORT_BY_DURATION:
1198                 compar = ls_duration_compare; break;
1199         case LS_SORT_BY_AUDIO_FORMAT:
1200                 compar = ls_audio_format_compare; break;
1201         default:
1202                 return -E_BAD_SORT;
1203         }
1204         qsort(options->data_ptr, nmemb, size, compar);
1205         return 1;
1206 }
1207
1208 /* row is either an aft_row or a row of the score table */
1209 /* TODO: Only compute widths if we need them */
1210 static int prepare_ls_row(struct osl_row *row, void *ls_opts)
1211 {
1212         int ret, i;
1213         struct ls_options *options = ls_opts;
1214         struct ls_data *d;
1215         struct ls_widths *w;
1216         unsigned short num_digits;
1217         unsigned tmp;
1218         struct osl_row *aft_row;
1219         long score;
1220         char *path;
1221
1222         if (options->flags & LS_FLAG_ADMISSIBLE_ONLY) {
1223                 ret = get_score_and_aft_row(row, &score, &aft_row);
1224                 if (ret < 0)
1225                         return ret;
1226         } else {
1227                 aft_row = row;
1228                 score = 0;
1229         }
1230         ret = get_audio_file_path_of_row(aft_row, &path);
1231         if (ret < 0)
1232                 return ret;
1233         if (!(options->flags & LS_FLAG_FULL_PATH)) {
1234                 char *p = strrchr(path, '/');
1235                 if (p)
1236                         path = p + 1;
1237         }
1238         if (options->num_patterns) {
1239                 for (i = 0; i < options->num_patterns; i++) {
1240                         ret = fnmatch(options->patterns[i], path, 0);
1241                         if (!ret)
1242                                 break;
1243                         if (ret == FNM_NOMATCH)
1244                                 continue;
1245                         return -E_FNMATCH;
1246                 }
1247                 if (i >= options->num_patterns) /* no match */
1248                         return 1;
1249         }
1250         tmp = options->num_matching_paths++;
1251         if (options->num_matching_paths > options->array_size) {
1252                 options->array_size++;
1253                 options->array_size *= 2;
1254                 options->data = para_realloc(options->data, options->array_size
1255                         * sizeof(*options->data));
1256         }
1257         d = options->data + tmp;
1258         ret = get_afsi_of_row(aft_row, &d->afsi);
1259         if (ret < 0)
1260                 return ret;
1261         ret = get_afhi_of_row(aft_row, &d->afhi);
1262         if (ret < 0)
1263                 return ret;
1264         d->path = path;
1265         ret = get_hash_of_row(aft_row, &d->hash);
1266         if (ret < 0)
1267                 goto err;
1268         w = &options->widths;
1269         GET_NUM_DIGITS(d->afsi.image_id, &num_digits);
1270         w->image_id_width = PARA_MAX(w->image_id_width, num_digits);
1271         GET_NUM_DIGITS(d->afsi.lyrics_id, &num_digits);
1272         w->lyrics_id_width = PARA_MAX(w->lyrics_id_width, num_digits);
1273         GET_NUM_DIGITS(d->afhi.bitrate, &num_digits);
1274         w->bitrate_width = PARA_MAX(w->bitrate_width, num_digits);
1275         GET_NUM_DIGITS(d->afhi.frequency, &num_digits);
1276         w->frequency_width = PARA_MAX(w->frequency_width, num_digits);
1277         GET_NUM_DIGITS(d->afsi.num_played, &num_digits);
1278         w->num_played_width = PARA_MAX(w->num_played_width, num_digits);
1279         /* get the number of chars to print this amount of time */
1280         num_digits = get_duration_width(d->afhi.seconds_total);
1281         w->duration_width = PARA_MAX(w->duration_width, num_digits);
1282         GET_NUM_DIGITS(d->afsi.amp, &num_digits);
1283         w->amp_width = PARA_MAX(w->amp_width, num_digits);
1284         num_digits = strlen(audio_format_name(d->afsi.audio_format_id));
1285         w->audio_format_width = PARA_MAX(w->audio_format_width, num_digits);
1286         if (options->flags & LS_FLAG_ADMISSIBLE_ONLY) {
1287                 GET_NUM_DIGITS(score, &num_digits);
1288                 num_digits++; /* add one for the sign (space or "-") */
1289                 w->score_width = PARA_MAX(w->score_width, num_digits);
1290                 d->score = score;
1291         }
1292         return 1;
1293 err:
1294         return ret;
1295 }
1296
1297 static int com_ls_callback(struct afs_callback_arg *aca)
1298 {
1299         struct ls_options *opts = aca->query.data;
1300         char *p, *pattern_start = (char *)aca->query.data + sizeof(*opts);
1301         int i = 0, ret;
1302         time_t current_time;
1303
1304         aca->pbout.flags = (opts->mode == LS_MODE_PARSER)? PBF_SIZE_PREFIX : 0;
1305         if (opts->num_patterns) {
1306                 opts->patterns = para_malloc(opts->num_patterns * sizeof(char *));
1307                 for (i = 0, p = pattern_start; i < opts->num_patterns; i++) {
1308                         opts->patterns[i] = p;
1309                         p += strlen(p) + 1;
1310                 }
1311         } else
1312                 opts->patterns = NULL;
1313         if (opts->flags & LS_FLAG_ADMISSIBLE_ONLY)
1314                 ret = admissible_file_loop(opts, prepare_ls_row);
1315         else
1316                 ret = osl(osl_rbtree_loop(audio_file_table, AFTCOL_PATH, opts,
1317                         prepare_ls_row));
1318         if (ret < 0)
1319                 goto out;
1320         if (opts->num_matching_paths == 0) {
1321                 ret = opts->num_patterns > 0? -E_NO_MATCH : 0;
1322                 goto out;
1323         }
1324         ret = sort_matching_paths(opts);
1325         if (ret < 0)
1326                 goto out;
1327         time(&current_time);
1328         if (opts->flags & LS_FLAG_REVERSE)
1329                 for (i = opts->num_matching_paths - 1; i >= 0; i--) {
1330                         ret = print_list_item(opts->data_ptr[i], opts,
1331                                 &aca->pbout, current_time);
1332                         if (ret < 0)
1333                                 goto out;
1334                 }
1335         else
1336                 for (i = 0; i < opts->num_matching_paths; i++) {
1337                         ret = print_list_item(opts->data_ptr[i], opts,
1338                                 &aca->pbout, current_time);
1339                         if (ret < 0)
1340                                 goto out;
1341                 }
1342 out:
1343         free(opts->data);
1344         free(opts->data_ptr);
1345         free(opts->patterns);
1346         return ret;
1347 }
1348
1349 /*
1350  * TODO: flags -h (sort by hash)
1351  */
1352 int com_ls(struct command_context *cc)
1353 {
1354         int i;
1355         unsigned flags = 0;
1356         enum ls_sorting_method sort = LS_SORT_BY_PATH;
1357         enum ls_listing_mode mode = LS_MODE_SHORT;
1358         struct ls_options opts = {.patterns = NULL};
1359         struct osl_object query = {.data = &opts, .size = sizeof(opts)};
1360
1361         for (i = 1; i < cc->argc; i++) {
1362                 const char *arg = cc->argv[i];
1363                 if (arg[0] != '-')
1364                         break;
1365                 if (!strcmp(arg, "--")) {
1366                         i++;
1367                         break;
1368                 }
1369                 /*
1370                  * Compatibility: Prior to 0.5.5 it was necessary to specify
1371                  * the listing mode without the '=' character as in -lv, for
1372                  * example. Now the variant with '=' is preferred and
1373                  * documented but we still accept the old way to specify the
1374                  * listing mode.
1375                  *
1376                  * Support for the legacy syntax can be dropped at 0.6.0
1377                  * or later.
1378                  */
1379                 if (!strncmp(arg, "-l", 2)) {
1380                         arg += 2;
1381                         if (*arg == '=')
1382                                 arg++;
1383                         switch (*arg) {
1384                         case 's':
1385                                 mode = LS_MODE_SHORT;
1386                                 continue;
1387                         case 'l':
1388                         case '\0':
1389                                 mode = LS_MODE_LONG;
1390                                 continue;
1391                         case 'v':
1392                                 mode = LS_MODE_VERBOSE;
1393                                 continue;
1394                         case 'm':
1395                                 mode = LS_MODE_MBOX;
1396                                 continue;
1397                         case 'c':
1398                                 mode = LS_MODE_CHUNKS;
1399                                 continue;
1400                         case 'p':
1401                                 mode = LS_MODE_PARSER;
1402                                 continue;
1403                         default:
1404                                 return -E_AFT_SYNTAX;
1405                         }
1406                 }
1407                 if (!strcmp(arg, "-p")) {
1408                         flags |= LS_FLAG_FULL_PATH;
1409                         continue;
1410                 }
1411                 if (!strcmp(arg, "-a")) {
1412                         flags |= LS_FLAG_ADMISSIBLE_ONLY;
1413                         continue;
1414                 }
1415                 if (!strcmp(arg, "-r")) {
1416                         flags |= LS_FLAG_REVERSE;
1417                         continue;
1418                 }
1419                 if (!strcmp(arg, "-d")) {
1420                         flags |= LS_FLAG_UNIXDATE;
1421                         continue;
1422                 }
1423                 /* The compatibility remark above applies also to -s. */
1424                 if (!strncmp(arg, "-s", 2)) {
1425                         arg += 2;
1426                         if (*arg == '=')
1427                                 arg++;
1428                         switch (*arg) {
1429                         case 'p':
1430                                 sort = LS_SORT_BY_PATH;
1431                                 continue;
1432                         case 's': /* -ss implies -a */
1433                                 sort = LS_SORT_BY_SCORE;
1434                                 flags |= LS_FLAG_ADMISSIBLE_ONLY;
1435                                 continue;
1436                         case 'l':
1437                                 sort = LS_SORT_BY_LAST_PLAYED;
1438                                 continue;
1439                         case 'n':
1440                                 sort = LS_SORT_BY_NUM_PLAYED;
1441                                 continue;
1442                         case 'f':
1443                                 sort = LS_SORT_BY_FREQUENCY;
1444                                 continue;
1445                         case 'c':
1446                                 sort = LS_SORT_BY_CHANNELS;
1447                                 continue;
1448                         case 'i':
1449                                 sort = LS_SORT_BY_IMAGE_ID;
1450                                 continue;
1451                         case 'y':
1452                                 sort = LS_SORT_BY_LYRICS_ID;
1453                                 continue;
1454                         case 'b':
1455                                 sort = LS_SORT_BY_BITRATE;
1456                                 continue;
1457                         case 'd':
1458                                 sort = LS_SORT_BY_DURATION;
1459                                 continue;
1460                         case 'a':
1461                                 sort = LS_SORT_BY_AUDIO_FORMAT;
1462                                 continue;
1463                         default:
1464                                 return -E_AFT_SYNTAX;
1465                         }
1466                 }
1467                 return -E_AFT_SYNTAX;
1468         }
1469         opts.flags = flags;
1470         opts.sorting = sort;
1471         opts.mode = mode;
1472         opts.num_patterns = cc->argc - i;
1473         return send_option_arg_callback_request(&query, opts.num_patterns,
1474                 cc->argv + i, com_ls_callback, afs_cb_result_handler, cc);
1475 }
1476
1477 /**
1478  * Call the given function for each file in the audio file table.
1479  *
1480  * \param private_data An arbitrary data pointer, passed to \a func.
1481  * \param func The custom function to be called.
1482  *
1483  * \return Standard.
1484  */
1485 int audio_file_loop(void *private_data, osl_rbtree_loop_func *func)
1486 {
1487         return osl(osl_rbtree_loop(audio_file_table, AFTCOL_HASH, private_data,
1488                 func));
1489 }
1490
1491 static int find_hash_sister(unsigned char *hash, struct osl_row **result)
1492 {
1493         int ret = aft_get_row_of_hash(hash, result);
1494
1495         if (ret == -OSL_ERRNO_TO_PARA_ERROR(E_OSL_RB_KEY_NOT_FOUND))
1496                 return 0;
1497         return ret;
1498 }
1499
1500 static int find_path_brother(const char *path, struct osl_row **result)
1501 {
1502         int ret = aft_get_row_of_path(path, result);
1503
1504         if (ret == -OSL_ERRNO_TO_PARA_ERROR(E_OSL_RB_KEY_NOT_FOUND))
1505                 return 0;
1506         return ret;
1507 }
1508
1509 /** The format of the data stored by save_audio_file_data(). */
1510 enum com_add_buffer_offsets {
1511         /* afhi (if present) starts at this offset. */
1512         CAB_AFHI_OFFSET_POS = 0,
1513         /** Start of the chunk table (if present). */
1514         CAB_CHUNKS_OFFSET_POS = 4,
1515         /** Flags given to the add command. */
1516         CAB_FLAGS_OFFSET = 8,
1517         /** Audio format id. */
1518         CAB_AUDIO_FORMAT_ID_OFFSET = 12,
1519         /** The hash of the audio file being added. */
1520         CAB_HASH_OFFSET = 13,
1521         /** Start of the path of the audio file. */
1522         CAB_PATH_OFFSET = (CAB_HASH_OFFSET + HASH_SIZE),
1523 };
1524
1525 /*
1526  * Store the given data to a single buffer. Doesn't need the audio file selector
1527  * info struct as the server knows it as well.
1528  *
1529  * It's OK to call this with afhi == NULL. In this case, the audio format
1530  * handler info won't be stored in the buffer.
1531  */
1532 static void save_add_callback_buffer(unsigned char *hash, const char *path,
1533                 struct afh_info *afhi, uint32_t flags,
1534                 uint8_t audio_format_num, struct osl_object *obj)
1535 {
1536         size_t path_len = strlen(path) + 1;
1537         size_t afhi_size = sizeof_afhi_buf(afhi);
1538         size_t size = CAB_PATH_OFFSET + path_len + afhi_size
1539                 + sizeof_chunk_table(afhi);
1540         char *buf = para_malloc(size);
1541         uint32_t pos;
1542
1543         pos = CAB_PATH_OFFSET + path_len;
1544         write_u32(buf + CAB_AFHI_OFFSET_POS, pos);
1545         save_afhi(afhi, buf + pos);
1546         pos += afhi_size;
1547
1548         write_u32(buf + CAB_CHUNKS_OFFSET_POS, pos);
1549         if (afhi)
1550                 save_chunk_table(afhi, buf + pos);
1551
1552         write_u32(buf + CAB_FLAGS_OFFSET, flags);
1553         write_u8(buf + CAB_AUDIO_FORMAT_ID_OFFSET, audio_format_num);
1554
1555         memcpy(buf + CAB_HASH_OFFSET, hash, HASH_SIZE);
1556         strcpy(buf + CAB_PATH_OFFSET, path);
1557
1558         obj->data = buf;
1559         obj->size = size;
1560 }
1561
1562 /*
1563
1564 Overview of the add command.
1565
1566 Input: What was passed to the callback by the command handler.
1567 ~~~~~~
1568 HS:     Hash sister. Whether an audio file with identical hash
1569         already exists in the osl database.
1570
1571 PB:     Path brother. Whether a file with the given path exists
1572         in the table.
1573
1574 F:      Force flag given. Whether add was called with -f.
1575
1576 output: Action performed by the callback.
1577 ~~~~~~~
1578 AFHI:   Whether afhi and chunk table are computed and sent.
1579 ACTION: Table modifications to be done by the callback.
1580
1581 +----+----+---+------+---------------------------------------------------+
1582 | HS | PB | F | AFHI | ACTION
1583 +----+----+---+------+---------------------------------------------------+
1584 | Y  |  Y | Y |  Y   | if HS != PB: remove PB. HS: force afhi update,
1585 |                    | update path, keep afsi
1586 +----+----+---+------+---------------------------------------------------+
1587 | Y  |  Y | N |  N   | if HS == PB: do not send callback request at all.
1588 |                    | otherwise: remove PB, HS: update path, keep afhi,
1589 |                    | afsi.
1590 +----+----+---+------+---------------------------------------------------+
1591 | Y  |  N | Y |  Y   | (rename) force afhi update of HS, update path of
1592 |                    | HS, keep afsi
1593 +----+----+---+------+---------------------------------------------------+
1594 | Y  |  N | N |  N   | (file rename) update path of HS, keep afsi, afhi
1595 +----+----+---+------+---------------------------------------------------+
1596 | N  |  Y | Y |  Y   | (file change) update afhi, hash, of PB, keep afsi
1597 |                    | (force has no effect)
1598 +----+----+---+------+---------------------------------------------------+
1599 | N  |  Y | N |  Y   | (file change) update afhi, hash of PB, keep afsi
1600 +----+----+---+------+---------------------------------------------------+
1601 | N  |  N | Y |  Y   | (new file) create new entry (force has no effect)
1602 +----+----+---+------+---------------------------------------------------+
1603 |  N |  N | N |  Y   | (new file) create new entry
1604 +----+----+---+------+---------------------------------------------------+
1605
1606 Notes:
1607
1608         afhi <=> force or no HS
1609         F => AFHI
1610
1611 */
1612
1613 /** Flags passed to the add command. */
1614 enum com_add_flags {
1615         /** Skip paths that exist already. */
1616         ADD_FLAG_LAZY = 1,
1617         /** Force adding. */
1618         ADD_FLAG_FORCE = 2,
1619         /** Print what is being done. */
1620         ADD_FLAG_VERBOSE = 4,
1621         /** Try to add files with unknown suffixes. */
1622         ADD_FLAG_ALL = 8,
1623 };
1624
1625 static int com_add_callback(struct afs_callback_arg *aca)
1626 {
1627         char *buf = aca->query.data, *path;
1628         struct osl_row *pb, *aft_row;
1629         struct osl_row *hs;
1630         struct osl_object objs[NUM_AFT_COLUMNS];
1631         unsigned char *hash;
1632         char asc[2 * HASH_SIZE + 1];
1633         int ret;
1634         char afsi_buf[AFSI_SIZE];
1635         uint32_t flags = read_u32(buf + CAB_FLAGS_OFFSET);
1636         struct afs_info default_afsi = {.last_played = 0};
1637         uint16_t afhi_offset, chunks_offset;
1638
1639         hash = (unsigned char *)buf + CAB_HASH_OFFSET;
1640         hash_to_asc(hash, asc);
1641         objs[AFTCOL_HASH].data = buf + CAB_HASH_OFFSET;
1642         objs[AFTCOL_HASH].size = HASH_SIZE;
1643
1644         path = buf + CAB_PATH_OFFSET;
1645         objs[AFTCOL_PATH].data = path;
1646         objs[AFTCOL_PATH].size = strlen(path) + 1;
1647
1648         PARA_INFO_LOG("request to add %s\n", path);
1649         ret = find_hash_sister(hash, &hs);
1650         if (ret < 0)
1651                 goto out;
1652         ret = find_path_brother(path, &pb);
1653         if (ret < 0)
1654                 goto out;
1655         if (hs && pb && hs == pb && !(flags & ADD_FLAG_FORCE)) {
1656                 if (flags & ADD_FLAG_VERBOSE)
1657                         para_printf(&aca->pbout, "ignoring duplicate\n");
1658                 ret = 1;
1659                 goto out;
1660         }
1661         if (hs && hs != pb) {
1662                 struct osl_object obj;
1663                 if (pb) { /* hs trumps pb, remove pb */
1664                         if (flags & ADD_FLAG_VERBOSE)
1665                                 para_printf(&aca->pbout, "removing %s\n", path);
1666                         ret = afs_event(AUDIO_FILE_REMOVE, &aca->pbout, pb);
1667                         if (ret < 0)
1668                                 goto out;
1669                         ret = osl(osl_del_row(audio_file_table, pb));
1670                         if (ret < 0)
1671                                 goto out;
1672                         pb = NULL;
1673                 }
1674                 /* file rename, update hs' path */
1675                 if (flags & ADD_FLAG_VERBOSE) {
1676                         ret = osl(osl_get_object(audio_file_table, hs,
1677                                 AFTCOL_PATH, &obj));
1678                         if (ret < 0)
1679                                 goto out;
1680                         para_printf(&aca->pbout, "renamed from %s\n",
1681                                 (char *)obj.data);
1682                 }
1683                 ret = osl(osl_update_object(audio_file_table, hs, AFTCOL_PATH,
1684                         &objs[AFTCOL_PATH]));
1685                 if (ret < 0)
1686                         goto out;
1687                 ret = afs_event(AUDIO_FILE_RENAME, &aca->pbout, hs);
1688                 if (ret < 0)
1689                         goto out;
1690                 if (!(flags & ADD_FLAG_FORCE))
1691                         goto out;
1692         }
1693         /* no hs or force mode, child must have sent afhi */
1694         afhi_offset = read_u32(buf + CAB_AFHI_OFFSET_POS);
1695         chunks_offset = read_u32(buf + CAB_CHUNKS_OFFSET_POS);
1696
1697         objs[AFTCOL_AFHI].data = buf + afhi_offset;
1698         objs[AFTCOL_AFHI].size = chunks_offset - afhi_offset;
1699         ret = -E_NO_AFHI;
1700         if (!objs[AFTCOL_AFHI].size) /* "impossible" */
1701                 goto out;
1702         objs[AFTCOL_CHUNKS].data = buf + chunks_offset;
1703         objs[AFTCOL_CHUNKS].size = aca->query.size - chunks_offset;
1704         if (pb && !hs) { /* update pb's hash */
1705                 char old_asc[2 * HASH_SIZE + 1];
1706                 unsigned char *old_hash;
1707                 ret = get_hash_of_row(pb, &old_hash);
1708                 if (ret < 0)
1709                         goto out;
1710                 hash_to_asc(old_hash, old_asc);
1711                 if (flags & ADD_FLAG_VERBOSE)
1712                         para_printf(&aca->pbout, "file change: %s -> %s\n",
1713                                 old_asc, asc);
1714                 ret = osl_update_object(audio_file_table, pb, AFTCOL_HASH,
1715                         &objs[AFTCOL_HASH]);
1716                 if (ret < 0)
1717                         goto out;
1718         }
1719         if (hs || pb) { /* (hs != NULL and pb != NULL) implies hs == pb */
1720                 struct osl_row *row = pb? pb : hs;
1721                 /* update afhi and chunk_table */
1722                 if (flags & ADD_FLAG_VERBOSE)
1723                         para_printf(&aca->pbout,
1724                                 "updating afhi and chunk table\n");
1725                 ret = osl(osl_update_object(audio_file_table, row, AFTCOL_AFHI,
1726                         &objs[AFTCOL_AFHI]));
1727                 if (ret < 0)
1728                         goto out;
1729                 ret = osl(osl_update_object(audio_file_table, row, AFTCOL_CHUNKS,
1730                         &objs[AFTCOL_CHUNKS]));
1731                 if (ret < 0)
1732                         goto out;
1733                 ret = afs_event(AFHI_CHANGE, &aca->pbout, row);
1734                 if (ret < 0)
1735                         goto out;
1736                 goto out;
1737         }
1738         /* new entry, use default afsi */
1739         if (flags & ADD_FLAG_VERBOSE)
1740                 para_printf(&aca->pbout, "new file\n");
1741         default_afsi.last_played = time(NULL) - 365 * 24 * 60 * 60;
1742         default_afsi.audio_format_id = read_u8(buf + CAB_AUDIO_FORMAT_ID_OFFSET);
1743
1744         objs[AFTCOL_AFSI].data = &afsi_buf;
1745         objs[AFTCOL_AFSI].size = AFSI_SIZE;
1746         save_afsi(&default_afsi, &objs[AFTCOL_AFSI]);
1747         ret = osl(osl_add_and_get_row(audio_file_table, objs, &aft_row));
1748         if (ret < 0)
1749                 goto out;
1750         ret = afs_event(AUDIO_FILE_ADD, &aca->pbout, aft_row);
1751 out:
1752         if (ret < 0)
1753                 para_printf(&aca->pbout, "could not add %s\n", path);
1754         return ret;
1755 }
1756
1757 /** Used by com_add(). */
1758 struct private_add_data {
1759         /** The pointer passed to the original command handler. */
1760         struct command_context *cc;
1761         /** The given add flags. */
1762         uint32_t flags;
1763 };
1764
1765 static int path_brother_callback(struct afs_callback_arg *aca)
1766 {
1767         char *path = aca->query.data;
1768         struct osl_row *path_brother;
1769         int ret = find_path_brother(path, &path_brother);
1770         if (ret <= 0)
1771                 return ret;
1772         return pass_buffer_as_shm(aca->fd, SBD_OUTPUT, (char *)&path_brother,
1773                 sizeof(path_brother));
1774 }
1775
1776 static int hash_sister_callback(struct afs_callback_arg *aca)
1777 {
1778         unsigned char *hash = aca->query.data;
1779         struct osl_row *hash_sister;
1780         int ret = find_hash_sister(hash, &hash_sister);
1781
1782         if (ret <= 0)
1783                 return ret;
1784         return pass_buffer_as_shm(aca->fd, SBD_OUTPUT, (char *)&hash_sister,
1785                 sizeof(hash_sister));
1786 }
1787
1788 static int get_row_pointer_from_result(struct osl_object *result,
1789                 __a_unused uint8_t band, void *private)
1790 {
1791         struct osl_row **row = private;
1792
1793         if (band == SBD_OUTPUT)
1794                 *row = *(struct osl_row **)(result->data);
1795         return 1;
1796 }
1797
1798 static int add_one_audio_file(const char *path, void *private_data)
1799 {
1800         int ret, send_ret = 1, fd;
1801         uint8_t format_num = -1;
1802         struct private_add_data *pad = private_data;
1803         struct afh_info afhi, *afhi_ptr = NULL;
1804         struct osl_row *pb = NULL, *hs = NULL; /* path brother/hash sister */
1805         struct osl_object map, obj = {.data = NULL}, query;
1806         unsigned char hash[HASH_SIZE];
1807
1808         ret = guess_audio_format(path);
1809         if (ret < 0 && !(pad->flags & ADD_FLAG_ALL)) {
1810                 ret = 0;
1811                 goto out_free;
1812         }
1813         query.data = (char *)path;
1814         query.size = strlen(path) + 1;
1815         ret = send_callback_request(path_brother_callback, &query,
1816                 get_row_pointer_from_result, &pb);
1817         if (ret < 0 && ret != -OSL_ERRNO_TO_PARA_ERROR(E_OSL_RB_KEY_NOT_FOUND))
1818                 goto out_free;
1819         ret = 1;
1820         if (pb && (pad->flags & ADD_FLAG_LAZY)) { /* lazy is really cheap */
1821                 if (pad->flags & ADD_FLAG_VERBOSE)
1822                         send_ret = send_sb_va(&pad->cc->scc, SBD_OUTPUT,
1823                                 "lazy-ignore: %s\n", path);
1824                 goto out_free;
1825         }
1826         /* We still want to add this file. Compute its hash. */
1827         ret = mmap_full_file(path, O_RDONLY, &map.data, &map.size, &fd);
1828         if (ret < 0)
1829                 goto out_free;
1830         hash_function(map.data, map.size, hash);
1831
1832         /* Check whether the database contains a file with the same hash. */
1833         query.data = hash;
1834         query.size = HASH_SIZE;
1835         ret = send_callback_request(hash_sister_callback, &query,
1836                 get_row_pointer_from_result, &hs);
1837         if (ret < 0)
1838                 goto out_unmap;
1839         /* Return success if we already know this file. */
1840         ret = 1;
1841         if (pb && hs && hs == pb && !(pad->flags & ADD_FLAG_FORCE)) {
1842                 if (pad->flags & ADD_FLAG_VERBOSE)
1843                         send_ret = send_sb_va(&pad->cc->scc, SBD_OUTPUT,
1844                                 "%s exists, not forcing update\n", path);
1845                 goto out_unmap;
1846         }
1847         /*
1848          * We won't recalculate the audio format info and the chunk table if
1849          * there is a hash sister and FORCE was not given.
1850          */
1851         if (!hs || (pad->flags & ADD_FLAG_FORCE)) {
1852                 ret = compute_afhi(path, map.data, map.size, fd, &afhi);
1853                 if (ret < 0)
1854                         goto out_unmap;
1855                 format_num = ret;
1856                 afhi_ptr = &afhi;
1857         }
1858         munmap(map.data, map.size);
1859         close(fd);
1860         if (pad->flags & ADD_FLAG_VERBOSE) {
1861                 send_ret = send_sb_va(&pad->cc->scc, SBD_OUTPUT,
1862                         "adding %s\n", path);
1863                 if (send_ret < 0)
1864                         goto out_free;
1865         }
1866         save_add_callback_buffer(hash, path, afhi_ptr, pad->flags, format_num, &obj);
1867         /* Ask afs to consider this entry for adding. */
1868         ret = send_callback_request(com_add_callback, &obj,
1869                 afs_cb_result_handler, pad->cc);
1870         goto out_free;
1871
1872 out_unmap:
1873         close(fd);
1874         munmap(map.data, map.size);
1875 out_free:
1876         if (ret < 0 && send_ret >= 0)
1877                 send_ret = send_sb_va(&pad->cc->scc, SBD_ERROR_LOG,
1878                         "failed to add %s (%s)\n", path, para_strerror(-ret));
1879         free(obj.data);
1880         clear_afhi(afhi_ptr);
1881         /* Stop adding files only on send errors. */
1882         return send_ret;
1883 }
1884
1885 int com_add(struct command_context *cc)
1886 {
1887         int i, ret;
1888         struct private_add_data pad = {.cc = cc, .flags = 0};
1889
1890         for (i = 1; i < cc->argc; i++) {
1891                 const char *arg = cc->argv[i];
1892                 if (arg[0] != '-')
1893                         break;
1894                 if (!strcmp(arg, "--")) {
1895                         i++;
1896                         break;
1897                 }
1898                 if (!strcmp(arg, "-a")) {
1899                         pad.flags |= ADD_FLAG_ALL;
1900                         continue;
1901                 }
1902                 if (!strcmp(arg, "-l")) {
1903                         pad.flags |= ADD_FLAG_LAZY;
1904                         continue;
1905                 }
1906                 if (!strcmp(arg, "-f")) {
1907                         pad.flags |= ADD_FLAG_FORCE;
1908                         continue;
1909                 }
1910                 if (!strcmp(arg, "-v")) {
1911                         pad.flags |= ADD_FLAG_VERBOSE;
1912                         continue;
1913                 }
1914         }
1915         if (cc->argc <= i)
1916                 return -E_AFT_SYNTAX;
1917         for (; i < cc->argc; i++) {
1918                 char *path;
1919                 ret = verify_path(cc->argv[i], &path);
1920                 if (ret < 0) {
1921                         ret = send_sb_va(&cc->scc, SBD_ERROR_LOG, "%s: %s\n",
1922                                 cc->argv[i], para_strerror(-ret));
1923                         if (ret < 0)
1924                                 return ret;
1925                         continue;
1926                 }
1927                 if (ret == 1) /* directory */
1928                         ret = for_each_file_in_dir(path, add_one_audio_file,
1929                                 &pad);
1930                 else /* regular file */
1931                         ret = add_one_audio_file(path, &pad);
1932                 if (ret < 0) {
1933                         send_sb_va(&cc->scc, SBD_OUTPUT, "%s: %s\n", path,
1934                                 para_strerror(-ret));
1935                         free(path);
1936                         return ret;
1937                 }
1938                 free(path);
1939         }
1940         return 1;
1941 }
1942
1943 /**
1944  * Flags used by the touch command.
1945  *
1946  * \sa com_touch().
1947  */
1948 enum touch_flags {
1949         /** Whether the \p FNM_PATHNAME flag should be passed to fnmatch(). */
1950         TOUCH_FLAG_FNM_PATHNAME = 1,
1951         /** Activates verbose mode. */
1952         TOUCH_FLAG_VERBOSE = 2
1953 };
1954
1955 /** Options used by com_touch(). */
1956 struct com_touch_options {
1957         /** New num_played value. */
1958         int32_t num_played;
1959         /** New last played count. */
1960         int64_t last_played;
1961         /** New lyrics id. */
1962         int32_t lyrics_id;
1963         /** New image id. */
1964         int32_t image_id;
1965         /** New amplification value. */
1966         int32_t amp;
1967         /** Command line flags (see \ref touch_flags). */
1968         unsigned flags;
1969 };
1970
1971 static int touch_audio_file(__a_unused struct osl_table *table,
1972                 struct osl_row *row, const char *name, void *data)
1973 {
1974         struct afs_callback_arg *aca = data;
1975         struct com_touch_options *cto = aca->query.data;
1976         struct osl_object obj;
1977         struct afs_info old_afsi, new_afsi;
1978         int ret, no_options = cto->num_played < 0 && cto->last_played < 0 &&
1979                 cto->lyrics_id < 0 && cto->image_id < 0 && cto->amp < 0;
1980         struct afsi_change_event_data aced;
1981
1982         ret = get_afsi_object_of_row(row, &obj);
1983         if (ret < 0) {
1984                 para_printf(&aca->pbout, "cannot touch %s\n", name);
1985                 return ret;
1986         }
1987         ret = load_afsi(&old_afsi, &obj);
1988         if (ret < 0) {
1989                 para_printf(&aca->pbout, "cannot touch %s\n", name);
1990                 return ret;
1991         }
1992         new_afsi = old_afsi;
1993         if (no_options) {
1994                 new_afsi.num_played++;
1995                 new_afsi.last_played = time(NULL);
1996                 if (cto->flags & TOUCH_FLAG_VERBOSE)
1997                         para_printf(&aca->pbout, "%s: num_played = %u, "
1998                                 "last_played = now()\n", name,
1999                                 new_afsi.num_played);
2000         } else {
2001                 if (cto->flags & TOUCH_FLAG_VERBOSE)
2002                         para_printf(&aca->pbout, "touching %s\n", name);
2003                 if (cto->lyrics_id >= 0)
2004                         new_afsi.lyrics_id = cto->lyrics_id;
2005                 if (cto->image_id >= 0)
2006                         new_afsi.image_id = cto->image_id;
2007                 if (cto->num_played >= 0)
2008                         new_afsi.num_played = cto->num_played;
2009                 if (cto->last_played >= 0)
2010                         new_afsi.last_played = cto->last_played;
2011                 if (cto->amp >= 0)
2012                         new_afsi.amp = cto->amp;
2013         }
2014         save_afsi(&new_afsi, &obj); /* in-place update */
2015         aced.aft_row = row;
2016         aced.old_afsi = &old_afsi;
2017         return afs_event(AFSI_CHANGE, &aca->pbout, &aced);
2018 }
2019
2020 static int com_touch_callback(struct afs_callback_arg *aca)
2021 {
2022         int ret;
2023         struct com_touch_options *cto = aca->query.data;
2024         struct pattern_match_data pmd = {
2025                 .table = audio_file_table,
2026                 .loop_col_num = AFTCOL_HASH,
2027                 .match_col_num = AFTCOL_PATH,
2028                 .patterns = {
2029                         .data = (char *)aca->query.data
2030                                 + sizeof(struct com_touch_options),
2031                         .size = aca->query.size
2032                                 - sizeof(struct com_touch_options)
2033                 },
2034                 .data = aca,
2035                 .action = touch_audio_file
2036         };
2037         if (cto->flags & TOUCH_FLAG_FNM_PATHNAME)
2038                 pmd.fnmatch_flags |= FNM_PATHNAME;
2039         ret = for_each_matching_row(&pmd);
2040         if (ret >= 0 && pmd.num_matches == 0)
2041                 ret = -E_NO_MATCH;
2042         return ret;
2043 }
2044
2045 int com_touch(struct command_context *cc)
2046 {
2047         struct com_touch_options cto = {
2048                 .num_played = -1,
2049                 .last_played = -1,
2050                 .lyrics_id = -1,
2051                 .image_id = -1,
2052                 .amp = -1,
2053         };
2054         struct osl_object query = {.data = &cto, .size = sizeof(cto)};
2055         int i, ret;
2056
2057
2058         for (i = 1; i < cc->argc; i++) {
2059                 const char *arg = cc->argv[i];
2060                 if (arg[0] != '-')
2061                         break;
2062                 if (!strcmp(arg, "--")) {
2063                         i++;
2064                         break;
2065                 }
2066                 if (!strncmp(arg, "-n=", 3)) {
2067                         ret = para_atoi32(arg + 3, &cto.num_played);
2068                         if (ret < 0)
2069                                 return ret;
2070                         continue;
2071                 }
2072                 if (!strncmp(arg, "-l=", 3)) {
2073                         ret = para_atoi64(arg + 3, &cto.last_played);
2074                         if (ret < 0)
2075                                 return ret;
2076                         continue;
2077                 }
2078                 if (!strncmp(arg, "-y=", 3)) {
2079                         ret = para_atoi32(arg + 3, &cto.lyrics_id);
2080                         if (ret < 0)
2081                                 return ret;
2082                         continue;
2083                 }
2084                 if (!strncmp(arg, "-i=", 3)) {
2085                         ret = para_atoi32(arg + 3, &cto.image_id);
2086                         if (ret < 0)
2087                                 return ret;
2088                         continue;
2089                 }
2090                 if (!strncmp(arg, "-a=", 3)) {
2091                         int32_t val;
2092                         ret = para_atoi32(arg + 3, &val);
2093                         if (ret < 0)
2094                                 return ret;
2095                         if (val < 0 || val > 255)
2096                                 return -ERRNO_TO_PARA_ERROR(EINVAL);
2097                         cto.amp = val;
2098                         continue;
2099                 }
2100                 if (!strcmp(arg, "-p")) {
2101                         cto.flags |= TOUCH_FLAG_FNM_PATHNAME;
2102                         continue;
2103                 }
2104                 if (!strcmp(arg, "-v")) {
2105                         cto.flags |= TOUCH_FLAG_VERBOSE;
2106                         continue;
2107                 }
2108                 break; /* non-option starting with dash */
2109         }
2110         if (i >= cc->argc)
2111                 return -E_AFT_SYNTAX;
2112         return send_option_arg_callback_request(&query, cc->argc - i,
2113                 cc->argv + i, com_touch_callback, afs_cb_result_handler, cc);
2114 }
2115
2116 /** Flags for com_rm(). */
2117 enum rm_flags {
2118         /** -v */
2119         RM_FLAG_VERBOSE = 1,
2120         /** -f */
2121         RM_FLAG_FORCE = 2,
2122         /** -p */
2123         RM_FLAG_FNM_PATHNAME = 4
2124 };
2125
2126 static int remove_audio_file(__a_unused struct osl_table *table,
2127                 struct osl_row *row, const char *name, void *data)
2128 {
2129         struct afs_callback_arg *aca = data;
2130         uint32_t flags =*(uint32_t *)aca->query.data;
2131         int ret;
2132
2133         if (flags & RM_FLAG_VERBOSE)
2134                 para_printf(&aca->pbout, "removing %s\n", name);
2135         ret = afs_event(AUDIO_FILE_REMOVE, &aca->pbout, row);
2136         if (ret < 0)
2137                 return ret;
2138         ret = osl(osl_del_row(audio_file_table, row));
2139         if (ret < 0)
2140                 para_printf(&aca->pbout, "cannot remove %s\n", name);
2141         return ret;
2142 }
2143
2144 static int com_rm_callback(struct afs_callback_arg *aca)
2145 {
2146         int ret;
2147         uint32_t flags = *(uint32_t *)aca->query.data;
2148         struct pattern_match_data pmd = {
2149                 .table = audio_file_table,
2150                 .loop_col_num = AFTCOL_HASH,
2151                 .match_col_num = AFTCOL_PATH,
2152                 .patterns = {.data = (char *)aca->query.data + sizeof(uint32_t),
2153                         .size = aca->query.size - sizeof(uint32_t)},
2154                 .data = aca,
2155                 .action = remove_audio_file
2156         };
2157         if (flags & RM_FLAG_FNM_PATHNAME)
2158                 pmd.fnmatch_flags |= FNM_PATHNAME;
2159         ret = for_each_matching_row(&pmd);
2160         if (ret < 0)
2161                 goto out;
2162         if (pmd.num_matches == 0) {
2163                 if (!(flags & RM_FLAG_FORCE))
2164                         ret = -E_NO_MATCH;
2165         } else if (flags & RM_FLAG_VERBOSE)
2166                 para_printf(&aca->pbout, "removed %u file(s)\n",
2167                         pmd.num_matches);
2168 out:
2169         return ret;
2170 }
2171
2172 /* TODO options: -r (recursive) */
2173 int com_rm(struct command_context *cc)
2174 {
2175         uint32_t flags = 0;
2176         struct osl_object query = {.data = &flags, .size = sizeof(flags)};
2177         int i;
2178
2179         for (i = 1; i < cc->argc; i++) {
2180                 const char *arg = cc->argv[i];
2181                 if (arg[0] != '-')
2182                         break;
2183                 if (!strcmp(arg, "--")) {
2184                         i++;
2185                         break;
2186                 }
2187                 if (!strcmp(arg, "-f")) {
2188                         flags |= RM_FLAG_FORCE;
2189                         continue;
2190                 }
2191                 if (!strcmp(arg, "-p")) {
2192                         flags |= RM_FLAG_FNM_PATHNAME;
2193                         continue;
2194                 }
2195                 if (!strcmp(arg, "-v")) {
2196                         flags |= RM_FLAG_VERBOSE;
2197                         continue;
2198                 }
2199                 break;
2200         }
2201         if (i >= cc->argc)
2202                 return -E_AFT_SYNTAX;
2203         return send_option_arg_callback_request(&query, cc->argc - i,
2204                 cc->argv + i, com_rm_callback, afs_cb_result_handler, cc);
2205 }
2206
2207 /**
2208  * Flags used by the cpsi command.
2209  *
2210  * \sa com_cpsi().
2211  */
2212 enum cpsi_flags {
2213         /** Whether the lyrics id should be copied. */
2214         CPSI_FLAG_COPY_LYRICS_ID = 1,
2215         /** Whether the image id should be copied. */
2216         CPSI_FLAG_COPY_IMAGE_ID = 2,
2217         /** Whether the lastplayed time should be copied. */
2218         CPSI_FLAG_COPY_LASTPLAYED = 4,
2219         /** Whether the numplayed count should be copied. */
2220         CPSI_FLAG_COPY_NUMPLAYED = 8,
2221         /** Whether the attributes should be copied. */
2222         CPSI_FLAG_COPY_ATTRIBUTES = 16,
2223         /** Activates verbose mode. */
2224         CPSI_FLAG_VERBOSE = 32,
2225 };
2226
2227 /** Data passed to the action handler of com_cpsi(). */
2228 struct cpsi_action_data {
2229         /** command line flags (see \ref cpsi_flags). */
2230         unsigned flags;
2231         /** Values are copied from here. */
2232         struct afs_info source_afsi;
2233         /** What was passed to com_cpsi_callback(). */
2234         struct afs_callback_arg *aca;
2235 };
2236
2237 static int copy_selector_info(__a_unused struct osl_table *table,
2238                 struct osl_row *row, const char *name, void *data)
2239 {
2240         struct cpsi_action_data *cad = data;
2241         struct osl_object target_afsi_obj;
2242         int ret;
2243         struct afs_info old_afsi, target_afsi;
2244         struct afsi_change_event_data aced;
2245
2246         ret = get_afsi_object_of_row(row, &target_afsi_obj);
2247         if (ret < 0)
2248                 return ret;
2249         load_afsi(&target_afsi, &target_afsi_obj);
2250         old_afsi = target_afsi;
2251         if (cad->flags & CPSI_FLAG_COPY_LYRICS_ID)
2252                 target_afsi.lyrics_id = cad->source_afsi.lyrics_id;
2253         if (cad->flags & CPSI_FLAG_COPY_IMAGE_ID)
2254                 target_afsi.image_id = cad->source_afsi.image_id;
2255         if (cad->flags & CPSI_FLAG_COPY_LASTPLAYED)
2256                 target_afsi.last_played = cad->source_afsi.last_played;
2257         if (cad->flags & CPSI_FLAG_COPY_NUMPLAYED)
2258                 target_afsi.num_played = cad->source_afsi.num_played;
2259         if (cad->flags & CPSI_FLAG_COPY_ATTRIBUTES)
2260                 target_afsi.attributes = cad->source_afsi.attributes;
2261         save_afsi(&target_afsi, &target_afsi_obj); /* in-place update */
2262         if (cad->flags & CPSI_FLAG_VERBOSE)
2263                 para_printf(&cad->aca->pbout, "copied afsi to %s\n", name);
2264         aced.aft_row = row;
2265         aced.old_afsi = &old_afsi;
2266         return afs_event(AFSI_CHANGE, &cad->aca->pbout, &aced);
2267 }
2268
2269 static int com_cpsi_callback(struct afs_callback_arg *aca)
2270 {
2271         struct cpsi_action_data cad = {
2272                 .flags = *(unsigned *)aca->query.data,
2273                 .aca = aca
2274         };
2275         int ret;
2276         char *source_path = (char *)aca->query.data + sizeof(cad.flags);
2277         struct pattern_match_data pmd = {
2278                 .table = audio_file_table,
2279                 .loop_col_num = AFTCOL_HASH,
2280                 .match_col_num = AFTCOL_PATH,
2281                 .patterns = {.data = source_path + strlen(source_path) + 1,
2282                         .size = aca->query.size - sizeof(cad.flags)
2283                                 - strlen(source_path) - 1},
2284                 .data = &cad,
2285                 .action = copy_selector_info
2286         };
2287
2288         ret = get_afsi_of_path(source_path, &cad.source_afsi);
2289         if (ret < 0)
2290                 goto out;
2291         ret = for_each_matching_row(&pmd);
2292         if (ret < 0)
2293                 goto out;
2294         if (pmd.num_matches > 0) {
2295                 if (cad.flags & CPSI_FLAG_VERBOSE)
2296                         para_printf(&aca->pbout, "updated afsi of %u file(s)\n",
2297                                 pmd.num_matches);
2298         } else
2299                 ret = -E_NO_MATCH;
2300 out:
2301         return ret;
2302 }
2303
2304 int com_cpsi(struct command_context *cc)
2305 {
2306         unsigned flags = 0;
2307         int i;
2308         struct osl_object options = {.data = &flags, .size = sizeof(flags)};
2309
2310         for (i = 1; i < cc->argc; i++) {
2311                 const char *arg = cc->argv[i];
2312                 if (arg[0] != '-')
2313                         break;
2314                 if (!strcmp(arg, "--")) {
2315                         i++;
2316                         break;
2317                 }
2318                 if (!strcmp(arg, "-y")) {
2319                         flags |= CPSI_FLAG_COPY_LYRICS_ID;
2320                         continue;
2321                 }
2322                 if (!strcmp(arg, "-i")) {
2323                         flags |= CPSI_FLAG_COPY_IMAGE_ID;
2324                         continue;
2325                 }
2326                 if (!strcmp(arg, "-l")) {
2327                         flags |= CPSI_FLAG_COPY_LASTPLAYED;
2328                         continue;
2329                 }
2330                 if (!strcmp(arg, "-n")) {
2331                         flags |= CPSI_FLAG_COPY_NUMPLAYED;
2332                         continue;
2333                 }
2334                 if (!strcmp(arg, "-a")) {
2335                         flags |= CPSI_FLAG_COPY_ATTRIBUTES;
2336                         continue;
2337                 }
2338                 if (!strcmp(arg, "-v")) {
2339                         flags |= CPSI_FLAG_VERBOSE;
2340                         continue;
2341                 }
2342                 break;
2343         }
2344         if (i + 1 >= cc->argc) /* need at least source file and pattern */
2345                 return -E_AFT_SYNTAX;
2346         if (!(flags & ~CPSI_FLAG_VERBOSE)) /* no copy flags given */
2347                 flags = ~(unsigned)CPSI_FLAG_VERBOSE | flags;
2348         return send_option_arg_callback_request(&options, cc->argc - i,
2349                 cc->argv + i, com_cpsi_callback, afs_cb_result_handler, cc);
2350 }
2351
2352 struct change_atts_data {
2353         uint64_t add_mask, del_mask;
2354         struct afs_callback_arg *aca;
2355 };
2356
2357 static int change_atts(__a_unused struct osl_table *table,
2358                 struct osl_row *row, __a_unused const char *name, void *data)
2359 {
2360         int ret;
2361         struct osl_object obj;
2362         struct afs_info old_afsi, new_afsi;
2363         struct afsi_change_event_data aced = {
2364                 .aft_row = row,
2365                 .old_afsi = &old_afsi
2366         };
2367         struct change_atts_data *cad = data;
2368
2369         ret = get_afsi_object_of_row(row, &obj);
2370         if (ret < 0)
2371                 return ret;
2372         ret = load_afsi(&old_afsi, &obj);
2373         if (ret < 0)
2374                 return ret;
2375         new_afsi = old_afsi;
2376         new_afsi.attributes |= cad->add_mask;
2377         new_afsi.attributes &= ~cad->del_mask;
2378         save_afsi(&new_afsi, &obj); /* in-place update */
2379         return afs_event(AFSI_CHANGE, &cad->aca->pbout, &aced);
2380 }
2381
2382 static int com_setatt_callback(struct afs_callback_arg *aca)
2383 {
2384         char *p;
2385         int ret;
2386         size_t len;
2387         struct change_atts_data cad = {.aca = aca};
2388         struct pattern_match_data pmd = {
2389                 .table = audio_file_table,
2390                 .loop_col_num = AFTCOL_HASH,
2391                 .match_col_num = AFTCOL_PATH,
2392                 .pm_flags = PM_SKIP_EMPTY_NAME,
2393                 .data = &cad,
2394                 .action = change_atts
2395         };
2396
2397         for (
2398                 p = aca->query.data;
2399                 p < (char *)aca->query.data + aca->query.size;
2400                 p += len + 1
2401         ) {
2402                 char c;
2403                 unsigned char bitnum;
2404
2405                 len = strlen(p);
2406                 ret = -E_ATTR_SYNTAX;
2407                 if (len == 0)
2408                         goto out;
2409                 c = p[len - 1];
2410                 if (c != '+' && c != '-')
2411                         break;
2412                 p[len - 1] = '\0';
2413                 ret = get_attribute_bitnum_by_name(p, &bitnum);
2414                 if (ret < 0) {
2415                         para_printf(&aca->pbout, "attribute not found: %s\n", p);
2416                         goto out;
2417                 }
2418                 if (c == '+')
2419                         cad.add_mask |= (1UL << bitnum);
2420                 else
2421                         cad.del_mask |= (1UL << bitnum);
2422         }
2423         ret = -E_ATTR_SYNTAX;
2424         if (!cad.add_mask && !cad.del_mask)
2425                 goto out;
2426         pmd.patterns.data = p;
2427         if (p >= (char *)aca->query.data + aca->query.size)
2428                 goto out;
2429         pmd.patterns.size = (char *)aca->query.data + aca->query.size - p;
2430         ret = for_each_matching_row(&pmd);
2431         if (ret < 0)
2432                 goto out;
2433         if (pmd.num_matches == 0)
2434                 ret = -E_NO_MATCH;
2435 out:
2436         return ret;
2437 }
2438
2439 int com_setatt(struct command_context *cc)
2440 {
2441         if (cc->argc < 3)
2442                 return -E_ATTR_SYNTAX;
2443         return send_standard_callback_request(cc->argc - 1, cc->argv + 1,
2444                 com_setatt_callback, afs_cb_result_handler, cc);
2445 }
2446
2447 static int afs_stat_callback(struct afs_callback_arg *aca)
2448 {
2449         int *parser_friendly = aca->query.data;
2450         char *buf = *parser_friendly?
2451                 parser_friendly_status_items : status_items;
2452
2453         if (!buf)
2454                 return 0;
2455         return pass_buffer_as_shm(aca->fd, SBD_OUTPUT, buf, strlen(buf));
2456 }
2457
2458 /**
2459  * Get the current afs status items from the afs process and send it.
2460  *
2461  * \param cc The command context, used e.g. for data encryption.
2462  * \param parser_friendly Whether parser-friendly output format should be used.
2463  *
2464  * As the contents of the afs status items change in time and the command
2465  * handler only has a COW version created at fork time, it can not send
2466  * up-to-date afs status items directly. Therefore the usual callback mechanism
2467  * is used to pass the status items from the afs process to the command handler
2468  * via a shared memory area and a pipe.
2469  *
2470  * \return The return value of the underlying call to \ref send_callback_request().
2471  */
2472 int send_afs_status(struct command_context *cc, int parser_friendly)
2473 {
2474         struct osl_object query = {.data = &parser_friendly,
2475                 .size = sizeof(parser_friendly)};
2476
2477         return send_callback_request(afs_stat_callback, &query,
2478                 afs_cb_result_handler, cc);
2479 }
2480
2481 /* returns success on non-fatal errors to keep the loop going */
2482 static int check_audio_file(struct osl_row *row, void *data)
2483 {
2484         char *path;
2485         struct para_buffer *pb = data;
2486         struct stat statbuf;
2487         int ret = get_audio_file_path_of_row(row, &path);
2488         struct afs_info afsi;
2489         char *blob_name;
2490
2491         if (ret < 0) {
2492                 para_printf(pb, "%s\n", para_strerror(-ret));
2493                 return ret;
2494         }
2495         if (stat(path, &statbuf) < 0)
2496                 para_printf(pb, "%s: stat error (%s)\n", path, strerror(errno));
2497         else if (!S_ISREG(statbuf.st_mode))
2498                 para_printf(pb, "%s: not a regular file\n", path);
2499         ret = get_afsi_of_row(row, &afsi);
2500         if (ret < 0) {
2501                 para_printf(pb, "%s: %s\n", path, para_strerror(-ret));
2502                 return 1;
2503         }
2504         ret = lyr_get_name_by_id(afsi.lyrics_id, &blob_name);
2505         if (ret < 0)
2506                 para_printf(pb, "%s lyrics id %u: %s\n", path, afsi.lyrics_id,
2507                         para_strerror(-ret));
2508         ret = img_get_name_by_id(afsi.image_id, &blob_name);
2509         if (ret < 0)
2510                 para_printf(pb, "%s image id %u: %s\n", path, afsi.image_id,
2511                         para_strerror(-ret));
2512         return 0;
2513 }
2514
2515 /**
2516  * Check the audio file table for inconsistencies.
2517  *
2518  * \param aca Only ->pbout is used for diagnostics.
2519  *
2520  * \return Standard. Inconsistencies are reported but not regarded as an error.
2521  *
2522  * \sa com_check().
2523  */
2524 int aft_check_callback(struct afs_callback_arg *aca)
2525 {
2526         para_printf(&aca->pbout, "checking audio file table...\n");
2527         return audio_file_loop(&aca->pbout, check_audio_file);
2528 }
2529
2530 struct aft_check_atts_data {
2531         uint64_t att_mask;
2532         struct para_buffer *pb;
2533 };
2534
2535 static int check_atts_of_audio_file(struct osl_row *row, void *data)
2536 {
2537         struct aft_check_atts_data *acad = data;
2538         int ret;
2539         struct afs_info afsi;
2540         char *path;
2541         uint64_t bad_bits;
2542
2543         ret = get_afsi_of_row(row, &afsi);
2544         if (ret < 0) {
2545                 para_printf(acad->pb, "cannot get afsi\n");
2546                 return ret;
2547         }
2548         bad_bits = afsi.attributes & ~acad->att_mask;
2549         if (bad_bits == 0) /* OK */
2550                 return 0;
2551         ret = get_audio_file_path_of_row(row, &path);
2552         if (ret < 0) {
2553                 para_printf(acad->pb, "cannot get path\n");
2554                 return ret;
2555         }
2556         para_printf(acad->pb, "invalid attribute bits (%" PRIu64 "): %s\n",
2557                 bad_bits, path);
2558         /* return success to keep looping */
2559         return 1;
2560 }
2561
2562 /**
2563  * Iterate over all audio files and check the attribute bit mask.
2564  *
2565  * \param att_mask The mask of all valid attributes.
2566  * \param pb Used for reporting inconsistencies.
2567  *
2568  * This reads the attribute bit mask of each audio file from the afs info
2569  * structure stored in the audio file table and verifies that all set bits are
2570  * also turned on in \a att_mask, i.e., correspond to an attribute of the
2571  * attribute table. Audio files for which this is not the case are reported via
2572  * \a pb.
2573  *
2574  * \return Standard. Inconsistencies are not regarded as errors.
2575  *
2576  * \sa \ref attribute_check_callback().
2577  */
2578 int aft_check_attributes(uint64_t att_mask, struct para_buffer *pb)
2579 {
2580         struct aft_check_atts_data acad = {.att_mask = att_mask, .pb = pb};
2581
2582         para_printf(pb, "checking attributes, mask: %" PRIx64 "\n", att_mask);
2583         return audio_file_loop(&acad, check_atts_of_audio_file);
2584 }
2585
2586 /**
2587  * Close the audio file table.
2588  *
2589  * \param flags Usual flags that are passed to osl_close_table().
2590  *
2591  * \sa osl_close_table().
2592  */
2593 static void aft_close(void)
2594 {
2595         osl_close_table(audio_file_table, OSL_MARK_CLEAN);
2596         audio_file_table = NULL;
2597 }
2598
2599 /**
2600  * Open the audio file table.
2601  *
2602  * \param dir The database directory.
2603  *
2604  * \return Standard.
2605  *
2606  * \sa osl_open_table().
2607  */
2608 static int aft_open(const char *dir)
2609 {
2610         int ret;
2611
2612         audio_file_table_desc.dir = dir;
2613         ret = osl(osl_open_table(&audio_file_table_desc, &audio_file_table));
2614         if (ret >= 0) {
2615                 unsigned num;
2616                 osl_get_num_rows(audio_file_table, &num);
2617                 PARA_INFO_LOG("audio file table contains %d files\n", num);
2618                 return ret;
2619         }
2620         PARA_NOTICE_LOG("failed to open audio file table\n");
2621         audio_file_table = NULL;
2622         if (ret == -OSL_ERRNO_TO_PARA_ERROR(E_OSL_NOENT))
2623                 return 1;
2624         return ret;
2625 }
2626
2627 static int aft_create(const char *dir)
2628 {
2629         audio_file_table_desc.dir = dir;
2630         return osl(osl_create_table(&audio_file_table_desc));
2631 }
2632
2633 static int clear_attribute(struct osl_row *row, void *data)
2634 {
2635         struct rmatt_event_data *red = data;
2636         struct afs_info afsi;
2637         struct osl_object obj;
2638         int ret = get_afsi_object_of_row(row, &obj);
2639         uint64_t mask = ~(1ULL << red->bitnum);
2640
2641         if (ret < 0)
2642                 return ret;
2643         ret = load_afsi(&afsi, &obj);
2644         if (ret < 0)
2645                 return ret;
2646         afsi.attributes &= mask;
2647         save_afsi(&afsi, &obj);
2648         return 1;
2649 }
2650
2651 static int aft_event_handler(enum afs_events event, struct para_buffer *pb,
2652                 void *data)
2653 {
2654         int ret;
2655
2656         switch (event) {
2657         case ATTRIBUTE_REMOVE: {
2658                 const struct rmatt_event_data *red = data;
2659                 para_printf(pb, "clearing attribute %s (bit %u) from all "
2660                         "entries in the audio file table\n", red->name,
2661                         red->bitnum);
2662                 return audio_file_loop(data, clear_attribute);
2663         } case AFSI_CHANGE: {
2664                 struct afsi_change_event_data *aced = data;
2665                 uint64_t old_last_played = status_item_ls_data.afsi.last_played;
2666                 if (aced->aft_row != current_aft_row)
2667                         return 0;
2668                 ret = get_afsi_of_row(aced->aft_row, &status_item_ls_data.afsi);
2669                 if (ret < 0)
2670                         return ret;
2671                 status_item_ls_data.afsi.last_played = old_last_played;
2672                 make_status_items();
2673                 return 1;
2674         } case AFHI_CHANGE: {
2675                 if (data != current_aft_row)
2676                         return 0;
2677                 ret = get_afhi_of_row(data, &status_item_ls_data.afhi);
2678                 if (ret < 0)
2679                         return ret;
2680                 make_status_items();
2681                 return 1;
2682         } default:
2683                 return 0;
2684         }
2685 }
2686
2687 /**
2688  * Initialize the audio file table.
2689  *
2690  * \param t Pointer to the structure to be initialized.
2691  */
2692 void aft_init(struct afs_table *t)
2693 {
2694         t->open = aft_open;
2695         t->close = aft_close;
2696         t->create = aft_create;
2697         t->event_handler = aft_event_handler;
2698 }