~ubuntu-branches/debian/squeeze/alsa-utils/squeeze

« back to all changes in this revision

Viewing changes to seq/aconnect/aconnect.1

  • Committer: Bazaar Package Importer
  • Author(s): Masato Taruishi
  • Date: 2002-04-03 14:58:38 UTC
  • Revision ID: james.westby@ubuntu.com-20020403145838-ylq6q55c9ifhpixw
Tags: upstream-0.9.0beta12
ImportĀ upstreamĀ versionĀ 0.9.0beta12

Show diffs side-by-side

added added

removed removed

Lines of Context:
 
1
.TH aconnect 1 "August 31, 2000"
 
2
.LO 1
 
3
.SH NAME
 
4
aconnect \- ALSA sequencer connection manager
 
5
 
 
6
.SH SYNOPSIS
 
7
.B aconnect
 
8
[\-d] [-options] sender receiver
 
9
.br
 
10
.B aconnect
 
11
\-i|-o [-options]
 
12
.br
 
13
.B aconnect
 
14
\-x
 
15
 
 
16
.SH DESCRIPTION
 
17
.B aconnect
 
18
is a utility to connect and disconnect two existing ports on ALSA sequencer
 
19
system.
 
20
The ports with the arbitrary subscription permission, such as created
 
21
by
 
22
.B aseqview(1),
 
23
can be connected to any (MIDI) device ports using
 
24
.B aconnect.
 
25
For example, to connect from port 64:0 to 65:0, run as follows:
 
26
.IP "" 4
 
27
% aconnect 64:0 65:0
 
28
.PP
 
29
The connection is one-way, and the whole data to the sender port (64:0)
 
30
is redirected to the receiver port (65:0).  When another port (e.g. 65:1)
 
31
is attached to the same sender port, the data is sent to both receiver
 
32
ports.
 
33
For disconnection, use
 
34
.B \-d
 
35
option.
 
36
.IP "" 4
 
37
% aconnect -d 64:0 65:0
 
38
.PP
 
39
The address can be given using the client's name.
 
40
.IP "" 4
 
41
% aconnect External:0 Emu8000:1
 
42
.PP
 
43
Then the port 0 of the client matching with the string "External" is
 
44
connected to the port 1 of the client matching with the "Emu8000".
 
45
.PP
 
46
Another function of
 
47
.B aconnect
 
48
is to list the present ports
 
49
on the given condition.
 
50
The input ports, which may become
 
51
.I sender
 
52
ports, can be listed with
 
53
.B \-i
 
54
option.
 
55
.IP "" 4
 
56
% aconnect -i
 
57
.br
 
58
client 0: 'System' [group=system] [type=kernel]
 
59
.in +4
 
60
0 'Timer           ' [group=system]
 
61
.br
 
62
1 'Announce        ' [group=system]
 
63
.in -4
 
64
client 64: 'External MIDI-0' [group=] [type=kernel]
 
65
.in +4
 
66
0 'MIDI 0-0        ' [group=device]
 
67
.in -4
 
68
.PP
 
69
Similary, to see the output ports, use
 
70
.B \-o
 
71
flag.
 
72
.PP
 
73
You can remove all existing exported connections using
 
74
.B \-x
 
75
option.  This function is useful for terminating the ALSA drivers,
 
76
because the modules with sequencer connections cannot be unloaded
 
77
unless their connections are removed.
 
78
 
 
79
.SH OPTIONS
 
80
.SS CONNNECTION MANAGEMENT
 
81
.TP
 
82
.B \-d, --disconnect
 
83
Disconnect the given subscription.
 
84
.TP
 
85
.B \-e, --exclusive
 
86
Connect ports with exclusvie mode.
 
87
Both sender and receiver ports can be no longer connected by any other ports.
 
88
.TP
 
89
.B \-r, --real queue
 
90
Convert time-stamps of event packets to the current value of the given
 
91
.I real-time
 
92
queue.
 
93
This is option is, however, not so useful, since
 
94
the receiver port must use (not necessarily own) the specified queue.
 
95
.TP
 
96
.B \-t, --tick queue
 
97
Like
 
98
.B -r
 
99
option, but 
 
100
time-stamps are converted to the current value of the given
 
101
.I tick
 
102
queue.
 
103
.TP
 
104
.B \-g, --group name
 
105
Specify the group name that
 
106
.B aconnect
 
107
uses.
 
108
Some ports may have special permissions, so that only the same group
 
109
may subscribe to them.  In such a case,
 
110
.B aconnect
 
111
can fake the group name
 
112
with this option.
 
113
 
 
114
.SS LIST PORTS
 
115
.TP
 
116
.B \-i, --input
 
117
List existing input (readable) ports.
 
118
This option is exclusive to
 
119
.B \-o.
 
120
.TP
 
121
.B \-o, --output
 
122
List existing output (writable) ports.
 
123
This option is exclusive to
 
124
.B \-i.
 
125
.TP
 
126
.B \-l, --list
 
127
List the current connection status.  The connected and connecting ports
 
128
from/to each port are listed together.
 
129
The suffix flag
 
130
.B [ex]
 
131
means the connection is exclusive.
 
132
The suffix flag
 
133
.B [real:#]
 
134
and
 
135
.B [tick:#]
 
136
mean the connection includes real-time and tick conversion on the listed
 
137
queue, respectively.
 
138
 
 
139
.SS REMOVE ALL CONNECTIONS
 
140
.TP
 
141
.B \-x, --removeall
 
142
Remove all exported connections.
 
143
 
 
144
.SH "SEE ALSO"
 
145
aseqnet(1), aseqview(1)
 
146
 
 
147
.SH AUTHOR
 
148
Takashi Iwai <tiwai@suse.de>