alsa-utils/seq/aseqnet/aseqnet.1
Andrea Piras 0e21f4d864 added an option to aseqnet to optionally set the midi process name
This option allows to run multiple instances of aseqnet without having
to double check the assigned port number, since each one can get spawned
with a unique name.

Fixes: https://github.com/alsa-project/alsa-utils/pull/95
Signed-off-by: Andrea Piras <andrea.piras.85@gmail.com>
Signed-off-by: Jaroslav Kysela <perex@perex.cz>
2021-06-14 12:00:44 +02:00

83 lines
1.9 KiB
Groff

.TH aseqnet 1 "January 1, 2000"
.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 \-n name
Specify the midi name of the process.
.TP
.B \-v
Verbose mode.
.SH "SEE ALSO"
aconnect(1), pmidi(1)
.SH AUTHOR
Takashi Iwai <tiwai@suse.de>.