--- web/trunk/www.linuxsampler.org/api/draft-linuxsampler-protocol.html	2007/05/24 14:22:39	1201
+++ web/trunk/www.linuxsampler.org/api/draft-linuxsampler-protocol.html	2009/11/01 12:59:16	2023
@@ -3,7 +3,7 @@
 <meta http-equiv="Content-Type" content="text/html; charset=utf-8">
 <meta name="description" content="LinuxSampler Control Protocol">
 <meta name="keywords" content="LSCP">
-<meta name="generator" content="xml2rfc v1.32 (http://xml.resource.org/)">
+<meta name="generator" content="xml2rfc v1.34 (http://xml.resource.org/)">
 <style type='text/css'><!--
         body {
                 font-family: verdana, charcoal, helvetica, arial, sans-serif;
@@ -145,10 +145,19 @@
 <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: November 25, 2007</td><td class="header">May 24, 2007</td></tr>
+<tr><td class="header">Expires: May 5, 2010</td><td class="header">November 1, 2009</td></tr>
 </table></td></tr></table>
-<h1><br />LinuxSampler Control Protocol<br />LSCP 1.2</h1>
+<h1><br />LinuxSampler Control Protocol<br />LSCP 1.5</h1>
 
+<h3>Abstract</h3>
+
+<p>The LinuxSampler Control Protocol (LSCP) is an
+            application-level protocol primarily intended for local and
+            remote controlling the LinuxSampler backend application, which is a
+            sophisticated server-like console application essentially playing
+            back audio samples and manipulating the samples in real time to
+            certain extent.
+</p>
 <h3>Status of this Memo</h3>
 <p>
 By submitting this Internet-Draft,
@@ -173,21 +182,8 @@
 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 November 25, 2007.</p>
-
-<h3>Copyright Notice</h3>
-<p>
-Copyright &copy; The IETF Trust (2007).</p>
-
-<h3>Abstract</h3>
-
-<p>The LinuxSampler Control Protocol (LSCP) is an
-            application-level protocol primarily intended for local and
-            remote controlling the LinuxSampler backend application, which is a
-            sophisticated server-like console application essentially playing
-            back audio samples and manipulating the samples in real time to
-            certain extent.
-</p><a name="toc"></a><br /><hr />
+This Internet-Draft will expire on May 5, 2010.</p>
+<a name="toc"></a><br /><hr />
 <h3>Table of Contents</h3>
 <p class="toc">
 <a href="#anchor1">1.</a>&nbsp;
@@ -336,7 +332,9 @@
 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 />
@@ -354,17 +352,27 @@
 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;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET VOICES">6.6.8.</a>&nbsp;
+Getting global voice limit<br />
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET VOICES">6.6.9.</a>&nbsp;
+Setting global voice limit<br />
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#GET STREAMS">6.6.10.</a>&nbsp;
+Getting global disk stream limit<br />
+&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<a href="#SET STREAMS">6.6.11.</a>&nbsp;
+Setting global disk stream limit<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 />
@@ -432,8 +440,28 @@
 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;
+Character Set and Escape Sequences<br />
 <a href="#events">8.</a>&nbsp;
 Events<br />
 &nbsp;&nbsp;&nbsp;&nbsp;<a href="#SUBSCRIBE AUDIO_OUTPUT_DEVICE_COUNT">8.1.</a>&nbsp;
@@ -446,41 +474,47 @@
 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 />
@@ -512,8 +546,8 @@
             (front-end) and server (LinuxSampler) respectively. Lines in
             examples must be interpreted as every line being CRLF
             terminated (carriage return character followed by line feed
-            character as defined in the ASCII standard), thus the following
-            example:
+            character as defined in the ASCII standard <a class='info' href='#RFC20'>[RFC20]<span> (</span><span class='info'>UCLA, &ldquo;ASCII format for Network Interchange,&rdquo; 1969.</span><span>)</span></a>),
+            thus the following example:
 </p>
 <p>
                 </p>
@@ -3299,7 +3333,8 @@
                     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>
@@ -3340,7 +3375,19 @@
 <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>
                     
@@ -3375,6 +3422,12 @@
                     number of the sampler channel the instrument should be assigned to.
                     Each sampler channel can only have one instrument.
 </p>
