xenial (1) aconnect.1.gz

NAME

       aconnect - ALSA sequencer connection manager

SYNOPSIS

       aconnect [-d] [-options] sender receiver
       aconnect -i|-o [-options]
       aconnect -x

DESCRIPTION

       aconnect  is  a utility to connect and disconnect two existing ports on ALSA sequencer system.  The ports
       with the arbitrary subscription permission, such as created by  aseqview(1),  can  be  connected  to  any
       (MIDI) device ports using aconnect.  For example, to connect from port 64:0 to 65:0, run as follows:

           % aconnect 64:0 65:0

       The  connection  is  one-way,  and the whole data to the sender port (64:0) is redirected to the receiver
       port (65:0).  When another port (e.g. 65:1) is attached to the same sender port, the data is sent to both
       receiver ports.  For disconnection, use -d option.

       % aconnect -d 64:0 65:0

       The address can be given using the client's name.

       % aconnect External:0 Emu8000:1

       Then  the  port  0  of  the  client matching with the string "External" is connected to the port 1 of the
       client matching with the "Emu8000".

       Another function of aconnect is to list the present ports on the given condition.  The input ports, which
       may become sender ports, can be listed with -i option.

       % aconnect -i
       client 0: 'System' [type=kernel]
           0 'Timer           '
           1 'Announce        '
       client 64: 'External MIDI-0' [type=kernel]
           0 'MIDI 0-0        '

       Similarly, to see the output ports, use -o flag.

       You  can  remove  all  existing  exported  connections  using  -x  option.   This  function is useful for
       terminating the ALSA drivers, because the modules with sequencer connections cannot  be  unloaded  unless
       their connections are removed.

OPTIONS

   CONNECTION MANAGEMENT
       -d, --disconnect
              Disconnect the given subscription.

       -e, --exclusive
              Connect  ports  with exclusive mode.  Both sender and receiver ports can be no longer connected by
              any other ports.

       -r, --real queue
              Convert time-stamps of event packets to the current value of the given real-time queue.   This  is
              option  is,  however,  not  so  useful, since the receiver port must use (not necessarily own) the
              specified queue.

       -t, --tick queue
              Like -r option, but time-stamps are converted to the current value of the given tick queue.

   LIST PORTS
       -i, --input
              List existing input (readable) ports.  This option is exclusive to -o.

       -o, --output
              List existing output (writable) ports.  This option is exclusive to -i.

       -l, --list
              List the current connection status.  The connected and connecting  ports  from/to  each  port  are
              listed  together.   The  suffix  flag  [ex]  means  the  connection is exclusive.  The suffix flag
              [real:#] and [tick:#] mean the connection includes real-time and tick  conversion  on  the  listed
              queue, respectively.

   REMOVE ALL CONNECTIONS
       -x, --removeall
              Remove all exported connections.

SEE ALSO

       aseqnet(1), aseqview(1)

AUTHOR

       Takashi Iwai <tiwai@suse.de>

                                                 August 31, 2000                                     aconnect(1)