Initial Import
[profile/ivi/alsa-utils.git] / seq / aseqnet / README.aseqnet
1 ================================================================
2         ALSA sequencer connectors over network
3                 ver.0.1
4         Copyright (C) 1999-2000 Takashi Iwai
5 ================================================================
6
7 * ASEQNET
8
9 aseqnet is a sequencer client which sends/receives events over
10 network.  Suppose two hosts (hostA and hostB) connected by network.
11 You need to run ALSA system on both hosts.  Then, start aseqnet as a
12 server on hostA:
13
14         hostA% aseqnet
15         sequencer opened: 128:0
16
17 A user client 128 with port 0 was opened. (The client number may
18 vary.)  At next, start client on hostB.  The argument is the hostname
19 where server is running.
20
21         hostB% aseqnet hostA
22         sequencer opened: 132:0
23
24 Now events sent to hostA:128:0 is transferred to hostB:132:0, and vice
25 versa.
26
27 You can connect these ports arbitrary to other sequencer ports.
28 For example, connect hostB:132:0 to a MIDI output device 65:0.  The
29 aconnect utility can be used for this:
30
31         hostB% aconnect 132:0 65:0
32
33 Events to hostA:128:0 will be delivered indirectly to hostB:65:0.
34 You'll hear MIDI sounds as following:
35
36         hostA% pmidi -p 128:0 foo.mid
37
38 The multiple clients may exist simultaneously.  If hostC is connected
39 as a client to hostA, events from from hostA are sent to all connected
40 network clients, hostB and hostC.  However, only one connection is
41 allowed from a client to a server.
42
43 To disconnect network, stop all clients before server by ctrl-C or
44 sending signal to them.  The server will automatically quit.
45
46 The available options are:
47
48   -p port : specify the TCP port number or TCP service name.
49             Default value is 40002.
50   -s addr : explicit read-subscription to the given address
51             (client:addr).
52   -d addr : explicit write-subscription to the given address.
53   -v      : verbose mode.