|
Packit Service |
a9274b |
.TH aconnect 1 "August 31, 2000"
|
|
Packit Service |
a9274b |
.de EX
|
|
Packit Service |
a9274b |
.nf
|
|
Packit Service |
a9274b |
.ft CW
|
|
Packit Service |
a9274b |
..
|
|
Packit Service |
a9274b |
.de EE
|
|
Packit Service |
a9274b |
.ft R
|
|
Packit Service |
a9274b |
.fi
|
|
Packit Service |
a9274b |
..
|
|
Packit Service |
a9274b |
.SH NAME
|
|
Packit Service |
a9274b |
aconnect \- ALSA sequencer connection manager
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
.SH SYNOPSIS
|
|
Packit Service |
a9274b |
.B aconnect
|
|
Packit Service |
a9274b |
[\-d] [\-options] sender receiver
|
|
Packit Service |
a9274b |
.br
|
|
Packit Service |
a9274b |
.B aconnect
|
|
Packit Service |
a9274b |
\-i|\-o [\-options]
|
|
Packit Service |
a9274b |
.br
|
|
Packit Service |
a9274b |
.B aconnect
|
|
Packit Service |
a9274b |
\-x
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
.SH DESCRIPTION
|
|
Packit Service |
a9274b |
.B aconnect
|
|
Packit Service |
a9274b |
is a utility to connect and disconnect two existing ports on ALSA sequencer
|
|
Packit Service |
a9274b |
system.
|
|
Packit Service |
a9274b |
The ports with the arbitrary subscription permission, such as created
|
|
Packit Service |
a9274b |
by
|
|
Packit Service |
a9274b |
.B aseqview(1),
|
|
Packit Service |
a9274b |
can be connected to any (MIDI) device ports using
|
|
Packit Service |
a9274b |
.B aconnect.
|
|
Packit Service |
a9274b |
For example, to connect from port 64:0 to 65:0, run as follows:
|
|
Packit Service |
a9274b |
.IP "" 4
|
|
Packit Service |
a9274b |
% aconnect 64:0 65:0
|
|
Packit Service |
a9274b |
.PP
|
|
Packit Service |
a9274b |
The connection is one-way, and the whole data to the sender port (64:0)
|
|
Packit Service |
a9274b |
is redirected to the receiver port (65:0). When another port (e.g. 65:1)
|
|
Packit Service |
a9274b |
is attached to the same sender port, the data is sent to both receiver
|
|
Packit Service |
a9274b |
ports.
|
|
Packit Service |
a9274b |
For disconnection, use
|
|
Packit Service |
a9274b |
.B \-d
|
|
Packit Service |
a9274b |
option.
|
|
Packit Service |
a9274b |
.sp
|
|
Packit Service |
a9274b |
.EX
|
|
Packit Service |
a9274b |
% aconnect \-d 64:0 65:0
|
|
Packit Service |
a9274b |
.EE
|
|
Packit Service |
a9274b |
.PP
|
|
Packit Service |
a9274b |
The address can be given using the client's name.
|
|
Packit Service |
a9274b |
.sp
|
|
Packit Service |
a9274b |
.EX
|
|
Packit Service |
a9274b |
% aconnect External:0 Emu8000:1
|
|
Packit Service |
a9274b |
.EE
|
|
Packit Service |
a9274b |
.PP
|
|
Packit Service |
a9274b |
Then the port 0 of the client matching with the string "External" is
|
|
Packit Service |
a9274b |
connected to the port 1 of the client matching with the "Emu8000".
|
|
Packit Service |
a9274b |
.PP
|
|
Packit Service |
a9274b |
Another function of
|
|
Packit Service |
a9274b |
.B aconnect
|
|
Packit Service |
a9274b |
is to list the present ports
|
|
Packit Service |
a9274b |
on the given condition.
|
|
Packit Service |
a9274b |
The input ports, which may become
|
|
Packit Service |
a9274b |
.I sender
|
|
Packit Service |
a9274b |
ports, can be listed with
|
|
Packit Service |
a9274b |
.B \-i
|
|
Packit Service |
a9274b |
option.
|
|
Packit Service |
a9274b |
.sp
|
|
Packit Service |
a9274b |
.EX
|
|
Packit Service |
a9274b |
% aconnect \-i
|
|
Packit Service |
a9274b |
client 0: 'System' [type=kernel]
|
|
Packit Service |
a9274b |
0 'Timer '
|
|
Packit Service |
a9274b |
1 'Announce '
|
|
Packit Service |
a9274b |
client 64: 'External MIDI\-0' [type=kernel]
|
|
Packit Service |
a9274b |
0 'MIDI 0\-0 '
|
|
Packit Service |
a9274b |
.EE
|
|
Packit Service |
a9274b |
.PP
|
|
Packit Service |
a9274b |
Similarly, to see the output ports, use
|
|
Packit Service |
a9274b |
.B \-o
|
|
Packit Service |
a9274b |
flag.
|
|
Packit Service |
a9274b |
.PP
|
|
Packit Service |
a9274b |
You can remove all existing exported connections using
|
|
Packit Service |
a9274b |
.B \-x
|
|
Packit Service |
a9274b |
option. This function is useful for terminating the ALSA drivers,
|
|
Packit Service |
a9274b |
because the modules with sequencer connections cannot be unloaded
|
|
Packit Service |
a9274b |
unless their connections are removed.
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
.SH OPTIONS
|
|
Packit Service |
a9274b |
.SS CONNECTION MANAGEMENT
|
|
Packit Service |
a9274b |
.TP
|
|
Packit Service |
a9274b |
.B \-d, \-\-disconnect
|
|
Packit Service |
a9274b |
Disconnect the given subscription.
|
|
Packit Service |
a9274b |
.TP
|
|
Packit Service |
a9274b |
.B \-e, \-\-exclusive
|
|
Packit Service |
a9274b |
Connect ports with exclusive mode.
|
|
Packit Service |
a9274b |
Both sender and receiver ports can be no longer connected by any other ports.
|
|
Packit Service |
a9274b |
.TP
|
|
Packit Service |
a9274b |
.B \-r, \-\-real queue
|
|
Packit Service |
a9274b |
Convert time-stamps of event packets to the current value of the given
|
|
Packit Service |
a9274b |
.I real-time
|
|
Packit Service |
a9274b |
queue.
|
|
Packit Service |
a9274b |
This is option is, however, not so useful, since
|
|
Packit Service |
a9274b |
the receiver port must use (not necessarily own) the specified queue.
|
|
Packit Service |
a9274b |
.TP
|
|
Packit Service |
a9274b |
.B \-t, \-\-tick queue
|
|
Packit Service |
a9274b |
Like
|
|
Packit Service |
a9274b |
.B \-r
|
|
Packit Service |
a9274b |
option, but
|
|
Packit Service |
a9274b |
time-stamps are converted to the current value of the given
|
|
Packit Service |
a9274b |
.I tick
|
|
Packit Service |
a9274b |
queue.
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
.SS LIST PORTS
|
|
Packit Service |
a9274b |
.TP
|
|
Packit Service |
a9274b |
.B \-i, \-\-input
|
|
Packit Service |
a9274b |
List existing input (readable) ports.
|
|
Packit Service |
a9274b |
This option is exclusive to
|
|
Packit Service |
a9274b |
.B \-o.
|
|
Packit Service |
a9274b |
.TP
|
|
Packit Service |
a9274b |
.B \-o, \-\-output
|
|
Packit Service |
a9274b |
List existing output (writable) ports.
|
|
Packit Service |
a9274b |
This option is exclusive to
|
|
Packit Service |
a9274b |
.B \-i.
|
|
Packit Service |
a9274b |
.TP
|
|
Packit Service |
a9274b |
.B \-l, \-\-list
|
|
Packit Service |
a9274b |
List the current connection status. The connected and connecting ports
|
|
Packit Service |
a9274b |
from/to each port are listed together.
|
|
Packit Service |
a9274b |
The suffix flag
|
|
Packit Service |
a9274b |
.B [ex]
|
|
Packit Service |
a9274b |
means the connection is exclusive.
|
|
Packit Service |
a9274b |
The suffix flag
|
|
Packit Service |
a9274b |
.B [real:#]
|
|
Packit Service |
a9274b |
and
|
|
Packit Service |
a9274b |
.B [tick:#]
|
|
Packit Service |
a9274b |
mean the connection includes real-time and tick conversion on the listed
|
|
Packit Service |
a9274b |
queue, respectively.
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
.SS REMOVE ALL CONNECTIONS
|
|
Packit Service |
a9274b |
.TP
|
|
Packit Service |
a9274b |
.B \-x, \-\-removeall
|
|
Packit Service |
a9274b |
Remove all exported connections.
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
.SH "SEE ALSO"
|
|
Packit Service |
a9274b |
aseqnet(1), aseqview(1)
|
|
Packit Service |
a9274b |
|
|
Packit Service |
a9274b |
.SH AUTHOR
|
|
Packit Service |
a9274b |
Takashi Iwai <tiwai@suse.de>
|