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

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

Parent Directory | Revision Log | View Patch Patch

-revision 1685 by schoenebeck,
Thu Feb 14 14:41:08 2008 UTC
+revision 1731 by iliev,
Fri May  2 13:03:00 2008 UTC
 Line 4
  LinuxSampler Developers                                   C. Schoenebeck
  Internet-Draft                           Interessengemeinschaft Software
  Intended status: Standards Track                       Engineering e. V.
- Expires: August 17, 2008                               February 14, 2008
+ Expires: October 3, 2008                                      April 2008
                       LinuxSampler Control Protocol
 Line 33 
 Status of this Memo
     The list of Internet-Draft Shadow Directories can be accessed at
     http://www.ietf.org/shadow.html.
-    This Internet-Draft will expire on August 17, 2008.
+    This Internet-Draft will expire on October 3, 2008.
- Copyright Notice
-    Copyright (C) The IETF Trust (2008).
-Line 52 
 Copyright Notice
+Line 51 
 Copyright Notice
- Schoenebeck              Expires August 17, 2008                [Page 1]
+ Schoenebeck              Expires October 3, 2008                [Page 1]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
  Abstract
 Line 108 
 Table of Contents
- Schoenebeck              Expires August 17, 2008                [Page 2]
+ Schoenebeck              Expires October 3, 2008                [Page 2]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
 .3.8.  Getting all created MIDI input device list  . . . . .  37
 Line 164 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008                [Page 3]
+ Schoenebeck              Expires October 3, 2008                [Page 3]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
 .5.4.  Close client connection . . . . . . . . . . . . . . .  73
 Line 215 
 Internet-Draft        LinuxSampler Contr
 .8.20. Finding instruments . . . . . . . . . . . . . . . . . 103
 .8.21. Getting job status information  . . . . . . . . . . . 106
 .8.22. Formatting the instruments database . . . . . . . . . 107
-.9.  Editing Instruments . . . . . . . . . . . . . . . . . . . 107
+.8.23. Checking for lost instrument files  . . . . . . . . . 107
-.9.1.  Opening an appropriate instrument editor
+.8.24. Replacing an instrument file  . . . . . . . . . . . . 108
- Schoenebeck              Expires August 17, 2008                [Page 4]
+ Schoenebeck              Expires October 3, 2008                [Page 4]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
-                application . . . . . . . . . . . . . . . . . . . . . 107
+.9.  Editing Instruments . . . . . . . . . . . . . . . . . . . 108
-.10. Managing Files  . . . . . . . . . . . . . . . . . . . . . 108
+.9.1.  Opening an appropriate instrument editor
-.10.1. Retrieving amount of instruments of a file  . . . . . 109
+                application . . . . . . . . . . . . . . . . . . . . . 109
-.10.2. Retrieving all instruments of a file  . . . . . . . . 109
+.10. Managing Files  . . . . . . . . . . . . . . . . . . . . . 110
+.10.1. Retrieving amount of instruments of a file  . . . . . 110
+.10.2. Retrieving all instruments of a file  . . . . . . . . 110
 .10.3. Retrieving informations about one instrument in a
-                file  . . . . . . . . . . . . . . . . . . . . . . . . 110
+                file  . . . . . . . . . . . . . . . . . . . . . . . . 111
-.  Command Syntax  . . . . . . . . . . . . . . . . . . . . . . . 112
+.  Command Syntax  . . . . . . . . . . . . . . . . . . . . . . . 113
-.1.  Character Set and Escape Sequences  . . . . . . . . . . . 126
+.1.  Character Set and Escape Sequences  . . . . . . . . . . . 127
-.  Events  . . . . . . . . . . . . . . . . . . . . . . . . . . . 130
+.  Events  . . . . . . . . . . . . . . . . . . . . . . . . . . . 131
-.1.  Number of audio output devices changed  . . . . . . . . . 130
+.1.  Number of audio output devices changed  . . . . . . . . . 131
-.2.  Audio output device's settings changed  . . . . . . . . . 130
+.2.  Audio output device's settings changed  . . . . . . . . . 131
-.3.  Number of MIDI input devices changed  . . . . . . . . . . 130
+.3.  Number of MIDI input devices changed  . . . . . . . . . . 131
-.4.  MIDI input device's settings changed  . . . . . . . . . . 131
+.4.  MIDI input device's settings changed  . . . . . . . . . . 132
-.5.  Number of sampler channels changed  . . . . . . . . . . . 131
+.5.  Number of sampler channels changed  . . . . . . . . . . . 132
-.6.  MIDI data on a sampler channel arrived  . . . . . . . . . 131
+.6.  MIDI data on a sampler channel arrived  . . . . . . . . . 132
-.7.  Number of active voices changed . . . . . . . . . . . . . 132
+.7.  MIDI data on a MIDI input device arrived  . . . . . . . . 133
-.8.  Number of active disk streams changed . . . . . . . . . . 132
+.8.  Number of active voices changed . . . . . . . . . . . . . 133
-.9.  Disk stream buffer fill state changed . . . . . . . . . . 133
+.9.  Number of active disk streams changed . . . . . . . . . . 134
-.10. Channel information changed . . . . . . . . . . . . . . . 133
+.10. Disk stream buffer fill state changed . . . . . . . . . . 134
-.11. Number of effect sends changed  . . . . . . . . . . . . . 133
+.11. Channel information changed . . . . . . . . . . . . . . . 134
-.12. Effect send information changed . . . . . . . . . . . . . 134
+.12. Number of effect sends changed  . . . . . . . . . . . . . 135
-.13. Total number of active voices changed . . . . . . . . . . 134
+.13. Effect send information changed . . . . . . . . . . . . . 135
-.14. Total number of active disk streams changed . . . . . . . 134
+.14. Total number of active voices changed . . . . . . . . . . 136
-.15. Number of MIDI instrument maps changed  . . . . . . . . . 135
+.15. Total number of active disk streams changed . . . . . . . 136
-.16. MIDI instrument map information changed . . . . . . . . . 135
+.16. Number of MIDI instrument maps changed  . . . . . . . . . 136
-.17. Number of MIDI instruments changed  . . . . . . . . . . . 135
+.17. MIDI instrument map information changed . . . . . . . . . 136
-.18. MIDI instrument information changed . . . . . . . . . . . 136
+.18. Number of MIDI instruments changed  . . . . . . . . . . . 137
-.19. Global settings changed . . . . . . . . . . . . . . . . . 136
+.19. MIDI instrument information changed . . . . . . . . . . . 137
-.20. Number of database instrument directories changed . . . . 136
+.20. Global settings changed . . . . . . . . . . . . . . . . . 138
-.21. Database instrument directory information changed . . . . 137
+.21. Number of database instrument directories changed . . . . 138
-.22. Number of database instruments changed  . . . . . . . . . 137
+.22. Database instrument directory information changed . . . . 138
-.23. Database instrument information changed . . . . . . . . . 138
+.23. Number of database instruments changed  . . . . . . . . . 139
-.24. Database job status information changed . . . . . . . . . 138
+.24. Database instrument information changed . . . . . . . . . 139
-.25. Miscellaneous and debugging events  . . . . . . . . . . . 139
+.25. Database job status information changed . . . . . . . . . 140
-.  Security Considerations . . . . . . . . . . . . . . . . . . . 140
+.26. Miscellaneous and debugging events  . . . . . . . . . . . 140
-. Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . 141
+.  Security Considerations . . . . . . . . . . . . . . . . . . . 141
-. References  . . . . . . . . . . . . . . . . . . . . . . . . . 142
+. Acknowledgments . . . . . . . . . . . . . . . . . . . . . . . 142
-    Author's Address  . . . . . . . . . . . . . . . . . . . . . . . . 143
+. References  . . . . . . . . . . . . . . . . . . . . . . . . . 143
-    Intellectual Property and Copyright Statements  . . . . . . . . . 144
+    Author's Address  . . . . . . . . . . . . . . . . . . . . . . . . 144
+    Intellectual Property and Copyright Statements  . . . . . . . . . 145
-Line 275 
 Internet-Draft        LinuxSampler Contr
