aconnect(1) General Commands Manual aconnect(1)
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 per-
mission, 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 re-
ceiver 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 use-
ful, 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.
-a, --all
List inactive ports, too.
-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 con-
version 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)
Generated by dwww version 1.16 on Sat Oct 3 06:01:04 CEST 2026.