[AudioLink-cvs]audiolink/Documentation alfilldb_doc.html,NONE,1.1 alsearch_doc.html,NONE,1.1 audioli
Status: Alpha
Brought to you by:
amitshah
Menu
▾
▴
[AudioLink-cvs]audiolink/Documentation alfilldb_doc.html,NONE,1.1 alsearch_doc.html,NONE,1.1 audiolink_doc.html,NONE,1.1
|
From: <ami...@us...> - 2003-12-05 17:25:34
|
Update of /cvsroot/audiolink/audiolink/Documentation In directory sc8-pr-cvs1:/tmp/cvs-serv22740 Added Files: alfilldb_doc.html alsearch_doc.html audiolink_doc.html Log Message: documents --- NEW FILE: alfilldb_doc.html --- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <title>alfilldb - Add/update information of music files in the AudioLink database</title> <link rev="made" href="mailto:root@localhost" /> </head> <body style="background-color: white"> <table border="0" width="100%" cellspacing="0" cellpadding="3"> <tr><td class="block" style="background-color: #cccccc" valign="middle"> <big><strong><span class="block"> alfilldb - Add/update information of music files in the AudioLink database</span></strong></big> </td></tr> </table> <p><a name="__index__"></a></p> <!-- INDEX BEGIN --> <ul> <li><a href="#name">NAME</a></li> <li><a href="#synopsis">SYNOPSIS</a></li> <li><a href="#description">DESCRIPTION</a></li> <li><a href="#options">OPTIONS</a></li> <li><a href="#examples">EXAMPLES</a></li> <li><a href="#caveats">CAVEATS</a></li> <li><a href="#see_also">SEE ALSO</a></li> <li><a href="#bugs">BUGS</a></li> <li><a href="#author">AUTHOR</a></li> <li><a href="#copyright">COPYRIGHT</a></li> </ul> <!-- INDEX END --> <hr /> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="name">NAME</a></h1> <p>alfilldb - Add/update information of music files in the AudioLink database</p> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="synopsis">SYNOPSIS</a></h1> <p><strong>alfilldb</strong> [<em>OPTION</em>]... <em>/path/to/songs/</em>...</p> <p><strong>alfilldb</strong> [<em>OPTION</em>]... <em>--file=/path/to/song</em>...</p> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="description">DESCRIPTION</a></h1> <p>You can use this script to add or update information about your music files (MP3 or Ogg Vorbis) in the AudioLink database. This information will be used when you use the <em>alsearch(1)</em> program to search for particular music. This program is part of the <em>audiolink(1)</em> package.</p> <p>The path given for the location of individual files or directories must be an absolute path (paths with ~ are allowed). Relative paths are not allowed. See the <a href="#examples">examples</a> section for more information.</p> <p>The user and password options have to be specified to gain access to the database. See the ``<em>more information</em>'' section in the <em>audiolink(1)</em> man page for the various ways in which you can specify them.</p> <p>Options that are used repetitively during different invocations of the program (like the user, password options) may be put in the config file. See the <em>audiolink(1)</em> man page for details on the config file.</p> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="options">OPTIONS</a></h1> <dl> <dt><strong><a name="item__2d_2dadd_2donly"><strong>--add-only</strong></a></strong><br /> </dt> <dd> Only the information about new songs will be added to the database; information about existing songs will not be updated. </dd> <p></p> <dt><strong><a name="item__2d_2dfile_3dxxx"><strong>--file</strong>=<em>xxx</em></a></strong><br /> </dt> <dd> Works on just a single file instead of a directory. If this argument is given, the /path/to/dirs is not considered. (You can have more than one of these). </dd> <p></p> <dt><strong><a name="item__2d_2dhelp"><strong>--help</strong></a></strong><br /> </dt> <dd> Brief usage information </dd> <p></p> <dt><strong><a name="item__2d_2dhost_3dxxx"><strong>--host</strong>=<em>xxx</em></a></strong><br /> </dt> <dd> Connects to the MySQL server on the given host. Default is localhost. </dd> <p></p> <dt><strong><a name="item__2d_2dno_2dprompt"><strong>--no-prompt</strong></a></strong><br /> </dt> <dd> Don't prompt for anything. Songs which do not have information for mandatory fields (eg., song title) will not be added to the database. </dd> <p></p> <dt><strong><a name="item__2d_2dpass_3dxxx"><strong>--pass</strong>=<em>xxx</em></a></strong><br /> </dt> <dd> Password for accessing the database </dd> <p></p> <dt><strong><a name="item__2d_2dprompt_3dxxx"><strong>--prompt</strong>=<em>xxx</em></a></strong><br /> </dt> <dd> Prompt for input if there isn't enough information in the song (ID3 or Ogg Vorbis comments). </dd> <dd> <p>The parameters that prompt accepts are:</p> </dd> <dl> <dt><strong><a name="item_basic"><em>basic</em></a></strong><br /> </dt> <dd> Prompts just for the album name and the artist/band name </dd> <p></p> <dt><strong><a name="item_limited"><em>limited</em></a></strong><br /> </dt> <dd> Prompts for album, artist/band, genre and year fields </dd> <p></p> <dt><strong><a name="item_most"><em>most</em></a></strong><br /> </dt> <dd> Prompt for all the fields except the Male, Female Artists and the Track number </dd> <p></p> <dt><strong><a name="item_paranoid"><em>paranoid</em></a></strong><br /> </dt> <dd> Prompt for all the fields, including Male Artist (1/2), Female Artist (1/2), Track Number. </dd> <p></p></dl> <dt><strong><a name="item__2ds_2c__2d_2dna"><strong>-s</strong>, <strong>--na</strong></a></strong><br /> </dt> <dd> Simulate or no-act mode: doesn't update the database. </dd> <p></p> <dt><strong><a name="item__2d_2dupd_2donly"><strong>--upd-only</strong></a></strong><br /> </dt> <dd> Only entries in the database will be updated from the input the user gives. Make sure you don't use the --no-prompt option along with this one... else you won't get anything done! </dd> <p></p> <dt><strong><a name="item__2d_2dupd_2dsong"><strong>--upd-song</strong></a></strong><br /> </dt> <dd> Update the tags in the file, ie, ID3 for MP3, comments for Ogg Vorbis. </dd> <p></p> <dt><strong><a name="item__2d_2duser_3dxxx"><strong>--user</strong>=<em>xxx</em></a></strong><br /> </dt> <dd> Username for accessing the database </dd> <p></p> <dt><strong><a name="item__2d_2dverbose"><strong>--verbose</strong></a></strong><br /> </dt> <dd> Displays some extra information while processing files </dd> <p></p></dl> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="examples">EXAMPLES</a></h1> <dl> <dt><strong><a name="item_alfilldb__2d_2dadd_2donly__2fhome_2fuser_2ftmp_2fs"><code>alfilldb --add-only /home/user/tmp/songs/</code></a></strong><br /> </dt> <dd> This invocation will scan the /home/user/tmp/songs directory recursively for new songs only. Songs already existing in the database will not be considered. </dd> <p></p> <dt><strong><a name="item_alfilldb__2d_2dupd_2donly__2d_2dprompt_3dmost__7e_"><code>alfilldb --upd-only --prompt=most ~/tmp/songs/</code></a></strong><br /> </dt> <dd> This invocation will scan the $(HOME)/tmp/songs directory recursively for the current user for incomplete information in the database. </dd> <p></p> <dt><strong><a name="item_alfilldb__7euser_2ftmp_2fsongs_2f"><code>alfilldb ~user/tmp/songs/</code></a></strong><br /> </dt> <dd> This invocation will scan the /home/user/tmp/songs folder for music files; will add new entries to the database as well as update the existing ones. </dd> <p></p> <dt><strong><a name="item_alfilldb__2d_2dfile_3d_7e_2ftmp_2fsongs_2fsomefile"><code>alfilldb --file=~/tmp/songs/somefile.ogg --file=~/tmp/songs/otherfile.mp3</code></a></strong><br /> </dt> <dd> This invocation will just add (or update) information about the files $(HOME)/tmp/songs/somefile.ogg and $(HOME)/tmp/songs/otherfile.mp3. </dd> <p></p></dl> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="caveats">CAVEATS</a></h1> <p>If the <strong>--prompt</strong> option is not specified, <strong>alfilldb</strong> will just prompt for the title of the song being processed. The title information is asked only if the ID3 tag or the Vorbis comment doesn't contain the title. This behavior can be overriden by the --no-prompt option, and in this case, the entry for the file will not be made, since the song title is a mandatory field for storing song information in the datbase.</p> <p>If neither of <strong>--add-only</strong> or <strong>--upd-only</strong> are specified, the default action is to add new entries as well as update existing ones.</p> <p>If the ID3 tags or Vorbis comments for a file were updated after entries were made in the AudioLink database, they will not be reflected in the database. If you want to maintain consistency, it is advised that you keep the database updated (by using the <strong>--upd-only</strong> option) and then update the ID3 tag in the MP3 or the comment in the Ogg Vorbis file (by running <strong>alfilldb</strong> with the <strong>--upd-only</strong> option).</p> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="see_also">SEE ALSO</a></h1> <em><a href="audiolink_doc.html">audiolink(1)</a></em>, <em><a href="alsearch_doc.html">alsearch(1)</a></em><p>The current version of this man page is available on the AudioLink website at <<a href="http://audiolink.sourceforge.net/">http://audiolink.sourceforge.net/</a>>.</p> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="bugs">BUGS</a></h1> <p>Report bugs related to the AudioLink software or the man pages to the audiolink-devel mailing list <<a href="mailto:aud...@li...">aud...@li...</a>>.</p> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="author">AUTHOR</a></h1> <p>This manual page is written and maintained by Amit Shah <<a href="mailto:ami...@gm...">ami...@gm...</a>></p> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="copyright">COPYRIGHT</a></h1> <p>The AudioLink package is Copyright (C) 2003, Amit Shah <<a href="mailto:ami...@gm...">ami...@gm...</a>>. All the programs and the documentation that come as part of AudioLink are licensed by the GNU General Public License v2 (GPLv2).</p> <p><a href="#__index__"><small>Top</small></a></p> <table border="0" width="100%" cellspacing="0" cellpadding="3"> <tr><td class="block" style="background-color: #cccccc" valign="middle"> <big><strong><span class="block"> alfilldb - Add/update information of music files in the AudioLink database</span></strong></big> </td></tr> </table> </body> </html> --- NEW FILE: alsearch_doc.html --- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <title>alsearch - Search the AudioLink database for music</title> <link rev="made" href="mailto:root@localhost" /> </head> <body style="background-color: white"> <table border="0" width="100%" cellspacing="0" cellpadding="3"> <tr><td class="block" style="background-color: #cccccc" valign="middle"> <big><strong><span class="block"> alsearch - Search the AudioLink database for music</span></strong></big> </td></tr> </table> <p><a name="__index__"></a></p> <!-- INDEX BEGIN --> <ul> <li><a href="#name">NAME</a></li> <li><a href="#synopsis">SYNOPSIS</a></li> <li><a href="#description">DESCRIPTION</a></li> <li><a href="#options">OPTIONS</a></li> <li><a href="#search_options">SEARCH OPTIONS</a></li> <li><a href="#examples">EXAMPLES</a></li> <li><a href="#see_also">SEE ALSO</a></li> <li><a href="#bugs">BUGS</a></li> <li><a href="#author">AUTHOR</a></li> <li><a href="#copyright">COPYRIGHT</a></li> </ul> <!-- INDEX END --> <hr /> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="name">NAME</a></h1> <p>alsearch - Search the AudioLink database for music</p> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="synopsis">SYNOPSIS</a></h1> <p><strong>alsearch</strong> [<em>OPTION</em>]... <em>search_option</em>... <em>--td=/some/path/to/create/links/</em></p> <p><strong>alsearch</strong> [<em>OPTION</em>]... <em>search_option</em>... <em>-s</em></p> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="description">DESCRIPTION</a></h1> <p>You can use this script to search for songs in the AudioLink database. You can specify one or several options for the artist, composer, lyricist, album, etc., as the search criteria.</p> <p>You can specify several <em>search_option</em> options to search for particular music files. See the section on <a href="#search_options">search options</a> for the list of options.</p> <p>The search is not case sensitive. <strong>alsearch</strong> looks for strings as well as sub-strings in the fields being searched. See the <a href="#examples">examples</a> section for more information.</p> <p>Specifying the <strong>--td</strong> (target directory) option is mandatory for creating links to the actual files. This directory will contain the symbolic links to the actual audio files. The directory will be created if it doesn't exist.</p> <p>Creating symbolic links to the actual files is analogous to creating playlists in audio-playing software. Symbolic links are actually just point to the actual files on the hard disk. This way of creating and storing playlists is very useful in several ways, some of which are:</p> <ol> <li><strong><a name="item_compatible_across_various_audio_players">Compatible across various audio players</a></strong><br /> </li> Since the ``playlists'' are actually files represented on your hard disk, you can add whole directories generated by the <strong>alsearch</strong> program in the playlist of your audio software. If you switch to another music player for whatever reason, you still have your playlists. You don't have to bother about compatibility between the playlist formats of the two players. <p></p> <li><strong><a name="item_can_be_seen_and_operated_upon_in_a_file_browser">Can be seen and operated upon in a file browser</a></strong><br /> </li> As the symbolic links are present on a file-system, your playlist collection can be viewed by using normal file operations in the shell or using a GUI-based file browsing program. If the file browsing program is supports file traversals and symlinks, it'll show you the information of the actual song. <p></p></ol> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="options">OPTIONS</a></h1> <dl> <dt><strong><a name="item__2d_2dhelp"><strong>--help</strong></a></strong><br /> </dt> <dd> Brief usage information </dd> <p></p> <dt><strong><a name="item__2d_2dhost_3dxxx"><strong>--host</strong>=<em>xxx</em></a></strong><br /> </dt> <dd> Connects to the MySQL server on the target host. Default is localhost. </dd> <p></p> <dt><strong><a name="item__2d_2dpass_3dxxx"><strong>--pass</strong>=<em>xxx</em></a></strong><br /> </dt> <dd> Password for the database </dd> <p></p> <dt><strong><a name="item__2ds_2c__2d_2dna"><strong>-s</strong>, <strong>--na</strong></a></strong><br /> </dt> <dd> Just displays the search results, doesn't create links (simulation mode) </dd> <p></p> <dt><strong><a name="item__2d_2dtd_3dxxx"><strong>--td</strong>=<em>xxx</em></a></strong><br /> </dt> <dd> Target-directory in which to create links </dd> <p></p> <dt><strong><a name="item__2d_2duser_3dxxx"><strong>--user</strong>=<em>xxx</em></a></strong><br /> </dt> <dd> Username for the database </dd> <p></p> <dt><strong><a name="item__2dv_2c__2d_2dverbose"><strong>-v</strong>, --verbose</a></strong><br /> </dt> <dd> Displays some extra information. Useful for spotting errors and sending debug information. </dd> <p></p></dl> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="search_options">SEARCH OPTIONS</a></h1> <dl> <dt><strong><a name="item__2d_2dalbum_3dxxx"><strong>--album</strong>=<em>xxx</em></a></strong><br /> </dt> <dd> Search in the ``album'' field </dd> <p></p> <dt><strong><a name="item__2d_2dartist_3dxxx"><strong>--artist</strong>=<em>xxx</em></a></strong><br /> </dt> <dd> Search in the artist/band/performers fields. You can give this option multiple times, for example: </dd> <dd> <p><code>alsearch --artist=kishore --artist=asha --td=/songs/asha_kishore</code></p> </dd> <p></p> <dt><strong><a name="item__2d_2dcomment_3dxxx"><strong>--comment</strong>=<em>xxx</em></a></strong><br /> </dt> <dd> Search in the ``comment'' field </dd> <p></p> <dt><strong><a name="item__2dc_2c__2d_2dcomposer_3dxxx"><strong>-c</strong>, <strong>--composer</strong>=<em>xxx</em></a></strong><br /> </dt> <dd> Search in the ``composer'' field </dd> <p></p> <dt><strong><a name="item__2d_2dgenre_3dxxx"><strong>--genre</strong>=<em>xxx</em></a></strong><br /> </dt> <dd> Search in the ``genre'' field </dd> <p></p> <dt><strong><a name="item__2dl_2c__2d_2dlyricist_3dxxx"><strong>-l</strong>, <strong>--lyricist</strong>=<em>xxx</em></a></strong><br /> </dt> <dd> Search in the ``lyricist'' field </dd> <p></p> <dt><strong><a name="item__2d_2dtitle_3dxxx"><strong>--title</strong>=<em>xxx</em></a></strong><br /> </dt> <dd> Search in the ``title'' field </dd> <p></p></dl> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="examples">EXAMPLES</a></h1> <p>The options that take arguments can be specified in two ways:</p> <p><code>alsearch --artist="kishore kumar" --td=/songs/kishore</code></p> <p><code>alsearch --artist "kishore kumar" --td /songs/kishore</code></p> <p>That is, the option and the argument can be separated with a '<em> </em>' (space) or an '<em>=</em>' (equal) sign.</p> <p>In case you want to search for a string that has spaces, enclose the string in `` ''.</p> <p><code>alsearch --artist=kishore --composer=burman --lyricist=bakshi</code></p> <p>Will search for songs sung by *Kishore*, composed by *Burman* and written by *Bakshi*. Any name in the composer field which have ``burman'' in them will be matched. This means, it'll find songs composed by RD Burman, SD Burman, etc. This is true for all search fields.</p> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="see_also">SEE ALSO</a></h1> <em><a href="audiolink_doc.html">audiolink(1)</a></em>, <em><a href="alfilldb_doc.html">alfilldb(1)</a></em><p>The current version of this man page is available on the AudioLink website at <<a href="http://audiolink.sourceforge.net/">http://audiolink.sourceforge.net/</a>>.</p> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="bugs">BUGS</a></h1> <p>Report bugs related to the AudioLink software or the man pages to the audiolink-devel mailing list <<a href="mailto:aud...@li...">aud...@li...</a>>.</p> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="author">AUTHOR</a></h1> <p>This manual page is written and maintained by Amit Shah <<a href="mailto:ami...@gm...">ami...@gm...</a>></p> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="copyright">COPYRIGHT</a></h1> <p>The AudioLink package is Copyright (C) 2003, Amit Shah <<a href="mailto:ami...@gm...">ami...@gm...</a>>. All the programs and the documentation that come as part of AudioLink are licensed by the GNU General Public License v2 (GPLv2).</p> <p><a href="#__index__"><small>Top</small></a></p> <table border="0" width="100%" cellspacing="0" cellpadding="3"> <tr><td class="block" style="background-color: #cccccc" valign="middle"> <big><strong><span class="block"> alsearch - Search the AudioLink database for music</span></strong></big> </td></tr> </table> </body> </html> --- NEW FILE: audiolink_doc.html --- <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <title>audiolink - Create AudioLink config file, databases and tables</title> <link rev="made" href="mailto:root@localhost" /> </head> <body style="background-color: white"> <table border="0" width="100%" cellspacing="0" cellpadding="3"> <tr><td class="block" style="background-color: #cccccc" valign="middle"> <big><strong><span class="block"> audiolink - Create AudioLink config file, databases and tables</span></strong></big> </td></tr> </table> <p><a name="__index__"></a></p> <!-- INDEX BEGIN --> <ul> <li><a href="#name">NAME</a></li> <li><a href="#synopsis">SYNOPSIS</a></li> <li><a href="#description">DESCRIPTION</a></li> <li><a href="#options">OPTIONS</a></li> <li><a href="#more_information">MORE INFORMATION</a></li> <li><a href="#configuration_file">CONFIGURATION FILE</a></li> <li><a href="#see_also">SEE ALSO</a></li> <li><a href="#bugs">BUGS</a></li> <li><a href="#author">AUTHOR</a></li> <li><a href="#copyright">COPYRIGHT</a></li> </ul> <!-- INDEX END --> <hr /> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="name">NAME</a></h1> <p>audiolink - Create AudioLink config file, databases and tables</p> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="synopsis">SYNOPSIS</a></h1> <p>audiolink [<em>OPTION</em>]...</p> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="description">DESCRIPTION</a></h1> <p>AudioLink is a set of programs which help you manage your music collection. It makes searching for music on your local storage media easier and faster. Your searches can include a variety of criteria, like male artists, female artists, band, genre, etc.</p> <p>It supports music files of MP3 and Ogg Vorbis formats.</p> <p><strong>audiolink</strong> assists you in creating a configuration file for oft-used options passed to the AudioLink programs and creating the MySQL database and tables which the AudioLink programs, <em>alfilldb(1)</em> and <em>alsearch(1)</em> use.</p> <p>The options specified on the command prompt override the options specified in the config file.</p> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="options">OPTIONS</a></h1> <dl> <dt><strong><a name="item__2d_2dhelp"><strong>--help</strong></a></strong><br /> </dt> <dd> Brief usage information </dd> <p></p> <dt><strong><a name="item__2d_2dhost_3dxxx"><strong>--host</strong>=<em>xxx</em></a></strong><br /> </dt> <dd> Connects to the MySQL server on the target host. Default is localhost. </dd> <p></p> <dt><strong><a name="item__2d_2dpass_3dxxx"><strong>--pass</strong>=<em>xxx</em></a></strong><br /> </dt> <dd> Password for the database </dd> <p></p> <dt><strong><a name="item__2d_2duser_3dxxx"><strong>--user</strong>=<em>xxx</em></a></strong><br /> </dt> <dd> Username for the database </dd> <p></p> <dt><strong><a name="item__2d_2dverbose"><strong>--verbose</strong></a></strong><br /> </dt> <dd> Display extra information about what's going on </dd> <p></p></dl> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="more_information">MORE INFORMATION</a></h1> <p>The user and password fields for the database have to be specified. There are three ways of doing this:</p> <ol> <li><strong><a name="item_command_2dline_arguments">Command-line arguments</a></strong><br /> </li> By specifying them via the --user and --pass command-line arguments to the programs: <p><code>alfilldb --user=mysql_username --pass=mysql_password --prompt=basic /songs/</code></p> <p><code>alsearch --user=mysql_username --pass=mysql_password --artist=kishore --td=/songs/kishore</code></p> <p></p> <li><strong><a name="item_environment_variables">Environment variables</a></strong><br /> </li> Setting the DBI_USER and DBI_PASS environment variables: <p>If you are using bash, ksh, zsh or sh do this:</p> <p><code>export DBI_USER=mysql_username</code></p> <p><code>export DBI_PASS=mysql_password</code></p> <p>If you are using csh or tcsh, do this:</p> <p><code>setenv DBI_USER mysql_username</code></p> <p><code>setenv DBI_USER mysql_password</code></p> <p>Consult the man page of the respective shell interpreter that you use for help on environment variables.</p> <p></p> <li><strong><a name="item_config_file">Config file</a></strong><br /> </li> Specifying them in the config file (the most convenient). The config file is stored in each user's home directory in the <em>~/.audiolink/config</em> location. <p></p></ol> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="configuration_file">CONFIGURATION FILE</a></h1> <p>The AudioLink configuration file <em>config</em> resides in the <em>.audiolink/</em> directory in the user's home directory (<em>$HOME/.audiolink/config</em>).</p> <p>The format of the current config file is pretty easy to understand: Just put in <code>a = b</code> on separate lines for all the options you want the AudioLink scripts to use by default. Here, a is the option name, like user, password, host, etc., and b is the value you wish to associate the option with. For example, to set the username for accessing the database to 'root', you would put this in the config file:</p> <p><code>user = root</code></p> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="see_also">SEE ALSO</a></h1> <em><a href="alfilldb_doc.html">alfilldb(1)</a></em>, <em><a href="alsearch_doc.html">alsearch(1)</a></em><p>The current version of this man page is available on the AudioLink website at <<a href="http://audiolink.sourceforge.net/">http://audiolink.sourceforge.net/</a>>.</p> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="bugs">BUGS</a></h1> <p>Report bugs related to the AudioLink software or the man pages to the audiolink-devel mailing list <<a href="mailto:aud...@li...">aud...@li...</a>>.</p> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="author">AUTHOR</a></h1> <p>This manual page is written and maintained by Amit Shah <<a href="mailto:ami...@gm...">ami...@gm...</a>></p> <p> <a href="#__index__"><small>Top</small></a> </p> <hr /> <h1><a name="copyright">COPYRIGHT</a></h1> <p>The AudioLink package is Copyright (C) 2003, Amit Shah <<a href="mailto:ami...@gm...">ami...@gm...</a>>. All the programs and the documentation that come as part of AudioLink are licensed by the GNU General Public License v2 (GPLv2).</p> <p><a href="#__index__"><small>Top</small></a></p> <table border="0" width="100%" cellspacing="0" cellpadding="3"> <tr><td class="block" style="background-color: #cccccc" valign="middle"> <big><strong><span class="block"> audiolink - Create AudioLink config file, databases and tables</span></strong></big> </td></tr> </table> </body> </html> |