+Line 276 
 Internet-Draft        LinuxSampler Contr
+ Schoenebeck              Expires October 3, 2008                [Page 5]
- Schoenebeck              Expires August 17, 2008                [Page 5]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
 .  Requirements notation
 Line 332 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008                [Page 6]
+ Schoenebeck              Expires October 3, 2008                [Page 6]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
 .  Versioning of this specification
 Line 388 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008                [Page 7]
+ Schoenebeck              Expires October 3, 2008                [Page 7]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
 .  Introduction
 Line 444 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008                [Page 8]
+ Schoenebeck              Expires October 3, 2008                [Page 8]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
 .  Focus of this protocol
 Line 500 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008                [Page 9]
+ Schoenebeck              Expires October 3, 2008                [Page 9]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
 .  Communication Overview
 Line 556 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 10]
+ Schoenebeck              Expires October 3, 2008               [Page 10]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
 .1.1.  Result format
 Line 612 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 11]
+ Schoenebeck              Expires October 3, 2008               [Page 11]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
     set has the following format:
 Line 668 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 12]
+ Schoenebeck              Expires October 3, 2008               [Page 12]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
     Each line of the result set MUST end with <CRLF>.
 Line 724 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 13]
+ Schoenebeck              Expires October 3, 2008               [Page 13]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
         inserted in the middle of the event message as well as any other
 Line 780 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 14]
+ Schoenebeck              Expires October 3, 2008               [Page 14]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
 .  Description for control commands
 Line 836 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 15]
+ Schoenebeck              Expires October 3, 2008               [Page 15]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
 .2.1.  Getting amount of available audio output drivers
 Line 892 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 16]
+ Schoenebeck              Expires October 3, 2008               [Page 16]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
        LinuxSampler will answer by sending a <CRLF> separated list.  Each
 Line 948 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 17]
+ Schoenebeck              Expires October 3, 2008               [Page 17]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
     obtained (as returned by the "GET AUDIO_OUTPUT_DRIVER INFO"
 Line 1004 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 18]
+ Schoenebeck              Expires October 3, 2008               [Page 18]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
        MULTIPLICITY -
 Line 1060 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 19]
+ Schoenebeck              Expires October 3, 2008               [Page 19]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
           returned, dependent to driver parameter)
 Line 1116 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 20]
+ Schoenebeck              Expires October 3, 2008               [Page 20]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
           "TYPE: INT"
 Line 1172 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 21]
+ Schoenebeck              Expires October 3, 2008               [Page 21]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
           providing an appropriate warning code and warning message
 Line 1228 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 22]
+ Schoenebeck              Expires October 3, 2008               [Page 22]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
        C: "DESTROY AUDIO_OUTPUT_DEVICE 0"
 Line 1284 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 23]
+ Schoenebeck              Expires October 3, 2008               [Page 23]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
     Possible Answers:
 Line 1340 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 24]
+ Schoenebeck              Expires October 3, 2008               [Page 24]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
           "FRAGMENTS: 2"
 Line 1396 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 25]
+ Schoenebeck              Expires October 3, 2008               [Page 25]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
 .2.11.  Getting information about an audio channel
 Line 1452 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 26]
+ Schoenebeck              Expires October 3, 2008               [Page 26]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
     Examples:
 Line 1508 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 27]
+ Schoenebeck              Expires October 3, 2008               [Page 27]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
     channel number and <param> a specific channel parameter name for
 Line 1564 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 28]
+ Schoenebeck              Expires October 3, 2008               [Page 28]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
           RANGE_MAX -
 Line 1620 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 29]
+ Schoenebeck              Expires October 3, 2008               [Page 29]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
        "OK" -
 Line 1676 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 30]
+ Schoenebeck              Expires October 3, 2008               [Page 30]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
     Note: examples in this chapter showing particular parameters of
 Line 1732 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 31]
+ Schoenebeck              Expires October 3, 2008               [Page 31]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
 .3.3.  Getting information about a specific MIDI input driver
 Line 1788 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 32]
+ Schoenebeck              Expires October 3, 2008               [Page 32]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
 .3.4.  Getting information about specific MIDI input driver parameter
 Line 1844 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 33]
+ Schoenebeck              Expires October 3, 2008               [Page 33]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
        FIX -
 Line 1900 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 34]
+ Schoenebeck              Expires October 3, 2008               [Page 34]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
           may also appear without (optionally returned, dependent to
 Line 1956 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 35]
+ Schoenebeck              Expires October 3, 2008               [Page 35]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
        "OK[<device-id>]" -
 Line 2012 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 36]
+ Schoenebeck              Expires October 3, 2008               [Page 36]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
           in case it failed, providing an appropriate error code and
 Line 2068 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 37]
+ Schoenebeck              Expires October 3, 2008               [Page 37]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
 .3.9.  Getting current settings of a MIDI input device
 Line 2124 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 38]
+ Schoenebeck              Expires October 3, 2008               [Page 38]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
           "ACTIVE: true"
 Line 2180 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 39]
+ Schoenebeck              Expires October 3, 2008               [Page 39]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
     MIDI_INPUT_DEVICES" (Section 6.3.8) command and <midi-port> the MIDI
 Line 2236 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 40]
+ Schoenebeck              Expires October 3, 2008               [Page 40]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
        character string to that info category.  There is information
 Line 2292 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 41]
