mirror of
https://github.com/alsa-project/alsa-utils
synced 2024-12-23 20:46:32 +01:00
148 lines
3.3 KiB
Groff
148 lines
3.3 KiB
Groff
.TH aconnect 1 "August 31, 2000"
|
|
.LO 1
|
|
.SH NAME
|
|
aconnect \- ALSA sequencer connection manager
|
|
|
|
.SH SYNOPSIS
|
|
.B aconnect
|
|
[\-d] [-options] sender receiver
|
|
.br
|
|
.B aconnect
|
|
\-i|-o [-options]
|
|
.br
|
|
.B aconnect
|
|
\-x
|
|
|
|
.SH DESCRIPTION
|
|
.B 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
|
|
.B aseqview(1),
|
|
can be connected to any (MIDI) device ports using
|
|
.B aconnect.
|
|
For example, to connect from port 64:0 to 65:0, run as follows:
|
|
.IP "" 4
|
|
% aconnect 64:0 65:0
|
|
.PP
|
|
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
|
|
.B \-d
|
|
option.
|
|
.IP "" 4
|
|
% aconnect -d 64:0 65:0
|
|
.PP
|
|
The address can be given using the client's name.
|
|
.IP "" 4
|
|
% aconnect External:0 Emu8000:1
|
|
.PP
|
|
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".
|
|
.PP
|
|
Another function of
|
|
.B aconnect
|
|
is to list the present ports
|
|
on the given condition.
|
|
The input ports, which may become
|
|
.I sender
|
|
ports, can be listed with
|
|
.B \-i
|
|
option.
|
|
.IP "" 4
|
|
% aconnect -i
|
|
.br
|
|
client 0: 'System' [group=system] [type=kernel]
|
|
.in +4
|
|
0 'Timer ' [group=system]
|
|
.br
|
|
1 'Announce ' [group=system]
|
|
.in -4
|
|
client 64: 'External MIDI-0' [group=] [type=kernel]
|
|
.in +4
|
|
0 'MIDI 0-0 ' [group=device]
|
|
.in -4
|
|
.PP
|
|
Similary, to see the output ports, use
|
|
.B \-o
|
|
flag.
|
|
.PP
|
|
You can remove all existing exported connections using
|
|
.B \-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.
|
|
|
|
.SH OPTIONS
|
|
.SS CONNNECTION MANAGEMENT
|
|
.TP
|
|
.B \-d, --disconnect
|
|
Disconnect the given subscription.
|
|
.TP
|
|
.B \-e, --exclusive
|
|
Connect ports with exclusvie mode.
|
|
Both sender and receiver ports can be no longer connected by any other ports.
|
|
.TP
|
|
.B \-r, --real queue
|
|
Convert time-stamps of event packets to the current value of the given
|
|
.I real-time
|
|
queue.
|
|
This is option is, however, not so useful, since
|
|
the receiver port must use (not necessarily own) the specified queue.
|
|
.TP
|
|
.B \-t, --tick queue
|
|
Like
|
|
.B -r
|
|
option, but
|
|
time-stamps are converted to the current value of the given
|
|
.I tick
|
|
queue.
|
|
.TP
|
|
.B \-g, --group name
|
|
Specify the group name that
|
|
.B aconnect
|
|
uses.
|
|
Some ports may have special permissions, so that only the same group
|
|
may subscribe to them. In such a case,
|
|
.B aconnect
|
|
can fake the group name
|
|
with this option.
|
|
|
|
.SS LIST PORTS
|
|
.TP
|
|
.B \-i, --input
|
|
List existing input (readable) ports.
|
|
This option is exclusive to
|
|
.B \-o.
|
|
.TP
|
|
.B \-o, --output
|
|
List existing output (writable) ports.
|
|
This option is exclusive to
|
|
.B \-i.
|
|
.TP
|
|
.B \-l, --list
|
|
List the current connection status. The connected and connecting ports
|
|
from/to each port are listed together.
|
|
The suffix flag
|
|
.B [ex]
|
|
means the connection is exclusive.
|
|
The suffix flag
|
|
.B [real:#]
|
|
and
|
|
.B [tick:#]
|
|
mean the connection includes real-time and tick conversion on the listed
|
|
queue, respectively.
|
|
|
|
.SS REMOVE ALL CONNECTIONS
|
|
.TP
|
|
.B \-x, --removeall
|
|
Remove all exported connections.
|
|
|
|
.SH "SEE ALSO"
|
|
aseqnet(1), aseqview(1)
|
|
|
|
.SH AUTHOR
|
|
Takashi Iwai <tiwai@suse.de>
|