2 SF: afs.c aft.c attribute.c
3 HC: Prototypes for the commands of the audio file selector.
4 CC: Array of commands for the audio file selector.
6 IN: para afh server list user_list
7 SN: list of afs commands
11 P: AFS_READ | AFS_WRITE
12 D: Add new audio files to the database.
13 U: add [-l] [-f] [-v] path1 ...
14 H: Each given path may be either the full path to an audio file, or the full path
15 H: of a directory. In case of a directory, all audio files in that directory
16 H: are added recursivly.
20 H: -l Add files lazily. If a file already exists in the database, skip this file.
21 H: This operation is really cheap. Use it when adding large directories if only a
22 H: few files where added.
24 H:-f Force adding/updating. Recompute the audio format handler data
25 H: even if a file with the same path and the same hash value exists.
27 H: -v Verbose mode. Print what is being done.
30 P: AFS_READ | AFS_WRITE
31 D: Initialize the osl tables for the audio file selector.
32 U: init [table_name ...]
33 H: When invoked without arguments, this command creates all tables. Otherwise
34 H: only the tables given by table_name... are created.
39 U: ls [-l[s|l|v|m]] -p -a -r -s{p|s|l|n|f|c|i|y|b|d|a} [pattern ...]
40 H: Print a list of all audio files matching pattern.
43 H: -l Change listing mode. Defaults to short listing if not given.
44 H: -ls: short listing mode
45 H: -ll: long listing mode (equivalent to -l)
46 H: -lv: verbose listing mode
47 H: -lm: mbox listing mode
49 H: -p List full path of audio file. If not specified, only the basename
50 H: of each file is printed.
52 H: -a List only file that are admissible with respect to the current mood or
55 H: -r Reverse sort order.
57 H: -s Change sort order. Defaults to alphabetical path sort if not given.
59 H: -sl: sort by last played time.
60 H: -ss: sort by score (implies -a).
61 H: -sn: sort by number of times the file was played.
62 H: -sf: sort by frequency.
63 H: -sc: sort by number of channels.
64 H: -si: sort by image id.
65 H: -sy: sort by lyrics id.
66 H: -sb: sort by bitrate.
67 H: -sd: sort by duration.
68 H: -sa: sort by audio format.
75 H: Print the list of all defined attributes.
78 H: -a Sort attributes alphabetically by name. The default is to sort by
81 H: -l Print a long listing containing both identifier and attribute name. The
82 H: default is to print only the name.
85 P: AFS_READ | AFS_WRITE
86 D: Set attribute(s) for all files matching a pattern.
87 U: setatt attribute1{+|-} [attribute2{+|-}...] pattern
89 H: Set ('+') or unset ('-') the given attributes for all audio files matching
92 H: sa rock+ punk+ classic- '*foo.mp3'
94 H: sets the 'rock' and the 'punk' attribute but unsets the 'classic'
95 H: attribute of all files ending with 'foo.mp3'.
98 P: AFS_READ | AFS_WRITE
99 D: Add new attribute(s).
100 U: addatt attribute1 [attribute2 ...]
101 H: This adds new attributes to the attribute table. At most 64 attributes
106 D: Run integrity checks for the osl tables.
107 U: check [-a] [-m] [-p]
111 P: AFS_READ | AFS_WRITE
117 P: AFS_READ | AFS_WRITE
123 P: AFS_READ | AFS_WRITE
124 D: Manupulate the afs data for all audio files matching a pattern.
125 U: touch [-n numplayed] [-l lastplayed] [-y lyrics_id] [-i image_id] pattern
126 If neither of the optional options is given, lastplayed is set to the current
127 time and numplayed is increased by one. Otherwise, only the given options are
130 H: -n Set numplayed count. The number of times afs has selected this
131 H: audio file for streaming.
133 H: -l Set lastplayed time. The last time this audio file was selected.
134 H: Must be given as the number of sectonds since the epoch. Example:
136 H: touch -l $(date +%s) file
138 H: sets the lastplayed time of 'file' to the current time
140 H: -y Set the lyrics id. Specify the lyrics data file associated with
143 H: -i Set the image id. Same as -y, but sets the image.
147 O: int com_add@member@(int fd, int argc, char * const * const argv);
148 P: AFS_READ | AFS_WRITE
150 U: add@member@ @member@_name
155 O: int com_cat@member@(int fd, int argc, char * const * const argv);
158 U: cat@member@ @member@_name
163 O: int com_ls@member@(int fd, int argc, char * const * const argv);
166 U: ls@member@ pattern
171 O: int com_rm@member@(int fd, int argc, char * const * const argv);
172 P: AFS_READ | AFS_WRITE
174 U: rm@member@ @member@_name
179 O: int com_mv@member@(int fd, int argc, char * const * const argv);
180 P: AFS_READ | AFS_WRITE
182 U: mv@member@ old_@member@_name new_@member@_name