+ Schoenebeck              Expires October 3, 2008               [Page 41]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
           returned, dependent to device and port parameter)
 Line 2348 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 42]
+ Schoenebeck              Expires October 3, 2008               [Page 42]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
        "ERR:<error-code>:<error-message>" -
 Line 2404 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 43]
+ Schoenebeck              Expires October 3, 2008               [Page 43]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
     format and SHOULD return ERR and SHOULD not launch the background
 Line 2460 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 44]
+ Schoenebeck              Expires October 3, 2008               [Page 44]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
     sampler channel.  This command has (currently) no way to define or
 Line 2516 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 45]
+ Schoenebeck              Expires October 3, 2008               [Page 45]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
 .4.4.  Getting all created sampler channel list
 Line 2572 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 46]
+ Schoenebeck              Expires October 3, 2008               [Page 46]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
           in case a new channel was added successfully, but there are
 Line 2628 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 47]
+ Schoenebeck              Expires October 3, 2008               [Page 47]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
 .4.7.  Getting amount of available engines
 Line 2684 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 48]
+ Schoenebeck              Expires October 3, 2008               [Page 48]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
     Possible Answers:
 Line 2740 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 49]
+ Schoenebeck              Expires October 3, 2008               [Page 49]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
        following categories are defined:
 Line 2796 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 50]
+ Schoenebeck              Expires October 3, 2008               [Page 50]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
           INSTRUMENT_STATUS -
 Line 2852 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 51]
+ Schoenebeck              Expires October 3, 2008               [Page 51]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
     The mentioned fields above don't have to be in particular order.
 Line 2908 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 52]
+ Schoenebeck              Expires October 3, 2008               [Page 52]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
     is interested in as returned by the "ADD CHANNEL" (Section 6.4.5) or
 Line 2964 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 53]
+ Schoenebeck              Expires October 3, 2008               [Page 53]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
     command.
 Line 3020 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 54]
+ Schoenebeck              Expires October 3, 2008               [Page 54]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
        "OK" -
 Line 3076 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 55]
+ Schoenebeck              Expires October 3, 2008               [Page 55]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
     Examples:
 Line 3132 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 56]
+ Schoenebeck              Expires October 3, 2008               [Page 56]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
     the "ADD CHANNEL" (Section 6.4.5) or "LIST CHANNELS" (Section 6.4.4)
 Line 3188 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 57]
+ Schoenebeck              Expires October 3, 2008               [Page 57]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
           message
 Line 3244 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 58]
+ Schoenebeck              Expires October 3, 2008               [Page 58]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
        SET CHANNEL MIDI_INPUT_CHANNEL <sampler-channel> <midi-input-chan>
 Line 3300 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 59]
+ Schoenebeck              Expires October 3, 2008               [Page 59]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
           if channel volume was set, but there are noteworthy issue(s)
 Line 3356 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 60]
+ Schoenebeck              Expires October 3, 2008               [Page 60]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
 .4.23.  Soloing a sampler channel
 Line 3412 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 61]
+ Schoenebeck              Expires October 3, 2008               [Page 61]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
           This is the default setting.  In this case the sampler channel
 Line 3468 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 62]
+ Schoenebeck              Expires October 3, 2008               [Page 62]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
     effect send entity.  The name does not have to be unique, but MUST be
 Line 3524 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 63]
+ Schoenebeck              Expires October 3, 2008               [Page 63]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
 .4.26.  Removing an effect send from a sampler channel
 Line 3580 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 64]
+ Schoenebeck              Expires October 3, 2008               [Page 64]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
        C: "GET FX_SENDS 0"
 Line 3636 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 65]
+ Schoenebeck              Expires October 3, 2008               [Page 65]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
        character string to that setting category.  At the moment the
 Line 3692 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 66]
+ Schoenebeck              Expires October 3, 2008               [Page 66]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
 .4.30.  Changing effect send's name
 Line 3748 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 67]
+ Schoenebeck              Expires October 3, 2008               [Page 67]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
     of the effect send's audio channel which should be rerouted and
 Line 3804 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 68]
+ Schoenebeck              Expires October 3, 2008               [Page 68]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
     "ADD CHANNEL" (Section 6.4.5) or "LIST CHANNELS" (Section 6.4.4)
 Line 3860 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 69]
+ Schoenebeck              Expires October 3, 2008               [Page 69]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
        "OK" -
 Line 3916 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 70]
+ Schoenebeck              Expires October 3, 2008               [Page 70]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
           in case it failed, providing an appropriate error code and
 Line 3972 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 71]
+ Schoenebeck              Expires October 3, 2008               [Page 71]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
        UNSUBSCRIBE <event-id>
 Line 4028 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 72]
+ Schoenebeck              Expires October 3, 2008               [Page 72]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
        "ERR:<error-code>:<error-message>" -
 Line 4084 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 73]
+ Schoenebeck              Expires October 3, 2008               [Page 73]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
 .6.3.  Current number of active disk streams
 Line 4140 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 74]
+ Schoenebeck              Expires October 3, 2008               [Page 74]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
              arbitrary textual description about the sampler (note that
 Line 4196 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 75]
+ Schoenebeck              Expires October 3, 2008               [Page 75]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
     attenuating the overall volume.
 Line 4252 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 76]
+ Schoenebeck              Expires October 3, 2008               [Page 76]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
 .7.1.  Create a new MIDI instrument map
 Line 4308 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 77]
+ Schoenebeck              Expires October 3, 2008               [Page 77]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
     The front-end can delete all MIDI instrument maps by sending the
 Line 4364 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 78]
+ Schoenebeck              Expires October 3, 2008               [Page 78]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
        LIST MIDI_INSTRUMENT_MAPS
 Line 4420 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 79]
+ Schoenebeck              Expires October 3, 2008               [Page 79]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
        C: "GET MIDI_INSTRUMENT_MAP INFO 0"
 Line 4476 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 80]
+ Schoenebeck              Expires October 3, 2008               [Page 80]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
     <midi_prog> an integer value between 0..127 reflecting the MIDI
 Line 4532 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 81]
+ Schoenebeck              Expires October 3, 2008               [Page 81]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
           instrument does not exist in the InstrumentManager's list yet,
 Line 4588 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 82]
+ Schoenebeck              Expires October 3, 2008               [Page 82]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
        "ERR:<error-code>:<error-message>" -
 Line 4644 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 83]
+ Schoenebeck              Expires October 3, 2008               [Page 83]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
        The sampler will answer by sending the current number of entries
 Line 4700 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 84]
+ Schoenebeck              Expires October 3, 2008               [Page 84]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
        UNMAP MIDI_INSTRUMENT <map> <midi_bank> <midi_prog>
 Line 4756 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 85]
+ Schoenebeck              Expires October 3, 2008               [Page 85]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
           mapped instrument.  It can be set and changed with the "MAP
 Line 4812 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 86]
