/[svn]/web/trunk/www.linuxsampler.org/api/draft-linuxsampler-protocol.html

Diff of /web/trunk/www.linuxsampler.org/api/draft-linuxsampler-protocol.html

Parent Directory | Revision Log | View Patch Patch

-revision 1251 by schoenebeck,
Fri Jun 22 14:24:57 2007 UTC
+revision 1773 by iliev,
Wed Sep 10 15:14:31 2008 UTC
 Line 1
  <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
- <html lang="en"><head><title>LinuxSampler Control Protocol (draft)</title>
+ <html lang="en"><head><title>LinuxSampler Control Protocol</title>
  <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
- <meta name="description" content="LinuxSampler Control Protocol (draft)">
+ <meta name="description" content="LinuxSampler Control Protocol">
  <meta name="keywords" content="LSCP">
  <meta name="generator" content="xml2rfc v1.32 (http://xml.resource.org/)">
  <style type='text/css'><!--
 Line 145
  <tr><td class="header">LinuxSampler Developers</td><td class="header">C. Schoenebeck</td></tr>
  <tr><td class="header">Internet-Draft</td><td class="header">Interessengemeinschaft Software</td></tr>
  <tr><td class="header">Intended status: Standards Track</td><td class="header">Engineering e. V.</td></tr>
- <tr><td class="header">Expires: December 24, 2007</td><td class="header">June 22, 2007</td></tr>
+ <tr><td class="header">Expires: March 14, 2009</td><td class="header">September 10, 2008</td></tr>
  </table></td></tr></table>
- <h1><br />LinuxSampler Control Protocol (draft)<br />LSCP 1.2cvs</h1>
+ <h1><br />LinuxSampler Control Protocol<br />LSCP 1.4</h1>
  <h3>Status of this Memo</h3>
  <p>
 Line 173 
 The list of current Internet-Drafts can
  The list of Internet-Draft Shadow Directories can be accessed at
  <a href='http://www.ietf.org/shadow.html'>http://www.ietf.org/shadow.html</a>.</p>
  <p>
- This Internet-Draft will expire on December 24, 2007.</p>
+ This Internet-Draft will expire on March 14, 2009.</p>
  <h3>Copyright Notice</h3>
  <p>
- Copyright &copy; The IETF Trust (2007).</p>
+ Copyright &copy; The IETF Trust (2008).</p>
  <h3>Abstract</h3>
 Line 336 
 Altering effect send's audio routing<br
  Altering effect send's MIDI controller<br />
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET FX_SEND LEVEL">6.4.33.</a>&nbsp;
  Altering effect send's send level<br />
- &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#RESET CHANNEL">6.4.34.</a>&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SEND CHANNEL MIDI_DATA">6.4.34.</a>&nbsp;
+ Sending MIDI messages to sampler channel<br />
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#RESET CHANNEL">6.4.35.</a>&nbsp;
  Resetting a sampler channel<br />
  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#anchor12">6.5.</a>&nbsp;
  Controlling connection<br />
-Line 354 
 Global commands<br />
+Line 356 
 Global commands<br />
  Current number of active voices<br />
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET TOTAL_VOICE_COUNT_MAX">6.6.2.</a>&nbsp;
  Maximum amount of active voices<br />
- &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#RESET">6.6.3.</a>&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET TOTAL_STREAM_COUNT">6.6.3.</a>&nbsp;
+ Current number of active disk streams<br />
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#RESET">6.6.4.</a>&nbsp;
  Reset sampler<br />
- &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET SERVER INFO">6.6.4.</a>&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET SERVER INFO">6.6.5.</a>&nbsp;
  General sampler informations<br />
- &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET VOLUME">6.6.5.</a>&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET VOLUME">6.6.6.</a>&nbsp;
  Getting global volume attenuation<br />
- &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET VOLUME">6.6.6.</a>&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET VOLUME">6.6.7.</a>&nbsp;
  Setting global volume attenuation<br />
  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#MIDI Instrument Mapping">6.7.</a>&nbsp;
  MIDI Instrument Mapping<br />
- &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#ADD MIDI_INSTRUMENT MAP">6.7.1.</a>&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#ADD MIDI_INSTRUMENT_MAP">6.7.1.</a>&nbsp;
  Create a new MIDI instrument map<br />
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#REMOVE MIDI_INSTRUMENT_MAP">6.7.2.</a>&nbsp;
  Delete one particular or all MIDI instrument maps<br />
-Line 432 
 Changing the description of instrument<b
+Line 436 
 Changing the description of instrument<b
  Finding instruments<br />
  &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET DB_INSTRUMENTS_JOB INFO">6.8.21.</a>&nbsp;
  Getting job status information<br />
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#FORMAT INSTRUMENTS_DB">6.8.22.</a>&nbsp;
+ Formatting the instruments database<br />
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#FIND LOST DB_INSTRUMENT_FILES">6.8.23.</a>&nbsp;
+ Checking for lost instrument files<br />
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET DB_INSTRUMENT FILE_PATH">6.8.24.</a>&nbsp;
+ Replacing an instrument file<br />
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="#editing_instruments">6.9.</a>&nbsp;
+ Editing Instruments<br />
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#EDIT INSTRUMENT">6.9.1.</a>&nbsp;
+ Opening an appropriate instrument editor application<br />
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="#file_management">6.10.</a>&nbsp;
+ Managing Files<br />
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET FILE INSTRUMENTS">6.10.1.</a>&nbsp;
+ Retrieving amount of instruments of a file<br />
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#LIST FILE INSTRUMENTS">6.10.2.</a>&nbsp;
+ Retrieving all instruments of a file<br />
+ &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET FILE INSTRUMENT INFO">6.10.3.</a>&nbsp;
+ Retrieving informations about one instrument in a file<br />
  <a href="#command_syntax">7.</a>&nbsp;
  Command Syntax<br />
  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#character_set">7.1.</a>&nbsp;
-Line 448 
 Number of MIDI input devices changed<br
+Line 470 
 Number of MIDI input devices changed<br
  MIDI input device's settings changed<br />
  &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE CHANNEL_COUNT">8.5.</a>&nbsp;
  Number of sampler channels changed<br />
- &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE VOICE_COUNT">8.6.</a>&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE CHANNEL_MIDI">8.6.</a>&nbsp;
+ MIDI data on a sampler channel arrived<br />
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE DEVICE_MIDI">8.7.</a>&nbsp;
+ MIDI data on a MIDI input device arrived<br />
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE VOICE_COUNT">8.8.</a>&nbsp;
  Number of active voices changed<br />
- &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE STREAM_COUNT">8.7.</a>&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE STREAM_COUNT">8.9.</a>&nbsp;
  Number of active disk streams changed<br />
- &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE BUFFER_FILL">8.8.</a>&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE BUFFER_FILL">8.10.</a>&nbsp;
  Disk stream buffer fill state changed<br />
- &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE CHANNEL_INFO">8.9.</a>&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE CHANNEL_INFO">8.11.</a>&nbsp;
  Channel information changed<br />
- &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE FX_SEND_COUNT">8.10.</a>&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE FX_SEND_COUNT">8.12.</a>&nbsp;
  Number of effect sends changed<br />
- &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE FX_SEND_INFO">8.11.</a>&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE FX_SEND_INFO">8.13.</a>&nbsp;
  Effect send information changed<br />
- &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE TOTAL_VOICE_COUNT">8.12.</a>&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE TOTAL_VOICE_COUNT">8.14.</a>&nbsp;
  Total number of active voices changed<br />
- &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INSTRUMENT_MAP_COUNT">8.13.</a>&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE TOTAL_STREAM_COUNT">8.15.</a>&nbsp;
+ Total number of active disk streams changed<br />
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INSTRUMENT_MAP_COUNT">8.16.</a>&nbsp;
  Number of MIDI instrument maps changed<br />
- &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INSTRUMENT_MAP_INFO">8.14.</a>&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INSTRUMENT_MAP_INFO">8.17.</a>&nbsp;
  MIDI instrument map information changed<br />
- &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INSTRUMENT_COUNT">8.15.</a>&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INSTRUMENT_COUNT">8.18.</a>&nbsp;
  Number of MIDI instruments changed<br />
- &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INSTRUMENT_INFO">8.16.</a>&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MIDI_INSTRUMENT_INFO">8.19.</a>&nbsp;
  MIDI instrument information changed<br />
- &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE GLOBAL_INFO">8.17.</a>&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE GLOBAL_INFO">8.20.</a>&nbsp;
  Global settings changed<br />
- &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE DB_INSTRUMENT_DIRECTORY_COUNT">8.18.</a>&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE DB_INSTRUMENT_DIRECTORY_COUNT">8.21.</a>&nbsp;
  Number of database instrument directories changed<br />
- &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE DB_INSTRUMENT_DIRECTORY_INFO">8.19.</a>&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE DB_INSTRUMENT_DIRECTORY_INFO">8.22.</a>&nbsp;
  Database instrument directory information changed<br />
- &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE DB_INSTRUMENT_COUNT">8.20.</a>&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE DB_INSTRUMENT_COUNT">8.23.</a>&nbsp;
  Number of database instruments changed<br />
- &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE DB_INSTRUMENT_INFO">8.21.</a>&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE DB_INSTRUMENT_INFO">8.24.</a>&nbsp;
  Database instrument information changed<br />
- &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE DB_INSTRUMENTS_JOB_INFO">8.22.</a>&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE DB_INSTRUMENTS_JOB_INFO">8.25.</a>&nbsp;
  Database job status information changed<br />
- &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MISCELLANEOUS">8.23.</a>&nbsp;
+ &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE MISCELLANEOUS">8.26.</a>&nbsp;
  Miscellaneous and debugging events<br />
  <a href="#anchor14">9.</a>&nbsp;
  Security Considerations<br />
-Line 3301 
 Changing settings of MIDI input ports</h
+Line 3329 
 Changing settings of MIDI input ports</h
                      or <a class='info' href='#LIST MIDI_INPUT_DEVICES'>"LIST MIDI_INPUT_DEVICES"<span> (</span><span class='info'>Getting all created MIDI input device list</span><span>)</span></a>
                      command, &lt;port&gt; by the MIDI port number, &lt;key&gt; by the name of
                      the parameter to change and &lt;value&gt; by the new value for this
-                     parameter.
+                     parameter (encapsulated into apostrophes) or NONE (not encapsulated into apostrophes)
+                     for specifying no value for parameters allowing a list of values.
  </p>
  <p>Possible Answers:
  </p>
-Line 3342 
 Changing settings of MIDI input ports</h