+<p>Notice: since LSCP 1.2 the &lt;filename&gt; argument supports
+                    escape characters for special characters (see 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>"
+                    for details) and accordingly backslash characters in the filename
+                    MUST now be escaped as well!
+</p>
 <p>The difference between regular and NON_MODAL versions of the command
                     is that the regular command returns OK only after the instrument has been
                     fully loaded and the channel is ready to be used while NON_MODAL version
@@ -3422,12 +3475,26 @@
 </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>
                     
@@ -3842,6 +3909,8 @@
                                         </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>
                                     
@@ -3927,7 +3996,7 @@
 <blockquote class="text">
 <p>numerical ID of the audio output device which is
                                             currently connected to this sampler channel to output
-                                            the audio signal, "NONE" if there's no device
+                                            the audio signal, "-1" if there's no device
                                             connected to this sampler channel
 </p>
 </blockquote>
@@ -3961,7 +4030,8 @@
 <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>
                                     
@@ -3969,7 +4039,9 @@
 <p>INSTRUMENT_NR -
                                         </p>
 <blockquote class="text">
-<p>the instrument index number of the loaded instrument
+<p>the instrument index number of the loaded instrument,
+                                            "-1" if there's no instrument loaded for this sampler
+                                            channel
 </p>
 </blockquote>
                                     
@@ -3978,6 +4050,8 @@
                                         </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>
                                     
@@ -3985,8 +4059,11 @@
 <p>INSTRUMENT_STATUS -
                                         </p>
 <blockquote class="text">
-<p>integer values 0 to 100 indicating loading progress percentage for the instrument. Negative
-                                            value indicates a loading exception. Value of 100 indicates that the instrument is fully
+<p>Integer values 0 to 100 indicating loading progress
+                                            percentage for the instrument. Negative
+                                            value indicates a loading exception (also returns "-1" in case no
+                                            instrument was yet to be loaded on the sampler channel).
+                                            Value of 100 indicates that the instrument is fully
                                             loaded.
 </p>
 </blockquote>
@@ -3997,7 +4074,7 @@
 <blockquote class="text">
 <p>numerical ID of the MIDI input device which is
                                             currently connected to this sampler channel to deliver
-                                            MIDI input commands, "NONE" if there's no device
+                                            MIDI input commands, "-1" if there's no device
                                             connected to this sampler channel
 </p>
 </blockquote>
@@ -4006,7 +4083,9 @@
 <p>MIDI_INPUT_PORT -
                                         </p>
 <blockquote class="text">
-<p>port number of the MIDI input device
+<p>port number of the MIDI input device (in case a
+                                            MIDI device was already assigned to the sampler
+                                            channel)
 </p>
 </blockquote>
                                     
@@ -5053,7 +5132,9 @@
                     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
@@ -5322,6 +5403,8 @@
                                         </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>
                                     
@@ -5412,7 +5495,10 @@
                     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>
@@ -5676,9 +5762,107 @@
 </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 a 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>
+                            
+
+<p>"CC" -
+                                </p>
+<blockquote class="text">
+<p>For changing a MIDI controller, where &lt;arg1&gt;
+                                    specifies the controller number and &lt;arg2&gt; the
+                                    new value of the controller as described in the Control
+                                    Change section of 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:
@@ -6013,9 +6197,36 @@
 </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:
@@ -6056,7 +6267,7 @@
 </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
@@ -6089,6 +6300,8 @@
                                         </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>
                                     
@@ -6130,7 +6343,7 @@
 </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
@@ -6163,7 +6376,7 @@
 </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
@@ -6216,6 +6429,198 @@
 </blockquote><p>
                     
 </p>
