1aconnect(1)                 General Commands Manual                aconnect(1)
2
3
4

NAME

6       aconnect - ALSA sequencer connection manager
7
8

SYNOPSIS

10       aconnect [-d] [-options] sender receiver
11       aconnect -i|-o [-options]
12       aconnect -x
13
14

DESCRIPTION

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 re‐
27       ceiver 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

OPTIONS

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       -a, --all
87              List inactive ports, too.
88
89       -l, --list
90              List  the current connection status.  The connected and connect‐
91              ing ports from/to each port are  listed  together.   The  suffix
92              flag  [ex]  means  the connection is exclusive.  The suffix flag
93              [real:#] and [tick:#] mean the connection includes real-time and
94              tick conversion on the listed queue, respectively.
95
96
97   REMOVE ALL CONNECTIONS
98       -x, --removeall
99              Remove all exported connections.
100
101

SEE ALSO

103       aseqnet(1), aseqview(1)
104
105

AUTHOR

107       Takashi Iwai <tiwai@suse.de>
108
109
110
111                                August 31, 2000                    aconnect(1)