1*a0ca34f2Sjmc.\" $OpenBSD: midicat.1,v 1.2 2018/11/30 08:00:43 jmc Exp $ 2424bdd43Sratchov.\" 3424bdd43Sratchov.\" Copyright (c) 2015 Alexandre Ratchov <alex@caoua.org> 4424bdd43Sratchov.\" 5424bdd43Sratchov.\" Permission to use, copy, modify, and distribute this software for any 6424bdd43Sratchov.\" purpose with or without fee is hereby granted, provided that the above 7424bdd43Sratchov.\" copyright notice and this permission notice appear in all copies. 8424bdd43Sratchov.\" 9424bdd43Sratchov.\" THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES 10424bdd43Sratchov.\" WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF 11424bdd43Sratchov.\" MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR 12424bdd43Sratchov.\" ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES 13424bdd43Sratchov.\" WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN 14424bdd43Sratchov.\" ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF 15424bdd43Sratchov.\" OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE. 16424bdd43Sratchov.\" 17424bdd43Sratchov.Dd $Mdocdate: November 30 2018 $ 18424bdd43Sratchov.Dt MIDICAT 1 19424bdd43Sratchov.Os 20424bdd43Sratchov.Sh NAME 21424bdd43Sratchov.Nm midicat 22*a0ca34f2Sjmc.Nd send to or receive from MIDI ports 23424bdd43Sratchov.Sh SYNOPSIS 24424bdd43Sratchov.Nm midicat 25424bdd43Sratchov.Bk -words 26424bdd43Sratchov.Op Fl d 27424bdd43Sratchov.Op Fl i Ar file 28424bdd43Sratchov.Op Fl o Ar file 29424bdd43Sratchov.Op Fl q Ar port 30424bdd43Sratchov.Ek 31424bdd43Sratchov.Sh DESCRIPTION 32424bdd43SratchovThe 33424bdd43Sratchov.Nm 34424bdd43Sratchovutility receives MIDI data from the given input MIDI port and/or 35424bdd43Sratchovsends it to the given output MIDI port. 36424bdd43SratchovThe options are as follows: 37424bdd43Sratchov.Bl -tag -width Ds 38424bdd43Sratchov.It Fl d 39424bdd43SratchovDump transferred data in hex on stderr. 40424bdd43Sratchov.It Fl i Ar file 41424bdd43SratchovRead MIDI data from this file instead of receiving it from the MIDI port. 42424bdd43SratchovIf the option argument is 43424bdd43Sratchov.Sq - 44424bdd43Sratchovthen standard input will be used. 45424bdd43Sratchov.It Fl o Ar file 46424bdd43SratchovWrite MIDI data to this file instead of sending it to the MIDI port. 47424bdd43SratchovIf the option argument is 48424bdd43Sratchov.Sq - 49424bdd43Sratchovthen standard output will be used. 50424bdd43Sratchov.It Fl q Ar port 51424bdd43SratchovUse this 52424bdd43Sratchov.Xr sndio 7 53424bdd43SratchovMIDI port for input/output. 54424bdd43SratchovIf the option is used twice, the first one specifies 55424bdd43Sratchovthe input port and the second one the output port. 56424bdd43Sratchov.El 57424bdd43Sratchov.Pp 58424bdd43SratchovIf no files are specified, then 59424bdd43Sratchov.Nm 60424bdd43Sratchovtransfers data from the MIDI input port to the MIDI output port. 61424bdd43Sratchov.Sh EXAMPLES 62424bdd43SratchovSend the given file to 63424bdd43Sratchov.Pa rmidi/0 : 64424bdd43Sratchov.Bd -literal -offset indent 65424bdd43Sratchov$ midicat -i file.syx -q rmidi/0 66424bdd43Sratchov.Ed 67424bdd43Sratchov.Pp 68424bdd43SratchovDump data received from 69424bdd43Sratchov.Pa rmidi/0 70424bdd43Sratchovto stderr: 71424bdd43Sratchov.Bd -literal -offset indent 72424bdd43Sratchov$ midicat -d -q rmidi/0 -o /dev/null 73424bdd43Sratchov.Ed 74424bdd43Sratchov.Pp 75424bdd43SratchovSend data from 76424bdd43Sratchov.Pa rmidi/0 77424bdd43Sratchovto 78424bdd43Sratchov.Pa midithru/0 : 79424bdd43Sratchov.Bd -literal -offset indent 80424bdd43Sratchov$ midicat -q rmidi/0 -q midithru/0 81424bdd43Sratchov.Ed 82424bdd43Sratchov.Sh SEE ALSO 83424bdd43Sratchov.Xr midi 4 , 84424bdd43Sratchov.Xr sndio 7 , 85424bdd43Sratchov.Xr sndiod 8 86