aconnect.1 (3104B)
1 .TH aconnect 1 "August 31, 2000" 2 .de EX 3 .nf 4 .ft CW 5 .. 6 .de EE 7 .ft R 8 .fi 9 .. 10 .SH NAME 11 aconnect \- ALSA sequencer connection manager 12 13 .SH SYNOPSIS 14 .B aconnect 15 [\-d] [\-options] sender receiver 16 .br 17 .B aconnect 18 \-i|\-o [\-options] 19 .br 20 .B aconnect 21 \-x 22 23 .SH DESCRIPTION 24 .B aconnect 25 is a utility to connect and disconnect two existing ports on ALSA sequencer 26 system. 27 The ports with the arbitrary subscription permission, such as created 28 by 29 .B aseqview(1), 30 can be connected to any (MIDI) device ports using 31 .B aconnect. 32 For example, to connect from port 64:0 to 65:0, run as follows: 33 .IP "" 4 34 % aconnect 64:0 65:0 35 .PP 36 The connection is one-way, and the whole data to the sender port (64:0) 37 is redirected to the receiver port (65:0). When another port (e.g. 65:1) 38 is attached to the same sender port, the data is sent to both receiver 39 ports. 40 For disconnection, use 41 .B \-d 42 option. 43 .sp 44 .EX 45 % aconnect \-d 64:0 65:0 46 .EE 47 .PP 48 The address can be given using the client's name. 49 .sp 50 .EX 51 % aconnect External:0 Emu8000:1 52 .EE 53 .PP 54 Then the port 0 of the client matching with the string "External" is 55 connected to the port 1 of the client matching with the "Emu8000". 56 .PP 57 Another function of 58 .B aconnect 59 is to list the present ports 60 on the given condition. 61 The input ports, which may become 62 .I sender 63 ports, can be listed with 64 .B \-i 65 option. 66 .sp 67 .EX 68 % aconnect \-i 69 client 0: 'System' [type=kernel] 70 0 'Timer ' 71 1 'Announce ' 72 client 64: 'External MIDI\-0' [type=kernel] 73 0 'MIDI 0\-0 ' 74 .EE 75 .PP 76 Similarly, to see the output ports, use 77 .B \-o 78 flag. 79 .PP 80 You can remove all existing exported connections using 81 .B \-x 82 option. This function is useful for terminating the ALSA drivers, 83 because the modules with sequencer connections cannot be unloaded 84 unless their connections are removed. 85 86 .SH OPTIONS 87 .SS CONNECTION MANAGEMENT 88 .TP 89 .B \-d, \-\-disconnect 90 Disconnect the given subscription. 91 .TP 92 .B \-e, \-\-exclusive 93 Connect ports with exclusive mode. 94 Both sender and receiver ports can be no longer connected by any other ports. 95 .TP 96 .B \-r, \-\-real queue 97 Convert time-stamps of event packets to the current value of the given 98 .I real-time 99 queue. 100 This is option is, however, not so useful, since 101 the receiver port must use (not necessarily own) the specified queue. 102 .TP 103 .B \-t, \-\-tick queue 104 Like 105 .B \-r 106 option, but 107 time-stamps are converted to the current value of the given 108 .I tick 109 queue. 110 111 .SS LIST PORTS 112 .TP 113 .B \-i, \-\-input 114 List existing input (readable) ports. 115 This option is exclusive to 116 .B \-o. 117 .TP 118 .B \-o, \-\-output 119 List existing output (writable) ports. 120 This option is exclusive to 121 .B \-i. 122 .TP 123 .B \-l, \-\-list 124 List the current connection status. The connected and connecting ports 125 from/to each port are listed together. 126 The suffix flag 127 .B [ex] 128 means the connection is exclusive. 129 The suffix flag 130 .B [real:#] 131 and 132 .B [tick:#] 133 mean the connection includes real-time and tick conversion on the listed 134 queue, respectively. 135 136 .SS REMOVE ALL CONNECTIONS 137 .TP 138 .B \-x, \-\-removeall 139 Remove all exported connections. 140 141 .SH "SEE ALSO" 142 aseqnet(1), aseqview(1) 143 144 .SH AUTHOR 145 Takashi Iwai <tiwai@suse.de>