+Line 3371 
 Changing settings of MIDI input ports</h
  <p>
                          </p>
  <blockquote class="text">
+ <p>C: "SET MIDI_INPUT_PORT_PARAMETER 0 0 ALSA_SEQ_BINDINGS='20:0'"
+ </p>
+ <p>S: "OK"
+ </p>
+ </blockquote><p>
+ </p>
  <p>
+                         </p>
+ <blockquote class="text">
+ <p>C: "SET MIDI_INPUT_PORT_PARAMETER 0 0 ALSA_SEQ_BINDINGS=NONE"
+ </p>
+ <p>S: "OK"
  </p>
  </blockquote><p>
-Line 3430 
 Loading an instrument</h3>
+Line 3471 
 Loading an instrument</h3>
  </blockquote><p>
  </p>
- <p>Example:
+ <p>Example (Unix):
  </p>
  <p>
                          </p>
  <blockquote class="text">
+ <p>C: LOAD INSTRUMENT '/home/joe/gigs/cello.gig' 0 0
+ </p>
+ <p>S: OK
+ </p>
+ </blockquote><p>
+ </p>
+ <p>Example (Windows):
+ </p>
  <p>
+                         </p>
+ <blockquote class="text">
+ <p>C: LOAD INSTRUMENT 'D:/MySounds/cello.gig' 0 0
+ </p>
+ <p>S: OK
  </p>
  </blockquote><p>
-Line 3850 
 Getting information about an engine</h3>
+Line 3905 
 Getting information about an engine</h3>
                                          </p>
  <blockquote class="text">
  <p>arbitrary description text about the engine
+                                             (note that the character string may contain
+                                             <a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>)
  </p>
  </blockquote>
-Line 3969 
 Getting sampler channel information</h3>
+Line 4026 
 Getting sampler channel information</h3>
  <blockquote class="text">
  <p>the file name of the loaded instrument, "NONE" if
                                              there's no instrument yet loaded for this sampler
-                                             channel
+                                             channel (note: since LSCP 1.2 this path may contain
+                                             <a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>)
  </p>
  </blockquote>
-Line 3986 
 Getting sampler channel information</h3>
+Line 4044 
 Getting sampler channel information</h3>
                                          </p>
  <blockquote class="text">
  <p>the instrument name of the loaded instrument
+                                             (note: since LSCP 1.2 this character string may contain
+                                             <a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>)
  </p>
  </blockquote>
-Line 5061 
 Adding an effect send to a sampler chann
+Line 5121 
 Adding an effect send to a sampler chann
                      sampler channel on which the effect send should be created on, &lt;midi-ctrl&gt;
                      is a number between 0..127 defining the MIDI controller which can alter the
                      effect send level and &lt;name&gt; is an optional argument defining a name
-                     for the effect send entity. The name does not have to be unique.
+                     for the effect send entity. The name does not have to be unique, but MUST be
+                     encapsulated into apostrophes and supports escape sequences as described in chapter
+                     "<a class='info' href='#character_set'>Character Set and Escape Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>".
  </p>
  <p>By default, that is as initial routing, the effect send's audio channels
                      are automatically routed to the last audio channels of the sampler channel's
-Line 5330 
 Getting effect send information</h3>
+Line 5392 
 Getting effect send information</h3>
                                          </p>
  <blockquote class="text">
  <p>name of the effect send entity
+                                             (note that this character string may contain
+                                              <a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>)
  </p>
  </blockquote>
-Line 5420 
 Changing effect send's name</h3>
+Line 5484 
 Changing effect send's name</h3>
                      as returned by the <a class='info' href='#CREATE FX_SEND'>"CREATE FX_SEND"<span> (</span><span class='info'>Adding an effect send to a sampler channel</span><span>)</span></a>
                      or <a class='info' href='#LIST FX_SENDS'>"LIST FX_SENDS"<span> (</span><span class='info'>Listing all effect sends on a sampler channel</span><span>)</span></a> command and
                      &lt;name&gt; is the new name of the effect send entity, which
-                     does not have to be unique.
+                     does not have to be unique (name MUST be encapsulated into apostrophes
+                     and supports escape sequences as described in chapter
+                     "<a class='info' href='#character_set'>Character Set and Escape Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>").
  </p>
  <p>Possible Answers:
  </p>
-Line 5684 
 Altering effect send's send level</h3>
+Line 5751 
 Altering effect send's send level</h3>
  </blockquote><p>
  </p>
- <a name="RESET CHANNEL"></a><br /><hr />
+ <a name="SEND CHANNEL MIDI_DATA"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
  <a name="rfc.section.6.4.34"></a><h3>6.4.34.&nbsp;
+ Sending MIDI messages to sampler channel</h3>
+ <p>The front-end can send MIDI events to specific sampler channel
+                     by sending the following command:
+ </p>
+ <p>
+                         </p>
+ <blockquote class="text">
+ <p>SEND CHANNEL MIDI_DATA &lt;midi-msg&gt; &lt;sampler-chan&gt; &lt;arg1&gt; &lt;arg2&gt;
+ </p>
+ </blockquote><p>
+ </p>
+ <p>Where &lt;sampler-chan&gt; is the sampler channel number
+                     as returned by the <a class='info' href='#ADD CHANNEL'>"ADD CHANNEL"<span> (</span><span class='info'>Adding a new sampler channel</span><span>)</span></a>
+                     or <a class='info' href='#LIST CHANNELS'>"LIST CHANNELS"<span> (</span><span class='info'>Getting all created sampler channel list</span><span>)</span></a> command,
+                     &lt;arg1&gt; and &lt;arg2&gt; arguments depend on the &lt;midi-msg&gt; argument, which
+                     specifies the MIDI message type. Currently, the following MIDI messages are supported:
+ </p>
+ <p>
+                         </p>
+ <blockquote class="text">
+ <p>"NOTE_ON" -
+                                 </p>
+ <blockquote class="text">
+ <p>For turning on MIDI notes, where &lt;arg1&gt;
+                                     specifies the key number and &lt;arg2&gt; the velocity
+                                     as described in the MIDI specification.
+ </p>
+ </blockquote>
+ <p>"NOTE_OFF" -
+                                 </p>
+ <blockquote class="text">
+ <p>For turning a currently playing MIDI note off, where &lt;arg1&gt;
+                                     specifies the key number and &lt;arg2&gt; the velocity
+                                     as described in the MIDI specification.
+ </p>
+ </blockquote>
+ </blockquote><p>
+ </p>
+ <p>CAUTION: This command is provided for implementations of virtual MIDI keyboards
+                     and no realtime guarantee whatsoever will be made!
+ </p>
+ <p>Possible Answers:
+ </p>
+ <p>
+                         </p>
+ <blockquote class="text">
+ <p>"OK" -
+                                 </p>
+ <blockquote class="text">
+ <p>on success
+ </p>
+ </blockquote>
+ <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
+                                 </p>
+ <blockquote class="text">
+ <p>in case it failed, providing an appropriate error code and error message
+ </p>
+ </blockquote>
+ </blockquote><p>
+ </p>
+ <p>Example:
+ </p>
+ <p>
+                         </p>
+ <blockquote class="text">
+ <p>C: "SEND CHANNEL MIDI_DATA NOTE_ON 0 56 112"
+ </p>
+ <p>S: "OK"
+ </p>
+ </blockquote><p>
+ </p>
+ <a name="RESET CHANNEL"></a><br /><hr />
+ <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
+ <a name="rfc.section.6.4.35"></a><h3>6.4.35.&nbsp;
  Resetting a sampler channel</h3>
  <p>The front-end can reset a particular sampler channel by sending the following command:
-Line 6021 
 Maximum amount of active voices</h3>
+Line 6175 
 Maximum amount of active voices</h3>
  </blockquote><p>
  </p>
- <a name="RESET"></a><br /><hr />
+ <a name="GET TOTAL_STREAM_COUNT"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
  <a name="rfc.section.6.6.3"></a><h3>6.6.3.&nbsp;
+ Current number of active disk streams</h3>
+ <p>The front-end can ask for the current number of active disk streams on
+                     the sampler by sending the following command:
+ </p>
+ <p>
+                         </p>
+ <blockquote class="text">
+ <p>GET TOTAL_STREAM_COUNT
+ </p>
+ </blockquote><p>
+ </p>
+ <p>Possible Answers:
+ </p>
+ <p>
+                         </p>
+ <blockquote class="text">
+ <p>LinuxSampler will answer by returning the number of all active
+                             disk streams on the sampler.
+ </p>
+ </blockquote><p>
+ </p>
+ <a name="RESET"></a><br /><hr />
+ <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
+ <a name="rfc.section.6.6.4"></a><h3>6.6.4.&nbsp;
  Reset sampler</h3>
  <p>The front-end can reset the whole sampler by sending the following command:
-Line 6064 
 Reset sampler</h3>
+Line 6245 
 Reset sampler</h3>
  </p>
  <a name="GET SERVER INFO"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
- <a name="rfc.section.6.6.4"></a><h3>6.6.4.&nbsp;
+ <a name="rfc.section.6.6.5"></a><h3>6.6.5.&nbsp;
  General sampler informations</h3>
  <p>The client can ask for general informations about the LinuxSampler
-Line 6097 
 General sampler informations</h3>
+Line 6278 
 General sampler informations</h3>
                                          </p>
  <blockquote class="text">
  <p>arbitrary textual description about the sampler
+                                             (note that the character string may contain
+                                             <a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>)
  </p>
  </blockquote>
-Line 6138 
 General sampler informations</h3>
+Line 6321 
 General sampler informations</h3>
  </p>
  <a name="GET VOLUME"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
- <a name="rfc.section.6.6.5"></a><h3>6.6.5.&nbsp;
+ <a name="rfc.section.6.6.6"></a><h3>6.6.6.&nbsp;
  Getting global volume attenuation</h3>
  <p>The client can ask for the current global sampler-wide volume
-Line 6171 
 Getting global volume attenuation</h3>
+Line 6354 
 Getting global volume attenuation</h3>
  </p>
  <a name="SET VOLUME"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
- <a name="rfc.section.6.6.6"></a><h3>6.6.6.&nbsp;
+ <a name="rfc.section.6.6.7"></a><h3>6.6.7.&nbsp;
  Setting global volume attenuation</h3>
  <p>The client can alter the current global sampler-wide volume
-Line 6258 
 MIDI Instrument Mapping</h3>
+Line 6441 
 MIDI Instrument Mapping</h3>
                  cause the sampler to switch to the respective instrument as
                  reflected by the current MIDI instrument map.
  </p>
