blob: a1dc1d37a85a495aa0b2793d3ef402bde3cab44b [file] [log] [blame]
.TH aseqnet 1 "January 1, 2000"
.LO 1
.SH NAME
aseqnet \- ALSA sequencer connectors over network
.SH SYNOPSIS
.B aseqnet
[remotehost]
.SH DESCRIPTION
.B aseqnet
is an ALSA sequencer client which sends and receives event packets
over network.
Suppose two hosts connected by network,
.I hostA
as a server
and
.I hostB
as a client.
The ALSA sequencer system must be running on both hosts.
For creating the server port, run the following on hostA:
.IP "" 4
hostA% aseqnet
.br
sequencer opened: 128:0
.PP
Then a user client 128 with port 0 was opened on hostA.
(The client number may vary.)
For creating the (network-)client port, run
.B aseqnet
with the hostname of the server:
.IP "" 4
hostB% aseqnet hostA
.br
sequencer opened: 132:0
.PP
Now all events sent to hostA:128:0 are transferred to hostB:132:0, and vice
versa.
.PP
The ports created by
.B aseqnet
can be connected arbitrary to other sequencer ports via
.B aconnect(1).
For example, to connect hostB:132:0 to a MIDI output device 65:0:
.IP "" 4
hostB% aconnect 132:0 65:0
.PP
Then events to hostA:128:0 will be delivered to hostB:65:0.
The following command plays MIDI on
.I hostB.
.IP "" 4
hostA% pmidi \-p 128:0 foo.mid
.PP
The multiple clients may exist simultaneously. If
.I hostC
is connected as a client to hostA, events from from hostA are sent
to all connected network clients, i.e. hostB and hostC.
However, only one connection is allowed from a client to a server.
.PP
To disconnect network, stop all clients before server by ctrl-C or
sending signal to them. The server will automatically quit.
.SH OPTIONS
.TP
.B \-p port
Specify the TCP port number or TCP service name.
.TP
.B \-s addr
Subscribe to the given address for read automatically.
.TP
.B \-d addr
Subscribe to the given address for write automatically.
.TP
.B \-v
Verbose mode.
.SH "SEE ALSO"
aconnect(1), pmidi(1)
.SH AUTHOR
Takashi Iwai <tiwai@suse.de>.