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  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 con-
     nected to the port 1 of the client matching with the "Emu8000".

     Another function of aconnect is to list the present ports on the given con-
     dition.  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.

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

     -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)

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

home | help