+<a name="GET VOICES"></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.8"></a><h3>6.6.8.&nbsp;
+Getting global voice limit</h3>
+
+<p>The client can ask for the current global sampler-wide limit
+                       for maximum voices by sending the following command:
+</p>
+<p>
+                        </p>
+<blockquote class="text">
+<p>GET VOICES
+</p>
+</blockquote><p>
+                    
+</p>
+<p>Possible Answers:
+</p>
+<p>
+                        </p>
+<blockquote class="text">
+<p>LinuxSampler will answer by returning the number for
+                               the current limit of maximum voices.
+</p>
+</blockquote><p>
+                    
+</p>
+<p>The voice limit setting defines how many voices should maximum
+                       be processed by the sampler at the same time. If the user
+                       triggers new notes which would exceed that voice limit, the
+                       sampler engine will react by stealing old voices for those
+                       newly triggered notes. Note that the amount of voices triggered
+                       by a new note can be larger than one and is dependent to the
+                       respective instrument and probably further criterias.
+</p>
+<a name="SET VOICES"></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.9"></a><h3>6.6.9.&nbsp;
+Setting global voice limit</h3>
+
+<p>The client can alter the current global sampler-wide limit
+                    for maximum voices by sending the following command:
+</p>
+<p>
+                        </p>
+<blockquote class="text">
+<p>SET VOICES &lt;max-voices&gt;
+</p>
+</blockquote><p>
+                    
+</p>
+<p>Where &lt;max-voices&gt; should be replaced by the integer
+                   value, reflecting the new global amount limit of maximum voices.
+                   This value has to be larger than 0.
+</p>
+<p>Possible Answers:
+</p>
+<p>
+                        </p>
+<blockquote class="text">
+<p>"OK" -
+                                </p>
+<blockquote class="text">
+<p>on success
+</p>
+</blockquote>
+                            
+
+<p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
+                                </p>
+<blockquote class="text">
+<p>if the voice limit was set, but there are noteworthy
+                                    issue(s) related, providing an appropriate warning code and
+                                    warning message
+</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>Note: the given value will be passed to all sampler engine instances.
+                       The total amount of maximum voices on the running system might thus
+                       be as big as the given value multiplied by the current amount of engine
+                       instances.
+</p>
+<p>Caution: when adjusting the voice limit, you SHOULD also
+                        adjust the disk stream limit respectively and vice versa.
+</p>
+<a name="GET STREAMS"></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.10"></a><h3>6.6.10.&nbsp;
+Getting global disk stream limit</h3>
+
+<p>The client can ask for the current global sampler-wide limit
+                       for maximum disk streams by sending the following command:
+</p>
+<p>
+                        </p>
+<blockquote class="text">
+<p>GET STREAMS
+</p>
+</blockquote><p>
+                    
+</p>
+<p>Possible Answers:
+</p>
+<p>
+                        </p>
+<blockquote class="text">
+<p>LinuxSampler will answer by returning the number for
+                               the current limit of maximum disk streams.
+</p>
+</blockquote><p>
+                    
+</p>
+<p>The disk stream limit setting defines how many disk streams should
+                       maximum be processed by a sampler engine at the same time. The
+                       higher this value, the more memory (RAM) will be occupied, since
+                       every disk streams allocates a certain buffer size for being able
+                       to perform its streaming operations.
+</p>
+<a name="SET STREAMS"></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.11"></a><h3>6.6.11.&nbsp;
+Setting global disk stream limit</h3>
+
+<p>The client can alter the current global sampler-wide limit
+                    for maximum disk streams by sending the following command:
+</p>
+<p>
+                        </p>
+<blockquote class="text">
+<p>SET STREAMS &lt;max-streams&gt;
+</p>
+</blockquote><p>
+                    
+</p>
+<p>Where &lt;max-streams&gt; should be replaced by the integer
+                   value, reflecting the new global amount limit of maximum disk streams.
+                   This value has to be positive.
+</p>
+<p>Possible Answers:
+</p>
+<p>
+                        </p>
+<blockquote class="text">
+<p>"OK" -
+                                </p>
+<blockquote class="text">
+<p>on success
+</p>
+</blockquote>
+                            
+
+<p>"WRN:&lt;warning-code&gt;:&lt;warning-message&gt;" -
+                                </p>
+<blockquote class="text">
+<p>if the disk stream limit was set, but there are noteworthy
+                                    issue(s) related, providing an appropriate warning code and
+                                    warning message
+</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>Note: the given value will be passed to all sampler engine instances.
+                       The total amount of maximum disk streams on the running system might
+                       thus be as big as the given value multiplied by the current amount of
+                       engine instances.
+</p>
+<p>Caution: when adjusting the disk stream limit, you SHOULD also
+                        adjust the voice limit respectively and vice versa.
+</p>
 <a name="MIDI Instrument Mapping"></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"></a><h3>6.7.&nbsp;
@@ -6250,7 +6655,7 @@
                 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>
@@ -6268,7 +6673,10 @@
 </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>
@@ -6526,6 +6934,8 @@
 <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>
                                     
@@ -6581,7 +6991,10 @@
 </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>
