mirror of
https://github.com/alsa-project/alsa-utils
synced 2024-12-23 13:56:31 +01:00
83bf6c33ad
Use local definitions of .EX/.EE or .DS/.DE to avoid low-level troff requests in the page body. There are plans to add these to groff man; in the interim, this patch adds a compatible definition. From: Eric S. Raymond <esr@thyrsus.com>
145 lines
3 KiB
Groff
145 lines
3 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 \-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>
|