aconnect(1)						      General Commands Manual						       aconnect(1)

NAME

       aconnect - ALSA sequencer connection manager

SYNOPSIS

       aconnect [-d] [-options] sender receiver
       aconnect -i|-o [-options]
       aconnect -x

DESCRIPTION

       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 aseqview(1), can be connected to any (MIDI) device ports using aconnect.	For example, to connect from  port
       64:0 to 65:0, run as follows:

	   % aconnect 64:0 65:0

       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 -d option.

       % aconnect -d 64:0 65:0

       The address can be given using the client's name.

       % aconnect External:0 Emu8000:1

       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".

       Another function of aconnect is to list the present ports on the given condition.  The input ports, which may become sender ports,  can	be
       listed with -i option.

       % aconnect -i
       client 0: 'System' [type=kernel]
	   0 'Timer	      '
	   1 'Announce	      '
       client 64: 'External MIDI-0' [type=kernel]
	   0 'MIDI 0-0	      '

       Similarly, to see the output ports, use -o flag.

       You  can  remove  all existing exported connections using -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.

OPTIONS

   CONNECTION MANAGEMENT
       -d, --disconnect
	      Disconnect the given subscription.

       -e, --exclusive
	      Connect ports with exclusive mode.  Both sender and receiver ports can be no longer connected by any other ports.

       -r, --real queue
	      Convert time-stamps of event packets to the current value of the given real-time queue.  This is option is, however, not so  useful,
	      since the receiver port must use (not necessarily own) the specified queue.

       -t, --tick queue
	      Like -r option, but time-stamps are converted to the current value of the given tick queue.

   LIST PORTS
       -i, --input
	      List existing input (readable) ports.  This option is exclusive to -o.

       -o, --output
	      List existing output (writable) ports.  This option is exclusive to -i.

       -l, --list
	      List the current connection status.  The connected and connecting ports from/to each port are listed together.  The suffix flag [ex]
	      means the connection is exclusive.  The suffix flag [real:#] and [tick:#] mean the connection includes real-time and tick conversion
	      on the listed queue, respectively.

   REMOVE ALL CONNECTIONS
       -x, --removeall
	      Remove all exported connections.

SEE ALSO

       aseqnet(1), aseqview(1)

AUTHOR

       Takashi Iwai <tiwai@suse.de>

								  August 31, 2000						       aconnect(1)