+++ /dev/null
-OF: mysql_selector_command_list
-SF: mysql_selector.c
-HC: prototypes for the commands of the mysql audio file selector
-CC: array of commands for the mysql audio file selector
-AT: server_command
-IN: para error string afh afs server list user_list
-SN: list of mysql selector commands
----
-N: cam
-P: AFS_READ | AFS_WRITE
-D: copy all metadata
-U: cam source dest1 [dest2 ...]
-H: Copy attributes and other meta data from source file to destination
-H: file(s). Useful for files that have been renamed.
----
-N: cdb
-P: AFS_READ | AFS_WRITE
-D: create database
-U: cdb [name]
-H:
-H: Create database name containing the initial columns for basic
-H: interoperation with server. This command has to be used only once
-H: when you use the mysql audio file selector for the very first time.
-H:
-H: The optional name defaults to 'paraslash' if not given.
----
-N: clean
-P: AFS_READ | AFS_WRITE
-D: nuke invalid entries in database
-U: clean
-H: If the vrfy command shows you any invalid entries in your database,
-H: you can get rid of them with clean. Always run 'upd' and 'vrfy'
-H: before running this command. Use with caution!
----
-N: cs
-P: VSS_WRITE | AFS_READ | AFS_WRITE
-D: change stream
-U: cs [s]
-H: Selects stream s or prints current stream when s was not given.
----
-N: csp
-P: VSS_WRITE | AFS_READ
-D: change stream and play
-U: csp s
-H: Select stream s and start playing. If this results in a
-H: stream-change, skip rest of current audio file.
----
-N: da
-P: AFS_READ | AFS_WRITE
-D: drop attribute from database
-U: da att
-H: Use with caution. All info on attribute att will be lost.
----
-N: hist
-P: AFS_READ
-D: print history
-U: hist
-H: Print list of all audio files together with number of days since
-H: each file was last played.
----
-N: info
-P: AFS_READ
-D: print database info
-U: info [af]
-H: print database informations for audio file af. Current audio file
-H: is used if af is not given.
----
-N: la
-P: AFS_READ
-D: list attributes
-U: la [af]
-H: List attributes of audio file af or of current audio file when
-H: invoked without arguments.
----
-N: laa
-P: AFS_READ
-D: list available attributes
-U: laa
-H: print list of all attributes defined in the database
----
-N: last
-P: AFS_READ
-D: print list of audio files, ordered by lastplayed time
-U: last [n]
-H: The optional number n defaults to 10 if not specified.
----
-N: ls
-P: AFS_READ
-D: list all audio files that match a LIKE pattern
-U: ls [pattern]
-H: If pattern was not given, print list of all audio files known
-H: to the mysql selector. See the documentation of mysql
-H: for the definition of LIKE patterns.
----
-N: mbox
-P: AFS_READ
-D: dump audio file list in mbox format
-U: mbox [p]
-H: Dump list of audio files in mbox format (email) to stdout. If
-H: the optional pattern p is given, only those audio files,
-H: whose basename match p are going to be included. Otherwise,
-H: all files are selected.
-H:
-H: EXAMPLE
-H: The mbox command can be used together with your favorite
-H: mailer (this example uses mutt) for browsing the audio file
-H: collection:
-H:
-H: para_client mbox > ~/para_mbox
-H:
-H: mutt -F ~/.muttrc.para -f ~/para_mbox
-H:
-H: For playlists, you can use mutt's powerful pattern matching
-H: language to select files. If you like to tag all files
-H: containing the pattern 'foo', type 'T', then '~s foo'.
-H:
-H: When ready with the list, type ';|' (i.e., hit the semicolon
-H: key to apply the next mutt command to all tagged messages,
-H: then the pipe key) to pipe the selected mails to a
-H: suitable script which adds a paraslash stream where exactly
-H: these files are admissable or does whatever thou wilt.
----
-N: mv
-P: AFS_READ | AFS_WRITE
-D: rename entry in database
-U: mv oldname newname
-H: Rename oldname to newname. This updates the data table to reflect
-H: the new name. All internal data (numplayed, lastplayed, picid,..)
-H: is kept. If newname is a full path, the dir table is updated as
-H: well.
----
-N: na
-P: AFS_READ | AFS_WRITE
-D: add new attribute to database
-U: na att
-H: This adds a column named att to your mysql database. att should
-H: only contain letters and numbers, in paricular, '+' and '-' are
-H: not allowed.
----
-N: ne
-P: AFS_READ | AFS_WRITE
-D: add new database entries
-U: ne file1 [file2 [...]]
-H: Add the given filename(s) to the database, where file1,... must
-H: be full path names. This command might be much faster than 'upd'
-H: if the number of given files is small.
----
-N: ns
-P: VSS_WRITE | AFS_READ | AFS_WRITE
-D: change to next stream
-U: ns
-H: Cycle forwards through stream list.
----
-N: pic
-P: AFS_READ
-D: get picture by name or by identifier
-U: pic [name]
-H: Dump jpg image that is associated to given audio file (current
-H: audio file if not specified) to stdout. If name starts with
-H: '#' it is interpreted as an identifier instead and the picture
-H: having that identifier is dumped to stdout.
-H:
-H: EXAMPLE
-H:
-H: para_client pic '#123' > pic123.jpg
----
-N: picadd
-P: AFS_READ | AFS_WRITE
-D: add picture to database
-U: picadd [picname]
-H: Read jpeg file from stdin and store it as picname in database.
-H:
-H: EXAMPLE
-H:
-H: para_client picadd foo.jpg < foo.jpg
----
-N: picass
-P: AFS_READ | AFS_WRITE
-D: associate a picture to file(s)
-U: picass pic_id file1 [file2...]
-H: Associate the picture given by pic_id to all given files.
----
-N: picch
-P: AFS_READ | AFS_WRITE
-D: change name of picture
-U: picch id new_name
-H: Asign new_name to picture with identifier id.
----
-N: picdel
-P: AFS_READ | AFS_WRITE
-D: delete picture from database
-U: picdel id1 [id2...]
-H: Delete each given picture from database.
----
-N: piclist
-P: AFS_READ
-D: print list of pictures
-U: piclist
-H: Print id, name and length of each picture contained in the
-H: database.
----
-N: ps
-P: VSS_WRITE | AFS_READ | AFS_WRITE
-D: change to previous stream
-U: ps
-H: Cycle backwards through stream list.
----
-N: rm
-P: AFS_READ | AFS_WRITE
-D: remove entries from database
-U: rm name1 [name2 [...]]
-H: Remove name1, name2, ... from the data table. Use with caution.
----
-N: sa
-P: AFS_READ | AFS_WRITE
-D: set/unset attributes
-U: sa at1<'+' | '-'> [at2<'+' | '-'> ] [af1 ...]
-H: Set ('+') or unset ('-') attribute at1, at2 etc. for given list of
-H: audio files. If no audio files were given the current audio file is
-H: used. Example:
-H:
-H: sa rock+ punk+ classic- LZ__Waldsterben.mp3
-H:
-H: sets the 'rock' and the 'punk' attribute but unsets the 'classic'
-H: attribute.
----
-N: skip
-P: AFS_READ | AFS_WRITE
-D: skip subsequent audio files(s)
-U: skip n [s]
-H: Skip the next n audio files of stream s. This is equivalent to the
-H: command 'sl n s', followed by 'us name' for each name the output of
-H: sl.
----
-N: sl
-P: AFS_READ
-D: print score list
-U: sl n [s]
-H: Print sorted list of maximal n lines. Each line is an admissible
-H: entry with respect to stream s. The list is sorted by score-value
-H: which is given by the definition of s. If s is not given, the
-H: current stream is used. Example:
-H:
-H: sl 1
-H:
-H: shows you the audio file the server would select right now.
----
-N: snp
-P: AFS_READ | AFS_WRITE
-D: set numplayed
-U: snp number af1 [af2 ...]
-H: Update the numplayed field in the data table for all given audio
-H: files.
----
-N: stradd
-P: AFS_READ | AFS_WRITE
-D: add stream
-U: stradd s
-H: Add stream s to the list of available streams. The stream
-H: definition for s is read from stdin and is then sent to
-H: para_server. Example:
-H:
-H: echo 'deny: NAME_LIKE(%Madonna%)' | para_client stradd no_madonna
-H:
-H: adds the new stream 'no_madonna' to the list of available streams.
-H: A given audio file is admissible for this stream iff its basename
-H: does not contain the string 'Madonna'.
----
-N: strdel
-P: AFS_READ | AFS_WRITE
-D: delete stream
-U: strdel s
-H: Remove stream s from database.
----
-N: streams
-P: AFS_READ
-D: list streams
-U: streams
-H: Print list of available streams. Use 'cs' to switch to any of
-H: these.
----
-N: strq
-P: AFS_READ
-D: query stream definition
-U: strq [s]
-H: Print definition of stream s to stdout. Use current stream if s was
-H: not given.
----
-N: summary
-P: AFS_READ
-D: list attributes
-U: summary
-H: Print a list of attributes together with number of audio
-H: files having that attribute set.
----
-N: upd
-P: AFS_READ | AFS_WRITE
-D: update database
-U: upd
-H: This command uses the --audio_file_dir option of para_server to
-H: locate your audio files. New files are then added to the mysql
-H: database. Use this command if you got new files or if you have
-H: moved some files around.
----
-N: us
-P: AFS_READ | AFS_WRITE
-D: update lastplayed time
-U: us name
-H: Update lastplayed time without actually playing the thing.
----
-N: verb
-P: AFS_READ | AFS_WRITE
-D: send verbatim sql query
-U: verb cmd
-H: Send cmd to mysql server. For expert/debugging only. Note that cmd
-H: usually must be escaped. Use only if you know what you are doing!
----
-N: vrfy
-P: AFS_READ
-D: list invalid entries in database
-U: vrfy
-H: Show what clean would delete. Run 'upd' before this command to make
-H: sure your database is up to date.
----
projects / paraslash.git / blobdiff