+ Schoenebeck              Expires October 3, 2008               [Page 86]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
           "INSTRUMENT_NR: 0"
 Line 4868 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 87]
+ Schoenebeck              Expires October 3, 2008               [Page 87]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
 .8.  Managing Instruments Database
 Line 4924 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 88]
+ Schoenebeck              Expires October 3, 2008               [Page 88]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
        REMOVE DB_INSTRUMENT_DIRECTORY [FORCE] <dir>
 Line 4980 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 89]
+ Schoenebeck              Expires October 3, 2008               [Page 89]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
        C: "GET DB_INSTRUMENT_DIRECTORIES '/'"
 Line 5036 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 90]
+ Schoenebeck              Expires October 3, 2008               [Page 90]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
        LinuxSampler will answer by sending a <CRLF> separated list.  Each
 Line 5092 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 91]
+ Schoenebeck              Expires October 3, 2008               [Page 91]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
     Possible Answers:
 Line 5148 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 92]
+ Schoenebeck              Expires October 3, 2008               [Page 92]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
 .8.8.  Copying instrument directories
 Line 5204 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 93]
+ Schoenebeck              Expires October 3, 2008               [Page 93]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
        "ERR:<error-code>:<error-message>" -
 Line 5260 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 94]
+ Schoenebeck              Expires October 3, 2008               [Page 94]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
        are last modified before <date-before>.  If <date-before> is
 Line 5316 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 95]
+ Schoenebeck              Expires October 3, 2008               [Page 95]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
     file is supplied, only the instruments in the specified file will be
 Line 5372 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 96]
+ Schoenebeck              Expires October 3, 2008               [Page 96]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
           if an invalid path is specified.
 Line 5428 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 97]
+ Schoenebeck              Expires October 3, 2008               [Page 97]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
        The current number of instruments in the specified directory.
 Line 5484 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 98]
+ Schoenebeck              Expires October 3, 2008               [Page 98]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
 .8.15.  Getting instrument information
 Line 5540 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008               [Page 99]
+ Schoenebeck              Expires October 3, 2008               [Page 99]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
           MODIFIED -
 Line 5596 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008              [Page 100]
+ Schoenebeck              Expires October 3, 2008              [Page 100]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
           "SIZE: 2050871870"
 Line 5652 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008              [Page 101]
+ Schoenebeck              Expires October 3, 2008              [Page 101]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
 .8.17.  Moving an instrument
 Line 5708 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008              [Page 102]
+ Schoenebeck              Expires October 3, 2008              [Page 102]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
           in case the given instrument does not exists, or if an
 Line 5764 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008              [Page 103]
+ Schoenebeck              Expires October 3, 2008              [Page 103]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
     directory to search in.  If NON_RECURSIVE is specified, the
 Line 5820 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008              [Page 104]
+ Schoenebeck              Expires October 3, 2008              [Page 104]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
        Restricts the search to instruments with product info that
 Line 5876 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008              [Page 105]
+ Schoenebeck              Expires October 3, 2008              [Page 105]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
        S: "'/Piano Collection/Bosendorfer 290'"
 Line 5932 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008              [Page 106]
+ Schoenebeck              Expires October 3, 2008              [Page 106]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
     Example:
 Line 5969 
 Internet-Draft        LinuxSampler Contr
           If the formatting of the instruments database failed.
+.8.23.  Checking for lost instrument files
+    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:
+       FIND LOST DB_INSTRUMENT_FILES
+    Possible Answers:
+       A comma separated list with the absolute path names (encapsulated
+       into apostrophes) of all lost instrument files.
+       "ERR:<error-code>:<error-message>" -
+ Schoenebeck              Expires October 3, 2008              [Page 107]
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
+          in case it failed, providing an appropriate error code and
+          error message.
+    Example:
+       C: "FIND LOST DB_INSTRUMENT_FILES"
+       S: "'/gigs/Bosendorfer 290.gig','/gigs/Steinway D.gig','/gigs/Free
+       Piano.gig'"
+.8.24.  Replacing an instrument file
+    The front-end can substitute all occurrences of an instrument file in
+    the instruments database with a new one by sending the following
+    command:
+       SET DB_INSTRUMENT FILE_PATH <old_path> <new_path>
+    Where <old_path> is the absolute path name of the instrument file to
+    substitute with <new_path>.
+    Possible Answers:
+       "OK" -
+          on success
+       "ERR:<error-code>:<error-message>" -
+          in case it failed, providing an appropriate error code and
+          error message.
+    Example:
+       C: "SET DB_INSTRUMENT FILE_PATH '/gigs/Bosendorfer 290.gig'
+       '/gigs/pianos/Bosendorfer 290.gig'"
+       S: "OK"
 .9.  Editing Instruments
     The sampler allows to edit instruments while playing with the sampler
-Line 5978 
 Internet-Draft        LinuxSampler Contr
+Line 6041 
 Internet-Draft        LinuxSampler Contr
     directory.  The sampler will automatically try to load all plugin
     DLLs in that directory on startup and only on startup!
+ Schoenebeck              Expires October 3, 2008              [Page 108]
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
     At the moment there is only one command for this feature set, but
     this will most probably change in future.
-Line 5986 
 Internet-Draft        LinuxSampler Contr
+Line 6057 
 Internet-Draft        LinuxSampler Contr
     The front-end can request to open an appropriate instrument editor
     application by sending the following command:
- Schoenebeck              Expires August 17, 2008              [Page 107]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
        EDIT CHANNEL INSTRUMENT <sampler-channel>
     Where <sampler-channel> should be replaced by the number of the
-Line 6032 
 Internet-Draft        LinuxSampler Contr
+Line 6096 
 Internet-Draft        LinuxSampler Contr
        C: "EDIT CHANNEL INSTRUMENT 0"
+ Schoenebeck              Expires October 3, 2008              [Page 109]
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
        S: "OK"
 .10.  Managing Files
-Line 6041 
 Internet-Draft        LinuxSampler Contr
+Line 6114 
 Internet-Draft        LinuxSampler Contr
     set allows to retrieve file informations even remotely from another
     machine.
- Schoenebeck              Expires August 17, 2008              [Page 108]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
 .10.1.  Retrieving amount of instruments of a file
     The front-end can retrieve the amount of instruments within a given
-Line 6088 
 Internet-Draft        LinuxSampler Contr
+Line 6153 
 Internet-Draft        LinuxSampler Contr
     Where <filename> is the name of the instrument file (encapsulated
     into apostrophes, supporting escape sequences as described in chapter
-    "Character Set and Escape Sequences (Section 7.1)").
-    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.
-    Possible Answers:
+ Schoenebeck              Expires October 3, 2008              [Page 110]
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
+    "Character Set and Escape Sequences (Section 7.1)").
- Schoenebeck              Expires August 17, 2008              [Page 109]
+    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
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+    list of IDs for the instruments in the given file.
+    Possible Answers:
        On success, the sampler will answer by returning a comma separated
        list of instrument IDs.
