summaryrefslogtreecommitdiffstats
path: root/lib/libsndio/sio_open.3 (follow)
Commit message (Collapse)AuthorAgeFilesLines
* Clarify what sio_start() does exactlyratchov2020-11-291-13/+13
| | | | | Suggested by Erico Nogueira <ericonr@disroot.org>, help from and ok jmc@, schwarze@
* * Add SIO_BPS() to NAME and SYNOPSIS where it is missing.schwarze2020-11-201-6/+15
| | | | | | | | * Use .Fn rather than .Dv for macros taking arguments. * Actually say what SIO_LE_NATIVE means. * Add closely related APIs to SEE ALSO. * Add missing HISTORY and AUTHORS sections. OK ratchov@
* basic macro cleanup: .Fo for long .Fn lines, .Fa for struct fields,schwarze2020-06-201-69/+75
| | | | avoid \*(Gt and \*(Lt, .Dv NULL, .Cm for pledge promises
* move mixerctl and audioctl man pages to section 8, as these workderaadt2020-04-211-3/+3
| | | | against root-only device nodes.
* Sayt that using capabilities to negociate audio parameters (ie usingratchov2019-01-181-2/+12
| | | | | | sio_getcap() function) is not recomended. From Paul Swanson <psw at protonmail.com>, ok jmc
* Move libsndio session cookie in its own $HOME/.sndio/ directory toratchov2018-07-281-3/+3
| | | | | | make libsndio easier to use with unveil(2). "make sense" deraadt
* Tweak RETURN VALUES section. Move description of sio_pollfd() andnatano2017-01-031-18/+28
| | | | | | sio_nfds() return values there and add a paragraph about sio_eof(). ok jmc ratchov
* Document how to use sndio in pledged programs.tim2016-02-111-2/+57
| | | | Input and OK jmc@ ratchov@ semarie@
* Move sndiod man page to section 8.ratchov2016-01-071-6/+6
| | | | suggested by deraadt, fixes from jmc, ok millert
* Remove useless quoting from .Fo and .Fn function names, to preventschwarze2015-09-141-19/+19
| | | | | | development of a cargo cult in case people look at existing files for examples. This achieves a consistent .Fo and .Fn quoting style across the whole tree.
* Kill the only instance of .Lb in our tree. It is better to not useschwarze2014-12-021-4/+3
| | | | | | | it at all, not even occasionally, because there is no sustainable way (and even less any portable way) to maintain the list of library names. Besides, without such a list, even the formatting looks bad. OK jmc@ bentley@
* say this is the "sndio" api, as we have other audio/midi apis,ratchov2014-03-051-3/+3
| | | | | | makes "man -k" happier. ok jmc, schwarze
* clean up macro usage;schwarze2014-01-221-74/+79
| | | | tweak and ok ratchov@, ok jmc@
* - clarify that sio_close() stops the device first, thenratchov2013-12-231-26/+21
| | | | | | | | | | frees the handle and not the opposite - clarify that sio_close() and sio_stop() dont discard samples in the play buffer. suggested by Reimar Doeffinger <Reimar.Doeffinger at gmx.de> ok jmc@
* - replaces "audio stream" by "audio device", as sndio is a deviceratchov2013-12-221-73/+55
| | | | | | | abstraction - remove useless statements. ok jmc@
* remove FILES sections because it's incomplete, wrong and doesn't giveratchov2013-07-041-15/+1
| | | | any useful information
* shorten lines in literal blocks to avoid word wrapingratchov2013-07-041-18/+18
|
* use fancy .In macro for includes. from Jan Klemkow. ok jmc schwarzetedu2013-06-051-3/+3
|
* explain what "default" means in sndio.7 rather than {sio,mio}_open.3,ratchov2013-04-061-10/+2
| | | | with tweaks from jmc
* Make the "default" string a valid device name that has the same effectratchov2012-05-231-4/+4
| | | | | as NULL has. This will (hopefully) simplify ports where the user passes the device string.
* Use "unsigned int" rather than "unsigned". No object change.ratchov2012-04-111-30/+30
| | | | suggested by deraadt@
* formatting errors, found using freebsd's "igor";jmc2011-12-241-3/+3
|
* mention sndiod rather than aucat when talking about the serverratchov2011-12-091-9/+9
|
* Remove midicat since aucat can now be used instead of midicatratchov2011-10-171-5/+5
| | | | | | | | | with almost the same syntax (roughly an extra -M option). Thru boxes are created with aucat, and corresponding MIDI port names have the "aucat" prefix instead of "midithru". The old device name will still work some time for backward compatibility. ok deraadt
* some tweaks, from Tim van der Molenjmc2011-10-041-5/+5
|
* Make aucat audio and midi backends share the same code to communicateratchov2011-04-161-3/+3
| | | | | | with the server. As we're at it use the same protocol for midi and audio. Now, both audio and midi code use the same SNDIO_DEBUG environment variable to turn on/off DPRINTF's.
* tweak previous;jmc2010-11-061-2/+3
|
* make sio_onvol(3) return a integer exposing whether a volume knobratchov2010-11-061-4/+14
| | | | | is available for the stream. As we're at it, remove macros and functions that are neither used nor documented.
* once sio_start() has been called, stream parameters cannot bejakemsr2010-04-261-2/+9
| | | | | | changed until after sio_stop() is called ok ratchov@, jmc@
* aucat (server):ratchov2010-04-061-45/+24
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | - make the ``-m mode'' option per subdevice, allowing subdevices to be play-only or rec-only even if the server is full-duplex - add ``monitoring'' mode (with ``-m mon''). This is a record-only stream from which played streams can be recorded (kind of ``record what you hear''). - allow MIDI devices to be subscribed to the controlling MIDI port of the server, ie what midicat does (with -f option), but using the -q option. - add flow control to the protocol, and serialize clock ticks (sio_onmove() calls) and data chunks. This should fix certain full-duplex programs, broken with ``magic'' block/buffer size combinations. - enable 3 block latency which is the minimum theoretical. Make -z and -b options correspond to device parameters. - make sio_getcap(3) the same for aucat and sun backends, ie return whatever is supported (``everything'' in the aucat case, since everything is actulally supported). aucat (player): - enable ``-m mode'' option to select between monitoring and recording when ``-o file'' is used. - plug MIDI code to non-server codepath. The MIDI control device is specified with the ``-q device'' option, as in server mode. - impliment lseek()'ing within files (controlled through MIDI). Necessary to use aucat with a MIDI sequencer. midicat (thrubox): - rename ``-f'' flag to ``-q'', so it has the same name as in aucat (-f is still working) ok jakemsr@, tweaks from jmc@
* explain what sio_close() drains play buffers as if sio_close() wasratchov2009-12-301-16/+16
| | | | | | | called. Since sio_onmove() callback doesn't return negative deltas anymore, slightly simplify related paragraphs. siggested by espie@, ok jakemsr@
* use const qualifier in libsndio, making it slightly more consistentratchov2009-07-251-3/+3
| | | | | with open(2) and write(2) syscalls. from Thomas Pfaff, jakemsr is fine with it
* Currently midi capable programs can control midi hardware, butratchov2009-07-251-14/+12
| | | | | | | | | | | | | | | | | | | | | | | | | | | cannot cooperate with other programs. The aim of this change is to allow any program to send midi data to other programs as they were midi hardware. For instance, this change should solve the longstanding problem of using a midi sequencer with software synthesizers. More precisely: - new midicat(1) utility (actually hardlink to aucat(1)). it creates software midi thru boxes, allowing programs to send midi messages to other programs as they were midi(4) hardware. - new midi api in libsndio (see mio_open(3)), to access midi(4) devices and midicat(1) sockets in a uniform way. - new device naming scheme <service>:<unit>[.<option>], common to audio and midi. - new sndio(7) manual describing concepts and naming The current audio device naming still works, but people having scripts or configuration files containing device names could read the sndio(7) man page and slowly start updating device names. discussed with jakemsr@ and deraadt@, help form jmc@
* describe sio_getcap(), sio_pollfd() and sio_setvol() retrurn valuesratchov2009-05-151-3/+7
| | | | spotted by Philipp Schafft
* update the default socket paths, to reflect recent aucat changesratchov2009-02-041-7/+7
|
* explain that it's ok if we get a slightly different rate thanratchov2009-02-041-3/+5
| | | | | the one we asked for, from Thomas Pfaff <tpfaff(at)tp76.info> with tweaks from jmc@
* fix bugs section: clarify that sio_start() and sio_stop() shouldratchov2009-01-211-2/+2
| | | | not be used if blocking is not desirable.
* explain what ``frame'' does meanratchov2009-01-211-3/+7
| | | | | from Thomas Pfaff <tpfaff(at)tp76.info>, thanks! ok jmc
* replace s/routine/function/, as other manuals doratchov2009-01-121-24/+24
| | | | | from Thomas Pfaff <tpfaff(at)tp76.info>, thanks! ok jmc@
* oops, i messed up tim's patch; correction from Tim van der Molenjmc2009-01-081-3/+3
|
* a little macro cleanup; from Tim van der Molenjmc2009-01-081-4/+8
|
* stop using stderr in the library, wrap all diagnostic fprintfsratchov2008-12-171-2/+2
| | | | | | so they are visible only when the DEBUG macro is #defined and SIO_DEBUG env. variable is set. requested by many, discussed with jakemsr
* tweak previous;jmc2008-12-171-4/+4
|
* add a writable ``appbufsz'' field to the sa_par structure, containingratchov2008-12-171-19/+31
| | | | | | | | the program-part of the buffer size, ie the part that is subject to underruns. Useful for apps like cdio(1) that don't have their own rings, or to apps that have a minimum ring size constraint. Setting the ``bufsz'' parameter becomes deprecated. ok jakemsr
* occures -> occurs;jmc2008-11-171-3/+3
|
* document that sio_revents() can return POLLHUPratchov2008-11-161-2/+5
|
* tweak previous;jmc2008-11-111-16/+16
|
* expose a volume knob in the sndio API: add sio_setvol(3) andratchov2008-11-111-2/+39
| | | | | | | sio_onvol(3) functions. The audio(4) backend tries to use the inputs.dac, outputs.dac, outputs.output and outputs.master controls (in this order). Add a sample file in regress/lib/libsndio/vol/vol.c
* typos; ok ratchov@ jmc@naddy2008-11-091-8/+8
|
* expose the block size in the sndio API by making par->round writableratchov2008-11-071-4/+4
| | | | | | | and thus remove the ugly rate <-> block-size table from sio_setpar(3). Handle the block size negociation in aucat(1), since it has few constrains the code is overally simpler. ok jakemsr@, major crank suggested by deraadt@
Copyright © 1996 – 2023 Jason A. Donenfeld. All Rights Reverse Engineered.