xenial (7) oss_midiloop.7.gz

Provided by: oss4-base_4.2-build2010-5ubuntu1~16.04.2_amd64 bug

NAME

       oss_midiloop - Loopback MIDI driver.

DESCRIPTION

       The  loopback  midi driver makes it possible to create special purpose virtual midi devices based on user
       land server processes.

INTRODUCTION

       MIDI loopback devices are like named pipes or pseudo terminals. They are grouped  in  client  and  server
       device pairs. The server side device must be open before the client side device can be opened.

   SERVER SIDE DEVICE
       The server side device is used by some special application (such as a software based MIDI synthesizer) to
       receice MIDI events from the applications that want to play MIDI.

   CLIENT SIDE DEVICE
       Client applications such as MIDI players open the client side device when they need  to  play  some  MIDI
       stream  (file).  The  client  side  device  behaves like any "ordinary" MIDI device. However it cannot be
       opened when there is no program connected to the server side.

COMPATIBILITY ISSUES

       MIDI loopback devices differ from "normal" MIDI devices because an application is needed at the both ends
       of  the  loop.  The  loop  device  will  return  a  "Connection  reset by peer" error (ECONNRESET) error.
       Applications designed to be used  as  loopback  based  server  applications  can/should  use  this  error
       (returned by read or write) as an end-of-stream indication.

OPTIONS

       o midiloop_instances:
              Specifies how many loopback client/server MIDI device pairs to be created.

              Values: 1-16
                     Default: 1

KNOWN PROBLEMS

       None

FILES

       /etc/oss4/conf/oss_midiloop.conf Device configuration file

AUTHOR

       4Front Technologies

                                                  09 July 2018                                   oss_midiloop(7)