-Line 6146 
 Internet-Draft        LinuxSampler Contr
+Line 6210 
 Internet-Draft        LinuxSampler Contr
-          NAME -
-             name of the instrument as stored in the instrument file
-          FORMAT_FAMILY -
+ Schoenebeck              Expires October 3, 2008              [Page 111]
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
+          NAME -
- Schoenebeck              Expires August 17, 2008              [Page 110]
+             name of the instrument as stored in the instrument file
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+          FORMAT_FAMILY -
              name of the sampler format of the given instrument
-Line 6204 
 Internet-Draft        LinuxSampler Contr
+Line 6268 
 Internet-Draft        LinuxSampler Contr
+ Schoenebeck              Expires October 3, 2008              [Page 112]
- Schoenebeck              Expires August 17, 2008              [Page 111]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
 .  Command Syntax
-Line 6268 
 Internet-Draft        LinuxSampler Contr
+Line 6324 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008              [Page 112]
+ Schoenebeck              Expires October 3, 2008              [Page 113]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
        / LIST SP list_instruction
-Line 6324 
 Internet-Draft        LinuxSampler Contr
+Line 6380 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008              [Page 113]
+ Schoenebeck              Expires October 3, 2008              [Page 114]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
        / DB_INSTRUMENTS SP db_path SP filename SP instrument_index
-Line 6349 
 Internet-Draft        LinuxSampler Contr
+Line 6405 
 Internet-Draft        LinuxSampler Contr
        / CHANNEL_MIDI
+       / DEVICE_MIDI
        / VOICE_COUNT
        / STREAM_COUNT
-Line 6375 
 Internet-Draft        LinuxSampler Contr
+Line 6433 
 Internet-Draft        LinuxSampler Contr
        / DB_INSTRUMENT_COUNT
-       / DB_INSTRUMENT_INFO
- Schoenebeck              Expires August 17, 2008              [Page 114]
+ Schoenebeck              Expires October 3, 2008              [Page 115]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
+       / DB_INSTRUMENT_INFO
        / DB_INSTRUMENTS_JOB_INFO
        / MISCELLANEOUS
-Line 6409 
 Internet-Draft        LinuxSampler Contr
+Line 6467 
 Internet-Draft        LinuxSampler Contr
        / CHANNEL_MIDI
+       / DEVICE_MIDI
        / VOICE_COUNT
        / STREAM_COUNT
-Line 6429 
 Internet-Draft        LinuxSampler Contr
+Line 6489 
 Internet-Draft        LinuxSampler Contr
        / MIDI_INSTRUMENT_INFO
-       / DB_INSTRUMENT_DIRECTORY_COUNT
-       / DB_INSTRUMENT_DIRECTORY_INFO
+ Schoenebeck              Expires October 3, 2008              [Page 116]
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
- Schoenebeck              Expires August 17, 2008              [Page 115]
+       / DB_INSTRUMENT_DIRECTORY_COUNT
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+       / DB_INSTRUMENT_DIRECTORY_INFO
        / DB_INSTRUMENT_COUNT
-Line 6484 
 Internet-Draft        LinuxSampler Contr
+Line 6544 
 Internet-Draft        LinuxSampler Contr
        / MIDI_INSTRUMENT_MAP SP ALL
-       / DB_INSTRUMENT_DIRECTORY SP FORCE SP db_path
-       / DB_INSTRUMENT_DIRECTORY SP db_path
+ Schoenebeck              Expires October 3, 2008              [Page 117]
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
- Schoenebeck              Expires August 17, 2008              [Page 116]
+       / DB_INSTRUMENT_DIRECTORY SP FORCE SP db_path
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+       / DB_INSTRUMENT_DIRECTORY SP db_path
        / DB_INSTRUMENT SP db_path
-Line 6540 
 Internet-Draft        LinuxSampler Contr
+Line 6600 
 Internet-Draft        LinuxSampler Contr
        / CHANNELS
-       / CHANNEL SP INFO SP sampler_channel
-       / CHANNEL SP BUFFER_FILL SP buffer_size_type SP sampler_channel
+ Schoenebeck              Expires October 3, 2008              [Page 118]
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
- Schoenebeck              Expires August 17, 2008              [Page 117]
+       / CHANNEL SP INFO SP sampler_channel
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+       / CHANNEL SP BUFFER_FILL SP buffer_size_type SP sampler_channel
        / CHANNEL SP STREAM_COUNT SP sampler_channel
-Line 6597 
 Internet-Draft        LinuxSampler Contr
+Line 6657 
 Internet-Draft        LinuxSampler Contr
        / VOLUME
-       / FILE SP INSTRUMENTS SP filename
-       / FILE SP INSTRUMENT SP INFO SP filename SP instrument_index
+ Schoenebeck              Expires October 3, 2008              [Page 119]
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
- Schoenebeck              Expires August 17, 2008              [Page 118]
+       / FILE SP INSTRUMENTS SP filename
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+       / FILE SP INSTRUMENT SP INFO SP filename SP instrument_index
     set_instruction =
-Line 6649 
 Internet-Draft        LinuxSampler Contr
+Line 6709 
 Internet-Draft        LinuxSampler Contr
        / DB_INSTRUMENT SP DESCRIPTION SP db_path SP stringval_escaped
+       / DB_INSTRUMENT SP FILE_PATH SP filename SP filename
        / ECHO SP boolean
-       / VOLUME SP volume_value
-    create_instruction =
-       AUDIO_OUTPUT_DEVICE SP string SP key_val_list
+ Schoenebeck              Expires October 3, 2008              [Page 120]
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
+       / VOLUME SP volume_value
- Schoenebeck              Expires August 17, 2008              [Page 119]
+    create_instruction =
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+       AUDIO_OUTPUT_DEVICE SP string SP key_val_list
        / AUDIO_OUTPUT_DEVICE SP string
-Line 6696 
 Internet-Draft        LinuxSampler Contr
+Line 6758 
 Internet-Draft        LinuxSampler Contr
        / DB_INSTRUMENT_DIRECTORIES SP db_path SP query_val_list
+       / LOST SP DB_INSTRUMENT_FILES
     move_instruction =
        DB_INSTRUMENT_DIRECTORY SP db_path SP db_path
-Line 6704 
 Internet-Draft        LinuxSampler Contr
+Line 6768 
 Internet-Draft        LinuxSampler Contr
     copy_instruction =
