1 /* Copyright (C) 2007 Andre Noll <maan@tuebingen.mpg.de>, see file COPYING. */
3 /** \file aft.c Audio file table functions. */
13 #include "server_cmd.lsg.h"
22 #include "portable_io.h"
26 /* Data about one audio file. Needed for ls and stat output. */
28 /* Usual audio format handler information. */
30 /* Audio file selector information. */
32 /* The full path of the audio file. */
34 /* The score value (if -a was given). */
36 /* The hash value of the audio file data. */
41 * The internal state of the audio file table is described by the following
42 * variables which are private to aft.c.
44 static struct osl_table *audio_file_table; /* NULL if table not open */
45 static struct osl_row *current_aft_row; /* NULL if no audio file open */
46 static unsigned char current_hash[HASH2_SIZE]; /* only used on sighup */
48 static char *status_items;
49 static char *parser_friendly_status_items;
50 static struct ls_data status_item_ls_data;
52 /** The different sorting methods of the ls command. */
53 enum ls_sorting_method {
54 LS_SORT_BY_PATH, /**< -s=p (default) */
55 LS_SORT_BY_SCORE, /**< -s=s */
56 LS_SORT_BY_LAST_PLAYED, /**< -s=l */
57 LS_SORT_BY_NUM_PLAYED, /**< -s=n */
58 LS_SORT_BY_FREQUENCY, /**< -s=f */
59 LS_SORT_BY_CHANNELS, /**< -s=c */
60 LS_SORT_BY_IMAGE_ID, /**< -s=i */
61 LS_SORT_BY_LYRICS_ID, /**< -s=y */
62 LS_SORT_BY_BITRATE, /**< -s=b */
63 LS_SORT_BY_DURATION, /**< -s=d */
64 LS_SORT_BY_AUDIO_FORMAT, /**< -s=a */
65 LS_SORT_BY_HASH, /**< -s=h */
68 /** The different listing modes of the ls command. */
69 enum ls_listing_mode {
70 LS_MODE_SHORT, /**< Default listing mode. */
71 LS_MODE_LONG, /**< -l or -l=l */
72 LS_MODE_VERBOSE, /** -l=v */
73 LS_MODE_MBOX, /** -l=m */
74 LS_MODE_CHUNKS, /** -l=c */
75 LS_MODE_PARSER, /** -l=p */
79 * The size of the individual output fields of the ls command.
81 * These depend on the content being listed. For example, if each listed file
82 * is shorter than an hour, the duration format is set to mm:ss. Otherwise it
86 /** size of the score field. */
87 unsigned short score_width;
88 /** size of the image id field. */
89 unsigned short image_id_width;
90 /** size of the lyrics id field. */
91 unsigned short lyrics_id_width;
92 /** size of the bitrate field. */
93 unsigned short bitrate_width;
94 /** size of the frequency field. */
95 unsigned short frequency_width;
96 /** size of the duration field. */
97 unsigned short duration_width;
98 /** size of the num played field. */
99 unsigned short num_played_width;
100 /** size of the amp field. */
101 unsigned short amp_width;
102 /** size of the audio format field. */
103 unsigned short audio_format_width;
106 /** Data passed from the ls command handler to its callback function. */
108 struct lls_parse_result *lpr;
109 /* Derived from lpr */
110 enum ls_sorting_method sorting;
111 /* Derived from lpr */
112 enum ls_listing_mode mode;
113 /** Used for long listing mode to align the output fields. */
114 struct ls_widths widths;
115 /** Size of the \a data array. */
117 /** Number of used entries in the data array. */
118 uint32_t num_matching_paths;
119 /** Array of matching entries. */
120 struct ls_data *data;
121 /** Used to sort the array. */
122 struct ls_data **data_ptr;
126 * Describes the layout of the mmapped-afs info struct.
128 * \sa struct \ref afs_info.
131 /** Where .last_played is stored. */
132 AFSI_LAST_PLAYED_OFFSET = 0,
133 /** Storage position of the attributes bitmap. */
134 AFSI_ATTRIBUTES_OFFSET = 8,
135 /** Storage position of the .num_played field. */
136 AFSI_NUM_PLAYED_OFFSET = 16,
137 /** Storage position of the .image_id field. */
138 AFSI_IMAGE_ID_OFFSET = 20,
139 /** Storage position of the .lyrics_id field. */
140 AFSI_LYRICS_ID_OFFSET = 24,
141 /** Storage position of the .audio_format_id field. */
142 AFSI_AUDIO_FORMAT_ID_OFFSET = 28,
143 /** Storage position of the amplification field. */
144 AFSI_AMP_OFFSET = 29,
145 /** 2 bytes reserved space for future usage. */
146 AFSI_AUDIO_FORMAT_UNUSED_OFFSET = 30,
147 /** On-disk storage space needed. */
152 * Convert a struct afs_info to an osl object.
154 * \param afsi Pointer to the audio file info to be converted.
155 * \param obj Result pointer.
157 * \sa \ref load_afsi().
159 static void save_afsi(struct afs_info *afsi, struct osl_object *obj)
161 char *buf = obj->data;
163 write_u64(buf + AFSI_LAST_PLAYED_OFFSET, afsi->last_played);
164 write_u64(buf + AFSI_ATTRIBUTES_OFFSET, afsi->attributes);
165 write_u32(buf + AFSI_NUM_PLAYED_OFFSET, afsi->num_played);
166 write_u32(buf + AFSI_IMAGE_ID_OFFSET, afsi->image_id);
167 write_u32(buf + AFSI_LYRICS_ID_OFFSET, afsi->lyrics_id);
168 write_u8(buf + AFSI_AUDIO_FORMAT_ID_OFFSET,
169 afsi->audio_format_id);
170 write_u8(buf + AFSI_AMP_OFFSET, afsi->amp);
171 memset(buf + AFSI_AUDIO_FORMAT_UNUSED_OFFSET, 0, 2);
175 * Get the audio file selector info struct stored in an osl object.
177 * \param afsi Points to the audio_file info structure to be filled in.
178 * \param obj The osl object holding the data.
182 * \sa \ref save_afsi().
184 static int load_afsi(struct afs_info *afsi, struct osl_object *obj)
186 char *buf = obj->data;
187 if (obj->size < AFSI_SIZE)
189 afsi->last_played = read_u64(buf + AFSI_LAST_PLAYED_OFFSET);
190 afsi->attributes = read_u64(buf + AFSI_ATTRIBUTES_OFFSET);
191 afsi->num_played = read_u32(buf + AFSI_NUM_PLAYED_OFFSET);
192 afsi->image_id = read_u32(buf + AFSI_IMAGE_ID_OFFSET);
193 afsi->lyrics_id = read_u32(buf + AFSI_LYRICS_ID_OFFSET);
194 afsi->audio_format_id = read_u8(buf +
195 AFSI_AUDIO_FORMAT_ID_OFFSET);
196 afsi->amp = read_u8(buf + AFSI_AMP_OFFSET);
200 /** The columns of the audio file table. */
201 enum audio_file_table_columns {
202 /** The hash on the content of the audio file. */
204 /** The full path in the filesystem. */
206 /** The audio file selector info. */
208 /** The audio format handler info. */
210 /** The chunk table info and the chunk table of the audio file. */
212 /** The number of columns of this table. */
216 /* compare function for the hash column */
217 static int aft_hash_compare(const struct osl_object *obj1,
218 const struct osl_object *obj2)
220 return hash_compare((unsigned char *)obj1->data,
221 (unsigned char *)obj2->data);
224 static struct osl_column_description aft_cols[] = {
226 .storage_type = OSL_MAPPED_STORAGE,
227 .storage_flags = OSL_RBTREE | OSL_FIXED_SIZE | OSL_UNIQUE,
229 .compare_function = aft_hash_compare,
230 .data_size = HASH2_SIZE
233 .storage_type = OSL_MAPPED_STORAGE,
234 .storage_flags = OSL_RBTREE | OSL_UNIQUE,
236 .compare_function = string_compare,
239 .storage_type = OSL_MAPPED_STORAGE,
240 .storage_flags = OSL_FIXED_SIZE,
242 .data_size = AFSI_SIZE
245 .storage_type = OSL_MAPPED_STORAGE,
249 .storage_type = OSL_DISK_STORAGE,
254 static struct osl_table_description audio_file_table_desc = {
255 .name = "audio-files",
256 .num_columns = NUM_AFT_COLUMNS,
257 .flags = OSL_LARGE_TABLE,
258 .column_descriptions = aft_cols
262 * Produce a canonicalized absolute pathname.
264 * Returns one if the resolved path a directory, zero if it is a regular file,
265 * negative on errors.
267 static int verify_path(const char *orig_path, char **resolved_path)
273 if (*orig_path != '/') /* we only accept absolute paths */
275 path = realpath(orig_path, NULL);
278 if (stat(path, &statbuf) < 0)
280 if (S_ISREG(statbuf.st_mode))
282 else if (S_ISDIR(statbuf.st_mode))
286 *resolved_path = path;
289 *resolved_path = NULL;
294 /** The on-disk layout of a afhi struct. */
296 /** Where the number of seconds is stored. */
297 AFHI_SECONDS_TOTAL_OFFSET = 0,
298 /** Position of the bitrate. */
299 AFHI_BITRATE_OFFSET = 4,
300 /** Position of the frequency. */
301 AFHI_FREQUENCY_OFFSET = 8,
302 /** Was: Location of the audio file header. */
303 AFHI_UNUSED1_OFFSET = 12,
304 /* Length of the audio file header. Zero means: No header. */
305 AFHI_HEADER_LEN_OFFSET = 16,
306 /** The total number of chunks (4 bytes). */
307 CHUNKS_TOTAL_OFFSET = 20,
308 /** The length of the audio file header (4 bytes). */
309 HEADER_LEN_OFFSET = 24,
310 /** Size of the largest chunk in bytes. (4 bytes). */
311 AFHI_MAX_CHUNK_SIZE_OFFSET = 28,
312 /** The seconds part of the chunk time (4 bytes). */
313 CHUNK_TV_TV_SEC_OFFSET = 32,
314 /** The microseconds part of the chunk time (4 bytes). */
315 CHUNK_TV_TV_USEC_OFFSET = 36,
316 /** Number of channels is stored here. (1 byte) */
317 AFHI_CHANNELS_OFFSET = 40,
318 /** The tag info position. */
319 AFHI_INFO_STRING_OFFSET = 41,
320 /** Minimal on-disk size of a valid afhi struct. */
321 MIN_AFHI_SIZE = 47, /* at least 6 null bytes for techinfo/tags */
324 static unsigned sizeof_afhi_buf(const struct afh_info *afhi)
329 + strlen(afhi->techinfo)
330 + strlen(afhi->tags.artist)
331 + strlen(afhi->tags.title)
332 + strlen(afhi->tags.year)
333 + strlen(afhi->tags.album)
334 + strlen(afhi->tags.comment);
337 static void save_afhi(struct afh_info *afhi, char *buf)
343 write_u32(buf + AFHI_SECONDS_TOTAL_OFFSET, afhi->seconds_total);
344 write_u32(buf + AFHI_BITRATE_OFFSET, afhi->bitrate);
345 write_u32(buf + AFHI_FREQUENCY_OFFSET, afhi->frequency);
346 write_u32(buf + AFHI_UNUSED1_OFFSET, 0);
347 write_u32(buf + AFHI_HEADER_LEN_OFFSET, afhi->header_len);
348 write_u8(buf + AFHI_CHANNELS_OFFSET, afhi->channels);
349 write_u32(buf + CHUNKS_TOTAL_OFFSET, afhi->chunks_total);
350 write_u32(buf + HEADER_LEN_OFFSET, afhi->header_len);
351 write_u32(buf + AFHI_MAX_CHUNK_SIZE_OFFSET, afhi->max_chunk_size);
352 write_u32(buf + CHUNK_TV_TV_SEC_OFFSET, afhi->chunk_tv.tv_sec);
353 write_u32(buf + CHUNK_TV_TV_USEC_OFFSET, afhi->chunk_tv.tv_usec);
354 p = buf + AFHI_INFO_STRING_OFFSET;
356 * The below sprintf(3) calls are OK because our caller already made
357 * sure that buf is large enough.
359 p += sprintf(p, "%s", afhi->techinfo) + 1;
360 p += sprintf(p, "%s", afhi->tags.artist) + 1;
361 p += sprintf(p, "%s", afhi->tags.title) + 1;
362 p += sprintf(p, "%s", afhi->tags.year) + 1;
363 p += sprintf(p, "%s", afhi->tags.album) + 1;
364 sprintf(p, "%s", afhi->tags.comment);
367 /* does not load the chunk table */
368 static void load_afhi(const char *buf, struct afh_info *afhi)
370 afhi->seconds_total = read_u32(buf + AFHI_SECONDS_TOTAL_OFFSET);
371 afhi->bitrate = read_u32(buf + AFHI_BITRATE_OFFSET);
372 afhi->frequency = read_u32(buf + AFHI_FREQUENCY_OFFSET);
373 afhi->header_len = read_u32(buf + AFHI_HEADER_LEN_OFFSET);
374 afhi->channels = read_u8(buf + AFHI_CHANNELS_OFFSET);
375 afhi->chunks_total = read_u32(buf + CHUNKS_TOTAL_OFFSET);
376 afhi->header_len = read_u32(buf + HEADER_LEN_OFFSET);
377 afhi->max_chunk_size = read_u32(buf + AFHI_MAX_CHUNK_SIZE_OFFSET);
378 afhi->chunk_tv.tv_sec = read_u32(buf + CHUNK_TV_TV_SEC_OFFSET);
379 afhi->chunk_tv.tv_usec = read_u32(buf + CHUNK_TV_TV_USEC_OFFSET);
380 afhi->techinfo = (char *)buf + AFHI_INFO_STRING_OFFSET;
381 afhi->tags.artist = afhi->techinfo + strlen(afhi->techinfo) + 1;
382 afhi->tags.title = afhi->tags.artist + strlen(afhi->tags.artist) + 1;
383 afhi->tags.year = afhi->tags.title + strlen(afhi->tags.title) + 1;
384 afhi->tags.album = afhi->tags.year + strlen(afhi->tags.year) + 1;
385 afhi->tags.comment = afhi->tags.album + strlen(afhi->tags.album) + 1;
388 /* Only used for saving the chunk table, but not for loading. */
389 static unsigned sizeof_chunk_table(struct afh_info *afhi)
391 if (!afhi || !afhi->chunk_table)
393 return 4 * (afhi->chunks_total + 1);
396 static void save_chunk_table(struct afh_info *afhi, char *buf)
400 if (!afhi->chunk_table || afhi->chunks_total == 0)
402 for (n = 0; n <= afhi->chunks_total; n++)
403 write_u32(buf + 4 * n, afhi->chunk_table[n]);
406 static void load_chunk_table(struct afh_info *afhi, const struct osl_object *ct)
411 if (!ct->data || ct->size < 4 * (afhi->chunks_total + 1)) {
412 afhi->chunk_table = NULL;
415 sz = PARA_MIN(((size_t)afhi->chunks_total + 1) * 4, ct->size) + 1;
416 afhi->chunk_table = alloc(sz);
417 for (i = 0; i <= afhi->chunks_total && i * 4 + 3 < ct->size; i++)
418 afhi->chunk_table[i] = read_u32(ct->data + 4 * i);
422 * Get the row of the audio file table corresponding to the given path.
424 * \param path The full path of the audio file.
425 * \param row Result pointer.
429 int aft_get_row_of_path(const char *path, struct osl_row **row)
431 struct osl_object obj = {.data = (char *)path, .size = strlen(path) + 1};
433 return osl(osl_get_row(audio_file_table, AFTCOL_PATH, &obj, row));
437 * Get the row of the audio file table corresponding to the given hash value.
439 * \param hash The hash value of the desired audio file.
440 * \param row Result pointer.
444 static int aft_get_row_of_hash(unsigned char *hash, struct osl_row **row)
446 const struct osl_object obj = {.data = hash, .size = HASH2_SIZE};
447 return osl(osl_get_row(audio_file_table, AFTCOL_HASH, &obj, row));
451 * Get the audio file selector info object of a row.
453 * \param row Pointer to a row in the audio file table.
454 * \param obj Result pointer.
458 static int get_afsi_object_of_row(const struct osl_row *row,
459 struct osl_object *obj)
461 return osl(osl_get_object(audio_file_table, row, AFTCOL_AFSI, obj));
465 * Get the osl object holding the audio file selector info, given a path.
468 * \param path The full path of the audio file.
469 * \param obj Result pointer.
471 * \return Positive on success, negative on errors.
473 static int get_afsi_object_of_path(const char *path, struct osl_object *obj)
476 int ret = aft_get_row_of_path(path, &row);
479 return get_afsi_object_of_row(row, obj);
483 * Get the audio file selector info, given a row of the audio file table.
485 * \param row Pointer to a row in the audio file table.
486 * \param afsi Result pointer.
488 * \return Positive on success, negative on errors.
490 int get_afsi_of_row(const struct osl_row *row, struct afs_info *afsi)
492 struct osl_object obj;
493 int ret = get_afsi_object_of_row(row, &obj);
496 return load_afsi(afsi, &obj);
500 * Get the audio file selector info, given the path of an audio table.
502 * \param path The full path of the audio file.
503 * \param afsi Result pointer.
507 static int get_afsi_of_path(const char *path, struct afs_info *afsi)
509 struct osl_object obj;
510 int ret = get_afsi_object_of_path(path, &obj);
513 return load_afsi(afsi, &obj);
517 * Get the path of an audio file, given a row of the audio file table.
519 * \param row Pointer to a row in the audio file table.
520 * \param path Result pointer.
522 * The result is a pointer to memory-mapped data. The caller must not attempt
527 int get_audio_file_path_of_row(const struct osl_row *row, char **path)
529 struct osl_object path_obj;
530 int ret = osl(osl_get_object(audio_file_table, row, AFTCOL_PATH,
536 *path = path_obj.data;
541 * Get the object containing the hash value of an audio file, given a row.
543 * \param row Pointer to a row of the audio file table.
544 * \param obj Result pointer.
546 * \return The return value of the underlying call to osl_get_object().
548 * \sa \ref get_hash_of_row().
550 static int get_hash_object_of_aft_row(const struct osl_row *row,
551 struct osl_object *obj)
553 return osl(osl_get_object(audio_file_table, row, AFTCOL_HASH, obj));
557 * Get the hash value of an audio file, given a row of the audio file table.
559 * \param row Pointer to a row of the audio file table.
560 * \param hash Result pointer.
562 * \a hash points to mapped data and must not be freed by the caller.
564 * \return The return value of the underlying call to
565 * get_hash_object_of_aft_row().
567 static int get_hash_of_row(const struct osl_row *row, unsigned char **hash)
569 struct osl_object obj;
570 int ret = get_hash_object_of_aft_row(row, &obj);
579 * Get the audio format handler info, given a row of the audio file table.
581 * \param row Pointer to a row of the audio file table.
582 * \param afhi Result pointer.
584 * \return The return value of the underlying call to osl_get_object().
586 * After the call the members of the afhi structure point to mapped memory
587 * which is owned by the osl table, Hence the caller must not attempt to free
588 * this memory by calling \ref clear_afhi().
590 int get_afhi_of_row(const struct osl_row *row, struct afh_info *afhi)
592 struct osl_object obj;
596 ret = osl(osl_get_object(audio_file_table, row, AFTCOL_AFHI, &obj));
599 load_afhi(obj.data, afhi);
603 /* returns shmid on success */
604 static int save_afd(struct audio_file_data *afd)
606 size_t size = sizeof(*afd) + sizeof_chunk_table(&afd->afhi);
607 int shmid, ret = shm_new(size);
614 ret = shm_attach(shmid, ATTACH_RW, &shm_afd);
619 save_chunk_table(&afd->afhi, buf);
620 if (afd->afhi.max_chunk_size == 0) { /* v0.5.x on-disk afhi */
621 set_max_chunk_size(&afd->afhi);
622 PARA_NOTICE_LOG("max chunk size unset, re-add required\n");
624 PARA_INFO_LOG("using max chunk size from afhi\n");
625 afd->max_chunk_size = afd->afhi.max_chunk_size;
626 *(struct audio_file_data *)shm_afd = *afd;
635 * Extract a afd stored in a shared memory area.
637 * Attach the shared memory area given by \a shmid, load the audio file data
638 * stored therein and detach the area afterwards. Called by vss, after
639 * receiving a positive response to the request for the next audio file.
641 * \param shmid The identifier of the shared memory area containing the afd.
642 * \param afd Result pointer.
646 int load_afd(int shmid, struct audio_file_data *afd)
650 struct osl_object obj;
652 ret = shm_attach(shmid, ATTACH_RO, &shm_afd);
655 ret = shm_size(shmid, &obj.size);
658 *afd = *(struct audio_file_data *)shm_afd;
659 obj.data = shm_afd + sizeof(*afd);
660 obj.size -= sizeof(*afd);
661 load_chunk_table(&afd->afhi, &obj);
668 static int get_local_time(uint64_t *seconds, char *buf, size_t size,
669 time_t current_time, enum ls_listing_mode lm)
673 * Omit year but show time if the given value is closer to the current
674 * time than this many seconds.
676 const time_t m = 6 * 30 * 24 * 3600; /* six months */
678 tm = localtime((time_t *)seconds);
681 if (lm == LS_MODE_MBOX) {
682 if (!strftime(buf, size, "%c", tm))
686 if (*seconds > current_time - m && *seconds < current_time + m) {
687 if (!strftime(buf, size, "%b %e %k:%M", tm))
692 * If the given time is more than six month away from the current time,
693 * we print only the year. The additional space character in the format
694 * string below makes the formatted date align nicely with dates that
695 * contain the time (those written by the above strftime() statement).
697 if (!strftime(buf, size, "%b %e %Y", tm))
702 /** Compute the number of (decimal) digits of a number. */
703 #define GET_NUM_DIGITS(x, num) { \
704 typeof((x)) _tmp = PARA_ABS(x); \
707 while ((_tmp) > 9) { \
713 __a_const static short unsigned get_duration_width(int seconds)
715 short unsigned width;
716 unsigned hours = seconds / 3600, mins = (seconds % 3600) / 60;
718 if (!hours) /* less than one hour => m:ss or mm:ss => 4 or 5 digits */
719 return 4 + (mins > 9);
720 /* more than one hour => h:mm:ss, hh:mm:ss, hhh:mm:ss, ... */
721 GET_NUM_DIGITS(hours, &width);
725 static void get_duration_buf(int seconds, char *buf, size_t bufsize,
726 struct ls_options *opts)
728 unsigned hours = seconds / 3600, mins = (seconds % 3600) / 60;
729 short unsigned max_width;
731 if (!hours) { /* m:ss or mm:ss */
732 max_width = opts->mode == LS_MODE_LONG?
733 opts->widths.duration_width : 4;
734 assert(max_width < bufsize - 1);
735 sprintf(buf, "%*u:%02d", 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 assert(max_width < bufsize - 1);
740 sprintf(buf, "%*u:%02u:%02d", max_width - 6, hours, mins,
745 static int write_attribute_items(struct para_buffer *b,
746 const char *att_bitmap, struct afs_info *afsi)
751 WRITE_STATUS_ITEM(b, SI_attributes_bitmap, "%s\n", att_bitmap);
752 ret = get_attribute_text(&afsi->attributes, " ", &att_text);
755 WRITE_STATUS_ITEM(b, SI_attributes_txt, "%s\n", att_text);
760 static void write_lyrics_items(struct para_buffer *b, struct afs_info *afsi)
764 WRITE_STATUS_ITEM(b, SI_lyrics_id, "%u\n", afsi->lyrics_id);
765 lyr_get_name_by_id(afsi->lyrics_id, &lyrics_name);
766 WRITE_STATUS_ITEM(b, SI_lyrics_name, "%s\n", lyrics_name?
767 lyrics_name : "(none)");
770 static void write_image_items(struct para_buffer *b, struct afs_info *afsi)
774 WRITE_STATUS_ITEM(b, SI_image_id, "%u\n", afsi->image_id);
775 img_get_name_by_id(afsi->image_id, &image_name);
776 WRITE_STATUS_ITEM(b, SI_image_name, "%s\n", image_name?
777 image_name : "(none)");
780 static void write_filename_items(struct para_buffer *b, const char *path,
786 WRITE_STATUS_ITEM(b, SI_basename, "%s\n", path);
789 WRITE_STATUS_ITEM(b, SI_path, "%s\n", path);
790 slash = strrchr(path, '/');
791 WRITE_STATUS_ITEM(b, SI_basename, "%s\n", slash? slash + 1 : path);
792 WRITE_STATUS_ITEM(b, SI_directory, "%.*s\n",
793 slash? (int)(slash - path) : (int)strlen(path), path);
796 static int print_chunk_table(struct ls_data *d, struct para_buffer *b)
798 struct osl_object chunk_table_obj;
799 struct osl_row *aft_row;
803 para_printf(b, "%s\nchunk_time: %lu:%lu\n", d->path,
804 (long unsigned) d->afhi.chunk_tv.tv_sec,
805 (long unsigned) d->afhi.chunk_tv.tv_usec
807 if (afh_supports_dynamic_chunks(d->afsi.audio_format_id))
809 ret = aft_get_row_of_hash(d->hash, &aft_row);
812 ret = osl(osl_open_disk_object(audio_file_table, aft_row,
813 AFTCOL_CHUNKS, &chunk_table_obj));
816 para_printf(b, "chunk_offsets: ");
817 buf = chunk_table_obj.data;
820 i <= d->afhi.chunks_total && 4 * i + 3 < chunk_table_obj.size;
823 para_printf(b, "%u ", (unsigned) read_u32(buf + 4 * i));
824 para_printf(b, "\n");
826 osl_close_disk_object(&chunk_table_obj);
830 static int print_list_item(struct ls_data *d, struct ls_options *opts,
831 struct para_buffer *b, time_t current_time)
833 const struct lls_opt_result *r_a = SERVER_CMD_OPT_RESULT(LS, ADMISSIBLE, opts->lpr);
834 const struct lls_opt_result *r_b = SERVER_CMD_OPT_RESULT(LS, BASENAME, opts->lpr);
835 const struct lls_opt_result *r_d = SERVER_CMD_OPT_RESULT(LS, UNIX_DATE, opts->lpr);
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 * HASH2_SIZE + 1];
844 if (opts->mode == LS_MODE_SHORT) {
845 para_printf(b, "%s\n", d->path);
849 if (opts->mode == LS_MODE_CHUNKS) {
850 ret = print_chunk_table(d, b);
853 get_attribute_bitmap(&afsi->attributes, att_buf);
854 if (lls_opt_given(r_d))
855 sprintf(last_played_time, "%llu",
856 (long long unsigned)afsi->last_played);
858 ret = get_local_time(&afsi->last_played, last_played_time,
859 sizeof(last_played_time), current_time, opts->mode);
863 get_duration_buf(afhi->seconds_total, duration_buf,
864 sizeof(duration_buf), opts);
865 if (opts->mode == LS_MODE_LONG) {
866 struct ls_widths *w = &opts->widths;
867 if (lls_opt_given(r_a))
868 para_printf(b, "%*li ", opts->widths.score_width,
871 "%s " /* attributes */
873 "%*u " /* image_id */
874 "%*u " /* lyrics_id */
876 "%*s " /* audio format */
877 "%*u " /* frequency */
880 "%*u " /* num_played */
881 "%s " /* last_played */
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,
893 w->num_played_width, afsi->num_played,
900 if (opts->mode == LS_MODE_MBOX) {
901 const char *slash = strrchr(d->path, '/');
903 "From foo@localhost %s\n"
904 "Received: from\nTo: bar\nFrom: a\n"
907 slash? slash + 1 : "?");
909 write_filename_items(b, d->path, lls_opt_given(r_b));
910 if (lls_opt_given(r_a))
911 WRITE_STATUS_ITEM(b, SI_score, "%li\n", d->score);
912 ret = write_attribute_items(b, att_buf, afsi);
915 write_image_items(b, afsi);
916 write_lyrics_items(b, afsi);
917 hash2_to_asc(d->hash, asc_hash);
918 WRITE_STATUS_ITEM(b, SI_hash, "%s\n", asc_hash);
919 WRITE_STATUS_ITEM(b, SI_bitrate, "%dkbit/s\n", afhi->bitrate);
920 WRITE_STATUS_ITEM(b, SI_format, "%s\n",
921 audio_format_name(afsi->audio_format_id));
922 WRITE_STATUS_ITEM(b, SI_frequency, "%dHz\n", afhi->frequency);
923 WRITE_STATUS_ITEM(b, SI_channels, "%d\n", afhi->channels);
924 WRITE_STATUS_ITEM(b, SI_duration, "%s\n", duration_buf);
925 WRITE_STATUS_ITEM(b, SI_seconds_total, "%" PRIu32 "\n",
926 afhi->seconds_total);
927 WRITE_STATUS_ITEM(b, SI_last_played, "%s\n", last_played_time);
928 WRITE_STATUS_ITEM(b, SI_num_played, "%u\n", afsi->num_played);
929 WRITE_STATUS_ITEM(b, SI_amplification, "%u\n", afsi->amp);
930 WRITE_STATUS_ITEM(b, SI_chunk_time, "%lu\n", tv2ms(&afhi->chunk_tv));
931 WRITE_STATUS_ITEM(b, SI_num_chunks, "%" PRIu32 "\n",
933 WRITE_STATUS_ITEM(b, SI_max_chunk_size, "%" PRIu32 "\n",
934 afhi->max_chunk_size);
935 WRITE_STATUS_ITEM(b, SI_techinfo, "%s\n", afhi->techinfo);
936 WRITE_STATUS_ITEM(b, SI_artist, "%s\n", afhi->tags.artist);
937 WRITE_STATUS_ITEM(b, SI_title, "%s\n", afhi->tags.title);
938 WRITE_STATUS_ITEM(b, SI_year, "%s\n", afhi->tags.year);
939 WRITE_STATUS_ITEM(b, SI_album, "%s\n", afhi->tags.album);
940 WRITE_STATUS_ITEM(b, SI_comment, "%s\n", afhi->tags.comment);
941 if (opts->mode == LS_MODE_MBOX) {
942 struct osl_object lyrics_def;
943 lyr_get_def_by_id(afsi->lyrics_id, &lyrics_def);
944 if (lyrics_def.data) {
945 para_printf(b, "Lyrics:\n~~~~~~~\n%s",
946 (char *)lyrics_def.data);
947 osl_close_disk_object(&lyrics_def);
954 static void make_inode_status_items(struct para_buffer *pb)
956 struct stat statbuf = {.st_size = 0};
957 char *path, mtime_str[30] = "\0";
961 ret = get_audio_file_path_of_row(current_aft_row, &path);
964 ret = stat(path, &statbuf);
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 */
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);
976 * Deallocate and invalidate the status item strings.
978 * This needs to be a public function so that afs.c can call it on shutdown.
980 void free_status_items(void)
982 freep(&status_items);
983 freep(&parser_friendly_status_items);
986 static void make_status_items(void)
988 const struct lls_command *cmd = SERVER_CMD_CMD_PTR(LS);
989 char *argv[] = {"ls", "--admissible", "--listing-mode=verbose"};
990 struct ls_options opts = {.mode = LS_MODE_VERBOSE};
991 struct para_buffer pb = {.max_size = shm_get_shmmax() - 1};
996 if (!status_item_ls_data.path) /* no audio file open */
998 ret = lls_parse(ARRAY_SIZE(argv), argv, cmd, &opts.lpr, NULL);
1000 time(¤t_time);
1001 ret = print_list_item(&status_item_ls_data, &opts, &pb, current_time);
1004 make_inode_status_items(&pb);
1005 status_items = pb.buf;
1007 memset(&pb, 0, sizeof(pb));
1008 pb.max_size = shm_get_shmmax() - 1;
1009 pb.flags = PBF_SIZE_PREFIX;
1010 ret = print_list_item(&status_item_ls_data, &opts, &pb, current_time);
1013 make_inode_status_items(&pb);
1014 parser_friendly_status_items = pb.buf;
1018 PARA_WARNING_LOG("could not create status items: %s\n",
1019 para_strerror(-ret));
1020 free_status_items();
1022 lls_free_parse_result(opts.lpr, cmd);
1026 * Open the audio file with highest score and set up an afd structure.
1028 * This determines and opens the next audio file, verifies that it did not
1029 * change by comparing the recomputed the hash value of the file contents
1030 * against the value stored in the audio file table. If all goes well, it
1031 * creates a shared memory area containing the serialized version of the afd
1032 * structure, including the chunk table, if any. The caller can then send the
1033 * ID of this area and the open fd to the server process.
1035 * \param fd Result pointer for the file descriptor of the audio file.
1037 * On success, the numplayed field of the audio file selector info is increased
1038 * and the lastplayed time is set to the current time. Finally, the score of
1039 * the audio file is updated.
1041 * \return Positive shmid on success, negative on errors.
1043 int open_and_update_audio_file(int *fd)
1045 unsigned char file_hash[HASH2_SIZE];
1046 struct osl_object afsi_obj;
1047 struct afs_info new_afsi;
1049 struct afsi_change_event_data aced;
1050 struct osl_object map, chunk_table_obj;
1051 struct ls_data *d = &status_item_ls_data;
1052 unsigned char *tmp_hash;
1053 struct audio_file_data afd;
1055 ret = score_get_best(¤t_aft_row, &d->score);
1059 * get_hash_of_row() and get_audio_file_path_of_row() initialize
1060 * their pointer argument to point to memory-mapped files. These pointers
1061 * become stale after a new audio file has been added or after the
1062 * server process received SIGHUP. For in both cases libosl unmaps and
1063 * remaps the underlying database files, and this remapping may well
1064 * change the starting address of the mapping. To avoid stale pointer
1065 * references we create copies on the heap.
1067 ret = get_hash_of_row(current_aft_row, &tmp_hash);
1071 d->hash = alloc(HASH2_SIZE);
1072 memcpy(d->hash, tmp_hash, HASH2_SIZE);
1074 ret = get_audio_file_path_of_row(current_aft_row, &d->path);
1077 PARA_NOTICE_LOG("%s\n", d->path);
1078 d->path = para_strdup(d->path);
1080 ret = get_afsi_object_of_row(current_aft_row, &afsi_obj);
1083 ret = load_afsi(&d->afsi, &afsi_obj);
1086 ret = get_afhi_of_row(current_aft_row, &afd.afhi);
1090 d->afhi.chunk_table = afd.afhi.chunk_table = NULL;
1091 ret = osl(osl_open_disk_object(audio_file_table, current_aft_row,
1092 AFTCOL_CHUNKS, &chunk_table_obj));
1094 if (!afh_supports_dynamic_chunks(d->afsi.audio_format_id))
1096 PARA_INFO_LOG("no chunk table for %s\n", d->path);
1097 chunk_table_obj.data = NULL;
1098 chunk_table_obj.size = 0;
1100 PARA_INFO_LOG("chunk table: %zu bytes\n", chunk_table_obj.size);
1102 ret = mmap_full_file(d->path, O_RDONLY, &map.data, &map.size, fd);
1105 hash2_function(map.data, map.size, file_hash);
1106 ret = hash2_compare(file_hash, d->hash);
1107 para_munmap(map.data, map.size);
1109 ret = -E_HASH_MISMATCH;
1113 new_afsi.num_played++;
1114 new_afsi.last_played = time(NULL);
1115 save_afsi(&new_afsi, &afsi_obj); /* in-place update */
1117 afd.audio_format_id = d->afsi.audio_format_id;
1118 load_chunk_table(&afd.afhi, &chunk_table_obj);
1119 aced.aft_row = current_aft_row;
1120 aced.old_afsi = &d->afsi;
1122 * No need to update the status items as the AFSI_CHANGE event will
1125 ret = afs_event(AFSI_CHANGE, NULL, &aced);
1128 ret = save_afd(&afd);
1130 free(afd.afhi.chunk_table);
1131 if (chunk_table_obj.data)
1132 osl_close_disk_object(&chunk_table_obj);
1134 PARA_ERROR_LOG("%s: %s\n", d->path, para_strerror(-ret));
1135 ret = score_delete(current_aft_row);
1142 static int ls_hash_compare(const void *a, const void *b)
1144 struct ls_data *d1 = *(struct ls_data **)a, *d2 = *(struct ls_data **)b;
1145 return memcmp(d1->hash, d2->hash, HASH2_SIZE);
1148 static int ls_audio_format_compare(const void *a, const void *b)
1150 struct ls_data *d1 = *(struct ls_data **)a, *d2 = *(struct ls_data **)b;
1151 return NUM_COMPARE(d1->afsi.audio_format_id, d2->afsi.audio_format_id);
1154 static int ls_duration_compare(const void *a, const void *b)
1156 struct ls_data *d1 = *(struct ls_data **)a, *d2 = *(struct ls_data **)b;
1157 return NUM_COMPARE(d1->afhi.seconds_total, d2->afhi.seconds_total);
1160 static int ls_bitrate_compare(const void *a, const void *b)
1162 struct ls_data *d1 = *(struct ls_data **)a, *d2 = *(struct ls_data **)b;
1163 return NUM_COMPARE(d1->afhi.bitrate, d2->afhi.bitrate);
1166 static int ls_lyrics_id_compare(const void *a, const void *b)
1168 struct ls_data *d1 = *(struct ls_data **)a, *d2 = *(struct ls_data **)b;
1169 return NUM_COMPARE(d1->afsi.lyrics_id, d2->afsi.lyrics_id);
1172 static int ls_image_id_compare(const void *a, const void *b)
1174 struct ls_data *d1 = *(struct ls_data **)a, *d2 = *(struct ls_data **)b;
1175 return NUM_COMPARE(d1->afsi.image_id, d2->afsi.image_id);
1178 static int ls_channels_compare(const void *a, const void *b)
1180 struct ls_data *d1 = *(struct ls_data **)a, *d2 = *(struct ls_data **)b;
1181 return NUM_COMPARE(d1->afhi.channels, d2->afhi.channels);
1184 static int ls_frequency_compare(const void *a, const void *b)
1186 struct ls_data *d1 = *(struct ls_data **)a, *d2 = *(struct ls_data **)b;
1187 return NUM_COMPARE(d1->afhi.frequency, d2->afhi.frequency);
1190 static int ls_num_played_compare(const void *a, const void *b)
1192 struct ls_data *d1 = *(struct ls_data **)a, *d2 = *(struct ls_data **)b;
1193 return NUM_COMPARE(d1->afsi.num_played, d2->afsi.num_played);
1196 static int ls_last_played_compare(const void *a, const void *b)
1198 struct ls_data *d1 = *(struct ls_data **)a, *d2 = *(struct ls_data **)b;
1199 return NUM_COMPARE(d1->afsi.last_played, d2->afsi.last_played);
1202 static int ls_score_compare(const void *a, const void *b)
1204 struct ls_data *d1 = *(struct ls_data **)a, *d2 = *(struct ls_data **)b;
1205 return NUM_COMPARE(d1->score, d2->score);
1208 static int ls_path_compare(const void *a, const void *b)
1210 struct ls_data *d1 = *(struct ls_data **)a, *d2 = *(struct ls_data **)b;
1211 return strcmp(d1->path, d2->path);
1214 static inline bool admissible_only(struct ls_options *opts)
1216 return SERVER_CMD_OPT_GIVEN(LS, ADMISSIBLE, opts->lpr)
1217 || opts->sorting == LS_SORT_BY_SCORE;
1220 static int sort_matching_paths(struct ls_options *options)
1222 const struct lls_opt_result *r_b = SERVER_CMD_OPT_RESULT(LS, BASENAME,
1224 size_t nmemb = options->num_matching_paths;
1225 size_t size = sizeof(*options->data_ptr);
1226 int (*compar)(const void *, const void *);
1229 options->data_ptr = arr_alloc(nmemb, sizeof(*options->data_ptr));
1230 for (i = 0; i < nmemb; i++)
1231 options->data_ptr[i] = options->data + i;
1233 /* In these cases the array is already sorted */
1234 if (admissible_only(options)) {
1235 if (options->sorting == LS_SORT_BY_SCORE)
1238 if (options->sorting == LS_SORT_BY_PATH && !lls_opt_given(r_b))
1242 switch (options->sorting) {
1243 case LS_SORT_BY_PATH:
1244 compar = ls_path_compare; break;
1245 case LS_SORT_BY_SCORE:
1246 compar = ls_score_compare; break;
1247 case LS_SORT_BY_LAST_PLAYED:
1248 compar = ls_last_played_compare; break;
1249 case LS_SORT_BY_NUM_PLAYED:
1250 compar = ls_num_played_compare; break;
1251 case LS_SORT_BY_FREQUENCY:
1252 compar = ls_frequency_compare; break;
1253 case LS_SORT_BY_CHANNELS:
1254 compar = ls_channels_compare; break;
1255 case LS_SORT_BY_IMAGE_ID:
1256 compar = ls_image_id_compare; break;
1257 case LS_SORT_BY_LYRICS_ID:
1258 compar = ls_lyrics_id_compare; break;
1259 case LS_SORT_BY_BITRATE:
1260 compar = ls_bitrate_compare; break;
1261 case LS_SORT_BY_DURATION:
1262 compar = ls_duration_compare; break;
1263 case LS_SORT_BY_AUDIO_FORMAT:
1264 compar = ls_audio_format_compare; break;
1265 case LS_SORT_BY_HASH:
1266 compar = ls_hash_compare; break;
1270 qsort(options->data_ptr, nmemb, size, compar);
1274 /* row is either an aft_row or a row of the score table */
1275 /* TODO: Only compute widths if we need them */
1276 static int prepare_ls_row(struct osl_row *row, void *ls_opts)
1279 struct ls_options *options = ls_opts;
1280 bool basename_given = SERVER_CMD_OPT_GIVEN(LS, BASENAME, options->lpr);
1282 struct ls_widths *w;
1283 unsigned short num_digits;
1284 unsigned tmp, num_inputs;
1285 struct osl_row *aft_row;
1289 if (admissible_only(options)) {
1290 ret = get_score_and_aft_row(row, &score, &aft_row);
1297 ret = get_audio_file_path_of_row(aft_row, &path);
1300 if (basename_given) {
1301 char *p = strrchr(path, '/');
1305 num_inputs = lls_num_inputs(options->lpr);
1306 if (num_inputs > 0) {
1307 for (i = 0; i < num_inputs; i++) {
1308 ret = fnmatch(lls_input(i, options->lpr), path, 0);
1311 if (ret == FNM_NOMATCH)
1315 if (i >= num_inputs) /* no match */
1318 tmp = options->num_matching_paths++;
1319 if (options->num_matching_paths > options->array_size) {
1320 options->array_size++;
1321 options->array_size *= 2;
1322 options->data = arr_realloc(options->data, options->array_size,
1323 sizeof(*options->data));
1325 d = options->data + tmp;
1326 ret = get_afsi_of_row(aft_row, &d->afsi);
1329 ret = get_afhi_of_row(aft_row, &d->afhi);
1333 ret = get_hash_of_row(aft_row, &d->hash);
1336 w = &options->widths;
1337 GET_NUM_DIGITS(d->afsi.image_id, &num_digits);
1338 w->image_id_width = PARA_MAX(w->image_id_width, num_digits);
1339 GET_NUM_DIGITS(d->afsi.lyrics_id, &num_digits);
1340 w->lyrics_id_width = PARA_MAX(w->lyrics_id_width, num_digits);
1341 GET_NUM_DIGITS(d->afhi.bitrate, &num_digits);
1342 w->bitrate_width = PARA_MAX(w->bitrate_width, num_digits);
1343 GET_NUM_DIGITS(d->afhi.frequency, &num_digits);
1344 w->frequency_width = PARA_MAX(w->frequency_width, num_digits);
1345 GET_NUM_DIGITS(d->afsi.num_played, &num_digits);
1346 w->num_played_width = PARA_MAX(w->num_played_width, num_digits);
1347 /* get the number of chars to print this amount of time */
1348 num_digits = get_duration_width(d->afhi.seconds_total);
1349 w->duration_width = PARA_MAX(w->duration_width, num_digits);
1350 GET_NUM_DIGITS(d->afsi.amp, &num_digits);
1351 w->amp_width = PARA_MAX(w->amp_width, num_digits);
1352 num_digits = strlen(audio_format_name(d->afsi.audio_format_id));
1353 w->audio_format_width = PARA_MAX(w->audio_format_width, num_digits);
1354 if (admissible_only(options)) {
1355 GET_NUM_DIGITS(score, &num_digits);
1356 num_digits++; /* add one for the sign (space or "-") */
1357 w->score_width = PARA_MAX(w->score_width, num_digits);
1365 static int mop_loop(const char *arg, struct afs_callback_arg *aca,
1366 struct ls_options *opts)
1371 if (!arg || strcmp(arg, ".") == 0)
1372 return score_loop(prepare_ls_row, NULL, opts);
1373 if (!strncmp(arg, "m/", 2)) {
1374 struct mood_instance *m;
1375 ret = mood_load(arg + 2, &m, &msg);
1377 afs_error(aca, "%s", msg);
1381 ret = mood_loop(m, prepare_ls_row, opts);
1385 if (!strncmp(arg, "p/", 2)) {
1386 struct playlist_instance *pi;
1387 ret = playlist_load(arg + 2, &pi, &msg);
1389 afs_error(aca, "%s", msg);
1393 ret = playlist_loop(pi, prepare_ls_row, opts);
1394 playlist_unload(pi);
1397 afs_error(aca, "bad mood/playlist specifier: %s\n", arg);
1398 return -ERRNO_TO_PARA_ERROR(EINVAL);
1401 static int com_ls_callback(struct afs_callback_arg *aca)
1403 const struct lls_command *cmd = SERVER_CMD_CMD_PTR(LS);
1404 struct ls_options *opts = aca->query.data;
1406 time_t current_time;
1407 const struct lls_opt_result *r_r, *r_a;
1408 uint32_t limit, k, n;
1410 ret = lls_deserialize_parse_result(
1411 (char *)aca->query.data + sizeof(*opts), cmd, &opts->lpr);
1413 r_r = SERVER_CMD_OPT_RESULT(LS, REVERSE, opts->lpr);
1414 r_a = SERVER_CMD_OPT_RESULT(LS, ADMISSIBLE, opts->lpr);
1415 aca->pbout.flags = (opts->mode == LS_MODE_PARSER)? PBF_SIZE_PREFIX : 0;
1416 if (admissible_only(opts)) {
1417 const char *arg = lls_string_val(0, r_a);
1418 ret = mop_loop(arg, aca, opts);
1420 ret = osl(osl_rbtree_loop(audio_file_table, AFTCOL_PATH, opts,
1424 n = opts->num_matching_paths;
1426 ret = lls_num_inputs(opts->lpr) > 0? -E_NO_MATCH : 0;
1429 ret = sort_matching_paths(opts);
1432 time(¤t_time);
1433 limit = SERVER_CMD_UINT32_VAL(LS, LIMIT, opts->lpr);
1434 for (k = 0; k < n && (limit == 0 || k < limit); k++) {
1435 uint32_t idx = lls_opt_given(r_r)? n - 1 - k : k;
1436 ret = print_list_item(opts->data_ptr[idx], opts, &aca->pbout,
1442 lls_free_parse_result(opts->lpr, cmd);
1444 free(opts->data_ptr);
1448 static int com_ls(struct command_context *cc, struct lls_parse_result *lpr)
1450 const struct lls_command *cmd = SERVER_CMD_CMD_PTR(LS);
1451 struct ls_options *opts;
1452 struct osl_object query;
1453 const struct lls_opt_result *r_l = SERVER_CMD_OPT_RESULT(LS, LISTING_MODE,
1455 const struct lls_opt_result *r_s = SERVER_CMD_OPT_RESULT(LS, SORT, lpr);
1459 ret = lls_serialize_parse_result(lpr, cmd, NULL, &query.size);
1461 query.size += sizeof(*opts);
1462 query.data = alloc(query.size);
1464 memset(opts, 0, sizeof(*opts));
1465 slpr = query.data + sizeof(*opts);
1466 ret = lls_serialize_parse_result(lpr, cmd, &slpr, NULL);
1468 opts->mode = LS_MODE_SHORT;
1469 opts->sorting = LS_SORT_BY_PATH;
1470 if (lls_opt_given(r_l)) {
1471 const char *val = lls_string_val(0, r_l);
1472 if (!strcmp(val, "l") || !strcmp(val, "long"))
1473 opts->mode = LS_MODE_LONG;
1474 else if (!strcmp(val, "s") || !strcmp(val, "short"))
1475 opts->mode = LS_MODE_SHORT;
1476 else if (!strcmp(val, "v") || !strcmp(val, "verbose"))
1477 opts->mode = LS_MODE_VERBOSE;
1478 else if (!strcmp(val, "m") || !strcmp(val, "mbox")) {
1479 send_sb_va(&cc->scc, SBD_WARNING_LOG,
1480 "Warning: mbox listing mode is deprecated\n");
1481 opts->mode = LS_MODE_MBOX;
1482 } else if (!strcmp(val, "c") || !strcmp(val, "chunk-table")) {
1483 send_sb_va(&cc->scc, SBD_WARNING_LOG,
1484 "Warning: chunk table listing mode is deprecated\n");
1485 opts->mode = LS_MODE_CHUNKS;
1486 } else if (!strcmp(val, "p") || !strcmp(val, "parser-friendly"))
1487 opts->mode = LS_MODE_PARSER;
1489 ret = -ERRNO_TO_PARA_ERROR(EINVAL);
1493 if (lls_opt_given(r_s)) {
1494 const char *val = lls_string_val(0, r_s);
1495 if (!strcmp(val, "p") || !strcmp(val, "path"))
1496 opts->sorting = LS_SORT_BY_PATH;
1497 else if (!strcmp(val, "s") || !strcmp(val, "score"))
1498 opts->sorting = LS_SORT_BY_SCORE;
1499 else if (!strcmp(val, "l") || !strcmp(val, "lastplayed"))
1500 opts->sorting = LS_SORT_BY_LAST_PLAYED;
1501 else if (!strcmp(val, "n") || !strcmp(val, "numplayed"))
1502 opts->sorting = LS_SORT_BY_NUM_PLAYED;
1503 else if (!strcmp(val, "f") || !strcmp(val, "frquency"))
1504 opts->sorting = LS_SORT_BY_FREQUENCY;
1505 else if (!strcmp(val, "c") || !strcmp(val, "channels"))
1506 opts->sorting = LS_SORT_BY_CHANNELS;
1507 else if (!strcmp(val, "i") || !strcmp(val, "image-id"))
1508 opts->sorting = LS_SORT_BY_IMAGE_ID;
1509 else if (!strcmp(val, "y") || !strcmp(val, "lyrics-id"))
1510 opts->sorting = LS_SORT_BY_LYRICS_ID;
1511 else if (!strcmp(val, "b") || !strcmp(val, "bitrate"))
1512 opts->sorting = LS_SORT_BY_BITRATE;
1513 else if (!strcmp(val, "d") || !strcmp(val, "duration"))
1514 opts->sorting = LS_SORT_BY_DURATION;
1515 else if (!strcmp(val, "a") || !strcmp(val, "audio-format"))
1516 opts->sorting = LS_SORT_BY_AUDIO_FORMAT;
1517 else if (!strcmp(val, "h") || !strcmp(val, "hash"))
1518 opts->sorting = LS_SORT_BY_HASH;
1520 ret = -ERRNO_TO_PARA_ERROR(EINVAL);
1524 ret = send_callback_request(com_ls_callback, &query,
1525 afs_cb_result_handler, cc);
1530 EXPORT_SERVER_CMD_HANDLER(ls);
1533 * Call the given function for each file in the audio file table.
1535 * \param private_data An arbitrary data pointer, passed to \a func.
1536 * \param func The custom function to be called.
1540 int audio_file_loop(void *private_data, osl_rbtree_loop_func *func)
1542 return osl(osl_rbtree_loop(audio_file_table, AFTCOL_HASH, private_data,
1546 static int find_hash_sister(unsigned char *hash, struct osl_row **result)
1548 int ret = aft_get_row_of_hash(hash, result);
1550 if (ret == -OSL_ERRNO_TO_PARA_ERROR(E_OSL_RB_KEY_NOT_FOUND))
1555 static int find_path_brother(const char *path, struct osl_row **result)
1557 int ret = aft_get_row_of_path(path, result);
1559 if (ret == -OSL_ERRNO_TO_PARA_ERROR(E_OSL_RB_KEY_NOT_FOUND))
1564 /** The format of the data stored by save_audio_file_data(). */
1565 enum com_add_buffer_offsets {
1566 /* afhi (if present) starts at this offset. */
1567 CAB_AFHI_OFFSET_POS = 0,
1568 /** Start of the chunk table (if present). */
1569 CAB_CHUNKS_OFFSET_POS = 4,
1570 /** Start of the (serialized) lopsub parse result. */
1572 /** Audio format id. */
1573 CAB_AUDIO_FORMAT_ID_OFFSET = 12,
1574 /** The hash of the audio file being added. */
1575 CAB_HASH_OFFSET = 13,
1576 /** Start of the path of the audio file. */
1577 CAB_PATH_OFFSET = (CAB_HASH_OFFSET + HASH2_SIZE),
1581 * Store the given data to a single buffer. Doesn't need the audio file selector
1582 * info struct as the server knows it as well.
1584 * It's OK to call this with afhi == NULL. In this case, the audio format
1585 * handler info won't be stored in the buffer.
1587 static void save_add_callback_buffer(unsigned char *hash, const char *path,
1588 struct afh_info *afhi, const char *slpr, size_t slpr_size,
1589 uint8_t audio_format_num, struct osl_object *obj)
1591 size_t path_len = strlen(path) + 1;
1592 size_t afhi_size = sizeof_afhi_buf(afhi);
1593 size_t size = CAB_PATH_OFFSET + path_len + afhi_size
1594 + sizeof_chunk_table(afhi) + slpr_size;
1595 char *buf = alloc(size);
1598 assert(size <= ~(uint32_t)0);
1599 write_u8(buf + CAB_AUDIO_FORMAT_ID_OFFSET, audio_format_num);
1600 memcpy(buf + CAB_HASH_OFFSET, hash, HASH2_SIZE);
1601 strcpy(buf + CAB_PATH_OFFSET, path);
1602 pos = CAB_PATH_OFFSET + path_len;
1603 write_u32(buf + CAB_AFHI_OFFSET_POS, pos);
1604 save_afhi(afhi, buf + pos);
1606 write_u32(buf + CAB_CHUNKS_OFFSET_POS, pos);
1608 save_chunk_table(afhi, buf + pos);
1609 pos += sizeof_chunk_table(afhi);
1611 write_u32(buf + CAB_LPR_OFFSET, pos);
1612 memcpy(buf + pos, slpr, slpr_size);
1613 assert(pos + slpr_size == size);
1620 Overview of the add command.
1622 Input: What was passed to the callback by the command handler.
1624 HS: Hash sister. Whether an audio file with identical hash
1625 already exists in the osl database.
1627 PB: Path brother. Whether a file with the given path exists
1630 F: Force flag given. Whether add was called with -f.
1632 output: Action performed by the callback.
1634 AFHI: Whether afhi and chunk table are computed and sent.
1635 ACTION: Table modifications to be done by the callback.
1637 +----+----+---+------+---------------------------------------------------+
1638 | HS | PB | F | AFHI | ACTION
1639 +----+----+---+------+---------------------------------------------------+
1640 | Y | Y | Y | Y | if HS != PB: remove PB. HS: force afhi update,
1641 | | update path, keep afsi
1642 +----+----+---+------+---------------------------------------------------+
1643 | Y | Y | N | N | if HS == PB: do not send callback request at all.
1644 | | otherwise: remove PB, HS: update path, keep afhi,
1646 +----+----+---+------+---------------------------------------------------+
1647 | Y | N | Y | Y | (rename) force afhi update of HS, update path of
1649 +----+----+---+------+---------------------------------------------------+
1650 | Y | N | N | N | (file rename) update path of HS, keep afsi, afhi
1651 +----+----+---+------+---------------------------------------------------+
1652 | N | Y | Y | Y | (file change) update afhi, hash, of PB, keep afsi
1653 | | (force has no effect)
1654 +----+----+---+------+---------------------------------------------------+
1655 | N | Y | N | Y | (file change) update afhi, hash of PB, keep afsi
1656 +----+----+---+------+---------------------------------------------------+
1657 | N | N | Y | Y | (new file) create new entry (force has no effect)
1658 +----+----+---+------+---------------------------------------------------+
1659 | N | N | N | Y | (new file) create new entry
1660 +----+----+---+------+---------------------------------------------------+
1664 afhi <=> force or no HS
1669 static int com_add_callback(struct afs_callback_arg *aca)
1671 char *buf = aca->query.data, *path;
1672 struct osl_row *pb, *aft_row;
1674 struct osl_object objs[NUM_AFT_COLUMNS];
1675 unsigned char *hash;
1676 char asc[2 * HASH2_SIZE + 1];
1678 char afsi_buf[AFSI_SIZE];
1679 uint32_t slpr_offset = read_u32(buf + CAB_LPR_OFFSET);
1680 char *slpr = buf + slpr_offset;
1681 struct afs_info default_afsi = {.last_played = 0};
1682 uint16_t afhi_offset, chunks_offset;
1683 const struct lls_command *cmd = SERVER_CMD_CMD_PTR(ADD);
1684 const struct lls_opt_result *r_f, *r_v;
1686 ret = lls_deserialize_parse_result(slpr, cmd, &aca->lpr);
1688 r_f = SERVER_CMD_OPT_RESULT(ADD, FORCE, aca->lpr);
1689 r_v = SERVER_CMD_OPT_RESULT(ADD, VERBOSE, aca->lpr);
1691 hash = (unsigned char *)buf + CAB_HASH_OFFSET;
1692 hash2_to_asc(hash, asc);
1693 objs[AFTCOL_HASH].data = buf + CAB_HASH_OFFSET;
1694 objs[AFTCOL_HASH].size = HASH2_SIZE;
1696 path = buf + CAB_PATH_OFFSET;
1697 objs[AFTCOL_PATH].data = path;
1698 objs[AFTCOL_PATH].size = strlen(path) + 1;
1700 PARA_INFO_LOG("request to add %s\n", path);
1701 ret = find_hash_sister(hash, &hs);
1704 ret = find_path_brother(path, &pb);
1707 if (hs && pb && hs == pb && !lls_opt_given(r_f)) {
1708 if (lls_opt_given(r_v))
1709 para_printf(&aca->pbout, "ignoring duplicate\n");
1713 if (hs && hs != pb) {
1714 struct osl_object obj;
1715 if (pb) { /* hs trumps pb, remove pb */
1716 if (lls_opt_given(r_v))
1717 para_printf(&aca->pbout, "removing %s\n", path);
1718 ret = afs_event(AUDIO_FILE_REMOVE, &aca->pbout, pb);
1721 ret = osl(osl_del_row(audio_file_table, pb));
1726 /* file rename, update hs' path */
1727 if (lls_opt_given(r_v)) {
1728 ret = osl(osl_get_object(audio_file_table, hs,
1729 AFTCOL_PATH, &obj));
1732 para_printf(&aca->pbout, "renamed from %s\n",
1735 ret = osl(osl_update_object(audio_file_table, hs, AFTCOL_PATH,
1736 &objs[AFTCOL_PATH]));
1739 ret = afs_event(AUDIO_FILE_RENAME, &aca->pbout, hs);
1742 if (!lls_opt_given(r_f))
1745 /* no hs or force mode, child must have sent afhi */
1746 afhi_offset = read_u32(buf + CAB_AFHI_OFFSET_POS);
1747 chunks_offset = read_u32(buf + CAB_CHUNKS_OFFSET_POS);
1748 assert(chunks_offset <= slpr_offset);
1750 objs[AFTCOL_AFHI].data = buf + afhi_offset;
1751 objs[AFTCOL_AFHI].size = chunks_offset - afhi_offset;
1753 if (!objs[AFTCOL_AFHI].size) /* "impossible" */
1755 objs[AFTCOL_CHUNKS].data = buf + chunks_offset;
1756 objs[AFTCOL_CHUNKS].size = slpr_offset - chunks_offset;
1757 if (pb && !hs) { /* update pb's hash */
1758 char old_asc[2 * HASH2_SIZE + 1];
1759 unsigned char *old_hash;
1760 ret = get_hash_of_row(pb, &old_hash);
1763 hash2_to_asc(old_hash, old_asc);
1764 if (lls_opt_given(r_v))
1765 para_printf(&aca->pbout, "file change: %s -> %s\n",
1767 ret = osl(osl_update_object(audio_file_table, pb, AFTCOL_HASH,
1768 &objs[AFTCOL_HASH]));
1772 if (hs || pb) { /* (hs != NULL and pb != NULL) implies hs == pb */
1773 struct osl_row *row = pb? pb : hs;
1774 /* update afhi and chunk_table */
1775 if (lls_opt_given(r_v))
1776 para_printf(&aca->pbout,
1777 "updating afhi and chunk table\n");
1778 ret = osl(osl_update_object(audio_file_table, row, AFTCOL_AFHI,
1779 &objs[AFTCOL_AFHI]));
1782 /* truncate the file to size zero if there is no chunk table */
1783 ret = osl(osl_update_object(audio_file_table, row, AFTCOL_CHUNKS,
1784 &objs[AFTCOL_CHUNKS]));
1787 ret = afs_event(AFHI_CHANGE, &aca->pbout, row);
1790 /* new entry, use default afsi */
1791 if (lls_opt_given(r_v))
1792 para_printf(&aca->pbout, "new file\n");
1793 default_afsi.last_played = time(NULL) - 365 * 24 * 60 * 60;
1794 default_afsi.audio_format_id = read_u8(buf + CAB_AUDIO_FORMAT_ID_OFFSET);
1796 objs[AFTCOL_AFSI].data = &afsi_buf;
1797 objs[AFTCOL_AFSI].size = AFSI_SIZE;
1798 save_afsi(&default_afsi, &objs[AFTCOL_AFSI]);
1799 ret = osl(osl_add_and_get_row(audio_file_table, objs, &aft_row));
1802 ret = afs_event(AUDIO_FILE_ADD, &aca->pbout, aft_row);
1805 afs_error(aca, "could not add %s\n", path);
1806 lls_free_parse_result(aca->lpr, cmd);
1810 /* Used by com_add(). */
1811 struct private_add_data {
1812 /* The pointer passed to the original command handler. */
1813 struct command_context *cc;
1814 /* Contains the flags given at the command line. */
1815 struct lls_parse_result *lpr;
1816 /* Serialized lopsub parse result. */
1818 /* Number of bytes. */
1822 static int path_brother_callback(struct afs_callback_arg *aca)
1824 char *path = aca->query.data;
1825 struct osl_row *path_brother;
1826 int ret = find_path_brother(path, &path_brother);
1829 return pass_buffer_as_shm(aca->fd, SBD_OUTPUT, (char *)&path_brother,
1830 sizeof(path_brother));
1833 static int hash_sister_callback(struct afs_callback_arg *aca)
1835 unsigned char *hash = aca->query.data;
1836 struct osl_row *hash_sister;
1837 int ret = find_hash_sister(hash, &hash_sister);
1841 return pass_buffer_as_shm(aca->fd, SBD_OUTPUT, (char *)&hash_sister,
1842 sizeof(hash_sister));
1845 static int get_row_pointer_from_result(struct osl_object *result,
1846 __a_unused uint8_t band, void *private)
1848 struct osl_row **row = private;
1850 if (band == SBD_OUTPUT)
1851 *row = *(struct osl_row **)(result->data);
1855 static int add_one_audio_file(const char *path, void *private_data)
1857 int ret, send_ret = 1, fd;
1858 uint8_t format_num = -1;
1859 struct private_add_data *pad = private_data;
1860 struct afh_info afhi, *afhi_ptr = NULL;
1861 struct osl_row *pb = NULL, *hs = NULL; /* path brother/hash sister */
1862 struct osl_object map, obj = {.data = NULL}, query;
1863 unsigned char hash[HASH2_SIZE];
1864 bool a_given = SERVER_CMD_OPT_GIVEN(ADD, ALL, pad->lpr);
1865 bool f_given = SERVER_CMD_OPT_GIVEN(ADD, FORCE, pad->lpr);
1866 bool l_given = SERVER_CMD_OPT_GIVEN(ADD, LAZY, pad->lpr);
1867 bool v_given = SERVER_CMD_OPT_GIVEN(ADD, VERBOSE, pad->lpr);
1869 ret = guess_audio_format(path);
1870 if (ret < 0 && !a_given) {
1874 query.data = (char *)path;
1875 query.size = strlen(path) + 1;
1876 ret = send_callback_request(path_brother_callback, &query,
1877 get_row_pointer_from_result, &pb);
1878 if (ret < 0 && ret != -OSL_ERRNO_TO_PARA_ERROR(E_OSL_RB_KEY_NOT_FOUND))
1881 if (pb && l_given) { /* lazy is really cheap */
1883 send_ret = send_sb_va(&pad->cc->scc, SBD_OUTPUT,
1884 "lazy-ignore: %s\n", path);
1887 /* We still want to add this file. Compute its hash. */
1888 ret = mmap_full_file(path, O_RDONLY, &map.data, &map.size, &fd);
1891 hash2_function(map.data, map.size, hash);
1893 /* Check whether the database contains a file with the same hash. */
1895 query.size = HASH2_SIZE;
1896 ret = send_callback_request(hash_sister_callback, &query,
1897 get_row_pointer_from_result, &hs);
1900 /* Return success if we already know this file. */
1902 if (pb && hs && hs == pb && !f_given) {
1904 send_ret = send_sb_va(&pad->cc->scc, SBD_OUTPUT,
1905 "%s exists, not forcing update\n", path);
1909 * We won't recalculate the audio format info and the chunk table if
1910 * there is a hash sister and FORCE was not given.
1912 if (!hs || f_given) {
1913 ret = compute_afhi(path, map.data, map.size, fd, &afhi);
1919 munmap(map.data, map.size);
1922 send_ret = send_sb_va(&pad->cc->scc, SBD_OUTPUT,
1923 "adding %s\n", path);
1927 save_add_callback_buffer(hash, path, afhi_ptr, pad->slpr,
1928 pad->slpr_size, format_num, &obj);
1929 /* Ask afs to consider this entry for adding. */
1930 ret = send_callback_request(com_add_callback, &obj,
1931 afs_cb_result_handler, pad->cc);
1936 munmap(map.data, map.size);
1938 if (ret < 0 && send_ret >= 0)
1939 send_ret = send_sb_va(&pad->cc->scc, SBD_ERROR_LOG,
1940 "failed to add %s (%s)\n", path, para_strerror(-ret));
1942 clear_afhi(afhi_ptr);
1943 /* Stop adding files only on send errors. */
1948 * Call back once for each regular file below a directory.
1950 * Traverse the given directory recursively and call the supplied callback for
1951 * each regular file encountered. The first argument to the callback will be
1952 * the path to the regular file and the second argument will be the data
1953 * pointer. All file types except regular files and directories are ignored. In
1954 * particular, symlinks are not followed. Subdirectories are ignored silently
1955 * if the calling process has insufficient access permissions.
1957 static int for_each_file_in_dir(const char *dirname,
1958 int (*func)(const char *, void *), void *data)
1962 struct dirent *entry;
1964 dir = opendir(dirname);
1966 return errno == EACCES? 1 : -ERRNO_TO_PARA_ERROR(errno);
1967 /* scan cwd recursively */
1968 while ((entry = readdir(dir))) {
1972 if (!strcmp(entry->d_name, "."))
1974 if (!strcmp(entry->d_name, ".."))
1976 tmp = make_message("%s/%s", dirname, entry->d_name);
1978 if (lstat(tmp, &s) != -1) {
1979 if (S_ISREG(s.st_mode))
1980 ret = func(tmp, data);
1981 else if (S_ISDIR(s.st_mode))
1982 ret = for_each_file_in_dir(tmp, func, data);
1994 static int com_add(struct command_context *cc, struct lls_parse_result *lpr)
1997 struct private_add_data pad = {.cc = cc, .lpr = lpr};
1998 const struct lls_command *cmd = SERVER_CMD_CMD_PTR(ADD);
1999 unsigned num_inputs;
2002 ret = lls(lls_check_arg_count(lpr, 1, INT_MAX, &errctx));
2004 send_errctx(cc, errctx);
2007 ret = lls_serialize_parse_result(lpr, cmd, &pad.slpr, &pad.slpr_size);
2009 num_inputs = lls_num_inputs(lpr);
2010 for (i = 0; i < num_inputs; i++) {
2012 ret = verify_path(lls_input(i, lpr), &path);
2014 ret = send_sb_va(&cc->scc, SBD_ERROR_LOG, "%s: %s\n",
2015 lls_input(i, lpr), para_strerror(-ret));
2020 if (ret == 1) /* directory */
2021 ret = for_each_file_in_dir(path, add_one_audio_file,
2023 else /* regular file */
2024 ret = add_one_audio_file(path, &pad);
2026 send_sb_va(&cc->scc, SBD_OUTPUT, "%s: %s\n", path,
2027 para_strerror(-ret));
2038 EXPORT_SERVER_CMD_HANDLER(add);
2040 /** Flags used by the touch command. */
2042 /** Whether the \p FNM_PATHNAME flag should be passed to fnmatch(). */
2043 TOUCH_FLAG_FNM_PATHNAME = 1,
2044 /** Activates verbose mode. */
2045 TOUCH_FLAG_VERBOSE = 2
2048 static int touch_audio_file(__a_unused struct osl_table *table,
2049 struct osl_row *row, const char *name, void *data)
2051 struct afs_callback_arg *aca = data;
2052 bool v_given = SERVER_CMD_OPT_GIVEN(TOUCH, VERBOSE, aca->lpr);
2053 const struct lls_opt_result *r_n, *r_l, *r_i, *r_y, *r_a;
2055 struct osl_object obj;
2056 struct afs_info old_afsi, new_afsi;
2058 struct afsi_change_event_data aced;
2060 r_n = SERVER_CMD_OPT_RESULT(TOUCH, NUMPLAYED, aca->lpr);
2061 r_l = SERVER_CMD_OPT_RESULT(TOUCH, LASTPLAYED, aca->lpr);
2062 r_i = SERVER_CMD_OPT_RESULT(TOUCH, IMAGE_ID, aca->lpr);
2063 r_y = SERVER_CMD_OPT_RESULT(TOUCH, LYRICS_ID, aca->lpr);
2064 r_a = SERVER_CMD_OPT_RESULT(TOUCH, AMP, aca->lpr);
2065 no_options = !lls_opt_given(r_n) && !lls_opt_given(r_l) && !lls_opt_given(r_i)
2066 && !lls_opt_given(r_y) && !lls_opt_given(r_a);
2068 ret = get_afsi_object_of_row(row, &obj);
2070 afs_error(aca, "cannot touch %s\n", name);
2073 ret = load_afsi(&old_afsi, &obj);
2075 afs_error(aca, "cannot touch %s\n", name);
2078 new_afsi = old_afsi;
2080 new_afsi.num_played++;
2081 new_afsi.last_played = time(NULL);
2083 para_printf(&aca->pbout, "%s: num_played = %u, "
2084 "last_played = now()\n", name,
2085 new_afsi.num_played);
2087 if (lls_opt_given(r_l))
2088 new_afsi.last_played = lls_uint64_val(0, r_l);
2089 if (lls_opt_given(r_n))
2090 new_afsi.num_played = lls_uint32_val(0, r_n);
2091 if (lls_opt_given(r_i))
2092 new_afsi.image_id = lls_uint32_val(0, r_i);
2093 if (lls_opt_given(r_y))
2094 new_afsi.lyrics_id = lls_uint32_val(0, r_y);
2095 if (lls_opt_given(r_a))
2096 new_afsi.amp = lls_uint32_val(0, r_a);
2098 para_printf(&aca->pbout, "touching %s\n", name);
2100 save_afsi(&new_afsi, &obj); /* in-place update */
2102 aced.old_afsi = &old_afsi;
2103 return afs_event(AFSI_CHANGE, &aca->pbout, &aced);
2106 static int com_touch_callback(struct afs_callback_arg *aca)
2108 const struct lls_command *cmd = SERVER_CMD_CMD_PTR(TOUCH);
2110 const struct lls_opt_result *r_i, *r_y;
2112 struct pattern_match_data pmd = {
2113 .table = audio_file_table,
2114 .loop_col_num = AFTCOL_HASH,
2115 .match_col_num = AFTCOL_PATH,
2117 .action = touch_audio_file
2120 ret = lls_deserialize_parse_result(aca->query.data, cmd, &aca->lpr);
2124 r_i = SERVER_CMD_OPT_RESULT(TOUCH, IMAGE_ID, aca->lpr);
2125 if (lls_opt_given(r_i)) {
2126 uint32_t id = lls_uint32_val(0, r_i);
2127 ret = img_get_name_by_id(id, NULL);
2129 afs_error(aca, "invalid image ID: %u\n", id);
2133 r_y = SERVER_CMD_OPT_RESULT(TOUCH, LYRICS_ID, aca->lpr);
2134 if (lls_opt_given(r_y)) {
2135 uint32_t id = lls_uint32_val(0, r_y);
2136 ret = lyr_get_name_by_id(id, NULL);
2138 afs_error(aca, "invalid lyrics ID: %u\n", id);
2142 p_given = SERVER_CMD_OPT_GIVEN(TOUCH, PATHNAME_MATCH, aca->lpr);
2144 pmd.fnmatch_flags |= FNM_PATHNAME;
2145 ret = for_each_matching_row(&pmd);
2146 if (ret >= 0 && pmd.num_matches == 0)
2148 lls_free_parse_result(aca->lpr, cmd);
2152 static int com_touch(struct command_context *cc, struct lls_parse_result *lpr)
2154 const struct lls_command *cmd = SERVER_CMD_CMD_PTR(TOUCH);
2158 ret = lls(lls_check_arg_count(lpr, 1, INT_MAX, &errctx));
2160 send_errctx(cc, errctx);
2163 return send_lls_callback_request(com_touch_callback, cmd, lpr, cc);
2165 EXPORT_SERVER_CMD_HANDLER(touch);
2167 static int remove_audio_file(__a_unused struct osl_table *table,
2168 struct osl_row *row, const char *name, void *data)
2170 struct afs_callback_arg *aca = data;
2171 bool v_given = SERVER_CMD_OPT_GIVEN(RM, VERBOSE, aca->lpr);
2175 para_printf(&aca->pbout, "removing %s\n", name);
2176 ret = afs_event(AUDIO_FILE_REMOVE, &aca->pbout, row);
2179 ret = osl(osl_del_row(audio_file_table, row));
2181 afs_error(aca, "cannot remove %s\n", name);
2185 static int com_rm_callback(struct afs_callback_arg *aca)
2187 const struct lls_command *cmd = SERVER_CMD_CMD_PTR(RM);
2189 struct pattern_match_data pmd = {
2190 .table = audio_file_table,
2191 .loop_col_num = AFTCOL_HASH,
2192 .match_col_num = AFTCOL_PATH,
2194 .action = remove_audio_file
2196 bool v_given, p_given, f_given;
2198 ret = lls_deserialize_parse_result(aca->query.data, cmd, &aca->lpr);
2201 v_given = SERVER_CMD_OPT_GIVEN(RM, VERBOSE, aca->lpr);
2202 p_given = SERVER_CMD_OPT_GIVEN(RM, PATHNAME_MATCH, aca->lpr);
2203 f_given = SERVER_CMD_OPT_GIVEN(RM, FORCE, aca->lpr);
2206 pmd.fnmatch_flags |= FNM_PATHNAME;
2207 ret = for_each_matching_row(&pmd);
2210 if (pmd.num_matches == 0) {
2214 para_printf(&aca->pbout, "removed %u file(s)\n",
2217 lls_free_parse_result(aca->lpr, cmd);
2221 /* TODO options: -r (recursive) */
2222 static int com_rm(struct command_context *cc, struct lls_parse_result *lpr)
2224 const struct lls_command *cmd = SERVER_CMD_CMD_PTR(RM);
2228 ret = lls(lls_check_arg_count(lpr, 1, INT_MAX, &errctx));
2230 send_errctx(cc, errctx);
2233 return send_lls_callback_request(com_rm_callback, cmd, lpr, cc);
2235 EXPORT_SERVER_CMD_HANDLER(rm);
2237 /** Data passed to the action handler of com_cpsi(). */
2238 struct cpsi_action_data {
2239 /** Values are copied from here. */
2240 struct afs_info source_afsi;
2241 /** What was passed to com_cpsi_callback(). */
2242 struct afs_callback_arg *aca;
2246 static int copy_selector_info(__a_unused struct osl_table *table,
2247 struct osl_row *row, const char *name, void *data)
2249 struct cpsi_action_data *cad = data;
2250 struct osl_object target_afsi_obj;
2252 struct afs_info old_afsi, target_afsi;
2253 struct afsi_change_event_data aced;
2254 bool a_given, y_given, i_given, l_given, n_given, v_given;
2256 a_given = SERVER_CMD_OPT_GIVEN(CPSI, ATTRIBUTE_BITMAP, cad->aca->lpr);
2257 y_given = SERVER_CMD_OPT_GIVEN(CPSI, LYRICS_ID, cad->aca->lpr);
2258 i_given = SERVER_CMD_OPT_GIVEN(CPSI, IMAGE_ID, cad->aca->lpr);
2259 l_given = SERVER_CMD_OPT_GIVEN(CPSI, LASTPLAYED, cad->aca->lpr);
2260 n_given = SERVER_CMD_OPT_GIVEN(CPSI, NUMPLAYED, cad->aca->lpr);
2261 v_given = SERVER_CMD_OPT_GIVEN(CPSI, VERBOSE, cad->aca->lpr);
2263 ret = get_afsi_object_of_row(row, &target_afsi_obj);
2266 ret = load_afsi(&target_afsi, &target_afsi_obj);
2269 old_afsi = target_afsi;
2270 if (cad->copy_all || y_given)
2271 target_afsi.lyrics_id = cad->source_afsi.lyrics_id;
2272 if (cad->copy_all || i_given)
2273 target_afsi.image_id = cad->source_afsi.image_id;
2274 if (cad->copy_all || l_given)
2275 target_afsi.last_played = cad->source_afsi.last_played;
2276 if (cad->copy_all || n_given)
2277 target_afsi.num_played = cad->source_afsi.num_played;
2278 if (cad->copy_all || a_given)
2279 target_afsi.attributes = cad->source_afsi.attributes;
2280 save_afsi(&target_afsi, &target_afsi_obj); /* in-place update */
2282 para_printf(&cad->aca->pbout, "copied afsi to %s\n", name);
2284 aced.old_afsi = &old_afsi;
2285 return afs_event(AFSI_CHANGE, &cad->aca->pbout, &aced);
2288 static int com_cpsi_callback(struct afs_callback_arg *aca)
2290 const struct lls_command *cmd = SERVER_CMD_CMD_PTR(CPSI);
2291 bool a_given, y_given, i_given, l_given, n_given, v_given;
2292 struct cpsi_action_data cad = {.aca = aca};
2294 struct pattern_match_data pmd = {
2295 .table = audio_file_table,
2296 .loop_col_num = AFTCOL_HASH,
2297 .match_col_num = AFTCOL_PATH,
2298 .input_skip = 1, /* skip first argument (source file) */
2300 .action = copy_selector_info
2303 ret = lls_deserialize_parse_result(aca->query.data, cmd, &aca->lpr);
2307 a_given = SERVER_CMD_OPT_GIVEN(CPSI, ATTRIBUTE_BITMAP, aca->lpr);
2308 y_given = SERVER_CMD_OPT_GIVEN(CPSI, LYRICS_ID, aca->lpr);
2309 i_given = SERVER_CMD_OPT_GIVEN(CPSI, IMAGE_ID, aca->lpr);
2310 l_given = SERVER_CMD_OPT_GIVEN(CPSI, LASTPLAYED, aca->lpr);
2311 n_given = SERVER_CMD_OPT_GIVEN(CPSI, NUMPLAYED, aca->lpr);
2312 v_given = SERVER_CMD_OPT_GIVEN(CPSI, VERBOSE, aca->lpr);
2313 cad.copy_all = !a_given && !y_given && !i_given && !l_given && !n_given;
2315 ret = get_afsi_of_path(lls_input(0, aca->lpr), &cad.source_afsi);
2318 ret = for_each_matching_row(&pmd);
2321 if (pmd.num_matches > 0) {
2323 para_printf(&aca->pbout, "updated afsi of %u file(s)\n",
2328 lls_free_parse_result(aca->lpr, cmd);
2332 static int com_cpsi(struct command_context *cc, struct lls_parse_result *lpr)
2334 const struct lls_command *cmd = SERVER_CMD_CMD_PTR(CPSI);
2336 int ret = lls(lls_check_arg_count(lpr, 2, INT_MAX, &errctx));
2338 send_errctx(cc, errctx);
2341 return send_lls_callback_request(com_cpsi_callback, cmd, lpr, cc);
2343 EXPORT_SERVER_CMD_HANDLER(cpsi);
2345 struct change_atts_data {
2346 uint64_t add_mask, del_mask;
2347 struct afs_callback_arg *aca;
2350 static int change_atts(__a_unused struct osl_table *table,
2351 struct osl_row *row, __a_unused const char *name, void *data)
2354 struct osl_object obj;
2355 struct afs_info old_afsi, new_afsi;
2356 struct afsi_change_event_data aced = {
2358 .old_afsi = &old_afsi
2360 struct change_atts_data *cad = data;
2362 ret = get_afsi_object_of_row(row, &obj);
2365 ret = load_afsi(&old_afsi, &obj);
2368 new_afsi = old_afsi;
2369 new_afsi.attributes |= cad->add_mask;
2370 new_afsi.attributes &= ~cad->del_mask;
2371 save_afsi(&new_afsi, &obj); /* in-place update */
2372 return afs_event(AFSI_CHANGE, &cad->aca->pbout, &aced);
2375 static int com_setatt_callback(struct afs_callback_arg *aca)
2377 const struct lls_command *cmd = SERVER_CMD_CMD_PTR(SETATT);
2379 struct change_atts_data cad = {.aca = aca};
2380 struct pattern_match_data pmd = {
2381 .table = audio_file_table,
2382 .loop_col_num = AFTCOL_HASH,
2383 .match_col_num = AFTCOL_PATH,
2384 .pm_flags = PM_SKIP_EMPTY_NAME,
2386 .action = change_atts
2388 unsigned num_inputs;
2390 ret = lls_deserialize_parse_result(aca->query.data, cmd, &aca->lpr);
2394 num_inputs = lls_num_inputs(aca->lpr);
2395 for (i = 0; i < num_inputs; i++) {
2396 unsigned char bitnum;
2398 const char *arg = lls_input(i, aca->lpr);
2400 size_t len = strlen(arg);
2402 ret = -E_ATTR_SYNTAX;
2406 if (c != '+' && c != '-') {
2407 if (cad.add_mask == 0 && cad.del_mask == 0)
2408 goto out; /* no attribute modifier given */
2412 memcpy(p, arg, len - 1);
2414 ret = get_attribute_bitnum_by_name(p, &bitnum);
2417 afs_error(aca, "invalid argument: %s\n", arg);
2421 cad.add_mask |= (one << bitnum);
2423 cad.del_mask |= (one << bitnum);
2425 /* no pattern given */
2426 ret = -E_ATTR_SYNTAX;
2430 ret = for_each_matching_row(&pmd);
2431 if (ret >= 0 && pmd.num_matches == 0)
2434 lls_free_parse_result(aca->lpr, cmd);
2438 static int com_setatt(struct command_context *cc, struct lls_parse_result *lpr)
2440 const struct lls_command *cmd = SERVER_CMD_CMD_PTR(SETATT);
2442 int ret = lls(lls_check_arg_count(lpr, 2, INT_MAX, &errctx));
2445 send_errctx(cc, errctx);
2448 return send_lls_callback_request(com_setatt_callback, cmd, lpr, cc);
2450 EXPORT_SERVER_CMD_HANDLER(setatt);
2452 static int afs_stat_callback(struct afs_callback_arg *aca)
2454 int *parser_friendly = aca->query.data;
2455 char *buf = *parser_friendly?
2456 parser_friendly_status_items : status_items;
2460 return pass_buffer_as_shm(aca->fd, SBD_OUTPUT, buf, strlen(buf));
2464 * Get the current afs status items from the afs process and send it.
2466 * \param cc The command context, used e.g. for data encryption.
2467 * \param parser_friendly Whether parser-friendly output format should be used.
2469 * As the contents of the afs status items change in time and the command
2470 * handler only has a COW version created at fork time, it can not send
2471 * up-to-date afs status items directly. Therefore the usual callback mechanism
2472 * is used to pass the status items from the afs process to the command handler
2473 * via a shared memory area and a pipe.
2475 * \return The return value of the underlying call to \ref send_callback_request().
2477 int send_afs_status(struct command_context *cc, int parser_friendly)
2479 struct osl_object query = {.data = &parser_friendly,
2480 .size = sizeof(parser_friendly)};
2482 return send_callback_request(afs_stat_callback, &query,
2483 afs_cb_result_handler, cc);
2486 /* returns success on non-fatal errors to keep the loop going */
2487 static int check_audio_file(struct osl_row *row, void *data)
2490 struct para_buffer *pb = data;
2491 struct stat statbuf;
2492 int ret = get_audio_file_path_of_row(row, &path);
2493 struct afs_info afsi;
2497 para_printf(pb, "%s\n", para_strerror(-ret));
2500 if (stat(path, &statbuf) < 0)
2501 para_printf(pb, "%s: stat error (%s)\n", path, strerror(errno));
2502 else if (!S_ISREG(statbuf.st_mode))
2503 para_printf(pb, "%s: not a regular file\n", path);
2504 ret = get_afsi_of_row(row, &afsi);
2506 para_printf(pb, "%s: %s\n", path, para_strerror(-ret));
2509 ret = lyr_get_name_by_id(afsi.lyrics_id, &blob_name);
2511 para_printf(pb, "%s lyrics id %u: %s\n", path, afsi.lyrics_id,
2512 para_strerror(-ret));
2513 ret = img_get_name_by_id(afsi.image_id, &blob_name);
2515 para_printf(pb, "%s image id %u: %s\n", path, afsi.image_id,
2516 para_strerror(-ret));
2521 * Check the audio file table for inconsistencies.
2523 * \param aca Only ->pbout is used for diagnostics.
2525 * \return Standard. Inconsistencies are reported but not regarded as an error.
2527 int aft_check_callback(struct afs_callback_arg *aca)
2529 para_printf(&aca->pbout, "checking audio file table...\n");
2530 return audio_file_loop(&aca->pbout, check_audio_file);
2533 struct aft_check_atts_data {
2535 struct para_buffer *pb;
2538 static int check_atts_of_audio_file(struct osl_row *row, void *data)
2540 struct aft_check_atts_data *acad = data;
2542 struct afs_info afsi;
2546 ret = get_afsi_of_row(row, &afsi);
2548 para_printf(acad->pb, "cannot get afsi\n");
2551 bad_bits = afsi.attributes & ~acad->att_mask;
2552 if (bad_bits == 0) /* OK */
2554 ret = get_audio_file_path_of_row(row, &path);
2556 para_printf(acad->pb, "cannot get path\n");
2559 para_printf(acad->pb, "invalid attribute bits (%" PRIu64 "): %s\n",
2561 /* return success to keep looping */
2566 * Iterate over all audio files and check the attribute bit mask.
2568 * \param att_mask The mask of all valid attributes.
2569 * \param pb Used for reporting inconsistencies.
2571 * This reads the attribute bit mask of each audio file from the afs info
2572 * structure stored in the audio file table and verifies that all set bits are
2573 * also turned on in \a att_mask, i.e., correspond to an attribute of the
2574 * attribute table. Audio files for which this is not the case are reported via
2577 * \return Standard. Inconsistencies are not regarded as errors.
2579 * \sa \ref attribute_check_callback().
2581 int aft_check_attributes(uint64_t att_mask, struct para_buffer *pb)
2583 struct aft_check_atts_data acad = {.att_mask = att_mask, .pb = pb};
2585 para_printf(pb, "checking attributes, mask: %" PRIx64 "\n", att_mask);
2586 return audio_file_loop(&acad, check_atts_of_audio_file);
2590 * This sets audio_file_table to NULL, but leaves current_aft_row unmodified,
2591 * though stale (pointing to unmapped memory). If the table is being closed
2592 * because we received SIGHUP, the table will be reopened after the config file
2593 * has been reloaded. We remember the hash of the current audio file here so
2594 * that aft_open() can initialize current_aft_row by looking up the saved hash.
2596 static void aft_close(void)
2601 if (current_aft_row) {
2602 ret = get_hash_of_row(current_aft_row, &p);
2604 PARA_WARNING_LOG("hash lookup failure\n");
2605 current_aft_row = NULL;
2607 memcpy(current_hash, p, HASH2_SIZE);
2609 osl_close_table(audio_file_table, OSL_MARK_CLEAN);
2610 audio_file_table = NULL;
2613 static int aft_open(const char *dir)
2617 audio_file_table_desc.dir = dir;
2618 ret = osl(osl_open_table(&audio_file_table_desc, &audio_file_table));
2621 osl_get_num_rows(audio_file_table, &num);
2622 PARA_INFO_LOG("audio file table contains %u files\n", num);
2623 if (!current_aft_row) {
2624 PARA_DEBUG_LOG("no current aft row\n");
2627 /* SIGHUP case, update current_aft_row */
2628 ret = aft_get_row_of_hash(current_hash, ¤t_aft_row);
2629 if (ret < 0) { /* not fatal */
2630 PARA_WARNING_LOG("current hash lookup failure: %s\n",
2631 para_strerror(-ret));
2632 current_aft_row = NULL;
2635 PARA_NOTICE_LOG("current audio file hash lookup: success\n");
2638 audio_file_table = NULL;
2639 if (ret == -OSL_ERRNO_TO_PARA_ERROR(E_OSL_NOENT)) {
2640 PARA_WARNING_LOG("no audio file table\n");
2643 PARA_NOTICE_LOG("failed to open audio file table\n");
2647 static int aft_create(const char *dir)
2649 audio_file_table_desc.dir = dir;
2650 return osl(osl_create_table(&audio_file_table_desc));
2653 static int clear_attribute(struct osl_row *row, void *data)
2655 struct rmatt_event_data *red = data;
2656 struct afs_info afsi;
2657 struct osl_object obj;
2658 int ret = get_afsi_object_of_row(row, &obj);
2659 uint64_t mask = ~(1ULL << red->bitnum);
2663 ret = load_afsi(&afsi, &obj);
2666 afsi.attributes &= mask;
2667 save_afsi(&afsi, &obj);
2671 static int aft_event_handler(enum afs_events event, struct para_buffer *pb,
2677 case ATTRIBUTE_REMOVE: {
2678 const struct rmatt_event_data *red = data;
2679 para_printf(pb, "clearing attribute %s (bit %u) from all "
2680 "entries in the audio file table\n", red->name,
2682 return audio_file_loop(data, clear_attribute);
2683 } case AFSI_CHANGE: {
2684 struct afsi_change_event_data *aced = data;
2685 uint64_t old_last_played = status_item_ls_data.afsi.last_played;
2686 if (aced->aft_row != current_aft_row)
2688 ret = get_afsi_of_row(aced->aft_row, &status_item_ls_data.afsi);
2691 status_item_ls_data.afsi.last_played = old_last_played;
2692 make_status_items();
2694 } case AUDIO_FILE_RENAME: {
2696 if (data != current_aft_row)
2698 ret = get_audio_file_path_of_row(current_aft_row, &path);
2701 free(status_item_ls_data.path);
2702 status_item_ls_data.path = para_strdup(path);
2703 make_status_items();
2705 } case AFHI_CHANGE: {
2706 if (data != current_aft_row)
2708 ret = get_afhi_of_row(data, &status_item_ls_data.afhi);
2711 make_status_items();
2713 } case AUDIO_FILE_REMOVE: {
2714 if (data == current_aft_row)
2715 current_aft_row = NULL;
2722 * These events are rare. We don't bother to check whether the
2723 * current status items are affected and simply recreate them
2724 * whenever an audio file is open.
2726 if (!current_aft_row)
2728 ret = get_afhi_of_row(current_aft_row,
2729 &status_item_ls_data.afhi);
2732 make_status_items();
2739 /** The audio file table contains information about known audio files. */
2740 const struct afs_table_operations aft_ops = {
2743 .create = aft_create,
2744 .event_handler = aft_event_handler,