man-pages/man1/aconnect.1.html
2021-03-31 01:06:50 +01:00

245 lines
4.7 KiB
HTML

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<HTML><HEAD><TITLE>Man page of aconnect</TITLE>
</HEAD><BODY>
<H1>aconnect</H1>
Section: User Commands (1)<BR>Updated: August 31, 2000<BR><A HREF="#index">Index</A>
<A HREF="/cgi-bin/man/man2html">Return to Main Contents</A><HR>
<A NAME="lbAB">&nbsp;</A>
<H2>NAME</H2>
aconnect - ALSA sequencer connection manager
<P>
<A NAME="lbAC">&nbsp;</A>
<H2>SYNOPSIS</H2>
<B>aconnect</B>
[-d] [-options] sender receiver
<BR>
<B>aconnect</B>
-i|-o [-options]
<BR>
<B>aconnect</B>
-x
<P>
<A NAME="lbAD">&nbsp;</A>
<H2>DESCRIPTION</H2>
<B>aconnect</B>
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><A HREF="/cgi-bin/man/man2html?1+aseqview">aseqview</A>(1),</B>
can be connected to any (MIDI) device ports using
<B>aconnect.</B>
For example, to connect from port 64:0 to 65:0, run as follows:
<DL COMPACT>
<DT id="1"><DD>
% aconnect 64:0 65:0
</DL>
<P>
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</B>
option.
<P>
<PRE>
% aconnect -d 64:0 65:0
</PRE>
<P>
The address can be given using the client's name.
<P>
<PRE>
% aconnect External:0 Emu8000:1
</PRE>
<P>
Then the port 0 of the client matching with the string &quot;External&quot; is
connected to the port 1 of the client matching with the &quot;Emu8000&quot;.
<P>
Another function of
<B>aconnect</B>
is to list the present ports
on the given condition.
The input ports, which may become
<I>sender</I>
ports, can be listed with
<B>-i</B>
option.
<P>
<PRE>
% aconnect -i
client 0: 'System' [type=kernel]
0 'Timer '
1 'Announce '
client 64: 'External MIDI-0' [type=kernel]
0 'MIDI 0-0 '
</PRE>
<P>
Similarly, to see the output ports, use
<B>-o</B>
flag.
<P>
You can remove all existing exported connections using
<B>-x</B>
option. This function is useful for terminating the ALSA drivers,
because the modules with sequencer connections cannot be unloaded
unless their connections are removed.
<P>
<A NAME="lbAE">&nbsp;</A>
<H2>OPTIONS</H2>
<A NAME="lbAF">&nbsp;</A>
<H3>CONNECTION MANAGEMENT</H3>
<DL COMPACT>
<DT id="2"><B>-d, --disconnect</B>
<DD>
Disconnect the given subscription.
<DT id="3"><B>-e, --exclusive</B>
<DD>
Connect ports with exclusive mode.
Both sender and receiver ports can be no longer connected by any other ports.
<DT id="4"><B>-r, --real queue</B>
<DD>
Convert time-stamps of event packets to the current value of the given
<I>real-time</I>
queue.
This is option is, however, not so useful, since
the receiver port must use (not necessarily own) the specified queue.
<DT id="5"><B>-t, --tick queue</B>
<DD>
Like
<B>-r</B>
option, but
time-stamps are converted to the current value of the given
<I>tick</I>
queue.
<P>
</DL>
<A NAME="lbAG">&nbsp;</A>
<H3>LIST PORTS</H3>
<DL COMPACT>
<DT id="6"><B>-i, --input</B>
<DD>
List existing input (readable) ports.
This option is exclusive to
<B>-o.</B>
<DT id="7"><B>-o, --output</B>
<DD>
List existing output (writable) ports.
This option is exclusive to
<B>-i.</B>
<DT id="8"><B>-l, --list</B>
<DD>
List the current connection status. The connected and connecting ports
from/to each port are listed together.
The suffix flag
<B>[ex]</B>
means the connection is exclusive.
The suffix flag
<B>[real:#]</B>
and
<B>[tick:#]</B>
mean the connection includes real-time and tick conversion on the listed
queue, respectively.
<P>
</DL>
<A NAME="lbAH">&nbsp;</A>
<H3>REMOVE ALL CONNECTIONS</H3>
<DL COMPACT>
<DT id="9"><B>-x, --removeall</B>
<DD>
Remove all exported connections.
<P>
</DL>
<A NAME="lbAI">&nbsp;</A>
<H2>SEE ALSO</H2>
<A HREF="/cgi-bin/man/man2html?1+aseqnet">aseqnet</A>(1), <A HREF="/cgi-bin/man/man2html?1+aseqview">aseqview</A>(1)
<P>
<A NAME="lbAJ">&nbsp;</A>
<H2>AUTHOR</H2>
Takashi Iwai &lt;<A HREF="mailto:tiwai@suse.de">tiwai@suse.de</A>&gt;
<P>
<HR>
<A NAME="index">&nbsp;</A><H2>Index</H2>
<DL>
<DT id="10"><A HREF="#lbAB">NAME</A><DD>
<DT id="11"><A HREF="#lbAC">SYNOPSIS</A><DD>
<DT id="12"><A HREF="#lbAD">DESCRIPTION</A><DD>
<DT id="13"><A HREF="#lbAE">OPTIONS</A><DD>
<DL>
<DT id="14"><A HREF="#lbAF">CONNECTION MANAGEMENT</A><DD>
<DT id="15"><A HREF="#lbAG">LIST PORTS</A><DD>
<DT id="16"><A HREF="#lbAH">REMOVE ALL CONNECTIONS</A><DD>
</DL>
<DT id="17"><A HREF="#lbAI">SEE ALSO</A><DD>
<DT id="18"><A HREF="#lbAJ">AUTHOR</A><DD>
</DL>
<HR>
This document was created by
<A HREF="/cgi-bin/man/man2html">man2html</A>,
using the manual pages.<BR>
Time: 00:05:06 GMT, March 31, 2021
</BODY>
</HTML>