- <a name="ADD MIDI_INSTRUMENT MAP"></a><br /><hr />
+ <a name="ADD MIDI_INSTRUMENT_MAP"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
  <a name="rfc.section.6.7.1"></a><h3>6.7.1.&nbsp;
  Create a new MIDI instrument map</h3>
-Line 6276 
 Create a new MIDI instrument map</h3>
+Line 6459 
 Create a new MIDI instrument map</h3>
  </p>
  <p>Where &lt;name&gt; is an optional argument allowing to
                      assign a custom name to the new map. MIDI instrument Map
-                     names do not have to be unique.
+                     names do not have to be unique, but MUST be encapsulated
+                     into apostrophes and support escape sequences as described
+                     in chapter "<a class='info' href='#character_set'>Character Set and Escape Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>".
  </p>
  <p>Possible Answers:
  </p>
-Line 6534 
 Getting MIDI instrument map information<
+Line 6720 
 Getting MIDI instrument map information<
  <blockquote class="text">
  <p>custom name of the given map,
                                              which does not have to be unique
+                                             (note that this character string may contain
+                                              <a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>)
  </p>
  </blockquote>
-Line 6589 
 Renaming a MIDI instrument map</h3>
+Line 6777 
 Renaming a MIDI instrument map</h3>
  </p>
  <p>Where &lt;map&gt; is the numerical ID of the map and
                      &lt;name&gt; the new custom name of the map, which does not
-                     have to be unique.
+                     have to be unique (name MUST be encapsulated into apostrophes
+                     and supports escape sequences as described in chapter
+                     "<a class='info' href='#character_set'>Character Set and Escape Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>").
  </p>
  <p>Possible Answers:
  </p>
-Line 6754 
 Create or replace a MIDI instrument map
+Line 6945 
 Create or replace a MIDI instrument map
                      load modes of entries, the frontend should retrieve the actual
                      mode by i.e. sending
                      <a class='info' href='#GET MIDI_INSTRUMENT INFO'>"GET MIDI_INSTRUMENT INFO"<span> (</span><span class='info'>Get current settings of MIDI instrument map entry</span><span>)</span></a>
-                     command(s). Finally the OPTIONAL &lt;name&gt; argument allows to
+                     command(s). Finally the OPTIONAL &lt;name&gt; argument allows to set a custom name
-                     set a custom name (encapsulated into apostrophes) for the mapping
+                     (encapsulated into apostrophes, supporting escape sequences as described in chapter
-                     entry, useful for frontends for displaying an appropriate name for
+                     "<a class='info' href='#character_set'>Character Set and Escape Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>") for the
+                     mapping entry, useful for frontends for displaying an appropriate name for
                      mapped instruments (using
                      <a class='info' href='#GET MIDI_INSTRUMENT INFO'>"GET MIDI_INSTRUMENT INFO"<span> (</span><span class='info'>Get current settings of MIDI instrument map entry</span><span>)</span></a>).
-Line 7078 
 Get current settings of MIDI instrument
+Line 7270 
 Get current settings of MIDI instrument
                                      changed with the
                                      <a class='info' href='#MAP MIDI_INSTRUMENT'>"MAP MIDI_INSTRUMENT"<span> (</span><span class='info'>Create or replace a MIDI instrument map entry</span><span>)</span></a>
                                      command and does not have to be unique.
+                                     (note that this character string may contain
+                                     <a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>)
  </p>
  </blockquote>
-Line 7094 
 Get current settings of MIDI instrument
+Line 7288 
 Get current settings of MIDI instrument
  <p>"INSTRUMENT_FILE" -
                                  </p>
  <blockquote class="text">
- <p>File name of the instrument.
+ <p>File name of the instrument
+                                     (note that this path may contain
+                                     <a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>).
  </p>
  </blockquote>
-Line 7112 
 Get current settings of MIDI instrument
+Line 7308 
 Get current settings of MIDI instrument
  <blockquote class="text">
  <p>Name of the loaded instrument as reflected by its file.
                                      In contrast to the "NAME" field, the "INSTRUMENT_NAME" field
-                                     cannot be changed.
+                                     cannot be changed (note that this character string may contain
+                                     <a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>).
  </p>
  </blockquote>
-Line 7247 
 Managing Instruments Database</h3>
+Line 7444 
 Managing Instruments Database</h3>
  <p>The following commands describe how to use and manage
                  the instruments database.
  </p>
+ <p>Notice:
+ </p>
+ <p>
+                         </p>
+ <blockquote class="text">
+ <p>All command arguments representing a path or
+                             instrument/directory name support escape sequences as described in chapter
+                             "<a class='info' href='#character_set'>Character Set and Escape Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>".
+ </p>
+ <p>All occurrences of a forward slash in instrument and directory
+                                names are escaped with its hex (\x2f) or octal (\057) escape sequence.
+ </p>
+ </blockquote><p>
+ </p>
  <a name="ADD DB_INSTRUMENT_DIRECTORY"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
  <a name="rfc.section.6.8.1"></a><h3>6.8.1.&nbsp;
-Line 7512 
 Getting instrument directory information
+Line 7726 
 Getting instrument directory information
  <p>DESCRIPTION -
                                          </p>
  <blockquote class="text">
- <p>A brief description of the directory content
+ <p>A brief description of the directory content.
+                                             Note that the character string may contain
+                                             <a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>.
  </p>
  </blockquote>
-Line 7757 
 Changing the description of directory</h
+Line 7973 
 Changing the description of directory</h
  </p>
  <p>Where &lt;dir&gt; is the absolute path name of the directory and
-                     &lt;desc&gt; is the new description for the directory.
+                     &lt;desc&gt; is the new description for the directory
+                     (encapsulated into apostrophes, supporting escape sequences as described in chapter
+                     "<a class='info' href='#character_set'>Character Set and Escape Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>").
  </p>
  <p>Possible Answers:
  </p>
-Line 7824 
 Finding directories</h3>
+Line 8042 
 Finding directories</h3>
                            </p>
  <blockquote class="text">
  <p>Restricts the search to directories, which names
-                               satisfy the supplied search string.
+                               satisfy the supplied search string (encapsulated into apostrophes,
+                               supporting escape sequences as described in chapter
+                               "<a class='info' href='#character_set'>Character Set and Escape Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>").
  </p>
  </blockquote><p>
-Line 7867 
 Finding directories</h3>
+Line 8087 
 Finding directories</h3>
                            </p>
  <blockquote class="text">
  <p>Restricts the search to directories with description
-                               that satisfies the supplied search string.
+                               that satisfies the supplied search string
+                               (encapsulated into apostrophes, supporting escape
+                               sequences as described in chapter
+                               "<a class='info' href='#character_set'>Character Set and Escape Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>").
  </p>
  </blockquote><p>
-Line 8248 
 Getting instrument information</h3>
+Line 8471 
 Getting instrument information</h3>
                                          </p>
  <blockquote class="text">
  <p>File name of the instrument.
+                                             Note that the character string may contain
+                                             <a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>.
  </p>
  </blockquote>
-Line 8307 
 Getting instrument information</h3>
+Line 8532 
 Getting instrument information</h3>
  <p>DESCRIPTION -
                                          </p>
  <blockquote class="text">
- <p>A brief description of the instrument
+ <p>A brief description of the instrument.
+                                             Note that the character string may contain
+                                             <a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>.
  </p>
  </blockquote>
-Line 8324 
 Getting instrument information</h3>
+Line 8551 
 Getting instrument information</h3>
  <p>PRODUCT -
                                          </p>
  <blockquote class="text">
- <p>The product title of the instrument
+ <p>The product title of the instrument.
+                                             Note that the character string may contain
+                                             <a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>.
  </p>
  </blockquote>
-Line 8332 
 Getting instrument information</h3>
+Line 8561 
 Getting instrument information</h3>
  <p>ARTISTS -
                                          </p>
  <blockquote class="text">
- <p>Lists the artist names
+ <p>Lists the artist names.
+                                             Note that the character string may contain
+                                             <a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>.
  </p>
  </blockquote>
-Line 8342 
 Getting instrument information</h3>
+Line 8573 
 Getting instrument information</h3>
  <blockquote class="text">
  <p>Provides a list of keywords that refer to the instrument.
                                              Keywords are separated with semicolon and blank.
+                                             Note that the character string may contain
+                                             <a class='info' href='#character_set'>escape sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>.
  </p>
  </blockquote>
-Line 8582 
 Changing the description of instrument</
+Line 8815 
 Changing the description of instrument</
  </p>
  <p>Where &lt;instr&gt; is the absolute path name of the instrument and
-                     &lt;desc&gt; is the new description for the instrument.
+                     &lt;desc&gt; is the new description for the instrument
+                     (encapsulated into apostrophes, supporting escape sequences as described in chapter
+                     "<a class='info' href='#character_set'>Character Set and Escape Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>").
  </p>
  <p>Possible Answers:
  </p>
-Line 8649 
 Finding instruments</h3>
+Line 8884 
 Finding instruments</h3>
                            </p>
  <blockquote class="text">
  <p>Restricts the search to instruments, which names
-                               satisfy the supplied search string.
+                               satisfy the supplied search string (encapsulated into apostrophes,
+                               supporting escape sequences as described in chapter
+                               "<a class='info' href='#character_set'>Character Set and Escape Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>").
  </p>
  </blockquote><p>
-Line 8707 
 Finding instruments</h3>
+Line 8944 
 Finding instruments</h3>
                            </p>
  <blockquote class="text">
  <p>Restricts the search to instruments with description
-                               that satisfies the supplied search string.
+                               that satisfies the supplied search string (encapsulated into apostrophes,
+                               supporting escape sequences as described in chapter
+                               "<a class='info' href='#character_set'>Character Set and Escape Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>").
  </p>
  </blockquote><p>
-Line 8718 
 Finding instruments</h3>
+Line 8957 
 Finding instruments</h3>
                            </p>
  <blockquote class="text">
  <p>Restricts the search to instruments with product info
-                               that satisfies the supplied search string.
+                               that satisfies the supplied search string (encapsulated into apostrophes,
+                               supporting escape sequences as described in chapter
+                               "<a class='info' href='#character_set'>Character Set and Escape Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>").
  </p>
  </blockquote><p>
-Line 8729 
 Finding instruments</h3>
+Line 8970 
 Finding instruments</h3>
                            </p>
  <blockquote class="text">
  <p>Restricts the search to instruments with artists info
-                               that satisfies the supplied search string.
+                               that satisfies the supplied search string (encapsulated into apostrophes,
+                               supporting escape sequences as described in chapter
+                               "<a class='info' href='#character_set'>Character Set and Escape Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>").
  </p>
  </blockquote><p>
