Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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  per-
       mission,	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 re-
       ceiver 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 mod-
       ules with sequencer connections cannot be unloaded unless their connec-
       tions 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 use-
	      ful, 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.

       -a, --all
	      List inactive ports, too.

       -l, --list
	      List  the	current	connection status.  The	connected and connect-
	      ing 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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=aconnect&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help