aconnect - ALSA sequencer connection manager
aconnect [-d] [-options] sender receiver
aconnect -i|-o [-options]
aconnect is a utility to connect and disconnect two existing ports on ALSA sequencer sys-
tem. The ports with the arbitrary subscription permission, such as created by ase-
qview(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.
Disconnect the given subscription.
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
List existing input (readable) ports. This option is exclusive to -o.
List existing output (writable) ports. This option is exclusive to -i.
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 exclu-
sive. The suffix flag [real:#] and [tick:#] mean the connection includes real-time
and tick conversion on the listed queue, respectively.
REMOVE ALL CONNECTIONS
Remove all exported connections.
Takashi Iwai <email@example.com>
August 31, 2000 aconnect(1)