@@ -6647,7 +7060,9 @@
                     index, &lt;engine_name&gt; a sampler engine name as returned by
                     the <a class='info' href='#LIST AVAILABLE_ENGINES'>"LIST AVAILABLE_ENGINES"<span> (</span><span class='info'>Getting all available engines</span><span>)</span></a>
                     command (not encapsulated into apostrophes), &lt;filename&gt; the name
-                    of the instrument's file to be deployed (encapsulated into apostrophes),
+                    of the instrument's file to be deployed (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>"),
                     &lt;instrument_index&gt; the index (integer value) of the instrument
                     within the given file, &lt;volume_value&gt; reflects the master
                     volume of the instrument as optionally dotted number (where a
@@ -6744,9 +7159,10 @@
                     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
-                    set a custom name (encapsulated into apostrophes) for the mapping
-                    entry, useful for frontends for displaying an appropriate name for
+                    command(s). Finally the OPTIONAL &lt;name&gt; argument allows to set a custom name
+                    (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>") 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>).
                     
@@ -7068,6 +7484,8 @@
                                     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>
                             
@@ -7084,7 +7502,9 @@
 <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>
                             
@@ -7102,7 +7522,8 @@
 <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>
                             
@@ -7237,6 +7658,23 @@
 <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;
@@ -7502,7 +7940,9 @@
 <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>
                                     
@@ -7747,7 +8187,9 @@
                     
 </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>
@@ -7814,7 +8256,9 @@
                           </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>
                       
@@ -7857,7 +8301,10 @@
                           </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>
                       
@@ -7920,7 +8367,7 @@
 <p>
                         </p>
 <blockquote class="text">
-<p>ADD DB_INSTRUMENTS [NON_MODAL] [&lt;mode&gt;] &lt;db_dir&gt; &lt;file_path&gt; [&lt;instr_index&gt;]
+<p>ADD DB_INSTRUMENTS [NON_MODAL] [&lt;mode&gt;[ FILE_AS_DIR]] &lt;db_dir&gt; &lt;file_path&gt; [&lt;instr_index&gt;]
 </p>
 </blockquote><p>
                     
@@ -7978,6 +8425,11 @@
 </blockquote><p>
                     
 </p>
+<p> If FILE_AS_DIR argument is supplied, all instruments in an instrument
+		 file will be added to a separate directory in the instruments database, which
+		 name will be the name of the instrument file with the file extension stripped off.
+                 
+</p>
 <p>The difference between regular and NON_MODAL versions of the command
                     is that the regular command returns when the scanning is finished
                     while NON_MODAL version returns immediately and a background process is launched.
@@ -8238,6 +8690,8 @@
                                         </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>
                                     
@@ -8297,7 +8751,9 @@
 <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>
                                     
@@ -8314,7 +8770,9 @@
 <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>
                                     
@@ -8322,7 +8780,9 @@
 <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>
                                     
@@ -8332,6 +8792,8 @@
 <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>
                                     
@@ -8572,7 +9034,9 @@
                     
 </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>
@@ -8639,7 +9103,9 @@
                           </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>
                       
@@ -8649,7 +9115,7 @@
 <p>SIZE=[&lt;min&gt;]..[&lt;max&gt;]
                           </p>
 <blockquote class="text">
-<p>Restricts the search to instruments, which 
+<p>Restricts the search to instruments, which
                               size is in the specified range. If &lt;min&gt; is omitted,
                               the search results are restricted to instruments with size less then
                               or equal to &lt;max&gt;. If &lt;max&gt; is omitted, the
@@ -8697,7 +9163,9 @@
                           </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>
                       
@@ -8708,7 +9176,9 @@
                           </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>
                       
@@ -8719,7 +9189,9 @@
                           </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>
                       
@@ -8730,7 +9202,9 @@
                           </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>
                       
@@ -8740,7 +9214,7 @@
 <p>IS_DRUM=true | false
                           </p>
 <blockquote class="text">
-<p>Either true or false. Restricts the search to 
+<p>Either true or false. Restricts the search to
                               drum kits or chromatic instruments.
 </p>
 </blockquote><p>
@@ -8900,6 +9374,523 @@
 </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;
@@ -9015,6 +10006,15 @@
 <p>/ COPY SP copy_instruction
 		
 </p>
+<p>/ EDIT SP edit_instruction
+		
+</p>
+<p>/ FORMAT SP format_instruction
+		
+</p>
+<p>/ SEND SP send_instruction
+		
+</p>
 <p>/ RESET
 		
 </p>
@@ -9030,25 +10030,31 @@
 <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 db_path SP filename
+		
+</p>
+<p>/ DB_INSTRUMENTS SP NON_MODAL SP scan_mode SP FILE_AS_DIR SP db_path SP filename
 		
 </p>
-<p>/ DB_INSTRUMENTS SP NON_MODAL SP scan_mode SP pathname SP pathname
+<p>/ DB_INSTRUMENTS 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 FILE_AS_DIR 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
@@ -9078,6 +10084,12 @@
 <p>/ CHANNEL_COUNT
 		
 </p>
+<p>/ CHANNEL_MIDI
+		
+</p>
+<p>/ DEVICE_MIDI
+		
+</p>
 <p>/ VOICE_COUNT
 		
 </p>
@@ -9126,6 +10138,9 @@
 <p>/ MISCELLANEOUS
 		
 </p>
+<p>/ TOTAL_STREAM_COUNT
+		
+</p>
 <p>/ TOTAL_VOICE_COUNT
 		
 </p>
@@ -9153,6 +10168,12 @@
 <p>/ CHANNEL_COUNT
 		
 </p>
+<p>/ CHANNEL_MIDI
+		
+</p>
+<p>/ DEVICE_MIDI
+		
+</p>
 <p>/ VOICE_COUNT
 		
 </p>
@@ -9201,6 +10222,9 @@
 <p>/ MISCELLANEOUS
 		
 </p>
+<p>/ TOTAL_STREAM_COUNT
+		
+</p>
 <p>/ TOTAL_VOICE_COUNT
 		
 </p>
@@ -9249,13 +10273,13 @@
 <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>
@@ -9336,6 +10360,9 @@
 <p>/ SERVER SP INFO
 		
 </p>
+<p>/ TOTAL_STREAM_COUNT
+		
+</p>
 <p>/ TOTAL_VOICE_COUNT
 		
 </p>
@@ -9363,22 +10390,22 @@
 <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
@@ -9387,6 +10414,18 @@
 <p>/ VOLUME
 		
 </p>
+<p>/ VOICES
+		
+</p>
+<p>/ STREAMS
+		
+</p>
+<p>/ FILE SP INSTRUMENTS SP filename
+		
+</p>
+<p>/ FILE SP INSTRUMENT SP INFO SP filename SP instrument_index
+		
+</p>
 </blockquote><p>
 
 </p>
@@ -9402,6 +10441,9 @@
 <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>
@@ -9423,16 +10465,19 @@
 <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 pathname SP stringval
+<p>/ DB_INSTRUMENT_DIRECTORY SP DESCRIPTION SP db_path SP stringval_escaped
 		
 </p>
-<p>/ DB_INSTRUMENT SP NAME SP pathname SP dirname
+<p>/ DB_INSTRUMENT SP NAME SP db_path SP stringval_escaped
 		
 </p>
-<p>/ DB_INSTRUMENT SP DESCRIPTION SP pathname SP stringval
+<p>/ DB_INSTRUMENT SP DESCRIPTION SP db_path SP stringval_escaped
+		
+</p>
+<p>/ DB_INSTRUMENT SP FILE_PATH SP filename SP filename
 		
 </p>
 <p>/ ECHO SP boolean
@@ -9441,6 +10486,12 @@
 <p>/ VOLUME SP volume_value
 		
 </p>
+<p>/ VOICES SP number
+		
+</p>
+<p>/ STREAMS SP number
+		
+</p>
 </blockquote><p>
 
 </p>
@@ -9492,16 +10543,19 @@
 <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>
@@ -9510,10 +10564,10 @@
 <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>
@@ -9522,10 +10576,10 @@
 <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>
@@ -9606,6 +10660,24 @@
 </blockquote><p>
 
 </p>
+<p>edit_instruction =
+	</p>
+<blockquote class="text">
+<p>CHANNEL SP INSTRUMENT SP sampler_channel
+		
+</p>
+</blockquote><p>
+
+</p>
+<p>format_instruction =
+	</p>
+<blockquote class="text">
+<p>INSTRUMENTS_DB
+		
+</p>
+</blockquote><p>
+
+</p>
 <p>modal_arg =
 	</p>
 <blockquote class="text">
@@ -9675,16 +10747,28 @@
 <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>
@@ -9867,28 +10951,19 @@
 </blockquote><p>
 
 </p>
-<p>pathname =
-	</p>
-<blockquote class="text">
-<p>stringval
-		
-</p>
-</blockquote><p>
-
-</p>
-<p>dirname =
+<p>filename =
 	</p>
 <blockquote class="text">
-<p>stringval
+<p>path
 		
 </p>
 </blockquote><p>
 
 </p>
-<p>filename =
+<p>db_path =
 	</p>
 <blockquote class="text">
-<p>stringval
+<p>path
 		
 </p>
 </blockquote><p>
@@ -9897,7 +10972,7 @@
 <p>map_name =
 	</p>
 <blockquote class="text">
-<p>stringval
+<p>stringval_escaped
 		
 </p>
 </blockquote><p>
@@ -9906,7 +10981,7 @@
 <p>entry_name =
 	</p>
 <blockquote class="text">
-<p>stringval
+<p>stringval_escaped
 		
 </p>
 </blockquote><p>
@@ -9915,7 +10990,7 @@
 <p>fx_send_name =
 	</p>
 <blockquote class="text">
-<p>stringval
+<p>stringval_escaped
 		
 </p>
 </blockquote><p>
@@ -9966,10 +11041,10 @@
 <p>query_val =
 	</p>
 <blockquote class="text">
-<p>string
+<p>text_escaped
 		
 </p>
-<p>/ stringval
+<p>/ stringval_escaped
 		
 </p>
 </blockquote><p>
@@ -9990,6 +11065,206 @@
 </blockquote><p>
 
 </p>
+<a name="character_set"></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.1"></a><h3>7.1.&nbsp;
+Character Set and Escape Sequences</h3>
+
+<p>Older versions of this protocol up to and including v1.1 only
+                supported the standard ASCII character set (ASCII code 0 - 127)
+                <a class='info' href='#RFC20'>[RFC20]<span> (</span><span class='info'>UCLA, &ldquo;ASCII format for Network Interchange,&rdquo; 1969.</span><span>)</span></a>, all younger versions of this protocol
+                however support the Extended ASCII character set (ASCII code
+                0 - 255). The same group of younger protocols also support
+                escape sequences, but only for certain, explicitly declared
+                parts of the protocol. The supported escape sequences are
+                defined as follows:
+</p><table class="full" align="center" border="0" cellpadding="2" cellspacing="2">
+<col align="left"><col align="left">
+<tr><th align="left">ASCII Character Sequence</th><th align="left">Translated into (Name)</th></tr>
+<tr>
+<td align="left">\n</td>
+<td align="left">new line</td>
+</tr>
+<tr>
+<td align="left">\r</td>
+<td align="left">carriage return</td>
+</tr>
+<tr>
+<td align="left">\f</td>
+<td align="left">form feed</td>
+</tr>
+<tr>
+<td align="left">\t</td>
+<td align="left">horizontal tab</td>
+</tr>
+<tr>
+<td align="left">\v</td>
+<td align="left">vertical tab</td>
+</tr>
+<tr>
+<td align="left">\'</td>
+<td align="left">apostrophe</td>
+</tr>
+<tr>
+<td align="left">\"</td>
+<td align="left">quotation mark</td>
+</tr>
+<tr>
+<td align="left">\\</td>
+<td align="left">backslash</td>
+</tr>
+<tr>
+<td align="left">\OOO</td>
+<td align="left">three digit octal ASCII code of the character</td>
+</tr>
+<tr>
+<td align="left">\xHH</td>
+<td align="left">two digit hex ASCII code of the character</td>
+</tr>
+</table>
+<br clear="all" />
+
+<p>Notice: due to the transition of certain parts of the
+                protocol which now support escape sequences, a slight backward
+                incompatibility to protocols version v1.1 and younger has been
+                introduced. The only difference is that in parts of the protocol
+                where escape characters are now supported, a backslash characters
+                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;
@@ -10150,9 +11425,85 @@
 <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
+                0 .. 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
+		       0 .. 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
@@ -10182,7 +11533,7 @@
 </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
@@ -10212,7 +11563,7 @@
 </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
@@ -10243,7 +11594,7 @@
 </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
@@ -10276,10 +11627,10 @@
 </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 
+<p>Client may want to be notified when the number of effect sends on
                 a particular sampler channel is changed by issuing the following command:
 </p>
 <p>
@@ -10306,7 +11657,7 @@
 </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
@@ -10336,7 +11687,7 @@
 </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
@@ -10363,9 +11714,38 @@
 <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
@@ -10394,7 +11774,7 @@
 </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
@@ -10427,7 +11807,7 @@
 </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
@@ -10457,7 +11837,7 @@
 </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
@@ -10491,7 +11871,7 @@
 </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
@@ -10516,11 +11896,27 @@
                         new global volume parameter.
 </p>
 </blockquote><p>
+                    </p>
+<blockquote class="text">
+<p>"NOTIFY:GLOBAL_INFO:VOICES &lt;max-voices&gt;" - Notifies that the
+                        golbal limit of the sampler for maximum voices is changed, where
+                        &lt;max-voices&gt; will be an integer value, reflecting the
+                        new global voice limit parameter.
+</p>
+</blockquote><p>
+                    </p>
+<blockquote class="text">
+<p>"NOTIFY:GLOBAL_INFO:STREAMS &lt;max-streams&gt;" - Notifies that the
+                        golbal limit of the sampler for maximum disk streams is changed, where
+                        &lt;max-streams&gt; will be an integer value, reflecting the
+                        new global disk streams limit parameter.
+</p>
+</blockquote><p>
                 
 </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
@@ -10554,7 +11950,7 @@
 </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
@@ -10599,7 +11995,7 @@
 </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
@@ -10633,7 +12029,7 @@
 </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
@@ -10678,7 +12074,7 @@
 </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
@@ -10711,7 +12107,7 @@
 </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
@@ -10776,12 +12172,14 @@
 <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>11.&nbsp;References</h3>
 <table width="99%" border="0">
+<tr><td class="author-text" valign="top"><a name="RFC20">[RFC20]</a></td>
+<td class="author-text">UCLA, &ldquo;<a href="http://tools.ietf.org/html/rfc20">ASCII format for Network Interchange</a>,&rdquo; RFC&nbsp;20, 1969.</td></tr>
 <tr><td class="author-text" valign="top"><a name="RFC2119">[RFC2119]</a></td>
-<td class="author-text">Bradner, S., &ldquo;<a href="ftp://ftp.isi.edu/in-notes/rfc2119.txt">Key words for use in RFCs to Indicate Requirement Levels</a>,&rdquo; RFC&nbsp;2119, 1997.</td></tr>
+<td class="author-text">Bradner, S., &ldquo;<a href="http://tools.ietf.org/html/rfc2119">Key words for use in RFCs to Indicate Requirement Levels</a>,&rdquo; RFC&nbsp;2119, 1997.</td></tr>
 <tr><td class="author-text" valign="top"><a name="RFC2234">[RFC2234]</a></td>
-<td class="author-text">Crocker, D. and P. Overell, &ldquo;<a href="ftp://ftp.isi.edu/in-notes/rfc2234.txt">Augmented BNF for Syntax Specifications</a>,&rdquo; RFC&nbsp;2234, 1997.</td></tr>
+<td class="author-text">Crocker, D. and P. Overell, &ldquo;<a href="http://tools.ietf.org/html/rfc2234">Augmented BNF for Syntax Specifications</a>,&rdquo; RFC&nbsp;2234, 1997.</td></tr>
 <tr><td class="author-text" valign="top"><a name="RFC793">[RFC793]</a></td>
-<td class="author-text">Defense Advanced Research Projects Agency, &ldquo;<a href="ftp://ftp.isi.edu/in-notes/rfc793.txt">TRANSMISSION CONTROL PROTOCOL</a>,&rdquo; RFC&nbsp;793, 1981.</td></tr>
+<td class="author-text">Defense Advanced Research Projects Agency, &ldquo;<a href="http://tools.ietf.org/html/rfc793">TRANSMISSION CONTROL PROTOCOL</a>,&rdquo; RFC&nbsp;793, 1981.</td></tr>
 </table>
 
 <a name="rfc.authors"></a><br /><hr />
@@ -10806,7 +12204,7 @@
 <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 (2009).</p>
 <p class='copyright'>
 This document is subject to the rights,
 licenses and restrictions contained in BCP&nbsp;78,
@@ -10848,8 +12246,5 @@
 proprietary rights that may cover technology that may be required
 to implement this standard.
 Please address the information to the IETF at <a href='mailto:ietf-ipr@ietf.org'>ietf-ipr@ietf.org</a>.</p>
-<h3>Acknowledgment</h3>
-<p class='copyright'>
-Funding for the RFC Editor function is provided by
-the IETF Administrative Support Activity (IASA).</p>
 </body></html>
+