1aconnect(1) General Commands Manual aconnect(1)
2
3
4
6 aconnect - ALSA sequencer connection manager
7
8
10 aconnect [-d] [-options] sender receiver
11 aconnect -i|-o [-options]
12 aconnect -x
13
14
16 aconnect is a utility to connect and disconnect two existing ports on
17 ALSA sequencer system. The ports with the arbitrary subscription per‐
18 mission, such as created by aseqview(1), can be connected to any (MIDI)
19 device ports using aconnect. For example, to connect from port 64:0 to
20 65:0, run as follows:
21
22 % aconnect 64:0 65:0
23
24 The connection is one-way, and the whole data to the sender port (64:0)
25 is redirected to the receiver port (65:0). When another port (e.g.
26 65:1) is attached to the same sender port, the data is sent to both
27 receiver ports. For disconnection, use -d option.
28
29 % aconnect -d 64:0 65:0
30
31 The address can be given using the client's name.
32
33 % aconnect External:0 Emu8000:1
34
35 Then the port 0 of the client matching with the string "External" is
36 connected to the port 1 of the client matching with the "Emu8000".
37
38 Another function of aconnect is to list the present ports on the given
39 condition. The input ports, which may become sender ports, can be
40 listed with -i option.
41
42 % aconnect -i
43 client 0: 'System' [type=kernel]
44 0 'Timer '
45 1 'Announce '
46 client 64: 'External MIDI-0' [type=kernel]
47 0 'MIDI 0-0 '
48
49 Similarly, to see the output ports, use -o flag.
50
51 You can remove all existing exported connections using -x option. This
52 function is useful for terminating the ALSA drivers, because the mod‐
53 ules with sequencer connections cannot be unloaded unless their connec‐
54 tions are removed.
55
56
58 CONNECTION MANAGEMENT
59 -d, --disconnect
60 Disconnect the given subscription.
61
62 -e, --exclusive
63 Connect ports with exclusive mode. Both sender and receiver
64 ports can be no longer connected by any other ports.
65
66 -r, --real queue
67 Convert time-stamps of event packets to the current value of the
68 given real-time queue. This is option is, however, not so use‐
69 ful, since the receiver port must use (not necessarily own) the
70 specified queue.
71
72 -t, --tick queue
73 Like -r option, but time-stamps are converted to the current
74 value of the given tick queue.
75
76
77 LIST PORTS
78 -i, --input
79 List existing input (readable) ports. This option is exclusive
80 to -o.
81
82 -o, --output
83 List existing output (writable) ports. This option is exclusive
84 to -i.
85
86 -l, --list
87 List the current connection status. The connected and connect‐
88 ing ports from/to each port are listed together. The suffix
89 flag [ex] means the connection is exclusive. The suffix flag
90 [real:#] and [tick:#] mean the connection includes real-time and
91 tick conversion on the listed queue, respectively.
92
93
94 REMOVE ALL CONNECTIONS
95 -x, --removeall
96 Remove all exported connections.
97
98
100 aseqnet(1), aseqview(1)
101
102
104 Takashi Iwai <tiwai@suse.de>
105
106
107
108 August 31, 2000 aconnect(1)