-Line 8740 
 Finding instruments</h3>
+Line 8983 
 Finding instruments</h3>
                            </p>
  <blockquote class="text">
  <p>Restricts the search to instruments with keyword list
-                               that satisfies the supplied search string.
+                               that satisfies the supplied search string (encapsulated into apostrophes,
+                               supporting escape sequences as described in chapter
+                               "<a class='info' href='#character_set'>Character Set and Escape Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>").
  </p>
  </blockquote><p>
-Line 8910 
 Getting job status information</h3>
+Line 9155 
 Getting job status information</h3>
  </blockquote><p>
  </p>
+ <a name="FORMAT INSTRUMENTS_DB"></a><br /><hr />
+ <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
+ <a name="rfc.section.6.8.22"></a><h3>6.8.22.&nbsp;
+ Formatting the instruments database</h3>
+ <p>The front-end can remove all instruments and directories and re-create
+                     the instruments database structure (e.g., in case of a database corruption)
+                     by sending the following command:
+ </p>
+ <p>
+                         </p>
+ <blockquote class="text">
+ <p>FORMAT INSTRUMENTS_DB
+ </p>
+ </blockquote><p>
+ </p>
+ <p>Possible Answers:
+ </p>
+ <p>
+                         </p>
+ <blockquote class="text">
+ <p>"OK" -
+                                 </p>
+ <blockquote class="text">
+ <p>on success
+ </p>
+ </blockquote>
+ <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
+                                 </p>
+ <blockquote class="text">
+ <p>If the formatting of the instruments database
+                                     failed.
+ </p>
+ </blockquote>
+ </blockquote><p>
+ </p>
+ <a name="FIND LOST DB_INSTRUMENT_FILES"></a><br /><hr />
+ <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
+ <a name="rfc.section.6.8.23"></a><h3>6.8.23.&nbsp;
+ Checking for lost instrument files</h3>
+ <p>The front-end can retrieve the list of all instrument files in the instruments database
+                     that don't exist in the filesystem by sending the following command:
+ </p>
+ <p>
+                         </p>
+ <blockquote class="text">
+ <p>FIND LOST DB_INSTRUMENT_FILES
+ </p>
+ </blockquote><p>
+ </p>
+ <p>Possible Answers:
+ </p>
+ <p>
+                         </p>
+ <blockquote class="text">
+ <p>A comma separated list with the absolute path names
+                             (encapsulated into apostrophes) of all lost instrument files.
+ </p>
+ <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
+                                 </p>
+ <blockquote class="text">
+ <p>in case it failed, providing an appropriate error code and error message.
+ </p>
+ </blockquote>
+ </blockquote><p>
+ </p>
+ <p>Example:
+ </p>
+ <p>
+                         </p>
+ <blockquote class="text">
+ <p>C: "FIND LOST DB_INSTRUMENT_FILES"
+ </p>
+ <p>S: "'/gigs/Bosendorfer 290.gig','/gigs/Steinway D.gig','/gigs/Free Piano.gig'"
+ </p>
+ </blockquote><p>
+ </p>
+ <a name="SET DB_INSTRUMENT FILE_PATH"></a><br /><hr />
+ <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
+ <a name="rfc.section.6.8.24"></a><h3>6.8.24.&nbsp;
+ Replacing an instrument file</h3>
+ <p>The front-end can substitute all occurrences of an instrument file
+                     in the instruments database with a new one by sending the following command:
+ </p>
+ <p>
+                         </p>
+ <blockquote class="text">
+ <p>SET DB_INSTRUMENT FILE_PATH &lt;old_path&gt; &lt;new_path&gt;
+ </p>
+ </blockquote><p>
+ </p>
+ <p>Where &lt;old_path&gt; is the absolute path name of the instrument file
+                     to substitute with &lt;new_path&gt;.
+ </p>
+ <p>Possible Answers:
+ </p>
+ <p>
+                         </p>
+ <blockquote class="text">
+ <p>"OK" -
+                                 </p>
+ <blockquote class="text">
+ <p>on success
+ </p>
+ </blockquote>
+ <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
+                                 </p>
+ <blockquote class="text">
+ <p>in case it failed, providing an appropriate error code and error message.
+ </p>
+ </blockquote>
+ </blockquote><p>
+ </p>
+ <p>Example:
+ </p>
+ <p>
+                         </p>
+ <blockquote class="text">
+ <p>C: "SET DB_INSTRUMENT FILE_PATH '/gigs/Bosendorfer 290.gig' '/gigs/pianos/Bosendorfer 290.gig'"
+ </p>
+ <p>S: "OK"
+ </p>
+ </blockquote><p>
+ </p>
+ <a name="editing_instruments"></a><br /><hr />
+ <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
+ <a name="rfc.section.6.9"></a><h3>6.9.&nbsp;
+ Editing Instruments</h3>
+ <p>The sampler allows to edit instruments while playing with the
+                 sampler by spawning an external (3rd party) instrument editor
+                 application for a given instrument. The 3rd party instrument
+                 editor applications have to place a respective plugin DLL file
+                 into the sampler's plugins directory. The sampler will
+                 automatically try to load all plugin DLLs in that directory on
+                 startup and only on startup!
+ </p>
+ <p>At the moment there is only one command for this feature set,
+                 but this will most probably change in future.
+ </p>
+ <a name="EDIT INSTRUMENT"></a><br /><hr />
+ <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
+ <a name="rfc.section.6.9.1"></a><h3>6.9.1.&nbsp;
+ Opening an appropriate instrument editor application</h3>
+ <p>The front-end can request to open an appropriate instrument
+                     editor application by sending the following command:
+ </p>
+ <p>
+                         </p>
+ <blockquote class="text">
+ <p>EDIT CHANNEL INSTRUMENT &lt;sampler-channel&gt;
+ </p>
+ </blockquote><p>
+ </p>
+ <p>Where &lt;sampler-channel&gt; should be replaced by the
+                     number of the sampler channel as given by the
+                     <a class='info' href='#ADD CHANNEL'>"ADD CHANNEL"<span> (</span><span class='info'>Adding a new sampler channel</span><span>)</span></a>
+                     or <a class='info' href='#LIST CHANNELS'>"LIST CHANNELS"<span> (</span><span class='info'>Getting all created sampler channel list</span><span>)</span></a>
+                     command.
+ </p>
+ <p>The sampler will try to ask all registered instrument
+                     editors (or to be more specific: their sampler plugins)
+                     whether they are capable to handle the instrument on the
+                     given sampler channel. The sampler will simply use the first
+                     instrument editor application which replied with a positive
+                     answer and spawn that instrument editor application within
+                     the sampler's process and provide that application access
+                     to the instrument's data structures, so both applications
+                     can share and access the same instruments data at the same
+                     time, thus allowing to immediately hear changes with the
+                     sampler made by the instrument editor.
+ </p>
+ <p>Note: consequently instrument editors are always spawned
+                     locally on the same machine where the sampler is running
+                     on!
+ </p>
+ <p>Possible Answers:
+ </p>
+ <p>
+                         </p>
+ <blockquote class="text">
+ <p>"OK" -
+                                 </p>
+ <blockquote class="text">
+ <p>when an appropriate instrument editor was
+                                     launched
+ </p>
+ </blockquote>
+ <p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
+                                 </p>
+ <blockquote class="text">
+ <p>when an appropriate instrument editor was
+                                     launched, but there are noteworthy issues
+ </p>
+ </blockquote>
+ <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
+                                 </p>
+ <blockquote class="text">
+ <p>when an appropriate instrument editor
+                                     could not be launched
+ </p>
+ </blockquote>
+ </blockquote><p>
+ </p>
+ <p>Examples:
+ </p>
+ <p>
+                         </p>
+ <blockquote class="text">
+ <p>C: "EDIT CHANNEL INSTRUMENT 0"
+ </p>
+ <p>S: "OK"
+ </p>
+ </blockquote><p>
+ </p>
+ <a name="file_management"></a><br /><hr />
+ <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
+ <a name="rfc.section.6.10"></a><h3>6.10.&nbsp;
+ Managing Files</h3>
+ <p>You can query detailed informations about files located
+                 at the same system where the sampler instance is running on.
+                 Using this command set allows to retrieve file informations
+                 even remotely from another machine.
+ </p>
+ <a name="GET FILE INSTRUMENTS"></a><br /><hr />
+ <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
+ <a name="rfc.section.6.10.1"></a><h3>6.10.1.&nbsp;
+ Retrieving amount of instruments of a file</h3>
+ <p>The front-end can retrieve the amount of instruments
+                     within a given instrument file by sending the
+                     following command:
+ </p>
+ <p>
+                         </p>
+ <blockquote class="text">
+ <p>GET FILE INSTRUMENTS &lt;filename&gt;
+ </p>
+ </blockquote><p>
+ </p>
+ <p>Where &lt;filename&gt; is the name of the instrument
+                     file (encapsulated into apostrophes, supporting escape
+                     sequences as described in chapter
+                     "<a class='info' href='#character_set'>Character Set and Escape
+                         Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>").
+ </p>
+ <p>The sampler will try to ask all sampler engines,
+                     whether they support the given file and ask the first
+                     engine with a positive answer for the amount of
+                     instruments.
+ </p>
+ <p>Possible Answers:
+ </p>
+ <p>
+                         </p>
+ <blockquote class="text">
+ <p>On success, the sampler will answer by
+                                returning the amount of instruments.
+ </p>
+ <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
+                                 </p>
+ <blockquote class="text">
+ <p>if the file could not be handled
+ </p>
+ </blockquote>
+ </blockquote><p>
+ </p>
+ <p>Examples:
+ </p>
+ <p>
+                         </p>
+ <blockquote class="text">
+ <p>C: "GET FILE INSTRUMENTS 'D:/Sounds/Foo.gig'"
+ </p>
+ <p>S: "10"
+ </p>
+ </blockquote><p>
+ </p>
+ <a name="LIST FILE INSTRUMENTS"></a><br /><hr />
+ <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
+ <a name="rfc.section.6.10.2"></a><h3>6.10.2.&nbsp;
+ Retrieving all instruments of a file</h3>
+ <p>The front-end can retrieve a list of all instruments
+                     within a given instrument file by sending the
+                     following command:
+ </p>
+ <p>
+                         </p>
+ <blockquote class="text">
+ <p>LIST FILE INSTRUMENTS &lt;filename&gt;
+ </p>
+ </blockquote><p>
+ </p>
+ <p>Where &lt;filename&gt; is the name of the instrument
+                     file (encapsulated into apostrophes, supporting escape
+                     sequences as described in chapter
+                     "<a class='info' href='#character_set'>Character Set and Escape
+                         Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>").
+ </p>
+ <p>The sampler will try to ask all sampler engines,
+                     whether they support the given file and ask the first
+                     engine with a positive answer for a list of IDs for the
+                     instruments in the given file.
+ </p>
+ <p>Possible Answers:
+ </p>
+ <p>
+                         </p>
+ <blockquote class="text">
+ <p>On success, the sampler will answer by
+                                returning a comma separated list of
+                                instrument IDs.
+ </p>
+ <p>"ERR:&lt;error-code&gt;:&lt;error-message&gt;" -
+                                 </p>
+ <blockquote class="text">
+ <p>if the file could not be handled
+ </p>
+ </blockquote>
+ </blockquote><p>
+ </p>
+ <p>Examples:
+ </p>
+ <p>
+                         </p>
+ <blockquote class="text">
+ <p>C: "LIST FILE INSTRUMENTS 'D:/Sounds/Foo.gig'"
+ </p>
+ <p>S: "0,1,2,3,4,5,6,7,8,9"
+ </p>
+ </blockquote><p>
+ </p>
+ <a name="GET FILE INSTRUMENT INFO"></a><br /><hr />
+ <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
+ <a name="rfc.section.6.10.3"></a><h3>6.10.3.&nbsp;
+ Retrieving informations about one instrument in a file</h3>
+ <p>The front-end can retrieve detailed informations
+                     about a specific instrument within a given instrument
+                     file by sending the following command:
+ </p>
+ <p>
+                         </p>
+ <blockquote class="text">
+ <p>GET FILE INSTRUMENT INFO &lt;filename&gt;
+                             &lt;instr-id&gt;
+ </p>
+ </blockquote><p>
+ </p>
+ <p>Where &lt;filename&gt; is the name of the instrument
+                     file (encapsulated into apostrophes, supporting escape
+                     sequences as described in chapter
+                     "<a class='info' href='#character_set'>Character Set and Escape
+                         Sequences<span> (</span><span class='info'>Character Set and Escape Sequences</span><span>)</span></a>") and &lt;instr-id&gt; is the numeric
+                     instrument ID as returned by the
+                     <a class='info' href='#LIST FILE INSTRUMENTS'>"LIST FILE INSTRUMENTS"<span> (</span><span class='info'>Retrieving all instruments of a file</span><span>)</span></a> command.
+ </p>
+ <p>The sampler will try to ask all sampler engines,
+                     whether they support the given file and ask the first
+                     engine with a positive answer for informations about the
+                     specific instrument in the given file.
+ </p>
+ <p>Possible Answers:
+ </p>
+ <p>
+                         </p>
+ <blockquote class="text">
+ <p>LinuxSampler will answer by sending a &lt;CRLF&gt; separated list.
+                             Each answer line begins with the settings category name
+                             followed by a colon and then a space character &lt;SP&gt; and finally
+                             the info character string to that setting category. At the
+                             moment the following categories are defined:
+ </p>
+ <p>
+                                 </p>
+ <blockquote class="text">
+ <p>NAME -
+                                         </p>
+ <blockquote class="text">
+ <p>name of the instrument as
+                                             stored in the instrument file
+ </p>
+ </blockquote>
+ <p>FORMAT_FAMILY -
+                                         </p>
+ <blockquote class="text">
+ <p>name of the sampler format
+                                             of the given instrument
+ </p>
+ </blockquote>
+ <p>FORMAT_VERSION -
+                                         </p>
+ <blockquote class="text">
+ <p>version of the sampler format
+                                             the instrumen is stored as
+ </p>
+ </blockquote>
+ <p>PRODUCT -
+                                         </p>
+ <blockquote class="text">
+ <p>official product name of the
+                                             instrument as stored in the file
+ </p>
+ </blockquote>
+ <p>ARTISTS -
+                                         </p>
+ <blockquote class="text">
+ <p>artists / sample library
+                                             vendor of the instrument
+ </p>
+ </blockquote>
+ <p>KEY_BINDINGS -
+                                         </p>
+ <blockquote class="text">
+ <p>comma separated list of integer values representing
+                                                the instrument's key mapping in the range between 0 .. 127,
+                                                reflecting the analog meaning of the MIDI specification.
+ </p>
+ </blockquote>
+ <p>KEYSWITCH_BINDINGS -
+                                         </p>
+ <blockquote class="text">
+ <p>comma separated list of integer values representing
+                                                the instrument's keyswitch mapping in the range between 0 .. 127,
+                                                reflecting the analog meaning of the MIDI specification.
+ </p>
+ </blockquote>
+ </blockquote>
+ </blockquote><p>
+ </p>
+ <p>The mentioned fields above don't have to be in particular order.
+ </p>
+ <p>Example:
+ </p>
+ <p>
+                         </p>
+ <blockquote class="text">
+ <p>C: "GET FILE INSTRUMENT INFO 'D:/Sounds/Foo.gig' 0"
+ </p>
+ <p>S: "NAME: Lunatic Loops"
+ </p>
+ <p>&nbsp;&nbsp;&nbsp;"FORMAT_FAMILY: GIG"
+ </p>
+ <p>&nbsp;&nbsp;&nbsp;"FORMAT_VERSION: 3"
+ </p>
+ <p>&nbsp;&nbsp;&nbsp;"PRODUCT: The Backbone Bongo Beats"
+ </p>
+ <p>&nbsp;&nbsp;&nbsp;"ARTISTS: Jimmy the Fish"
+ </p>
+ <p>&nbsp;&nbsp;&nbsp;"."
+ </p>
+ </blockquote><p>
+ </p>
  <a name="command_syntax"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
  <a name="rfc.section.7"></a><h3>7.&nbsp;
-Line 9028 
 Command Syntax</h3>
+Line 9790 
 Command Syntax</h3>
  <p>/ EDIT SP edit_instruction
  </p>
+ <p>/ FORMAT SP format_instruction
+ </p>
+ <p>SEND SP send_instruction
+ </p>
  <p>/ RESET
  </p>
-Line 9043 
 Command Syntax</h3>
+Line 9811 
 Command Syntax</h3>
  <p>CHANNEL
  </p>
- <p>/ DB_INSTRUMENT_DIRECTORY SP pathname
+ <p>/ DB_INSTRUMENT_DIRECTORY SP db_path
  </p>
- <p>/ DB_INSTRUMENTS SP NON_MODAL SP scan_mode SP pathname SP pathname
+ <p>/ DB_INSTRUMENTS SP NON_MODAL SP scan_mode SP db_path SP filename
  </p>
- <p>/ DB_INSTRUMENTS SP scan_mode SP pathname SP pathname
+ <p>/ DB_INSTRUMENTS SP scan_mode SP db_path SP filename
  </p>
- <p>/ DB_INSTRUMENTS SP NON_MODAL SP pathname SP pathname
+ <p>/ DB_INSTRUMENTS SP NON_MODAL SP db_path SP filename
  </p>
- <p>/ DB_INSTRUMENTS SP NON_MODAL SP pathname SP pathname SP instrument_index
+ <p>/ DB_INSTRUMENTS SP NON_MODAL SP db_path SP filename SP instrument_index
  </p>
- <p>/ DB_INSTRUMENTS SP pathname SP pathname
+ <p>/ DB_INSTRUMENTS SP db_path SP filename
  </p>
- <p>/ DB_INSTRUMENTS SP pathname SP pathname SP instrument_index
+ <p>/ DB_INSTRUMENTS SP db_path SP filename SP instrument_index
  </p>
  <p>/ MIDI_INSTRUMENT_MAP
-Line 9091 
 Command Syntax</h3>
+Line 9859 
 Command Syntax</h3>
  <p>/ CHANNEL_COUNT
  </p>
+ <p>/ CHANNEL_MIDI
+ </p>
+ <p>/ DEVICE_MIDI
+ </p>
  <p>/ VOICE_COUNT
  </p>
-Line 9139 
 Command Syntax</h3>
+Line 9913 
 Command Syntax</h3>
  <p>/ MISCELLANEOUS
  </p>
+ <p>/ TOTAL_STREAM_COUNT
+ </p>
  <p>/ TOTAL_VOICE_COUNT
  </p>
-Line 9166 
 Command Syntax</h3>
+Line 9943 
 Command Syntax</h3>
  <p>/ CHANNEL_COUNT
  </p>
+ <p>/ CHANNEL_MIDI
+ </p>
+ <p>/ DEVICE_MIDI
+ </p>
  <p>/ VOICE_COUNT
  </p>
-Line 9214 
 Command Syntax</h3>
+Line 9997 
 Command Syntax</h3>
  <p>/ MISCELLANEOUS
  </p>
+ <p>/ TOTAL_STREAM_COUNT
+ </p>
  <p>/ TOTAL_VOICE_COUNT
  </p>
-Line 9262 
 Command Syntax</h3>
+Line 10048 
 Command Syntax</h3>
  <p>/ MIDI_INSTRUMENT_MAP SP ALL
  </p>
- <p>/ DB_INSTRUMENT_DIRECTORY SP FORCE SP pathname
+ <p>/ DB_INSTRUMENT_DIRECTORY SP FORCE SP db_path
  </p>
- <p>/ DB_INSTRUMENT_DIRECTORY SP pathname
+ <p>/ DB_INSTRUMENT_DIRECTORY SP db_path
  </p>
- <p>/ DB_INSTRUMENT SP pathname
+ <p>/ DB_INSTRUMENT SP db_path
  </p>
  </blockquote><p>
-Line 9349 
 Command Syntax</h3>
+Line 10135 
 Command Syntax</h3>
  <p>/ SERVER SP INFO
  </p>
+ <p>/ TOTAL_STREAM_COUNT
+ </p>
  <p>/ TOTAL_VOICE_COUNT
  </p>
-Line 9376 
 Command Syntax</h3>
+Line 10165 
 Command Syntax</h3>
  <p>/ FX_SEND SP INFO SP sampler_channel SP fx_send_id
  </p>
- <p>/ DB_INSTRUMENT_DIRECTORIES SP RECURSIVE SP pathname
+ <p>/ DB_INSTRUMENT_DIRECTORIES SP RECURSIVE SP db_path
  </p>
- <p>/ DB_INSTRUMENT_DIRECTORIES SP pathname
+ <p>/ DB_INSTRUMENT_DIRECTORIES SP db_path
  </p>
- <p>/ DB_INSTRUMENT_DIRECTORY SP INFO SP pathname
+ <p>/ DB_INSTRUMENT_DIRECTORY SP INFO SP db_path
  </p>
- <p>/ DB_INSTRUMENTS SP RECURSIVE SP pathname
+ <p>/ DB_INSTRUMENTS SP RECURSIVE SP db_path
  </p>
- <p>/ DB_INSTRUMENTS SP pathname
+ <p>/ DB_INSTRUMENTS SP db_path
  </p>
- <p>/ DB_INSTRUMENT SP INFO SP pathname
+ <p>/ DB_INSTRUMENT SP INFO SP db_path
  </p>
  <p>/ DB_INSTRUMENTS_JOB SP INFO SP number
-Line 9400 
 Command Syntax</h3>
+Line 10189 
 Command Syntax</h3>
  <p>/ VOLUME
  </p>
+ <p>/ FILE SP INSTRUMENTS SP filename
+ </p>
+ <p>/ FILE SP INSTRUMENT SP INFO SP filename SP instrument_index
+ </p>
  </blockquote><p>
  </p>
-Line 9415 
 Command Syntax</h3>
+Line 10210 
 Command Syntax</h3>
  <p>/ MIDI_INPUT_DEVICE_PARAMETER SP number SP string '=' param_val_list
  </p>
+ <p>/ MIDI_INPUT_PORT_PARAMETER SP number SP number SP string '=' NONE
+ </p>
  <p>/ MIDI_INPUT_PORT_PARAMETER SP number SP number SP string '=' param_val_list
  </p>
-Line 9436 
 Command Syntax</h3>
+Line 10234 
 Command Syntax</h3>
  <p>/ FX_SEND SP LEVEL SP sampler_channel SP fx_send_id SP volume_value
  </p>
- <p>/ DB_INSTRUMENT_DIRECTORY SP NAME SP pathname SP dirname
+ <p>/ DB_INSTRUMENT_DIRECTORY SP NAME SP db_path SP stringval_escaped
+ </p>
+ <p>/ DB_INSTRUMENT_DIRECTORY SP DESCRIPTION SP db_path SP stringval_escaped
  </p>
- <p>/ DB_INSTRUMENT_DIRECTORY SP DESCRIPTION SP pathname SP stringval
+ <p>/ DB_INSTRUMENT SP NAME SP db_path SP stringval_escaped
  </p>
- <p>/ DB_INSTRUMENT SP NAME SP pathname SP dirname
+ <p>/ DB_INSTRUMENT SP DESCRIPTION SP db_path SP stringval_escaped
  </p>
- <p>/ DB_INSTRUMENT SP DESCRIPTION SP pathname SP stringval
+ <p>/ DB_INSTRUMENT SP FILE_PATH SP filename SP filename
  </p>
  <p>/ ECHO SP boolean
-Line 9505 
 Command Syntax</h3>
+Line 10306 
 Command Syntax</h3>
  <p>find_instruction =
          </p>
  <blockquote class="text">
- <p>DB_INSTRUMENTS SP NON_RECURSIVE SP pathname SP query_val_list
+ <p>DB_INSTRUMENTS SP NON_RECURSIVE SP db_path SP query_val_list
+ </p>
+ <p>/ DB_INSTRUMENTS SP db_path SP query_val_list
  </p>
- <p>/ DB_INSTRUMENTS SP pathname SP query_val_list
+ <p>/ DB_INSTRUMENT_DIRECTORIES SP NON_RECURSIVE SP db_path SP query_val_list
  </p>
- <p>/ DB_INSTRUMENT_DIRECTORIES SP NON_RECURSIVE SP pathname SP query_val_list
+ <p>/ DB_INSTRUMENT_DIRECTORIES SP db_path SP query_val_list
  </p>
- <p>/ DB_INSTRUMENT_DIRECTORIES SP pathname SP query_val_list
+ <p>/ LOST SP DB_INSTRUMENT_FILES
  </p>
  </blockquote><p>
-Line 9523 
 Command Syntax</h3>
+Line 10327 
 Command Syntax</h3>
  <p>move_instruction =
          </p>
  <blockquote class="text">
- <p>DB_INSTRUMENT_DIRECTORY SP pathname SP pathname
+ <p>DB_INSTRUMENT_DIRECTORY SP db_path SP db_path
  </p>
- <p>/ DB_INSTRUMENT SP pathname SP pathname
+ <p>/ DB_INSTRUMENT SP db_path SP db_path
  </p>
  </blockquote><p>
-Line 9535 
 Command Syntax</h3>
+Line 10339 
 Command Syntax</h3>
  <p>copy_instruction =
          </p>
  <blockquote class="text">
- <p>DB_INSTRUMENT_DIRECTORY SP pathname SP pathname
+ <p>DB_INSTRUMENT_DIRECTORY SP db_path SP db_path
  </p>
- <p>/ DB_INSTRUMENT SP pathname SP pathname
+ <p>/ DB_INSTRUMENT SP db_path SP db_path
  </p>
  </blockquote><p>
-Line 9622 
 Command Syntax</h3>
+Line 10426 
 Command Syntax</h3>
  <p>edit_instruction =
          </p>
  <blockquote class="text">
- <p>INSTRUMENT SP sampler_channel
+ <p>CHANNEL SP INSTRUMENT SP sampler_channel
+ </p>
+ </blockquote><p>
+ </p>
+ <p>format_instruction =
+         </p>
+ <blockquote class="text">
+ <p>INSTRUMENTS_DB
  </p>
  </blockquote><p>
-Line 9697 
 Command Syntax</h3>
+Line 10510 
 Command Syntax</h3>
  <p>/ FX_SENDS SP sampler_channel
  </p>
- <p>/ DB_INSTRUMENT_DIRECTORIES SP RECURSIVE SP pathname
+ <p>/ DB_INSTRUMENT_DIRECTORIES SP RECURSIVE SP db_path
+ </p>
+ <p>/ DB_INSTRUMENT_DIRECTORIES SP db_path
+ </p>
+ <p>/ DB_INSTRUMENTS SP RECURSIVE SP db_path
  </p>
- <p>/ DB_INSTRUMENT_DIRECTORIES SP pathname
+ <p>/ DB_INSTRUMENTS SP db_path
  </p>
- <p>/ DB_INSTRUMENTS SP RECURSIVE SP pathname
+ <p>/ FILE SP INSTRUMENTS SP filename
  </p>
- <p>/ DB_INSTRUMENTS SP pathname
+ </blockquote><p>
+ </p>
+ <p>send_instruction =
+         </p>
+ <blockquote class="text">
+ <p>CHANNEL SP MIDI_DATA SP string SP sampler_channel SP number SP number
  </p>
  </blockquote><p>
-Line 9889 
 Command Syntax</h3>
+Line 10714 
 Command Syntax</h3>
  </blockquote><p>
  </p>
- <p>pathname =
+ <p>filename =
-         </p>
- <blockquote class="text">
- <p>stringval
- </p>
- </blockquote><p>
- </p>
- <p>dirname =
          </p>
  <blockquote class="text">
- <p>stringval
+ <p>path
  </p>
  </blockquote><p>
  </p>
- <p>filename =
+ <p>db_path =
          </p>
  <blockquote class="text">
- <p>stringval_escaped
+ <p>path
  </p>
  </blockquote><p>
-Line 9919 
 Command Syntax</h3>
+Line 10735 
 Command Syntax</h3>
  <p>map_name =
          </p>
  <blockquote class="text">
- <p>stringval
+ <p>stringval_escaped
  </p>
  </blockquote><p>
-Line 9928 
 Command Syntax</h3>
+Line 10744 
 Command Syntax</h3>
  <p>entry_name =
          </p>
  <blockquote class="text">
- <p>stringval
+ <p>stringval_escaped
  </p>
  </blockquote><p>
-Line 9937 
 Command Syntax</h3>
+Line 10753 
 Command Syntax</h3>
  <p>fx_send_name =
          </p>
  <blockquote class="text">
- <p>stringval
+ <p>stringval_escaped
  </p>
  </blockquote><p>
-Line 9988 
 Command Syntax</h3>
+Line 10804 
 Command Syntax</h3>
  <p>query_val =
          </p>
  <blockquote class="text">
- <p>string
+ <p>text_escaped
  </p>
- <p>/ stringval
+ <p>/ stringval_escaped
  </p>
  </blockquote><p>
-Line 10078 
 Character Set and Escape Sequences</h3>
+Line 10894 
 Character Set and Escape Sequences</h3>
                  MUST be escaped as well (that is as double backslash), whereas
                  in the old versions a single backslash was sufficient.
  </p>
+ <p>The following LSCP commands support escape sequences as part
+                 of their filename / path based arguments and / or may contain
+                 a filename / path with escape sequences in their response:
+                 </p>
+ <blockquote class="text">
+ <p><a class='info' href='#LOAD INSTRUMENT'>"LOAD INSTRUMENT"<span> (</span><span class='info'>Loading an instrument</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#GET CHANNEL INFO'>"GET CHANNEL INFO"<span> (</span><span class='info'>Getting sampler channel information</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#MAP MIDI_INSTRUMENT'>"MAP MIDI_INSTRUMENT"<span> (</span><span class='info'>Create or replace a MIDI instrument map entry</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#GET MIDI_INSTRUMENT INFO'>"GET MIDI_INSTRUMENT INFO"<span> (</span><span class='info'>Get current settings of MIDI instrument map entry</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#ADD DB_INSTRUMENT_DIRECTORY'>"ADD DB_INSTRUMENT_DIRECTORY"<span> (</span><span class='info'>Creating a new instrument directory</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#ADD DB_INSTRUMENTS'>"ADD DB_INSTRUMENTS"<span> (</span><span class='info'>Adding instruments to the instruments database</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#REMOVE DB_INSTRUMENT_DIRECTORY'>"REMOVE DB_INSTRUMENT_DIRECTORY"<span> (</span><span class='info'>Deleting an instrument directory</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#REMOVE DB_INSTRUMENT'>"REMOVE DB_INSTRUMENT"<span> (</span><span class='info'>Removing an instrument</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#GET DB_INSTRUMENT_DIRECTORIES'>"GET DB_INSTRUMENT_DIRECTORIES"<span> (</span><span class='info'>Getting amount of instrument directories</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#LIST DB_INSTRUMENT_DIRECTORIES'>"LIST DB_INSTRUMENT_DIRECTORIES"<span> (</span><span class='info'>Listing all directories in specific directory</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#GET DB_INSTRUMENT_DIRECTORY INFO'>"GET DB_INSTRUMENT_DIRECTORY INFO"<span> (</span><span class='info'>Getting instrument directory information</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#GET DB_INSTRUMENTS'>"GET DB_INSTRUMENTS"<span> (</span><span class='info'>Getting amount of instruments</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#LIST DB_INSTRUMENTS'>"LIST DB_INSTRUMENTS"<span> (</span><span class='info'>Listing all instruments in specific directory</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#GET DB_INSTRUMENT INFO'>"GET DB_INSTRUMENT INFO"<span> (</span><span class='info'>Getting instrument information</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#SET DB_INSTRUMENT_DIRECTORY NAME'>"SET DB_INSTRUMENT_DIRECTORY NAME"<span> (</span><span class='info'>Renaming an instrument directory</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#SET DB_INSTRUMENT_DIRECTORY DESCRIPTION'>"SET DB_INSTRUMENT_DIRECTORY DESCRIPTION"<span> (</span><span class='info'>Changing the description of directory</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#SET DB_INSTRUMENT NAME'>"SET DB_INSTRUMENT NAME"<span> (</span><span class='info'>Renaming an instrument</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#SET DB_INSTRUMENT DESCRIPTION'>"SET DB_INSTRUMENT DESCRIPTION"<span> (</span><span class='info'>Changing the description of instrument</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#FIND DB_INSTRUMENTS'>"FIND DB_INSTRUMENTS"<span> (</span><span class='info'>Finding instruments</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#FIND DB_INSTRUMENT_DIRECTORIES'>"FIND DB_INSTRUMENT_DIRECTORIES"<span> (</span><span class='info'>Finding directories</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#MOVE DB_INSTRUMENT'>"MOVE DB_INSTRUMENT"<span> (</span><span class='info'>Moving an instrument</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#MOVE DB_INSTRUMENT_DIRECTORY'>"MOVE DB_INSTRUMENT_DIRECTORY"<span> (</span><span class='info'>Moving an instrument directory</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#COPY DB_INSTRUMENT'>"COPY DB_INSTRUMENT"<span> (</span><span class='info'>Copying instruments</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#COPY DB_INSTRUMENT_DIRECTORY'>"COPY DB_INSTRUMENT_DIRECTORY"<span> (</span><span class='info'>Copying instrument directories</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#FIND LOST DB_INSTRUMENT_FILES'>"FIND LOST DB_INSTRUMENT_FILES"<span> (</span><span class='info'>Checking for lost instrument files</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#SET DB_INSTRUMENT FILE_PATH'>"SET DB_INSTRUMENT FILE_PATH"<span> (</span><span class='info'>Replacing an instrument file</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#GET FILE INSTRUMENTS'>"GET FILE INSTRUMENTS"<span> (</span><span class='info'>Retrieving amount of instruments of a file</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#LIST FILE INSTRUMENTS'>"LIST FILE INSTRUMENTS"<span> (</span><span class='info'>Retrieving all instruments of a file</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#GET FILE INSTRUMENT INFO'>"GET FILE INSTRUMENT INFO"<span> (</span><span class='info'>Retrieving informations about one instrument in a file</span><span>)</span></a>
+ </p>
+ </blockquote><p>
+                 Note that the forward slash character ('/') has a special meaning in
+                 filename / path based arguments: it acts as separator of the nodes in
+                 the path, thus if a directory- or filename includes a forward slash
+                 (not intended as path node separator), you MUST escape that slash
+                 either with the respective hex escape sequence ("\x2f") or with the
+                 respective octal escape sequence ("\057").
+ </p>
+ <p>
+                 Note for Windows: file path arguments in LSCP are expected
+                 to use forward slashes as directory node separator similar
+                 to Unix based operating systems. In contrast to Unix however
+                 a Windows typical drive character is expected to be
+                 prefixed to the path. That is an original Windows file path
+                 like "D:\Sounds\My.gig" would become in LSCP:
+                 "D:/Sounds/My.gig".
+ </p>
+ <p>
+                 The following LSCP commands even support escape sequences as
+                 part of at least one of their text-based arguments (i.e. entity name,
+                 description) and / or may contain escape sequences in at least one of
+                 their text-based fields in their response:
+                 </p>
+ <blockquote class="text">
+ <p><a class='info' href='#GET SERVER INFO'>"GET SERVER INFO"<span> (</span><span class='info'>General sampler informations</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#GET ENGINE INFO'>"GET ENGINE INFO"<span> (</span><span class='info'>Getting information about an engine</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#GET CHANNEL INFO'>"GET CHANNEL INFO"<span> (</span><span class='info'>Getting sampler channel information</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#CREATE FX_SEND'>"CREATE FX_SEND"<span> (</span><span class='info'>Adding an effect send to a sampler channel</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#GET FX_SEND INFO'>"GET FX_SEND INFO"<span> (</span><span class='info'>Getting effect send information</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#SET FX_SEND NAME'>"SET FX_SEND NAME"<span> (</span><span class='info'>Changing effect send's name</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#GET MIDI_INSTRUMENT INFO'>"GET MIDI_INSTRUMENT INFO"<span> (</span><span class='info'>Get current settings of MIDI instrument map entry</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#GET MIDI_INSTRUMENT_MAP INFO'>"GET MIDI_INSTRUMENT_MAP INFO"<span> (</span><span class='info'>Getting MIDI instrument map information</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#ADD MIDI_INSTRUMENT_MAP'>"ADD MIDI_INSTRUMENT_MAP"<span> (</span><span class='info'>Create a new MIDI instrument map</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#MAP MIDI_INSTRUMENT'>"MAP MIDI_INSTRUMENT"<span> (</span><span class='info'>Create or replace a MIDI instrument map entry</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#SET MIDI_INSTRUMENT_MAP NAME'>"SET MIDI_INSTRUMENT_MAP NAME"<span> (</span><span class='info'>Renaming a MIDI instrument map</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#GET DB_INSTRUMENT_DIRECTORY INFO'>"GET DB_INSTRUMENT_DIRECTORY INFO"<span> (</span><span class='info'>Getting instrument directory information</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#SET DB_INSTRUMENT_DIRECTORY NAME'>"SET DB_INSTRUMENT_DIRECTORY NAME"<span> (</span><span class='info'>Renaming an instrument directory</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#SET DB_INSTRUMENT_DIRECTORY DESCRIPTION'>"SET DB_INSTRUMENT_DIRECTORY DESCRIPTION"<span> (</span><span class='info'>Changing the description of directory</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#FIND DB_INSTRUMENT_DIRECTORIES'>"FIND DB_INSTRUMENT_DIRECTORIES"<span> (</span><span class='info'>Finding directories</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#GET DB_INSTRUMENT INFO'>"GET DB_INSTRUMENT INFO"<span> (</span><span class='info'>Getting instrument information</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#SET DB_INSTRUMENT NAME'>"SET DB_INSTRUMENT NAME"<span> (</span><span class='info'>Renaming an instrument</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#SET DB_INSTRUMENT DESCRIPTION'>"SET DB_INSTRUMENT DESCRIPTION"<span> (</span><span class='info'>Changing the description of instrument</span><span>)</span></a>
+ </p>
+ <p><a class='info' href='#FIND DB_INSTRUMENTS'>"FIND DB_INSTRUMENTS"<span> (</span><span class='info'>Finding instruments</span><span>)</span></a>
+ </p>
+ </blockquote><p>
+                 Please note that these lists are manually maintained. If you
+                 find a command that also supports escape sequences we forgot to
+                 mention here, please report it!
+ </p>
  <a name="events"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
  <a name="rfc.section.8"></a><h3>8.&nbsp;
-Line 10238 
 Number of sampler channels changed</h3>
+Line 11187 
 Number of sampler channels changed</h3>
  <p>where &lt;channels&gt; will be replaced by the new number
                  of sampler channels.
  </p>
- <a name="SUBSCRIBE VOICE_COUNT"></a><br /><hr />
+ <a name="SUBSCRIBE CHANNEL_MIDI"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
  <a name="rfc.section.8.6"></a><h3>8.6.&nbsp;
+ MIDI data on a sampler channel arrived</h3>
+ <p>Client may want to be notified when MIDI data arrive on sampler channels on
+                 back-end side, by issuing the following command:
+ </p>
+ <p>
+                     </p>
+ <blockquote class="text">
+ <p>SUBSCRIBE CHANNEL_MIDI
+ </p>
+ </blockquote><p>
+ </p>
+ <p>Server will start sending one of the the following notification messages:
+ </p>
+ <p>
+                     </p>
+ <blockquote class="text">
+ <p>"NOTIFY:CHANNEL_MIDI:&lt;channel-id&gt; NOTE_ON  &lt;note&gt; &lt;velocity&gt;"
+ </p>
+ <p>"NOTIFY:CHANNEL_MIDI:&lt;channel-id&gt; NOTE_OFF &lt;note&gt; &lt;velocity&gt;"
+ </p>
+ </blockquote><p>
+ </p>
+ <p>where &lt;channel-id&gt; will be replaced by the ID of the sampler channel where the MIDI
+                 data arrived. &lt;note&gt; and &lt;velocity&gt; are integer values in the range between
+.. 127, reflecting the analog meaning of the MIDI specification.
+ </p>
+ <p>CAUTION: no guarantee whatsoever will be made that MIDI events are actually all
+                 delivered by this mechanism! With other words: events could be lost at any time!
+                 This restriction was made to keep the RT-safeness of the backend's MIDI and audio
+                 thread unaffected by this feature.
+ </p>
+ <a name="SUBSCRIBE DEVICE_MIDI"></a><br /><hr />
+ <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
+ <a name="rfc.section.8.7"></a><h3>8.7.&nbsp;
+ MIDI data on a MIDI input device arrived</h3>
+ <p>Client may want to be notified when MIDI data arrive on MIDI input devices by issuing the following command:
+ </p>
+ <p>
+                             </p>
+ <blockquote class="text">
+ <p>SUBSCRIBE DEVICE_MIDI
+ </p>
+ </blockquote><p>
+ </p>
+ <p>Server will start sending one of the the following notification messages:
+ </p>
+ <p>
+                             </p>
+ <blockquote class="text">
+ <p>"NOTIFY:DEVICE_MIDI:&lt;device-id&gt; &lt;port-id&gt; NOTE_ON &lt;note&gt; &lt;velocity&gt;"
+ </p>
+ <p>"NOTIFY:DEVICE_MIDI:&lt;device-id&gt; &lt;port-id&gt; NOTE_OFF &lt;note&gt; &lt;velocity&gt;"
+ </p>
+ </blockquote><p>
+ </p>
+ <p>where &lt;device-id&gt; &lt;port-id&gt; will be replaced
+                        by the IDs of the respective MIDI input device and the device's MIDI port where the MIDI
+                        data arrived. &lt;note&gt; and &lt;velocity&gt; are integer values in the range between
+.. 127, reflecting the analog meaning of the MIDI specification.
+ </p>
+ <p>CAUTION: no guarantee whatsoever will be made that MIDI events are actually all
+                        delivered by this mechanism! With other words: events could be lost at any time!
+                        This restriction was made to keep the RT-safeness of the backend's MIDI and audio
+                        thread unaffected by this feature.
+ </p>
+ <a name="SUBSCRIBE VOICE_COUNT"></a><br /><hr />
+ <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
+ <a name="rfc.section.8.8"></a><h3>8.8.&nbsp;
  Number of active voices changed</h3>
  <p>Client may want to be notified when the number of voices on the
-Line 10270 
 Number of active voices changed</h3>
+Line 11295 
 Number of active voices changed</h3>
  </p>
  <a name="SUBSCRIBE STREAM_COUNT"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
- <a name="rfc.section.8.7"></a><h3>8.7.&nbsp;
+ <a name="rfc.section.8.9"></a><h3>8.9.&nbsp;
  Number of active disk streams changed</h3>
  <p>Client may want to be notified when the number of streams on the back-end
-Line 10300 
 Number of active disk streams changed</h
+Line 11325 
 Number of active disk streams changed</h
  </p>
  <a name="SUBSCRIBE BUFFER_FILL"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
- <a name="rfc.section.8.8"></a><h3>8.8.&nbsp;
+ <a name="rfc.section.8.10"></a><h3>8.10.&nbsp;
  Disk stream buffer fill state changed</h3>
  <p>Client may want to be notified when the buffer fill state of a disk stream
-Line 10331 
 Disk stream buffer fill state changed</h
+Line 11356 
 Disk stream buffer fill state changed</h
  </p>
  <a name="SUBSCRIBE CHANNEL_INFO"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
- <a name="rfc.section.8.9"></a><h3>8.9.&nbsp;
+ <a name="rfc.section.8.11"></a><h3>8.11.&nbsp;
  Channel information changed</h3>
  <p>Client may want to be notified when changes were made to sampler channels on the
-Line 10364 
 Channel information changed</h3>
+Line 11389 
 Channel information changed</h3>
  </p>
  <a name="SUBSCRIBE FX_SEND_COUNT"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
- <a name="rfc.section.8.10"></a><h3>8.10.&nbsp;
+ <a name="rfc.section.8.12"></a><h3>8.12.&nbsp;
  Number of effect sends changed</h3>
  <p>Client may want to be notified when the number of effect sends on
-Line 10394 
 Number of effect sends changed</h3>
+Line 11419 
 Number of effect sends changed</h3>
  </p>
  <a name="SUBSCRIBE FX_SEND_INFO"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
- <a name="rfc.section.8.11"></a><h3>8.11.&nbsp;
+ <a name="rfc.section.8.13"></a><h3>8.13.&nbsp;
  Effect send information changed</h3>
  <p>Client may want to be notified when changes were made to effect sends on a
-Line 10424 
 Effect send information changed</h3>
+Line 11449 
 Effect send information changed</h3>
  </p>
  <a name="SUBSCRIBE TOTAL_VOICE_COUNT"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
- <a name="rfc.section.8.12"></a><h3>8.12.&nbsp;
+ <a name="rfc.section.8.14"></a><h3>8.14.&nbsp;
  Total number of active voices changed</h3>
  <p>Client may want to be notified when the total number of voices on the
-Line 10451 
 Total number of active voices changed</h
+Line 11476 
 Total number of active voices changed</h
  <p>where &lt;voices&gt; will be replaced by the new number of
                  all currently active voices.
  </p>
+ <a name="SUBSCRIBE TOTAL_STREAM_COUNT"></a><br /><hr />
+ <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
+ <a name="rfc.section.8.15"></a><h3>8.15.&nbsp;
+ Total number of active disk streams changed</h3>
+ <p>Client may want to be notified when the total number of disk streams on the
+                 back-end changes by issuing the following command:
+ </p>
+ <p>
+                     </p>
+ <blockquote class="text">
+ <p>SUBSCRIBE TOTAL_STREAM_COUNT
+ </p>
+ </blockquote><p>
+ </p>
+ <p>Server will start sending the following notification messages:
+ </p>
+ <p>
+                     </p>
+ <blockquote class="text">
+ <p>"NOTIFY:TOTAL_STREAM_COUNT:&lt;streams&gt;"
+ </p>
+ </blockquote><p>
+ </p>
+ <p>where &lt;streams&gt; will be replaced by the new number of
+                 all currently active disk streams.
+ </p>
  <a name="SUBSCRIBE MIDI_INSTRUMENT_MAP_COUNT"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
- <a name="rfc.section.8.13"></a><h3>8.13.&nbsp;
+ <a name="rfc.section.8.16"></a><h3>8.16.&nbsp;
  Number of MIDI instrument maps changed</h3>
  <p>Client may want to be notified when the number of MIDI instrument maps on the
-Line 10482 
 Number of MIDI instrument maps changed</
+Line 11536 
 Number of MIDI instrument maps changed</
  </p>
  <a name="SUBSCRIBE MIDI_INSTRUMENT_MAP_INFO"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
- <a name="rfc.section.8.14"></a><h3>8.14.&nbsp;
+ <a name="rfc.section.8.17"></a><h3>8.17.&nbsp;
  MIDI instrument map information changed</h3>
  <p>Client may want to be notified when changes were made to MIDI instrument maps on the
-Line 10515 
 MIDI instrument map information changed<
+Line 11569 
 MIDI instrument map information changed<
  </p>
  <a name="SUBSCRIBE MIDI_INSTRUMENT_COUNT"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
- <a name="rfc.section.8.15"></a><h3>8.15.&nbsp;
+ <a name="rfc.section.8.18"></a><h3>8.18.&nbsp;
  Number of MIDI instruments changed</h3>
  <p>Client may want to be notified when the number of MIDI instrument maps on the
-Line 10545 
 Number of MIDI instruments changed</h3>
+Line 11599 
 Number of MIDI instruments changed</h3>
  </p>
  <a name="SUBSCRIBE MIDI_INSTRUMENT_INFO"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
- <a name="rfc.section.8.16"></a><h3>8.16.&nbsp;
+ <a name="rfc.section.8.19"></a><h3>8.19.&nbsp;
  MIDI instrument information changed</h3>
  <p>Client may want to be notified when changes were made to MIDI instruments on the
-Line 10579 
 MIDI instrument information changed</h3>
+Line 11633 
 MIDI instrument information changed</h3>
  </p>
  <a name="SUBSCRIBE GLOBAL_INFO"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
- <a name="rfc.section.8.17"></a><h3>8.17.&nbsp;
+ <a name="rfc.section.8.20"></a><h3>8.20.&nbsp;
  Global settings changed</h3>
  <p>Client may want to be notified when changes to the global settings
-Line 10608 
 Global settings changed</h3>
+Line 11662 
 Global settings changed</h3>
  </p>
  <a name="SUBSCRIBE DB_INSTRUMENT_DIRECTORY_COUNT"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
- <a name="rfc.section.8.18"></a><h3>8.18.&nbsp;
+ <a name="rfc.section.8.21"></a><h3>8.21.&nbsp;
  Number of database instrument directories changed</h3>
  <p>Client may want to be notified when the number of instrument
-Line 10642 
 Number of database instrument directorie
+Line 11696 
 Number of database instrument directorie
  </p>
  <a name="SUBSCRIBE DB_INSTRUMENT_DIRECTORY_INFO"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
- <a name="rfc.section.8.19"></a><h3>8.19.&nbsp;
+ <a name="rfc.section.8.22"></a><h3>8.22.&nbsp;
  Database instrument directory information changed</h3>
  <p>Client may want to be notified when changes were made to directories
-Line 10687 
 Database instrument directory informatio
+Line 11741 
 Database instrument directory informatio
  </p>
  <a name="SUBSCRIBE DB_INSTRUMENT_COUNT"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
- <a name="rfc.section.8.20"></a><h3>8.20.&nbsp;
+ <a name="rfc.section.8.23"></a><h3>8.23.&nbsp;
  Number of database instruments changed</h3>
  <p>Client may want to be notified when the number of instruments
-Line 10721 
 Number of database instruments changed</
+Line 11775 
 Number of database instruments changed</
  </p>
  <a name="SUBSCRIBE DB_INSTRUMENT_INFO"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
- <a name="rfc.section.8.21"></a><h3>8.21.&nbsp;
+ <a name="rfc.section.8.24"></a><h3>8.24.&nbsp;
  Database instrument information changed</h3>
  <p>Client may want to be notified when changes were made to instruments
-Line 10766 
 Database instrument information changed<
+Line 11820 
 Database instrument information changed<
  </p>
  <a name="SUBSCRIBE DB_INSTRUMENTS_JOB_INFO"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
- <a name="rfc.section.8.22"></a><h3>8.22.&nbsp;
+ <a name="rfc.section.8.25"></a><h3>8.25.&nbsp;
  Database job status information changed</h3>
  <p>Client may want to be notified when the status of particular database
-Line 10799 
 Database job status information changed<
+Line 11853 
 Database job status information changed<
  </p>
  <a name="SUBSCRIBE MISCELLANEOUS"></a><br /><hr />
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
- <a name="rfc.section.8.23"></a><h3>8.23.&nbsp;
+ <a name="rfc.section.8.26"></a><h3>8.26.&nbsp;
  Miscellaneous and debugging events</h3>
  <p>Client may want to be notified of miscellaneous and debugging events occurring at
-Line 10896 
 Schoenebeck</td></tr>
+Line 11950 
 Schoenebeck</td></tr>
  <table summary="layout" cellpadding="0" cellspacing="2" class="TOCbug" align="right"><tr><td class="TOCbug"><a href="#toc">&nbsp;TOC&nbsp;</a></td></tr></table>
  <h3>Full Copyright Statement</h3>
  <p class='copyright'>
- Copyright &copy; The IETF Trust (2007).</p>
+ Copyright &copy; The IETF Trust (2008).</p>
  <p class='copyright'>
  This document is subject to the rights,
  licenses and restrictions contained in BCP&nbsp;78,

 Legend:



Removed from v.1251
 


changed lines


 
Added in v.1773
 Legend:



Removed from v.1251
 


changed lines


 
Added in v.1773
-Removed from v.1251
+Added in v.1773

	ViewVC Help
Powered by ViewVC