mirror of
https://github.com/alsa-project/alsa-utils
synced 2024-12-23 03:26:31 +01:00
64b1d486b1
This patch extends the aconnect program for supporting UMP. Now the verbose output can show the UMP client version. Also, a new option -a is added to control the behavior whether to show the all ports including the inactive ports or not. As default, only the active ports are shown, but UMP clients allow to hide some ports as inactive. Signed-off-by: Takashi Iwai <tiwai@suse.de>
148 lines
3.1 KiB
Groff
148 lines
3.1 KiB
Groff
.TH aconnect 1 "August 31, 2000"
|
|
.de EX
|
|
.nf
|
|
.ft CW
|
|
..
|
|
.de EE
|
|
.ft R
|
|
.fi
|
|
..
|
|
.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.
|
|
.sp
|
|
.EX
|
|
% aconnect \-d 64:0 65:0
|
|
.EE
|
|
.PP
|
|
The address can be given using the client's name.
|
|
.sp
|
|
.EX
|
|
% aconnect External:0 Emu8000:1
|
|
.EE
|
|
.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.
|
|
.sp
|
|
.EX
|
|
% aconnect \-i
|
|
client 0: 'System' [type=kernel]
|
|
0 'Timer '
|
|
1 'Announce '
|
|
client 64: 'External MIDI\-0' [type=kernel]
|
|
0 'MIDI 0\-0 '
|
|
.EE
|
|
.PP
|
|
Similarly, 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 CONNECTION MANAGEMENT
|
|
.TP
|
|
.B \-d, \-\-disconnect
|
|
Disconnect the given subscription.
|
|
.TP
|
|
.B \-e, \-\-exclusive
|
|
Connect ports with exclusive 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.
|
|
|
|
.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 \-a, \-\-all
|
|
List inactive ports, too.
|
|
.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>
|