-       DB_INSTRUMENT_DIRECTORY SP db_path SP db_path
-       / DB_INSTRUMENT SP db_path SP db_path
-    destroy_instruction =
-       AUDIO_OUTPUT_DEVICE SP number
+ Schoenebeck              Expires October 3, 2008              [Page 121]
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
+       DB_INSTRUMENT_DIRECTORY SP db_path SP db_path
+       / DB_INSTRUMENT SP db_path SP db_path
- Schoenebeck              Expires August 17, 2008              [Page 120]
+    destroy_instruction =
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+       AUDIO_OUTPUT_DEVICE SP number
        / MIDI_INPUT_DEVICE SP number
-Line 6760 
 Internet-Draft        LinuxSampler Contr
+Line 6824 
 Internet-Draft        LinuxSampler Contr
        / MIDI_INSTRUMENT_MAP SP sampler_channel SP midi_map
+ Schoenebeck              Expires October 3, 2008              [Page 122]
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
        / MIDI_INSTRUMENT_MAP SP sampler_channel SP NONE
        / MIDI_INSTRUMENT_MAP SP sampler_channel SP DEFAULT
-Line 6770 
 Internet-Draft        LinuxSampler Contr
+Line 6843 
 Internet-Draft        LinuxSampler Contr
     format_instruction =
- Schoenebeck              Expires August 17, 2008              [Page 121]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
        INSTRUMENTS_DB
     modal_arg =
-Line 6815 
 Internet-Draft        LinuxSampler Contr
+Line 6881 
 Internet-Draft        LinuxSampler Contr
        / MIDI_INSTRUMENTS SP ALL
-       / MIDI_INSTRUMENT_MAPS
-       / FX_SENDS SP sampler_channel
-       / DB_INSTRUMENT_DIRECTORIES SP RECURSIVE SP db_path
-       / DB_INSTRUMENT_DIRECTORIES SP db_path
+ Schoenebeck              Expires October 3, 2008              [Page 123]
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
-       / DB_INSTRUMENTS SP RECURSIVE SP db_path
+       / MIDI_INSTRUMENT_MAPS
+       / FX_SENDS SP sampler_channel
+       / DB_INSTRUMENT_DIRECTORIES SP RECURSIVE SP db_path
- Schoenebeck              Expires August 17, 2008              [Page 122]
+       / DB_INSTRUMENT_DIRECTORIES SP db_path
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+       / DB_INSTRUMENTS SP RECURSIVE SP db_path
        / DB_INSTRUMENTS SP db_path
-Line 6871 
 Internet-Draft        LinuxSampler Contr
+Line 6937 
 Internet-Draft        LinuxSampler Contr
        number
-    midi_input_channel_index =
-       number
-       / ALL
-    midi_input_type_name =
+ Schoenebeck              Expires October 3, 2008              [Page 124]
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
-       string
+    midi_input_channel_index =
+       number
+       / ALL
- Schoenebeck              Expires August 17, 2008              [Page 123]
+    midi_input_type_name =
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+       string
     midi_map =
-Line 6927 
 Internet-Draft        LinuxSampler Contr
+Line 6993 
 Internet-Draft        LinuxSampler Contr
        string
-    filename =
-       path
-    db_path =
-       path
+ Schoenebeck              Expires October 3, 2008              [Page 125]
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
-    map_name =
+    filename =
+       path
+    db_path =
- Schoenebeck              Expires August 17, 2008              [Page 124]
+       path
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+    map_name =
        stringval_escaped
-Line 6983 
 Internet-Draft        LinuxSampler Contr
+Line 7049 
 Internet-Draft        LinuxSampler Contr
        / stringval_escaped
-    scan_mode =
-       RECURSIVE
-       / NON_RECURSIVE
-       / FLAT
+ Schoenebeck              Expires October 3, 2008              [Page 126]
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
+    scan_mode =
+       RECURSIVE
- Schoenebeck              Expires August 17, 2008              [Page 125]
+       / NON_RECURSIVE
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+       / FLAT
 .1.  Character Set and Escape Sequences
-Line 7041 
 Internet-Draft        LinuxSampler Contr
+Line 7105 
 Internet-Draft        LinuxSampler Contr
     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
+ Schoenebeck              Expires October 3, 2008              [Page 127]
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
     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
-Line 7050 
 Internet-Draft        LinuxSampler Contr
+Line 7122 
 Internet-Draft        LinuxSampler Contr
     filename / path based arguments and / or may contain a filename /
     path with escape sequences in their response:
- Schoenebeck              Expires August 17, 2008              [Page 126]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
        "LOAD INSTRUMENT" (Section 6.4.1)
        "GET CHANNEL INFO" (Section 6.4.10)
-Line 7095 
 Internet-Draft        LinuxSampler Contr
+Line 7160 
 Internet-Draft        LinuxSampler Contr
        "FIND DB_INSTRUMENTS" (Section 6.8.20)
+ Schoenebeck              Expires October 3, 2008              [Page 128]
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
        "FIND DB_INSTRUMENT_DIRECTORIES" (Section 6.8.10)
        "MOVE DB_INSTRUMENT" (Section 6.8.17)
-Line 7105 
 Internet-Draft        LinuxSampler Contr
+Line 7179 
 Internet-Draft        LinuxSampler Contr
        "COPY DB_INSTRUMENT_DIRECTORY" (Section 6.8.8)
+       "FIND LOST DB_INSTRUMENT_FILES" (Section 6.8.23)
+       "SET DB_INSTRUMENT FILE_PATH" (Section 6.8.24)
- Schoenebeck              Expires August 17, 2008              [Page 127]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
        "GET FILE INSTRUMENTS" (Section 6.10.1)
-Line 7146 
 Internet-Draft        LinuxSampler Contr
+Line 7216 
 Internet-Draft        LinuxSampler Contr
        "CREATE FX_SEND" (Section 6.4.25)
+ Schoenebeck              Expires October 3, 2008              [Page 129]
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
        "GET FX_SEND INFO" (Section 6.4.29)
        "SET FX_SEND NAME" (Section 6.4.30)
-Line 7160 
 Internet-Draft        LinuxSampler Contr
+Line 7239 
 Internet-Draft        LinuxSampler Contr
        "SET MIDI_INSTRUMENT_MAP NAME" (Section 6.7.6)
- Schoenebeck              Expires August 17, 2008              [Page 128]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
        "GET DB_INSTRUMENT_DIRECTORY INFO" (Section 6.8.5)
        "SET DB_INSTRUMENT_DIRECTORY NAME" (Section 6.8.6)
-Line 7206 
 Internet-Draft        LinuxSampler Contr
+Line 7276 
 Internet-Draft        LinuxSampler Contr
+ Schoenebeck              Expires October 3, 2008              [Page 130]
- Schoenebeck              Expires August 17, 2008              [Page 129]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
 .  Events
