--- name: "aconnect-0.9" section: "1" platform: "linux" package: "alsa-utils" version: "0.9.0beta12-1" release: "Debian 3.0 (Woody)" platforms: ["linux"] url: "https://new.carta.tech/aconnect-0.9" --- # aconnect-0.9(1) ALSA sequencer connection manager ## 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' \[group=system\] \[type=kernel\] 0 'Timer ' \[group=system\]\ 1 'Announce ' \[group=system\] client 64: 'External MIDI-0' \[group=\] \[type=kernel\] 0 'MIDI 0-0 ' \[group=device\] Similary, 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 ### CONNNECTION MANAGEMENT - **-d, --disconnect** Disconnect the given subscription. - **-e, --exclusive** Connect ports with exclusvie 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. - **-g, --group name** Specify the group name that **aconnect** uses. Some ports may have special permissions, so that only the same group may subscribe to them. In such a case, **aconnect** can fake the group name with this option. ### 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)](/aseqnet/1.md), aseqview(1) ## AUTHOR Takashi Iwai \