-Line 7276 
 Internet-Draft        LinuxSampler Contr
+Line 7332 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008              [Page 130]
+ Schoenebeck              Expires October 3, 2008              [Page 131]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
        "NOTIFY:MIDI_INPUT_DEVICE_COUNT:<devices>"
-Line 7332 
 Internet-Draft        LinuxSampler Contr
+Line 7388 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008              [Page 131]
+ Schoenebeck              Expires October 3, 2008              [Page 132]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
        "NOTIFY:CHANNEL_MIDI:<channel-id> NOTE_ON <note> <velocity>"
-Line 7352 
 Internet-Draft        LinuxSampler Contr
+Line 7408 
 Internet-Draft        LinuxSampler Contr
     safeness of the backend's MIDI and audio thread unaffected by this
     feature.
-.7.  Number of active voices changed
+.7.  MIDI data on a MIDI input device arrived
+    Client may want to be notified when MIDI data arrive on MIDI input
+    devices by issuing the following command:
+       SUBSCRIBE DEVICE_MIDI
+    Server will start sending one of the the following notification
+    messages:
+       "NOTIFY:DEVICE_MIDI:<device-id> <port-id> NOTE_ON <note>
+       <velocity>"
+       "NOTIFY:DEVICE_MIDI:<device-id> <port-id> NOTE_OFF <note>
+       <velocity>"
+    where <device-id> <port-id> will be replaced by the IDs of the
+    respective MIDI input device and the device's MIDI port where the
+    MIDI data arrived. <note> and <velocity> are integer values in the
+    range between 0 .. 127, reflecting the analog meaning of the MIDI
+    specification.
+    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.
+.8.  Number of active voices changed
     Client may want to be notified when the number of voices on the back-
     end changes by issuing the following command:
+ Schoenebeck              Expires October 3, 2008              [Page 133]
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
        SUBSCRIBE VOICE_COUNT
     Server will start sending the following notification messages:
-Line 7367 
 Internet-Draft        LinuxSampler Contr
+Line 7459 
 Internet-Draft        LinuxSampler Contr
     voice count change occurred and <voices> by the new number of active
     voices on that channel.
-.8.  Number of active disk streams changed
+.9.  Number of active disk streams changed
     Client may want to be notified when the number of streams on the
     back-end changes by issuing the following command: SUBSCRIBE
-Line 7383 
 Internet-Draft        LinuxSampler Contr
+Line 7475 
 Internet-Draft        LinuxSampler Contr
     stream count change occurred and <streams> by the new number of
     active disk streams on that channel.
+.10.  Disk stream buffer fill state changed
- Schoenebeck              Expires August 17, 2008              [Page 132]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
-.9.  Disk stream buffer fill state changed
     Client may want to be notified when the buffer fill state of a disk
     stream on the back-end changes by issuing the following command:
-Line 7410 
 Internet-Draft        LinuxSampler Contr
+Line 7492 
 Internet-Draft        LinuxSampler Contr
     Section 6.4.13 as if the "GET CHANNEL BUFFER_FILL PERCENTAGE"
     (Section 6.4.13) command was issued on this channel.
-.10.  Channel information changed
+.11.  Channel information changed
     Client may want to be notified when changes were made to sampler
     channels on the back-end by issuing the following command:
+ Schoenebeck              Expires October 3, 2008              [Page 134]
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
        SUBSCRIBE CHANNEL_INFO
     Server will start sending the following notification messages:
-Line 7428 
 Internet-Draft        LinuxSampler Contr
+Line 7518 
 Internet-Draft        LinuxSampler Contr
     rather than real time events happening on the server, it is believed
     that an empty notification message is sufficient here.
-.11.  Number of effect sends changed
+.12.  Number of effect sends changed
     Client may want to be notified when the number of effect sends on a
     particular sampler channel is changed by issuing the following
-Line 7441 
 Internet-Draft        LinuxSampler Contr
+Line 7531 
 Internet-Draft        LinuxSampler Contr
        "NOTIFY:FX_SEND_COUNT:<channel-id> <fx-sends>"
     where <channel-id> will be replaced by the numerical ID of the
- Schoenebeck              Expires August 17, 2008              [Page 133]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
     sampler channel, on which the effect sends number is changed and <fx-
     sends> will be replaced by the new number of effect sends on that
     channel.
-.12.  Effect send information changed
+.13.  Effect send information changed
     Client may want to be notified when changes were made to effect sends
     on a a particular sampler channel by issuing the following command:
-Line 7469 
 Internet-Draft        LinuxSampler Contr
+Line 7551 
 Internet-Draft        LinuxSampler Contr
     send-id> will be replaced by the numerical ID of the changed effect
     send.
-.13.  Total number of active voices changed
+ Schoenebeck              Expires October 3, 2008              [Page 135]
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
+.14.  Total number of active voices changed
     Client may want to be notified when the total number of voices on the
     back-end changes by issuing the following command:
-Line 7483 
 Internet-Draft        LinuxSampler Contr
+Line 7575 
 Internet-Draft        LinuxSampler Contr
     where <voices> will be replaced by the new number of all currently
     active voices.
-.14.  Total number of active disk streams changed
+.15.  Total number of active disk streams changed
     Client may want to be notified when the total number of disk streams
     on the back-end changes by issuing the following command:
-Line 7497 
 Internet-Draft        LinuxSampler Contr
+Line 7589 
 Internet-Draft        LinuxSampler Contr
     where <streams> will be replaced by the new number of all currently
     active disk streams.
+.16.  Number of MIDI instrument maps changed
- Schoenebeck              Expires August 17, 2008              [Page 134]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
-.15.  Number of MIDI instrument maps changed
     Client may want to be notified when the number of MIDI instrument
     maps on the back-end changes by issuing the following command:
-Line 7519 
 Internet-Draft        LinuxSampler Contr
+Line 7603 
 Internet-Draft        LinuxSampler Contr
     where <maps> will be replaced by the new number of MIDI instrument
     maps.
-.16.  MIDI instrument map information changed
+.17.  MIDI instrument map information changed
     Client may want to be notified when changes were made to MIDI
     instrument maps on the back-end by issuing the following command:
+ Schoenebeck              Expires October 3, 2008              [Page 136]
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
        SUBSCRIBE MIDI_INSTRUMENT_MAP_INFO
     Server will start sending the following notification messages:
-Line 7538 
 Internet-Draft        LinuxSampler Contr
+Line 7631 
 Internet-Draft        LinuxSampler Contr
     happening on the server, it is believed that an empty notification
     message is sufficient here.
-.17.  Number of MIDI instruments changed
+.18.  Number of MIDI instruments changed
     Client may want to be notified when the number of MIDI instrument
     maps on the back-end changes by issuing the following command:
-Line 7553 
 Internet-Draft        LinuxSampler Contr
+Line 7646 
 Internet-Draft        LinuxSampler Contr
     which the nuber of instruments has changed and <instruments> will be
     replaced by the new number of MIDI instruments in the specified map.
+.19.  MIDI instrument information changed
- Schoenebeck              Expires August 17, 2008              [Page 135]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
-.18.  MIDI instrument information changed
     Client may want to be notified when changes were made to MIDI
     instruments on the back-end by issuing the following command:
-Line 7581 
 Internet-Draft        LinuxSampler Contr
+Line 7666 
 Internet-Draft        LinuxSampler Contr
     real time events happening on the server, it is believed that an
     empty notification message is sufficient here.
-.19.  Global settings changed
+ Schoenebeck              Expires October 3, 2008              [Page 137]
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
+.20.  Global settings changed
     Client may want to be notified when changes to the global settings of
     the sampler were made by issuing the following command:
-Line 7596 
 Internet-Draft        LinuxSampler Contr
+Line 7688 
 Internet-Draft        LinuxSampler Contr
        by the optional dotted floating point value, reflecting the new
        global volume parameter.
-.20.  Number of database instrument directories changed
+.21.  Number of database instrument directories changed
     Client may want to be notified when the number of instrument
     directories in a particular directory in the instruments database is
-Line 7609 
 Internet-Draft        LinuxSampler Contr
+Line 7701 
 Internet-Draft        LinuxSampler Contr
        "NOTIFY:DB_INSTRUMENT_DIRECTORY_COUNT:<dir-path>"
     where <dir-path> will be replaced by the absolute path name of the
- Schoenebeck              Expires August 17, 2008              [Page 136]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
     directory in the instruments database, in which the number of
     directories is changed.
     Note that when a non-empty directory is removed, this event is not
     sent for the subdirectories in that directory.
-.21.  Database instrument directory information changed
+.22.  Database instrument directory information changed
     Client may want to be notified when changes were made to directories
     in the instruments database by issuing the following command:
-Line 7637 
 Internet-Draft        LinuxSampler Contr
+Line 7721 
 Internet-Draft        LinuxSampler Contr
     where <dir-path> will be replaced by the absolute path name of the
     directory, for which information changes occurred.  The front-end
     will have to send the respective command to actually get the updated
+ Schoenebeck              Expires October 3, 2008              [Page 138]
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
     directory info.  Because these messages will be triggered by LSCP
     commands issued by other clients rather than real time events
     happening on the server, it is believed that an empty notification
-Line 7649 
 Internet-Draft        LinuxSampler Contr
+Line 7741 
 Internet-Draft        LinuxSampler Contr
     (encapsulated into apostrophes), which name is changes and <new-name>
     is the new name of the directory, encapsulated into apostrophes.
-.22.  Number of database instruments changed
+.23.  Number of database instruments changed
     Client may want to be notified when the number of instruments in a
     particular directory in the instruments database is changed by
-Line 7665 
 Internet-Draft        LinuxSampler Contr
+Line 7757 
 Internet-Draft        LinuxSampler Contr
     directory in the instruments database, in which the number of
     instruments is changed.
- Schoenebeck              Expires August 17, 2008              [Page 137]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
     Note that when a non-empty directory is removed, this event is not
     sent for the instruments in that directory.
-.23.  Database instrument information changed
+.24.  Database instrument information changed
     Client may want to be notified when changes were made to instruments
     in the instruments database by issuing the following command:
-Line 7693 
 Internet-Draft        LinuxSampler Contr
+Line 7777 
 Internet-Draft        LinuxSampler Contr
     info.  Because these messages will be triggered by LSCP commands
     issued by other clients rather than real time events happening on the
     server, it is believed that an empty notification message is
+ Schoenebeck              Expires October 3, 2008              [Page 139]
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
     sufficient here.
        "NOTIFY:DB_INSTRUMENT_INFO:NAME <old-instr-path> <new-name>"
-Line 7702 
 Internet-Draft        LinuxSampler Contr
+Line 7794 
 Internet-Draft        LinuxSampler Contr
     <new-name> is the new name of the instrument, encapsulated into
     apostrophes.
-.24.  Database job status information changed
+.25.  Database job status information changed
     Client may want to be notified when the status of particular database
     instruments job is changed by issuing the following command:
-Line 7720 
 Internet-Draft        LinuxSampler Contr
+Line 7812 
 Internet-Draft        LinuxSampler Contr
     real time events happening on the server, it is believed that an
     empty notification message is sufficient here.
+.26.  Miscellaneous and debugging events
- Schoenebeck              Expires August 17, 2008              [Page 138]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
-.25.  Miscellaneous and debugging events
     Client may want to be notified of miscellaneous and debugging events
     occurring at the server by issuing the following command:
-Line 7753 
 Internet-Draft        LinuxSampler Contr
+Line 7836 
 Internet-Draft        LinuxSampler Contr
+ Schoenebeck              Expires October 3, 2008              [Page 140]
- Schoenebeck              Expires August 17, 2008              [Page 139]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
 .  Security Considerations
-Line 7836 
 Internet-Draft        LinuxSampler Contr
+Line 7892 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008              [Page 140]
+ Schoenebeck              Expires October 3, 2008              [Page 141]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
 .  Acknowledgments
-Line 7892 
 Internet-Draft        LinuxSampler Contr
+Line 7948 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008              [Page 141]
+ Schoenebeck              Expires October 3, 2008              [Page 142]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
 .  References
-Line 7948 
 Internet-Draft        LinuxSampler Contr
+Line 8004 
 Internet-Draft        LinuxSampler Contr
- Schoenebeck              Expires August 17, 2008              [Page 142]
+ Schoenebeck              Expires October 3, 2008              [Page 143]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
  Author's Address
-Line 8004 
 Author's Address
+Line 8060 
 Author's Address
- Schoenebeck              Expires August 17, 2008              [Page 143]
+ Schoenebeck              Expires October 3, 2008              [Page 144]
- Internet-Draft        LinuxSampler Control Protocol        February 2008
+ Internet-Draft        LinuxSampler Control Protocol           April 2008
  Full Copyright Statement
-Line 8051 
 Intellectual Property
+Line 8107 
 Intellectual Property
     ietf-ipr@ietf.org.
- Acknowledgment
-    Funding for the RFC Editor function is provided by the IETF
-    Administrative Support Activity (IASA).
- Schoenebeck              Expires August 17, 2008              [Page 144]
+ Schoenebeck              Expires October 3, 2008              [Page 145]

 Legend:



Removed from v.1685
 


changed lines


 
Added in v.1731
 Legend:



Removed from v.1685
 


changed lines


 
Added in v.1731
-Removed from v.1685
+Added in v.1731

	ViewVC Help
Powered by ViewVC